@microsoft/webui 0.0.18 → 0.0.19

package/dist/projection/graph.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Normalized module graph and adapter SPI for the bundler-neutral
+ * state projection compiler.
+ *
+ * The adapter SPI isolates bundler-specific semantics. The projection compiler
+ * (`compiler.ts`) consumes only these interfaces, never bundler-specific APIs.
+ *
+ * See DESIGN.md §"Bundler-Neutral State Projection Compiler" for the
+ * authoritative specification.
+ */
+/** Physical/virtual classification used for hashing and path validation. */
+export type ModuleKind = "file" | "virtual";
+/** One authored module specifier paired with the bundler-resolved target. */
+export interface ResolvedImport {
+    /** Specifier exactly as authored in the importing source file. */
+    readonly specifier: string;
+    /**
+     * Canonical target module ID. Undefined only when `external` is true.
+     *
+     * The compiler never reconstructs this value from `specifier`.
+     */
+    readonly resolvedId: string | undefined;
+    /** Whether the bundler left this dependency external. */
+    readonly external: boolean;
+    /** Static imports/re-exports participate in symbol resolution. */
+    readonly kind: "static" | "dynamic";
+    /**
+     * Owning package when the adapter can prove it.
+     *
+     * This lets aliases that resolve to `@microsoft/webui-framework` retain the
+     * same semantic identity without coupling the compiler to node_modules path
+     * layouts.
+     */
+    readonly packageName?: string;
+}
+/** A single resolved module in the build graph. */
+export interface ModuleNode {
+    /**
+     * Canonical absolute path on disk (always forward-slash, no query/hash).
+     *
+     * Virtual modules (no physical file) have an `id` beginning with `\0`
+     * (null byte). Their `source` may be provided but their physical `inputs`
+     * hash is `"virtual"`.
+     */
+    readonly id: string;
+    /** Whether `id` identifies a physical file or a bundler-owned virtual module. */
+    readonly kind: ModuleKind;
+    /** Owning package identity, when proven by the adapter. */
+    readonly packageName?: string;
+    /**
+     * Raw UTF-8 source text.
+     *
+     * Required for file modules. Virtual modules may omit source when they carry
+     * no analyzable WebUI code.
+     */
+    readonly source: string | undefined;
+    /**
+     * Authored specifiers paired with their exact bundler-resolved targets.
+     *
+     * Keeping both values is essential: aliases, extension substitution,
+     * package exports, virtual namespaces, and plugin resolution cannot be
+     * reconstructed from source text.
+     */
+    readonly imports: ReadonlyArray<ResolvedImport>;
+}
+/** The resolved input module graph as seen by the bundler. */
+export interface ModuleGraph {
+    /**
+     * All modules reachable from the entry set, keyed by canonical ID.
+     *
+     * The compiler walks this map following `imports` edges. Modules absent from
+     * this map are not part of this build.
+     */
+    readonly modules: ReadonlyMap<string, ModuleNode>;
+    /** Canonical entry module IDs; a subset of `modules.keys()`. */
+    readonly entries: ReadonlyArray<string>;
+}
+/**
+ * Maps each emitted output path to the input module IDs that contribute to it.
+ *
+ * This is the authoritative source for whether a component class was
+ * tree-shaken from the final bundle. A class whose defining module does not
+ * appear in any output's contributing set is excluded from the manifest.
+ */
+export interface OutputMembership {
+    /**
+     * Key: canonical absolute output ID, or a virtual ID beginning with `\0`.
+     *
+     * Value: set of canonical input module IDs (`ModuleNode.id`) whose code
+     *   appears in this output after bundling and tree shaking.
+     */
+    readonly outputs: ReadonlyMap<string, ReadonlySet<string>>;
+}
+/**
+ * Context passed from the bundler adapter to the projection compiler.
+ *
+ * The adapter constructs this from bundler-native structures and passes it
+ * to `compileProjection()`. The compiler never calls bundler APIs directly.
+ */
+export interface AdapterContext {
+    /** Resolved input module graph. */
+    readonly graph: ModuleGraph;
+    /** Final output→input membership from the bundler's tree shaking. */
+    readonly membership: OutputMembership;
+    /**
+     * Canonical absolute build root containing every physical input, output,
+     * and the manifest itself.
+     *
+     * Manifest file keys are relative to this root. The serialized manifest
+     * stores the root relative to its own directory (normally `".."` for a
+     * manifest under `dist/`).
+     */
+    readonly rootDir: string;
+    /**
+     * Absolute disk path where the manifest will be written.
+     *
+     * Used by the compiler to compute canonical relative paths for all
+     * `outputs`, `inputs`, and `ComponentEntry.module` fields.
+     */
+    readonly manifestPath: string;
+    /**
+     * Bundler adapter name, e.g. `"esbuild"`.
+     *
+     * Written to `manifest.adapter.name`.
+     */
+    readonly bundlerName: string;
+    /**
+     * Bundler version string, e.g. `"0.28.1"`.
+     *
+     * Written to `manifest.adapter.bundler` as `"<bundlerName>@<bundlerVersion>"`.
+     */
+    readonly bundlerVersion: string;
+    /**
+     * Exact bytes for emitted physical output files, keyed by the same absolute
+     * output ID used in `membership.outputs`.
+     *
+     * The compiler never reads files from disk. When an adapter can supply the
+     * Adapters must provide every physical output. Omitting one is a hard
+     * adapter-contract diagnostic; a disk output can never be marked virtual to
+     * bypass stale validation.
+     */
+    readonly outputContents: ReadonlyMap<string, string | Uint8Array>;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/projection/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/projection/graph.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAEpC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACjD;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAElD,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5D;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAEtC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;CACnE"}

package/dist/projection/graph.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+export {};
+//# sourceMappingURL=graph.js.map

package/dist/projection/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/projection/graph.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/projection/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `@microsoft/webui/projection.js` — build-only state projection compiler subpath.
+ *
+ * This subpath is intentionally separate from the root `@microsoft/webui`
+ * entry so that render/build consumers do not load compiler or adapter code.
+ *
+ * Peer dependencies required by this subpath:
+ *   - `typescript` ^6.0.3  (for TypeScript AST analysis)
+ *   - `esbuild` ^0.28.1    (for the esbuild adapter only; other adapters have
+ *                            their own optional peer requirements)
+ *
+ * Both peers are optional in `package.json` so users of the root build/render
+ * API do not receive peer-missing warnings. Importing this subpath without the
+ * required peer produces `PROJ-P001` or `PROJ-P002`.
+ *
+ * See DESIGN.md §"Bundler-Neutral State Projection Compiler" for the
+ * authoritative specification.
+ */
+export type { ModuleKind, ResolvedImport, ModuleNode, ModuleGraph, OutputMembership, AdapterContext, } from "./graph.js";
+export type { ProjectionManifest, ProducerInfo, AdapterInfo, ComponentEntry, } from "./manifest.js";
+export { MANIFEST_SCHEMA, validateManifestSchema } from "./manifest.js";
+export type { ProjectionCode, DiagnosticSeverity, ProjectionDiagnostic, } from "./diagnostics.js";
+export { PROJECTION_CODES, CODE_SEVERITY, ProjectionError, } from "./diagnostics.js";
+export type { ConformanceCase, ConformanceReport, ConformanceFailure, AdapterFactory, ConformanceSuiteOptions, } from "./fixtures/conformance.js";
+export { runConformanceSuite, ALL_CASES } from "./fixtures/conformance.js";
+export { VIRTUAL_HASH, hashContent, computeBuildId, serializeManifestCanonical, } from "./manifest.js";
+/**
+ * Compile an exact state-projection manifest from an adapter-resolved graph.
+ *
+ * The implementation is loaded lazily so importing the subpath without the
+ * optional TypeScript peer produces a structured `PROJ-P001` diagnostic
+ * instead of Node's generic module-resolution error.
+ */
+export { compileProjection } from "./loader.js";
+export type { EsbuildProjectionOptions } from "./adapters/esbuild.js";
+export { esbuildProjection } from "./adapters/esbuild.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/projection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAGH,YAAY,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGxE,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3E,OAAO,EACL,YAAY,EACZ,WAAW,EACX,cAAc,EACd,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/projection/index.js

@@ -0,0 +1,17 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+export { MANIFEST_SCHEMA, validateManifestSchema } from "./manifest.js";
+export { PROJECTION_CODES, CODE_SEVERITY, ProjectionError, } from "./diagnostics.js";
+export { runConformanceSuite, ALL_CASES } from "./fixtures/conformance.js";
+// Manifest serialization/hash/build-ID utilities
+export { VIRTUAL_HASH, hashContent, computeBuildId, serializeManifestCanonical, } from "./manifest.js";
+/**
+ * Compile an exact state-projection manifest from an adapter-resolved graph.
+ *
+ * The implementation is loaded lazily so importing the subpath without the
+ * optional TypeScript peer produces a structured `PROJ-P001` diagnostic
+ * instead of Node's generic module-resolution error.
+ */
+export { compileProjection } from "./loader.js";
+export { esbuildProjection } from "./adapters/esbuild.js";
+//# sourceMappingURL=index.js.map

package/dist/projection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAsClC,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAQxE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAU1B,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3E,iDAAiD;AACjD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,cAAc,EACd,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/projection/loader.d.ts

@@ -0,0 +1,10 @@
+import type { AdapterContext } from "./graph.js";
+import type { ProjectionManifest } from "./manifest.js";
+/**
+ * Lazily load the TypeScript-backed compiler so a missing optional peer is
+ * surfaced as a stable projection diagnostic.
+ */
+export declare function compileProjection(context: AdapterContext): Promise<ProjectionManifest>;
+/** Start compiler/TypeScript loading without waiting for semantic analysis. */
+export declare function preloadProjectionCompiler(): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/projection/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/projection/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAMxD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAG7B;AAED,+EAA+E;AAC/E,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D"}

package/dist/projection/loader.js

@@ -0,0 +1,45 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+import { ProjectionError, createDiagnostic } from "./diagnostics.js";
+let compilerModule;
+/**
+ * Lazily load the TypeScript-backed compiler so a missing optional peer is
+ * surfaced as a stable projection diagnostic.
+ */
+export async function compileProjection(context) {
+    const compiler = await loadCompiler();
+    return compiler.compileProjection(context);
+}
+/** Start compiler/TypeScript loading without waiting for semantic analysis. */
+export async function preloadProjectionCompiler() {
+    await loadCompiler();
+}
+function loadCompiler() {
+    compilerModule ??= importCompiler();
+    return compilerModule;
+}
+async function importCompiler() {
+    try {
+        return await import("./compiler.js");
+    }
+    catch (error) {
+        if (isMissingTypeScriptPeer(error)) {
+            throw new ProjectionError([
+                createDiagnostic("PROJ-P001", {
+                    help: "Install a compatible application-owned TypeScript peer (^6.0.3) before using @microsoft/webui/projection.js.",
+                }),
+            ]);
+        }
+        throw error;
+    }
+}
+function isMissingTypeScriptPeer(error) {
+    if (!(error instanceof Error))
+        return false;
+    const code = error.code;
+    return (code === "ERR_MODULE_NOT_FOUND" &&
+        (error.message.includes("'typescript'") ||
+            error.message.includes('"typescript"') ||
+            error.message.includes("typescript/package.json")));
+}
+//# sourceMappingURL=loader.js.map

package/dist/projection/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/projection/loader.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAIlC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGrE,IAAI,cAAmD,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,YAAY,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,YAAY;IACnB,cAAc,KAAK,cAAc,EAAE,CAAC;IACpC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,eAAe,CAAC;gBACxB,gBAAgB,CAAC,WAAW,EAAE;oBAC5B,IAAI,EAAE,8GAA8G;iBACrH,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,IAAI,GAAI,KAAoC,CAAC,IAAI,CAAC;IACxD,OAAO,CACL,IAAI,KAAK,sBAAsB;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YACrC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YACtC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CACrD,CAAC;AACJ,CAAC"}

package/dist/projection/manifest.d.ts

@@ -0,0 +1,97 @@
+/** The only valid schema string for this version. */
+export declare const MANIFEST_SCHEMA: "webui.state-projection/v1";
+export type ManifestSchema = typeof MANIFEST_SCHEMA;
+/** Sentinel hash value for virtual modules/outputs with no physical bytes. */
+export declare const VIRTUAL_HASH: "virtual";
+/** Bytes accepted by the SHA-256 helpers. */
+export type HashContent = string | Uint8Array;
+/** Computes `"sha256:<64 lowercase hex>"` over exact UTF-8/byte content. */
+export declare function hashContent(content: HashContent): string;
+/** Cross-language lexical ordering: raw UTF-8 bytes, ascending. */
+export declare function compareUtf8(left: string, right: string): number;
+/**
+ * Computes the deterministic manifest `buildId`.
+ *
+ * Each canonical record is encoded as a record label followed by
+ * `<utf8-byte-length>:<value>` fields and one LF. Length-prefixing avoids
+ * delimiter ambiguity for paths and Unicode identifiers.
+ */
+export declare function computeBuildId(params: {
+    readonly producerName: string;
+    readonly producerVersion: string;
+    readonly adapterName: string;
+    readonly adapterBundler: string;
+    readonly root: string;
+    readonly analysisHash: string;
+    readonly sortedInputs: ReadonlyArray<readonly [string, string]>;
+    readonly sortedOutputs: ReadonlyArray<readonly [string, string]>;
+    readonly sortedComponents: ReadonlyArray<readonly [
+        tag: string,
+        module: string,
+        sortedOutputs: ReadonlyArray<string>,
+        sortedHydrationKeys: ReadonlyArray<string>,
+        sortedNavigationKeys: ReadonlyArray<string>
+    ]>;
+}): string;
+/** Serializes a manifest to its canonical compact JSON form. */
+export declare function serializeManifestCanonical(manifest: ProjectionManifest): string;
+/** Root manifest type. */
+export interface ProjectionManifest {
+    readonly schema: ManifestSchema;
+    readonly producer: ProducerInfo;
+    readonly adapter: AdapterInfo;
+    /**
+     * Build root relative to the manifest directory.
+     *
+     * `"."` or one/more parent segments (`".."`, `"../.."`). Every physical
+     * input/output/module path is relative to this root and contains no `..`.
+     */
+    readonly root: string;
+    /** SHA-256 of normalized entries, graph edges, and output membership. */
+    readonly analysisHash: string;
+    /** Deterministic identifier covering the complete serialized proof. */
+    readonly buildId: string;
+    /** Root-relative output path to content hash. */
+    readonly outputs: Readonly<Record<string, string>>;
+    /** Root-relative/virtual input ID to content hash. */
+    readonly inputs: Readonly<Record<string, string>>;
+    /** Exact component surfaces keyed by custom-element tag. */
+    readonly components: Readonly<Record<string, ComponentEntry>>;
+}
+/** Identity of the tool that produced the manifest. */
+export interface ProducerInfo {
+    readonly name: "@microsoft/webui/projection.js";
+    readonly version: string;
+}
+/** Identity of the bundler adapter. */
+export interface AdapterInfo {
+    readonly name: string;
+    readonly bundler: string;
+}
+/** One shipped WebUI component's exact client state surface. */
+export interface ComponentEntry {
+    /** Root-relative physical module path. */
+    readonly module: string;
+    /** Sorted root-relative/virtual outputs containing the defining module. */
+    readonly outputs: ReadonlyArray<string>;
+    /**
+     * Sorted exact `@observable + @attr` property names consumed during initial
+     * SSR bootstrap. Existing host attributes take precedence; state fills
+     * attribute-backed values that were not materialized on the SSR host.
+     */
+    readonly hydrationKeys: ReadonlyArray<string>;
+    /**
+     * Sorted exact property names consumed by client-created/navigation state:
+     * `@observable` plus `@attr`. Attribute decorators still use the JavaScript
+     * property name because `setState()` addresses properties, not reflected
+     * HTML attribute names.
+     */
+    readonly navigationKeys: ReadonlyArray<string>;
+}
+/**
+ * Validates a parsed manifest's structural and canonical invariants.
+ *
+ * Stale file validation is intentionally performed by the consuming host.
+ */
+export declare function validateManifestSchema(value: unknown): string[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/projection/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/projection/manifest.ts"],"names":[],"mappings":"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"}