@pipelex/mthds-ui 0.28.0 → 0.29.0

package/dist/static-graph/index.d.ts

@@ -1,8 +1,8 @@
-import { C as ConceptInfo, P as PipeBlueprintUnion, a as PresenceMarker, b as GraphSpec, V as ValidationIssue } from '../types-DvhUuMHz.js';
+import { C as ConceptInfo, P as PipeBlueprintUnion, a as PresenceMarker, b as GraphSpec, V as ValidationIssue } from '../types-BaFWy56P.js';
 export { P as ParsedPipeRef, m as makePipeRef, p as parsePipeRef } from '../pipeRefs-BQJO5nh5.js';
 
 type DiagnosticSeverity = "error" | "warning";
-type DiagnosticCode = "toml-parse-error" | "missing-domain" | "invalid-bundle-shape" | "invalid-concept-entry" | "invalid-pipe-entry" | "unknown-pipe-type" | "retired-signature-tag" | "invalid-concept-ref" | "unknown-input-slot-key" | "missing-pipe-output" | "invalid-sub-pipe" | "incomplete-batch-spec" | "duplicate-concept" | "duplicate-pipe" | "signature-type-mismatch" | "unresolved-pipe-ref" | "cyclic-pipe-ref" | "missing-main-pipe" | "no-entry-pipe" | "conflicting-input-concept";
+type DiagnosticCode = "toml-parse-error" | "missing-domain" | "invalid-bundle-shape" | "invalid-concept-entry" | "invalid-pipe-entry" | "unknown-pipe-type" | "retired-signature-tag" | "invalid-concept-ref" | "unknown-input-slot-key" | "invalid-input-name" | "missing-pipe-output" | "invalid-sub-pipe" | "invalid-binding-step" | "binding-path-unresolved" | "incomplete-batch-spec" | "duplicate-concept" | "duplicate-pipe" | "signature-type-mismatch" | "unresolved-pipe-ref" | "cyclic-pipe-ref" | "missing-main-pipe" | "no-entry-pipe" | "conflicting-input-concept";
 /**
  * A non-fatal note collected while parsing or merging. `error` means a whole
  * unit could not be interpreted (unparseable TOML, a skipped pipe); `warning`
@@ -28,6 +28,31 @@ interface Diagnostic {
      */
     domain_code?: string;
 }
+/**
+ * One field of a concept's declared structure, as the binding walk reads it:
+ * the four keys that decide what a path through the field reaches. A field
+ * written as a bare description string is a required text field, as pipelex
+ * reads that shorthand.
+ */
+interface StructureField {
+    /** The declared `type`, or null when the field declares none (a field defined by its `choices`). */
+    type: string | null;
+    /** `concept_ref` of a `concept` field, as authored. */
+    conceptRef: string | null;
+    /** `item_type` of a `list` field. */
+    itemType: string | null;
+    /** `item_concept_ref` of a list of concepts, as authored. */
+    itemConceptRef: string | null;
+}
+/**
+ * What a concept declares for its structure, beside its `ConceptInfo`: its
+ * fields in declaration order, or the name of the Python class a
+ * `structure = "ClassName"` string points at, which a bundle does not show. A
+ * concept declaring no structure has no entry. This is kept apart from
+ * `ConceptInfo` on purpose: `ConceptInfo` is what a GraphSpec's
+ * `concept_registry` carries, and a dry or live spec carries no such field.
+ */
+type ConceptStructure = Record<string, StructureField> | string;
 /**
  * One `.mthds` file, parsed and normalized. Pipes are narrowed to the same
  * `PipeBlueprintUnion` shapes the pipelex runtime serializes into GraphSpec
@@ -41,6 +66,8 @@ interface ParsedBundle {
     system_prompt: string | null;
     /** Concepts declared in this bundle, keyed by bare concept code. */
     concepts: Record<string, ConceptInfo>;
+    /** The structures those concepts declare, keyed by bare concept code — what a binding step walks. */
+    structures: Record<string, ConceptStructure>;
     /** Pipes declared in this bundle, keyed by bare pipe code. */
     pipes: Record<string, PipeBlueprintUnion>;
 }
@@ -48,10 +75,11 @@ interface ParseMthdsBundleResult {
     bundle: ParsedBundle;
     diagnostics: Diagnostic[];
 }
-/** Namespace of one domain after merging bundles: concepts and pipes by bare code. */
+/** Namespace of one domain after merging bundles: concepts, their structures and pipes by bare code. */
 interface DomainNamespace {
     domain: string;
     concepts: Record<string, ConceptInfo>;
+    structures: Record<string, ConceptStructure>;
     pipes: Record<string, PipeBlueprintUnion>;
 }
 /**
@@ -96,11 +124,6 @@ interface InputSlotParts {
     missingConcept: boolean;
     /** Keys of an expanded slot table this version of the standard does not define. */
     unknownKeys: string[];
-    /**
-     * True when the table is not a slot table at all but the wreckage of an
-     * unquoted dotted input name — see {@link looksLikeUnquotedDottedName}.
-     */
-    dottedName: boolean;
 }
 /**
  * Read one `inputs` value, whichever form authored it.
@@ -242,4 +265,4 @@ declare const MTHDS_SOURCES_EMBED_ID = "mthds-sources";
  */
 declare function serializeMthdsSourcesEmbed(sources: readonly MthdsSource[]): string;
 
-export { type ConceptRefParts, DEFAULT_BUNDLE_FILE_NAME, type Diagnostic, type DiagnosticCode, type DiagnosticSeverity, type DomainNamespace, type InputSlotParts, MTHDS_SOURCES_EMBED_ID, type MergedMethodSet, type MthdsSource, NATIVE_CONCEPT_CODES, NATIVE_DOMAIN, type ParseMthdsBundleResult, type ParsedBundle, type StaticGraphOptions, type StaticGraphResult, UNKNOWN_DOMAIN, buildStaticGraphSpec, buildStaticGraphSpecFromToml, hasTopLevelMainPipe, mergeBundles, orderMthdsSources, parseConceptRef, parseInputSlot, parseMthdsBundle, selectPrimaryMthdsSource, serializeMthdsSourcesEmbed, staticDiagnosticsToValidationIssues };
+export { type ConceptRefParts, type ConceptStructure, DEFAULT_BUNDLE_FILE_NAME, type Diagnostic, type DiagnosticCode, type DiagnosticSeverity, type DomainNamespace, type InputSlotParts, MTHDS_SOURCES_EMBED_ID, type MergedMethodSet, type MthdsSource, NATIVE_CONCEPT_CODES, NATIVE_DOMAIN, type ParseMthdsBundleResult, type ParsedBundle, type StaticGraphOptions, type StaticGraphResult, type StructureField, UNKNOWN_DOMAIN, buildStaticGraphSpec, buildStaticGraphSpecFromToml, hasTopLevelMainPipe, mergeBundles, orderMthdsSources, parseConceptRef, parseInputSlot, parseMthdsBundle, selectPrimaryMthdsSource, serializeMthdsSourcesEmbed, staticDiagnosticsToValidationIssues };