unity-open-mcp 0.5.0 → 0.7.0

package/dist/offline/types.js

@@ -0,0 +1,154 @@
+// Shared internal types and constants for the offline asset reader.
+//
+// Extracted from the former monolithic offline.ts (M28-refactoring Plan 3,
+// T3.1). These types and lookup tables are imported by every offline submodule
+// — parse, hierarchy, overrides, references, primitives. Keeping them in one
+// leaf module with no runtime imports of its own preserves the static,
+// type-stripping-safe import graph.
+import { extname } from "node:path";
+// ===========================================================================
+// Native Unity class IDs → names.
+// ===========================================================================
+export const nativeClassNames = {
+    1: "GameObject",
+    4: "Transform",
+    20: "Camera",
+    23: "MeshRenderer",
+    33: "MeshFilter",
+    64: "MeshCollider",
+    65: "BoxCollider",
+    81: "AudioListener",
+    82: "AudioSource",
+    95: "Animator",
+    108: "Light",
+    114: "MonoBehaviour",
+    115: "MonoScript",
+    120: "LineRenderer",
+    137: "SkinnedMeshRenderer",
+    156: "Terrain",
+    198: "ParticleSystem",
+    212: "SpriteRenderer",
+    222: "CanvasRenderer",
+    223: "Canvas",
+    224: "RectTransform",
+    225: "CanvasGroup",
+    329: "VideoPlayer",
+    73398921: "VFXRenderer",
+};
+export function nativeClassName(classID) {
+    return nativeClassNames[classID] ?? "";
+}
+// ===========================================================================
+// Kind / extension utilities.
+// ===========================================================================
+export const extToKind = {
+    ".anim": "anim",
+    ".asmdef": "asmdef",
+    ".asset": "asset",
+    ".controller": "controller",
+    ".cs": "cs",
+    ".mat": "mat",
+    ".overrideController": "controller",
+    ".physicsMaterial2D": "physics2d",
+    ".physicMaterial": "physics",
+    ".playable": "playable",
+    ".prefab": "prefab",
+    ".preset": "preset",
+    ".shader": "shader",
+    ".shadergraph": "shadergraph",
+    ".shadersubgraph": "shadergraph",
+    ".spriteatlas": "atlas",
+    ".terrainlayer": "terrainlayer",
+    ".unity": "scene",
+    ".uss": "uss",
+    ".uxml": "uxml",
+    ".vfx": "vfx",
+    ".meta": "meta",
+};
+// ===========================================================================
+// M24 — offline-parseable extension sets.
+// YAML_PARSEABLE covers text-serialized Unity YAML; JSON_PARSEABLE covers the
+// JSON asset kinds unity-scanner does not handle (our differentiator). Both are
+// merged into OFFLINE_PARSEABLE for the read_asset / search / find_references
+// gates. LISTABLE stays broader (it never parses, only enumerates files).
+// ===========================================================================
+export const YAML_PARSEABLE_EXTENSIONS = new Set([
+    ".prefab", ".unity", ".asset", ".mat", ".controller", ".anim", ".playable",
+    ".preset", ".spriteatlas", ".terrainlayer", ".vfx",
+]);
+export const JSON_PARSEABLE_EXTENSIONS = new Set([
+    ".asmdef", ".shadergraph", ".shadersubgraph",
+]);
+export const OFFLINE_PARSEABLE_EXTENSIONS = new Set([
+    ...YAML_PARSEABLE_EXTENSIONS,
+    ...JSON_PARSEABLE_EXTENSIONS,
+]);
+export function offlineParseKind(assetPath) {
+    const dot = assetPath.lastIndexOf(".");
+    if (dot < 0)
+        return null;
+    const ext = assetPath.slice(dot).toLowerCase();
+    if (YAML_PARSEABLE_EXTENSIONS.has(ext))
+        return "yaml";
+    if (JSON_PARSEABLE_EXTENSIONS.has(ext))
+        return "json";
+    return null;
+}
+export const kindAliases = {
+    prefabs: "prefab",
+    scenes: "scene",
+    unity: "scene",
+    scripts: "cs",
+    script: "cs",
+    material: "mat",
+    materials: "mat",
+};
+export function kindForPath(path) {
+    const ext = extname(path);
+    if (extToKind[ext])
+        return extToKind[ext];
+    if (ext === "")
+        return "none";
+    return ext.slice(1).toLowerCase();
+}
+export function normalizeKind(kind) {
+    const trimmed = kind.trim().toLowerCase();
+    if (kindAliases[trimmed])
+        return kindAliases[trimmed];
+    return trimmed;
+}
+export function parseKindSet(raw) {
+    const out = new Set();
+    for (const part of raw.split(",")) {
+        const kind = normalizeKind(part);
+        if (kind !== "")
+            out.add(kind);
+    }
+    return out;
+}
+export const skipDirs = new Set([
+    ".git", ".vs", "Library", "Logs", "obj", "Obj",
+    "Temp", "Build", "Builds", "UserSettings", "node_modules",
+]);
+export function shouldSkipDir(name) {
+    return skipDirs.has(name);
+}
+// ===========================================================================
+// Field extraction allow-list (shared by YAML + prefab-override renderers).
+// ===========================================================================
+export const skipFieldNames = new Set([
+    "m_Name", "m_ObjectHideFlags", "m_CorrespondingSourceObject",
+    "m_PrefabInstance", "m_PrefabAsset", "serializedVersion",
+    "m_GameObject", "m_Script", "m_Enabled",
+    "m_EditorHideFlags", "m_EditorClassIdentifier", "m_Modification",
+]);
+// A ParsedAsset stand-in used only by resolveReferences' local-reference path.
+// JSON assets have no in-file fileIDs, so local ref resolution is a no-op.
+export const EMPTY_PARSED = {
+    path: "",
+    kind: "",
+    guid: "",
+    objects: [],
+    byID: new Map(),
+};
+//# sourceMappingURL=types.js.map

package/dist/offline/types.js.map

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

package/dist/offline.d.ts

@@ -1,180 +1,2 @@
-import type { AssetModel, SearchModel } from "./compression/asset-model.js";
-export declare function isOfflineAsset(assetPath: string): boolean;
-export interface OfflineReadResult {
-    model: AssetModel;
-    source: "offline";
-}
-/**
- * M24 — full-hierarchy parity helper. The offline `objectCount` counts every
- * YAML object in the file; the live `read_asset` bridge counts only GameObjects
- * + the components attached to them (it walks the loaded Transform tree, not
- * the raw YAML). This helper returns the live-comparable counts so an
- * acceptance test can verify the offline-reconstructed tree matches a live read
- * node-for-node and component-for-component, without depending on the bridge.
- *
- * Returns `{ nodes, components }` where `nodes` is the GameObject count and
- * `components` is the sum of components across the tree — the two numbers the
- * live `ReadAssetTool` emits as `objectCount` (nodes+components) and
- * `componentCount`.
- */
-export declare function countHierarchy(model: AssetModel): {
-    nodes: number;
-    components: number;
-};
-export declare function readAssetOffline(assetPath: string, opts: {
-    fieldLimit: number;
-    projectRoot: string;
-}): Promise<OfflineReadResult>;
-export declare function searchAssetsOffline(opts: {
-    name?: string;
-    component?: string;
-    guid?: string;
-    type?: string;
-    folder?: string;
-    projectRoot: string;
-    maxResults?: number;
-}): Promise<SearchModel>;
-export interface FolderListing {
-    folder: string;
-    kinds: Record<string, {
-        count: number;
-        sample: string[];
-    }>;
-    fileCount: number;
-}
-export interface ListAssetsResult {
-    root: string;
-    typeFilter?: string;
-    folders: FolderListing[];
-    totalFiles: number;
-    totalFolders: number;
-    kindSummary: Record<string, number>;
-    truncated: number;
-}
-export declare function listAssetsOffline(opts: {
-    folder?: string;
-    type?: string;
-    maxPerFolder?: number;
-    projectRoot: string;
-}): Promise<ListAssetsResult>;
-export interface ReferencedByEntry {
-    assetPath: string;
-    guid?: string;
-    kind: string;
-    folder: string;
-    /** Verbose-only: field locations where the GUID appears (capped). */
-    locations?: string[];
-}
-export interface CollapsedGroup {
-    folder: string;
-    count: number;
-    kinds: Record<string, number>;
-}
-export interface FindReferencesOfflineResult {
-    queriedAssetPath: string;
-    queriedAssetGuid: string;
-    referencedBy: ReferencedByEntry[];
-    totalCount: number;
-    byKind: Record<string, number>;
-    byFolder: Record<string, number>;
-    collapsedGroups?: CollapsedGroup[];
-    detail: string;
-    truncated: number;
-}
-export declare function findReferencesOffline(opts: {
-    assetPath?: string;
-    guid?: string;
-    detail?: string;
-    maxResults?: number;
-    maxPerFile?: number;
-    patternThreshold?: number;
-    projectRoot: string;
-}): Promise<FindReferencesOfflineResult>;
-/** Edge-kind discriminator — surfaces HOW a forward edge was declared so an
- * agent can reason about a missing ref (a broken m_Script is a different fix
- * than a broken prefab base). Mirrors the C# Dependencies.Scanner edge kinds. */
-export type ForwardEdgeKind = "pptr" | "script" | "prefab_source";
-export interface ForwardEdge {
-    guid: string;
-    assetPath: string;
-    kind: ForwardEdgeKind;
-    resolved: boolean;
-}
-export interface ReverseEdge {
-    assetPath: string;
-    guid: string;
-    kind: string;
-}
-export interface ImpactEntry {
-    assetPath: string;
-    /** Hop distance from the queried asset (1 = direct reverse edge). */
-    depth: number;
-}
-export interface DependenciesOfflineResult {
-    queriedAssetPath: string;
-    queriedAssetGuid: string;
-    forwardDependencies: ForwardEdge[];
-    forwardCount: number;
-    /** Distinct unresolved forward-edge target GUIDs (the broken_dependency set). */
-    brokenForwardGuids: string[];
-    /** Dependency cycles passing through the queried asset (each a path list). */
-    cycles: string[][];
-    reverseDependencies: ReverseEdge[];
-    reverseCount: number;
-    /** Transitive reverse closure ("what breaks if I delete/move this?"). Empty
-     * unless opts.includeImpact is set — the walk is the expensive part. */
-    impact?: {
-        affected: ImpactEntry[];
-        affectedCount: number;
-        maxDepth: number;
-        /** True when the impact walk hit the depth bound before exhausting the
-         * graph — the affected set is a prefix, not the full closure. */
-        truncated: boolean;
-    };
-    detail: string;
-    /** Reverse-edge roster truncation count (max_results cap). */
-    truncated: number;
-    /** Non-fatal: forward-edge extraction failed to parse the queried asset as
-     * YAML (e.g. a JSON-only kind or a binary asset read offline). The forward
-     * arrays are empty and this names the reason; reverse edges are unaffected. */
-    forwardSkipped?: string;
-    _source: "offline";
-}
-export declare function dependenciesOffline(opts: {
-    assetPath?: string;
-    guid?: string;
-    detail?: string;
-    maxResults?: number;
-    /** Include the transitive impact closure (multi-hop reverse). Default
-     * false — the BFS is the expensive part of this call. */
-    includeImpact?: boolean;
-    /** Max hop depth for the impact BFS (default 5). Bounds the walk on large
-     * graphs. */
-    maxImpactDepth?: number;
-    /** Max depth for the forward-cycle DFS (default 8). */
-    maxCycleDepth?: number;
-    projectRoot: string;
-}): Promise<DependenciesOfflineResult>;
-export interface IntegrityScanEntry {
-    /** The asset/.meta path the issue is reported on. */
-    path: string;
-    code: string;
-    severity: "error" | "warning" | "info";
-    detail: string;
-    /** For duplicate_guid: the other paths sharing this GUID. */
-    relatedPaths?: string[];
-}
-export interface IntegrityScanResult {
-    issues: IntegrityScanEntry[];
-    byCode: Record<string, number>;
-    totalIssues: number;
-    assetsScanned: number;
-    _source: "offline";
-}
-/** Scan the whole Assets/ tree for project-wide integrity issues that the
- *  per-read checks cannot surface (orphaned .meta, duplicate GUIDs) plus the
- *  aggregated missing-reference set. Offline counterpart of a full verify
- *  scan_paths run for these three rule families. */
-export declare function scanIntegrityOffline(opts: {
-    projectRoot: string;
-}): Promise<IntegrityScanResult>;
+export { readAssetOffline, searchAssetsOffline, listAssetsOffline, findReferencesOffline, dependenciesOffline, scanIntegrityOffline, isOfflineAsset, countHierarchy, } from "./offline/api.js";
+export type { OfflineReadResult, FolderListing, ListAssetsResult, ReferencedByEntry, CollapsedGroup, FindReferencesOfflineResult, ForwardEdgeKind, ForwardEdge, ReverseEdge, ImpactEntry, DependenciesOfflineResult, IntegrityScanEntry, IntegrityScanResult, } from "./offline/api.js";