@yahoo/uds-create-config 4.36.0 → 4.36.1

package/dist/configs/CanvasConfig.js

@@ -10,42 +10,6 @@ import { Tool } from "../entities/system/Tool.js";
 import { defineConfig } from "../framework/defineConfig.js";
 import { System } from "./system.js";
 import { z } from "zod";
-//#region src/configs/CanvasConfig.ts
-/**
-* The canvas config — a design file as its own config TYPE, and every entity it owns, co-located in
-* one home (the same shape `../design-file.ts` keeps, which this supersedes).
-*
-* `Node` is the ONE kind, flat: every element is its own node row. A PLACED node — the thing
-* react-flow wraps — additionally carries `page` + geometry; its subtree nodes carry none and nest
-* under its id (`n1/badge` is part of `n1`, the same occupied-prefix containment `Card/Header`
-* uses), with `children`/`slots` as real node refs. Flat rather than an embedded keyed tree
-* because an embedded tree is the old `spec` jsonb blob again: one Yjs key per node means two
-* people editing different subtree elements conflict as whole-blob writes, and every edit re-ships
-* the tree. One row per element is the collaboration and write granularity. An instance is one
-* placed node, a generation placeholder is a placed node with no `type` yet.
-*
-* AI provenance is the chain node → `AiGeneration` → `AiFlow` → `AiMessage` → `AiChat`, every hop a
-* real ref. The system arrives WHOLE through `SystemSource` — never `LinkedSystem`'s partial-borrow
-* apparatus, which a canvas has no use for. See `docs/config-v2-spec-renderer-model.md`, "Where an
-* entity-shaped Spec lives".
-*
-* Lives in config-v2 (not studio) so every consumer can hold one: the derived `operation`/`tool`
-* catalog means the compact agent tools serve canvas CRUD the same way they serve the system's —
-* the MCP/CLI surface derives from the config type, and a studio-only home would fence
-* that off. Studio keeps the runtime halves (row mapping, Yjs session, dynamic registry), which
-* genuinely are app concerns.
-*/
-/**
-* `SystemSource` — this canvas's pointer at the ONE system it belongs to, in full. `LinkedSystem` is
-* the wrong mechanism here: it exists for a design system partially borrowing PIECES of another
-* (`link`, per-entity `options`, override/extend), and a canvas never does that — a node's `type`
-* always resolves against the whole of exactly one system.
-*
-* The source is attached under the system config's own `name`, which is `system-config` for a web
-* system and `react-native-system` for a native one, so a node ref the canvas mints
-* (`component:actions/Button@system-config`) means "the attached system". The system itself resolves
-* that ref as its own, through `Config.configFor`'s own-name rule.
-*/
 const SystemSource = defineEntity({
 	kind: "system-source",
 	fields: z.object({ 
@@ -62,18 +26,10 @@ systemId: z.string().optional() }),
 	},
 	linkable: false
 });
-/**
-* `Canvas` — a surface in a design file (a design file has one or more). Pages belong to a canvas,
-* nodes belong to a page (flat, ref-related, matching the real tables' `canvasId`/`pageId` columns).
-*/
 const Canvas = defineEntity({
 	kind: "canvas",
 	fields: z.object({ name: z.string().optional() })
 });
-/**
-* `Page` — a page within a `Canvas`. Field-for-field the `canvas_pages` table (id → path,
-* `canvasId` → the ref, timestamps DB-owned).
-*/
 const Page = defineEntity({
 	kind: "page",
 	fields: z.object({
@@ -85,17 +41,12 @@ const Page = defineEntity({
 		sortOrder: z.number().optional()
 	})
 });
-/**
-* `AiChat` — one conversation. Deliberately minimal: the transcript is the `AiMessage` rows that
-* ref it (flat rows pointing at their owner, never an embedded array nothing can ref into).
-*/
 const AiChat = defineEntity({
 	kind: "ai-chat",
 	fields: z.object({ title: z.string().optional() }),
 	label: "AI chat",
 	linkable: false
 });
-/** `AiMessage` — one turn in an `AiChat`. */
 const AiMessage = defineEntity({
 	kind: "ai-message",
 	fields: z.object({
@@ -146,11 +97,6 @@ const AiFlow = defineEntity({
 	label: "AI flow",
 	linkable: false
 });
-/**
-* `AiGeneration` — how one node came to exist: the flow that produced it, and — for an iteration —
-* the lineage it varied from, as a real graph edge. Replaces the `canvas_nodes` table's
-* `generation_*` and `iteration_meta` columns, which all describe this one event.
-*/
 const AiGeneration = defineEntity({
 	kind: "ai-generation",
 	fields: z.object({
@@ -199,17 +145,6 @@ const Size = z.discriminatedUnion("type", [z.object({
 	type: z.literal("device"),
 	ref: Device
 })]);
-/**
-* `Node` — the unit of a canvas: one element, one record, one row. FLAT — a subtree node is its own
-* item nested under its placed root's id (`n1/badge`), and `children`/`slots` hold real node refs,
-* so `dependents()`, delete-refusal and rename-cascade come from the framework instead of
-* `reKeySlotRefs` (UDS-3526) / `gcUnreachableElements` (UDS-3557) hand-rolling them per gesture.
-*
-* Placement fields are present on a PLACED node (`page` is the discriminant — what the canvas lists
-* and react-flow wraps) and absent on subtree nodes. `type` is optional for exactly one reason: a
-* placed node awaiting its first generation (today's skeleton / pending placeholder) exists before
-* anyone knows what it renders.
-*/
 const Node = defineEntity({
 	kind: "node",
 	schemas: captureNodeOps,
@@ -284,17 +219,6 @@ displayLabel: ({ member, config }) => {
 		return type ? config.displayLabelOf(type) : void 0;
 	} }
 });
-/**
-* `CanvasConfig` — the design-file config TYPE. Owns placement, content, and AI provenance (flat,
-* ref-related), DRAWS ON a system, and derives the same agent-tool catalog (`operation`/`tool`) as
-* the system so its design-file CRUD tools project from it.
-*
-* A source, not a read-through window onto every one of the system's kinds. A node's `type` carries
-* the source it points into (`component:actions/Button@<slug>`), so one resolution path serves both
-* and nothing has to know that THIS config borrows a whole kind. Read-only stays read-only: a
-* source's items resolve through their own config, so there is no local collection to offer CRUD
-* over.
-*/
 const CanvasConfig = defineConfig({
 	name: "canvas",
 	entities: {

package/dist/configs/documentation.d.ts

@@ -1,256 +1,16 @@
-import { ComputedInput } from "../framework/registry.js";
-import { DerivedEntityClass } from "../framework/defineDerivedEntity.js";
-import { EntityClass } from "../framework/defineEntity.js";
 import { ConfigClass } from "../framework/defineConfig.js";
-import { Config } from "../framework/Config.js";
-import * as _$zod from "zod";
-import * as _$zod_v4_core0 from "zod/v4/core";
-
+import { Named } from "../framework/named.js";
+import { DocumentationClass } from "../entities/documentation/Documentation.js";
+import { OperationClass } from "../entities/system/Operation.js";
+import { ToolClass } from "../entities/system/Tool.js";
 //#region src/configs/documentation.d.ts
-declare const DocumentationLibrary: ConfigClass<{
-  documents: EntityClass<_$zod.ZodObject<{
-    title: _$zod.ZodString;
-    summary: _$zod.ZodOptional<_$zod.ZodString>;
-    markdown: _$zod.ZodString;
-    category: _$zod.ZodString;
-    public: _$zod.ZodDefault<_$zod.ZodBoolean>;
-    products: _$zod.ZodArray<_$zod.ZodEnum<{
-      create: "create";
-      uds: "uds";
-    }>>;
-    platform: _$zod.ZodOptional<_$zod.ZodEnum<{
-      mobile: "mobile";
-      web: "web";
-    }>>;
-  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "documentation", {
-    readonly search: {
-      readonly input: _$zod.ZodObject<{
-        query: _$zod.ZodDefault<_$zod.ZodString>;
-      }, _$zod_v4_core0.$strip>;
-      readonly readOnly: true;
-      readonly label: "Search";
-      readonly description: "Find articles by text in their path, title, summary, or Markdown. An empty query browses all articles. Returns metadata without article bodies; use get to read an article.";
-      readonly scope: "collection";
-      readonly example: () => {
-        query: string;
-      };
-      readonly handler: (input: Record<string, unknown>, config: Config) => {
-        path: string;
-        title: string;
-        summary: string | undefined;
-        category: string;
-        products: ("create" | "uds")[];
-        platform: "mobile" | "web" | undefined;
-      }[];
-    };
-  }, Record<never, never>, false, Record<never, never>, Record<never, never>>;
+declare const DocumentationLibraryDefinition: ConfigClass<{
+  documents: DocumentationClass;
 }, {
-  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;
-  }>;
+  operations: OperationClass;
+  tools: ToolClass;
 }, Record<never, never>>;
+interface DocumentationLibraryClass extends Named<typeof DocumentationLibraryDefinition> {}
+declare const DocumentationLibrary: DocumentationLibraryClass;
 //#endregion
-export { DocumentationLibrary };
+export { DocumentationLibrary, DocumentationLibraryClass };

package/dist/configs/documentation.js

@@ -2,7 +2,6 @@ import { Operation } from "../entities/system/Operation.js";
 import { Tool } from "../entities/system/Tool.js";
 import { defineConfig } from "../framework/defineConfig.js";
 import { Documentation } from "../entities/documentation/Documentation.js";
-//#region src/configs/documentation.ts
 const DocumentationLibrary = defineConfig({
 	name: "documentation-library",
 	description: "Knowledge Base articles about UDS and Create, independently of users’ design systems.",