@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/commands/trace.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/trace.ts"],
-  "sourcesContent": ["/**\n * Trace command - display dependency trace for an element\n */\n\nimport ansis from 'ansis';\nimport { Model } from '../core/model.js';\nimport { ReferenceRegistry } from '../core/reference-registry.js';\nimport { DependencyTracker, TraceDirection } from '../core/dependency-tracker.js';\nimport { findElementLayer } from '../utils/element-utils.js';\n\nexport async function traceCommand(\n  elementId: string,\n  options: {\n    direction?: 'up' | 'down' | 'both';\n    depth?: number;\n    showMetrics?: boolean;\n    model?: string;\n  } = {}\n): Promise<void> {\n  try {\n    // Load model\n    const model = await Model.load(options.model);\n\n    // Find element\n    const layerName = await findElementLayer(model, elementId);\n    if (!layerName) {\n      console.error(ansis.red(`Error: Element ${elementId} not found`));\n      process.exit(1);\n    }\n\n    // Build reference registry\n    const registry = new ReferenceRegistry();\n    for (const layer of model.layers.values()) {\n      for (const element of layer.listElements()) {\n        registry.registerElement(element);\n      }\n    }\n\n    // Create dependency tracker with registry\n    const tracker = new DependencyTracker(registry);\n\n    // Set default direction\n    const direction = options.direction || 'both';\n\n    // Display header\n    console.log('');\n    console.log(\n      ansis.bold(\n        `${ansis.blue('Dependency Trace:')} ${ansis.yellow(elementId)}`\n      )\n    );\n    console.log(ansis.dim('\u2500'.repeat(80)));\n\n    // Display dependents (elements that depend on this element - upward)\n    if (direction === 'up' || direction === 'both') {\n      const transitiveDependents = tracker.traceDependencies(elementId, TraceDirection.DOWN, null);\n      const directDependents = tracker.traceDependencies(elementId, TraceDirection.DOWN, 1);\n\n      console.log('');\n      console.log(\n        ansis.cyan(\n          `Dependents (${directDependents.length} direct, ${transitiveDependents.length} transitive):`\n        )\n      );\n\n      if (directDependents.length === 0) {\n        console.log(ansis.dim('  (none)'));\n      } else {\n        // Show direct dependents with indentation\n        console.log(ansis.gray('  Direct:'));\n        for (const dep of directDependents.slice(0, 10)) {\n          console.log(\n            `    ${ansis.yellow('\u2190')} ${ansis.green(dep)}`\n          );\n        }\n        if (directDependents.length > 10) {\n          console.log(\n            ansis.dim(`    ... and ${directDependents.length - 10} more`)\n          );\n        }\n      }\n\n      if (transitiveDependents.length > 0 && directDependents.length > 0) {\n        console.log(ansis.gray('  Transitive:'));\n        const transitiveOnly = transitiveDependents.filter(\n          (d: string) => !directDependents.includes(d)\n        );\n        for (const dep of transitiveOnly.slice(0, 10)) {\n          console.log(\n            `    ${ansis.yellow('\u2196')} ${ansis.dim(dep)}`\n          );\n        }\n        if (transitiveOnly.length > 10) {\n          console.log(\n            ansis.dim(`    ... and ${transitiveOnly.length - 10} more`)\n          );\n        }\n      }\n    }\n\n    // Display dependencies (elements this element depends on - downward)\n    if (direction === 'down' || direction === 'both') {\n      const transitiveDependencies = tracker.traceDependencies(\n        elementId,\n        TraceDirection.UP,\n        null\n      );\n      const directDependencies = tracker.traceDependencies(elementId, TraceDirection.UP, 1);\n\n      console.log('');\n      console.log(\n        ansis.cyan(\n          `Dependencies (${directDependencies.length} direct, ${transitiveDependencies.length} transitive):`\n        )\n      );\n\n      if (directDependencies.length === 0) {\n        console.log(ansis.dim('  (none)'));\n      } else {\n        // Show direct dependencies with indentation\n        console.log(ansis.gray('  Direct:'));\n        for (const dep of directDependencies.slice(0, 10)) {\n          console.log(\n            `    ${ansis.yellow('\u2192')} ${ansis.green(dep)}`\n          );\n        }\n        if (directDependencies.length > 10) {\n          console.log(\n            ansis.dim(`    ... and ${directDependencies.length - 10} more`)\n          );\n        }\n      }\n\n      if (transitiveDependencies.length > 0 && directDependencies.length > 0) {\n        console.log(ansis.gray('  Transitive:'));\n        const transitiveOnly = transitiveDependencies.filter(\n          (d: string) => !directDependencies.includes(d)\n        );\n        for (const dep of transitiveOnly.slice(0, 10)) {\n          console.log(\n            `    ${ansis.yellow('\u2198')} ${ansis.dim(dep)}`\n          );\n        }\n        if (transitiveOnly.length > 10) {\n          console.log(\n            ansis.dim(`    ... and ${transitiveOnly.length - 10} more`)\n          );\n        }\n      }\n    }\n\n    // Note: Advanced features like cycle detection and metrics are not yet implemented\n    // in the refactored DependencyTracker matching Python CLI API\n\n    console.log('');\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Trace command - display dependency trace for an element\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { ReferenceRegistry } from \"../core/reference-registry.js\";\nimport { DependencyTracker, TraceDirection } from \"../core/dependency-tracker.js\";\nimport { findElementLayer } from \"../utils/element-utils.js\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { CLIError } from \"../utils/errors.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\nexport async function traceCommand(\n  elementId: string,\n  options: {\n    direction?: \"up\" | \"down\" | \"both\";\n    depth?: number;\n    showMetrics?: boolean;\n    model?: string;\n  } = {}\n): Promise<void> {\n  const direction = options.direction || \"both\";\n  const span = isTelemetryEnabled\n    ? startSpan(\"trace.execute\", {\n        \"trace.elementId\": elementId,\n        \"trace.direction\": direction,\n        \"trace.hasDepthLimit\": options.depth !== undefined,\n        \"trace.depth\": options.depth,\n      })\n    : null;\n\n  try {\n    // Load model\n    const model = await Model.load(options.model);\n\n    // Find element\n    const layerName = await findElementLayer(model, elementId);\n    if (!layerName) {\n      if (isTelemetryEnabled && span) {\n        (span as any).setAttribute(\"trace.found\", false);\n      }\n      throw new CLIError(`Element ${elementId} not found`, 1);\n    }\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"trace.found\", true);\n      (span as any).setAttribute(\"trace.layer\", layerName);\n    }\n\n    // Build reference registry from element cross-layer references\n    const registry = new ReferenceRegistry();\n    for (const layer of model.layers.values()) {\n      for (const element of layer.listElements()) {\n        registry.registerElement(element);\n      }\n    }\n\n    // Extend the dependency graph with intra-layer relationships from\n    // relationships.yaml, which the registry doesn't load on its own.\n    const graph = registry.getDependencyGraph();\n    for (const rel of model.relationships.getAll()) {\n      if (!graph.hasNode(rel.source)) graph.addNode(rel.source);\n      if (!graph.hasNode(rel.target)) graph.addNode(rel.target);\n      if (!graph.hasEdge(rel.source, rel.target)) {\n        graph.addEdge(rel.source, rel.target, { type: rel.predicate });\n      }\n    }\n\n    // Create dependency tracker with the fully-populated graph\n    const tracker = new DependencyTracker(graph, model);\n\n    // Display header\n    console.log(\"\");\n    console.log(ansis.bold(`${ansis.blue(\"Dependency Trace:\")} ${ansis.yellow(elementId)}`));\n    console.log(ansis.dim(\"\u2500\".repeat(80)));\n\n    // Display dependents (elements that depend on this element - upward)\n    if (direction === \"up\" || direction === \"both\") {\n      const transitiveDependents = tracker.traceDependencies(elementId, TraceDirection.DOWN, null);\n      const directDependents = tracker.traceDependencies(elementId, TraceDirection.DOWN, 1);\n\n      if (isTelemetryEnabled && span) {\n        (span as any).setAttribute(\"trace.directDependents\", directDependents.length);\n        (span as any).setAttribute(\"trace.transitiveDependents\", transitiveDependents.length);\n      }\n\n      const transitiveOnlyDependents = transitiveDependents.filter(\n        (d: string) => !directDependents.includes(d)\n      );\n\n      console.log(\"\");\n      console.log(\n        ansis.cyan(\n          `Dependents (${directDependents.length} direct, ${transitiveOnlyDependents.length} transitive):`\n        )\n      );\n\n      if (directDependents.length === 0) {\n        console.log(ansis.dim(\"  (none)\"));\n      } else {\n        // Show direct dependents with indentation\n        console.log(ansis.gray(\"  Direct:\"));\n        for (const dep of directDependents.slice(0, 10)) {\n          console.log(`    ${ansis.yellow(\"\u2190\")} ${ansis.green(dep)}`);\n        }\n        if (directDependents.length > 10) {\n          console.log(ansis.dim(`    ... and ${directDependents.length - 10} more`));\n        }\n      }\n\n      if (transitiveOnlyDependents.length > 0) {\n        console.log(ansis.gray(\"  Transitive:\"));\n        for (const dep of transitiveOnlyDependents.slice(0, 10)) {\n          console.log(`    ${ansis.yellow(\"\u2196\")} ${ansis.dim(dep)}`);\n        }\n        if (transitiveOnlyDependents.length > 10) {\n          console.log(ansis.dim(`    ... and ${transitiveOnlyDependents.length - 10} more`));\n        }\n      }\n    }\n\n    // Display dependencies (elements this element depends on - downward)\n    if (direction === \"down\" || direction === \"both\") {\n      const transitiveDependencies = tracker.traceDependencies(elementId, TraceDirection.UP, null);\n      const directDependencies = tracker.traceDependencies(elementId, TraceDirection.UP, 1);\n\n      if (isTelemetryEnabled && span) {\n        (span as any).setAttribute(\"trace.directDependencies\", directDependencies.length);\n        (span as any).setAttribute(\"trace.transitiveDependencies\", transitiveDependencies.length);\n      }\n\n      const transitiveOnlyDependencies = transitiveDependencies.filter(\n        (d: string) => !directDependencies.includes(d)\n      );\n\n      console.log(\"\");\n      console.log(\n        ansis.cyan(\n          `Dependencies (${directDependencies.length} direct, ${transitiveOnlyDependencies.length} transitive):`\n        )\n      );\n\n      if (directDependencies.length === 0) {\n        console.log(ansis.dim(\"  (none)\"));\n      } else {\n        // Show direct dependencies with indentation\n        console.log(ansis.gray(\"  Direct:\"));\n        for (const dep of directDependencies.slice(0, 10)) {\n          console.log(`    ${ansis.yellow(\"\u2192\")} ${ansis.green(dep)}`);\n        }\n        if (directDependencies.length > 10) {\n          console.log(ansis.dim(`    ... and ${directDependencies.length - 10} more`));\n        }\n      }\n\n      if (transitiveOnlyDependencies.length > 0) {\n        console.log(ansis.gray(\"  Transitive:\"));\n        for (const dep of transitiveOnlyDependencies.slice(0, 10)) {\n          console.log(`    ${ansis.yellow(\"\u2198\")} ${ansis.dim(dep)}`);\n        }\n        if (transitiveOnlyDependencies.length > 10) {\n          console.log(ansis.dim(`    ... and ${transitiveOnlyDependencies.length - 10} more`));\n        }\n      }\n    }\n\n    console.log(\"\");\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setStatus({ code: 0 });\n    }\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({\n        code: 2,\n        message: getErrorMessage(error),\n      });\n    }\n    if (error instanceof CLIError) {\n      throw error;\n    }\n    const message = getErrorMessage(error);\n    throw new CLIError(message, 1);\n  } finally {\n    endSpan(span);\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/commands/update.js

@@ -1,32 +1,159 @@
 import ansis from "ansis";
 import { Model } from "../core/model.js";
+import { MutationHandler } from "../core/mutation-handler.js";
+import { StagingAreaManager } from "../core/staging-area.js";
+import { StagedChangesetStorage } from "../core/staged-changeset-storage.js";
 import { findElementLayer } from "../utils/element-utils.js";
+import { CLIError, handleError, findSimilar, formatValidOptions } from "../utils/errors.js";
+import { isValidNodeType, getNodeTypesForLayer, normalizeNodeType } from "../generated/node-types.js";
+import { Element } from "../core/element.js";
+import { Layer } from "../core/layer.js";
+import { SchemaValidator } from "../validators/schema-validator.js";
+import { validateSourceReferenceOptions, buildSourceReference } from "../utils/source-reference.js";
 import { startSpan, endSpan } from "../telemetry/index.js";
 const isTelemetryEnabled = !1;
+function validateUpdateSourceReferenceOptions(options) {
+  const hasSourceOptions = options.sourceFile || options.sourceSymbol || options.sourceProvenance || options.sourceRepoRemote || options.sourceRepoCommit;
+  if (options.clearSourceReference && hasSourceOptions)
+    throw new CLIError("Cannot use --clear-source-reference with other source reference options", 1, ["Specify either --clear-source-reference or other source options, not both"]);
+  hasSourceOptions && validateSourceReferenceOptions(options);
+}
 async function updateCommand(id, options) {
   const changedFields = [];
-  options.name && changedFields.push("name"), options.description && changedFields.push("description"), options.properties && changedFields.push("properties");
+  options.name && changedFields.push("name"), options.description && changedFields.push("description"), options.type && changedFields.push("type"), options.attributes && changedFields.push("attributes"), (options.sourceFile || options.clearSourceReference) && changedFields.push("sourceReference");
   const span = isTelemetryEnabled ? startSpan("element.update", {
     "element.id": id,
     "element.changed_fields": changedFields.join(",")
   }) : null;
   try {
+    validateUpdateSourceReferenceOptions(options);
     const model = await Model.load(), layerName = await findElementLayer(model, id);
-    layerName || (console.error(ansis.red(`Error: Element ${id} not found`)), process.exit(1));
-    const element = (await model.getLayer(layerName)).getElement(id), beforeState = element.toJSON();
-    let updated = !1;
-    if (options.name && (element.name = options.name, updated = !0), options.description !== void 0 && (element.description = options.description || void 0, updated = !0), options.properties)
-      try {
-        const newProperties = JSON.parse(options.properties);
-        element.properties = { ...element.properties, ...newProperties }, updated = !0;
-      } catch {
-        console.error(ansis.red("Error: Invalid JSON in --properties")), process.exit(1);
+    if (!layerName) {
+      const stagingManager = new StagingAreaManager(model.rootPath, model), storage = new StagedChangesetStorage(model.rootPath), activeId = await stagingManager.getActiveId();
+      if (activeId) {
+        const changeset = await storage.load(activeId);
+        if (changeset) {
+          const addChange = changeset.changes.find((c) => c.type === "add" && c.elementId === id);
+          if (addChange && addChange.after) {
+            if (!(options.name || options.description !== void 0 || options.attributes || options.sourceFile || options.clearSourceReference || options.type)) {
+              console.log(ansis.yellow("No fields specified for update"));
+              return;
+            }
+            const after = { ...addChange.after };
+            if (options.type) {
+              const stagedLayerName = addChange.layerName;
+              if (!isValidNodeType(stagedLayerName, options.type)) {
+                const typeNames = getNodeTypesForLayer(stagedLayerName).map((t) => t.type).sort(), similar = findSimilar(options.type, typeNames, 3), suggestions = [`Valid types for ${stagedLayerName}: ${formatValidOptions(typeNames)}`];
+                throw similar.length > 0 && suggestions.unshift(`Did you mean: ${similar.join(" or ")}?`), new CLIError(`Invalid element type "${options.type}" for layer "${stagedLayerName}"`, 1, suggestions);
+              }
+              const resolvedNewType = normalizeNodeType(stagedLayerName, options.type);
+              after.type = resolvedNewType, after.spec_node_id = `${stagedLayerName}.${resolvedNewType}`;
+            }
+            if (options.name && (after.name = options.name), options.description !== void 0 && (after.description = options.description || void 0), options.attributes)
+              try {
+                const parsed = JSON.parse(options.attributes);
+                after.attributes = parsed;
+              } catch {
+                throw new CLIError("Invalid JSON in --attributes", 1, [
+                  "Ensure your JSON is valid and properly formatted"
+                ]);
+              }
+            if (options.clearSourceReference)
+              delete after.source_reference;
+            else if (options.sourceFile) {
+              const newRef = buildSourceReference(options);
+              newRef && (after.source_reference = newRef);
+            }
+            if (options.type || options.attributes) {
+              const stagedLayerName = addChange.layerName, tempElem = Element.fromSpecNode({
+                id: String(after.id ?? addChange.elementId ?? "staged"),
+                path: String(after.path ?? addChange.elementId ?? ""),
+                spec_node_id: String(after.spec_node_id ?? ""),
+                type: String(after.type ?? ""),
+                layer_id: String(after.layer_id ?? stagedLayerName),
+                name: String(after.name ?? ""),
+                attributes: after.attributes || {}
+              }), schemaValidator = new SchemaValidator(), tempLayer = new Layer(stagedLayerName);
+              tempLayer.addElement(tempElem);
+              const attrValidation = await schemaValidator.validateLayer(tempLayer);
+              if (!attrValidation.isValid()) {
+                const errorMessages = attrValidation.errors.map((e) => `  ${e.message}`).join(`
+`);
+                throw new CLIError(`Updated attributes fail schema validation:
+${errorMessages}`, 1, [
+                  options.type ? `Incompatible attributes must be manually cleaned up before changing type. Run "dr schema ${stagedLayerName} ${after.type}" to see the required attributes` : `Run "dr schema ${stagedLayerName} ${after.type}" to see the required attributes`
+                ]);
+              }
+            }
+            await storage.updateChange(activeId, id, {
+              type: addChange.type,
+              elementId: addChange.elementId,
+              layerName: addChange.layerName,
+              before: addChange.before,
+              after
+            }), console.log(ansis.green(`\u2713 Updated staged element ${ansis.bold(id)}`));
+            return;
+          }
+        }
+      }
+      throw new CLIError(`Element ${id} not found`, 1);
+    }
+    const layer = await model.getLayer(layerName);
+    if (!layer)
+      throw new CLIError(`Layer ${layerName} not found`, 1);
+    const element = layer.getElement(id);
+    if (!element)
+      throw new CLIError(`Element ${id} not found`, 1);
+    if (!(options.name || options.description !== void 0 || options.type || options.attributes || options.sourceFile || options.clearSourceReference)) {
+      console.log(ansis.yellow("No fields specified for update"));
+      return;
+    }
+    await new MutationHandler(model, id, layerName).executeUpdate(element, async (elem, after) => {
+      let resolvedNewType;
+      if (options.type) {
+        if (!isValidNodeType(layerName, options.type)) {
+          const typeNames = getNodeTypesForLayer(layerName).map((t) => t.type).sort(), similar = findSimilar(options.type, typeNames, 3), suggestions = [`Valid types for ${layerName}: ${formatValidOptions(typeNames)}`];
+          throw similar.length > 0 && suggestions.unshift(`Did you mean: ${similar.join(" or ")}?`), new CLIError(`Invalid element type "${options.type}" for layer "${layerName}"`, 1, suggestions);
+        }
+        resolvedNewType = normalizeNodeType(layerName, options.type);
+      }
+      let parsedAttributes;
+      if (options.attributes)
+        try {
+          parsedAttributes = JSON.parse(options.attributes);
+        } catch {
+          throw new CLIError("Invalid JSON in --attributes", 1, [
+            "Ensure your JSON is valid and properly formatted"
+          ]);
+        }
+      if (resolvedNewType || parsedAttributes) {
+        const candidateType = resolvedNewType ?? elem.type, tempElem = new Element({
+          ...elem.toJSON(),
+          type: candidateType,
+          spec_node_id: `${layerName}.${candidateType}`,
+          attributes: parsedAttributes ?? elem.attributes
+        }), schemaValidator = new SchemaValidator(), tempLayer = new Layer(layerName);
+        tempLayer.addElement(tempElem);
+        const attrValidation = await schemaValidator.validateLayer(tempLayer);
+        if (!attrValidation.isValid()) {
+          const errorMessages = attrValidation.errors.map((e) => `  ${e.message}`).join(`
+`);
+          throw new CLIError(`Updated attributes fail schema validation:
+${errorMessages}`, 1, [
+            resolvedNewType ? `Incompatible attributes must be manually cleaned up before changing type. Run "dr schema ${layerName} ${candidateType}" to see the required attributes` : `Run "dr schema ${layerName} ${elem.type}" to see the required attributes`
+          ]);
+        }
+      }
+      if (resolvedNewType && (elem.type = resolvedNewType, after.type = resolvedNewType, elem.spec_node_id = `${layerName}.${resolvedNewType}`, after.spec_node_id = `${layerName}.${resolvedNewType}`), options.name && (elem.name = options.name, after.name = options.name), options.description !== void 0 && (elem.description = options.description || void 0, after.description = options.description || void 0), parsedAttributes && (elem.attributes = parsedAttributes, after.attributes = parsedAttributes), options.clearSourceReference)
+        elem.setSourceReference(void 0), after.sourceReference = void 0;
+      else if (options.sourceFile) {
+        const newRef = buildSourceReference(options);
+        newRef && (elem.setSourceReference(newRef), after.sourceReference = newRef);
       }
-    updated || (console.log(ansis.yellow("No fields specified for update")), process.exit(0)), await model.getActiveChangesetContext().trackChange("update", id, layerName, beforeState, element.toJSON()), await model.saveLayer(layerName), await model.saveManifest(), console.log(ansis.green(`\u2713 Updated element ${ansis.bold(id)}`)), options.verbose && (console.log(ansis.dim(`  Layer: ${layerName}`)), options.name && console.log(ansis.dim(`  Name: ${options.name}`)), options.description && console.log(ansis.dim(`  Description: ${options.description}`)));
+      layer.updateElement(elem);
+    }), console.log(ansis.green(`\u2713 Updated element ${ansis.bold(id)}`)), options.verbose && (console.log(ansis.dim(`  Layer: ${layerName}`)), options.type && console.log(ansis.dim(`  Type: ${options.type}`)), options.name && console.log(ansis.dim(`  Name: ${options.name}`)), options.description && console.log(ansis.dim(`  Description: ${options.description}`)), options.sourceFile && console.log(ansis.dim(`  Source: ${options.sourceFile}`)), options.clearSourceReference && console.log(ansis.dim("  Source: cleared")));
   } catch (error) {
-    isTelemetryEnabled && span && (span.recordException(error), span.setStatus({ code: 2, message: error.message }));
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(ansis.red(`Error: ${message}`)), process.exit(1);
+    isTelemetryEnabled && span && (span.recordException(error), span.setStatus({ code: 2, message: error.message })), handleError(error);
   } finally {
     isTelemetryEnabled && endSpan(span);
   }

package/dist/commands/update.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/update.ts"],
-  "sourcesContent": ["/**\n * Update an element\n */\n\nimport ansis from 'ansis';\nimport { Model } from '../core/model.js';\nimport { findElementLayer } from '../utils/element-utils.js';\nimport { startSpan, endSpan } from '../telemetry/index.js';\n\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== 'undefined' ? TELEMETRY_ENABLED : false;\n\nexport interface UpdateOptions {\n  name?: string;\n  description?: string;\n  properties?: string;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\nexport async function updateCommand(id: string, options: UpdateOptions): Promise<void> {\n  const changedFields: string[] = [];\n  if (options.name) changedFields.push('name');\n  if (options.description) changedFields.push('description');\n  if (options.properties) changedFields.push('properties');\n\n  const span = isTelemetryEnabled ? startSpan('element.update', {\n    'element.id': id,\n    'element.changed_fields': changedFields.join(','),\n  }) : null;\n\n  try {\n    // Load model\n    const model = await Model.load();\n\n    // Find element\n    const layerName = await findElementLayer(model, id);\n    if (!layerName) {\n      console.error(ansis.red(`Error: Element ${id} not found`));\n      process.exit(1);\n    }\n\n    const layer = (await model.getLayer(layerName))!;\n    const element = layer.getElement(id)!;\n\n    // Capture before state for changeset tracking\n    const beforeState = element.toJSON();\n\n    // Update fields\n    let updated = false;\n\n    if (options.name) {\n      element.name = options.name;\n      updated = true;\n    }\n\n    if (options.description !== undefined) {\n      element.description = options.description || undefined;\n      updated = true;\n    }\n\n    if (options.properties) {\n      try {\n        const newProperties = JSON.parse(options.properties);\n        element.properties = { ...element.properties, ...newProperties };\n        updated = true;\n      } catch (e) {\n        console.error(ansis.red('Error: Invalid JSON in --properties'));\n        process.exit(1);\n      }\n    }\n\n    if (!updated) {\n      console.log(ansis.yellow('No fields specified for update'));\n      process.exit(0);\n    }\n\n    // Track change in active changeset if present\n    const activeChangeset = model.getActiveChangesetContext();\n    await activeChangeset.trackChange(\n      'update',\n      id,\n      layerName,\n      beforeState as unknown as Record<string, unknown>,\n      element.toJSON() as unknown as Record<string, unknown>\n    );\n\n    // Save\n    await model.saveLayer(layerName);\n    await model.saveManifest();\n\n    console.log(ansis.green(`\u2713 Updated element ${ansis.bold(id)}`));\n    if (options.verbose) {\n      console.log(ansis.dim(`  Layer: ${layerName}`));\n      if (options.name) {\n        console.log(ansis.dim(`  Name: ${options.name}`));\n      }\n      if (options.description) {\n        console.log(ansis.dim(`  Description: ${options.description}`));\n      }\n    }\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({ code: 2, message: (error as Error).message });\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  } finally {\n    if (isTelemetryEnabled) {\n      endSpan(span);\n    }\n  }\n}\n"],
-  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,aAAa;AACtB,SAAS,wBAAwB;AACjC,SAAS,WAAW,eAAe;AAGnC,MAAM,qBAAgE;AAUtE,eAAsB,cAAc,IAAY,SAAsB;AACpE,QAAM,gBAA0B,CAAA;AAChC,EAAI,QAAQ,QAAM,cAAc,KAAK,MAAM,GACvC,QAAQ,eAAa,cAAc,KAAK,aAAa,GACrD,QAAQ,cAAY,cAAc,KAAK,YAAY;AAEvD,QAAM,OAAO,qBAAqB,UAAU,kBAAkB;IAC5D,cAAc;IACd,0BAA0B,cAAc,KAAK,GAAG;GACjD,IAAI;AAEL,MAAI;AAEF,UAAM,QAAQ,MAAM,MAAM,KAAI,GAGxB,YAAY,MAAM,iBAAiB,OAAO,EAAE;AAClD,IAAK,cACH,QAAQ,MAAM,MAAM,IAAI,kBAAkB,EAAE,YAAY,CAAC,GACzD,QAAQ,KAAK,CAAC;AAIhB,UAAM,WADS,MAAM,MAAM,SAAS,SAAS,GACvB,WAAW,EAAE,GAG7B,cAAc,QAAQ,OAAM;AAGlC,QAAI,UAAU;AAYd,QAVI,QAAQ,SACV,QAAQ,OAAO,QAAQ,MACvB,UAAU,KAGR,QAAQ,gBAAgB,WAC1B,QAAQ,cAAc,QAAQ,eAAe,QAC7C,UAAU,KAGR,QAAQ;AACV,UAAI;AACF,cAAM,gBAAgB,KAAK,MAAM,QAAQ,UAAU;AACnD,gBAAQ,aAAa,EAAE,GAAG,QAAQ,YAAY,GAAG,cAAa,GAC9D,UAAU;MACZ,QAAY;AACV,gBAAQ,MAAM,MAAM,IAAI,qCAAqC,CAAC,GAC9D,QAAQ,KAAK,CAAC;MAChB;AAGF,IAAK,YACH,QAAQ,IAAI,MAAM,OAAO,gCAAgC,CAAC,GAC1D,QAAQ,KAAK,CAAC,IAKhB,MADwB,MAAM,0BAAyB,EACjC,YACpB,UACA,IACA,WACA,aACA,QAAQ,OAAM,CAAwC,GAIxD,MAAM,MAAM,UAAU,SAAS,GAC/B,MAAM,MAAM,aAAY,GAExB,QAAQ,IAAI,MAAM,MAAM,0BAAqB,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC,GAC1D,QAAQ,YACV,QAAQ,IAAI,MAAM,IAAI,YAAY,SAAS,EAAE,CAAC,GAC1C,QAAQ,QACV,QAAQ,IAAI,MAAM,IAAI,WAAW,QAAQ,IAAI,EAAE,CAAC,GAE9C,QAAQ,eACV,QAAQ,IAAI,MAAM,IAAI,kBAAkB,QAAQ,WAAW,EAAE,CAAC;EAGpE,SAAS,OAAO;AACd,IAAI,sBAAsB,SACvB,KAAa,gBAAgB,KAAc,GAC3C,KAAa,UAAU,EAAE,MAAM,GAAG,SAAU,MAAgB,QAAO,CAAE;AAExE,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAQ,MAAM,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,GAC5C,QAAQ,KAAK,CAAC;EAChB;AACE,IAAI,sBACF,QAAQ,IAAI;EAEhB;AACF;",
+  "sourcesContent": ["/**\n * Update an element\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { MutationHandler } from \"../core/mutation-handler.js\";\nimport { StagingAreaManager } from \"../core/staging-area.js\";\nimport { StagedChangesetStorage } from \"../core/staged-changeset-storage.js\";\nimport { findElementLayer } from \"../utils/element-utils.js\";\nimport { CLIError, handleError, findSimilar, formatValidOptions } from \"../utils/errors.js\";\nimport { isValidNodeType, getNodeTypesForLayer, normalizeNodeType } from \"../generated/node-types.js\";\nimport { Element } from \"../core/element.js\";\nimport { Layer } from \"../core/layer.js\";\nimport { SchemaValidator } from \"../validators/schema-validator.js\";\nimport { validateSourceReferenceOptions, buildSourceReference } from \"../utils/source-reference.js\";\nimport { startSpan, endSpan } from \"../telemetry/index.js\";\n\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\nexport interface UpdateOptions {\n  name?: string;\n  description?: string;\n  type?: string;\n  attributes?: string;\n  sourceFile?: string;\n  sourceSymbol?: string;\n  sourceProvenance?: string;\n  sourceRepoRemote?: string;\n  sourceRepoCommit?: string;\n  clearSourceReference?: boolean;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\n/**\n * Validate update-specific source reference options\n */\nfunction validateUpdateSourceReferenceOptions(options: UpdateOptions): void {\n  const hasSourceOptions =\n    options.sourceFile ||\n    options.sourceSymbol ||\n    options.sourceProvenance ||\n    options.sourceRepoRemote ||\n    options.sourceRepoCommit;\n\n  if (options.clearSourceReference && hasSourceOptions) {\n    throw new CLIError(\n      \"Cannot use --clear-source-reference with other source reference options\",\n      1,\n      [\"Specify either --clear-source-reference or other source options, not both\"]\n    );\n  }\n\n  // Use shared validation for source reference options if any are provided\n  if (hasSourceOptions) {\n    validateSourceReferenceOptions(options);\n  }\n}\n\nexport async function updateCommand(id: string, options: UpdateOptions): Promise<void> {\n  const changedFields: string[] = [];\n  if (options.name) changedFields.push(\"name\");\n  if (options.description) changedFields.push(\"description\");\n  if (options.type) changedFields.push(\"type\");\n  if (options.attributes) changedFields.push(\"attributes\");\n  if (options.sourceFile || options.clearSourceReference) changedFields.push(\"sourceReference\");\n\n  const span = isTelemetryEnabled\n    ? startSpan(\"element.update\", {\n        \"element.id\": id,\n        \"element.changed_fields\": changedFields.join(\",\"),\n      })\n    : null;\n\n  try {\n    // Validate source reference options\n    validateUpdateSourceReferenceOptions(options);\n\n    // Load model\n    const model = await Model.load();\n\n    // Find element\n    const layerName = await findElementLayer(model, id);\n    if (!layerName) {\n      // Not in committed model \u2014 check active changeset for a staged ADD\n      const stagingManager = new StagingAreaManager(model.rootPath, model);\n      const storage = new StagedChangesetStorage(model.rootPath);\n      const activeId = await stagingManager.getActiveId();\n\n      if (activeId) {\n        const changeset = await storage.load(activeId);\n        if (changeset) {\n          const addChange = changeset.changes.find(\n            (c) => c.type === \"add\" && c.elementId === id\n          );\n          if (addChange && addChange.after) {\n            const hasUpdates =\n              options.name ||\n              options.description !== undefined ||\n              options.attributes ||\n              options.sourceFile ||\n              options.clearSourceReference ||\n              options.type;\n\n            if (!hasUpdates) {\n              console.log(ansis.yellow(\"No fields specified for update\"));\n              return;\n            }\n\n            const after: Record<string, unknown> = { ...addChange.after };\n\n            if (options.type) {\n              const stagedLayerName = addChange.layerName;\n              if (!isValidNodeType(stagedLayerName, options.type)) {\n                const validNodeTypes = getNodeTypesForLayer(stagedLayerName);\n                const typeNames = validNodeTypes.map((t) => t.type).sort();\n                const similar = findSimilar(options.type, typeNames, 3);\n                const suggestions: string[] = [`Valid types for ${stagedLayerName}: ${formatValidOptions(typeNames)}`];\n                if (similar.length > 0) suggestions.unshift(`Did you mean: ${similar.join(\" or \")}?`);\n                throw new CLIError(`Invalid element type \"${options.type}\" for layer \"${stagedLayerName}\"`, 1, suggestions);\n              }\n              const resolvedNewType = normalizeNodeType(stagedLayerName, options.type);\n              after.type = resolvedNewType;\n              after.spec_node_id = `${stagedLayerName}.${resolvedNewType}`;\n            }\n            if (options.name) after.name = options.name;\n            if (options.description !== undefined) {\n              after.description = options.description || undefined;\n            }\n            if (options.attributes) {\n              try {\n                const parsed = JSON.parse(options.attributes);\n                after.attributes = parsed;\n              } catch {\n                throw new CLIError(\"Invalid JSON in --attributes\", 1, [\n                  \"Ensure your JSON is valid and properly formatted\",\n                ]);\n              }\n            }\n            if (options.clearSourceReference) {\n              delete after.source_reference;\n            } else if (options.sourceFile) {\n              const newRef = buildSourceReference(options);\n              if (newRef) after.source_reference = newRef;\n            }\n\n            // Validate schema if type or attributes changed in staged element\n            if (options.type || options.attributes) {\n              const stagedLayerName = addChange.layerName;\n              const tempElem = Element.fromSpecNode({\n                id: String(after.id ?? addChange.elementId ?? \"staged\"),\n                path: String(after.path ?? addChange.elementId ?? \"\"),\n                spec_node_id: String(after.spec_node_id ?? \"\"),\n                type: String(after.type ?? \"\"),\n                layer_id: String(after.layer_id ?? stagedLayerName),\n                name: String(after.name ?? \"\"),\n                attributes: (after.attributes as Record<string, unknown>) || {},\n              });\n              const schemaValidator = new SchemaValidator();\n              const tempLayer = new Layer(stagedLayerName);\n              tempLayer.addElement(tempElem);\n              const attrValidation = await schemaValidator.validateLayer(tempLayer);\n              if (!attrValidation.isValid()) {\n                const errorMessages = attrValidation.errors\n                  .map((e) => `  ${e.message}`)\n                  .join(\"\\n\");\n                throw new CLIError(\n                  `Updated attributes fail schema validation:\\n${errorMessages}`,\n                  1,\n                  [\n                    options.type\n                      ? `Incompatible attributes must be manually cleaned up before changing type. Run \"dr schema ${stagedLayerName} ${after.type}\" to see the required attributes`\n                      : `Run \"dr schema ${stagedLayerName} ${after.type}\" to see the required attributes`,\n                  ]\n                );\n              }\n            }\n\n            await storage.updateChange(activeId, id, {\n              type: addChange.type,\n              elementId: addChange.elementId,\n              layerName: addChange.layerName,\n              before: addChange.before,\n              after,\n            });\n\n            console.log(ansis.green(`\u2713 Updated staged element ${ansis.bold(id)}`));\n            return;\n          }\n        }\n      }\n\n      throw new CLIError(`Element ${id} not found`, 1);\n    }\n\n    const layer = await model.getLayer(layerName);\n    if (!layer) {\n      throw new CLIError(`Layer ${layerName} not found`, 1);\n    }\n\n    const element = layer.getElement(id);\n    if (!element) {\n      throw new CLIError(`Element ${id} not found`, 1);\n    }\n\n    // Validate that at least one field is specified\n    const hasUpdates =\n      options.name ||\n      options.description !== undefined ||\n      options.type ||\n      options.attributes ||\n      options.sourceFile ||\n      options.clearSourceReference;\n\n    if (!hasUpdates) {\n      console.log(ansis.yellow(\"No fields specified for update\"));\n      return;\n    }\n\n    // Single unified mutation handler for update\n    const handler = new MutationHandler(model, id, layerName);\n\n    // Execute update through unified path (handles staging and base model consistently)\n    // The mutator function applies all updates in a single pass with validated JSON parsing\n    await handler.executeUpdate(element, async (elem, after) => {\n      // Resolve new type (validate name only \u2014 don't mutate live elem yet)\n      let resolvedNewType: string | undefined;\n      if (options.type) {\n        if (!isValidNodeType(layerName, options.type)) {\n          const validNodeTypes = getNodeTypesForLayer(layerName);\n          const typeNames = validNodeTypes.map((t) => t.type).sort();\n          const similar = findSimilar(options.type, typeNames, 3);\n          const suggestions: string[] = [`Valid types for ${layerName}: ${formatValidOptions(typeNames)}`];\n          if (similar.length > 0) suggestions.unshift(`Did you mean: ${similar.join(\" or \")}?`);\n          throw new CLIError(`Invalid element type \"${options.type}\" for layer \"${layerName}\"`, 1, suggestions);\n        }\n        resolvedNewType = normalizeNodeType(layerName, options.type);\n      }\n\n      // Parse attributes (don't mutate yet)\n      let parsedAttributes: Record<string, unknown> | undefined;\n      if (options.attributes) {\n        try {\n          parsedAttributes = JSON.parse(options.attributes) as Record<string, unknown>;\n        } catch (e) {\n          throw new CLIError(\"Invalid JSON in --attributes\", 1, [\n            \"Ensure your JSON is valid and properly formatted\",\n          ]);\n        }\n      }\n\n      // Validate against schema using a temp element BEFORE mutating the live elem\n      if (resolvedNewType || parsedAttributes) {\n        const candidateType = resolvedNewType ?? elem.type;\n        const tempElem = new Element({\n          ...elem.toJSON(),\n          type: candidateType,\n          spec_node_id: `${layerName}.${candidateType}`,\n          attributes: parsedAttributes ?? elem.attributes,\n        });\n        const schemaValidator = new SchemaValidator();\n        const tempLayer = new Layer(layerName);\n        tempLayer.addElement(tempElem);\n        const attrValidation = await schemaValidator.validateLayer(tempLayer);\n        if (!attrValidation.isValid()) {\n          const errorMessages = attrValidation.errors\n            .map((e) => `  ${e.message}`)\n            .join(\"\\n\");\n          throw new CLIError(\n            `Updated attributes fail schema validation:\\n${errorMessages}`,\n            1,\n            [\n              resolvedNewType\n                ? `Incompatible attributes must be manually cleaned up before changing type. Run \"dr schema ${layerName} ${candidateType}\" to see the required attributes`\n                : `Run \"dr schema ${layerName} ${elem.type}\" to see the required attributes`,\n            ]\n          );\n        }\n      }\n\n      // Validation passed \u2014 apply all mutations to live element\n      if (resolvedNewType) {\n        elem.type = resolvedNewType;\n        after.type = resolvedNewType;\n        elem.spec_node_id = `${layerName}.${resolvedNewType}`;\n        after.spec_node_id = `${layerName}.${resolvedNewType}`;\n      }\n\n      if (options.name) {\n        elem.name = options.name;\n        after.name = options.name;\n      }\n\n      if (options.description !== undefined) {\n        elem.description = options.description || undefined;\n        after.description = options.description || undefined;\n      }\n\n      if (parsedAttributes) {\n        elem.attributes = parsedAttributes;\n        after.attributes = parsedAttributes;\n      }\n\n      if (options.clearSourceReference) {\n        elem.setSourceReference(undefined);\n        after.sourceReference = undefined;\n      } else if (options.sourceFile) {\n        const newRef = buildSourceReference(options);\n        if (newRef) {\n          elem.setSourceReference(newRef);\n          after.sourceReference = newRef;\n        }\n      }\n\n      // Update element in layer graph to persist mutations\n      layer.updateElement(elem);\n    });\n\n    console.log(ansis.green(`\u2713 Updated element ${ansis.bold(id)}`));\n    if (options.verbose) {\n      console.log(ansis.dim(`  Layer: ${layerName}`));\n      if (options.type) {\n        console.log(ansis.dim(`  Type: ${options.type}`));\n      }\n      if (options.name) {\n        console.log(ansis.dim(`  Name: ${options.name}`));\n      }\n      if (options.description) {\n        console.log(ansis.dim(`  Description: ${options.description}`));\n      }\n      if (options.sourceFile) {\n        console.log(ansis.dim(`  Source: ${options.sourceFile}`));\n      }\n      if (options.clearSourceReference) {\n        console.log(ansis.dim(`  Source: cleared`));\n      }\n    }\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({ code: 2, message: (error as Error).message });\n    }\n    handleError(error);\n  } finally {\n    if (isTelemetryEnabled) {\n      endSpan(span);\n    }\n  }\n}\n"],
+  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,aAAa;AACtB,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,8BAA8B;AACvC,SAAS,wBAAwB;AACjC,SAAS,UAAU,aAAa,aAAa,0BAA0B;AACvE,SAAS,iBAAiB,sBAAsB,yBAAyB;AACzE,SAAS,eAAe;AACxB,SAAS,aAAa;AACtB,SAAS,uBAAuB;AAChC,SAAS,gCAAgC,4BAA4B;AACrE,SAAS,WAAW,eAAe;AAGnC,MAAM,qBAAgE;AAoBtE,SAAS,qCAAqC,SAAsB;AAClE,QAAM,mBACJ,QAAQ,cACR,QAAQ,gBACR,QAAQ,oBACR,QAAQ,oBACR,QAAQ;AAEV,MAAI,QAAQ,wBAAwB;AAClC,UAAM,IAAI,SACR,2EACA,GACA,CAAC,2EAA2E,CAAC;AAKjF,EAAI,oBACF,+BAA+B,OAAO;AAE1C;AAEA,eAAsB,cAAc,IAAY,SAAsB;AACpE,QAAM,gBAA0B,CAAA;AAChC,EAAI,QAAQ,QAAM,cAAc,KAAK,MAAM,GACvC,QAAQ,eAAa,cAAc,KAAK,aAAa,GACrD,QAAQ,QAAM,cAAc,KAAK,MAAM,GACvC,QAAQ,cAAY,cAAc,KAAK,YAAY,IACnD,QAAQ,cAAc,QAAQ,yBAAsB,cAAc,KAAK,iBAAiB;AAE5F,QAAM,OAAO,qBACT,UAAU,kBAAkB;IAC1B,cAAc;IACd,0BAA0B,cAAc,KAAK,GAAG;GACjD,IACD;AAEJ,MAAI;AAEF,yCAAqC,OAAO;AAG5C,UAAM,QAAQ,MAAM,MAAM,KAAI,GAGxB,YAAY,MAAM,iBAAiB,OAAO,EAAE;AAClD,QAAI,CAAC,WAAW;AAEd,YAAM,iBAAiB,IAAI,mBAAmB,MAAM,UAAU,KAAK,GAC7D,UAAU,IAAI,uBAAuB,MAAM,QAAQ,GACnD,WAAW,MAAM,eAAe,YAAW;AAEjD,UAAI,UAAU;AACZ,cAAM,YAAY,MAAM,QAAQ,KAAK,QAAQ;AAC7C,YAAI,WAAW;AACb,gBAAM,YAAY,UAAU,QAAQ,KAClC,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,cAAc,EAAE;AAE/C,cAAI,aAAa,UAAU,OAAO;AAShC,gBAAI,EAPF,QAAQ,QACR,QAAQ,gBAAgB,UACxB,QAAQ,cACR,QAAQ,cACR,QAAQ,wBACR,QAAQ,OAEO;AACf,sBAAQ,IAAI,MAAM,OAAO,gCAAgC,CAAC;AAC1D;YACF;AAEA,kBAAM,QAAiC,EAAE,GAAG,UAAU,MAAK;AAE3D,gBAAI,QAAQ,MAAM;AAChB,oBAAM,kBAAkB,UAAU;AAClC,kBAAI,CAAC,gBAAgB,iBAAiB,QAAQ,IAAI,GAAG;AAEnD,sBAAM,YADiB,qBAAqB,eAAe,EAC1B,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAI,GAClD,UAAU,YAAY,QAAQ,MAAM,WAAW,CAAC,GAChD,cAAwB,CAAC,mBAAmB,eAAe,KAAK,mBAAmB,SAAS,CAAC,EAAE;AACrG,sBAAI,QAAQ,SAAS,KAAG,YAAY,QAAQ,iBAAiB,QAAQ,KAAK,MAAM,CAAC,GAAG,GAC9E,IAAI,SAAS,yBAAyB,QAAQ,IAAI,gBAAgB,eAAe,KAAK,GAAG,WAAW;cAC5G;AACA,oBAAM,kBAAkB,kBAAkB,iBAAiB,QAAQ,IAAI;AACvE,oBAAM,OAAO,iBACb,MAAM,eAAe,GAAG,eAAe,IAAI,eAAe;YAC5D;AAKA,gBAJI,QAAQ,SAAM,MAAM,OAAO,QAAQ,OACnC,QAAQ,gBAAgB,WAC1B,MAAM,cAAc,QAAQ,eAAe,SAEzC,QAAQ;AACV,kBAAI;AACF,sBAAM,SAAS,KAAK,MAAM,QAAQ,UAAU;AAC5C,sBAAM,aAAa;cACrB,QAAQ;AACN,sBAAM,IAAI,SAAS,gCAAgC,GAAG;kBACpD;iBACD;cACH;AAEF,gBAAI,QAAQ;AACV,qBAAO,MAAM;qBACJ,QAAQ,YAAY;AAC7B,oBAAM,SAAS,qBAAqB,OAAO;AAC3C,cAAI,WAAQ,MAAM,mBAAmB;YACvC;AAGA,gBAAI,QAAQ,QAAQ,QAAQ,YAAY;AACtC,oBAAM,kBAAkB,UAAU,WAC5B,WAAW,QAAQ,aAAa;gBACpC,IAAI,OAAO,MAAM,MAAM,UAAU,aAAa,QAAQ;gBACtD,MAAM,OAAO,MAAM,QAAQ,UAAU,aAAa,EAAE;gBACpD,cAAc,OAAO,MAAM,gBAAgB,EAAE;gBAC7C,MAAM,OAAO,MAAM,QAAQ,EAAE;gBAC7B,UAAU,OAAO,MAAM,YAAY,eAAe;gBAClD,MAAM,OAAO,MAAM,QAAQ,EAAE;gBAC7B,YAAa,MAAM,cAA0C,CAAA;eAC9D,GACK,kBAAkB,IAAI,gBAAe,GACrC,YAAY,IAAI,MAAM,eAAe;AAC3C,wBAAU,WAAW,QAAQ;AAC7B,oBAAM,iBAAiB,MAAM,gBAAgB,cAAc,SAAS;AACpE,kBAAI,CAAC,eAAe,QAAO,GAAI;AAC7B,sBAAM,gBAAgB,eAAe,OAClC,IAAI,CAAC,MAAM,KAAK,EAAE,OAAO,EAAE,EAC3B,KAAK;CAAI;AACZ,sBAAM,IAAI,SACR;EAA+C,aAAa,IAC5D,GACA;kBACE,QAAQ,OACJ,4FAA4F,eAAe,IAAI,MAAM,IAAI,qCACzH,kBAAkB,eAAe,IAAI,MAAM,IAAI;iBACpD;cAEL;YACF;AAEA,kBAAM,QAAQ,aAAa,UAAU,IAAI;cACvC,MAAM,UAAU;cAChB,WAAW,UAAU;cACrB,WAAW,UAAU;cACrB,QAAQ,UAAU;cAClB;aACD,GAED,QAAQ,IAAI,MAAM,MAAM,iCAA4B,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC;AACrE;UACF;QACF;MACF;AAEA,YAAM,IAAI,SAAS,WAAW,EAAE,cAAc,CAAC;IACjD;AAEA,UAAM,QAAQ,MAAM,MAAM,SAAS,SAAS;AAC5C,QAAI,CAAC;AACH,YAAM,IAAI,SAAS,SAAS,SAAS,cAAc,CAAC;AAGtD,UAAM,UAAU,MAAM,WAAW,EAAE;AACnC,QAAI,CAAC;AACH,YAAM,IAAI,SAAS,WAAW,EAAE,cAAc,CAAC;AAYjD,QAAI,EAPF,QAAQ,QACR,QAAQ,gBAAgB,UACxB,QAAQ,QACR,QAAQ,cACR,QAAQ,cACR,QAAQ,uBAEO;AACf,cAAQ,IAAI,MAAM,OAAO,gCAAgC,CAAC;AAC1D;IACF;AAOA,UAJgB,IAAI,gBAAgB,OAAO,IAAI,SAAS,EAI1C,cAAc,SAAS,OAAO,MAAM,UAAS;AAEzD,UAAI;AACJ,UAAI,QAAQ,MAAM;AAChB,YAAI,CAAC,gBAAgB,WAAW,QAAQ,IAAI,GAAG;AAE7C,gBAAM,YADiB,qBAAqB,SAAS,EACpB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAI,GAClD,UAAU,YAAY,QAAQ,MAAM,WAAW,CAAC,GAChD,cAAwB,CAAC,mBAAmB,SAAS,KAAK,mBAAmB,SAAS,CAAC,EAAE;AAC/F,gBAAI,QAAQ,SAAS,KAAG,YAAY,QAAQ,iBAAiB,QAAQ,KAAK,MAAM,CAAC,GAAG,GAC9E,IAAI,SAAS,yBAAyB,QAAQ,IAAI,gBAAgB,SAAS,KAAK,GAAG,WAAW;QACtG;AACA,0BAAkB,kBAAkB,WAAW,QAAQ,IAAI;MAC7D;AAGA,UAAI;AACJ,UAAI,QAAQ;AACV,YAAI;AACF,6BAAmB,KAAK,MAAM,QAAQ,UAAU;QAClD,QAAY;AACV,gBAAM,IAAI,SAAS,gCAAgC,GAAG;YACpD;WACD;QACH;AAIF,UAAI,mBAAmB,kBAAkB;AACvC,cAAM,gBAAgB,mBAAmB,KAAK,MACxC,WAAW,IAAI,QAAQ;UAC3B,GAAG,KAAK,OAAM;UACd,MAAM;UACN,cAAc,GAAG,SAAS,IAAI,aAAa;UAC3C,YAAY,oBAAoB,KAAK;SACtC,GACK,kBAAkB,IAAI,gBAAe,GACrC,YAAY,IAAI,MAAM,SAAS;AACrC,kBAAU,WAAW,QAAQ;AAC7B,cAAM,iBAAiB,MAAM,gBAAgB,cAAc,SAAS;AACpE,YAAI,CAAC,eAAe,QAAO,GAAI;AAC7B,gBAAM,gBAAgB,eAAe,OAClC,IAAI,CAAC,MAAM,KAAK,EAAE,OAAO,EAAE,EAC3B,KAAK;CAAI;AACZ,gBAAM,IAAI,SACR;EAA+C,aAAa,IAC5D,GACA;YACE,kBACI,4FAA4F,SAAS,IAAI,aAAa,qCACtH,kBAAkB,SAAS,IAAI,KAAK,IAAI;WAC7C;QAEL;MACF;AAyBA,UAtBI,oBACF,KAAK,OAAO,iBACZ,MAAM,OAAO,iBACb,KAAK,eAAe,GAAG,SAAS,IAAI,eAAe,IACnD,MAAM,eAAe,GAAG,SAAS,IAAI,eAAe,KAGlD,QAAQ,SACV,KAAK,OAAO,QAAQ,MACpB,MAAM,OAAO,QAAQ,OAGnB,QAAQ,gBAAgB,WAC1B,KAAK,cAAc,QAAQ,eAAe,QAC1C,MAAM,cAAc,QAAQ,eAAe,SAGzC,qBACF,KAAK,aAAa,kBAClB,MAAM,aAAa,mBAGjB,QAAQ;AACV,aAAK,mBAAmB,MAAS,GACjC,MAAM,kBAAkB;eACf,QAAQ,YAAY;AAC7B,cAAM,SAAS,qBAAqB,OAAO;AAC3C,QAAI,WACF,KAAK,mBAAmB,MAAM,GAC9B,MAAM,kBAAkB;MAE5B;AAGA,YAAM,cAAc,IAAI;IAC1B,CAAC,GAED,QAAQ,IAAI,MAAM,MAAM,0BAAqB,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC,GAC1D,QAAQ,YACV,QAAQ,IAAI,MAAM,IAAI,YAAY,SAAS,EAAE,CAAC,GAC1C,QAAQ,QACV,QAAQ,IAAI,MAAM,IAAI,WAAW,QAAQ,IAAI,EAAE,CAAC,GAE9C,QAAQ,QACV,QAAQ,IAAI,MAAM,IAAI,WAAW,QAAQ,IAAI,EAAE,CAAC,GAE9C,QAAQ,eACV,QAAQ,IAAI,MAAM,IAAI,kBAAkB,QAAQ,WAAW,EAAE,CAAC,GAE5D,QAAQ,cACV,QAAQ,IAAI,MAAM,IAAI,aAAa,QAAQ,UAAU,EAAE,CAAC,GAEtD,QAAQ,wBACV,QAAQ,IAAI,MAAM,IAAI,mBAAmB,CAAC;EAGhD,SAAS,OAAO;AACd,IAAI,sBAAsB,SACvB,KAAa,gBAAgB,KAAc,GAC3C,KAAa,UAAU,EAAE,MAAM,GAAG,SAAU,MAAgB,QAAO,CAAE,IAExE,YAAY,KAAK;EACnB;AACE,IAAI,sBACF,QAAQ,IAAI;EAEhB;AACF;",
   "names": []
 }