@zhin.js/pagemanager 0.0.0 → 1.1.1

package/README.md

@@ -0,0 +1,86 @@
+# @zhin.js/pagemanager
+
+Remote Console **Node 侧运行时**：PageManager、EntryStore、`GET /entries`、esbuild 打包与 `/@dev` 开发资源路由。无 UI；契约在 `@zhin.js/contract`，浏览器 SDK 在 `@zhin.js/client`。
+
+> **路径约定**：本包位于 `packages/console/pagemanager/`。源码在 `src/node/`，构建产物在 `lib/node/`。
+
+## 分层
+
+见 [Console 栈概览](../README.md)：
+
+```
+@zhin.js/contract  →  @zhin.js/pagemanager  →  @zhin.js/client  →  zhin-console（独立仓库）
+```
+
+领域术语与关系图见 **[CONTEXT.md](./CONTEXT.md)**。
+
+## 安装
+
+Monorepo 内 workspace 依赖；对外发布时：
+
+```bash
+pnpm add @zhin.js/pagemanager
+```
+
+## 主要导出
+
+| 导出 | 用途 |
+|------|------|
+| `PageManager` | 控制台服务端运行时；拥有 EntryStore，注册 Console Entry |
+| `mountConsoleRouter` | 挂载 entries 与静态/dev 资源路由 |
+| `createInMemoryEntryStore` / `EntryStore` | Entry 目录 |
+| `buildEntriesResponse` / `rewriteEntriesForClient` | 序列化 `GET /entries` 响应 |
+| `attachConsoleClientHost` | 将 Console 路由挂到现有 Koa Host |
+| `serverRuntimeEnv` | development / production 运行时标记 |
+
+类型（`ConsoleServerOptions`、`PluginServerRegisterHostApi` 等）自 `./consoleServerOptions.js` 导出。
+
+## Plugin Runtime
+
+`@zhin.js/pagemanager/plugin-runtime` 提供 snapshot-coherent 的 `ConsoleRuntime`。一次
+`runView()` 在完整回调期间持有同一 generation lease，route guard、权限过滤、Navigation
+树和 Layout fallback chain 都从同一个 Page/Layout projection 读取；回调结束后 catalog
+失效，避免浏览器模块 URL 跨 generation 逃逸。
+
+该子路径不引入 React、Router 或客户端编译器。Page 与 Layout 的约定式发现分别由
+`@zhin.js/page`、`@zhin.js/layout` 提供，wire types 来自零依赖
+`@zhin.js/console-contract`。
+
+## Client Build
+
+`@zhin.js/pagemanager/client-build` 是可选的 TypeScript AST/build adapter。它静态提取
+`definePage()` 的 JSON-like metadata，生成 content-hash ESM 与
+`pages.manifest.json`，生产 loader 不记录构建机绝对路径。
+
+TypeScript 是 optional peer，不进入默认 PageManager 或 Plugin Runtime 的生产闭包。
+选择该子路径的构建 workspace 需要显式安装兼容版本的 `typescript`。
+
+## 插件注册 Entry
+
+在插件 Node 侧通过 `web` 上下文获取 **PageManager 实例**（非静态全局）：
+
+```typescript
+useContext('web', (pageManager) => {
+  pageManager.addEntry({
+    id: 'my-plugin',
+    name: 'My Plugin',
+    dev: '/@dev/plugins/my-plugin/client/index.tsx',
+    prod: '/@assets/my-plugin/client/index.js',
+  });
+});
+```
+
+浏览器侧由 `@zhin.js/client` 的 `loadConsoleEntries` 拉取并动态 `import`。
+
+## 构建
+
+```bash
+pnpm --filter @zhin.js/pagemanager build
+```
+
+## 相关文档
+
+- [Remote Console 使用说明](../../../docs/console-remote.md)
+- [@zhin.js/contract](../contract/README.md)
+- [@zhin.js/client](../client/README.md)
+- [@zhin.js/host-http（Console/HTTP Host 传输）](../../host/http/README.md)

package/lib/client-build/index.d.ts

@@ -0,0 +1,6 @@
+export * from './manifest-loader.js';
+export * from './module-runtime.js';
+export * from './static-metadata.js';
+export * from './typescript-builder.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/client-build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client-build/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/lib/client-build/index.js

@@ -0,0 +1,6 @@
+export * from './manifest-loader.js';
+export * from './module-runtime.js';
+export * from './static-metadata.js';
+export * from './typescript-builder.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/lib/client-build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client-build/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/lib/client-build/manifest-loader.d.ts

@@ -0,0 +1,9 @@
+import type { ClientModuleRequest } from '@zhin.js/feature-kit';
+import type { ClientArtifactManifest, ClientModuleLoader } from './types.js';
+export declare class ManifestClientModuleLoader implements ClientModuleLoader {
+    #private;
+    constructor(manifest: ClientArtifactManifest);
+    static fromFile(path: string): Promise<ManifestClientModuleLoader>;
+    load<T = unknown>(_source: string, request: ClientModuleRequest): Promise<T>;
+}
+//# sourceMappingURL=manifest-loader.d.ts.map

package/lib/client-build/manifest-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../../src/client-build/manifest-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EACV,sBAAsB,EAEtB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,0BAA2B,YAAW,kBAAkB;;gBAGvD,QAAQ,EAAE,sBAAsB;WAc/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAKlE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;CASnF"}

package/lib/client-build/manifest-loader.js

@@ -0,0 +1,47 @@
+import { readFile } from 'node:fs/promises';
+export class ManifestClientModuleLoader {
+    #entries;
+    constructor(manifest) {
+        if (manifest.protocol !== 1 || !Array.isArray(manifest.entries)) {
+            throw new TypeError('Unsupported client artifact manifest');
+        }
+        const entries = new Map();
+        for (const candidate of manifest.entries) {
+            const entry = validateEntry(candidate);
+            const key = artifactKey(entry);
+            if (entries.has(key))
+                throw new Error(`Duplicate client artifact: ${key}`);
+            entries.set(key, Object.freeze({ ...entry }));
+        }
+        this.#entries = entries;
+    }
+    static async fromFile(path) {
+        const parsed = JSON.parse(await readFile(path, 'utf8'));
+        return new ManifestClientModuleLoader(parsed);
+    }
+    async load(_source, request) {
+        const entry = this.#entries.get(artifactKey(request));
+        if (!entry)
+            throw new Error(`Missing client artifact for ${request.feature}:${request.localName}`);
+        return Object.freeze({
+            module: entry.module,
+            hash: entry.hash,
+            metadata: entry.metadata,
+        });
+    }
+}
+function artifactKey(request) {
+    return `${request.owner}\0${request.feature}\0${request.localName}`;
+}
+function validateEntry(value) {
+    if (!value || typeof value !== 'object')
+        throw new TypeError('Invalid client artifact entry');
+    const entry = value;
+    for (const field of ['source', 'owner', 'feature', 'localName', 'module', 'hash']) {
+        if (typeof entry[field] !== 'string' || !entry[field]) {
+            throw new TypeError(`Invalid client artifact ${field}`);
+        }
+    }
+    return entry;
+}
+//# sourceMappingURL=manifest-loader.js.map

package/lib/client-build/manifest-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.js","sourceRoot":"","sources":["../../src/client-build/manifest-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,MAAM,OAAO,0BAA0B;IAC5B,QAAQ,CAAsD;IAEvE,YAAY,QAAgC;QAC1C,IAAI,QAAQ,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0C,CAAC;QAClE,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;YAC3E,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAY;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAA2B,CAAC;QAClF,OAAO,IAAI,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI,CAAc,OAAe,EAAE,OAA4B;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACnG,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAM,CAAC;IACV,CAAC;CACF;AAED,SAAS,WAAW,CAAC,OAA4B;IAC/C,OAAO,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,KAAsC,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAU,EAAE,CAAC;QAC3F,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,SAAS,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,KAA6B,CAAC;AACvC,CAAC"}

package/lib/client-build/module-runtime.d.ts

@@ -0,0 +1,17 @@
+import type { Dispose } from '@zhin.js/plugin-runtime';
+import type { ClientModuleRequest } from '@zhin.js/feature-kit';
+import type { ModuleRuntime } from '@zhin.js/runtime';
+import type { ClientModuleLoader } from './types.js';
+/** Adds client artifact loading while preserving the server ModuleRuntime authority. */
+export declare class ClientBuildModuleRuntime implements ModuleRuntime {
+    private readonly server;
+    private readonly client;
+    constructor(server: ModuleRuntime, client: ClientModuleLoader);
+    load<T = unknown>(source: string): Promise<T>;
+    loadClientModule<T = unknown>(source: string, request: ClientModuleRequest): Promise<T>;
+    invalidate(source: string): Promise<void> | void;
+    affectedSources(source: string): readonly string[];
+    watch(listener: (source: string) => void): Dispose;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=module-runtime.d.ts.map

package/lib/client-build/module-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-runtime.d.ts","sourceRoot":"","sources":["../../src/client-build/module-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wFAAwF;AACxF,qBAAa,wBAAyB,YAAW,aAAa;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,kBAAkB;IAG7C,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7C,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIhD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAIlD,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;IAIlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvB"}

package/lib/client-build/module-runtime.js

@@ -0,0 +1,28 @@
+/** Adds client artifact loading while preserving the server ModuleRuntime authority. */
+export class ClientBuildModuleRuntime {
+    server;
+    client;
+    constructor(server, client) {
+        this.server = server;
+        this.client = client;
+    }
+    load(source) {
+        return this.server.load(source);
+    }
+    loadClientModule(source, request) {
+        return this.client.load(source, request);
+    }
+    invalidate(source) {
+        return this.server.invalidate?.(source);
+    }
+    affectedSources(source) {
+        return this.server.affectedSources?.(source) ?? [source];
+    }
+    watch(listener) {
+        return this.server.watch?.(listener) ?? (() => undefined);
+    }
+    close() {
+        return this.server.close();
+    }
+}
+//# sourceMappingURL=module-runtime.js.map

package/lib/client-build/module-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-runtime.js","sourceRoot":"","sources":["../../src/client-build/module-runtime.ts"],"names":[],"mappings":"AAKA,wFAAwF;AACxF,MAAM,OAAO,wBAAwB;IAEhB;IACA;IAFnB,YACmB,MAAqB,EACrB,MAA0B;QAD1B,WAAM,GAAN,MAAM,CAAe;QACrB,WAAM,GAAN,MAAM,CAAoB;IAC1C,CAAC;IAEJ,IAAI,CAAc,MAAc;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAI,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,gBAAgB,CAAc,MAAc,EAAE,OAA4B;QACxE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAI,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,QAAkC;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/lib/client-build/static-metadata.d.ts

@@ -0,0 +1,9 @@
+export declare function extractPageMetadata(source: string, fileName: string): unknown;
+export declare function assertLayoutModule(source: string, fileName: string): void;
+export declare class ClientSourceError extends Error {
+    readonly source: string;
+    readonly line: number;
+    readonly column: number;
+    constructor(source: string, line: number, column: number, message: string);
+}
+//# sourceMappingURL=static-metadata.d.ts.map

package/lib/client-build/static-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-metadata.d.ts","sourceRoot":"","sources":["../../src/client-build/static-metadata.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgB7E;AAmBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGzE;AAyED,qBAAa,iBAAkB,SAAQ,KAAK;IAExC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAFd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM;CAKlB"}

package/lib/client-build/static-metadata.js

@@ -0,0 +1,126 @@
+import ts from 'typescript';
+export function extractPageMetadata(source, fileName) {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, scriptKind(fileName));
+    assertDefaultExport(file);
+    let metadata;
+    let found = false;
+    for (const statement of file.statements) {
+        if (!ts.isVariableStatement(statement) || !hasModifier(statement, ts.SyntaxKind.ExportKeyword))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== 'meta')
+                continue;
+            if (found)
+                fail(file, declaration, 'Page module exports meta more than once');
+            found = true;
+            assertDefinePageImport(file, declaration);
+            metadata = parseDefinePage(file, declaration.initializer);
+        }
+    }
+    return metadata;
+}
+function assertDefinePageImport(file, node) {
+    const found = file.statements.some((statement) => {
+        if (!ts.isImportDeclaration(statement)
+            || !ts.isStringLiteral(statement.moduleSpecifier)
+            || statement.moduleSpecifier.text !== '@zhin.js/console-contract')
+            return false;
+        const bindings = statement.importClause?.namedBindings;
+        return bindings && ts.isNamedImports(bindings)
+            && bindings.elements.some((element) => element.name.text === 'definePage'
+                && (element.propertyName?.text ?? element.name.text) === 'definePage');
+    });
+    if (!found)
+        fail(file, node, 'Page meta requires a named definePage import from @zhin.js/console-contract');
+}
+export function assertLayoutModule(source, fileName) {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, scriptKind(fileName));
+    assertDefaultExport(file);
+}
+function parseDefinePage(file, expression) {
+    if (!expression || !ts.isCallExpression(expression)
+        || !ts.isIdentifier(expression.expression) || expression.expression.text !== 'definePage') {
+        fail(file, expression ?? file, 'Page meta must be definePage({...})');
+    }
+    if (expression.arguments.length > 1)
+        fail(file, expression, 'definePage() accepts at most one argument');
+    const argument = expression.arguments[0];
+    return argument ? literal(file, argument) : {};
+}
+function literal(file, node) {
+    if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))
+        return node.text;
+    if (ts.isNumericLiteral(node))
+        return Number(node.text);
+    if (node.kind === ts.SyntaxKind.TrueKeyword)
+        return true;
+    if (node.kind === ts.SyntaxKind.FalseKeyword)
+        return false;
+    if (node.kind === ts.SyntaxKind.NullKeyword)
+        return null;
+    if (ts.isPrefixUnaryExpression(node)
+        && node.operator === ts.SyntaxKind.MinusToken && ts.isNumericLiteral(node.operand)) {
+        return -Number(node.operand.text);
+    }
+    if (ts.isArrayLiteralExpression(node)) {
+        return node.elements.map((element) => {
+            if (ts.isSpreadElement(element) || ts.isOmittedExpression(element)) {
+                fail(file, element, 'Page metadata arrays cannot contain spreads or holes');
+            }
+            return literal(file, element);
+        });
+    }
+    if (ts.isObjectLiteralExpression(node)) {
+        const result = {};
+        for (const property of node.properties) {
+            if (!ts.isPropertyAssignment(property)) {
+                fail(file, property, 'Page metadata only supports static property assignments');
+            }
+            const name = propertyName(file, property.name);
+            if (Object.hasOwn(result, name))
+                fail(file, property.name, `Duplicate Page metadata key: ${name}`);
+            result[name] = literal(file, property.initializer);
+        }
+        return result;
+    }
+    fail(file, node, 'Page metadata must contain JSON-like literals only');
+}
+function propertyName(file, name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name))
+        return name.text;
+    fail(file, name, 'Page metadata does not support computed property names');
+}
+function assertDefaultExport(file) {
+    const found = file.statements.some((statement) => {
+        if (ts.isExportAssignment(statement))
+            return !statement.isExportEquals;
+        return (ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement))
+            && hasModifier(statement, ts.SyntaxKind.ExportKeyword)
+            && hasModifier(statement, ts.SyntaxKind.DefaultKeyword);
+    });
+    if (!found)
+        fail(file, file, 'Client module must have a default export');
+}
+function hasModifier(node, kind) {
+    return ts.canHaveModifiers(node) && ts.getModifiers(node)?.some((modifier) => modifier.kind === kind) === true;
+}
+function scriptKind(fileName) {
+    return fileName.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+}
+function fail(file, node, message) {
+    const position = file.getLineAndCharacterOfPosition(node.getStart(file, false));
+    throw new ClientSourceError(file.fileName, position.line + 1, position.character + 1, message);
+}
+export class ClientSourceError extends Error {
+    source;
+    line;
+    column;
+    constructor(source, line, column, message) {
+        super(`${source}:${line}:${column} ${message}`);
+        this.source = source;
+        this.line = line;
+        this.column = column;
+        this.name = 'ClientSourceError';
+    }
+}
+//# sourceMappingURL=static-metadata.js.map

package/lib/client-build/static-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-metadata.js","sourceRoot":"","sources":["../../src/client-build/static-metadata.ts"],"names":[],"mappings":"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"}

package/lib/client-build/types.d.ts

@@ -0,0 +1,26 @@
+import type { ClientModuleArtifact } from '@zhin.js/console-contract';
+import type { ClientModuleRequest } from '@zhin.js/feature-kit';
+export interface ClientBuildEntry extends ClientModuleRequest {
+    readonly source: string;
+}
+export interface ClientArtifactRecord extends ClientBuildEntry, ClientModuleArtifact {
+}
+export interface ClientArtifactManifest {
+    readonly protocol: 1;
+    readonly entries: readonly ClientArtifactRecord[];
+}
+export interface ClientModuleLoader {
+    load<T = unknown>(source: string, request: ClientModuleRequest): Promise<T>;
+}
+export interface TypeScriptClientBuilderOptions {
+    readonly outDir: string;
+    readonly projectRoot?: string;
+    readonly publicBase?: string;
+    /**
+     * Console public base used when rewriting bare React imports to `/esm/…`.
+     * Defaults to `/` (Host root). Must match the base passed to `GET /esm/:enc.mjs`.
+     */
+    readonly consoleBasePath?: string;
+    readonly manifestFile?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/client-build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client-build/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB,EAAE,oBAAoB;CAAG;AAEvF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/lib/client-build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/client-build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client-build/types.ts"],"names":[],"mappings":""}

package/lib/client-build/typescript-builder.d.ts

@@ -0,0 +1,9 @@
+import type { ClientModuleRequest } from '@zhin.js/feature-kit';
+import type { ClientArtifactManifest, ClientBuildEntry, ClientModuleLoader, TypeScriptClientBuilderOptions } from './types.js';
+export declare class TypeScriptClientBuilder implements ClientModuleLoader {
+    #private;
+    constructor(options: TypeScriptClientBuilderOptions);
+    load<T = unknown>(source: string, request: ClientModuleRequest): Promise<T>;
+    build(entries: readonly ClientBuildEntry[]): Promise<Readonly<ClientArtifactManifest>>;
+}
+//# sourceMappingURL=typescript-builder.d.ts.map

package/lib/client-build/typescript-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-builder.d.ts","sourceRoot":"","sources":["../../src/client-build/typescript-builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAUhE,OAAO,KAAK,EACV,sBAAsB,EAEtB,gBAAgB,EAChB,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAoBpB,qBAAa,uBAAwB,YAAW,kBAAkB;;gBAQpD,OAAO,EAAE,8BAA8B;IAQ7C,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB3E,KAAK,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;CAiB7F"}