@kite3d/engine 0.18.0 → 0.19.0-alpha.1

package/dist/projectFormat.js

@@ -1,125 +1,114 @@
-import { parse as j } from "jsonc-parser";
-const S = "kite3d", y = `/${S}/`;
-function O(t, e) {
-  const n = `${y}@`;
+import { parse as v } from "jsonc-parser";
+const y = "kite3d", w = `/${y}/`, j = "Generator components were removed in Kite3D 0.19.0.";
+function O(e, n) {
+  const t = `${w}@`;
   return (o) => {
-    var c;
-    if (o.startsWith(n)) {
-      const p = new URL(o, "https://kite3d.invalid"), a = decodeURIComponent(p.pathname.slice(n.length)), r = a.indexOf("/"), d = r < 0 ? a : a.slice(0, r), f = r < 0 ? "" : a.slice(r + 1), s = e.files[d];
+    var f;
+    if (o.startsWith(t)) {
+      const i = new URL(o, "https://kite3d.invalid"), a = decodeURIComponent(i.pathname.slice(t.length)), c = a.indexOf("/"), d = c < 0 ? a : a.slice(0, c), p = c < 0 ? "" : a.slice(c + 1), s = n.files[d];
       if (!(s != null && s.path)) throw new Error(`Unknown asset id in URL: ${d}`);
-      const i = (c = s.files) == null ? void 0 : c[f];
-      if (i) return new URL(i, t).href;
-      if (s.files) throw new Error(`Unknown file for asset ${d}: ${f}`);
-      return /^f\.[^/]+$/i.test(f) ? new URL(s.path, t).href : new URL(f, new URL(s.path, t)).href;
+      const r = (f = s.files) == null ? void 0 : f[p];
+      if (r) return new URL(r, e).href;
+      if (s.files) throw new Error(`Unknown file for asset ${d}: ${p}`);
+      return /^f\.[^/]+$/i.test(p) ? new URL(s.path, e).href : new URL(p, new URL(s.path, e)).href;
     }
-    return o.startsWith(y) ? new URL(o.slice(y.length), t).href : o;
+    return o.startsWith(w) ? new URL(o.slice(w.length), e).href : o;
   };
 }
-function b(t, e) {
-  const n = e.dependencies;
-  return h(n) && Object.prototype.hasOwnProperty.call(n, t);
+function R(e, n) {
+  const t = n.dependencies;
+  return S(t) && Object.prototype.hasOwnProperty.call(t, e);
 }
-function x(t) {
-  const e = j(t);
-  if (!e || typeof e != "object" || Array.isArray(e))
+function U(e) {
+  const n = v(e);
+  if (!n || typeof n != "object" || Array.isArray(n))
     throw new Error("Invalid package.json file: expected an object");
-  const n = e;
-  if (typeof n.mainScene != "string" || !n.mainScene.toLowerCase().endsWith(".gltf"))
+  const t = n;
+  if (typeof t.mainScene != "string" || !t.mainScene.toLowerCase().endsWith(".gltf"))
     throw new Error("package.json mainScene must name a text .gltf file");
-  return n;
+  return t;
 }
-function U(t) {
-  const e = j(t);
-  if (e.files && typeof e.files != "object")
+function b(e) {
+  const n = v(e);
+  if (n.files && typeof n.files != "object")
     throw new Error("Invalid assets.json file: files should be an object");
-  if (e.version !== void 0 && typeof e.version != "number")
+  if (n.version !== void 0 && typeof n.version != "number")
     throw new Error("Invalid assets.json file: version should be a number");
-  return e.files || (e.files = {}), e.version || (e.version = 1), e;
+  return n.files || (n.files = {}), n.version || (n.version = 1), n;
 }
-function k(t, e) {
-  const n = JSON.parse(e);
-  if (!n || typeof n != "object" || !n.asset)
-    throw new Error(`${t} is not a JSON glTF document`);
+function k(e, n) {
+  const t = JSON.parse(n);
+  if (!t || typeof t != "object" || !t.asset)
+    throw new Error(`${e} is not a JSON glTF document`);
 }
-function P(t) {
-  var e;
-  try {
-    const n = JSON.parse(t), o = [];
-    for (const [c, p] of (n.nodes || []).entries())
-      for (const [a, r] of Object.entries(((e = p.extras) == null ? void 0 : e.EntityComponentPlugin) || {}))
-        r.type !== "Generator" || !h(r.state) || o.push({
-          componentId: a,
-          module: typeof r.state.module == "string" ? r.state.module : "",
-          nodeIndex: c,
-          nodeName: typeof p.name == "string" ? p.name : `Node ${c}`,
-          params: h(r.state.params) ? r.state.params : {},
-          schema: {}
-        });
-    return o;
-  } catch {
-    return [];
-  }
+function A(e) {
+  var o;
+  const n = JSON.parse(e), t = [];
+  for (const [f, i] of (n.nodes || []).entries())
+    Object.values(((o = i.extras) == null ? void 0 : o.EntityComponentPlugin) || {}).some(({ type: c }) => c === "Generator") && t.push({
+      nodeIndex: f,
+      nodeName: typeof i.name == "string" && i.name.trim() ? i.name : `Node ${f}`
+    });
+  return t;
 }
-function E(t, e, n) {
-  var p, a, r, d, f;
-  const o = JSON.parse(t), c = (f = (d = (r = (a = (p = o.nodes) == null ? void 0 : p[e.nodeIndex]) == null ? void 0 : a.extras) == null ? void 0 : r.EntityComponentPlugin) == null ? void 0 : d[e.componentId]) == null ? void 0 : f.state;
-  if (!h(c)) throw new Error(`Generator component is missing on ${e.nodeName}`);
-  return Object.assign(c, n), { text: JSON.stringify(o, null, 2), state: c };
+function $(e) {
+  return `${j} Convert ${e} to asset files. See the guide's Scene asset management section.`;
 }
-async function N(t, e) {
-  var d, f;
-  const n = t[S] ?? {}, o = [], p = {
-    ...t.dependencies && typeof t.dependencies == "object" && !Array.isArray(t.dependencies) ? t.dependencies : {}
+async function N(e, n) {
+  var d, p;
+  const t = e[y] ?? {}, o = [], i = {
+    ...e.dependencies && typeof e.dependencies == "object" && !Array.isArray(e.dependencies) ? e.dependencies : {}
   };
-  o.push(...Object.entries(p).map(([s, i]) => ({ key: s, version: i }))), n.imports && o.push(...Object.entries(n.imports).map(([s, i]) => ({
+  o.push(...Object.entries(i).map(([s, r]) => ({ key: s, version: r }))), t.imports && o.push(...Object.entries(t.imports).map(([s, r]) => ({
     key: s,
-    url: i.startsWith("@") ? void 0 : i,
-    version: i.startsWith("@") ? i.slice(1) : ""
+    url: r.startsWith("@") ? void 0 : r,
+    version: r.startsWith("@") ? r.slice(1) : ""
   })));
-  const a = ((d = n.plugins) == null ? void 0 : d.map((s) => {
+  const a = ((d = t.plugins) == null ? void 0 : d.map((s) => {
     if (typeof s != "string") return s;
-    const i = s.match(/\((.*)\)$/);
-    let g, l = s;
-    if (i) {
-      const w = i[1].trim();
-      if (l = s.slice(0, i.index).trim(), w)
+    const r = s.match(/\((.*)\)$/);
+    let h, l = s;
+    if (r) {
+      const g = r[1].trim();
+      if (l = s.slice(0, r.index).trim(), g)
         try {
           const m = [];
-          if (g = j(`[${w}]`, m), !Array.isArray(g) || m.length)
+          if (h = v(`[${g}]`, m), !Array.isArray(h) || m.length)
             throw console.error(m), new Error("Plugin params is not a valid array");
         } catch (m) {
-          return console.error("Unable to parse plugin params, skipping plugin", s, w, m), null;
+          return console.error("Unable to parse plugin params, skipping plugin", s, g, m), null;
         }
     }
     const u = l.lastIndexOf(":");
     return {
       import: u !== -1 ? l.slice(0, u) : l,
       className: u !== -1 ? l.slice(u + 1) : void 0,
-      params: g
+      params: h
     };
-  })) || [], r = ((f = n.scripts) == null ? void 0 : f.map(
+  })) || [], c = ((p = t.scripts) == null ? void 0 : p.map(
     (s) => typeof s == "string" ? { import: s } : s
   )) || [];
   return {
     plugins: a.filter(Boolean),
-    scripts: r,
+    scripts: c,
     dependencies: o,
-    viewer: n.viewer || {}
+    viewer: t.viewer || {}
   };
 }
-function h(t) {
-  return !!t && typeof t == "object" && !Array.isArray(t);
+function S(e) {
+  return !!e && typeof e == "object" && !Array.isArray(e);
 }
 export {
-  y as assetUrlPrefix,
+  j as REMOVED_GENERATOR_GUIDANCE,
+  w as assetUrlPrefix,
   O as createProjectAssetURLModifier,
-  b as isDependencyModuleSpecifier,
-  U as parseAssetsJSONManifest,
-  x as parsePackageJSON,
+  A as findRemovedGeneratorNodes,
+  R as isDependencyModuleSpecifier,
+  b as parseAssetsJSONManifest,
+  U as parsePackageJSON,
   N as parsePackageJsonSettingsConfig,
-  P as readProjectGeneratorStates,
-  S as settingsKey,
-  E as updateProjectGeneratorState,
+  $ as removedGeneratorMessage,
+  y as settingsKey,
   k as validateSceneSource
 };
 //# sourceMappingURL=projectFormat.js.map

package/dist/projectFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"projectFormat.js","sources":["../src/runtime/projectFormat.ts"],"sourcesContent":["import {parse, ParseError} from 'jsonc-parser'\nimport type {GeneratorParamSchema} from '../generatorParams.ts'\n\nexport const settingsKey = 'kite3d'\nexport const assetUrlPrefix = `/${settingsKey}/`\n\nexport type JSONValue = string | number | boolean | null | JSONValue[] | {[key: string]: JSONValue}\nexport type ProjectPackageJSON = Record<string, JSONValue> & {mainScene: string}\n\nexport interface ProjectGeneratorState {\n    componentId: string\n    module: string\n    nodeIndex: number\n    nodeName: string\n    params: Record<string, unknown>\n    schema: GeneratorParamSchema\n}\n\nexport interface AssetsJSONManifest {\n    files: Record<string, {\n        path: string\n        files?: Record<string, string>\n    }>\n    version: number\n}\n\nexport function createProjectAssetURLModifier(base: URL, assets: AssetsJSONManifest) {\n    const assetIdPrefix = `${assetUrlPrefix}@`\n    return (url: string): string => {\n        if (url.startsWith(assetIdPrefix)) {\n            const request = new URL(url, 'https://kite3d.invalid')\n            const relative = decodeURIComponent(request.pathname.slice(assetIdPrefix.length))\n            const slash = relative.indexOf('/')\n            const id = slash < 0 ? relative : relative.slice(0, slash)\n            const assetPath = slash < 0 ? '' : relative.slice(slash + 1)\n            const asset = assets.files[id]\n            if (!asset?.path) throw new Error(`Unknown asset id in URL: ${id}`)\n            const registered = asset.files?.[assetPath]\n            if (registered) return new URL(registered, base).href\n            if (asset.files) throw new Error(`Unknown file for asset ${id}: ${assetPath}`)\n            if (/^f\\.[^/]+$/i.test(assetPath)) return new URL(asset.path, base).href\n            return new URL(assetPath, new URL(asset.path, base)).href\n        }\n        if (url.startsWith(assetUrlPrefix)) {\n            return new URL(url.slice(assetUrlPrefix.length), base).href\n        }\n        return url\n    }\n}\n\nexport interface ProjectDependency {\n    key: string\n    version: string\n    url?: string\n}\n\nexport interface ExternalPlugin {\n    import: string\n    /** @default `default` */\n    className?: string\n    /** @default true */\n    active?: boolean\n    /** Constructor parameters. */\n    params?: JSONValue[]\n}\n\nexport interface ExternalScript {\n    import: string\n    /** @default true */\n    active?: boolean\n}\n\nexport interface ProjectViewerSettings {\n    msaa?: boolean\n    rgbm?: boolean\n    zPrepass?: boolean\n    renderScale?: number | 'auto'\n    maxRenderScale?: number\n    backgroundColor?: string | number | null\n    modelRootScale?: number\n    stencil?: boolean\n    debug?: boolean\n    tonemap?: boolean\n    camera?: {\n        type?: 'perspective' | 'orthographic'\n        controlsMode?: string\n        position?: [number, number, number]\n        target?: [number, number, number]\n    }\n    maxHDRIntensity?: number\n    powerPreference?: 'default' | 'high-performance' | 'low-power'\n}\n\nexport interface ProjectConfigSettings {\n    plugins: ExternalPlugin[]\n    scripts: ExternalScript[]\n    dependencies: ProjectDependency[]\n    viewer: ProjectViewerSettings\n}\n\nexport interface ProjectConfigSettingsJSON {\n    plugins?: (ExternalPlugin | string)[]\n    imports?: Record<string, string>\n    scripts?: (ExternalScript | string)[]\n    viewer?: ProjectViewerSettings\n}\n\n/** A configured script or plugin is package-backed only when it names a declared dependency exactly. */\nexport function isDependencyModuleSpecifier(\n    specifier: string,\n    packageJson: ProjectPackageJSON,\n): boolean {\n    const dependencies = packageJson.dependencies\n    return isRecord(dependencies) && Object.prototype.hasOwnProperty.call(dependencies, specifier)\n}\n\nexport function parsePackageJSON(text: string): ProjectPackageJSON {\n    const json = parse(text) as unknown\n    if (!json || typeof json !== 'object' || Array.isArray(json)) {\n        throw new Error('Invalid package.json file: expected an object')\n    }\n    const packageJson = json as ProjectPackageJSON\n    if (typeof packageJson.mainScene !== 'string' || !packageJson.mainScene.toLowerCase().endsWith('.gltf')) {\n        throw new Error('package.json mainScene must name a text .gltf file')\n    }\n    return packageJson\n}\n\nexport function parseAssetsJSONManifest(text: string): AssetsJSONManifest {\n    const json = parse(text) as AssetsJSONManifest\n\n    if (json.files && typeof json.files !== 'object') {\n        throw new Error('Invalid assets.json file: files should be an object')\n    }\n    if (json.version !== undefined && typeof json.version !== 'number') {\n        throw new Error('Invalid assets.json file: version should be a number')\n    }\n\n    if (!json.files) json.files = {}\n    if (!json.version) json.version = 1\n\n    return json\n}\n\nexport function validateSceneSource(path: string, text: string): void {\n    const document = JSON.parse(text) as {asset?: unknown}\n    if (!document || typeof document !== 'object' || !document.asset) {\n        throw new Error(`${path} is not a JSON glTF document`)\n    }\n}\n\nexport function readProjectGeneratorStates(text: string): ProjectGeneratorState[] {\n    try {\n        const document = JSON.parse(text) as {\n            nodes?: Array<{\n                name?: unknown\n                extras?: {EntityComponentPlugin?: Record<string, {type?: unknown, state?: unknown}>}\n            }>\n        }\n        const generators: ProjectGeneratorState[] = []\n        for (const [nodeIndex, node] of (document.nodes || []).entries()) {\n            for (const [componentId, component] of Object.entries(node.extras?.EntityComponentPlugin || {})) {\n                if (component.type !== 'Generator' || !isRecord(component.state)) continue\n                generators.push({\n                    componentId,\n                    module: typeof component.state.module === 'string' ? component.state.module : '',\n                    nodeIndex,\n                    nodeName: typeof node.name === 'string' ? node.name : `Node ${nodeIndex}`,\n                    params: isRecord(component.state.params) ? component.state.params : {},\n                    schema: {},\n                })\n            }\n        }\n        return generators\n    } catch {\n        return []\n    }\n}\n\nexport function updateProjectGeneratorState(\n    text: string,\n    generator: Pick<ProjectGeneratorState, 'componentId' | 'nodeIndex' | 'nodeName'>,\n    update: Partial<Pick<ProjectGeneratorState, 'module' | 'params'>>,\n): {text: string, state: Record<string, unknown>} {\n    const document = JSON.parse(text) as {\n        nodes?: Array<{extras?: {EntityComponentPlugin?: Record<string, {state?: unknown}>}}>\n    }\n    const state = document.nodes?.[generator.nodeIndex]?.extras?.EntityComponentPlugin?.[generator.componentId]?.state\n    if (!isRecord(state)) throw new Error(`Generator component is missing on ${generator.nodeName}`)\n    Object.assign(state, update)\n    return {text: JSON.stringify(document, null, 2), state}\n}\n\nexport async function parsePackageJsonSettingsConfig(json: ProjectPackageJSON, _project?: unknown): Promise<ProjectConfigSettings> {\n    const config = (json[settingsKey] ?? {}) as ProjectConfigSettingsJSON\n    const dependencies: ProjectDependency[] = []\n    const packageDependencies = json.dependencies && typeof json.dependencies === 'object' && !Array.isArray(json.dependencies)\n        ? json.dependencies as Record<string, string>\n        : {}\n    const deps: Record<string, string> = {\n        ...packageDependencies,\n    }\n\n    dependencies.push(...Object.entries(deps).map(([key, version]) => ({key, version})))\n\n    if (config.imports) {\n        dependencies.push(...Object.entries(config.imports).map(([key, url]) => ({\n            key,\n            url: !url.startsWith('@') ? url : undefined,\n            version: url.startsWith('@') ? url.slice(1) : '',\n        })))\n    }\n\n    const plugins = config.plugins?.map((entry) => {\n        if (typeof entry !== 'string') return entry\n\n        const match = entry.match(/\\((.*)\\)$/)\n        let params: JSONValue[] | undefined\n        let spec = entry\n\n        if (match) {\n            const paramString = match[1].trim()\n            spec = entry.slice(0, match.index).trim()\n            if (paramString) {\n                try {\n                    const errors: ParseError[] = []\n                    params = parse(`[${paramString}]`, errors)\n                    if (!Array.isArray(params) || errors.length) {\n                        console.error(errors)\n                        throw new Error('Plugin params is not a valid array')\n                    }\n                } catch (error) {\n                    console.error('Unable to parse plugin params, skipping plugin', entry, paramString, error)\n                    return null\n                }\n            }\n        }\n\n        const separator = spec.lastIndexOf(':')\n        return {\n            import: separator !== -1 ? spec.slice(0, separator) : spec,\n            className: separator !== -1 ? spec.slice(separator + 1) : undefined,\n            params,\n        } satisfies ExternalPlugin\n    }) || []\n\n    const scripts = config.scripts?.map((entry) =>\n        typeof entry === 'string' ? {import: entry} : entry\n    ) || []\n\n    return {\n        plugins: plugins.filter(Boolean) as ExternalPlugin[],\n        scripts,\n        dependencies,\n        viewer: config.viewer || {},\n    }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n"],"names":["settingsKey","assetUrlPrefix","createProjectAssetURLModifier","base","assets","assetIdPrefix","url","request","relative","slash","id","assetPath","asset","registered","_a","isDependencyModuleSpecifier","specifier","packageJson","dependencies","isRecord","parsePackageJSON","text","json","parse","parseAssetsJSONManifest","validateSceneSource","path","document","readProjectGeneratorStates","generators","nodeIndex","node","componentId","component","updateProjectGeneratorState","generator","update","state","_e","_d","_c","_b","parsePackageJsonSettingsConfig","_project","config","deps","key","version","plugins","entry","match","params","spec","paramString","errors","error","separator","scripts","value"],"mappings":"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"}
+{"version":3,"file":"projectFormat.js","sources":["../src/runtime/projectFormat.ts"],"sourcesContent":["import {parse, ParseError} from 'jsonc-parser'\n\nexport const settingsKey = 'kite3d'\nexport const assetUrlPrefix = `/${settingsKey}/`\nexport const REMOVED_GENERATOR_GUIDANCE = 'Generator components were removed in Kite3D 0.19.0.'\n\nexport type JSONValue = string | number | boolean | null | JSONValue[] | {[key: string]: JSONValue}\nexport type ProjectPackageJSON = Record<string, JSONValue> & {mainScene: string}\n\nexport interface AssetsJSONManifest {\n    files: Record<string, {\n        path: string\n        files?: Record<string, string>\n    }>\n    version: number\n}\n\nexport function createProjectAssetURLModifier(base: URL, assets: AssetsJSONManifest) {\n    const assetIdPrefix = `${assetUrlPrefix}@`\n    return (url: string): string => {\n        if (url.startsWith(assetIdPrefix)) {\n            const request = new URL(url, 'https://kite3d.invalid')\n            const relative = decodeURIComponent(request.pathname.slice(assetIdPrefix.length))\n            const slash = relative.indexOf('/')\n            const id = slash < 0 ? relative : relative.slice(0, slash)\n            const assetPath = slash < 0 ? '' : relative.slice(slash + 1)\n            const asset = assets.files[id]\n            if (!asset?.path) throw new Error(`Unknown asset id in URL: ${id}`)\n            const registered = asset.files?.[assetPath]\n            if (registered) return new URL(registered, base).href\n            if (asset.files) throw new Error(`Unknown file for asset ${id}: ${assetPath}`)\n            if (/^f\\.[^/]+$/i.test(assetPath)) return new URL(asset.path, base).href\n            return new URL(assetPath, new URL(asset.path, base)).href\n        }\n        if (url.startsWith(assetUrlPrefix)) {\n            return new URL(url.slice(assetUrlPrefix.length), base).href\n        }\n        return url\n    }\n}\n\nexport interface ProjectDependency {\n    key: string\n    version: string\n    url?: string\n}\n\nexport interface ExternalPlugin {\n    import: string\n    /** @default `default` */\n    className?: string\n    /** @default true */\n    active?: boolean\n    /** Constructor parameters. */\n    params?: JSONValue[]\n}\n\nexport interface ExternalScript {\n    import: string\n    /** @default true */\n    active?: boolean\n}\n\nexport interface ProjectViewerSettings {\n    msaa?: boolean\n    rgbm?: boolean\n    zPrepass?: boolean\n    renderScale?: number | 'auto'\n    maxRenderScale?: number\n    backgroundColor?: string | number | null\n    modelRootScale?: number\n    stencil?: boolean\n    debug?: boolean\n    tonemap?: boolean\n    camera?: {\n        type?: 'perspective' | 'orthographic'\n        controlsMode?: string\n        position?: [number, number, number]\n        target?: [number, number, number]\n    }\n    maxHDRIntensity?: number\n    powerPreference?: 'default' | 'high-performance' | 'low-power'\n}\n\nexport interface ProjectConfigSettings {\n    plugins: ExternalPlugin[]\n    scripts: ExternalScript[]\n    dependencies: ProjectDependency[]\n    viewer: ProjectViewerSettings\n}\n\nexport interface ProjectConfigSettingsJSON {\n    plugins?: (ExternalPlugin | string)[]\n    imports?: Record<string, string>\n    scripts?: (ExternalScript | string)[]\n    viewer?: ProjectViewerSettings\n}\n\n/** A configured script or plugin is package-backed only when it names a declared dependency exactly. */\nexport function isDependencyModuleSpecifier(\n    specifier: string,\n    packageJson: ProjectPackageJSON,\n): boolean {\n    const dependencies = packageJson.dependencies\n    return isRecord(dependencies) && Object.prototype.hasOwnProperty.call(dependencies, specifier)\n}\n\nexport function parsePackageJSON(text: string): ProjectPackageJSON {\n    const json = parse(text) as unknown\n    if (!json || typeof json !== 'object' || Array.isArray(json)) {\n        throw new Error('Invalid package.json file: expected an object')\n    }\n    const packageJson = json as ProjectPackageJSON\n    if (typeof packageJson.mainScene !== 'string' || !packageJson.mainScene.toLowerCase().endsWith('.gltf')) {\n        throw new Error('package.json mainScene must name a text .gltf file')\n    }\n    return packageJson\n}\n\nexport function parseAssetsJSONManifest(text: string): AssetsJSONManifest {\n    const json = parse(text) as AssetsJSONManifest\n\n    if (json.files && typeof json.files !== 'object') {\n        throw new Error('Invalid assets.json file: files should be an object')\n    }\n    if (json.version !== undefined && typeof json.version !== 'number') {\n        throw new Error('Invalid assets.json file: version should be a number')\n    }\n\n    if (!json.files) json.files = {}\n    if (!json.version) json.version = 1\n\n    return json\n}\n\nexport function validateSceneSource(path: string, text: string): void {\n    const document = JSON.parse(text) as {asset?: unknown}\n    if (!document || typeof document !== 'object' || !document.asset) {\n        throw new Error(`${path} is not a JSON glTF document`)\n    }\n}\n\n/** Find nodes that still carry the component removed in Kite3D 0.19.0. */\nexport function findRemovedGeneratorNodes(text: string): Array<{nodeIndex: number, nodeName: string}> {\n    const document = JSON.parse(text) as {\n        nodes?: Array<{\n            name?: unknown\n            extras?: {EntityComponentPlugin?: Record<string, {type?: unknown}>}\n        }>\n    }\n    const nodes: Array<{nodeIndex: number, nodeName: string}> = []\n    for (const [nodeIndex, node] of (document.nodes || []).entries()) {\n        const components = Object.values(node.extras?.EntityComponentPlugin || {})\n        if (!components.some(({type}) => type === 'Generator')) continue\n        nodes.push({\n            nodeIndex,\n            nodeName: typeof node.name === 'string' && node.name.trim() ? node.name : `Node ${nodeIndex}`,\n        })\n    }\n    return nodes\n}\n\nexport function removedGeneratorMessage(nodeName: string): string {\n    return `${REMOVED_GENERATOR_GUIDANCE} Convert ${nodeName} to asset files. See the guide's Scene asset management section.`\n}\n\nexport async function parsePackageJsonSettingsConfig(json: ProjectPackageJSON, _project?: unknown): Promise<ProjectConfigSettings> {\n    const config = (json[settingsKey] ?? {}) as ProjectConfigSettingsJSON\n    const dependencies: ProjectDependency[] = []\n    const packageDependencies = json.dependencies && typeof json.dependencies === 'object' && !Array.isArray(json.dependencies)\n        ? json.dependencies as Record<string, string>\n        : {}\n    const deps: Record<string, string> = {\n        ...packageDependencies,\n    }\n\n    dependencies.push(...Object.entries(deps).map(([key, version]) => ({key, version})))\n\n    if (config.imports) {\n        dependencies.push(...Object.entries(config.imports).map(([key, url]) => ({\n            key,\n            url: !url.startsWith('@') ? url : undefined,\n            version: url.startsWith('@') ? url.slice(1) : '',\n        })))\n    }\n\n    const plugins = config.plugins?.map((entry) => {\n        if (typeof entry !== 'string') return entry\n\n        const match = entry.match(/\\((.*)\\)$/)\n        let params: JSONValue[] | undefined\n        let spec = entry\n\n        if (match) {\n            const paramString = match[1].trim()\n            spec = entry.slice(0, match.index).trim()\n            if (paramString) {\n                try {\n                    const errors: ParseError[] = []\n                    params = parse(`[${paramString}]`, errors)\n                    if (!Array.isArray(params) || errors.length) {\n                        console.error(errors)\n                        throw new Error('Plugin params is not a valid array')\n                    }\n                } catch (error) {\n                    console.error('Unable to parse plugin params, skipping plugin', entry, paramString, error)\n                    return null\n                }\n            }\n        }\n\n        const separator = spec.lastIndexOf(':')\n        return {\n            import: separator !== -1 ? spec.slice(0, separator) : spec,\n            className: separator !== -1 ? spec.slice(separator + 1) : undefined,\n            params,\n        } satisfies ExternalPlugin\n    }) || []\n\n    const scripts = config.scripts?.map((entry) =>\n        typeof entry === 'string' ? {import: entry} : entry\n    ) || []\n\n    return {\n        plugins: plugins.filter(Boolean) as ExternalPlugin[],\n        scripts,\n        dependencies,\n        viewer: config.viewer || {},\n    }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n"],"names":["settingsKey","assetUrlPrefix","REMOVED_GENERATOR_GUIDANCE","createProjectAssetURLModifier","base","assets","assetIdPrefix","url","request","relative","slash","id","assetPath","asset","registered","_a","isDependencyModuleSpecifier","specifier","packageJson","dependencies","isRecord","parsePackageJSON","text","json","parse","parseAssetsJSONManifest","validateSceneSource","path","document","findRemovedGeneratorNodes","nodes","nodeIndex","node","type","removedGeneratorMessage","nodeName","parsePackageJsonSettingsConfig","_project","config","deps","key","version","plugins","entry","match","params","spec","paramString","errors","error","separator","scripts","_b","value"],"mappings":"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"}

package/dist/runtime/createGame.d.ts

@@ -25,5 +25,5 @@ export interface CreatedGame {
     dispose(): RuntimeCleanupReport;
 }
 export declare function createGame(options: CreateGameOptions): Promise<CreatedGame>;
-/** Load the saved project and generator previews without starting components, physics, the timeline, or main.js. */
+/** Load the saved project without starting components, physics, the timeline, or main.js. */
 export declare function createStoppedGame(options: CreateGameOptions): Promise<CreatedGame>;

package/dist/runtime/index.d.ts

@@ -6,8 +6,6 @@ export * from './migrations.ts';
 export { RuntimeNestedAssetLoader } from './nestedAssets.ts';
 export { registerScripts, walkScriptExports } from '../scripts.ts';
 export { HtmlUiComponent } from '../plugins/HtmlUiComponent.ts';
-export { GeneratorComponent, markGenerated, removeGeneratedChildren, resolveGeneratorModule, runGenerator } from '../plugins/GeneratorComponent.ts';
-export type { GeneratorContext, GeneratorModule, GeneratorParams, GeneratorViewerOptions, RunGeneratorOptions } from '../plugins/GeneratorComponent.ts';
 export { CannonPhysicsPlugin } from '../plugins/cannon/CannonPhysicsPlugin.ts';
 export { serializeSceneGltf, serializeSceneGltfDocument } from '../sceneSerialization.ts';
 export type { SerializeSceneGltfOptions, SerializedSceneFile, SerializedSceneGltf } from '../sceneSerialization.ts';

package/dist/runtime/projectFormat.d.ts

@@ -1,20 +1,12 @@
-import { GeneratorParamSchema } from '../generatorParams.ts';
 export declare const settingsKey = "kite3d";
 export declare const assetUrlPrefix = "/kite3d/";
+export declare const REMOVED_GENERATOR_GUIDANCE = "Generator components were removed in Kite3D 0.19.0.";
 export type JSONValue = string | number | boolean | null | JSONValue[] | {
     [key: string]: JSONValue;
 };
 export type ProjectPackageJSON = Record<string, JSONValue> & {
     mainScene: string;
 };
-export interface ProjectGeneratorState {
-    componentId: string;
-    module: string;
-    nodeIndex: number;
-    nodeName: string;
-    params: Record<string, unknown>;
-    schema: GeneratorParamSchema;
-}
 export interface AssetsJSONManifest {
     files: Record<string, {
         path: string;
@@ -79,9 +71,10 @@ export declare function isDependencyModuleSpecifier(specifier: string, packageJs
 export declare function parsePackageJSON(text: string): ProjectPackageJSON;
 export declare function parseAssetsJSONManifest(text: string): AssetsJSONManifest;
 export declare function validateSceneSource(path: string, text: string): void;
-export declare function readProjectGeneratorStates(text: string): ProjectGeneratorState[];
-export declare function updateProjectGeneratorState(text: string, generator: Pick<ProjectGeneratorState, 'componentId' | 'nodeIndex' | 'nodeName'>, update: Partial<Pick<ProjectGeneratorState, 'module' | 'params'>>): {
-    text: string;
-    state: Record<string, unknown>;
-};
+/** Find nodes that still carry the component removed in Kite3D 0.19.0. */
+export declare function findRemovedGeneratorNodes(text: string): Array<{
+    nodeIndex: number;
+    nodeName: string;
+}>;
+export declare function removedGeneratorMessage(nodeName: string): string;
 export declare function parsePackageJsonSettingsConfig(json: ProjectPackageJSON, _project?: unknown): Promise<ProjectConfigSettings>;