@flighthq/vite-plugin-manifest 0.5.1-next.1680.bdc44c6

package/LICENSE.md

@@ -0,0 +1,9 @@
+# MIT License
+
+Copyright (c) 2013-2026 Joshua Granick and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @flighthq/vite-plugin-manifest
+
+Vite plugin serving generated Flight registration source from analyzed content
+
+## Install
+
+```sh
+npm install @flighthq/vite-plugin-manifest
+```
+
+Import the supported application-facing API from `@flighthq/vite-plugin-manifest`. The `@flighthq/vite-plugin-manifest/contract` export is the wider package-to-package contract used to compose Flight itself.
+
+This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
+
+- [Flight project](https://github.com/flighthq/flight)
+- [Source for @flighthq/vite-plugin-manifest@0.5.1-next.1680.bdc44c6](https://github.com/flighthq/flight/tree/bdc44c63675b7c50301154e66b79e2d29d6262da/packages/vite-plugin-manifest)
+- [License](https://github.com/flighthq/flight/blob/bdc44c63675b7c50301154e66b79e2d29d6262da/LICENSE.md)

package/dist/contentAnalyzers.d.ts

@@ -0,0 +1,18 @@
+import type { RequirementSet } from '@flighthq/types/contract';
+/**
+ * Reads one content file and reports what it requires.
+ *
+ * The plugin owns no format knowledge: an analyzer is a function the format package already exports,
+ * and this signature is only the shape they share. A new format is added by registering its analyzer
+ * here or by passing one in `analyzers`, never by teaching this package to read bytes.
+ */
+export type ContentAnalyzer = (source: Uint8Array) => RequirementSet;
+/**
+ * The formats Flight analyzes out of the box, keyed by lowercase file extension.
+ *
+ * These are the format packages' own exports called directly. Duplicating their logic here would let
+ * a build's idea of what a file needs drift from what the importer actually reads — the two must be
+ * the same walk or the manifest is a guess.
+ */
+export declare const DEFAULT_CONTENT_ANALYZERS: Readonly<Record<string, ContentAnalyzer>>;
+//# sourceMappingURL=contentAnalyzers.d.ts.map

package/dist/contentAnalyzers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentAnalyzers.d.ts","sourceRoot":"","sources":["../src/contentAnalyzers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,cAAc,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAO9E,CAAC"}

package/dist/contentAnalyzers.js

@@ -0,0 +1,18 @@
+import { parseAwd2Requirements } from '@flighthq/scene3d-formats/contract';
+import { parseSwfRequirements } from '@flighthq/swf/contract';
+/**
+ * The formats Flight analyzes out of the box, keyed by lowercase file extension.
+ *
+ * These are the format packages' own exports called directly. Duplicating their logic here would let
+ * a build's idea of what a file needs drift from what the importer actually reads — the two must be
+ * the same walk or the manifest is a guess.
+ */
+export const DEFAULT_CONTENT_ANALYZERS = Object.freeze({
+    // Away3D writes `.awd`; `.awd2` is accepted too because the format is AWD2 and projects name the
+    // file either way. Both resolve to the same analyzer, so the choice of suffix never changes what a
+    // build reads.
+    '.awd': (source) => parseAwd2Requirements(source, null, null),
+    '.awd2': (source) => parseAwd2Requirements(source, null, null),
+    '.swf': (source) => parseSwfRequirements(source, null, null),
+});
+//# sourceMappingURL=contentAnalyzers.js.map

package/dist/contentAnalyzers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentAnalyzers.js","sourceRoot":"","sources":["../src/contentAnalyzers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAY9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAA8C,MAAM,CAAC,MAAM,CAAC;IAChG,iGAAiG;IACjG,mGAAmG;IACnG,eAAe;IACf,MAAM,EAAE,CAAC,MAAkB,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;IACzE,OAAO,EAAE,CAAC,MAAkB,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;IAC1E,MAAM,EAAE,CAAC,MAAkB,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;CACzE,CAAC,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,5 @@
+export * from './contentAnalyzers';
+export * from './manifestPlugin';
+export * from './manifestModuleSource';
+export * from './requirementOptionFields';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/dist/contract.js

@@ -0,0 +1,5 @@
+export * from './contentAnalyzers';
+export * from './manifestPlugin';
+export * from './manifestModuleSource';
+export * from './requirementOptionFields';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './contentAnalyzers';
+export * from './manifestPlugin';
+export * from './manifestModuleSource';
+export * from './requirementOptionFields';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './contentAnalyzers';
+export * from './manifestPlugin';
+export * from './manifestModuleSource';
+export * from './requirementOptionFields';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/dist/manifestModuleSource.d.ts

@@ -0,0 +1,41 @@
+import type { RequirementCatalogEntry } from '@flighthq/types/contract';
+/** The backends a manifest module always exports a fragment for, and the export name each one uses. */
+export declare const MANIFEST_BACKEND_EXPORTS: Readonly<Record<string, string>>;
+/**
+ * The catalog backend whose rows become `parserOptions` rather than a render-state fragment.
+ *
+ * A row's DESTINATION is its backend, not its facet: the same `document.format` requirement resolves
+ * to a tag handler for the parser and to a node renderer for `canvas`, and only the catalog author
+ * knows which row is which. Routing by facet alone would send both to the same place.
+ */
+export declare const MANIFEST_PARSER_BACKEND = "parser";
+/** One resolved row: the catalog entry, and the requirement kind it satisfies. */
+export interface ManifestModuleEntry {
+    readonly entry: Readonly<RequirementCatalogEntry>;
+    readonly kind: string;
+}
+/** What the emitter produced, and every row it could not place. */
+export interface ManifestModuleResult {
+    /** Rows dropped with the reason, so a caller reports them instead of losing them silently. */
+    readonly problems: readonly string[];
+    readonly source: string;
+}
+/**
+ * Emits the per-file manifest module for one content file.
+ *
+ * Flat named exports — `canvasOptions`, `glOptions`, `wgpuOptions`, `domOptions`, `parserOptions` — so
+ * an application writes `import { glOptions } from './asset.swf?manifest'` and spreads it straight
+ * into `createGlRenderState`. Flat flat named bindings are what make the module shakable: a bundler
+ * that sees only `glOptions` imported can drop every other fragment AND the implementation modules
+ * only they referenced, which it could not do if the fragments hung off one default object.
+ *
+ * Every referenced symbol gets a precise named import from the module the catalog row names. There is
+ * no barrel import and no dynamic lookup, so the import graph states exactly which implementations
+ * this one file needs.
+ *
+ * Deterministic: imports are grouped by module with modules and symbols sorted, map entries are
+ * emitted in sorted kind order, and array entries keep catalog order. The same inputs always produce
+ * byte-identical source.
+ */
+export declare function generateManifestModuleSource(rows: readonly ManifestModuleEntry[], extension: string): ManifestModuleResult;
+//# sourceMappingURL=manifestModuleSource.d.ts.map

package/dist/manifestModuleSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestModuleSource.d.ts","sourceRoot":"","sources":["../src/manifestModuleSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAIxE,uGAAuG;AACvG,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKpE,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,SAAS,mBAAmB,EAAE,EACpC,SAAS,EAAE,MAAM,GAChB,oBAAoB,CAuDtB"}

package/dist/manifestModuleSource.js

@@ -0,0 +1,125 @@
+import { BACKEND_OPTION_FIELDS, PARSER_HANDLER_FIELDS, REQUIREMENT_OPTION_FIELDS } from './requirementOptionFields';
+/** The backends a manifest module always exports a fragment for, and the export name each one uses. */
+export const MANIFEST_BACKEND_EXPORTS = Object.freeze({
+    canvas: 'canvasOptions',
+    dom: 'domOptions',
+    gl: 'glOptions',
+    wgpu: 'wgpuOptions',
+});
+/**
+ * The catalog backend whose rows become `parserOptions` rather than a render-state fragment.
+ *
+ * A row's DESTINATION is its backend, not its facet: the same `document.format` requirement resolves
+ * to a tag handler for the parser and to a node renderer for `canvas`, and only the catalog author
+ * knows which row is which. Routing by facet alone would send both to the same place.
+ */
+export const MANIFEST_PARSER_BACKEND = 'parser';
+/**
+ * Emits the per-file manifest module for one content file.
+ *
+ * Flat named exports — `canvasOptions`, `glOptions`, `wgpuOptions`, `domOptions`, `parserOptions` — so
+ * an application writes `import { glOptions } from './asset.swf?manifest'` and spreads it straight
+ * into `createGlRenderState`. Flat flat named bindings are what make the module shakable: a bundler
+ * that sees only `glOptions` imported can drop every other fragment AND the implementation modules
+ * only they referenced, which it could not do if the fragments hung off one default object.
+ *
+ * Every referenced symbol gets a precise named import from the module the catalog row names. There is
+ * no barrel import and no dynamic lookup, so the import graph states exactly which implementations
+ * this one file needs.
+ *
+ * Deterministic: imports are grouped by module with modules and symbols sorted, map entries are
+ * emitted in sorted kind order, and array entries keep catalog order. The same inputs always produce
+ * byte-identical source.
+ */
+export function generateManifestModuleSource(rows, extension) {
+    const importsByModule = new Map();
+    const byBackend = new Map();
+    const parserRows = [];
+    const problems = [];
+    for (const row of rows) {
+        if (row.entry.backend === MANIFEST_PARSER_BACKEND) {
+            addImport(importsByModule, row.entry.implementationImport, row.entry.implementationSymbol);
+            parserRows.push(row);
+            continue;
+        }
+        // Two ways a render-backend row cannot be placed, and NEITHER is a silent skip. A facet with no
+        // render-state field at all (compression, physics, resource mime type) has nowhere to go; and a
+        // field this particular backend does not declare — blendRealizations on WGPU, say — would emit a
+        // fragment that spreads into nothing. Both are reported so the build can see what it lost.
+        const field = REQUIREMENT_OPTION_FIELDS[row.entry.facet];
+        if (field === undefined) {
+            problems.push(`facet ${row.entry.facet} has no render-state options field: dropped ${row.kind} for ${row.entry.backend}`);
+            continue;
+        }
+        const accepted = BACKEND_OPTION_FIELDS[row.entry.backend];
+        if (accepted === undefined) {
+            problems.push(`unknown backend ${row.entry.backend}: dropped ${row.entry.facet} ${row.kind}`);
+            continue;
+        }
+        if (!accepted.has(field)) {
+            problems.push(`backend ${row.entry.backend} has no ${field} field: dropped ${row.entry.facet} ${row.kind}`);
+            continue;
+        }
+        addImport(importsByModule, row.entry.implementationImport, row.entry.implementationSymbol);
+        let list = byBackend.get(row.entry.backend);
+        if (list === undefined) {
+            list = [];
+            byBackend.set(row.entry.backend, list);
+        }
+        list.push(row);
+    }
+    const lines = [
+        '// GENERATED by @flighthq/vite-plugin-manifest. Do not edit.',
+        `// Requirements of one ${extension} file, resolved for every backend in the catalog.`,
+    ];
+    const importLines = [...importsByModule.keys()]
+        .sort()
+        .map((module) => `import { ${[...importsByModule.get(module)].sort().join(', ')} } from '${module}';`);
+    if (importLines.length > 0)
+        lines.push('', ...importLines);
+    for (const backend of Object.keys(MANIFEST_BACKEND_EXPORTS).sort()) {
+        lines.push('', ...backendFragment(MANIFEST_BACKEND_EXPORTS[backend], byBackend.get(backend) ?? []));
+    }
+    lines.push('', ...parserFragment(parserRows, PARSER_HANDLER_FIELDS[extension] ?? 'handlers'));
+    return { problems, source: `${lines.join('\n')}\n` };
+}
+function addImport(importsByModule, module, symbol) {
+    let symbols = importsByModule.get(module);
+    if (symbols === undefined) {
+        symbols = new Set();
+        importsByModule.set(module, symbols);
+    }
+    symbols.add(symbol);
+}
+function backendFragment(exportName, rows) {
+    const byField = new Map();
+    for (const row of rows) {
+        const field = REQUIREMENT_OPTION_FIELDS[row.entry.facet];
+        let list = byField.get(field);
+        if (list === undefined) {
+            list = [];
+            byField.set(field, list);
+        }
+        list.push(row);
+    }
+    // An empty fragment is still exported. A backend this content needs nothing for must spread to
+    // nothing rather than fail to import, so an application can spread every fragment unconditionally.
+    if (byField.size === 0)
+        return [`export const ${exportName} = {};`];
+    const fields = [...byField.keys()].sort().map((field) => {
+        const entries = [...byField.get(field)]
+            .sort((a, b) => a.kind.localeCompare(b.kind))
+            .map((row) => `    ['${row.kind}', ${row.entry.implementationSymbol}],`);
+        return `  ${field}: new Map([\n${entries.join('\n')}\n  ]),`;
+    });
+    return [`export const ${exportName} = {`, ...fields, '};'];
+}
+function parserFragment(rows, field) {
+    if (rows.length === 0)
+        return ['export const parserOptions = {};'];
+    // Catalog order is preserved rather than sorted: a handler list is ordered, and reordering it
+    // changes which handler claims a contested tag and whether AWD2's build phases see their inputs.
+    const handlers = rows.map((row) => `    ${row.entry.implementationSymbol},`);
+    return [`export const parserOptions = {`, `  ${field}: [`, ...handlers, '  ],', '};'];
+}
+//# sourceMappingURL=manifestModuleSource.js.map

package/dist/manifestModuleSource.js.map

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

package/dist/manifestPlugin.d.ts

@@ -0,0 +1,45 @@
+import type { NonEntityCreateResult, RequirementCatalog } from '@flighthq/types/contract';
+/** The import suffix that asks this plugin for a file's manifest instead of the file itself. */
+export declare const MANIFEST_QUERY_SUFFIX = "?manifest";
+/** What `createManifestPlugin` accepts. Every input is explicit; nothing is discovered by convention. */
+export interface ManifestPluginOptions {
+    /** The catalog mapping a requirement to the implementation that satisfies it, for every backend. */
+    readonly catalog: Readonly<RequirementCatalog>;
+    /**
+     * Called for every unsupported format, unreadable file, analyzer failure and unresolved requirement.
+     * Defaults to a warning on the `flight-manifest` channel through `@flighthq/log`. A requirement the
+     * build cannot place is reported rather than skipped: silently dropping one is how a bundle ends up
+     * missing an implementation it needed.
+     */
+    readonly onDiagnostic?: (message: string) => void;
+}
+/** The subset of Vite's plugin surface this factory produces. Structural, so Vite is a peer, not a dep. */
+export interface ManifestPlugin {
+    /**
+     * Runs in Vite's `pre` stage. Without it Vite's own asset handling claims `./asset.swf?manifest`
+     * first and hands rollup the binary to parse as JavaScript — the plugin must see the id before the
+     * default resolver treats the path as a file to serve.
+     */
+    readonly enforce: 'pre';
+    readonly handleHotUpdate: (context: {
+        readonly file: string;
+    }) => void;
+    readonly load: (id: string) => Promise<string | null>;
+    readonly name: string;
+    readonly resolveId: (id: string, importer?: string) => string | null;
+}
+/**
+ * Creates the plugin. Explicit factory, no default export and no module-level state: importing this
+ * package configures nothing.
+ *
+ * It intercepts a per-file import — `import { glOptions } from './asset.swf?manifest'` — reads THAT
+ * file, picks the analyzer by extension, resolves the requirements against the catalog for every
+ * backend, and serves a module of flat per-backend fragments. Per-file rather than project-wide
+ * because the import graph is then the truth: a document nothing imports contributes nothing, and a
+ * bundler can see which implementations each document actually pulled in.
+ *
+ * The pipeline is the SDK's own — `parse*Requirements` to read content, the catalog to resolve. This
+ * package contributes the Vite lifecycle and the module text, nothing else.
+ */
+export declare function createManifestPlugin(options: Readonly<ManifestPluginOptions>): NonEntityCreateResult<ManifestPlugin, 'descriptor'>;
+//# sourceMappingURL=manifestPlugin.d.ts.map

package/dist/manifestPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestPlugin.d.ts","sourceRoot":"","sources":["../src/manifestPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAe,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAUvG,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAEjD,yGAAyG;AACzG,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,2GAA2G;AAC3G,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACvC,qBAAqB,CAAC,cAAc,EAAE,YAAY,CAAC,CAyErD"}

package/dist/manifestPlugin.js

@@ -0,0 +1,102 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, extname, isAbsolute, resolve } from 'node:path';
+import { logWarn } from '@flighthq/log/contract';
+import { createRequirementCodegenPlan } from '@flighthq/requirement-codegen/contract';
+import { DEFAULT_CONTENT_ANALYZERS } from './contentAnalyzers';
+import { generateManifestModuleSource, MANIFEST_BACKEND_EXPORTS, MANIFEST_PARSER_BACKEND, } from './manifestModuleSource';
+/** The import suffix that asks this plugin for a file's manifest instead of the file itself. */
+export const MANIFEST_QUERY_SUFFIX = '?manifest';
+/**
+ * Creates the plugin. Explicit factory, no default export and no module-level state: importing this
+ * package configures nothing.
+ *
+ * It intercepts a per-file import — `import { glOptions } from './asset.swf?manifest'` — reads THAT
+ * file, picks the analyzer by extension, resolves the requirements against the catalog for every
+ * backend, and serves a module of flat per-backend fragments. Per-file rather than project-wide
+ * because the import graph is then the truth: a document nothing imports contributes nothing, and a
+ * bundler can see which implementations each document actually pulled in.
+ *
+ * The pipeline is the SDK's own — `parse*Requirements` to read content, the catalog to resolve. This
+ * package contributes the Vite lifecycle and the module text, nothing else.
+ */
+export function createManifestPlugin(options) {
+    const report = options.onDiagnostic ?? ((message) => logWarn(message, MANIFEST_LOG_CHANNEL));
+    // Keyed by the absolute content path, so invalidation is per imported source: editing one document
+    // rebuilds that document's module and leaves every other file's cached module untouched.
+    const sourceByPath = new Map();
+    async function build(path) {
+        const extension = extname(path).toLowerCase();
+        const analyze = DEFAULT_CONTENT_ANALYZERS[extension];
+        if (analyze === undefined) {
+            report(`unsupported content format, no analyzer for ${extension}: ${path}`);
+            return generateManifestModuleSource([], extension).source;
+        }
+        let requirements;
+        try {
+            requirements = analyze(new Uint8Array(await readFile(path)));
+        }
+        catch (error) {
+            report(`analyzer failed for ${path}: ${error.message}`);
+            return generateManifestModuleSource([], extension).source;
+        }
+        // Resolution is the codegen kernel's job, not this plugin's. Every backend is planned, not a
+        // configured one: the module exports a fragment per backend and the application's import decides
+        // which survive the bundle. The parser is planned alongside them because parserOptions is one of
+        // those exports.
+        const rows = [];
+        const unresolvedEverywhere = new Map();
+        const resolvedSomewhere = new Set();
+        for (const backend of MANIFEST_RESOLVED_BACKENDS) {
+            const plan = createRequirementCodegenPlan(options.catalog, requirements, backend);
+            for (const entry of plan.entries) {
+                rows.push({ entry, kind: entry.kind });
+                resolvedSomewhere.add(`${entry.facet}\u0000${entry.kind}`);
+            }
+            for (const requirement of plan.unresolved) {
+                unresolvedEverywhere.set(`${requirement.facet}\u0000${requirement.key}`, requirement);
+            }
+        }
+        // Reported only when NO backend could place it. A requirement satisfied by GL but absent from the
+        // WGPU catalog is a normal per-backend gap, not a hole in the content's coverage.
+        for (const [identity, requirement] of unresolvedEverywhere) {
+            if (resolvedSomewhere.has(identity))
+                continue;
+            report(`no catalog entry for ${requirement.facet} ${requirement.key}: ${path}`);
+        }
+        const generated = generateManifestModuleSource(rows, extension);
+        for (const problem of generated.problems)
+            report(`${problem}: ${path}`);
+        return generated.source;
+    }
+    return {
+        enforce: 'pre',
+        handleHotUpdate: (context) => {
+            sourceByPath.delete(context.file);
+        },
+        load: async (id) => {
+            if (!id.startsWith(MANIFEST_RESOLVED_PREFIX))
+                return null;
+            const path = id.slice(MANIFEST_RESOLVED_PREFIX.length);
+            let source = sourceByPath.get(path);
+            if (source === undefined) {
+                source = await build(path);
+                sourceByPath.set(path, source);
+            }
+            return source;
+        },
+        name: 'flight-manifest',
+        resolveId: (id, importer) => {
+            if (!id.endsWith(MANIFEST_QUERY_SUFFIX))
+                return null;
+            const request = id.slice(0, -MANIFEST_QUERY_SUFFIX.length);
+            const base = importer === undefined ? process.cwd() : dirname(importer);
+            return `${MANIFEST_RESOLVED_PREFIX}${isAbsolute(request) ? request : resolve(base, request)}`;
+        },
+    };
+}
+// Rollup treats a leading NUL as "this id belongs to a plugin", which keeps the resolved id out of
+// filesystem resolution while still carrying the path the module was built from.
+const MANIFEST_RESOLVED_PREFIX = '\0flight-manifest:';
+const MANIFEST_LOG_CHANNEL = 'flight-manifest';
+const MANIFEST_RESOLVED_BACKENDS = [...Object.keys(MANIFEST_BACKEND_EXPORTS), MANIFEST_PARSER_BACKEND].sort();
+//# sourceMappingURL=manifestPlugin.js.map

package/dist/manifestPlugin.js.map

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

package/dist/requirementOptionFields.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The render-state options field that collects each facet's implementations.
+ *
+ * A catalog row names a facet, a kind and an implementation, but not the options field that holds it —
+ * deliberately, because a row is a fact about ownership and should not encode one consumer's option
+ * shape. This table is where the plugin decides.
+ *
+ * `document.format` maps to `nodeRenderers` for a render backend: a document's content kinds are the
+ * nodes the importer produces, so that is the field a renderer needs them in.
+ */
+export declare const REQUIREMENT_OPTION_FIELDS: Readonly<Record<string, string>>;
+/**
+ * The kind-keyed fields each backend's options type ACTUALLY declares, taken from the types package.
+ *
+ * Backend sets are not interchangeable and the differences are real: `GlRenderStateOptions` has
+ * `blendRealizations`, `pbrExtensions` and `customEffectShaders`; `WgpuRenderStateOptions` has NONE of
+ * those three. Emitting one into the other would produce a fragment that typechecks nowhere and
+ * silently does nothing when spread, so routing is per backend and a row naming a field its backend
+ * does not accept is REPORTED rather than emitted.
+ *
+ * All four backends now take ONE options object, and every set below is derived from the options type
+ * that backend actually declares rather than from a guess about which fields it ought to have.
+ * `CanvasRenderStateOptions` carries the registries and texture resolvers directly, so a canvas
+ * fragment spreads into `createCanvasRenderState(options)` like every other backend's. DOM's registry
+ * fields are seeded into the runtime at construction. Neither canvas nor DOM declares
+ * `blendRealizations`, and DOM declares no material or effect tables, so a row naming one is reported
+ * rather than emitted into a field that does not exist.
+ */
+export declare const BACKEND_OPTION_FIELDS: Readonly<Record<string, ReadonlySet<string>>>;
+/** The parser options field each content format spreads its ordered handler list into. */
+export declare const PARSER_HANDLER_FIELDS: Readonly<Record<string, string>>;
+//# sourceMappingURL=requirementOptionFields.d.ts.map

package/dist/requirementOptionFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementOptionFields.d.ts","sourceRoot":"","sources":["../src/requirementOptionFields.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrE,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CA+B9E,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIjE,CAAC"}

package/dist/requirementOptionFields.js

@@ -0,0 +1,76 @@
+import { RequirementFacet } from '@flighthq/types/contract';
+/**
+ * The render-state options field that collects each facet's implementations.
+ *
+ * A catalog row names a facet, a kind and an implementation, but not the options field that holds it —
+ * deliberately, because a row is a fact about ownership and should not encode one consumer's option
+ * shape. This table is where the plugin decides.
+ *
+ * `document.format` maps to `nodeRenderers` for a render backend: a document's content kinds are the
+ * nodes the importer produces, so that is the field a renderer needs them in.
+ */
+export const REQUIREMENT_OPTION_FIELDS = Object.freeze({
+    [RequirementFacet.DocumentFormat]: 'nodeRenderers',
+    [RequirementFacet.SceneBlendMode]: 'blendRealizations',
+    [RequirementFacet.SceneMaterialKind]: 'materialRenderers',
+    [RequirementFacet.SceneModifierKind]: 'modifierSnippets',
+    [RequirementFacet.SceneNodeKind]: 'nodeRenderers',
+    [RequirementFacet.SceneShapeCommand]: 'canvasShapeCommands',
+    [RequirementFacet.SceneTextureSourceKind]: 'textureResolvers',
+});
+/**
+ * The kind-keyed fields each backend's options type ACTUALLY declares, taken from the types package.
+ *
+ * Backend sets are not interchangeable and the differences are real: `GlRenderStateOptions` has
+ * `blendRealizations`, `pbrExtensions` and `customEffectShaders`; `WgpuRenderStateOptions` has NONE of
+ * those three. Emitting one into the other would produce a fragment that typechecks nowhere and
+ * silently does nothing when spread, so routing is per backend and a row naming a field its backend
+ * does not accept is REPORTED rather than emitted.
+ *
+ * All four backends now take ONE options object, and every set below is derived from the options type
+ * that backend actually declares rather than from a guess about which fields it ought to have.
+ * `CanvasRenderStateOptions` carries the registries and texture resolvers directly, so a canvas
+ * fragment spreads into `createCanvasRenderState(options)` like every other backend's. DOM's registry
+ * fields are seeded into the runtime at construction. Neither canvas nor DOM declares
+ * `blendRealizations`, and DOM declares no material or effect tables, so a row naming one is reported
+ * rather than emitted into a field that does not exist.
+ */
+export const BACKEND_OPTION_FIELDS = Object.freeze({
+    // Derived from the landed CanvasRenderStateOptions: it extends RenderStateOptions and
+    // CanvasRenderOptions and adds effects and materialRenderers, so these are its kind-keyed fields.
+    canvas: new Set(['canvasShapeCommands', 'effectPaddingResolvers', 'effects', 'materialRenderers', 'nodeRenderers']),
+    // D3: DomRenderOptions declares registry fields, seeded into the runtime at construction.
+    dom: new Set(['canvasShapeCommands', 'effectPaddingResolvers', 'nodeRenderers', 'textureResolvers']),
+    gl: new Set([
+        'blendRealizations',
+        'canvasShapeCommands',
+        'customEffectShaders',
+        'customMaterialShaders',
+        'effectPaddingResolvers',
+        'effects',
+        'materialRenderers',
+        'modifierSnippets',
+        'nodeRenderers',
+        'pbrExtensions',
+        'textureResolvers',
+        'velocityWriters',
+    ]),
+    wgpu: new Set([
+        'canvasShapeCommands',
+        'customMaterialShaders',
+        'effectPaddingResolvers',
+        'effects',
+        'materialRenderers',
+        'modifierSnippets',
+        'nodeRenderers',
+        'textureResolvers',
+        'velocityWriters',
+    ]),
+});
+/** The parser options field each content format spreads its ordered handler list into. */
+export const PARSER_HANDLER_FIELDS = Object.freeze({
+    '.awd': 'blocks',
+    '.awd2': 'blocks',
+    '.swf': 'tags',
+});
+//# sourceMappingURL=requirementOptionFields.js.map

package/dist/requirementOptionFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementOptionFields.js","sourceRoot":"","sources":["../src/requirementOptionFields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACvF,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE,eAAe;IAClD,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE,mBAAmB;IACtD,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,mBAAmB;IACzD,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,kBAAkB;IACxD,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,eAAe;IACjD,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,qBAAqB;IAC3D,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,EAAE,kBAAkB;CAC9D,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkD,MAAM,CAAC,MAAM,CAAC;IAChG,sFAAsF;IACtF,kGAAkG;IAClG,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,qBAAqB,EAAE,wBAAwB,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;IACnH,0FAA0F;IAC1F,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,qBAAqB,EAAE,wBAAwB,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;IACpG,EAAE,EAAE,IAAI,GAAG,CAAC;QACV,mBAAmB;QACnB,qBAAqB;QACrB,qBAAqB;QACrB,uBAAuB;QACvB,wBAAwB;QACxB,SAAS;QACT,mBAAmB;QACnB,kBAAkB;QAClB,eAAe;QACf,eAAe;QACf,kBAAkB;QAClB,iBAAiB;KAClB,CAAC;IACF,IAAI,EAAE,IAAI,GAAG,CAAC;QACZ,qBAAqB;QACrB,uBAAuB;QACvB,wBAAwB;QACxB,SAAS;QACT,mBAAmB;QACnB,kBAAkB;QAClB,eAAe;QACf,kBAAkB;QAClB,iBAAiB;KAClB,CAAC;CACH,CAAC,CAAC;AAEH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACnF,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,MAAM;CACf,CAAC,CAAC"}