refactor(plugins): simplify injected-script exports and drop the connect wrapper

Rename the browser/injected surface for clarity, per review:
- a11y: the injected browser script is now ./client-script (src/client-script/index.ts, no page-script subfolder); drop the confusing 'page script' term. Keep a11yClientScriptBundlePath (deprecated aliases for the old names).
- data-inspector: the node --import module is now ./inject (src/inject/, restored name), since it runs in the user's Node process, not the browser.
- inspect/og/assets/code-server: the connectX wrapper was only used by each plugin's own SPA, so move it into app/connect.ts and drop the ./client-script export; these plugins now build only their node side with tsdown. Trim the barrel to the types the app actually uses.
- reconcile alias.ts, tsconfig.base.json paths, knip entries, and API snapshots

Author: antfubot

alias.ts

@@ -78,7 +78,6 @@ export const alias = {
   '@devframes/json-render-ui/spa': r('json-render-ui/src/spa.ts'),
   '@devframes/json-render-ui': r('json-render-ui/src/index.ts'),
   'json-render/dashboard': fileURLToPath(new URL('./examples/json-render/src/dashboard.ts', import.meta.url)),
-  '@devframes/plugin-code-server/client-script': p('code-server/src/client-script/client/index.ts'),
   '@devframes/plugin-code-server/node': p('code-server/src/node/setup.ts'),
   '@devframes/plugin-code-server/constants': p('code-server/src/node/constants.ts'),
   '@devframes/plugin-code-server/types': p('code-server/src/node/types.ts'),
@@ -98,24 +97,20 @@ export const alias = {
   'devframe/recipes/common-rpc-functions': r('devframe/src/recipes/common-rpc-functions.ts'),
   'devframe/client': r('devframe/src/client/index.ts'),
   'devframe': r('devframe/src'),
-  '@devframes/plugin-data-inspector/client-script/page-script': p('data-inspector/src/client-script/page-script/index.ts'),
-  '@devframes/plugin-data-inspector/client-script': p('data-inspector/src/client-script/client/index.ts'),
+  '@devframes/plugin-data-inspector/inject': p('data-inspector/src/inject/index.ts'),
   '@devframes/plugin-data-inspector/node': p('data-inspector/src/node/setup.ts'),
   '@devframes/plugin-data-inspector/registry': p('data-inspector/src/node/registry/index.ts'),
   '@devframes/plugin-data-inspector/engine': p('data-inspector/src/node/engine/index.ts'),
   '@devframes/plugin-data-inspector/cli': p('data-inspector/src/node/cli.ts'),
   '@devframes/plugin-data-inspector': p('data-inspector/src/node/index.ts'),
-  '@devframes/plugin-inspect/client-script': p('inspect/src/client-script/client/index.ts'),
   '@devframes/plugin-inspect/node': p('inspect/src/node/setup.ts'),
   '@devframes/plugin-inspect/cli': p('inspect/src/node/cli.ts'),
   '@devframes/plugin-inspect': p('inspect/src/node/index.ts'),
-  '@devframes/plugin-og/client-script': p('og/src/client-script/client/index.ts'),
   '@devframes/plugin-og/node': p('og/src/node/setup.ts'),
   '@devframes/plugin-og/rpc': p('og/src/node/rpc/index.ts'),
   '@devframes/plugin-og/cli': p('og/src/node/cli.ts'),
   '@devframes/plugin-og': p('og/src/node/index.ts'),
-  '@devframes/plugin-a11y/client-script/page-script': p('a11y/src/client-script/page-script/index.ts'),
-  '@devframes/plugin-a11y/client-script': p('a11y/src/client-script/client/index.ts'),
+  '@devframes/plugin-a11y/client-script': p('a11y/src/client-script/index.ts'),
   '@devframes/plugin-a11y/node': p('a11y/src/node/setup.ts'),
   '@devframes/plugin-a11y/cli': p('a11y/src/node/cli.ts'),
   '@devframes/plugin-a11y': p('a11y/src/node/index.ts'),
@@ -125,7 +120,6 @@ export const alias = {
   '@devframes/plugin-messages/rpc': p('messages/src/node/rpc/index.ts'),
   '@devframes/plugin-messages/cli': p('messages/src/node/cli.ts'),
   '@devframes/plugin-messages': p('messages/src/node/index.ts'),
-  '@devframes/plugin-assets/client-script': p('assets/src/client-script/client/index.ts'),
   '@devframes/plugin-assets/node': p('assets/src/node/setup.ts'),
   '@devframes/plugin-assets/rpc': p('assets/src/node/rpc/index.ts'),
   '@devframes/plugin-assets/cli': p('assets/src/node/cli.ts'),

knip.jsonc

@@ -27,7 +27,7 @@
     // renames left `createDevframeClientHost` → `createDevframeClientRuntime`
     // and `AGENT_DISCOVERY_FILE` → `DISCOVERY_FILE` aliases behind.
     "packages/hub/src/client/host.ts": ["duplicates"],
-    "plugins/data-inspector/src/client-script/page-script/index.ts": ["duplicates"]
+    "plugins/data-inspector/src/inject/index.ts": ["duplicates"]
   },
   "workspaces": {
     ".": {
@@ -212,7 +212,6 @@
       "entry": [
         "src/node/{index,setup,cli}.ts",
         "src/node/rpc/index.ts",
-        "src/client-script/client/index.ts",
         "app/**/*.stories.@(ts|tsx)"
       ],
       "ignoreDependencies": ["@devframes/plugin-inspect--assets", "@devframes/vite"]
@@ -231,7 +230,6 @@
       "entry": [
         "src/node/{index,setup,cli}.ts",
         "src/node/rpc/index.ts",
-        "src/client-script/client/index.ts",
         "app/**/*.stories.@(ts|tsx)"
       ],
       "ignoreDependencies": ["@devframes/plugin-og--assets", "@devframes/vite"]
@@ -242,8 +240,7 @@
         "src/node/{index,setup,cli}.ts",
         "src/node/rpc/index.ts",
         "src/node/{engine,registry}/index.ts",
-        "src/client-script/client/index.ts",
-        "src/client-script/page-script/index.ts",
+        "src/inject/index.ts",
         "app/**/*.stories.@(ts|tsx)"
       ],
       "ignoreDependencies": ["@devframes/plugin-data-inspector--assets", "@devframes/vite"]
@@ -253,7 +250,6 @@
       "entry": [
         "src/node/{index,setup,cli,constants,types,vite}.ts",
         "src/node/rpc/index.ts",
-        "src/client-script/client/index.ts",
         "app/**/*.stories.@(ts|tsx)"
       ],
       "ignoreDependencies": ["@devframes/plugin-code-server--assets"]
@@ -263,7 +259,6 @@
       "entry": [
         "src/node/{index,setup,cli,constants,types}.ts",
         "src/node/rpc/index.ts",
-        "src/client-script/client/index.ts",
         "app/**/*.stories.@(ts|tsx)"
       ],
       "ignoreDependencies": ["@devframes/plugin-assets--assets", "@devframes/vite"]
@@ -306,7 +301,7 @@
       "entry": [
         "src/node/{index,setup,cli}.ts",
         "src/node/rpc/index.ts",
-        "src/client-script/{client,page-script}/index.ts",
+        "src/client-script/index.ts",
         "app/**/*.stories.tsx"
       ],
       "ignoreDependencies": ["@devframes/plugin-a11y--assets", "@devframes/vite"]

plugins/a11y/package.json

@@ -23,8 +23,7 @@
   "sideEffects": false,
   "exports": {
     ".": "./dist/node/index.mjs",
-    "./client-script": "./dist/client-script/client/index.mjs",
-    "./client-script/page-script": "./dist/client-script/page-script/index.mjs",
+    "./client-script": "./dist/client-script/index.mjs",
     "./cli": "./dist/node/cli.mjs",
     "./node": "./dist/node/setup.mjs",
     "./package.json": "./package.json"

plugins/a11y/playgrounds/server.mjs

@@ -35,7 +35,7 @@ const ROOT = resolve(HERE, '..')
 const devframe = createA11yDevframe()
 const mode = process.argv[2] === 'build' ? 'build' : 'dev'
 const basePath = devframe.basePath
-const injectDir = resolve(ROOT, 'dist/client-script/page-script')
+const injectDir = resolve(ROOT, 'dist/client-script')
 const panelDir = mode === 'build' ? resolve(ROOT, 'dist/static') : resolve(ROOT, 'assets-pkg/dist')
 
 function requireBuilt(file, hint) {

plugins/a11y/src/client-script/client/index.ts

@@ -15,7 +15,7 @@
  * export receives the hub's client-script context and additionally mirrors
  * each scan into the hub's messages feed.
  */
-import type { A11yChannelProtocol, PageScriptConfig, PinTarget, ScanReport } from '../../shared/protocol.ts'
+import type { A11yChannelProtocol, PageScriptConfig, PinTarget, ScanReport } from '../shared/protocol.ts'
 import type { A11yPageScriptContext } from './messages.ts'
 import type { PinInfo } from './overlay.ts'
 import { createPageScriptChannel } from 'devframe/in-page-channel'
@@ -24,7 +24,7 @@ import {
   A11Y_DEFAULT_DOCK_ID,
   A11Y_NODE_ATTR,
   A11Y_STORAGE_KEY,
-} from '../../shared/protocol.ts'
+} from '../shared/protocol.ts'
 import { createMessagesReporter } from './messages.ts'
 import { createOverlay } from './overlay.ts'
 import { resolveElement, scan } from './scanner.ts'

plugins/a11y/src/client-script/client/shims.d.ts

@@ -9,8 +9,8 @@
  * simply has no messages client and skips the feed. Mirrors the pattern used
  * by the terminals and code-server plugins for `ctx.terminals`.
  */
-import type { Impact, ScanReport } from '../../shared/protocol.ts'
-import { A11Y_DEFAULT_DOCK_ID } from '../../shared/protocol.ts'
+import type { Impact, ScanReport } from '../shared/protocol.ts'
+import { A11Y_DEFAULT_DOCK_ID } from '../shared/protocol.ts'
 
 /**
  * Structural slice of the hub's `DevframeMessageAction` the page script emits: a

…y/src/client-script/page-script/index.ts plugins/a11y/src/client-script/index.tsplugins/a11y/src/client-script/page-script/index.ts renamed to plugins/a11y/src/client-script/index.ts plugins/a11y/src/client-script/page-script/index.ts renamed to plugins/a11y/src/client-script/index.ts

@@ -1,5 +1,5 @@
-import type { Impact } from '../../shared/protocol.ts'
-import { IMPACT_COLOR } from '../../shared/protocol.ts'
+import type { Impact } from '../shared/protocol.ts'
+import { IMPACT_COLOR } from '../shared/protocol.ts'
 
 const PREFERS_REDUCED_MOTION
   = typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches

…rc/client-script/page-script/messages.ts …ugins/a11y/src/client-script/messages.tsplugins/a11y/src/client-script/page-script/messages.ts renamed to plugins/a11y/src/client-script/messages.ts plugins/a11y/src/client-script/page-script/messages.ts renamed to plugins/a11y/src/client-script/messages.ts

@@ -1,6 +1,6 @@
-import type { ScanReport, Violation, ViolationNode } from '../../shared/protocol.ts'
+import type { ScanReport, Violation, ViolationNode } from '../shared/protocol.ts'
 import axe from 'axe-core'
-import { A11Y_NODE_ATTR, DEFAULT_AXE_TAGS, emptyCounts, IMPACT_ORDER } from '../../shared/protocol.ts'
+import { A11Y_NODE_ATTR, DEFAULT_AXE_TAGS, emptyCounts, IMPACT_ORDER } from '../shared/protocol.ts'
 
 const IMPACTS = new Set<string>(IMPACT_ORDER)
 let counter = 0