@pipelex/mthds-form 0.33.0 → 0.34.0

package/dist/core/gate.js

@@ -1,6 +1,6 @@
-export { apiInputsFromSchemaData, buildRunInputsSchema, gateRunInputs, prepareRunInputs, validateRunInputs } from '../chunk-IBBAJXIO.js';
+export { apiInputsFromSchemaData, buildRunInputsSchema, gateRunInputs, prepareRunInputs, validateRunInputs } from '../chunk-XIWBKV7T.js';
 import '../chunk-E6BIXJ6C.js';
-import '../chunk-XO5OENNF.js';
+import '../chunk-TF4RTKLH.js';
 import '../chunk-Y2ND6W4W.js';
 import '../chunk-LBFZXYCY.js';
 import '../chunk-OD3VYXUY.js';

package/dist/core/index.js

@@ -1,9 +1,9 @@
 export { planFileSave, planStuffSave } from '../chunk-4VAO6BDE.js';
-export { closeOptionalStructures, openOptionalStructures, seedInputs, seedObjectValue } from '../chunk-VH5CDQDR.js';
+export { closeOptionalStructures, openOptionalStructures, seedInputs, seedObjectValue } from '../chunk-AURDKAIC.js';
 export { addChosenFiles, chosenFilesAdded, roomForChosenFiles, sourceFileValue } from '../chunk-L23R3JNQ.js';
 export { collectStuffFiles } from '../chunk-56WECFBD.js';
 export { describeValidationError, displayValue, valueAtProperty } from '../chunk-RPA7DNSK.js';
-export { apiInputsFromRunValues, fieldsForContract, inputDataFromWorkingMemory, outputsFromPipeOutput, rjsfDataFromRunValues, runValuesFromInputs, runValuesFromStore, sameRunValues, setValueAtPath, storeInputDataFromRunValues } from '../chunk-ZX52CQJ4.js';
+export { apiInputsFromRunValues, fieldsForContract, inputDataFromWorkingMemory, outputsFromPipeOutput, rjsfDataFromRunValues, runValuesFromInputs, runValuesFromStore, sameRunValues, setValueAtPath, storeInputDataFromRunValues } from '../chunk-CFBK7NO7.js';
 export { enumValueLabeler, humanizeEnumValue, humanizeFieldName } from '../chunk-GHVVULHY.js';
 export { narrowFileFormats } from '../chunk-CAKQ5VFT.js';
 export { NATIVE_CHOICE_CONCEPT_REF, NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, NATIVE_PAGE_CONCEPT_REF, NATIVE_RATING_CONCEPT_REF, NATIVE_SEARCH_RESULT_CONCEPT_REF, NATIVE_YES_NO_CONCEPT_REF, TYPED_SCALAR_MARKERS, citedSource, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isNativePageNode, isNativeSearchResultNode, isViewableUrl, nativeVerdictOf, readChoiceContent, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, readPageContent, readRatingContent, readSearchResultContent, readYesNoContent, splitCitations, viewableUrl } from '../chunk-QQK6Y55E.js';
@@ -11,9 +11,9 @@ export { getPipeOutputForm } from '../chunk-JIGRWJTV.js';
 export { buildResultField, buildRunFields, getPipeInputForm } from '../chunk-ZB4RYUKV.js';
 export { conceptCategory } from '../chunk-FABY3DEY.js';
 export { DOCUMENT_FORMATS, IMAGE_FORMATS, acceptLabel, acceptMap, formatsForKind, isAcceptedFile } from '../chunk-XCO6GTEC.js';
-export { apiInputsFromSchemaData, buildRunInputsSchema, gateRunInputs, prepareRunInputs, validateRunInputs } from '../chunk-IBBAJXIO.js';
+export { apiInputsFromSchemaData, buildRunInputsSchema, gateRunInputs, prepareRunInputs, validateRunInputs } from '../chunk-XIWBKV7T.js';
 export { deflateAllInputs, deflateInput, healStringWrappers, inflateAllInputs, inflateInput, pruneEmptyOptionals, resolveConceptCode } from '../chunk-E6BIXJ6C.js';
-export { anyOptionalStructureOpen, computeReadiness, fieldFilled, foldsBehindOptionalDisclosure, isFilled, isFoldedOptional, isOptionalStructure, mustBeFilled, optionalStructureOpen, shownAsOptional } from '../chunk-XO5OENNF.js';
+export { anyOptionalStructureOpen, computeReadiness, fieldFilled, foldsBehindOptionalDisclosure, isFilled, isFoldedOptional, isOptionalStructure, mustBeFilled, optionalStructureOpen, shownAsOptional } from '../chunk-TF4RTKLH.js';
 import '../chunk-Y2ND6W4W.js';
 export { normalizeSchemaForRjsf, prepareSchemaForRjsf } from '../chunk-LBFZXYCY.js';
 export { collapseNullable, collectSchemaDefs, derefSchema, flattenAnyOf, hoistDefsToRoot, resolveSchemaIndirection, schemaTypeOf } from '../chunk-OD3VYXUY.js';

package/dist/core/readiness.d.ts

@@ -88,6 +88,39 @@ declare function mustBeFilled(field: RunField): boolean;
  * things stand between me and Run", which is the number a host is displaying.
  */
 declare function computeReadiness(fields: RunField[], values: Record<string, unknown>): Readiness;
+/**
+ * The top-level fields that stand between the current values and a run, as
+ * fields rather than names, in the descriptor's order: the inputs
+ * `computeReadiness` counts as missing. A surface that names them in its own
+ * words - a humanised label, a run button's description - reads them here, so
+ * it names exactly what the count says.
+ */
+declare function missingFields(fields: readonly RunField[], values: Record<string, unknown> | undefined): RunField[];
+/**
+ * Why the run gate refuses a field, as the structure or the form holding it
+ * holds it: a field that must be filled (`mustFill`) and is not is
+ * `required`, and a field that need not be but holds something short of what
+ * its concept demands is `incomplete`. This is `fieldFilled`'s own rule for a
+ * structure's members, so a structure the gate refuses has at least one
+ * member it refuses, unless it is a structure that must be touched and holds
+ * nothing at all.
+ */
+declare function gateRefusal(field: RunField, value: unknown, mustFill: boolean): 'required' | 'incomplete' | undefined;
+/**
+ * The fields a person fills to let the run go, at the depth a form draws
+ * them: each missing input (`missingFields`), and in place of a structure the
+ * members it refuses (`gateRefusal`), at every depth, which is where a form
+ * marks them and where a layout that spreads a structure's members over the
+ * page puts them. A structure that refuses no member of its own - one that
+ * must be touched and holds nothing, with no required member - is itself the
+ * field to fill. A list is one field: its rows are the person's own.
+ */
+declare function waitingFields(fields: readonly RunField[], values: Record<string, unknown> | undefined): WaitingField[];
+/** A field the run waits for, and the names that lead to it from the inputs, its own last. */
+interface WaitingField {
+    field: RunField;
+    path: readonly string[];
+}
 /**
  * Whether a person should see this field as optional: not required AND carrying no authored
  * default. The standard marks a defaulted field `required: false` (it can never be missing), but it
@@ -142,4 +175,4 @@ declare function isFoldedOptional(field: RunField, value: unknown): boolean;
 /** Whether any optional structure among `fields` is open in `values`. */
 declare function anyOptionalStructureOpen(fields: readonly RunField[], values: Record<string, unknown> | undefined): boolean;
 
-export { type Readiness, anyOptionalStructureOpen, computeReadiness, fieldFilled, foldsBehindOptionalDisclosure, isFilled, isFoldedOptional, isOptionalStructure, mustBeFilled, optionalStructureOpen, shownAsOptional };
+export { type Readiness, type WaitingField, anyOptionalStructureOpen, computeReadiness, fieldFilled, foldsBehindOptionalDisclosure, gateRefusal, isFilled, isFoldedOptional, isOptionalStructure, missingFields, mustBeFilled, optionalStructureOpen, shownAsOptional, waitingFields };

package/dist/core/readiness.js

@@ -1,4 +1,4 @@
-export { anyOptionalStructureOpen, computeReadiness, fieldFilled, foldsBehindOptionalDisclosure, isFilled, isFoldedOptional, isOptionalStructure, mustBeFilled, optionalStructureOpen, shownAsOptional } from '../chunk-XO5OENNF.js';
+export { anyOptionalStructureOpen, computeReadiness, fieldFilled, foldsBehindOptionalDisclosure, gateRefusal, isFilled, isFoldedOptional, isOptionalStructure, missingFields, mustBeFilled, optionalStructureOpen, shownAsOptional, waitingFields } from '../chunk-TF4RTKLH.js';
 import '../chunk-V3OV2XQT.js';
 //# sourceMappingURL=readiness.js.map
 //# sourceMappingURL=readiness.js.map

package/dist/core/seed.js

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

package/dist/core/values.js

@@ -1,8 +1,8 @@
-export { apiInputsFromRunValues, fieldsForContract, inputDataFromWorkingMemory, outputsFromPipeOutput, rjsfDataFromRunValues, runValuesFromInputs, runValuesFromStore, sameRunValues, setValueAtPath, storeInputDataFromRunValues } from '../chunk-ZX52CQJ4.js';
+export { apiInputsFromRunValues, fieldsForContract, inputDataFromWorkingMemory, outputsFromPipeOutput, rjsfDataFromRunValues, runValuesFromInputs, runValuesFromStore, sameRunValues, setValueAtPath, storeInputDataFromRunValues } from '../chunk-CFBK7NO7.js';
 import '../chunk-ZB4RYUKV.js';
 import '../chunk-XCO6GTEC.js';
 import '../chunk-E6BIXJ6C.js';
-import '../chunk-XO5OENNF.js';
+import '../chunk-TF4RTKLH.js';
 import '../chunk-OD3VYXUY.js';
 import '../chunk-WYH56SOZ.js';
 import '../chunk-V3OV2XQT.js';

package/dist/generative/headless/index.d.ts

@@ -1278,9 +1278,10 @@ declare function designerCatalog({ frame }?: DesignerCatalogOptions): DesignerCa
  * the catalog as data (`designerCatalog({ frame })`). Both are what a run was
  * actually given, so both are hashed - a reworded rule and a renamed prop each
  * move the pin, exactly as they did when the prompt was rendered here. A run
- * is given the catalog of one frame, and the hash covers every frame's in a
- * fixed order: one pin a host compares every stored layout with, whichever
- * frame it was written for, and which any frame's vocabulary moving moves. The frame a
+ * is given the catalog of one frame, and the hash covers the method's text
+ * first and then every frame's catalog, in a fixed order: one pin a host
+ * compares every stored layout with, whichever frame it was written for, and
+ * which a reworded rule or any frame's vocabulary moving moves. The frame a
  * layout was written for is its own provenance, beside the hash. The brief is
  * not hashed: it is the per-method half, recorded with each layout. The model
  * pin in the method file moves it too, since the file is hashed whole; a
@@ -1408,11 +1409,14 @@ interface LayoutVerdict {
     /** Every problem, one a line, in the words the repair pass reads; empty means the layout may render. */
     problems: string[];
     /**
-     * Whether a check threw on a layout of the right shape: a defect in the
-     * checks, stated among the problems in a line of its own. The layout is
-     * refused all the same - the host keeps the plain form - but a producer
-     * stops here instead of handing the lines to the repair pass, which can
-     * change the layout and not the checks.
+     * Whether no repair of the layout can help: a check threw on a layout of
+     * the right shape, a defect in the checks, or the frame or the descriptor
+     * the layout is checked against is not one, a defect in what the host
+     * handed over. Each
+     * is stated among the problems in a line of its own. The layout is refused
+     * all the same - the host keeps the plain form - but a producer stops here
+     * instead of handing the lines to the repair pass, which can change the
+     * layout and neither the checks nor the descriptor.
      */
     checksFailed: boolean;
 }
@@ -1432,7 +1436,9 @@ interface LayoutVerdict {
  * page to its fallback. So a frame this package does not draw, a missing or
  * misshapen descriptor, and anything not shaped like a spec are each a
  * problem line, and a throw left in a walk below on a layout of the right
- * shape is the checks' own failure: a line saying so, and `checksFailed`.
+ * shape is the checks' own failure, a line saying so. The frame and the
+ * descriptor are the host's, and a throw is the checks', so each of those
+ * sets `checksFailed` too: no repair of the layout can mend it.
  * The shape is checked once, before either check walks the layout.
  */
 declare function layoutCheck(spec: Spec, { frame, descriptor }: LayoutCheck): LayoutVerdict;

package/dist/generative/headless/index.js

@@ -1,6 +1,7 @@
-export { COMPONENT_NAMES, COMPONENT_RENDERINGS, COMPOSER_COMPONENTS, CUSTOM_COMPONENTS, DESIGNER_BRIEF_CONCEPT, DESIGNER_CATALOG_CONCEPT, FRAMES, FRAME_COMPONENTS, ICON_NAMES, INPUTS_ROOT, METRIC_FORMATS, PICKED_SHADCN, PRODUCT_COMPONENTS, PROMPT_HASH, REPAIR_ATTEMPTS, RESULT_COMPONENTS, RESULT_ROOT, absoluteHatchPath, catalog, componentNamesFor, designerCatalog, fieldAtSegments, findFixture, fixtureId, fixtureLabel, formatProblems, frameCatalog, inputBrief, inputFieldAtPath, isDelegatedInput, isDelegatedResult, joinPath, jsonlLines, layoutCheck, layoutCheckProblems, layoutFits, layoutProblems, payloadToState, promptHashSubject, repeatBasePathOf, resultBrief, resultFieldAtPath, seedLine, segmentsUnder, specFromJsonl, specToJsonl, validateAgainstCatalog } from '../../chunk-4SRSGZWM.js';
+export { COMPONENT_NAMES, COMPONENT_RENDERINGS, COMPOSER_COMPONENTS, CUSTOM_COMPONENTS, DESIGNER_BRIEF_CONCEPT, DESIGNER_CATALOG_CONCEPT, FRAMES, FRAME_COMPONENTS, ICON_NAMES, INPUTS_ROOT, METRIC_FORMATS, PICKED_SHADCN, PRODUCT_COMPONENTS, PROMPT_HASH, REPAIR_ATTEMPTS, RESULT_COMPONENTS, RESULT_ROOT, absoluteHatchPath, catalog, componentNamesFor, designerCatalog, fieldAtSegments, findFixture, fixtureId, fixtureLabel, formatProblems, frameCatalog, inputBrief, inputFieldAtPath, isDelegatedInput, isDelegatedResult, joinPath, jsonlLines, layoutCheck, layoutCheckProblems, layoutFits, layoutProblems, payloadToState, promptHashSubject, repeatBasePathOf, resultBrief, resultFieldAtPath, seedLine, segmentsUnder, specFromJsonl, specToJsonl, validateAgainstCatalog } from '../../chunk-XYS5KCXB.js';
 import '../../chunk-QQK6Y55E.js';
-import '../../chunk-3GO65HWP.js';
+import '../../chunk-PNNWNRPG.js';
+import '../../chunk-TF4RTKLH.js';
 import '../../chunk-V3OV2XQT.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/generative/index.d.ts

@@ -802,16 +802,39 @@ declare function useStoreSnapshot(store: StateStore): StateModel;
  */
 declare const generativeRegistry: _json_render_react.ComponentRegistry;
 
+/**
+ * A panel that can be hidden - a tab's, a step's, a closed section's - as a
+ * refused run sees it: `open` shows this panel, and the reveal it hands its
+ * contents opens the panels around it first. The reveal handed down keeps its
+ * identity across renders, so no field re-renders when its panel does.
+ */
+declare function RevealPanel({ open, children }: {
+    open: () => void;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/** What `useCheckedField` gives a control: json-render's field validation, and where the focus goes. */
+type CheckedField = ReturnType<typeof useFieldValidation> & {
+    /**
+     * A ref for the element a refused run puts the focus on: the input, the
+     * select's trigger, a radio group's checked option or its first while none
+     * is. A control that attaches it is focused when it is the first failing
+     * field of a refused run; one that does not is still revealed, after every
+     * field that does.
+     */
+    focusRef: (element: HTMLElement | null) => void;
+};
 /**
  * json-render's `useFieldValidation`, for a control that carries checks. On a
  * page, the field's checks enter the page's record while it is mounted, and
  * the field validates against every check its path carries, so a control
  * hidden or dropped no longer holds the run and two controls on one path
- * agree. A host's own control that carries checks calls this rather than
- * `useFieldValidation` to be held to the same rules; outside a page it is
+ * agree; and when a run is refused, the first failing field is revealed and
+ * focused. A host's own control that carries checks calls this rather than
+ * `useFieldValidation` to be held to the same rules, and attaches `focusRef`
+ * to the element that should take the focus; outside a page it is
  * `useFieldValidation`.
  */
-declare function useCheckedField(path: string, config: ValidationConfig | undefined): ReturnType<typeof useFieldValidation>;
+declare function useCheckedField(path: string, config: ValidationConfig | undefined): CheckedField;
 
 /**
  * What the page paints under the work column, when there is anything to paint.
@@ -880,4 +903,4 @@ declare function FrameHostProvider({ host, children, }: {
 }): React.JSX.Element;
 declare function useFrameHost(): FrameHost;
 
-export { BrandBar, type BrandBarProps, BrandManifest, BrandProvider, DescriptorProvider, type DescriptorScope, type ElementErrorHandler, type ElementErrorInfo, type FrameHost, FrameHostProvider, GenerativePage, type GenerativePageProps, type PageRegistry, type ResultSlot, ResultSlotProvider, domIdFor, generativeRegistry, generativeRenderers, pathFromDomId, useBrand, useCheckedField, useDescriptorScope, useFrameHost, useResultSlot, useStoreSnapshot };
+export { BrandBar, type BrandBarProps, BrandManifest, BrandProvider, type CheckedField, DescriptorProvider, type DescriptorScope, type ElementErrorHandler, type ElementErrorInfo, type FrameHost, FrameHostProvider, GenerativePage, type GenerativePageProps, type PageRegistry, type ResultSlot, ResultSlotProvider, RevealPanel, domIdFor, generativeRegistry, generativeRenderers, pathFromDomId, useBrand, useCheckedField, useDescriptorScope, useFrameHost, useResultSlot, useStoreSnapshot };