@vgai/engine 0.5.11 → 0.5.13

package/dist/manifest/index.js

@@ -1,8 +1,8 @@
 // Game manifest (vgai.project.json) — schema + loader (T3.1 slice
 // 1)..
 export { isManifestFilename, MANIFEST_FILENAME, REMOVED_MANIFEST_FILENAME, removedManifestFilenameMessage, } from './filename';
-export { CAPABILITY_CEILINGS, DEFAULT_SERVER_MODULE, loadGameManifest } from './load';
-export { AdapterRootSchema, GameManifestSchema, IngestStrategySchema, RootAdapterSchema, TierSchema, } from './schema';
+export { DEFAULT_SERVER_MODULE, loadGameManifest } from './load';
+export { AdapterRootSchema, GameManifestSchema, RootAdapterSchema } from './schema';
 // `loadGameManifestFile` (Node-only, reads `path` via `node:fs`) is
 // deliberately NOT re-exported here — this barrel must stay import-safe for
 // browser bundles. Import it directly from `@engine/manifest/load-file` in

package/dist/manifest/load.d.ts

@@ -1,4 +1,4 @@
-import { type IngestStrategy, type LearnMetadata, type Tier } from './schema';
+import { type LearnMetadata } from './schema';
 /** D6's resolved adapter identities. */
 export type ResolvedAdapter = {
     readonly type: 'builtin';
@@ -13,27 +13,24 @@ export type ResolvedAdapter = {
     readonly type: 'ingest';
     readonly identity: 'ingest-three' | 'ingest-pixi' | 'ingest-react';
     readonly surface: 'three' | 'canvas' | 'dom';
-    readonly strategy: IngestStrategy;
-    readonly entryHtml: string | undefined;
     /**
      * Project-relative ES module declaring `window.vgaiGame` beside a
      * pristine copy. OPTIONAL rather than required-and-possibly-undefined
-     * (the shape its siblings above use) because it is read by exactly one
-     * mount route: every other construction site of this type — the ingest
-     * routes' own fixtures included — has nothing to say about it, and
-     * requiring the key would only make them all say `undefined`.
+     * (the shape its siblings above use) because most ingested games have
+     * nothing to say about it, and requiring the key would only make every
+     * construction site say `undefined`.
      */
     readonly contractShim?: string | undefined;
+    /**
+     * Project-relative ES module that writes this game'''s own DATA file back
+     * (see the field'''s schema description). Same OPTIONAL shape and same
+     * reason as {@link contractShim}: a game whose truth is entirely source
+     * declares nothing here.
+     */
+    readonly dataWriter?: string | undefined;
     readonly assets: Record<string, string> | undefined;
     readonly domStubs: string[] | undefined;
     readonly captureTimeoutMs: number | undefined;
-    /** Iframe-reachable-multi mount fields. */
-    readonly bundleUrl: string | undefined;
-    readonly baseHref: string | undefined;
-    readonly assetBaseUrl: string | undefined;
-    readonly extraDeps: string[] | undefined;
-    readonly pixiModuleUrl: string | undefined;
-    readonly bodyHtml: string | undefined;
 };
 export interface ResolvedAdapterRoot {
     readonly id: string;
@@ -47,11 +44,6 @@ export interface ResolvedAdapterRoot {
      *  `manifest/schema.ts`'s `dev` field for the four readers. */
     readonly dev: boolean;
     readonly loop: 'gated' | 'self-driven';
-    /** Every optional resolved: both contexts always present (§4/§5). */
-    readonly capabilities: {
-        readonly local: Tier;
-        readonly hosted: Tier;
-    };
 }
 export interface ResolvedGameManifest {
     readonly manifestVersion: 2;
@@ -71,6 +63,10 @@ export interface ResolvedGameManifest {
         readonly width: number;
         readonly height: number;
     } | undefined;
+    /** Construction-time renderer properties no world can declare for itself — see the schema. */
+    readonly rendering: {
+        readonly antialias: boolean;
+    } | undefined;
     readonly authoring: {
         readonly hierarchy?: {
             readonly rootLabels?: Readonly<Record<string, string>> | undefined;
@@ -110,54 +106,6 @@ export interface ResolvedGameManifest {
      *  gallery/wizard/Learn-catalog registries. */
     readonly learn: LearnMetadata | undefined;
 }
-/**
- * Ceiling (maximum legal declared `Tier`) per adapter type and delivery
- * context. `default` roots are always first-party in both contexts (D6/§2 —
- * a first-party root is fully vgai-native everywhere). `ingest` roots are
- * ceilinged by their own capture `strategy`: locally the local CLI's Vite
- * pipeline gives bundler dedupe, so every strategy reaches its own natural
- * rung; hosted has no bundler (esbuild-wasm + externals only), and a
- * `deduped` root is DEFINED by being source built through our pipeline — no
- * prebuilt bundle exists to fall back to an iframe rung, and nothing
- * implements a hosted build for it, so hosted is `unsupported` (honesty over
- * optimism; if the hosted esbuild-wasm path ever proves capable, raising
- * this ceiling is a non-breaking widening). `shared`/`iframe-reachable`/
- * `opaque-embed` don't depend on a bundler either way, so they carry through
- * unchanged. `module` adapters have no derivable ceiling ("a custom
- * adapter's reach is not derivable", §4) — modeled here as `first-party`
- * (the top rank), i.e. no ceiling actually constrains a module adapter's
- * declared tier; the loader instead requires the tier to be declared
- * explicitly for module roots (see `resolveCapabilities`), since there is no
- * default to derive.
- */
-export declare const CAPABILITY_CEILINGS: {
-    readonly builtin: {
-        readonly local: "first-party";
-        readonly hosted: "first-party";
-    };
-    readonly ingest: {
-        readonly shared: {
-            readonly local: "shared";
-            readonly hosted: "shared";
-        };
-        readonly deduped: {
-            readonly local: "deduped";
-            readonly hosted: "unsupported";
-        };
-        readonly 'iframe-reachable': {
-            readonly local: "iframe-reachable";
-            readonly hosted: "iframe-reachable";
-        };
-        readonly 'opaque-embed': {
-            readonly local: "opaque-embed";
-            readonly hosted: "opaque-embed";
-        };
-    };
-    readonly module: {
-        readonly local: "first-party";
-        readonly hosted: "first-party";
-    };
-};
 /** Default relative path for `server.module` when omitted (§3) — the scaffolded Colyseus bootstrap. */
 export declare const DEFAULT_SERVER_MODULE = "server/colyseus-setup.ts";
 /**

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

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

package/dist/manifest/load.js

@@ -13,49 +13,6 @@
 // wrapper that reads a path and calls this function, so browser bundles that
 // only need `loadGameManifest` never pull in `node:fs`.
 import { GameManifestSchema, } from './schema';
-// ---------------------------------------------------------------------------
-// §4 — the per-context ceiling table (named + exported so the tier-table test
-// can pin its rows against this).
-// ---------------------------------------------------------------------------
-/**
- * Ceiling (maximum legal declared `Tier`) per adapter type and delivery
- * context. `default` roots are always first-party in both contexts (D6/§2 —
- * a first-party root is fully vgai-native everywhere). `ingest` roots are
- * ceilinged by their own capture `strategy`: locally the local CLI's Vite
- * pipeline gives bundler dedupe, so every strategy reaches its own natural
- * rung; hosted has no bundler (esbuild-wasm + externals only), and a
- * `deduped` root is DEFINED by being source built through our pipeline — no
- * prebuilt bundle exists to fall back to an iframe rung, and nothing
- * implements a hosted build for it, so hosted is `unsupported` (honesty over
- * optimism; if the hosted esbuild-wasm path ever proves capable, raising
- * this ceiling is a non-breaking widening). `shared`/`iframe-reachable`/
- * `opaque-embed` don't depend on a bundler either way, so they carry through
- * unchanged. `module` adapters have no derivable ceiling ("a custom
- * adapter's reach is not derivable", §4) — modeled here as `first-party`
- * (the top rank), i.e. no ceiling actually constrains a module adapter's
- * declared tier; the loader instead requires the tier to be declared
- * explicitly for module roots (see `resolveCapabilities`), since there is no
- * default to derive.
- */
-export const CAPABILITY_CEILINGS = {
-    builtin: { local: 'first-party', hosted: 'first-party' },
-    ingest: {
-        shared: { local: 'shared', hosted: 'shared' },
-        deduped: { local: 'deduped', hosted: 'unsupported' },
-        'iframe-reachable': { local: 'iframe-reachable', hosted: 'iframe-reachable' },
-        'opaque-embed': { local: 'opaque-embed', hosted: 'opaque-embed' },
-    },
-    module: { local: 'first-party', hosted: 'first-party' },
-};
-/** Total order over `Tier` (§4: `first-party > shared ≈ deduped > iframe-reachable > opaque-embed > unsupported`). */
-const TIER_RANK = {
-    'first-party': 5,
-    shared: 4,
-    deduped: 4,
-    'iframe-reachable': 3,
-    'opaque-embed': 2,
-    unsupported: 1,
-};
 /** Default relative path for `server.module` when omitted (§3) — the scaffolded Colyseus bootstrap. */
 export const DEFAULT_SERVER_MODULE = 'server/colyseus-setup.ts';
 const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;
@@ -84,16 +41,11 @@ function checkAdapterEntryRules(root) {
         throw new Error(`Game manifest: root "${root.id}" uses the '${adapter}' adapter but declares no ` +
             '`entry` — a built-in adapter root is authored as an entry module.');
     }
+    if (typeof adapter === 'object' && 'ingest' in adapter && !root.entry) {
+        throw new Error(`Game manifest: root "${root.id}" is an { ingest } root but declares no \`entry\` — the ` +
+            "game's own entry module is what the host imports.");
+    }
 }
-// Historical note (Track N, N1): this file used to reject EVERY `kind:
-// 'react'` + `{ ingest }` root outright here (`checkReactAdapterRestriction`,
-// citing "no react ingest program is un-parked"). Track N un-parks exactly
-// that program — react+ingest is now a structurally legal combination,
-// resolved to the `'ingest-react'` identity by `resolveAdapter` below like
-// any other ingest root. There is nothing left to reject at THIS layer: the
-// v1 "deduped strategy only" restriction is an editor-resolver concern (D-N3),
-// not a manifest-shape concern — see the `ResolvedAdapter` type's comment
-// above.
 // ---------------------------------------------------------------------------
 // Resolution (§5)
 // ---------------------------------------------------------------------------
@@ -111,8 +63,7 @@ function resolveAdapter(root) {
         };
     }
     // isIngestAdapter (Track N, N1: 'ingest-react' joins 'ingest-three'/
-    // 'ingest-pixi' — see the `ResolvedAdapter` type's comment above for why
-    // this stays strategy-agnostic here).
+    // 'ingest-pixi').
     const identity = adapter.surface === 'three'
         ? 'ingest-three'
         : adapter.surface === 'canvas'
@@ -123,56 +74,13 @@ function resolveAdapter(root) {
         type: 'ingest',
         identity,
         surface: adapter.surface,
-        strategy: ingest.strategy,
-        entryHtml: ingest.entryHtml,
         contractShim: ingest.contractShim,
+        dataWriter: ingest.dataWriter,
         assets: ingest.assets,
         domStubs: ingest.domStubs,
         captureTimeoutMs: ingest.captureTimeoutMs,
-        bundleUrl: ingest.bundleUrl,
-        baseHref: ingest.baseHref,
-        assetBaseUrl: ingest.assetBaseUrl,
-        extraDeps: ingest.extraDeps,
-        pixiModuleUrl: ingest.pixiModuleUrl,
-        bodyHtml: ingest.bodyHtml,
     };
 }
-function ceilingFor(adapter, context) {
-    if (typeof adapter === 'string')
-        return CAPABILITY_CEILINGS.builtin[context];
-    if (isModuleAdapter(adapter))
-        return CAPABILITY_CEILINGS.module[context];
-    return CAPABILITY_CEILINGS.ingest[adapter.ingest.strategy][context];
-}
-function resolveCapabilities(root) {
-    const contexts = ['local', 'hosted'];
-    const result = {};
-    for (const context of contexts) {
-        const declared = root.capabilities?.[context];
-        if (declared !== undefined) {
-            const ceiling = ceilingFor(root.adapter, context);
-            if (TIER_RANK[declared] > TIER_RANK[ceiling]) {
-                throw new Error(`Game manifest: root "${root.id}": declared capabilities.${context} tier "${declared}" ` +
-                    `exceeds the "${ceiling}" ceiling for this adapter in the ${context} context (§4). ` +
-                    'Under-claiming (including `unsupported`) is legal; over-claiming is not.');
-            }
-            result[context] = declared;
-            continue;
-        }
-        // Omitted -> derive.
-        if (typeof root.adapter === 'string') {
-            result[context] = 'first-party';
-        }
-        else if (isModuleAdapter(root.adapter)) {
-            throw new Error(`Game manifest: root "${root.id}": { module } adapter requires an explicit ` +
-                `capabilities.${context} declaration — a custom adapter's reach is not derivable (§4).`);
-        }
-        else {
-            result[context] = CAPABILITY_CEILINGS.ingest[root.adapter.ingest.strategy][context];
-        }
-    }
-    return result;
-}
 function checkEngineVersionPin(version) {
     if (!SEMVER_RE.test(version)) {
         throw new Error(`Game manifest: engine.version "${version}" is not a valid exact semver string (e.g. ` +
@@ -181,17 +89,17 @@ function checkEngineVersionPin(version) {
 }
 /**
  * Resolve one already-Zod-validated root entry into its `ResolvedAdapterRoot`
- * (adapter identity, capabilities, and a pass-through of every other field).
+ * (adapter identity, and a pass-through of every other field).
  * Every `AdapterRoot` field participates here or in a check above:
  * `id` drives uniqueness; `adapter` (incl. its surface and
- * `module`/`ingest.*` sub-fields) drives identity + capability-ceiling
+ * `module`/`ingest.*` sub-fields) drives adapter identity
  * resolution; `entry` drives the entry cross-field rule and is
  * carried through; `zOrder` drives the final sort; `pausable`/`loop` are
  * carried through as-is (their consumers are the runtime/CLI, T3.2/T3.3);
  * `dev` is carried through for the four dev-layer readers (`mountManifestRoots`'s
  * ship gate, the host's topmost stacking pass, the play compositor's capture
  * exclusion, and the editor's chrome-not-content seam);
- * `capabilities.{local,hosted}` drive tier resolution; `description` (T3.3
+ * `description` (T3.3
  * slice 3) is carried through as-is — its consumer today is
  * `resolveIngestDescriptor` (packages/editor/src/adapter-resolver.ts), which
  * threads an ingest-three root's description into `IngestGame.description`.
@@ -209,7 +117,6 @@ function resolveRoot(root) {
         pausable: root.pausable,
         dev: root.dev,
         loop: root.loop,
-        capabilities: resolveCapabilities(root),
     };
 }
 // ---------------------------------------------------------------------------
@@ -234,7 +141,7 @@ export function loadGameManifest(raw) {
         // raw multi-issue dump, because each one already reads as a finished
         // sentence naming the offending ids. Every other schema violation keeps
         // propagating as the raw `ZodError` it always has (unchanged behavior,
-        // e.g. the iframe-reachable field-exclusivity / manifestVersion checks).
+        // e.g. an unrecognized key or a bad `manifestVersion`).
         const compositionIssue = parsed.error.issues.find((issue) => issue.message.startsWith('Game manifest: duplicate root id') ||
             issue.message.startsWith('Game manifest: a project has at most one'));
         if (compositionIssue)
@@ -261,6 +168,7 @@ export function loadGameManifest(raw) {
         roots,
         server,
         resolution: manifest.resolution,
+        rendering: manifest.rendering,
         authoring: manifest.authoring,
         debug: manifest.debug,
         determinism: manifest.determinism,

package/dist/manifest/schema.d.ts

@@ -4,99 +4,59 @@ import { z } from 'zod';
  * compatibility checks do not duplicate the schema's literal value.
  */
 export declare const GAME_MANIFEST_VERSION: 2;
-export declare const IngestStrategySchema: z.ZodEnum<{
-    shared: "shared";
-    deduped: "deduped";
-    "iframe-reachable": "iframe-reachable";
-    "opaque-embed": "opaque-embed";
-}>;
-export type IngestStrategy = z.infer<typeof IngestStrategySchema>;
-export declare const TierSchema: z.ZodEnum<{
-    shared: "shared";
-    deduped: "deduped";
-    "iframe-reachable": "iframe-reachable";
-    "opaque-embed": "opaque-embed";
-    "first-party": "first-party";
-    unsupported: "unsupported";
-}>;
-export type Tier = z.infer<typeof TierSchema>;
 export declare const RootAdapterSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodUnion<readonly [z.ZodEnum<{
-    three: "three";
     canvas: "canvas";
+    three: "three";
     dom: "dom";
 }>, z.ZodObject<{
     module: z.ZodString;
     surface: z.ZodEnum<{
-        three: "three";
         canvas: "canvas";
+        three: "three";
         dom: "dom";
     }>;
 }, z.core.$strict>, z.ZodObject<{
     surface: z.ZodEnum<{
-        three: "three";
         canvas: "canvas";
+        three: "three";
         dom: "dom";
     }>;
     ingest: z.ZodObject<{
-        strategy: z.ZodEnum<{
-            shared: "shared";
-            deduped: "deduped";
-            "iframe-reachable": "iframe-reachable";
-            "opaque-embed": "opaque-embed";
-        }>;
-        entryHtml: z.ZodOptional<z.ZodString>;
         contractShim: z.ZodOptional<z.ZodString>;
+        dataWriter: z.ZodOptional<z.ZodString>;
         assets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         domStubs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         captureTimeoutMs: z.ZodOptional<z.ZodNumber>;
-        bundleUrl: z.ZodOptional<z.ZodString>;
-        baseHref: z.ZodOptional<z.ZodString>;
-        assetBaseUrl: z.ZodOptional<z.ZodString>;
-        extraDeps: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        pixiModuleUrl: z.ZodOptional<z.ZodString>;
-        bodyHtml: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
 }, z.core.$strict>]>>;
 export type RootAdapter = z.infer<typeof RootAdapterSchema>;
 export declare const AdapterRootSchema: z.ZodObject<{
     id: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     adapter: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodUnion<readonly [z.ZodEnum<{
-        three: "three";
         canvas: "canvas";
+        three: "three";
         dom: "dom";
     }>, z.ZodObject<{
         module: z.ZodString;
         surface: z.ZodEnum<{
-            three: "three";
             canvas: "canvas";
+            three: "three";
             dom: "dom";
         }>;
     }, z.core.$strict>, z.ZodObject<{
         surface: z.ZodEnum<{
-            three: "three";
             canvas: "canvas";
+            three: "three";
             dom: "dom";
         }>;
         ingest: z.ZodObject<{
-            strategy: z.ZodEnum<{
-                shared: "shared";
-                deduped: "deduped";
-                "iframe-reachable": "iframe-reachable";
-                "opaque-embed": "opaque-embed";
-            }>;
-            entryHtml: z.ZodOptional<z.ZodString>;
             contractShim: z.ZodOptional<z.ZodString>;
+            dataWriter: z.ZodOptional<z.ZodString>;
             assets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             domStubs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             captureTimeoutMs: z.ZodOptional<z.ZodNumber>;
-            bundleUrl: z.ZodOptional<z.ZodString>;
-            baseHref: z.ZodOptional<z.ZodString>;
-            assetBaseUrl: z.ZodOptional<z.ZodString>;
-            extraDeps: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            pixiModuleUrl: z.ZodOptional<z.ZodString>;
-            bodyHtml: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
+        }, z.core.$strict>;
     }, z.core.$strict>]>>;
     entry: z.ZodOptional<z.ZodString>;
     zOrder: z.ZodDefault<z.ZodNumber>;
@@ -106,24 +66,6 @@ export declare const AdapterRootSchema: z.ZodObject<{
         gated: "gated";
         "self-driven": "self-driven";
     }>>;
-    capabilities: z.ZodOptional<z.ZodObject<{
-        local: z.ZodOptional<z.ZodEnum<{
-            shared: "shared";
-            deduped: "deduped";
-            "iframe-reachable": "iframe-reachable";
-            "opaque-embed": "opaque-embed";
-            "first-party": "first-party";
-            unsupported: "unsupported";
-        }>>;
-        hosted: z.ZodOptional<z.ZodEnum<{
-            shared: "shared";
-            deduped: "deduped";
-            "iframe-reachable": "iframe-reachable";
-            "opaque-embed": "opaque-embed";
-            "first-party": "first-party";
-            unsupported: "unsupported";
-        }>>;
-    }, z.core.$strip>>;
 }, z.core.$strict>;
 export type AdapterRoot = z.infer<typeof AdapterRootSchema>;
 export declare const LearnKindSchema: z.ZodEnum<{
@@ -172,41 +114,29 @@ export declare const GameManifestSchema: z.ZodObject<{
         id: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         adapter: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodUnion<readonly [z.ZodEnum<{
-            three: "three";
             canvas: "canvas";
+            three: "three";
             dom: "dom";
         }>, z.ZodObject<{
             module: z.ZodString;
             surface: z.ZodEnum<{
-                three: "three";
                 canvas: "canvas";
+                three: "three";
                 dom: "dom";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             surface: z.ZodEnum<{
-                three: "three";
                 canvas: "canvas";
+                three: "three";
                 dom: "dom";
             }>;
             ingest: z.ZodObject<{
-                strategy: z.ZodEnum<{
-                    shared: "shared";
-                    deduped: "deduped";
-                    "iframe-reachable": "iframe-reachable";
-                    "opaque-embed": "opaque-embed";
-                }>;
-                entryHtml: z.ZodOptional<z.ZodString>;
                 contractShim: z.ZodOptional<z.ZodString>;
+                dataWriter: z.ZodOptional<z.ZodString>;
                 assets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 domStubs: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 captureTimeoutMs: z.ZodOptional<z.ZodNumber>;
-                bundleUrl: z.ZodOptional<z.ZodString>;
-                baseHref: z.ZodOptional<z.ZodString>;
-                assetBaseUrl: z.ZodOptional<z.ZodString>;
-                extraDeps: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                pixiModuleUrl: z.ZodOptional<z.ZodString>;
-                bodyHtml: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
+            }, z.core.$strict>;
         }, z.core.$strict>]>>;
         entry: z.ZodOptional<z.ZodString>;
         zOrder: z.ZodDefault<z.ZodNumber>;
@@ -216,24 +146,6 @@ export declare const GameManifestSchema: z.ZodObject<{
             gated: "gated";
             "self-driven": "self-driven";
         }>>;
-        capabilities: z.ZodOptional<z.ZodObject<{
-            local: z.ZodOptional<z.ZodEnum<{
-                shared: "shared";
-                deduped: "deduped";
-                "iframe-reachable": "iframe-reachable";
-                "opaque-embed": "opaque-embed";
-                "first-party": "first-party";
-                unsupported: "unsupported";
-            }>>;
-            hosted: z.ZodOptional<z.ZodEnum<{
-                shared: "shared";
-                deduped: "deduped";
-                "iframe-reachable": "iframe-reachable";
-                "opaque-embed": "opaque-embed";
-                "first-party": "first-party";
-                unsupported: "unsupported";
-            }>>;
-        }, z.core.$strip>>;
     }, z.core.$strict>>;
     authoring: z.ZodOptional<z.ZodObject<{
         hierarchy: z.ZodOptional<z.ZodObject<{
@@ -258,6 +170,9 @@ export declare const GameManifestSchema: z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strip>>;
+    rendering: z.ZodOptional<z.ZodObject<{
+        antialias: z.ZodBoolean;
+    }, z.core.$strict>>;
     debug: z.ZodOptional<z.ZodObject<{
         allowInProduction: z.ZodBoolean;
     }, z.core.$strip>>;

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/manifest/schema.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAMhD,eAAO,MAAM,oBAAoB;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,eAAO,MAAM,UAAU;;;;;;;EAOrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAsF9C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAmP3B,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoEnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAkB5D,eAAO,MAAM,eAAe;;;;;EAMzB,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB;;;;EAEa,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;kBAqC7B,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+RyD,CAAC;AAEzF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/manifest/schema.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAsFhD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;qBAuG3B,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsDnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAkB5D,eAAO,MAAM,eAAe;;;;;EAMzB,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB;;;;EAEa,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;kBAqC7B,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqTyD,CAAC;AAEzF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}