@kite3d/engine 0.17.0 → 0.19.0-alpha.1

package/dist/sceneSerialization.js

@@ -1,61 +1,66 @@
 const l = new TextEncoder();
 async function N(e, t = {}) {
-  const n = await e.exportScene({
+  const r = await e.exportScene({
     exportExt: "gltf",
     preserveUUIDs: !0,
     viewerConfig: !0,
     embedUrlImages: !1,
-    onlyVisible: !0,
+    onlyVisible: !1,
+    shouldExportObject: x,
     jsonSpaces: 2
   }, !1);
-  if (!n) throw new Error("The scene exporter returned no glTF data");
-  return x(JSON.parse(await n.text()), t);
+  if (!r) throw new Error("The scene exporter returned no glTF data");
+  return E(JSON.parse(await r.text()), t);
 }
-async function x(e, t = {}) {
+function x(e) {
+  var t, r;
+  return ((t = e.userData) == null ? void 0 : t.excludeFromExport) !== !0 && ((r = e.userData) == null ? void 0 : r.isWidgetRoot) !== !0 && e.isWidget !== !0 && e.assetType !== "widget";
+}
+async function E(e, t = {}) {
   if (!a(e) || !a(e.asset))
     throw new Error("The scene is not a JSON glTF document");
-  const n = U(e);
-  u(n), j(n);
-  const r = T(t.scenePath || "assets/main.scene.gltf"), s = z(r), f = [];
-  E(n, s, P(r), f), await A(n, s, f, 16);
-  const i = y(n);
+  const r = U(e);
+  g(r), j(r);
+  const n = z(t.scenePath || "assets/main.scene.gltf"), s = P(n), f = [];
+  A(r, s, $(n), f), await O(r, s, f, 16);
+  const i = y(r);
   return {
     document: i,
     gltf: l.encode(`${JSON.stringify(i, null, 2)}
 `),
-    files: f.sort((d, m) => d.path.localeCompare(m.path))
+    files: f.sort((d, u) => d.path.localeCompare(u.path))
   };
 }
-function u(e) {
+function g(e) {
   if (Array.isArray(e)) {
-    e.forEach(u);
+    e.forEach(g);
     return;
   }
   if (a(e)) {
     if (e.rootSceneModelRoot === !0 && delete e.gltfUUID, a(e.WEBGI_viewer)) {
       h(e.WEBGI_viewer);
-      const t = e.WEBGI_viewer.scene, n = a(t) ? t.defaultCamera : void 0, r = a(n) ? n.object : void 0;
-      a(r) && delete r.uuid;
+      const t = e.WEBGI_viewer.scene, r = a(t) ? t.defaultCamera : void 0, n = a(r) ? r.object : void 0;
+      a(n) && delete n.uuid;
     }
-    Object.values(e).forEach(u);
+    Object.values(e).forEach(g);
   }
 }
 function j(e) {
   const t = /* @__PURE__ */ new Map();
-  p(e, (n, r) => {
-    t.set(n, (t.get(n) || 0) + 1), typeof r == "string" && t.set(r, (t.get(r) || 0) + 1);
-  }), p(e, (n, r, s) => {
-    n === "uuid" && typeof r == "string" && t.get(r) === 1 && delete s[n];
+  m(e, (r, n) => {
+    t.set(r, (t.get(r) || 0) + 1), typeof n == "string" && t.set(n, (t.get(n) || 0) + 1);
+  }), m(e, (r, n, s) => {
+    r === "uuid" && typeof n == "string" && t.get(n) === 1 && delete s[r];
   });
 }
-function p(e, t) {
+function m(e, t) {
   if (Array.isArray(e)) {
-    e.forEach((n) => p(n, t));
+    e.forEach((r) => m(r, t));
     return;
   }
   if (a(e))
-    for (const [n, r] of Object.entries(e))
-      t(n, r, e), p(r, t);
+    for (const [r, n] of Object.entries(e))
+      t(r, n, e), m(n, t);
 }
 function h(e) {
   if (Array.isArray(e)) {
@@ -64,7 +69,7 @@ function h(e) {
   }
   a(e) && (e.isEuler === !0 && (typeof e.order != "string" && (e.order = "XYZ"), typeof e.x != "number" && (e.x = 0), typeof e.y != "number" && (e.y = 0), typeof e.z != "number" && (e.z = 0)), e.autoAspect === !0 && (delete e.aspect, a(e.object) && delete e.object.aspect), Object.values(e).forEach(h));
 }
-function E(e, t, n, r) {
+function A(e, t, r, n) {
   const s = e.buffers;
   if (!(s != null && s.length)) return;
   const f = s.map((o) => {
@@ -81,46 +86,46 @@ function E(e, t, n, r) {
   const d = f.map((o) => {
     const c = J(i);
     return i = c + ((o == null ? void 0 : o.byteLength) || 0), c;
-  }), m = new Uint8Array(i);
+  }), u = new Uint8Array(i);
   f.forEach((o, c) => {
-    o && m.set(o, d[c]);
+    o && u.set(o, d[c]);
   });
   for (const o of e.bufferViews || []) {
     const c = d[o.buffer];
     if (c === void 0) throw new Error(`Invalid glTF buffer index: ${o.buffer}`);
     o.byteOffset = (o.byteOffset || 0) + c, o.buffer = 0;
   }
-  const g = `${n}.bin`;
-  e.buffers = [{ byteLength: m.byteLength, uri: g }], r.push({ path: $(t, g), bytes: m });
+  const p = `${r}.bin`;
+  e.buffers = [{ byteLength: u.byteLength, uri: p }], n.push({ path: W(t, p), bytes: u });
 }
-async function A(e, t, n, r) {
+async function O(e, t, r, n) {
   var f;
   const s = /* @__PURE__ */ new Map();
   for (const i of e.images || []) {
     if (!((f = i.uri) != null && f.startsWith("data:"))) continue;
-    const d = w(i.uri), m = d.mimeType || i.mimeType || "application/octet-stream", o = `assets/textures/${(await I(d.bytes)).slice(0, r)}.${S(m)}`;
-    s.set(o, d.bytes), i.uri = C(t, o), i.mimeType = m;
+    const d = w(i.uri), u = d.mimeType || i.mimeType || "application/octet-stream", o = `assets/textures/${(await S(d.bytes)).slice(0, n)}.${T(u)}`;
+    s.set(o, d.bytes), i.uri = C(t, o), i.mimeType = u;
   }
-  for (const [i, d] of s) n.push({ path: i, bytes: d });
+  for (const [i, d] of s) r.push({ path: i, bytes: d });
 }
 function w(e) {
   const t = /^data:([^;,]*)(;base64)?,(.*)$/s.exec(e);
   if (!t) throw new Error("Invalid data URL in glTF");
   return {
-    bytes: t[2] ? O(t[3]) : l.encode(decodeURIComponent(t[3])),
+    bytes: t[2] ? I(t[3]) : l.encode(decodeURIComponent(t[3])),
     mimeType: t[1] || void 0
   };
 }
-function O(e) {
+function I(e) {
   const t = atob(e);
-  return Uint8Array.from(t, (n) => n.charCodeAt(0));
+  return Uint8Array.from(t, (r) => r.charCodeAt(0));
 }
-async function I(e) {
+async function S(e) {
   const t = await crypto.subtle.digest("SHA-256", e);
-  return Array.from(new Uint8Array(t), (n) => n.toString(16).padStart(2, "0")).join("");
+  return Array.from(new Uint8Array(t), (r) => r.toString(16).padStart(2, "0")).join("");
 }
-function S(e) {
-  var r;
+function T(e) {
+  var n;
   const t = e.toLowerCase().split(";", 1)[0];
   return {
     "image/avif": "avif",
@@ -130,7 +135,7 @@ function S(e) {
     "image/png": "png",
     "image/svg+xml": "svg",
     "image/webp": "webp"
-  }[t] || ((r = t.split("/")[1]) == null ? void 0 : r.replace(/[^a-z0-9.+-]/g, "")) || "bin";
+  }[t] || ((n = t.split("/")[1]) == null ? void 0 : n.replace(/[^a-z0-9.+-]/g, "")) || "bin";
 }
 function y(e) {
   return Array.isArray(e) ? e.map(y) : a(e) ? Object.fromEntries(Object.keys(e).sort().map((t) => [t, y(e[t])])) : e;
@@ -141,34 +146,34 @@ function U(e) {
 function a(e) {
   return !!e && typeof e == "object" && !Array.isArray(e);
 }
-function T(e) {
+function z(e) {
   const t = e.replace(/\\/g, "/").replace(/^\.\//, "");
   if (!t || t.startsWith("/") || t.split("/").includes(".."))
     throw new Error(`Invalid project path: ${e}`);
   return t;
 }
-function z(e) {
+function P(e) {
   const t = e.lastIndexOf("/");
   return t < 0 ? "" : e.slice(0, t);
 }
-function P(e) {
-  const t = e.slice(e.lastIndexOf("/") + 1), n = t.lastIndexOf(".");
-  return n < 0 ? t : t.slice(0, n);
+function $(e) {
+  const t = e.slice(e.lastIndexOf("/") + 1), r = t.lastIndexOf(".");
+  return r < 0 ? t : t.slice(0, r);
 }
-function $(e, t) {
+function W(e, t) {
   return e ? `${e}/${t}` : t;
 }
 function C(e, t) {
-  const n = e ? e.split("/") : [], r = t.split("/");
-  for (; n.length && r.length && n[0] === r[0]; )
-    n.shift(), r.shift();
-  return [...n.map(() => ".."), ...r].join("/") || ".";
+  const r = e ? e.split("/") : [], n = t.split("/");
+  for (; r.length && n.length && r[0] === n[0]; )
+    r.shift(), n.shift();
+  return [...r.map(() => ".."), ...n].join("/") || ".";
 }
 function J(e) {
   return e + 3 & -4;
 }
 export {
   N as serializeSceneGltf,
-  x as serializeSceneGltfDocument
+  E as serializeSceneGltfDocument
 };
 //# sourceMappingURL=sceneSerialization.js.map

package/dist/sceneSerialization.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneSerialization.js","sources":["../src/sceneSerialization.ts"],"sourcesContent":["import type {ThreeViewer} from 'threepipe'\n\nexport interface SerializeSceneGltfOptions {\n    scenePath?: string\n}\n\nexport interface SerializedSceneFile {\n    path: string\n    bytes: Uint8Array\n}\n\nexport interface SerializedSceneGltf {\n    document: Record<string, unknown>\n    gltf: Uint8Array\n    files: SerializedSceneFile[]\n}\n\ninterface GltfBuffer {\n    byteLength?: number\n    uri?: string\n    [key: string]: unknown\n}\n\ninterface GltfBufferView {\n    buffer: number\n    byteOffset?: number\n    [key: string]: unknown\n}\n\ninterface GltfImage {\n    uri?: string\n    mimeType?: string\n    [key: string]: unknown\n}\n\ninterface GltfDocument extends Record<string, unknown> {\n    buffers?: GltfBuffer[]\n    bufferViews?: GltfBufferView[]\n    images?: GltfImage[]\n}\n\nconst encoder = new TextEncoder()\n\n/** Export a viewer scene as deterministic text glTF plus external resources. */\nexport async function serializeSceneGltf(\n    viewer: Pick<ThreeViewer, 'exportScene'>,\n    options: SerializeSceneGltfOptions = {},\n): Promise<SerializedSceneGltf> {\n    const blob = await viewer.exportScene({\n        exportExt: 'gltf',\n        preserveUUIDs: true,\n        viewerConfig: true,\n        embedUrlImages: false,\n        onlyVisible: true,\n        jsonSpaces: 2,\n    }, false)\n    if (!blob) throw new Error('The scene exporter returned no glTF data')\n    return serializeSceneGltfDocument(JSON.parse(await blob.text()), options)\n}\n\n/** Canonicalize JSON glTF and extract every embedded resource. */\nexport async function serializeSceneGltfDocument(\n    input: unknown,\n    options: SerializeSceneGltfOptions = {},\n): Promise<SerializedSceneGltf> {\n    if (!isRecord(input) || !isRecord(input.asset)) {\n        throw new Error('The scene is not a JSON glTF document')\n    }\n    const document = cloneJson(input) as GltfDocument\n    removeVolatileViewerIds(document)\n    removeUnreferencedUuids(document)\n    const scenePath = normalizeProjectPath(options.scenePath || 'assets/main.scene.gltf')\n    const sceneDirectory = directoryName(scenePath)\n    const files: SerializedSceneFile[] = []\n\n    extractBuffers(document, sceneDirectory, fileStem(scenePath), files)\n    await extractImages(document, sceneDirectory, files, 16)\n\n    const sorted = sortObjectKeys(document) as GltfDocument\n    return {\n        document: sorted,\n        gltf: encoder.encode(`${JSON.stringify(sorted, null, 2)}\\n`),\n        files: files.sort((left, right) => left.path.localeCompare(right.path)),\n    }\n}\n\nfunction removeVolatileViewerIds(value: unknown): void {\n    if (Array.isArray(value)) {\n        value.forEach(removeVolatileViewerIds)\n        return\n    }\n    if (!isRecord(value)) return\n    if (value.rootSceneModelRoot === true) delete value.gltfUUID\n    if (isRecord(value.WEBGI_viewer)) {\n        canonicalizeViewerConfig(value.WEBGI_viewer)\n        const scene = value.WEBGI_viewer.scene\n        const camera = isRecord(scene) ? scene.defaultCamera : undefined\n        const object = isRecord(camera) ? camera.object : undefined\n        if (isRecord(object)) delete object.uuid\n    }\n    Object.values(value).forEach(removeVolatileViewerIds)\n}\n\nfunction removeUnreferencedUuids(document: GltfDocument): void {\n    const uses = new Map<string, number>()\n    visitJson(document, (key, value) => {\n        uses.set(key, (uses.get(key) || 0) + 1)\n        if (typeof value === 'string') uses.set(value, (uses.get(value) || 0) + 1)\n    })\n    visitJson(document, (key, value, owner) => {\n        if (key === 'uuid' && typeof value === 'string' && uses.get(value) === 1) delete owner[key]\n    })\n}\n\nfunction visitJson(\n    value: unknown,\n    visit: (key: string, value: unknown, owner: Record<string, unknown>) => void,\n): void {\n    if (Array.isArray(value)) {\n        value.forEach((child) => visitJson(child, visit))\n        return\n    }\n    if (!isRecord(value)) return\n    for (const [key, child] of Object.entries(value)) {\n        visit(key, child, value)\n        visitJson(child, visit)\n    }\n}\n\nfunction canonicalizeViewerConfig(value: unknown): void {\n    if (Array.isArray(value)) {\n        value.forEach(canonicalizeViewerConfig)\n        return\n    }\n    if (!isRecord(value)) return\n    if (value.isEuler === true) {\n        if (typeof value.order !== 'string') value.order = 'XYZ'\n        if (typeof value.x !== 'number') value.x = 0\n        if (typeof value.y !== 'number') value.y = 0\n        if (typeof value.z !== 'number') value.z = 0\n    }\n    if (value.autoAspect === true) {\n        delete value.aspect\n        if (isRecord(value.object)) delete value.object.aspect\n    }\n    Object.values(value).forEach(canonicalizeViewerConfig)\n}\n\nfunction extractBuffers(\n    document: GltfDocument,\n    sceneDirectory: string,\n    baseName: string,\n    files: SerializedSceneFile[],\n): void {\n    const buffers = document.buffers\n    if (!buffers?.length) return\n\n    const embedded = buffers.map((buffer) => buffer.uri?.startsWith('data:') ? decodeDataUrl(buffer.uri).bytes : undefined)\n    if (embedded.every((value) => value === undefined)) return\n    if (embedded.some((value, index) => value === undefined && buffers[index]?.uri)) {\n        throw new Error('A scene cannot combine embedded and external buffers during serialization')\n    }\n\n    let byteLength = 0\n    const offsets = embedded.map((bytes) => {\n        const offset = align4(byteLength)\n        byteLength = offset + (bytes?.byteLength || 0)\n        return offset\n    })\n    const combined = new Uint8Array(byteLength)\n    embedded.forEach((bytes, index) => {\n        if (bytes) combined.set(bytes, offsets[index])\n    })\n\n    for (const view of document.bufferViews || []) {\n        const offset = offsets[view.buffer]\n        if (offset === undefined) throw new Error(`Invalid glTF buffer index: ${view.buffer}`)\n        view.byteOffset = (view.byteOffset || 0) + offset\n        view.buffer = 0\n    }\n\n    const binName = `${baseName}.bin`\n    document.buffers = [{byteLength: combined.byteLength, uri: binName}]\n    files.push({path: joinProjectPath(sceneDirectory, binName), bytes: combined})\n}\n\nasync function extractImages(\n    document: GltfDocument,\n    sceneDirectory: string,\n    files: SerializedSceneFile[],\n    hashLength: number,\n): Promise<void> {\n    const byPath = new Map<string, Uint8Array>()\n    for (const image of document.images || []) {\n        if (!image.uri?.startsWith('data:')) continue\n        const decoded = decodeDataUrl(image.uri)\n        const mimeType = decoded.mimeType || image.mimeType || 'application/octet-stream'\n        const hash = await sha256(decoded.bytes)\n        const path = `assets/textures/${hash.slice(0, hashLength)}.${imageExtension(mimeType)}`\n        byPath.set(path, decoded.bytes)\n        image.uri = relativeProjectPath(sceneDirectory, path)\n        image.mimeType = mimeType\n    }\n    for (const [path, bytes] of byPath) files.push({path, bytes})\n}\n\nfunction decodeDataUrl(uri: string): {bytes: Uint8Array, mimeType?: string} {\n    const match = /^data:([^;,]*)(;base64)?,(.*)$/s.exec(uri)\n    if (!match) throw new Error('Invalid data URL in glTF')\n    return {\n        bytes: match[2] ? decodeBase64(match[3]) : encoder.encode(decodeURIComponent(match[3])),\n        mimeType: match[1] || undefined,\n    }\n}\n\nfunction decodeBase64(value: string): Uint8Array {\n    const decoded = atob(value)\n    return Uint8Array.from(decoded, (character) => character.charCodeAt(0))\n}\n\nasync function sha256(bytes: Uint8Array): Promise<string> {\n    const digest = await crypto.subtle.digest('SHA-256', bytes as BufferSource)\n    return Array.from(new Uint8Array(digest), (value) => value.toString(16).padStart(2, '0')).join('')\n}\n\nfunction imageExtension(mimeType: string): string {\n    const normalized = mimeType.toLowerCase().split(';', 1)[0]\n    const extensions: Record<string, string> = {\n        'image/avif': 'avif',\n        'image/gif': 'gif',\n        'image/jpeg': 'jpg',\n        'image/ktx2': 'ktx2',\n        'image/png': 'png',\n        'image/svg+xml': 'svg',\n        'image/webp': 'webp',\n    }\n    return extensions[normalized] || normalized.split('/')[1]?.replace(/[^a-z0-9.+-]/g, '') || 'bin'\n}\n\nfunction sortObjectKeys(value: unknown): unknown {\n    if (Array.isArray(value)) return value.map(sortObjectKeys)\n    if (!isRecord(value)) return value\n    return Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortObjectKeys(value[key])]))\n}\n\nfunction cloneJson<T>(value: T): T {\n    return JSON.parse(JSON.stringify(value)) as T\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n\nfunction normalizeProjectPath(path: string): string {\n    const normalized = path.replace(/\\\\/g, '/').replace(/^\\.\\//, '')\n    if (!normalized || normalized.startsWith('/') || normalized.split('/').includes('..')) {\n        throw new Error(`Invalid project path: ${path}`)\n    }\n    return normalized\n}\n\nfunction directoryName(path: string): string {\n    const end = path.lastIndexOf('/')\n    return end < 0 ? '' : path.slice(0, end)\n}\n\nfunction fileStem(path: string): string {\n    const name = path.slice(path.lastIndexOf('/') + 1)\n    const end = name.lastIndexOf('.')\n    return end < 0 ? name : name.slice(0, end)\n}\n\nfunction joinProjectPath(directory: string, name: string): string {\n    return directory ? `${directory}/${name}` : name\n}\n\nfunction relativeProjectPath(fromDirectory: string, target: string): string {\n    const from = fromDirectory ? fromDirectory.split('/') : []\n    const to = target.split('/')\n    while (from.length && to.length && from[0] === to[0]) {\n        from.shift()\n        to.shift()\n    }\n    return [...from.map(() => '..'), ...to].join('/') || '.'\n}\n\nfunction align4(value: number): number {\n    return (value + 3) & ~3\n}\n"],"names":["encoder","serializeSceneGltf","viewer","options","blob","serializeSceneGltfDocument","input","isRecord","document","cloneJson","removeVolatileViewerIds","removeUnreferencedUuids","scenePath","normalizeProjectPath","sceneDirectory","directoryName","files","extractBuffers","fileStem","extractImages","sorted","sortObjectKeys","left","right","value","canonicalizeViewerConfig","scene","camera","object","uses","visitJson","key","owner","visit","child","baseName","buffers","embedded","buffer","_a","decodeDataUrl","index","byteLength","offsets","bytes","offset","align4","combined","view","binName","joinProjectPath","hashLength","byPath","image","decoded","mimeType","path","sha256","imageExtension","relativeProjectPath","uri","match","decodeBase64","character","digest","normalized","end","name","directory","fromDirectory","target","from","to"],"mappings":"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"}
+{"version":3,"file":"sceneSerialization.js","sources":["../src/sceneSerialization.ts"],"sourcesContent":["import type {IObject3D, ThreeViewer} from 'threepipe'\n\nexport interface SerializeSceneGltfOptions {\n    scenePath?: string\n}\n\nexport interface SerializedSceneFile {\n    path: string\n    bytes: Uint8Array\n}\n\nexport interface SerializedSceneGltf {\n    document: Record<string, unknown>\n    gltf: Uint8Array\n    files: SerializedSceneFile[]\n}\n\ninterface GltfBuffer {\n    byteLength?: number\n    uri?: string\n    [key: string]: unknown\n}\n\ninterface GltfBufferView {\n    buffer: number\n    byteOffset?: number\n    [key: string]: unknown\n}\n\ninterface GltfImage {\n    uri?: string\n    mimeType?: string\n    [key: string]: unknown\n}\n\ninterface GltfDocument extends Record<string, unknown> {\n    buffers?: GltfBuffer[]\n    bufferViews?: GltfBufferView[]\n    images?: GltfImage[]\n}\n\nconst encoder = new TextEncoder()\n\n/** Export a viewer scene as deterministic text glTF plus external resources. */\nexport async function serializeSceneGltf(\n    viewer: Pick<ThreeViewer, 'exportScene'>,\n    options: SerializeSceneGltfOptions = {},\n): Promise<SerializedSceneGltf> {\n    const blob = await viewer.exportScene({\n        exportExt: 'gltf',\n        preserveUUIDs: true,\n        viewerConfig: true,\n        embedUrlImages: false,\n        onlyVisible: false,\n        shouldExportObject: isAuthoredSceneObject,\n        jsonSpaces: 2,\n    }, false)\n    if (!blob) throw new Error('The scene exporter returned no glTF data')\n    return serializeSceneGltfDocument(JSON.parse(await blob.text()), options)\n}\n\nfunction isAuthoredSceneObject(object: IObject3D): boolean {\n    return object.userData?.excludeFromExport !== true\n        && object.userData?.isWidgetRoot !== true\n        && object.isWidget !== true\n        && object.assetType !== 'widget'\n}\n\n/** Canonicalize JSON glTF and extract every embedded resource. */\nexport async function serializeSceneGltfDocument(\n    input: unknown,\n    options: SerializeSceneGltfOptions = {},\n): Promise<SerializedSceneGltf> {\n    if (!isRecord(input) || !isRecord(input.asset)) {\n        throw new Error('The scene is not a JSON glTF document')\n    }\n    const document = cloneJson(input) as GltfDocument\n    removeVolatileViewerIds(document)\n    removeUnreferencedUuids(document)\n    const scenePath = normalizeProjectPath(options.scenePath || 'assets/main.scene.gltf')\n    const sceneDirectory = directoryName(scenePath)\n    const files: SerializedSceneFile[] = []\n\n    extractBuffers(document, sceneDirectory, fileStem(scenePath), files)\n    await extractImages(document, sceneDirectory, files, 16)\n\n    const sorted = sortObjectKeys(document) as GltfDocument\n    return {\n        document: sorted,\n        gltf: encoder.encode(`${JSON.stringify(sorted, null, 2)}\\n`),\n        files: files.sort((left, right) => left.path.localeCompare(right.path)),\n    }\n}\n\nfunction removeVolatileViewerIds(value: unknown): void {\n    if (Array.isArray(value)) {\n        value.forEach(removeVolatileViewerIds)\n        return\n    }\n    if (!isRecord(value)) return\n    if (value.rootSceneModelRoot === true) delete value.gltfUUID\n    if (isRecord(value.WEBGI_viewer)) {\n        canonicalizeViewerConfig(value.WEBGI_viewer)\n        const scene = value.WEBGI_viewer.scene\n        const camera = isRecord(scene) ? scene.defaultCamera : undefined\n        const object = isRecord(camera) ? camera.object : undefined\n        if (isRecord(object)) delete object.uuid\n    }\n    Object.values(value).forEach(removeVolatileViewerIds)\n}\n\nfunction removeUnreferencedUuids(document: GltfDocument): void {\n    const uses = new Map<string, number>()\n    visitJson(document, (key, value) => {\n        uses.set(key, (uses.get(key) || 0) + 1)\n        if (typeof value === 'string') uses.set(value, (uses.get(value) || 0) + 1)\n    })\n    visitJson(document, (key, value, owner) => {\n        if (key === 'uuid' && typeof value === 'string' && uses.get(value) === 1) delete owner[key]\n    })\n}\n\nfunction visitJson(\n    value: unknown,\n    visit: (key: string, value: unknown, owner: Record<string, unknown>) => void,\n): void {\n    if (Array.isArray(value)) {\n        value.forEach((child) => visitJson(child, visit))\n        return\n    }\n    if (!isRecord(value)) return\n    for (const [key, child] of Object.entries(value)) {\n        visit(key, child, value)\n        visitJson(child, visit)\n    }\n}\n\nfunction canonicalizeViewerConfig(value: unknown): void {\n    if (Array.isArray(value)) {\n        value.forEach(canonicalizeViewerConfig)\n        return\n    }\n    if (!isRecord(value)) return\n    if (value.isEuler === true) {\n        if (typeof value.order !== 'string') value.order = 'XYZ'\n        if (typeof value.x !== 'number') value.x = 0\n        if (typeof value.y !== 'number') value.y = 0\n        if (typeof value.z !== 'number') value.z = 0\n    }\n    if (value.autoAspect === true) {\n        delete value.aspect\n        if (isRecord(value.object)) delete value.object.aspect\n    }\n    Object.values(value).forEach(canonicalizeViewerConfig)\n}\n\nfunction extractBuffers(\n    document: GltfDocument,\n    sceneDirectory: string,\n    baseName: string,\n    files: SerializedSceneFile[],\n): void {\n    const buffers = document.buffers\n    if (!buffers?.length) return\n\n    const embedded = buffers.map((buffer) => buffer.uri?.startsWith('data:') ? decodeDataUrl(buffer.uri).bytes : undefined)\n    if (embedded.every((value) => value === undefined)) return\n    if (embedded.some((value, index) => value === undefined && buffers[index]?.uri)) {\n        throw new Error('A scene cannot combine embedded and external buffers during serialization')\n    }\n\n    let byteLength = 0\n    const offsets = embedded.map((bytes) => {\n        const offset = align4(byteLength)\n        byteLength = offset + (bytes?.byteLength || 0)\n        return offset\n    })\n    const combined = new Uint8Array(byteLength)\n    embedded.forEach((bytes, index) => {\n        if (bytes) combined.set(bytes, offsets[index])\n    })\n\n    for (const view of document.bufferViews || []) {\n        const offset = offsets[view.buffer]\n        if (offset === undefined) throw new Error(`Invalid glTF buffer index: ${view.buffer}`)\n        view.byteOffset = (view.byteOffset || 0) + offset\n        view.buffer = 0\n    }\n\n    const binName = `${baseName}.bin`\n    document.buffers = [{byteLength: combined.byteLength, uri: binName}]\n    files.push({path: joinProjectPath(sceneDirectory, binName), bytes: combined})\n}\n\nasync function extractImages(\n    document: GltfDocument,\n    sceneDirectory: string,\n    files: SerializedSceneFile[],\n    hashLength: number,\n): Promise<void> {\n    const byPath = new Map<string, Uint8Array>()\n    for (const image of document.images || []) {\n        if (!image.uri?.startsWith('data:')) continue\n        const decoded = decodeDataUrl(image.uri)\n        const mimeType = decoded.mimeType || image.mimeType || 'application/octet-stream'\n        const hash = await sha256(decoded.bytes)\n        const path = `assets/textures/${hash.slice(0, hashLength)}.${imageExtension(mimeType)}`\n        byPath.set(path, decoded.bytes)\n        image.uri = relativeProjectPath(sceneDirectory, path)\n        image.mimeType = mimeType\n    }\n    for (const [path, bytes] of byPath) files.push({path, bytes})\n}\n\nfunction decodeDataUrl(uri: string): {bytes: Uint8Array, mimeType?: string} {\n    const match = /^data:([^;,]*)(;base64)?,(.*)$/s.exec(uri)\n    if (!match) throw new Error('Invalid data URL in glTF')\n    return {\n        bytes: match[2] ? decodeBase64(match[3]) : encoder.encode(decodeURIComponent(match[3])),\n        mimeType: match[1] || undefined,\n    }\n}\n\nfunction decodeBase64(value: string): Uint8Array {\n    const decoded = atob(value)\n    return Uint8Array.from(decoded, (character) => character.charCodeAt(0))\n}\n\nasync function sha256(bytes: Uint8Array): Promise<string> {\n    const digest = await crypto.subtle.digest('SHA-256', bytes as BufferSource)\n    return Array.from(new Uint8Array(digest), (value) => value.toString(16).padStart(2, '0')).join('')\n}\n\nfunction imageExtension(mimeType: string): string {\n    const normalized = mimeType.toLowerCase().split(';', 1)[0]\n    const extensions: Record<string, string> = {\n        'image/avif': 'avif',\n        'image/gif': 'gif',\n        'image/jpeg': 'jpg',\n        'image/ktx2': 'ktx2',\n        'image/png': 'png',\n        'image/svg+xml': 'svg',\n        'image/webp': 'webp',\n    }\n    return extensions[normalized] || normalized.split('/')[1]?.replace(/[^a-z0-9.+-]/g, '') || 'bin'\n}\n\nfunction sortObjectKeys(value: unknown): unknown {\n    if (Array.isArray(value)) return value.map(sortObjectKeys)\n    if (!isRecord(value)) return value\n    return Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortObjectKeys(value[key])]))\n}\n\nfunction cloneJson<T>(value: T): T {\n    return JSON.parse(JSON.stringify(value)) as T\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n\nfunction normalizeProjectPath(path: string): string {\n    const normalized = path.replace(/\\\\/g, '/').replace(/^\\.\\//, '')\n    if (!normalized || normalized.startsWith('/') || normalized.split('/').includes('..')) {\n        throw new Error(`Invalid project path: ${path}`)\n    }\n    return normalized\n}\n\nfunction directoryName(path: string): string {\n    const end = path.lastIndexOf('/')\n    return end < 0 ? '' : path.slice(0, end)\n}\n\nfunction fileStem(path: string): string {\n    const name = path.slice(path.lastIndexOf('/') + 1)\n    const end = name.lastIndexOf('.')\n    return end < 0 ? name : name.slice(0, end)\n}\n\nfunction joinProjectPath(directory: string, name: string): string {\n    return directory ? `${directory}/${name}` : name\n}\n\nfunction relativeProjectPath(fromDirectory: string, target: string): string {\n    const from = fromDirectory ? fromDirectory.split('/') : []\n    const to = target.split('/')\n    while (from.length && to.length && from[0] === to[0]) {\n        from.shift()\n        to.shift()\n    }\n    return [...from.map(() => '..'), ...to].join('/') || '.'\n}\n\nfunction align4(value: number): number {\n    return (value + 3) & ~3\n}\n"],"names":["encoder","serializeSceneGltf","viewer","options","blob","isAuthoredSceneObject","serializeSceneGltfDocument","object","_a","_b","input","isRecord","document","cloneJson","removeVolatileViewerIds","removeUnreferencedUuids","scenePath","normalizeProjectPath","sceneDirectory","directoryName","files","extractBuffers","fileStem","extractImages","sorted","sortObjectKeys","left","right","value","canonicalizeViewerConfig","scene","camera","uses","visitJson","key","owner","visit","child","baseName","buffers","embedded","buffer","decodeDataUrl","index","byteLength","offsets","bytes","offset","align4","combined","view","binName","joinProjectPath","hashLength","byPath","image","decoded","mimeType","path","sha256","imageExtension","relativeProjectPath","uri","match","decodeBase64","character","digest","normalized","end","name","directory","fromDirectory","target","from","to"],"mappings":"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"}

package/dist/version.js

@@ -1,4 +1,4 @@
-const n = "0.17.0", e = {
+const n = "0.19.0-alpha.1", e = {
   version: n
 }, o = e.version;
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kite3d/engine",
-  "version": "0.17.0",
+  "version": "0.19.0-alpha.1",
   "description": "The open Kite3D game runtime, project format, scripting helpers, and game plugins.",
   "type": "module",
   "license": "Apache-2.0",
@@ -60,9 +60,9 @@
     "build": "vite build && vite build --config vite.runtime.config.ts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext ts --report-unused-disable-directives --max-warnings 0",
-    "test": "vitest run test/unit",
-    "test:gates": "npm run build && playwright test persistence-gate.spec.ts startup-failures.spec.ts release-gates.spec.ts",
-    "test:runtime": "npm run build && vitest run test/unit && playwright test"
+    "test": "vitest run test/unit --passWithNoTests",
+    "test:gates": "npm run build && playwright test persistence-gate.spec.ts",
+    "test:runtime": "npm run build && npm test && playwright test"
   },
   "dependencies": {
     "cannon-es": "^0.20.0",

package/src/authoring.ts

@@ -3,7 +3,7 @@ import type {IObject3D} from 'threepipe'
 export const KITE3D_AUTHORING_METADATA_KEY = 'kite3dAuthoring'
 export const KITE3D_RUNTIME_METADATA_KEY = 'kite3dRuntime'
 
-export type AuthoringRole = 'direct' | 'template' | 'generator'
+export type AuthoringRole = 'direct' | 'template'
 
 export interface AuthoringMetadata {
     role: AuthoringRole
@@ -40,7 +40,7 @@ interface TrackedRuntimeObject {
     scene?: RuntimeScene
 }
 
-const authoringRoles = new Set<AuthoringRole>(['direct', 'template', 'generator'])
+const authoringRoles = new Set<AuthoringRole>(['direct', 'template'])
 const trackedRuntimeObjects = new Map<IObject3D, TrackedRuntimeObject>()
 
 /** Store a validated, serializable authored identity on an object. */
@@ -123,7 +123,7 @@ export class RuntimeObjectOwner {
     cloneFrom<T extends IObject3D>(source: T, parent: IObject3D | undefined = this.runtimeParent, options: RuntimeCloneOptions = {}): T {
         const sourceMetadata = getAuthoringMetadata(source)
         if (!sourceMetadata || sourceMetadata.sourceId) {
-            throw new Error('Runtime clones require a direct, template, or generator source with a stable authored id')
+            throw new Error('Runtime clones require a direct or template source with a stable authored id')
         }
         if (!parent) throw new Error('Runtime clones require a parent or an attached runtime root')
         const scene = findTrackedScene(parent) || findRuntimeScene(source) || findRuntimeScene(parent)

package/src/authoringValidation.ts

@@ -18,7 +18,6 @@ import {
 
 export type AuthoringFailureCode =
     | 'NO_VISIBLE_AUTHORED_CONTENT'
-    | 'GENERATOR_PREVIEW_MISSING'
     | 'RUNTIME_OBJECT_AFTER_STOP'
     | 'MISSING_AUTHORING_SOURCE'
     | 'RUNTIME_SOURCE_DRIFT'
@@ -45,7 +44,6 @@ export interface AuthoringQualityReport {
         visibleAuthoredContent: boolean
         selectableAuthoredContent: boolean
         relationshipsValid: boolean
-        generatorPreviews: boolean
         cameraUseful: boolean
     }
     metrics: {
@@ -53,8 +51,6 @@ export interface AuthoringQualityReport {
         renderableCount: number
         visibleRenderableCount: number
         selectableCount: number
-        generatorCount: number
-        generatorPreviewCount: number
         cameraFramedRenderableCount: number
         cameraInsideRenderableCount: number
     }
@@ -99,7 +95,7 @@ interface SourceRecord {
     metadata: AuthoringMetadata
 }
 
-/** Validate the stopped authoring hierarchy, its sources, previews, and saved camera. */
+/** Validate the stopped authoring hierarchy, its sources, and saved camera. */
 export function authoringQualityReport(viewer: ViewerLike): AuthoringQualityReport {
     const scene = viewer.scene as SceneLike
     if (!scene?.modelRoot) throw new Error('Authoring validation requires viewer.scene.modelRoot')
@@ -107,9 +103,6 @@ export function authoringQualityReport(viewer: ViewerLike): AuthoringQualityRepo
 
     const issues: AuthoringValidationIssue[] = []
     const sources = collectSources(scene.modelRoot)
-    const generators: SourceRecord[] = []
-    const previews: SourceRecord[] = []
-    const boundedPreviewSourceIds = new Set<string>()
     const visibleBounds: Array<{object: IObject3D, bounds: Box3}> = []
     let authoredObjectCount = 0
     let renderableCount = 0
@@ -119,9 +112,6 @@ export function authoringQualityReport(viewer: ViewerLike): AuthoringQualityRepo
     scene.modelRoot.traverse((object) => {
         if (object === scene.modelRoot) return
         authoredObjectCount += 1
-        const metadata = getAuthoringMetadata(object)
-        if (metadata?.role === 'generator' && !metadata.sourceId) generators.push({object, metadata})
-        if (metadata?.role === 'generator' && metadata.sourceId) previews.push({object, metadata})
         if (!isRenderable(object)) return
         renderableCount += 1
         if (!isEffectivelyVisible(object, scene.modelRoot)) return
@@ -130,34 +120,11 @@ export function authoringQualityReport(viewer: ViewerLike): AuthoringQualityRepo
         const bounds = new Box3().setFromObject(object)
         if (!bounds.isEmpty() && finiteVector(bounds.min) && finiteVector(bounds.max)) {
             visibleBounds.push({object, bounds})
-            if (metadata?.role === 'generator' && metadata.sourceId) boundedPreviewSourceIds.add(metadata.sourceId)
         }
     })
-
-    for (const preview of previews) {
-        const source = sources.get(preview.metadata.sourceId || '')
-        if (!source || source.metadata.role !== 'generator') {
-            pushIssue(issues, {
-                code: 'MISSING_AUTHORING_SOURCE',
-                severity: 'error',
-                message: `Generator output source "${preview.metadata.sourceId || '(missing)'}" is not present beneath modelRoot.`,
-                object: objectEvidence(preview.object),
-            })
-        }
-    }
-    for (const generator of generators) {
-        if (!boundedPreviewSourceIds.has(generator.metadata.id)) {
-            pushIssue(issues, {
-                code: 'GENERATOR_PREVIEW_MISSING',
-                severity: 'error',
-                message: 'An authored generator needs a bounded stopped-mode preview.',
-                object: objectEvidence(generator.object),
-            })
-        }
-    }
     issues.push(...runtimeRelationshipIssues(scene, sources))
 
-    const emptyScene = authoredObjectCount === 0 && generators.length === 0
+    const emptyScene = authoredObjectCount === 0
     if (visibleRenderableCount === 0 || selectableCount === 0) {
         issues.push({
             code: 'NO_VISIBLE_AUTHORED_CONTENT',
@@ -178,7 +145,6 @@ export function authoringQualityReport(viewer: ViewerLike): AuthoringQualityRepo
     const errors = issues.filter(({severity}) => severity === 'error')
     const relationshipsValid = !errors.some(({code}) =>
         code === 'MISSING_AUTHORING_SOURCE' || code === 'RUNTIME_SOURCE_DRIFT')
-    const generatorPreviews = !errors.some(({code}) => code === 'GENERATOR_PREVIEW_MISSING')
     const ok = errors.length === 0
     return {
         ok,
@@ -189,7 +155,6 @@ export function authoringQualityReport(viewer: ViewerLike): AuthoringQualityRepo
             visibleAuthoredContent: visibleRenderableCount > 0,
             selectableAuthoredContent: selectableCount > 0,
             relationshipsValid,
-            generatorPreviews,
             cameraUseful: cameraResult.useful,
         },
         metrics: {
@@ -197,8 +162,6 @@ export function authoringQualityReport(viewer: ViewerLike): AuthoringQualityRepo
             renderableCount,
             visibleRenderableCount,
             selectableCount,
-            generatorCount: generators.length,
-            generatorPreviewCount: boundedPreviewSourceIds.size,
             cameraFramedRenderableCount: cameraResult.framed,
             cameraInsideRenderableCount: cameraResult.inside,
         },
@@ -415,7 +378,7 @@ function runtimeRelationshipIssues(scene: SceneLike, sources: Map<string, Source
             return
         }
         const runtime = getRuntimeObjectMetadata(object)
-        if (!runtime || runtime.kind === 'effect' || source.metadata.role === 'generator') return
+        if (!runtime || runtime.kind === 'effect') return
         const overrides = new Set<RuntimeMutableProperty>(runtime.overrides || [])
         if (JSON.stringify(runtimeSignature(source.object, overrides)) !== JSON.stringify(runtimeSignature(object, overrides))) {
             pushIssue(issues, {

package/src/index.ts

@@ -8,7 +8,6 @@ export * from './sceneSerialization.ts'
 export * from './authoring.ts'
 export * from './authoringValidation.ts'
 export * from './plugins/HtmlUiComponent.ts'
-export * from './plugins/GeneratorComponent.ts'
 export * from './plugins/cannon/CannonPhysicsPlugin.ts'
 export * from './plugins/cannon/Cannon3DBodyComponent.ts'
 export * from './plugins/cannon/Cannon3DShapeComponent.ts'

package/src/runtime/createGame.ts

@@ -18,7 +18,6 @@ import {
 import {MeshoptDecoder} from 'meshoptimizer'
 import {registerScripts} from '../scripts.ts'
 import {HtmlUiComponent} from '../plugins/HtmlUiComponent.ts'
-import {GeneratorComponent} from '../plugins/GeneratorComponent.ts'
 import {CannonPhysicsPlugin} from '../plugins/cannon/CannonPhysicsPlugin.ts'
 import {
     installGameHooks,
@@ -73,7 +72,7 @@ export function createGame(options: CreateGameOptions): Promise<CreatedGame> {
     return createProjectGame(options, true)
 }
 
-/** 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 function createStoppedGame(options: CreateGameOptions): Promise<CreatedGame> {
     return createProjectGame(options, false)
 }
@@ -137,8 +136,6 @@ async function createProjectGame({
         viewer.timeline.endTime = 0
         gameHooks = installGameHooks()
         entityComponents.addComponentType(HtmlUiComponent)
-        entityComponents.addComponentType(GeneratorComponent)
-        GeneratorComponent.configureViewer(viewer, {base: baseUrl, onError: reportError})
 
         // Three's LoadingManager delegates through this importer hook. It covers
         // glTF buffers/textures and nested imports without patching global fetch.
@@ -158,7 +155,6 @@ async function createProjectGame({
         }
         await nestedAssets.loadObjectDependencies(loadedScene as IObject3D)
         await nestedAssets.waitForPending()
-        await GeneratorComponent.waitForViewer(viewer)
 
         if (start) {
             viewer.timeline.reset()

package/src/runtime/index.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/src/runtime/projectFormat.ts

@@ -2,18 +2,11 @@ import {parse, ParseError} from 'jsonc-parser'
 
 export const settingsKey = 'kite3d'
 export const assetUrlPrefix = `/${settingsKey}/`
+export 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>
-}
-
 export interface AssetsJSONManifest {
     files: Record<string, {
         path: string
@@ -147,45 +140,28 @@ export function validateSceneSource(path: string, text: string): void {
     }
 }
 
-export function readProjectGeneratorStates(text: string): ProjectGeneratorState[] {
-    try {
-        const document = JSON.parse(text) as {
-            nodes?: Array<{
-                name?: unknown
-                extras?: {EntityComponentPlugin?: Record<string, {type?: unknown, state?: unknown}>}
-            }>
-        }
-        const generators: ProjectGeneratorState[] = []
-        for (const [nodeIndex, node] of (document.nodes || []).entries()) {
-            for (const [componentId, component] of Object.entries(node.extras?.EntityComponentPlugin || {})) {
-                if (component.type !== 'Generator' || !isRecord(component.state)) continue
-                generators.push({
-                    componentId,
-                    module: typeof component.state.module === 'string' ? component.state.module : '',
-                    nodeIndex,
-                    nodeName: typeof node.name === 'string' ? node.name : `Node ${nodeIndex}`,
-                    params: isRecord(component.state.params) ? component.state.params : {},
-                })
-            }
-        }
-        return generators
-    } catch {
-        return []
+/** Find nodes that still carry the component removed in Kite3D 0.19.0. */
+export function findRemovedGeneratorNodes(text: string): Array<{nodeIndex: number, nodeName: string}> {
+    const document = JSON.parse(text) as {
+        nodes?: Array<{
+            name?: unknown
+            extras?: {EntityComponentPlugin?: Record<string, {type?: unknown}>}
+        }>
+    }
+    const nodes: Array<{nodeIndex: number, nodeName: string}> = []
+    for (const [nodeIndex, node] of (document.nodes || []).entries()) {
+        const components = Object.values(node.extras?.EntityComponentPlugin || {})
+        if (!components.some(({type}) => type === 'Generator')) continue
+        nodes.push({
+            nodeIndex,
+            nodeName: typeof node.name === 'string' && node.name.trim() ? node.name : `Node ${nodeIndex}`,
+        })
     }
+    return nodes
 }
 
-export function updateProjectGeneratorState(
-    text: string,
-    generator: Pick<ProjectGeneratorState, 'componentId' | 'nodeIndex' | 'nodeName'>,
-    update: Partial<Pick<ProjectGeneratorState, 'module' | 'params'>>,
-): {text: string, state: Record<string, unknown>} {
-    const document = JSON.parse(text) as {
-        nodes?: Array<{extras?: {EntityComponentPlugin?: Record<string, {state?: unknown}>}}>
-    }
-    const state = document.nodes?.[generator.nodeIndex]?.extras?.EntityComponentPlugin?.[generator.componentId]?.state
-    if (!isRecord(state)) throw new Error(`Generator component is missing on ${generator.nodeName}`)
-    Object.assign(state, update)
-    return {text: JSON.stringify(document, null, 2), state}
+export function removedGeneratorMessage(nodeName: string): string {
+    return `${REMOVED_GENERATOR_GUIDANCE} Convert ${nodeName} to asset files. See the guide's Scene asset management section.`
 }
 
 export async function parsePackageJsonSettingsConfig(json: ProjectPackageJSON, _project?: unknown): Promise<ProjectConfigSettings> {