@vectoriox/iox-ui 5.46.0 → 5.47.0

package/generation-core/index.d.ts

@@ -23,7 +23,7 @@ declare const SPEC_SITE_PLAN_SHAPE: {
     readonly business: {
         readonly name: "string — the brand: the header, the hero, the copyright line";
         readonly "tagline?": "string — the hero lead and the footer line";
-        readonly "facts?": "{ [fact]: string } — facts (email, phone, city): only the customer's own words; a blank fact is a publish-blocking placeholder, never invented";
+        readonly "facts?": "{ [fact]: string } — facts (email, phone, city, address, hours): only the customer's own words; a blank fact is a publish-blocking placeholder, never invented";
     };
     readonly design: {
         readonly flavorId: "string — a v2 flavor pack id";
@@ -102,6 +102,8 @@ declare const SPEC_SITE_FACTS: {
     readonly email: "Email address";
     readonly phone: "Phone number";
     readonly city: "City or area";
+    readonly address: "Street address";
+    readonly hours: "Opening hours";
 };
 declare const SPEC_SITE_PATTERNS: {
     readonly "nav.inline-cta": {
@@ -1759,6 +1761,100 @@ declare const SPEC_SITE_TEMPLATES: {
         };
     };
 };
+declare const SPEC_SITE_LIBRARY: readonly [{
+    readonly id: "nav.inline-cta";
+    readonly family: "nav";
+}, {
+    readonly id: "nav.centered-logo";
+    readonly family: "nav";
+}, {
+    readonly id: "nav.overlay-menu";
+    readonly family: "nav";
+}, {
+    readonly id: "hero.split";
+    readonly family: "hero";
+}, {
+    readonly id: "hero.centered";
+    readonly family: "hero";
+}, {
+    readonly id: "hero.full-bleed-media";
+    readonly family: "hero";
+}, {
+    readonly id: "hero.stacked-editorial";
+    readonly family: "hero";
+}, {
+    readonly id: "proof.logo-strip";
+    readonly family: "proof";
+}, {
+    readonly id: "proof.stat-row";
+    readonly family: "proof";
+}, {
+    readonly id: "proof.testimonial-single";
+    readonly family: "proof";
+}, {
+    readonly id: "proof.testimonial-carousel";
+    readonly family: "proof";
+}, {
+    readonly id: "feature.triad";
+    readonly family: "feature";
+}, {
+    readonly id: "feature.alternating-rows";
+    readonly family: "feature";
+}, {
+    readonly id: "feature.icon-list";
+    readonly family: "feature";
+}, {
+    readonly id: "feature.tabbed";
+    readonly family: "feature";
+}, {
+    readonly id: "collection.card-grid";
+    readonly family: "collection";
+}, {
+    readonly id: "collection.masonry-gallery";
+    readonly family: "collection";
+}, {
+    readonly id: "collection.slider";
+    readonly family: "collection";
+}, {
+    readonly id: "collection.list-detail";
+    readonly family: "collection";
+}, {
+    readonly id: "story.long-form";
+    readonly family: "story";
+}, {
+    readonly id: "story.timeline";
+    readonly family: "story";
+}, {
+    readonly id: "story.quote-break";
+    readonly family: "story";
+}, {
+    readonly id: "cta.banner";
+    readonly family: "cta";
+}, {
+    readonly id: "cta.split-form";
+    readonly family: "cta";
+}, {
+    readonly id: "contact.split-map";
+    readonly family: "contact";
+}, {
+    readonly id: "contact.simple";
+    readonly family: "contact";
+}, {
+    readonly id: "faq.accordion";
+    readonly family: "faq";
+}, {
+    readonly id: "pricing.tiers";
+    readonly family: "pricing";
+}, {
+    readonly id: "footer.three-column";
+    readonly family: "footer";
+}, {
+    readonly id: "footer.mega";
+    readonly family: "footer";
+}, {
+    readonly id: "footer.minimal";
+    readonly family: "footer";
+}];
 
 /** What an untouched node of one registered type saves as (`NODE_BASELINES`, generated from the live
  *  iox-builder configs) — the builder serializer's flat `props` / `styleProps`, the trait names it has a
@@ -2190,6 +2286,51 @@ declare function setStyleProps(node: SerializedNode, values: Readonly<Record<str
 /** Every node of a tree, depth first. */
 declare function walkSerialized(nodes: ReadonlyArray<SerializedNode>, visit: (node: SerializedNode, ancestors: SerializedNode[]) => void, ancestors?: SerializedNode[]): void;
 
+/**
+ * The ONE way a framework-free gate refuses a document "with a path, never repairs" (W1's site-plan gate, the
+ * harness's analysis gate): a documented shape table (key → type text; `key?` optional, `[name]` the object's
+ * own field names) whose key lists the gate READS — so the shape a model is told about is the shape refused —
+ * and a collector that records each refusal at its dotted path. Generic over each gate's issue-code enum.
+ */
+type ShapeEntry = Readonly<Record<string, string>>;
+type PlainObject = Record<string, unknown>;
+/** Every fixed key an object of the shape may carry. */
+declare function shapeKeys(entry: ShapeEntry): string[];
+/** The keys an object of the shape must carry. */
+declare function requiredShapeKeys(entry: ShapeEntry): string[];
+declare const isPlainObject: (v: unknown) => v is PlainObject;
+declare const isNonEmptyString: (v: unknown) => v is string;
+/** `path.key`, or `key` at the root. */
+declare const pathAt: (path: string, key: string) => string;
+interface PathIssue<C extends string> {
+    code: C;
+    /** Where, as a dotted path into the document (`pages[2].sections[0].binding`). */
+    path: string;
+    message: string;
+}
+/** The three refusals every shape gate shares, named in that gate's own code enum. */
+interface ShapeIssueCodes<C extends string> {
+    /** A value of the wrong type, or a required value missing. */
+    shape: C;
+    /** A key the shape does not have. */
+    unknownKey: C;
+    /** A name used twice where it must be unique. */
+    duplicate: C;
+}
+declare class PathIssueCollector<C extends string> {
+    private readonly subject;
+    private readonly codes;
+    readonly issues: PathIssue<C>[];
+    /** `subject` names the document in a refusal ("… is not part of the plan shape"). */
+    constructor(subject: string, codes: ShapeIssueCodes<C>);
+    add(code: C, path: string, message: string): void;
+    keys(obj: PlainObject, allowed: ReadonlyArray<string>, path: string): void;
+    string(obj: PlainObject, key: string, path: string, required?: boolean): string | null;
+    boolean(obj: PlainObject, key: string, path: string): void;
+    array(obj: PlainObject, key: string, path: string): unknown[];
+    unique(values: Array<string | null>, path: (i: number) => string, what: string): void;
+}
+
 /**
  * The Site Plan validator — the gate in front of the composer. The wizard's plan and (later) the AI's
  * plan go through the SAME checks: an unknown pattern, a slot the pattern does not declare, a source
@@ -2225,12 +2366,7 @@ declare enum SitePlanIssueCode {
      *  its alt text. */
     MissingPreviewField = "missing-preview-field"
 }
-interface SitePlanIssue {
-    code: SitePlanIssueCode;
-    /** Where, as a dotted path into the plan (`pages[2].sections[0].binding`). */
-    path: string;
-    message: string;
-}
+type SitePlanIssue = PathIssue<SitePlanIssueCode>;
 interface SitePlanValidation {
     valid: boolean;
     issues: SitePlanIssue[];
@@ -2239,14 +2375,6 @@ declare class SitePlanError extends Error {
     readonly issues: ReadonlyArray<SitePlanIssue>;
     constructor(issues: ReadonlyArray<SitePlanIssue>);
 }
-/** The documented plan shape (contract `site.planShape`): key → type; a key ending in `?` is optional and
- *  a `[name]` key stands for the object's own field names. The key lists below are READ from it, so a
- *  key the plan documents is a key the gate validates — and an undocumented one is refused. */
-type ShapeEntry = Readonly<Record<string, string>>;
-/** Every fixed key an object of the shape may carry. */
-declare function shapeKeys(entry: ShapeEntry): string[];
-/** The keys an object of the shape must carry. */
-declare function requiredShapeKeys(entry: ShapeEntry): string[];
 /** The `:param` names of a route, in order. */
 declare function routeParams(route: string): string[];
 /** The plan's `$siblings.next` source of `routeSource` — what a pattern's `next.*` reads. */
@@ -2581,5 +2709,5 @@ declare function removeBarItem(globals: ReadonlyArray<SerializedNode>, itemId: s
 /** The bar's Items list drag-to-reorder (board 2): item `from` moves to `to`. Input not mutated. */
 declare function moveBarItem(globals: ReadonlyArray<SerializedNode>, from: number, to: number): BarItemsEditResult;
 
-export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavPagesSource, NavRole, NavShape, NavShapeError, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, composeNavHeader, composeSection, composeSite, createSerializedNode, findNavRoot, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planFromTemplate, planNavShape, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, siteNavPages, validateSitePlan, walkSerialized };
-export type { AddBarItemResult, BarItemsEditResult, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, DataSourcePlan, FactKey, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PagePlan, PageSectionPlan, PatternNode, RelativeDataSourcePlan, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, SiteBusiness, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };
+export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavPagesSource, NavRole, NavShape, NavShapeError, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, composeNavHeader, composeSection, composeSite, createSerializedNode, findNavRoot, isNonEmptyString, isPlainObject, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planFromTemplate, planNavShape, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, siteNavPages, validateSitePlan, walkSerialized };
+export type { AddBarItemResult, BarItemsEditResult, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, DataSourcePlan, FactKey, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PagePlan, PageSectionPlan, PathIssue, PatternNode, PlainObject, RelativeDataSourcePlan, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, SiteBusiness, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };