@yahoo/uds-create-config 2.44.0 → 3.0.0

package/dist/migrations/2.0.0/v1-artifact.d.ts

@@ -0,0 +1,1559 @@
+import { CopyPlan } from "../../entities/system/copy-plan.js";
+import { Ref } from "../../framework/utils/refs.js";
+import { DerivedEntityClass } from "../../framework/defineDerivedEntity.js";
+import { SubEntityClass } from "../../framework/defineSubEntity.js";
+import { ComponentContractOf, PathOf } from "../../framework/registered.js";
+import { EntityClass } from "../../framework/defineEntity.js";
+import { ConfigInstance } from "../../framework/defineConfig.js";
+import { PinOptionsField } from "../../entities/system/LinkedSystem.js";
+import { BreakPlan, LinkPlan, SourceRowState, UnlinkPlan } from "../../entities/system/link-plan.js";
+import { Config } from "../../framework/Config.js";
+import { ComputedInput } from "../../framework/registry.js";
+import { DerivedColor, Gradient } from "../../entities/system/color.js";
+import { StyleValue } from "../../entities/system/style-bag.js";
+import { ComponentElementBody, ComponentReference, ComponentStyleBody } from "../../entities/system/Component.js";
+import { StylePropValue } from "../../entities/system/StyleProperty.js";
+import { OverrideCondition } from "../../entities/system/Token.js";
+import { DocumentRename } from "../../spec/rewrite-refs.js";
+import * as _$zod from "zod";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region src/migrations/2.0.0/v1-artifact.d.ts
+/**
+ * What the reader could not carry, by a fixed code so a caller can tell an intended drop from a loss.
+ * `loss` is the code's verdict: a hole never held anything, where an unrecognized marker did.
+ */
+declare const V1_DIAGNOSTIC_CODES: {
+  /** A prop the artifact stores as `null`: a declaration that named no marker. */readonly 'prop-hole-dropped': {
+    readonly loss: false;
+  }; /** A prop marker config-v2 has no type for. */
+  readonly 'prop-unrecognized': {
+    readonly loss: true;
+  }; /** A layer value that is neither a tag, a component ref, nor an inline component body. */
+  readonly 'layer-unrecognized': {
+    readonly loss: true;
+  }; /** A style bag addressed to a layer the component does not declare. */
+  readonly 'style-layer-undeclared': {
+    readonly loss: true;
+  }; /** A component that took content without declaring `children`; the slot is declared for it. */
+  readonly 'children-slot-inferred': {
+    readonly loss: false;
+  }; /** CSS whose syntax or ordered entries cannot be represented by a global style. */
+  readonly 'raw-css-unparsed': {
+    readonly loss: true;
+  };
+  /** A selector modifier v1 also guarded with a media query; a v2 modifier activates one way. The
+   *  guard only kept `:hover` off touch devices, which is accepted rather than carried. */
+  readonly 'modifier-media-dropped': {
+    readonly loss: false;
+  }; /** A component with layers and no `root`; the first layer is renamed, and the render must follow. */
+  readonly 'root-layer-renamed': {
+    readonly loss: true;
+  };
+  /** A ref the artifact spells to something it never declares; v1 emitted nothing, v2 refuses. A
+   *  loss when carried; a note under `dropUnresolved`, since what is removed painted nothing. */
+  readonly 'ref-unresolved': {
+    readonly loss: true;
+  };
+  /** A style bag key that is neither a style prop, a CSS property, nor a prop of the layer's
+   *  element. v1 wrote it as a declaration no browser parses, so it painted nothing. */
+  readonly 'style-key-unrecognized': {
+    readonly loss: false;
+  };
+};
+type V1DiagnosticCode = keyof typeof V1_DIAGNOSTIC_CODES;
+interface V1Diagnostic {
+  readonly code: V1DiagnosticCode;
+  /** Where in the artifact: `<Component>/<prop>`, `<Component>/<when>/<layer>`. */
+  readonly path: string;
+  readonly detail: string;
+  readonly loss: boolean;
+}
+interface LoadV1Options {
+  /** Receives each drop as it happens. The hydrate path passes none. */
+  readonly onDiagnostic?: (diagnostic: V1Diagnostic) => void;
+  /** Remove each `ref-unresolved` ref from the body holding it, so the rest builds. Still reported. */
+  readonly dropUnresolved?: boolean;
+}
+interface V1Artifact {
+  prefix?: string;
+  /** How the REPO builds the system. Kept verbatim apart from the prefix, which the artifact spells
+   *  at the top level and the config keeps in here. */
+  buildOptions?: {
+    componentsDir?: string;
+    registryDir?: string;
+    content?: string[];
+    cssScope?: string;
+    skipCssVariables?: boolean;
+  };
+  preflight?: boolean;
+  modes?: Record<string, Record<string, {
+    css?: string;
+    media?: string;
+  }>>;
+  modifiers?: Record<string, {
+    selector: unknown;
+    media?: string;
+  }>;
+  tokenGroups?: Record<string, {
+    label?: string;
+    description?: string;
+    tokens?: Record<string, Record<string, unknown>>;
+  }>;
+  tokens?: Record<string, Record<string, unknown>>;
+  styleProps?: Record<string, {
+    cssProperty: string | string[]; /** The class-name segment — not derivable from the prop's name (`position` emits none). */
+    classPrefix?: string;
+    values?: unknown[];
+    /** Old config records the accepted bracket-literal TYPE (`{ type: 'color' }`) or a bare
+     *  truthy marker; config-v2 keeps only whether they're allowed. */
+    arbitrary?: unknown;
+    responsive?: boolean;
+    metadata?: {
+      label?: string;
+    };
+    /** Old config's opacity sibling: an opacity prop existed ONLY as this field, never as a
+     *  registered style prop, so a component exposing `bgOpacity` pointed at nothing. config-v2
+     *  registers it as an entity that names what it modulates. */
+    opacityPair?: {
+      as?: string;
+      ref?: string;
+      values?: unknown;
+    };
+  }>;
+  compositeStyles?: Record<string, {
+    label?: string;
+    description?: string;
+    styles: Record<string, unknown>;
+  }>;
+  motion?: Record<string, Record<string, unknown>>;
+  components?: Record<string, Record<string, unknown>>;
+  componentGroups?: Record<string, {
+    label?: string;
+    description?: string;
+    icon?: string;
+  }>;
+  assetGroups?: Record<string, {
+    assetKind?: string;
+    label?: string;
+    version?: string;
+    sizes?: Record<string, number>;
+    variants?: string[];
+    component?: string;
+    members?: string[] | Record<string, {
+      fontFamily?: string;
+      /** One entry per font FILE. Field naming varies by source — an upload writes `url`,
+       *  the v3 declaration map writes `src`/`fontWeight`/`fontStyle`. */
+      declarations?: Array<{
+        url?: string;
+        src?: string;
+        format?: string;
+        weight?: number | string;
+        fontWeight?: number | string;
+        style?: string;
+        fontStyle?: string;
+        postscriptName?: string;
+      }>; /** A comma list or an array; config-v2 stores the list. */
+      fallback?: string | string[];
+      deprecated?: boolean;
+      isVariableFont?: boolean;
+    }>;
+  }>;
+  /** Selector → its declarations; a nested record is a nested rule (`@keyframes`). */
+  globalStyles?: Record<string, Record<string, unknown>>;
+  /** CSS the config shipped verbatim — font faces, `:root` variables, helper-built rules. */
+  rawCss?: string | string[];
+  /** Role (`frame`, `text`) → the components that insert tool offers. */
+  canvasRoles?: Record<string, Array<{
+    component: string;
+    default?: boolean;
+    defaultProps?: Record<string, unknown>;
+  }>>;
+}
+/**
+ * The components a v1 artifact marks as parts of another, as the renames that move each to its
+ * owner path.
+ *
+ * v1 recorded the edge twice, `subcomponentOf: 'Card'` on the part and `subcomponents: ['Header']`
+ * on the owner, and either spelling alone counts. config-v2 has no field for it: `Card/Header` is a
+ * part of `Card` by being named that way. A part of a part lands under the owner's own owner path.
+ *
+ * The list is what a canvas conversion hands to `rewriteSpecRefs`, so a node whose type still names
+ * the bare component follows it to the owner path. `convert` runs the same list as component renames.
+ */
+declare function v1ComponentRenames(studio: V1Artifact): DocumentRename[];
+/**
+ * Read a v1 build artifact as a config-v2 `System`.
+ *
+ * One shape in, and only one: the flat pre-cutover bag. A config-v2 artifact does not come through
+ * here — `Config.fromJSON` reads it directly, and it refuses this shape outright rather than
+ * hydrating an empty config from fields it cannot see.
+ */
+declare function loadV1Artifact(studio: V1Artifact, options?: LoadV1Options): ConfigInstance<{
+  settings: EntityClass<_$zod.ZodObject<{
+    system: _$zod.ZodOptional<_$zod.ZodObject<{
+      id: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strict>>;
+    build: _$zod.ZodOptional<_$zod.ZodObject<{
+      inputDir: _$zod.ZodOptional<_$zod.ZodString>;
+      outDir: _$zod.ZodOptional<_$zod.ZodString>;
+      registryDir: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strict>>;
+    css: _$zod.ZodOptional<_$zod.ZodObject<{
+      prefix: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+        classNames: _$zod.ZodString;
+        variables: _$zod.ZodString;
+      }, _$zod_v4_core0.$strict>]>>;
+      scope: _$zod.ZodOptional<_$zod.ZodString>;
+      preflight: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      safelist: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+    }, _$zod_v4_core0.$strict>>;
+    playground: _$zod.ZodOptional<_$zod.ZodObject<{
+      pagesDir: _$zod.ZodOptional<_$zod.ZodString>;
+      port: _$zod.ZodOptional<_$zod.ZodNumber>;
+    }, _$zod_v4_core0.$strict>>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "settings", Record<never, never>, Record<never, never>, true>;
+  tokens: EntityClass<_$zod.ZodObject<{
+    value: _$zod.ZodType<string | number | Ref | DerivedColor | Gradient, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | Ref | DerivedColor | Gradient, unknown>>;
+    type: _$zod.ZodOptional<_$zod.ZodString>;
+    overrides: _$zod.ZodOptional<SubEntityClass<_$zod.ZodObject<{
+      on: _$zod.ZodType<OverrideCondition, unknown, _$zod_v4_core0.$ZodTypeInternals<OverrideCondition, unknown>>;
+      value: _$zod.ZodType<string | number | Ref | DerivedColor | Gradient, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | Ref | DerivedColor | Gradient, unknown>>;
+    }, _$zod_v4_core0.$strip>>>;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+    cssPrefix: _$zod.ZodOptional<_$zod.ZodString>;
+  }, _$zod_v4_core0.$strip>, "token", {
+    readonly create: {
+      readonly description: `Create a token at \`<group>/<name>\` \u2014 \`data.value\` is the CSS value. The first path segment is its group, and a style property takes a whole group as one ref (\`${string}\`), so put the tokens one prop should offer in one group rather than listing values on the prop.`;
+    };
+  }, Record<never, never>, false>;
+  components: Omit<EntityClass<_$zod.ZodObject<{
+    layers: SubEntityClass<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodLazy<_$zod.ZodType<Ref, unknown, _$zod_v4_core0.$ZodTypeInternals<Ref, unknown>>>, EntityClass<_$zod.ZodObject<{
+      version: _$zod.ZodOptional<_$zod.ZodString>;
+      exports: _$zod.ZodOptional<SubEntityClass<_$zod.ZodObject<{}, _$zod_v4_core0.$strict>>>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "package", Record<never, never>, Record<never, never>, false>]>>;
+    props: _$zod.ZodOptional<SubEntityClass<_$zod.ZodNullable<_$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"slot">;
+      text: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      accepts: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>, _$zod.ZodArray<_$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>>]>>;
+      required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"variant">;
+      value: _$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodArray<_$zod.ZodString>, _$zod.ZodTransform<{
+        [k: string]: {};
+      }, string[]>>, _$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>, SubEntityClass<_$zod.ZodObject<{
+        label: _$zod.ZodOptional<_$zod.ZodString>;
+        description: _$zod.ZodOptional<_$zod.ZodString>;
+        deprecated: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      }, _$zod_v4_core0.$strict>>]>;
+      required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodPipe<_$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"forward">;
+      target: _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>]>;
+      into: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>]>>;
+      accepts: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>, _$zod.ZodArray<_$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>>]>>;
+      text: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+      type: "forward";
+      target: string | {
+        __ref: string;
+      };
+      into?: string | {
+        __ref: string;
+      } | undefined;
+      accepts?: {
+        __ref: string;
+      } | {
+        __ref: string;
+      }[] | undefined;
+      text?: boolean | undefined;
+      required?: boolean | undefined;
+    }, {
+      type: "forward";
+      target: string | {
+        __ref: string;
+      };
+      into?: string | {
+        __ref: string;
+      } | undefined;
+      accepts?: {
+        __ref: string;
+      } | {
+        __ref: string;
+      }[] | undefined;
+      text?: boolean | undefined;
+      required?: boolean | undefined;
+    }>>, _$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"styleProperty">;
+      value: _$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"composite">;
+      value: _$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"motion">;
+      value: _$zod.ZodDefault<_$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"string">;
+      value: _$zod.ZodOptional<_$zod.ZodString>;
+      required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"number">;
+      value: _$zod.ZodOptional<_$zod.ZodNumber>;
+      required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      type: _$zod.ZodLiteral<"boolean">;
+      value: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+    }, _$zod_v4_core0.$strict>], "type">>>>;
+    forwards: _$zod.ZodOptional<SubEntityClass<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodObject<{
+      __ref: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>>]>>>;
+    styles: _$zod.ZodOptional<SubEntityClass<_$zod.ZodType<ComponentStyleBody, unknown, _$zod_v4_core0.$ZodTypeInternals<ComponentStyleBody, unknown>>>>;
+    anatomy: _$zod.ZodOptional<SubEntityClass<_$zod.ZodType<ComponentElementBody, unknown, _$zod_v4_core0.$ZodTypeInternals<ComponentElementBody, unknown>>>>;
+    defaultProps: _$zod.ZodOptional<SubEntityClass<_$zod.ZodType<StyleValue, unknown, _$zod_v4_core0.$ZodTypeInternals<StyleValue, unknown>>>>;
+    previewProps: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    file: _$zod.ZodOptional<_$zod.ZodObject<{
+      __ref: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>>;
+    export: _$zod.ZodOptional<_$zod.ZodString>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+    icon: _$zod.ZodOptional<_$zod.ZodString>;
+  }, _$zod_v4_core0.$strip>, "component", {
+    readonly create: {
+      readonly data: _$zod.ZodObject<{
+        layers: SubEntityClass<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodLazy<_$zod.ZodType<Ref, unknown, _$zod_v4_core0.$ZodTypeInternals<Ref, unknown>>>, EntityClass<_$zod.ZodObject<{
+          version: _$zod.ZodOptional<_$zod.ZodString>;
+          exports: _$zod.ZodOptional<SubEntityClass<_$zod.ZodObject<{}, _$zod_v4_core0.$strict>>>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "package", Record<never, never>, Record<never, never>, false>]>>;
+        props: _$zod.ZodOptional<SubEntityClass<_$zod.ZodNullable<_$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"slot">;
+          text: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          accepts: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>, _$zod.ZodArray<_$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>>]>>;
+          required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"variant">;
+          value: _$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodArray<_$zod.ZodString>, _$zod.ZodTransform<{
+            [k: string]: {};
+          }, string[]>>, _$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>, SubEntityClass<_$zod.ZodObject<{
+            label: _$zod.ZodOptional<_$zod.ZodString>;
+            description: _$zod.ZodOptional<_$zod.ZodString>;
+            deprecated: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          }, _$zod_v4_core0.$strict>>]>;
+          required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodPipe<_$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"forward">;
+          target: _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>]>;
+          into: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>]>>;
+          accepts: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>, _$zod.ZodArray<_$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>>]>>;
+          text: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+          type: "forward";
+          target: string | {
+            __ref: string;
+          };
+          into?: string | {
+            __ref: string;
+          } | undefined;
+          accepts?: {
+            __ref: string;
+          } | {
+            __ref: string;
+          }[] | undefined;
+          text?: boolean | undefined;
+          required?: boolean | undefined;
+        }, {
+          type: "forward";
+          target: string | {
+            __ref: string;
+          };
+          into?: string | {
+            __ref: string;
+          } | undefined;
+          accepts?: {
+            __ref: string;
+          } | {
+            __ref: string;
+          }[] | undefined;
+          text?: boolean | undefined;
+          required?: boolean | undefined;
+        }>>, _$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"styleProperty">;
+          value: _$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"composite">;
+          value: _$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"motion">;
+          value: _$zod.ZodDefault<_$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"string">;
+          value: _$zod.ZodOptional<_$zod.ZodString>;
+          required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"number">;
+          value: _$zod.ZodOptional<_$zod.ZodNumber>;
+          required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+          type: _$zod.ZodLiteral<"boolean">;
+          value: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        }, _$zod_v4_core0.$strict>], "type">>>>;
+        forwards: _$zod.ZodOptional<SubEntityClass<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodObject<{
+          __ref: _$zod.ZodString;
+        }, _$zod_v4_core0.$strip>>]>>>;
+        styles: _$zod.ZodOptional<SubEntityClass<_$zod.ZodType<ComponentStyleBody, unknown, _$zod_v4_core0.$ZodTypeInternals<ComponentStyleBody, unknown>>>>;
+        anatomy: _$zod.ZodOptional<SubEntityClass<_$zod.ZodType<ComponentElementBody, unknown, _$zod_v4_core0.$ZodTypeInternals<ComponentElementBody, unknown>>>>;
+        defaultProps: _$zod.ZodOptional<SubEntityClass<_$zod.ZodType<StyleValue, unknown, _$zod_v4_core0.$ZodTypeInternals<StyleValue, unknown>>>>;
+        previewProps: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+        file: _$zod.ZodOptional<_$zod.ZodObject<{
+          __ref: _$zod.ZodString;
+        }, _$zod_v4_core0.$strip>>;
+        export: _$zod.ZodOptional<_$zod.ZodString>;
+      }, _$zod_v4_core0.$strict>;
+      readonly description: "Create a component at a new qualified `path`. When its complete body is known, include all layers, anatomy, props, defaults, and styles in this one operation. `data.layers` maps each stable layer name to the element it renders and must include `root` — a tag for a primitive (`{ \"layers\": { \"root\": \"div\" } }`), and for anything built on top, a ref to a primitive (`{ \"root\": { \"__ref\": \"component:Box\" }, \"label\": { \"__ref\": \"component:Text\" } }`), which is what lets the layer take that primitive's style props. A primitive exposes style props as `{ \"type\": \"styleProperty\", \"value\": { \"__ref\": \"style-property:bg\" } }` and declares `children: { \"type\": \"slot\", \"text\": true }` when it holds content — without the slot, nothing nested inside it renders. A composed component exposes a layer's props at its own top level through `forwards`, keyed by layer: `{ \"forwards\": { \"root\": \"*\" } }` passes every prop the root's element takes (so `<Button width=\"full\">` reaches the root's `width`), and a list of member refs (`[{ \"__ref\": \"component:Box#props/width\" }]`, each naming the component that declares the prop) passes only those. A prop a layer already exposes is forwarded, never redeclared in `props`; a `props` entry of `{ \"type\": \"forward\" }` is the reverse route, one of this component's props into a layer's. `anatomy` is the tree the build would read off a render: each node renders a layer (`{ \"__ref\": \"layer:<name>\" }`), an intrinsic tag, or `Slot` (`{ \"element\": \"Slot\", \"props\": { \"name\": \"children\" } }`, where a slot prop's content lands — but a declared slot fills `root` by default, so a primitive still declares its `children` slot prop yet needs no `Slot` node or `children` entry for it, and a `Slot` node is only for landing that content in a nested layer); `children` lists sibling node keys from the `root` node, never a prop name; `text` is a fixed string; `visible` is a condition on a prop (`{ \"$state\": \"<prop>\" }`, or with `eq`); content shown in a nested layer is a route, `children: { \"type\": \"forward\", \"target\": \"label/children\" }`. `$state` appears only in `visible` and in an `element` a prop chooses, never as a prop value. A glyph is a node of its own, `{ \"element\": { \"__ref\": \"icon:<library>/<Name>\" } }`, listed in the `children` of the layer node that holds it, never a prop value. Text a prop supplies to a text layer is never a node either: declare the prop `{ \"type\": \"forward\", \"target\": \"<layer>/children\" }` and the layer shows it; a `Slot` node goes only under a layer that takes nodes. A style rule is `\"styles\": { \"*\": { \"when\": null, \"layers\": { \"root\": { \"bg\": \"surface\" } } } }`, keyed by a name, with each layer's bag under `layers`. A composed component carries its own styles: give it an unconditional (`\"*\"`) rule that lays out and surfaces it through the system's style properties — spacing, alignment and gap on the container, a background and color where it has one — rather than leaning on the bare primitives, which paint flat. Style a layer only with the style props the primitive it renders exposes, set to the values those props accept: `component/get` on the primitive lists both, so read it and choose from that rather than reaching for a CSS name or value the system has no style property for. Set `previewProps` (or `defaultProps`) so the component previews with content; a root that takes children renders empty otherwise. A style rule's layer bag is keyed by style-prop name (`fontWeight`, `color`), never by CSS property name, and each value is one of that prop's values.";
+      readonly example: ({
+        config
+      }: {
+        config: Config;
+        kind: string;
+        path: string;
+      }) => {
+        path: string;
+        data: Record<string, unknown>;
+      };
+    };
+    readonly 'sub-create/anatomy': {
+      readonly description: "Add one anatomy node (`key` + `data`) to a component. In a batch, create child nodes before a parent whose `children` or `slots` names them; each referenced node must already exist when this operation runs.";
+    };
+    readonly 'sub-create/props': {
+      readonly description: "Declare a prop this component owns (`key` + `data`): a `variant`, a `slot`, a `styleProperty` or `composite` on a primitive, a `forward` routing this prop into a layer's (`{ \"type\": \"forward\", \"target\": \"<layer>/<prop>\" }`), or `null` to drop a forwarded prop from the surface. A prop one of its layers already exposes — `width` on a root that renders `Box` — is not declared here; `sub-create/forwards` exposes it at the top level.";
+    };
+    readonly 'sub-create/forwards': {
+      readonly description: "Expose a layer's props at this component's top level. `key` is one of the component's own layer names; `data` is `\"*\"` for every prop that layer's element takes, or a list of component prop member refs (`[{ \"__ref\": \"component:Box#props/width\" }]`) for a selection, each naming the component that declares the prop — `Button` forwarding `width` from a `Pressable` root names `Box`, where `Pressable` takes it from. This is how `<Button width=\"full\">` reaches the root's `width` with no `width` entry in `props`; a prop the layer already exposes is forwarded, never redeclared. Two entries may not offer the same prop, and removing one forwarded prop is a `null` tombstone under `props`.";
+      readonly example: ({
+        config
+      }: {
+        config: Config;
+        kind: string;
+        path: string;
+      }) => {
+        path: string;
+        key: string;
+        data: "*";
+      } | undefined;
+    };
+    readonly 'sub-upsert/forwards': {
+      readonly description: "Set what one layer forwards, added when absent and replaced whole when present. Expose a layer's props at this component's top level. `key` is one of the component's own layer names; `data` is `\"*\"` for every prop that layer's element takes, or a list of component prop member refs (`[{ \"__ref\": \"component:Box#props/width\" }]`) for a selection, each naming the component that declares the prop — `Button` forwarding `width` from a `Pressable` root names `Box`, where `Pressable` takes it from. This is how `<Button width=\"full\">` reaches the root's `width` with no `width` entry in `props`; a prop the layer already exposes is forwarded, never redeclared. Two entries may not offer the same prop, and removing one forwarded prop is a `null` tombstone under `props`.";
+    };
+    readonly 'sub-update/forwards': {
+      readonly description: "Replace what one layer forwards: the member is `'*'` or a list, so `data` is the whole new value. Expose a layer's props at this component's top level. `key` is one of the component's own layer names; `data` is `\"*\"` for every prop that layer's element takes, or a list of component prop member refs (`[{ \"__ref\": \"component:Box#props/width\" }]`) for a selection, each naming the component that declares the prop — `Button` forwarding `width` from a `Pressable` root names `Box`, where `Pressable` takes it from. This is how `<Button width=\"full\">` reaches the root's `width` with no `width` entry in `props`; a prop the layer already exposes is forwarded, never redeclared. Two entries may not offer the same prop, and removing one forwarded prop is a `null` tombstone under `props`.";
+    };
+    readonly 'element-insert': {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        key: _$zod.ZodOptional<_$zod.ZodString>;
+        data: _$zod.ZodPrefault<_$zod.ZodObject<{
+          element: _$zod.ZodDefault<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>]>>;
+          parent: _$zod.ZodOptional<_$zod.ZodString>;
+          index: _$zod.ZodOptional<_$zod.ZodNumber>;
+          props: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+          slotProp: _$zod.ZodOptional<_$zod.ZodString>;
+          visible: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodObject<{
+            not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+            eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+            neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+            gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+            gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+            lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+            lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+            $state: _$zod.ZodString;
+          }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+            $state: string;
+            not?: true | undefined;
+            eq?: unknown;
+            neq?: unknown;
+            gt?: number | undefined;
+            gte?: number | undefined;
+            lt?: number | undefined;
+            lte?: number | undefined;
+          }, {
+            $state: string;
+            not?: true | undefined;
+            eq?: unknown;
+            neq?: unknown;
+            gt?: number | undefined;
+            gte?: number | undefined;
+            lt?: number | undefined;
+            lte?: number | undefined;
+          }>>, _$zod.ZodObject<{
+            $or: _$zod.ZodArray<_$zod.ZodPipe<_$zod.ZodObject<{
+              not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+              eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              $state: _$zod.ZodString;
+            }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }, {
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }>>>;
+          }, _$zod_v4_core0.$strict>, _$zod.ZodArray<_$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodObject<{
+            not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+            eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+            neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+            gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+            gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+            lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+            lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+            $state: _$zod.ZodString;
+          }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+            $state: string;
+            not?: true | undefined;
+            eq?: unknown;
+            neq?: unknown;
+            gt?: number | undefined;
+            gte?: number | undefined;
+            lt?: number | undefined;
+            lte?: number | undefined;
+          }, {
+            $state: string;
+            not?: true | undefined;
+            eq?: unknown;
+            neq?: unknown;
+            gt?: number | undefined;
+            gte?: number | undefined;
+            lt?: number | undefined;
+            lte?: number | undefined;
+          }>>, _$zod.ZodObject<{
+            $or: _$zod.ZodArray<_$zod.ZodPipe<_$zod.ZodObject<{
+              not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+              eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              $state: _$zod.ZodString;
+            }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }, {
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }>>>;
+          }, _$zod_v4_core0.$strict>]>>, _$zod.ZodPipe<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean, _$zod.ZodObject<{
+            __ref: _$zod.ZodString;
+          }, _$zod_v4_core0.$strip>]>>, _$zod.ZodTransform<{
+            $state: string;
+            eq?: unknown;
+          } | {
+            $state: string;
+            eq?: unknown;
+          }[], Record<string, string | number | boolean | {
+            __ref: string;
+          }>>>]>>;
+          text: _$zod.ZodOptional<_$zod.ZodString>;
+          children: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+          slots: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodArray<_$zod.ZodString>>>;
+          nodes: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodObject<{
+            element: _$zod.ZodDefault<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+              __ref: _$zod.ZodString;
+            }, _$zod_v4_core0.$strip>]>>;
+            props: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+            children: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            slots: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodArray<_$zod.ZodString>>>;
+            visible: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodObject<{
+              not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+              eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              $state: _$zod.ZodString;
+            }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }, {
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }>>, _$zod.ZodObject<{
+              $or: _$zod.ZodArray<_$zod.ZodPipe<_$zod.ZodObject<{
+                not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+                eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                $state: _$zod.ZodString;
+              }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }, {
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }>>>;
+            }, _$zod_v4_core0.$strict>, _$zod.ZodArray<_$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodObject<{
+              not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+              eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+              gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+              lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+              $state: _$zod.ZodString;
+            }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }, {
+              $state: string;
+              not?: true | undefined;
+              eq?: unknown;
+              neq?: unknown;
+              gt?: number | undefined;
+              gte?: number | undefined;
+              lt?: number | undefined;
+              lte?: number | undefined;
+            }>>, _$zod.ZodObject<{
+              $or: _$zod.ZodArray<_$zod.ZodPipe<_$zod.ZodObject<{
+                not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+                eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                $state: _$zod.ZodString;
+              }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }, {
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }>>>;
+            }, _$zod_v4_core0.$strict>]>>, _$zod.ZodPipe<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean, _$zod.ZodObject<{
+              __ref: _$zod.ZodString;
+            }, _$zod_v4_core0.$strip>]>>, _$zod.ZodTransform<{
+              $state: string;
+              eq?: unknown;
+            } | {
+              $state: string;
+              eq?: unknown;
+            }[], Record<string, string | number | boolean | {
+              __ref: string;
+            }>>>]>>;
+            text: _$zod.ZodOptional<_$zod.ZodString>;
+          }, _$zod_v4_core0.$strict>>>;
+          subtree: _$zod.ZodOptional<_$zod.ZodObject<{
+            root: _$zod.ZodString;
+            elements: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodObject<{
+              element: _$zod.ZodDefault<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+                __ref: _$zod.ZodString;
+              }, _$zod_v4_core0.$strip>]>>;
+              props: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+              children: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+              slots: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodArray<_$zod.ZodString>>>;
+              visible: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodObject<{
+                not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+                eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                $state: _$zod.ZodString;
+              }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }, {
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }>>, _$zod.ZodObject<{
+                $or: _$zod.ZodArray<_$zod.ZodPipe<_$zod.ZodObject<{
+                  not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+                  eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                  neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                  gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  $state: _$zod.ZodString;
+                }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+                  $state: string;
+                  not?: true | undefined;
+                  eq?: unknown;
+                  neq?: unknown;
+                  gt?: number | undefined;
+                  gte?: number | undefined;
+                  lt?: number | undefined;
+                  lte?: number | undefined;
+                }, {
+                  $state: string;
+                  not?: true | undefined;
+                  eq?: unknown;
+                  neq?: unknown;
+                  gt?: number | undefined;
+                  gte?: number | undefined;
+                  lt?: number | undefined;
+                  lte?: number | undefined;
+                }>>>;
+              }, _$zod_v4_core0.$strict>, _$zod.ZodArray<_$zod.ZodUnion<readonly [_$zod.ZodPipe<_$zod.ZodObject<{
+                not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+                eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                $state: _$zod.ZodString;
+              }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }, {
+                $state: string;
+                not?: true | undefined;
+                eq?: unknown;
+                neq?: unknown;
+                gt?: number | undefined;
+                gte?: number | undefined;
+                lt?: number | undefined;
+                lte?: number | undefined;
+              }>>, _$zod.ZodObject<{
+                $or: _$zod.ZodArray<_$zod.ZodPipe<_$zod.ZodObject<{
+                  not: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
+                  eq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                  neq: _$zod.ZodOptional<_$zod.ZodUnknown>;
+                  gt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  gte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  lt: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  lte: _$zod.ZodOptional<_$zod.ZodNumber>;
+                  $state: _$zod.ZodString;
+                }, _$zod_v4_core0.$strict>, _$zod.ZodTransform<{
+                  $state: string;
+                  not?: true | undefined;
+                  eq?: unknown;
+                  neq?: unknown;
+                  gt?: number | undefined;
+                  gte?: number | undefined;
+                  lt?: number | undefined;
+                  lte?: number | undefined;
+                }, {
+                  $state: string;
+                  not?: true | undefined;
+                  eq?: unknown;
+                  neq?: unknown;
+                  gt?: number | undefined;
+                  gte?: number | undefined;
+                  lt?: number | undefined;
+                  lte?: number | undefined;
+                }>>>;
+              }, _$zod_v4_core0.$strict>]>>, _$zod.ZodPipe<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean, _$zod.ZodObject<{
+                __ref: _$zod.ZodString;
+              }, _$zod_v4_core0.$strip>]>>, _$zod.ZodTransform<{
+                $state: string;
+                eq?: unknown;
+              } | {
+                $state: string;
+                eq?: unknown;
+              }[], Record<string, string | number | boolean | {
+                __ref: string;
+              }>>>]>>;
+              text: _$zod.ZodOptional<_$zod.ZodString>;
+            }, _$zod_v4_core0.$strict>>;
+          }, _$zod_v4_core0.$strip>>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: false;
+      readonly label: "Add element";
+      readonly description: "Add an element to a component: creates the LAYER it is styled through and the anatomy node that places it, under `parent`.";
+      readonly scope: "item";
+      readonly creates: true;
+      readonly title: (entity: string) => string;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Config;
+    };
+    readonly 'element-delete': {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        key: _$zod.ZodString;
+        data: _$zod.ZodOptional<_$zod.ZodObject<{
+          subtree: _$zod.ZodDefault<_$zod.ZodBoolean>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: false;
+      readonly label: "Remove element";
+      readonly description: "Remove an element from a component: its anatomy node, the layer it is styled through, its subtree, every parent edge naming it, and its entry in every style rule.";
+      readonly scope: "item";
+      readonly approval: "destructive";
+      readonly title: (entity: string) => string;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Config;
+    };
+    readonly 'element-move': {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        key: _$zod.ZodString;
+        data: _$zod.ZodPrefault<_$zod.ZodObject<{
+          parent: _$zod.ZodDefault<_$zod.ZodString>;
+          index: _$zod.ZodOptional<_$zod.ZodNumber>;
+          slotProp: _$zod.ZodOptional<_$zod.ZodString>;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: false;
+      readonly label: "Move element";
+      readonly description: "Move a component's anatomy node under a different parent, to a different position under the same one, or — with `slotProp` — into a parent's slot.";
+      readonly scope: "item";
+      readonly approval: "reference-change";
+      readonly title: (entity: string) => string;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Config;
+    };
+    readonly validate: {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        data: _$zod.ZodObject<{
+          props: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>;
+        }, _$zod_v4_core0.$strip>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: true;
+      readonly label: "Validate props";
+      readonly description: "Check a bag of prop VALUES against a component — rejects unknown props and out-of-domain values.";
+      readonly scope: "item";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        kind: string;
+        path: string;
+      }) => {
+        path: string;
+        data: {
+          props: Record<string, unknown>;
+        };
+      };
+      readonly handler: (input: Record<string, unknown>, config: Config) => string[];
+    };
+  }, {
+    readonly slots: ({
+      config,
+      path,
+      member
+    }: ComputedInput) => string[];
+  }, false>, "ref"> & {
+    ref<const Path extends PathOf<"component">>(path: Path): ComponentReference<ComponentContractOf<Path>>;
+  };
+  modifiers: EntityClass<_$zod.ZodObject<{
+    type: _$zod.ZodEnum<{
+      composite: "composite";
+      selector: "selector";
+      "media-query": "media-query";
+    }>;
+    value: _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodLazy<EntityClass<_$zod.ZodObject<{
+      styles: SubEntityClass<_$zod.ZodType<StyleValue, unknown, _$zod_v4_core0.$ZodTypeInternals<StyleValue, unknown>>>;
+    }, _$zod_v4_core0.$strip>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "composite", Record<never, never>, Record<never, never>, false>>]>;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+    type: _$zod.ZodOptional<_$zod.ZodEnum<{
+      mode: "mode";
+      state: "state";
+    }>>;
+    default: _$zod.ZodOptional<_$zod.ZodObject<{
+      __ref: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>>;
+  }, _$zod_v4_core0.$strip>, "modifier", Record<never, never>, Record<never, never>, false>;
+  styleProps: EntityClass<_$zod.ZodObject<{
+    properties: _$zod.ZodArray<_$zod.ZodString>;
+    values: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodType<StylePropValue, unknown, _$zod_v4_core0.$ZodTypeInternals<StylePropValue, unknown>>>>;
+    responsive: _$zod.ZodDefault<_$zod.ZodBoolean>;
+    classPrefix: _$zod.ZodOptional<_$zod.ZodString>;
+    arbitrary: _$zod.ZodDefault<_$zod.ZodBoolean>;
+    negates: _$zod.ZodDefault<_$zod.ZodBoolean>;
+    opacityOf: _$zod.ZodOptional<_$zod.ZodLazy<_$zod.ZodType<Ref, unknown, _$zod_v4_core0.$ZodTypeInternals<Ref, unknown>>>>;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "style-property", {
+    readonly rename: {
+      readonly to: _$zod.ZodString;
+    };
+    readonly create: {
+      readonly path: _$zod.ZodString;
+      readonly description: `Create a style property \u2014 the prop a component exposes for one CSS effect. \`path\` is the prop's JSX name, camelCase (\`borderRadius\`), never a CSS name; the CSS goes in \`properties\`. \`values\` is a ref to a token GROUP (\`${string}\`), which offers every token in it and keeps the prop in step with modes and edits; \`{ "alias": "brand", "value": ${string} }\` offers one token under a name of the prop's own; a literal (\`"row"\`, \`{ "alias": "full", "value": "9999px" }\`) is for a keyword the system has no token for. Restating a token's value as a literal instead of referencing it is refused.`;
+      readonly example: ({
+        config
+      }: {
+        config: Config;
+        kind: string;
+        path: string;
+      }) => {
+        path: string;
+        data: Record<string, unknown>;
+      } | undefined;
+    };
+  }, Record<never, never>, false>;
+  composites: EntityClass<_$zod.ZodObject<{
+    styles: SubEntityClass<_$zod.ZodType<StyleValue, unknown, _$zod_v4_core0.$ZodTypeInternals<StyleValue, unknown>>>;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "composite", Record<never, never>, Record<never, never>, false>;
+  motion: EntityClass<_$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+    runtime: _$zod.ZodLiteral<"css">;
+    keyframes: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    duration: _$zod.ZodOptional<_$zod.ZodString>;
+    delay: _$zod.ZodOptional<_$zod.ZodString>;
+    timingFunction: _$zod.ZodOptional<_$zod.ZodString>;
+    iterationCount: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber]>>;
+    direction: _$zod.ZodOptional<_$zod.ZodString>;
+    fillMode: _$zod.ZodOptional<_$zod.ZodString>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+    runtime: _$zod.ZodLiteral<"js">;
+    initial: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    animate: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    transition: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    whileHover: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    whileTap: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    whileFocus: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    whileDrag: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    drag: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodBoolean, _$zod.ZodString]>>;
+    dragConstraints: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodNumber>>;
+    dragElastic: _$zod.ZodOptional<_$zod.ZodNumber>;
+  }, _$zod_v4_core0.$strict>], "runtime">, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "motion", Record<never, never>, Record<never, never>, false>;
+  fonts: EntityClass<_$zod.ZodObject<{
+    fontFamily: _$zod.ZodString;
+    files: _$zod.ZodOptional<SubEntityClass<_$zod.ZodObject<{
+      src: _$zod.ZodString;
+      format: _$zod.ZodOptional<_$zod.ZodString>;
+      weight: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodNumber, _$zod.ZodString]>>;
+      style: _$zod.ZodOptional<_$zod.ZodString>;
+      postscriptName: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>>>;
+    fallbackStack: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+    isVariableFont: _$zod.ZodOptional<_$zod.ZodBoolean>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+    version: _$zod.ZodOptional<_$zod.ZodString>;
+  }, _$zod_v4_core0.$strict>, "font", Record<never, never>, Record<never, never>, false>;
+  icons: EntityClass<_$zod.ZodObject<{
+    categories: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+    tags: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+    codepoint: _$zod.ZodOptional<_$zod.ZodNumber>;
+    knockoutVariants: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+    module: _$zod.ZodOptional<_$zod.ZodString>;
+    version: _$zod.ZodOptional<_$zod.ZodString>;
+    metadata: _$zod.ZodOptional<_$zod.ZodObject<{
+      from: EntityClass<_$zod.ZodObject<{
+        version: _$zod.ZodOptional<_$zod.ZodString>;
+        exports: _$zod.ZodOptional<SubEntityClass<_$zod.ZodObject<{}, _$zod_v4_core0.$strict>>>;
+      }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "package", Record<never, never>, Record<never, never>, false>;
+      format: _$zod.ZodEnum<{
+        uds: "uds";
+        phosphor: "phosphor";
+      }>;
+    }, _$zod_v4_core0.$strict>>;
+    sizes: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodNumber>>;
+    variants: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+    component: _$zod.ZodOptional<_$zod.ZodObject<{
+      __ref: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>>;
+  }, _$zod_v4_core0.$strict>, "icon", Record<never, never>, Record<never, never>, false>;
+  packages: EntityClass<_$zod.ZodObject<{
+    version: _$zod.ZodOptional<_$zod.ZodString>;
+    exports: _$zod.ZodOptional<SubEntityClass<_$zod.ZodObject<{}, _$zod_v4_core0.$strict>>>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "package", Record<never, never>, Record<never, never>, false>;
+  files: EntityClass<_$zod.ZodObject<{
+    hash: _$zod.ZodString;
+    imports: _$zod.ZodOptional<SubEntityClass<_$zod.ZodObject<{
+      target: _$zod.ZodType<Ref, unknown, _$zod_v4_core0.$ZodTypeInternals<Ref, unknown>>;
+      names: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+    }, _$zod_v4_core0.$strip>>>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "file", Record<never, never>, {
+    readonly binary: ({
+      path
+    }: ComputedInput) => boolean;
+  }, false>;
+  guidance: EntityClass<_$zod.ZodObject<{
+    text: _$zod.ZodArray<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+      __ref: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>]>>;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+    label: _$zod.ZodOptional<_$zod.ZodString>;
+    description: _$zod.ZodOptional<_$zod.ZodString>;
+    appliesTo: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodEnum<{
+      chat: "chat";
+      huddle: "huddle";
+      "paint-style": "paint-style";
+      "figma-import": "figma-import";
+    }>>>;
+  }, _$zod_v4_core0.$strict>, "guidance", Record<never, never>, Record<never, never>, false>;
+  guidanceStyles: EntityClass<_$zod.ZodObject<{
+    text: _$zod.ZodString;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "guidance-style", Record<never, never>, Record<never, never>, false>;
+  canvasRoles: EntityClass<_$zod.ZodObject<{
+    entries: _$zod.ZodArray<_$zod.ZodObject<{
+      component: _$zod.ZodObject<{
+        __ref: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>;
+      default: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      defaultProps: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    }, _$zod_v4_core0.$strip>>;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "canvas-role", {
+    readonly create: {
+      readonly description: `Register a canvas insert tool for this system. \`path\` is the role, one of ${string}; \`data.entries\` names the components that tool inserts, one marked \`default\`. A system whose roles are unregistered has those canvas tools disabled, so register \`frame\` and \`text\` once a layout primitive and a text primitive exist.`;
+    };
+  }, Record<never, never>, false>;
+  globalStyles: EntityClass<_$zod.ZodObject<{
+    selector: _$zod.ZodString;
+    declarations: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodType<string | number | {
+      __ref: string;
+    } | {
+      [key: string]: string | number | {
+        __ref: string;
+      } | /*elided*/any;
+    }, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | {
+      __ref: string;
+    } | {
+      [key: string]: string | number | {
+        __ref: string;
+      } | /*elided*/any;
+    }, unknown>>>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "global-style", Record<never, never>, Record<never, never>, false>;
+  devices: EntityClass<_$zod.ZodObject<{
+    width: _$zod.ZodNumber;
+    height: _$zod.ZodNumber;
+    name: _$zod.ZodOptional<_$zod.ZodString>;
+  }, _$zod_v4_core0.$strip>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "device", Record<never, never>, Record<never, never>, false>;
+  linkedSystems: EntityClass<_$zod.ZodObject<{
+    configPath: _$zod.ZodOptional<_$zod.ZodString>;
+    link: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>>;
+    options: PinOptionsField;
+    package: _$zod.ZodOptional<_$zod.ZodString>;
+    systemId: _$zod.ZodOptional<_$zod.ZodString>;
+    name: _$zod.ZodOptional<_$zod.ZodString>;
+    version: _$zod.ZodOptional<_$zod.ZodString>;
+  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "linked-system", {
+    readonly link: {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        data: _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: false;
+      readonly label: "Link from";
+      readonly description: "Draw entities from a linked system, following the source: `data` names them by accessor — `{ tokens: ['color/brand', 'color'] }` takes an entity and a folder's members, `{ tokens: '*' }` every token, and `'*'` the whole system. What this config already holds at those paths is replaced by theirs, so run `linked-system/link-plan` with the same input first to see what that is. To hold their values as your own instead, `copy`.";
+      readonly scope: "item";
+      readonly approval: "reference-change";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Config;
+    };
+    readonly 'link-plan': {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        data: _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: true;
+      readonly label: "Plan a link";
+      readonly description: "What `link` with the same input replaces — rows of yours deleted so the source shows through, rows held through another pin turned into extensions, and members left alone because they are already here from the same origin. Writes nothing.";
+      readonly scope: "item";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Omit<LinkPlan, "patches">;
+    };
+    readonly unlink: {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        data: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: false;
+      readonly label: "Unlink from";
+      readonly description: "Stop following a linked system's entities, in `link`'s shape or everything when `data` is omitted. The rows the declaration minted go with it, and so do the linked rows that point at them, since left linked they would bring them back; nothing of yours moves. A row of yours pointing at one of theirs refuses this — `copy` what is used first, or `break` with `keep: true`. `unlink-plan` names everything that goes.";
+      readonly scope: "item";
+      readonly approval: "reference-change";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Config;
+    };
+    readonly 'unlink-plan': {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        data: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: true;
+      readonly label: "Plan an unlink";
+      readonly description: "What `unlink` with the same input removes — the minted rows the narrower declaration no longer reaches, with the linked rows taken along because they point at them named in `cascade` — and why the config would refuse it. Writes nothing.";
+      readonly scope: "item";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Omit<UnlinkPlan, "patches">;
+    };
+    readonly break: {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        keep: _$zod.ZodBoolean;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: false;
+      readonly label: "Break link";
+      readonly description: "Remove a linked system. With `keep: true` every value drawn through it is copied in as your own first, and a row of yours that pointed through the pin points at the copies; with `keep: false` the rows it minted go, and a row of yours still pointing through it refuses the break. Run `linked-system/break-plan` first to see every row it reaches.";
+      readonly scope: "item";
+      readonly approval: "destructive";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Config;
+    };
+    readonly 'break-plan': {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        keep: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        data: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: true;
+      readonly label: "Plan a break";
+      readonly description: "Every row a break reaches, and why the config would refuse it. `keep` plans `break` with the same input; `data` in `copy`'s shape plans detaching those entities alone — the rows the copy lands, the rows of yours it points at the copies, and the rows still linked that reference what moves. Writes nothing.";
+      readonly scope: "item";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Omit<BreakPlan, "patches">;
+    };
+    readonly rows: {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: true;
+      readonly label: "Source rows";
+      readonly description: "Every top-level folder and item the linked system offers, read against this config: whether every member is linked through this pin, how many rows of yours a `link` would replace, and how many members are already here from the source's own origin. Needs the source attached; empty otherwise.";
+      readonly scope: "item";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => SourceRowState[];
+    };
+    readonly copy: {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        data: _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>;
+        onConflict: _$zod.ZodOptional<_$zod.ZodEnum<{
+          replace: "replace";
+          skip: "skip";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: false;
+      readonly label: "Copy from";
+      readonly description: "Take entities from a linked system as your own, holding the values the source has now and no longer following it. `data` names them by accessor: `{ tokens: ['color/brand', 'color'] }` takes an entity and a folder's members, `{ tokens: '*' }` every token, and `'*'` the whole system. What a copied entity points at comes with it, so run `linked-system/copy-plan` with the same input first and see everything that lands. To use theirs without owning it, declare it in the pin's `link` instead. A whole-system copy is thousands of rows, and on a repo-backed system each one is written into `uds.config.ts`.";
+      readonly scope: "item";
+      readonly approval: "reference-change";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Config;
+    };
+    readonly 'copy-plan': {
+      readonly input: _$zod.ZodObject<{
+        path: _$zod.ZodType<string, string | undefined, _$zod_v4_core0.$ZodTypeInternals<string, string | undefined>>;
+        data: _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodLiteral<"*">, _$zod.ZodArray<_$zod.ZodString>]>>]>;
+        onConflict: _$zod.ZodOptional<_$zod.ZodEnum<{
+          replace: "replace";
+          skip: "skip";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      readonly readOnly: true;
+      readonly label: "Plan a copy";
+      readonly description: "See what copying would bring before you do it — what lands as yours, what comes along because it is pointed at, and what you already hold that the copies will point at. Takes exactly the same input as `copy` and writes nothing. Run it before `copy`, and always before a `'*'` copy.";
+      readonly scope: "item";
+      readonly title: (entity: string) => string;
+      readonly example: ({
+        config,
+        path
+      }: {
+        config: Config;
+        path: string;
+      }) => Record<string, unknown> | undefined;
+      readonly handler: (input: Record<string, unknown>, config: Config) => Omit<CopyPlan, "patches">;
+    };
+  }, {
+    readonly displayName: ({
+      member,
+      path
+    }: ComputedInput) => string;
+  }, false>;
+}, {
+  operations: DerivedEntityClass<_$zod.ZodObject<{
+    kind: _$zod.ZodString;
+    verb: _$zod.ZodString;
+    readOnly: _$zod.ZodBoolean;
+    label: _$zod.ZodString;
+    description: _$zod.ZodString;
+    scope: _$zod.ZodString;
+    creates: _$zod.ZodBoolean;
+    approval: _$zod.ZodOptional<_$zod.ZodEnum<{
+      destructive: "destructive";
+      "reference-change": "reference-change";
+    }>>;
+  }, _$zod_v4_core0.$strip>, {
+    inputSchema: ({
+      member: op,
+      config
+    }: Omit<ComputedInput, "member"> & {
+      member: {
+        kind: string;
+        verb: string;
+        readOnly: boolean;
+        label: string;
+        description: string;
+        scope: string;
+        creates: boolean;
+        approval?: "destructive" | "reference-change" | undefined;
+      };
+    }) => _$zod.ZodTypeAny<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>> | undefined;
+    execute: ({
+      member: op,
+      config: declaring
+    }: Omit<ComputedInput, "member"> & {
+      member: {
+        kind: string;
+        verb: string;
+        readOnly: boolean;
+        label: string;
+        description: string;
+        scope: string;
+        creates: boolean;
+        approval?: "destructive" | "reference-change" | undefined;
+      };
+    }) => ((input: Record<string, unknown>, config: Config) => unknown) | undefined;
+    field: ({
+      member: op
+    }: Omit<ComputedInput, "member"> & {
+      member: {
+        kind: string;
+        verb: string;
+        readOnly: boolean;
+        label: string;
+        description: string;
+        scope: string;
+        creates: boolean;
+        approval?: "destructive" | "reference-change" | undefined;
+      };
+    }) => string | undefined;
+    title: ({
+      member: op,
+      config
+    }: Omit<ComputedInput, "member"> & {
+      member: {
+        kind: string;
+        verb: string;
+        readOnly: boolean;
+        label: string;
+        description: string;
+        scope: string;
+        creates: boolean;
+        approval?: "destructive" | "reference-change" | undefined;
+      };
+    }) => ((entity: string) => string) | undefined;
+    example: ({
+      member: op,
+      config
+    }: Omit<ComputedInput, "member"> & {
+      member: {
+        kind: string;
+        verb: string;
+        readOnly: boolean;
+        label: string;
+        description: string;
+        scope: string;
+        creates: boolean;
+        approval?: "destructive" | "reference-change" | undefined;
+      };
+    }) => Record<string, unknown> | undefined;
+  }>;
+  tools: DerivedEntityClass<_$zod.ZodObject<{
+    operation: DerivedEntityClass<_$zod.ZodObject<{
+      kind: _$zod.ZodString;
+      verb: _$zod.ZodString;
+      readOnly: _$zod.ZodBoolean;
+      label: _$zod.ZodString;
+      description: _$zod.ZodString;
+      scope: _$zod.ZodString;
+      creates: _$zod.ZodBoolean;
+      approval: _$zod.ZodOptional<_$zod.ZodEnum<{
+        destructive: "destructive";
+        "reference-change": "reference-change";
+      }>>;
+    }, _$zod_v4_core0.$strip>, {
+      inputSchema: ({
+        member: op,
+        config
+      }: Omit<ComputedInput, "member"> & {
+        member: {
+          kind: string;
+          verb: string;
+          readOnly: boolean;
+          label: string;
+          description: string;
+          scope: string;
+          creates: boolean;
+          approval?: "destructive" | "reference-change" | undefined;
+        };
+      }) => _$zod.ZodTypeAny<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>> | undefined;
+      execute: ({
+        member: op,
+        config: declaring
+      }: Omit<ComputedInput, "member"> & {
+        member: {
+          kind: string;
+          verb: string;
+          readOnly: boolean;
+          label: string;
+          description: string;
+          scope: string;
+          creates: boolean;
+          approval?: "destructive" | "reference-change" | undefined;
+        };
+      }) => ((input: Record<string, unknown>, config: Config) => unknown) | undefined;
+      field: ({
+        member: op
+      }: Omit<ComputedInput, "member"> & {
+        member: {
+          kind: string;
+          verb: string;
+          readOnly: boolean;
+          label: string;
+          description: string;
+          scope: string;
+          creates: boolean;
+          approval?: "destructive" | "reference-change" | undefined;
+        };
+      }) => string | undefined;
+      title: ({
+        member: op,
+        config
+      }: Omit<ComputedInput, "member"> & {
+        member: {
+          kind: string;
+          verb: string;
+          readOnly: boolean;
+          label: string;
+          description: string;
+          scope: string;
+          creates: boolean;
+          approval?: "destructive" | "reference-change" | undefined;
+        };
+      }) => ((entity: string) => string) | undefined;
+      example: ({
+        member: op,
+        config
+      }: Omit<ComputedInput, "member"> & {
+        member: {
+          kind: string;
+          verb: string;
+          readOnly: boolean;
+          label: string;
+          description: string;
+          scope: string;
+          creates: boolean;
+          approval?: "destructive" | "reference-change" | undefined;
+        };
+      }) => Record<string, unknown> | undefined;
+    }>;
+    name: _$zod.ZodString;
+    description: _$zod.ZodString;
+    enabled: _$zod.ZodDefault<_$zod.ZodBoolean>;
+  }, _$zod_v4_core0.$strip>, {
+    kind: (input: ComputedInput) => string | undefined;
+    verb: (input: ComputedInput) => string | undefined;
+    readOnly: ({
+      member,
+      config
+    }: Omit<ComputedInput, "member"> & {
+      member: {
+        operation: {
+          __ref: string;
+        };
+        name: string;
+        description: string;
+        enabled: boolean;
+      };
+    }) => boolean;
+    inputSchema: (input: ComputedInput) => _$zod.ZodTypeAny<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>> | undefined;
+    execute: (input: ComputedInput) => ((input: Record<string, unknown>, config: Config) => unknown) | undefined;
+    action: (input: ComputedInput) => string | undefined;
+    field: (input: ComputedInput) => string | undefined;
+    scope: (input: ComputedInput) => string | undefined;
+    approval: (input: ComputedInput) => "destructive" | "reference-change" | undefined;
+    label: (input: ComputedInput) => string | undefined;
+    shortLabel: (input: ComputedInput) => string | undefined;
+    example: (input: ComputedInput) => Record<string, unknown> | undefined;
+  }>;
+}>;
+//#endregion
+export { LoadV1Options, V1Artifact, V1Diagnostic, V1DiagnosticCode, V1_DIAGNOSTIC_CODES, loadV1Artifact, v1ComponentRenames };