fix: declare empty a11y panel protocol

Author: posva

packages/devframe/src/in-page-channel/page-script.ts

@@ -2,7 +2,6 @@ import type { AttachedChannelPort } from './internal'
 import type {
   CreatePageScriptChannelOptions,
   InPageChannelProtocol,
-  InPageFunctionDefinitionAny,
   PageScriptChannel,
   PageScriptChannelEvents,
   PanelPeer,
@@ -64,7 +63,7 @@ export function createPageScriptChannel<P extends InPageChannelProtocol>(
   let heartbeatTimer: ReturnType<typeof setInterval> | undefined
 
   const registry = createLocalFunctionRegistry(codec)
-  for (const [fnName, definition] of Object.entries(options.functions) as [string, Omit<InPageFunctionDefinitionAny, 'name'>][])
+  for (const [fnName, definition] of Object.entries(options.functions ?? {}))
     registry.register({ ...definition, name: fnName })
 
   const stateHost = createPageScriptStateHost<P>(function* () {

packages/devframe/src/in-page-channel/panel.ts

@@ -3,7 +3,6 @@ import type {
   ConnectPanelChannelOptions,
   InPageChannelProtocol,
   InPageChannelStatus,
-  InPageFunctionDefinitionAny,
   PanelChannel,
   PanelChannelEvents,
 } from './types'
@@ -63,7 +62,7 @@ export function connectPanelChannel<P extends InPageChannelProtocol>(
 
   const events = createEventEmitter<PanelChannelEvents>()
   const registry = createLocalFunctionRegistry(codec)
-  for (const [fnName, definition] of Object.entries(options.functions) as [string, Omit<InPageFunctionDefinitionAny, 'name'>][])
+  for (const [fnName, definition] of Object.entries(options.functions ?? {}))
     registry.register({ ...definition, name: fnName })
 
   let status: InPageChannelStatus = 'connecting'

packages/devframe/src/in-page-channel/types.test-d.ts

@@ -1,9 +1,8 @@
-import type { InPageChannelProtocol } from './types'
 import { describe, expectTypeOf, it } from 'vitest'
 import { createPageScriptChannel } from './page-script'
 import { connectPanelChannel } from './panel'
 
-interface TestProtocol extends InPageChannelProtocol {
+interface TestProtocol {
   pageScript: {
     echo: (value: string) => string
     sum: (a: number, b: number) => number
@@ -14,10 +13,11 @@ interface TestProtocol extends InPageChannelProtocol {
   }
 }
 
-interface PageScriptOnlyProtocol extends InPageChannelProtocol {
+interface PageScriptOnlyProtocol {
   pageScript: {
     echo: (value: string) => string
   }
+  panel: Record<string, never>
 }
 
 describe('In-page script channel', () => {
@@ -124,7 +124,7 @@ describe('In-page script channel', () => {
       panel.call('notify', false)
     })
 
-    it('rejects calls when the protocol omits panel functions', () => {
+    it('rejects calls when the protocol declares no panel functions', () => {
       const pageScriptOnlyChannel = createPageScriptChannel<PageScriptOnlyProtocol>({
         name: 'devframes:page-script-only',
         functions: {
@@ -219,7 +219,7 @@ describe('Panel channel', () => {
       })
     })
 
-    it('rejects definitions when the protocol omits panel functions', () => {
+    it('accepts an explicitly empty panel function map', () => {
       connectPanelChannel<PageScriptOnlyProtocol>({
         name: 'devframes:page-script-only',
         functions: {},

packages/devframe/src/in-page-channel/types.ts

@@ -22,13 +22,9 @@ export interface InPageChannelProtocol {
   sharedStates?: Record<string, object>
 }
 
-type SideFunctions<P, S> = InPageChannelProtocol extends P
-  ? Record<string, (...args: any[]) => any>
-  : S extends Record<string, (...args: any[]) => any>
-    ? string extends keyof S ? Record<never, never> : S
-    : Record<never, never>
-type PageScriptFunctions<P extends InPageChannelProtocol> = SideFunctions<P, NonNullable<P['pageScript']>>
-type PanelFunctions<P extends InPageChannelProtocol> = SideFunctions<P, NonNullable<P['panel']>>
+type SideFunctions<S> = S extends Record<string, (...args: any[]) => any> ? S : Record<string, never>
+type PageScriptFunctions<P extends InPageChannelProtocol> = SideFunctions<NonNullable<P['pageScript']>>
+type PanelFunctions<P extends InPageChannelProtocol> = SideFunctions<NonNullable<P['panel']>>
 type SharedStates<P extends InPageChannelProtocol>
   = P['sharedStates'] extends Record<string, object> ? P['sharedStates'] : Record<string, never>
 
@@ -117,9 +113,7 @@ interface InPageFunctionOption<F> {
  */
 type CreatePageScriptChannelOptionsFunctions<P extends InPageChannelProtocol> = {
   [NAME in keyof PageScriptFunctions<P> & string]: InPageFunctionOption<PageScriptFunctions<P>[NAME]>
-} extends infer FUNCTIONS
-  ? keyof FUNCTIONS extends never ? Record<string, never> : FUNCTIONS
-  : never
+}
 
 /**
  * Functions implemented by {@link connectPanelChannel}.
@@ -128,9 +122,7 @@ type CreatePageScriptChannelOptionsFunctions<P extends InPageChannelProtocol> =
  */
 type ConnectPanelChannelOptionsFunctions<P extends InPageChannelProtocol> = {
   [NAME in keyof PanelFunctions<P> & string]: InPageFunctionOption<PanelFunctions<P>[NAME]>
-} extends infer FUNCTIONS
-  ? keyof FUNCTIONS extends never ? Record<string, never> : FUNCTIONS
-  : never
+}
 
 /**
  * Connection lifecycle of a panel endpoint: `connecting` (handshake retry

plugins/a11y/src/shared/protocol.ts

@@ -19,8 +19,6 @@
  * `static` RPC the panel resolves) is forwarded to the page script over the
  * same channel, keeping the page script itself free of any RPC dependency.
  */
-import type { InPageChannelProtocol } from 'devframe/in-page-channel'
-
 /** In-page channel name. Namespaced with the devframe id, per convention. */
 export const A11Y_CHANNEL = 'devframes:plugin:a11y'
 
@@ -164,7 +162,7 @@ export interface PageScriptConfig {
  * aggregate the page script owns. All functions are fire-and-forget events —
  * results flow back through the shared state.
  */
-export interface A11yChannelProtocol extends InPageChannelProtocol {
+export interface A11yChannelProtocol {
   pageScript: {
     /**
      * Draw the transient hover-preview ring around a node's element.
@@ -187,6 +185,7 @@ export interface A11yChannelProtocol extends InPageChannelProtocol {
     /** Drop the whole tracked-route history. */
     'clear-all': () => void
   }
+  panel: Record<string, never>
   sharedStates: {
     /** The authoritative route → report aggregate the page script owns. */
     state: A11yState