@pipelex/mthds-form 0.12.1 → 0.14.0

package/dist/core/seed.d.ts

@@ -0,0 +1,56 @@
+import { RunField, ObjectRunField } from './descriptor.js';
+import './contracts.js';
+import 'mthds/protocol';
+import './file-formats.js';
+
+/**
+ * Seeding a form from the method's authored defaults.
+ *
+ * Pure module: no React, no DOM - a server building a payload and a control
+ * opening an optional structure read the same answer from here.
+ */
+
+/**
+ * The `/inputs` seed: the authored defaults, and nothing else.
+ *
+ * A defaulted field carries `defaultValue` (never the `null` a schema
+ * projection attaches to an optional field); a structure's defaults sit inside
+ * it. What is NOT seeded is an empty string or a zero for an unfilled field -
+ * the kernel's readiness treats an absent value as absent, and a seeded
+ * placeholder would count as filled.
+ *
+ * **An optional structure is not descended into.** Its presence is a choice the
+ * person makes with the "+ N optional" disclosure it folds behind (see
+ * `isOptionalStructure`), so a seed that put its children's defaults inside it would make that choice
+ * for them: the structure would arrive open and be sent, merely because its
+ * concept declares defaults. It is seeded only when the structure itself
+ * carries an authored default; otherwise it stays absent, and turning it on
+ * seeds it then, through `seedObjectValue`. A host that wants it open from the
+ * start puts `seedObjectValue(field)` at its path.
+ */
+declare function seedInputs(fields: readonly RunField[]): Record<string, unknown>;
+/**
+ * The value a structured field holds the moment it is opened: the
+ * structure's own authored default when it carries an object one, otherwise
+ * an object seeded from its children's defaults by `seedInputs` - which is `{}`
+ * when none of them declares one. Always a plain object, so the disclosure that
+ * reads the value back (`optionalStructureOpen`) reads open.
+ *
+ * Optional structures beneath it stay absent, by `seedInputs`' own rule: each
+ * opens with its own container's disclosure.
+ */
+declare function seedObjectValue(field: ObjectRunField): Record<string, unknown>;
+/**
+ * What expanding a "+ N optional" disclosure writes: `values` with every
+ * CLOSED optional structure among `fields` opened to `seedObjectValue(field)`.
+ * Open ones and every other field are kept as they are. Returns a new object.
+ */
+declare function openOptionalStructures(fields: readonly RunField[], values: Record<string, unknown> | undefined): Record<string, unknown>;
+/**
+ * What collapsing a "+ N optional" disclosure writes: `values` with every
+ * optional structure among `fields` closed to `undefined`, so each leaves the
+ * payload. Every other field is kept as it is. Returns a new object.
+ */
+declare function closeOptionalStructures(fields: readonly RunField[], values: Record<string, unknown> | undefined): Record<string, unknown>;
+
+export { closeOptionalStructures, openOptionalStructures, seedInputs, seedObjectValue };

package/dist/core/seed.js

@@ -0,0 +1,5 @@
+export { closeOptionalStructures, openOptionalStructures, seedInputs, seedObjectValue } from '../chunk-VH5CDQDR.js';
+import '../chunk-XO5OENNF.js';
+import '../chunk-V3OV2XQT.js';
+//# sourceMappingURL=seed.js.map
+//# sourceMappingURL=seed.js.map

package/dist/core/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"seed.js"}

package/dist/core/values.js

@@ -1,8 +1,8 @@
-export { apiInputsFromRunValues, fieldsForContract, inputDataFromWorkingMemory, outputsFromPipeOutput, rjsfDataFromRunValues, runValuesFromStore, setValueAtPath, storeInputDataFromRunValues } from '../chunk-4KGQ65TQ.js';
+export { apiInputsFromRunValues, fieldsForContract, inputDataFromWorkingMemory, outputsFromPipeOutput, rjsfDataFromRunValues, runValuesFromStore, setValueAtPath, storeInputDataFromRunValues } from '../chunk-VT5E5W4E.js';
 import '../chunk-ZB4RYUKV.js';
 import '../chunk-XCO6GTEC.js';
 import '../chunk-GCXV76WU.js';
-import '../chunk-PM55AHRO.js';
+import '../chunk-XO5OENNF.js';
 import '../chunk-GKV77RAS.js';
 import '../chunk-OD3VYXUY.js';
 import '../chunk-WYH56SOZ.js';

package/dist/generative/index.d.ts

@@ -8,6 +8,7 @@ import * as _json_render_react from '@json-render/react';
 import { Components, Renderer } from '@json-render/react';
 import * as zod_v4_core from 'zod/v4/core';
 import { F as FieldEnv } from '../field-renderer-C5Onx6qB.js';
+export { seedInputs } from '../core/seed.js';
 import '../core/contracts.js';
 import 'mthds/protocol';
 import '../core/file-formats.js';
@@ -2023,16 +2024,6 @@ declare function absoluteHatchPath(spec: Spec, key: string, path: string, parent
  * the model and the escape hatch read the same tree.
  */
 declare function payloadToState(field: RunField, payload: unknown): unknown;
-/**
- * The `/inputs` seed: the authored defaults, and nothing else.
- *
- * A defaulted field carries `defaultValue` (never the `null` a schema
- * projection attaches to an optional field); a structure's defaults sit inside
- * it. What is NOT seeded is an empty string or a zero for an unfilled field -
- * the kernel's readiness treats an absent value as absent, and a seeded
- * placeholder would count as filled.
- */
-declare function seedInputs(fields: readonly RunField[]): Record<string, unknown>;
 
 /**
  * A spec with its provenance - the shape every fixture takes, whoever produced
@@ -2103,4 +2094,4 @@ declare function fixtureLabel(fixture: Pick<SpecFixture, 'producer' | 'model' |
 /** The fixture a story asks for, or a loud failure: a story must never render a page it did not name. */
 declare function findFixture(fixtures: readonly SpecFixture[], pipeRef: string, id: string): SpecFixture;
 
-export { type BrandManifest, BrandProvider, type BriefSubject, COMPONENT_NAMES, COMPONENT_RENDERINGS, CUSTOM_COMPONENTS, type ComponentRendering, type CriticLoop, DESIGNER_BRIEF_CONCEPT, DESIGNER_CATALOG_CONCEPT, DescriptorProvider, type DescriptorScope, type DesignerAction, type DesignerBrief, type DesignerCatalog, type DesignerComponent, type DesignerPathEntry, GenerativePage, type GenerativePageProps, type GenerativeSpec, ICON_NAMES, INPUTS_ROOT, type LayoutDescriptor, METRIC_FORMATS, PICKED_SHADCN, PRODUCT_COMPONENTS, PROMPT_HASH, type PageRegistry, type Producer, type ProductComponentName, RESULT_ROOT, type ResultSlot, ResultSlotProvider, type SpecFixture, type SpecProblem, type SpecVerdict, type ValidationCatalog, absoluteHatchPath, brandManifestSchema, catalog, designerCatalog, fieldAtSegments, findFixture, fixtureId, fixtureLabel, formatProblems, generativeRegistry, generativeRenderers, inputBrief, inputFieldAtPath, isDelegatedInput, isDelegatedResult, joinPath, jsonlLines, layoutFits, layoutProblems, pathFromDomId, payloadToState, repeatBasePathOf, resultBrief, resultFieldAtPath, seedInputs, segmentsUnder, specFromJsonl, specToJsonl, useBrand, useDescriptorScope, useResultSlot, useStoreSnapshot, validateAgainstCatalog };
+export { type BrandManifest, BrandProvider, type BriefSubject, COMPONENT_NAMES, COMPONENT_RENDERINGS, CUSTOM_COMPONENTS, type ComponentRendering, type CriticLoop, DESIGNER_BRIEF_CONCEPT, DESIGNER_CATALOG_CONCEPT, DescriptorProvider, type DescriptorScope, type DesignerAction, type DesignerBrief, type DesignerCatalog, type DesignerComponent, type DesignerPathEntry, GenerativePage, type GenerativePageProps, type GenerativeSpec, ICON_NAMES, INPUTS_ROOT, type LayoutDescriptor, METRIC_FORMATS, PICKED_SHADCN, PRODUCT_COMPONENTS, PROMPT_HASH, type PageRegistry, type Producer, type ProductComponentName, RESULT_ROOT, type ResultSlot, ResultSlotProvider, type SpecFixture, type SpecProblem, type SpecVerdict, type ValidationCatalog, absoluteHatchPath, brandManifestSchema, catalog, designerCatalog, fieldAtSegments, findFixture, fixtureId, fixtureLabel, formatProblems, generativeRegistry, generativeRenderers, inputBrief, inputFieldAtPath, isDelegatedInput, isDelegatedResult, joinPath, jsonlLines, layoutFits, layoutProblems, pathFromDomId, payloadToState, repeatBasePathOf, resultBrief, resultFieldAtPath, segmentsUnder, specFromJsonl, specToJsonl, useBrand, useDescriptorScope, useResultSlot, useStoreSnapshot, validateAgainstCatalog };

package/dist/generative/index.js

@@ -1,12 +1,18 @@
 "use client";
-import { cn, fieldControlClass, ResultRoot, ResultField, FieldRenderer, ToggleGroup, ToggleGroupItem, Switch, Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '../chunk-2D4NEFUH.js';
-import '../chunk-7KQXGG6J.js';
+import { cn, fieldControlClass, ResultRoot, ResultField, FieldRenderer, ToggleGroup, ToggleGroupItem, Switch, Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '../chunk-7JRT6ZII.js';
+export { seedInputs } from '../chunk-VH5CDQDR.js';
+import '../chunk-VT5E5W4E.js';
+import '../chunk-ICUEHNEH.js';
 import '../chunk-RRTI7AIR.js';
 import { isNativeValueNode, readDateContent, formatDateContent, isNativeHtmlNode, isNativeDateNode, isNativeCompositeNode } from '../chunk-CM4KVG53.js';
+import '../chunk-ZB4RYUKV.js';
 import '../chunk-FABY3DEY.js';
 import '../chunk-XCO6GTEC.js';
-import '../chunk-PM55AHRO.js';
+import '../chunk-GCXV76WU.js';
+import '../chunk-XO5OENNF.js';
 import '../chunk-GKV77RAS.js';
+import '../chunk-OD3VYXUY.js';
+import '../chunk-WYH56SOZ.js';
 import { hasOwnProp } from '../chunk-V3OV2XQT.js';
 import { defineSchema, defineCatalog, validateSpec, compileSpecStream } from '@json-render/core';
 import { z } from 'zod';
@@ -903,7 +909,7 @@ function describe(field, path, depth, side, entries, seeded = false) {
   entries.push(entry);
   if (entry.delegated) return;
   if (field.kind === "object") {
-    const seededBelow = seeded || field.defaultValue !== void 0;
+    const seededBelow = seeded || field.defaultValue !== void 0 || side === "input" && !field.required;
     for (const child of field.fields) {
       describe(child, joinPath(path, child.name), depth + 1, side, entries, seededBelow);
     }
@@ -3042,18 +3048,6 @@ function payloadToState(field, payload) {
       return field;
   }
 }
-function seedInputs(fields) {
-  const seed = {};
-  for (const field of fields) {
-    if (field.defaultValue !== void 0) {
-      seed[field.name] = field.defaultValue;
-    } else if (field.kind === "object") {
-      const nested = seedInputs(field.fields);
-      if (Object.keys(nested).length > 0) seed[field.name] = nested;
-    }
-  }
-  return seed;
-}
 
 // src/generative/fixture.ts
 function fixtureId(fixture) {
@@ -3090,6 +3084,6 @@ function findFixture(fixtures, pipeRef, id) {
   return found;
 }
 
-export { BrandProvider, COMPONENT_NAMES, COMPONENT_RENDERINGS, CUSTOM_COMPONENTS, DESIGNER_BRIEF_CONCEPT, DESIGNER_CATALOG_CONCEPT, DescriptorProvider, GenerativePage, ICON_NAMES, INPUTS_ROOT, METRIC_FORMATS, PICKED_SHADCN, PRODUCT_COMPONENTS, PROMPT_HASH, RESULT_ROOT, ResultSlotProvider, absoluteHatchPath, brandManifestSchema, catalog, designerCatalog, fieldAtSegments, findFixture, fixtureId, fixtureLabel, formatProblems, generativeRegistry, generativeRenderers, inputBrief, inputFieldAtPath, isDelegatedInput, isDelegatedResult, joinPath, jsonlLines, layoutFits, layoutProblems, pathFromDomId, payloadToState, repeatBasePathOf, resultBrief, resultFieldAtPath, seedInputs, segmentsUnder, specFromJsonl, specToJsonl, useBrand, useDescriptorScope, useResultSlot, useStoreSnapshot, validateAgainstCatalog };
+export { BrandProvider, COMPONENT_NAMES, COMPONENT_RENDERINGS, CUSTOM_COMPONENTS, DESIGNER_BRIEF_CONCEPT, DESIGNER_CATALOG_CONCEPT, DescriptorProvider, GenerativePage, ICON_NAMES, INPUTS_ROOT, METRIC_FORMATS, PICKED_SHADCN, PRODUCT_COMPONENTS, PROMPT_HASH, RESULT_ROOT, ResultSlotProvider, absoluteHatchPath, brandManifestSchema, catalog, designerCatalog, fieldAtSegments, findFixture, fixtureId, fixtureLabel, formatProblems, generativeRegistry, generativeRenderers, inputBrief, inputFieldAtPath, isDelegatedInput, isDelegatedResult, joinPath, jsonlLines, layoutFits, layoutProblems, pathFromDomId, payloadToState, repeatBasePathOf, resultBrief, resultFieldAtPath, segmentsUnder, specFromJsonl, specToJsonl, useBrand, useDescriptorScope, useResultSlot, useStoreSnapshot, validateAgainstCatalog };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map