unity-open-mcp 0.5.0 → 0.7.0

package/dist/offline/parse.js

@@ -0,0 +1,236 @@
+// YAML + JSON text parsing for the offline asset reader.
+//
+// Extracted from the former monolithic offline.ts (M28-refactoring Plan 3,
+// T3.1). Two parsing paths:
+//   - parseAsset — splits a Unity YAML document stream into ParsedObjects,
+//     extracting the per-object key fields (m_Name, component IDs, transform
+//     parent links, source-prefab refs, m_Script GUIDs). Runs the prefab
+//     override name-resolution pass at the end of parsing.
+//   - The JSON asset path (.asmdef / .shadergraph / .shadersubgraph): a
+//     brace-depth stream splitter + per-object discriminator. unity-scanner
+//     handles YAML only, so this is the coverage differentiator.
+//
+// Depends on types + primitives + overrides (for applyPrefabNameOverrides at
+// parse time).
+import { EMPTY_PARSED } from "./types.js";
+import { parseHeaderLine, readComponentIDs, readFileIDField, readGUIDField, readScalar, scanObjectTypeLine, } from "./primitives.js";
+import { applyPrefabNameOverrides } from "./overrides.js";
+// ===========================================================================
+// YAML parser — split YAML into documents, extract key fields per object.
+// ===========================================================================
+export function parseAsset(data) {
+    const objects = [];
+    const byID = new Map();
+    const lines = data.split("\n");
+    let current = null;
+    for (const line of lines) {
+        const header = parseHeaderLine(line);
+        if (header) {
+            if (current)
+                finishObject(current, objects, byID);
+            current = {
+                id: header.id,
+                classID: header.classID,
+                type: "",
+                lines: [],
+                order: objects.length,
+                name: "",
+                componentIDs: [],
+                gameObjectID: "",
+                fatherTransformID: "",
+                sourceObjectID: "",
+                sourceGUID: "",
+                scriptGUID: "",
+            };
+            continue;
+        }
+        if (current === null)
+            continue;
+        current.lines.push(line);
+        scanObjectTypeLine(current, line);
+    }
+    if (current)
+        finishObject(current, objects, byID);
+    if (objects.length === 0) {
+        throw new Error("no Unity YAML objects found");
+    }
+    applyPrefabNameOverrides(objects);
+    return { path: "", kind: "", guid: "", objects, byID };
+}
+function finishObject(o, objects, byID) {
+    if (o.lines.length > 0) {
+        o.name = readScalar(o.lines, "m_Name");
+        switch (o.type) {
+            case "GameObject":
+                o.componentIDs = readComponentIDs(o.lines);
+                break;
+            case "Transform":
+            case "RectTransform":
+                o.gameObjectID = readFileIDField(o.lines, "m_GameObject");
+                o.fatherTransformID = readFileIDField(o.lines, "m_Father");
+                break;
+            default:
+                o.gameObjectID = readFileIDField(o.lines, "m_GameObject");
+                break;
+        }
+        o.sourceObjectID = readFileIDField(o.lines, "m_CorrespondingSourceObject");
+        o.sourceGUID = readGUIDField(o.lines, "m_CorrespondingSourceObject");
+        if (o.type === "MonoBehaviour") {
+            o.scriptGUID = readGUIDField(o.lines, "m_Script");
+        }
+    }
+    objects.push(o);
+    byID.set(o.id, o);
+}
+// ===========================================================================
+// M24 — JSON asset parser (.asmdef / .shadergraph / .shadersubgraph).
+//
+// unity-scanner handles YAML only; this path is the coverage differentiator.
+// Each kind has a distinct on-disk shape:
+//  - .asmdef  → a single JSON object (assembly-definition manifest).
+//  - .shadergraph / .shadersubgraph → a JSON-document stream: multiple pretty-
+//    printed JSON objects concatenated on blank-line boundaries, each carrying
+//    an "m_Type" discriminator. The first is always the graph root.
+// GUID references inside the JSON are resolved against the meta index the same
+// way YAML field refs are.
+// ===========================================================================
+export function parseJsonAsset(data, issues) {
+    const ext = "json";
+    const chunks = splitJsonStream(data);
+    if (chunks.length === 0) {
+        issues.push({ code: "malformed_json", detail: "no JSON objects found", severity: "error" });
+        return [];
+    }
+    const out = [];
+    for (let i = 0; i < chunks.length; i++) {
+        let value;
+        try {
+            value = JSON.parse(chunks[i]);
+        }
+        catch (e) {
+            issues.push({
+                code: "malformed_json",
+                detail: `object ${i + 1}: ${e.message}`,
+                severity: "error",
+            });
+            continue;
+        }
+        out.push(jsonParsedObject(value, i));
+    }
+    return out;
+    function jsonParsedObject(value, index) {
+        if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+            const obj = value;
+            const type = typeof obj.m_Type === "string" && obj.m_Type !== ""
+                ? jsonShortType(obj.m_Type)
+                : "json";
+            const name = pickString(obj.m_Name) ??
+                pickString(obj.m_ObjectId) ??
+                pickString(obj.name) ??
+                (type !== "json" ? `${type}#${index}` : `object#${index}`);
+            return { name, type, value };
+        }
+        return { name: `value#${index}`, type: ext, value };
+    }
+}
+export function pickString(v) {
+    return typeof v === "string" && v !== "" ? v : undefined;
+}
+/** Shorten a ShaderGraph m_Type like "UnityEditor.ShaderGraph.MultiplyNode" → "MultiplyNode". */
+export function jsonShortType(full) {
+    const dot = full.lastIndexOf(".");
+    return dot >= 0 ? full.slice(dot + 1) : full;
+}
+/**
+ * A `.shadergraph` is a stream of pretty-printed JSON objects. They are
+ * separated by blank lines, but a single object's pretty-printed body also
+ * contains newlines — so the split must track brace depth, not line gaps.
+ * `.asmdef` is a single object; this still returns a one-element array.
+ */
+export function splitJsonStream(data) {
+    const trimmed = data.trim();
+    if (trimmed === "")
+        return [];
+    const chunks = [];
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    let start = -1;
+    for (let i = 0; i < trimmed.length; i++) {
+        const ch = trimmed[i];
+        if (inString) {
+            if (escape)
+                escape = false;
+            else if (ch === "\\")
+                escape = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            continue;
+        }
+        if (ch === "{") {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0 && start >= 0) {
+                chunks.push(trimmed.slice(start, i + 1));
+                start = -1;
+            }
+        }
+    }
+    // Fallback: if brace tracking found nothing (e.g. a top-level array or a
+    // malformed file), try a single JSON.parse on the whole content so the
+    // malformed_json issue path can report it.
+    if (chunks.length === 0)
+        chunks.push(trimmed);
+    return chunks;
+}
+/**
+ * Flatten a parsed JSON value into display fields. Scalars, arrays, and nested
+ * objects are summarized into short `name: value` rows, mirroring the YAML
+ * field renderer. GUID refs are resolved against the meta index via the
+ * injected resolver (avoids a direct reference-resolution import here).
+ */
+export function jsonFields(value, limit, guidIndex, resolveRef) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return [];
+    const obj = value;
+    const out = [];
+    for (const [key, raw] of Object.entries(obj)) {
+        if (out.length >= limit && limit > 0)
+            break;
+        out.push({ name: key, value: jsonScalar(raw, guidIndex, resolveRef) });
+    }
+    return out;
+}
+export function jsonScalar(value, guidIndex, resolveRef) {
+    if (value === null)
+        return "null";
+    switch (typeof value) {
+        case "string":
+            return resolveRef(value, guidIndex, EMPTY_PARSED);
+        case "number":
+        case "boolean":
+            return String(value);
+        default: {
+            if (Array.isArray(value))
+                return `[${value.length}]`;
+            const obj = value;
+            // Inline {fileID, guid, type} PPtr → resolve to asset name.
+            if (typeof obj.guid === "string" && obj.guid.length === 32) {
+                return resolveRef(`{fileID: ${obj.fileID ?? 0}, guid: ${obj.guid}, type: ${obj.type ?? 0}}`, guidIndex, EMPTY_PARSED);
+            }
+            const keys = Object.keys(obj);
+            if (keys.length === 0)
+                return "{}";
+            return `{${keys.slice(0, 4).join(", ")}${keys.length > 4 ? ", …" : ""}}`;
+        }
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/offline/parse.js.map

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

package/dist/offline/paths.d.ts

@@ -0,0 +1,4 @@
+import { shouldSkipDir } from "./types.js";
+export declare function toAssetPath(projectRoot: string, absPath: string): string;
+export declare function relativeDir(projectRoot: string, absPath: string): string;
+export { shouldSkipDir };

package/dist/offline/paths.js

@@ -0,0 +1,23 @@
+// Path-normalization helpers for the offline reader.
+//
+// Extracted from the former monolithic offline.ts (M28-refactoring Plan 3,
+// T3.1). Converts absolute filesystem paths to project-relative asset paths
+// (forward-slash normalized) and to relative directory segments. A leaf
+// module — depends only on node:path.
+import { relative, sep } from "node:path";
+import { shouldSkipDir } from "./types.js";
+export function toAssetPath(projectRoot, absPath) {
+    let rel = relative(projectRoot, absPath);
+    if (sep === "\\")
+        rel = rel.replace(/\\/g, "/");
+    return rel;
+}
+export function relativeDir(projectRoot, absPath) {
+    let rel = absPath.slice(projectRoot.length).replace(/\\/g, "/");
+    if (rel.startsWith("/"))
+        rel = rel.slice(1);
+    const lastSlash = rel.lastIndexOf("/");
+    return lastSlash >= 0 ? rel.slice(0, lastSlash) : rel;
+}
+export { shouldSkipDir };
+//# sourceMappingURL=paths.js.map

package/dist/offline/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/offline/paths.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAe;IAC9D,IAAI,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,IAAI;QAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAe;IAC9D,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACxD,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/offline/primitives.d.ts

@@ -0,0 +1,17 @@
+import type { HeaderInfo, ParsedObject } from "./types.js";
+export declare function scanObjectTypeLine(obj: ParsedObject, line: string): boolean;
+export declare function parseHeaderLine(line: string): HeaderInfo | null;
+export declare function parsePositiveInt(value: string): number | null;
+export declare function readScalar(lines: string[], key: string): string;
+export declare function readFileIDField(lines: string[], key: string): string;
+export declare function readGUIDField(lines: string[], key: string): string;
+export declare function readComponentIDs(lines: string[]): string[];
+export declare function extractFileID(line: string): string;
+export declare function extractGUID(line: string): string;
+export declare function findGUIDs(value: string): string[];
+export declare function findFileIDs(value: string): string[];
+export declare function scanGUID(value: string): string;
+export declare function isHex(code: number): boolean;
+export declare function cleanScalar(value: string): string;
+export declare function shortGUID(guid: string): string;
+export declare function readMetaGUID(data: string): string;

package/dist/offline/primitives.js

@@ -0,0 +1,195 @@
+// Low-level extraction primitives for the offline YAML/JSON parser.
+//
+// Extracted from the former monolithic offline.ts (M28-refactoring Plan 3,
+// T3.1). These are the leaf scanning functions — GUID/fileID extraction,
+// scalar cleaning, header parsing, line-shape classification. They depend only
+// on the shared types module; no cross-submodule runtime imports.
+// ===========================================================================
+// Line-scanning helpers.
+// ===========================================================================
+export function scanObjectTypeLine(obj, line) {
+    if (obj.type !== "" || line.length <= 1 || line[0] === " " || !line.endsWith(":")) {
+        return false;
+    }
+    obj.type = line.slice(0, -1).trim();
+    return true;
+}
+// ===========================================================================
+// Low-level extraction primitives.
+// ===========================================================================
+export function parseHeaderLine(line) {
+    const prefix = "--- !u!";
+    if (!line.startsWith(prefix))
+        return null;
+    const rest = line.slice(prefix.length);
+    const space = rest.indexOf(" ");
+    if (space <= 0 || space + 2 > rest.length || rest[space + 1] !== "&")
+        return null;
+    const classID = parsePositiveInt(rest.slice(0, space));
+    if (classID === null)
+        return null;
+    let id = rest.slice(space + 2);
+    const fields = id.split(/\s+/);
+    if (fields.length > 0)
+        id = fields[0];
+    if (id === "")
+        return null;
+    return { classID, id };
+}
+export function parsePositiveInt(value) {
+    if (value.length === 0)
+        return null;
+    let out = 0;
+    for (const ch of value) {
+        if (ch < "0" || ch > "9")
+            return null;
+        out = out * 10 + (ch.charCodeAt(0) - "0".charCodeAt(0));
+    }
+    return out;
+}
+export function readScalar(lines, key) {
+    const prefix = `  ${key}:`;
+    for (const line of lines) {
+        if (line.startsWith(prefix))
+            return cleanScalar(line.slice(prefix.length).trim());
+    }
+    return "";
+}
+export function readFileIDField(lines, key) {
+    const prefix = `  ${key}:`;
+    for (const line of lines) {
+        if (line.startsWith(prefix))
+            return extractFileID(line);
+    }
+    return "";
+}
+export function readGUIDField(lines, key) {
+    const prefix = `  ${key}:`;
+    for (const line of lines) {
+        if (line.startsWith(prefix))
+            return extractGUID(line);
+    }
+    return "";
+}
+export function readComponentIDs(lines) {
+    const ids = [];
+    for (const line of lines) {
+        if (line.includes("- component:")) {
+            const id = extractFileID(line);
+            if (id !== "" && id !== "0")
+                ids.push(id);
+        }
+    }
+    return ids;
+}
+export function extractFileID(line) {
+    const start = line.indexOf("fileID:");
+    if (start < 0)
+        return "";
+    let i = start + "fileID:".length;
+    while (i < line.length && line[i] === " ")
+        i++;
+    const begin = i;
+    if (i < line.length && line[i] === "-")
+        i++;
+    while (i < line.length && line[i] >= "0" && line[i] <= "9")
+        i++;
+    if (i === begin || (line[begin] === "-" && i === begin + 1))
+        return "";
+    return line.slice(begin, i);
+}
+export function extractGUID(line) {
+    const start = line.indexOf("guid:");
+    if (start < 0)
+        return "";
+    return scanGUID(line.slice(start + "guid:".length));
+}
+export function findGUIDs(value) {
+    const out = [];
+    let offset = 0;
+    while (offset < value.length) {
+        const start = value.indexOf("guid:", offset);
+        if (start < 0)
+            break;
+        offset = start + "guid:".length;
+        const guid = scanGUID(value.slice(offset));
+        if (guid !== "") {
+            out.push(guid);
+            offset += guid.length;
+        }
+    }
+    return out;
+}
+export function findFileIDs(value) {
+    const out = [];
+    let offset = 0;
+    while (offset < value.length) {
+        const start = value.indexOf("fileID:", offset);
+        if (start < 0)
+            break;
+        offset = start + "fileID:".length;
+        while (offset < value.length && value[offset] === " ")
+            offset++;
+        const begin = offset;
+        if (offset < value.length && value[offset] === "-")
+            offset++;
+        while (offset < value.length && value[offset] >= "0" && value[offset] <= "9")
+            offset++;
+        if (offset === begin || (value[begin] === "-" && offset === begin + 1))
+            continue;
+        out.push(value.slice(begin, offset));
+    }
+    return out;
+}
+export function scanGUID(value) {
+    let i = 0;
+    while (i < value.length && value[i] === " ")
+        i++;
+    const start = i;
+    while (i < value.length && isHex(value.charCodeAt(i)))
+        i++;
+    if (i === start)
+        return "";
+    return value.slice(start, i).toLowerCase();
+}
+export function isHex(code) {
+    return ((code >= 48 && code <= 57) ||
+        (code >= 97 && code <= 102) ||
+        (code >= 65 && code <= 70));
+}
+export function cleanScalar(value) {
+    value = value.trim();
+    if (value.length >= 2 && value[0] === '"' && value[value.length - 1] === '"') {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+export function shortGUID(guid) {
+    if (guid.length <= 8)
+        return guid;
+    return guid.slice(0, 8);
+}
+// ===========================================================================
+// .meta GUID extraction — reads the guid: line from a .meta file's contents.
+// ===========================================================================
+export function readMetaGUID(data) {
+    let start;
+    if (data.startsWith("guid:")) {
+        start = "guid:".length;
+    }
+    else {
+        const idx = data.indexOf("\nguid:");
+        if (idx < 0)
+            return "";
+        start = idx + 1 + "guid:".length;
+    }
+    const end = data.indexOf("\n", start);
+    const slice = end < 0 ? data.slice(start) : data.slice(start, end);
+    return slice.trim();
+}
+//# sourceMappingURL=primitives.js.map

package/dist/offline/primitives.js.map

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

package/dist/offline/references.d.ts

@@ -0,0 +1,9 @@
+import type { GUIDIndex, ParsedAsset } from "./types.js";
+import { componentName, localReferenceLabel, objectPath } from "./hierarchy.js";
+export declare function resolveReferences(value: string, guidIndex: GUIDIndex, asset: ParsedAsset): string;
+export declare const OVERRIDE_LABEL_HELPERS: {
+    objectPath: typeof objectPath;
+    localReferenceLabel: typeof localReferenceLabel;
+    componentName: typeof componentName;
+    resolveReferences: typeof resolveReferences;
+};

package/dist/offline/references.js

@@ -0,0 +1,55 @@
+// Reference resolution for the offline reader.
+//
+// Extracted from the former monolithic offline.ts (M28-refactoring Plan 3,
+// T3.1). resolveReferences rewrites a scalar field value to inline the
+// human-readable names of the assets it points at — via the GUID→path index for
+// external refs, and via the local FileID→object map for in-file refs. This is
+// the resolution primitive the hierarchy builder and JSON scalar renderer both
+// consume (injected, to keep the dependency one-directional).
+import { basename, extname } from "node:path";
+import { findFileIDs, findGUIDs } from "./primitives.js";
+import { componentName, localReferenceLabel, objectPath, } from "./hierarchy.js";
+export function resolveReferences(value, guidIndex, asset) {
+    const guids = findGUIDs(value);
+    if (guids.length > 0) {
+        const refs = [];
+        const seen = new Set();
+        for (const guid of guids) {
+            const path = guidIndex.get(guid);
+            if (!path || seen.has(path))
+                continue;
+            seen.add(path);
+            const name = basename(path);
+            const ext = extname(name);
+            refs.push(ext ? name.slice(0, -ext.length) : name);
+        }
+        if (refs.length > 0)
+            return `${value} -> ${refs.join(", ")}`;
+    }
+    if (guids.length === 0) {
+        const refs = [];
+        const seen = new Set();
+        for (const fileID of findFileIDs(value)) {
+            const label = localReferenceLabel(asset, fileID);
+            if (label === "" || seen.has(label))
+                continue;
+            seen.add(label);
+            refs.push(label);
+        }
+        if (refs.length > 0)
+            return `${value} -> ${refs.join(", ")}`;
+    }
+    return value;
+}
+// Wire the overrides label-registry with this module's hierarchy-backed
+// implementations. overrides.ts needs objectPath / localReferenceLabel /
+// componentName / resolveReferences for its label resolver, but cannot import
+// references.ts (references imports overrides' collectOverrides). The
+// late-bound registry breaks the cycle; this is the only wiring site.
+export const OVERRIDE_LABEL_HELPERS = {
+    objectPath,
+    localReferenceLabel,
+    componentName,
+    resolveReferences,
+};
+//# sourceMappingURL=references.js.map

package/dist/offline/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/offline/references.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,8DAA8D;AAE9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,SAAoB,EACpB,KAAkB;IAElB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YACtC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC9C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,yEAAyE;AACzE,8EAA8E;AAC9E,sEAAsE;AACtE,sEAAsE;AACtE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,UAAU;IACV,mBAAmB;IACnB,aAAa;IACb,iBAAiB;CAClB,CAAC"}

package/dist/offline/types.d.ts

@@ -0,0 +1,65 @@
+import type { PrefabOverrideEntry, AssetIntegrityIssue } from "../compression/asset-model.js";
+export interface ParsedObject {
+    id: string;
+    classID: number;
+    type: string;
+    lines: string[];
+    order: number;
+    name: string;
+    componentIDs: string[];
+    gameObjectID: string;
+    fatherTransformID: string;
+    sourceObjectID: string;
+    sourceGUID: string;
+    scriptGUID: string;
+}
+export interface HierarchyResult {
+    gameObject: ParsedObject;
+    children: HierarchyResult[];
+    path: string;
+    depth: number;
+}
+export interface ParsedAsset {
+    path: string;
+    kind: string;
+    guid: string;
+    objects: ParsedObject[];
+    byID: Map<string, ParsedObject>;
+}
+export type ScriptIndex = Map<string, string>;
+export type GUIDIndex = Map<string, string>;
+export interface PrefabOverride {
+    kind: string;
+    target: string;
+    propertyPath: string;
+    value: string;
+    addedObject: string;
+}
+export interface HeaderInfo {
+    classID: number;
+    id: string;
+}
+export interface JsonParsedObject {
+    /** Display label (m_Name / m_ObjectId / name key, or a generated label). */
+    name: string;
+    /** Type label (top-level kind, or the m_Type discriminator for shadergraph). */
+    type: string;
+    /** The parsed JSON value. */
+    value: unknown;
+}
+export type { PrefabOverrideEntry, AssetIntegrityIssue };
+export declare const nativeClassNames: Record<number, string>;
+export declare function nativeClassName(classID: number): string;
+export declare const extToKind: Record<string, string>;
+export declare const YAML_PARSEABLE_EXTENSIONS: Set<string>;
+export declare const JSON_PARSEABLE_EXTENSIONS: Set<string>;
+export declare const OFFLINE_PARSEABLE_EXTENSIONS: Set<string>;
+export declare function offlineParseKind(assetPath: string): "yaml" | "json" | null;
+export declare const kindAliases: Record<string, string>;
+export declare function kindForPath(path: string): string;
+export declare function normalizeKind(kind: string): string;
+export declare function parseKindSet(raw: string): Set<string>;
+export declare const skipDirs: Set<string>;
+export declare function shouldSkipDir(name: string): boolean;
+export declare const skipFieldNames: Set<string>;
+export declare const EMPTY_PARSED: ParsedAsset;