@sankhyatronics/sankhya-cms 0.0.0-stage → 0.0.9

package/dist/index.js

@@ -0,0 +1,93 @@
+import {
+  Testimonials
+} from "./chunk-WCO7JAIK.js";
+import {
+  MenuGridItem
+} from "./chunk-4HKSA5UT.js";
+import {
+  MenuItem
+} from "./chunk-LHU23TF6.js";
+import {
+  PromoBanner
+} from "./chunk-3ERKQNZT.js";
+import {
+  Select
+} from "./chunk-5UFRGZWG.js";
+import {
+  Stats
+} from "./chunk-USNFT4DU.js";
+import {
+  FeatureItem,
+  FeaturesSection
+} from "./chunk-E52WO7R7.js";
+import {
+  Footer
+} from "./chunk-YYK4GQUW.js";
+import {
+  Header
+} from "./chunk-23IHTBAB.js";
+import "./chunk-3TCP25JG.js";
+import {
+  Hero
+} from "./chunk-TIU73O7I.js";
+import {
+  IconButton
+} from "./chunk-XXPBFHWR.js";
+import {
+  ItemsAccordion
+} from "./chunk-74MILER4.js";
+import {
+  MenuGrid
+} from "./chunk-VYON56QO.js";
+import {
+  BentoGrid
+} from "./chunk-OEX5FDMR.js";
+import {
+  Card
+} from "./chunk-7PSYCTEN.js";
+import {
+  Carousel
+} from "./chunk-XHBC23TV.js";
+import {
+  ContentBlock
+} from "./chunk-IMACP7HN.js";
+import {
+  CookieConsent
+} from "./chunk-2VZFHTBC.js";
+import {
+  Dropdown
+} from "./chunk-RMIJVTFS.js";
+import {
+  FeatureSplit
+} from "./chunk-5REZSZCK.js";
+import {
+  Markdown
+} from "./chunk-3JU3R22O.js";
+import "./chunk-3VE6VFJ4.js";
+import "./chunk-RHAOQ6K4.js";
+import "./chunk-EUXUH3YW.js";
+export {
+  BentoGrid,
+  Card,
+  Carousel,
+  ContentBlock,
+  CookieConsent,
+  Dropdown,
+  FeatureItem,
+  FeatureSplit,
+  FeaturesSection,
+  Footer,
+  Header,
+  Hero,
+  IconButton,
+  ItemsAccordion,
+  Markdown,
+  MenuGrid,
+  MenuGridItem,
+  MenuItem,
+  PromoBanner,
+  Select,
+  Stats,
+  Testimonials
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/items-accordion/index.d.ts

@@ -0,0 +1,31 @@
+import * as lit from 'lit';
+import { LitElement } from 'lit';
+
+interface AccordionItem {
+    id: string;
+    title: string;
+    content: string;
+}
+/** A vertical list of collapsible title/content rows; one open at a time unless `allow-multiple`. */
+declare class ItemsAccordion extends LitElement {
+    static styles: lit.CSSResult;
+    title: string;
+    subtitle: string;
+    items: AccordionItem[];
+    allowMultiple: boolean;
+    private openIds;
+    private toggle;
+    render(): lit.TemplateResult<1>;
+}
+
+interface AccordionToggleEventDetail {
+    id: string;
+    open: boolean;
+}
+declare global {
+    interface HTMLElementEventMap {
+        'accordion-toggle': CustomEvent<AccordionToggleEventDetail>;
+    }
+}
+
+export { type AccordionItem, type AccordionToggleEventDetail, ItemsAccordion };

package/dist/items-accordion/index.js

@@ -0,0 +1,10 @@
+import {
+  ItemsAccordion
+} from "../chunk-74MILER4.js";
+import "../chunk-3VE6VFJ4.js";
+import "../chunk-RHAOQ6K4.js";
+import "../chunk-EUXUH3YW.js";
+export {
+  ItemsAccordion
+};
+//# sourceMappingURL=index.js.map

package/dist/items-accordion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/markdown/index.d.ts

@@ -0,0 +1,33 @@
+import * as lit from 'lit';
+import { LitElement, nothing } from 'lit';
+
+/**
+ * Renders Markdown (GFM, single newlines become `<br>`) from either an inline `content` string or
+ * a `src` URL it fetches. Ports `SankhyaUI`'s `useMarkdown` hook + `react-markdown` (remark-gfm,
+ * remark-breaks); output is sanitized with DOMPurify. `src` wins over `content` when both are set.
+ * While a fetch is pending it shows "Loading content..."; on failure "Error loading content." and
+ * a `markdown-error` event (detail: `{ error }`).
+ *
+ * Text color is inherited from the parent so inverted containers just work.
+ */
+declare class Markdown extends LitElement {
+    static styles: lit.CSSResult;
+    /** Inline Markdown source. Ignored when `src` is set. */
+    content: string;
+    /** URL of a Markdown file to fetch. */
+    src: string;
+    private fetched;
+    private loading;
+    private error;
+    private abort?;
+    willUpdate(changed: Map<string, unknown>): void;
+    disconnectedCallback(): void;
+    private load;
+    render(): lit.TemplateResult<1> | typeof nothing;
+}
+
+interface MarkdownErrorEventDetail {
+    error: Error;
+}
+
+export { Markdown, type MarkdownErrorEventDetail };

package/dist/markdown/index.js

@@ -0,0 +1,9 @@
+import {
+  Markdown
+} from "../chunk-3JU3R22O.js";
+import "../chunk-RHAOQ6K4.js";
+import "../chunk-EUXUH3YW.js";
+export {
+  Markdown
+};
+//# sourceMappingURL=index.js.map

package/dist/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/menu-grid/index.d.ts

@@ -0,0 +1,21 @@
+import * as lit from 'lit';
+import { LitElement } from 'lit';
+
+/**
+ * A responsive grid of `st-menu-grid-item`s — the "rich" nav-menu layout (icon + title +
+ * description per entry, arranged in columns), typically slotted into `st-dropdown`'s default
+ * slot. A 1:1 port of `SankhyaUI`'s React `MenuGrid` (`SankhyaCMS/SankhyaUI/src/components/Menu`):
+ * same markup (`.menu-grid-container` > `.menu-grid.columns-N`), gap and breakpoints (768px: 2–4
+ * columns → 2; 480px: everything → 1; a 1-column grid stays 1).
+ */
+declare class MenuGrid extends LitElement {
+    static styles: lit.CSSResult;
+    /** Number of columns at full width (1–4, same as the source component's `columns-N` classes). */
+    columns: number;
+    /** Extra class(es) appended to the inner grid element — the source component's `gridClassName`.
+     * Its outer `className` is the host element itself here: set a `class` attribute on `st-menu-grid`. */
+    gridClassName: string;
+    render(): lit.TemplateResult<1>;
+}
+
+export { MenuGrid };

package/dist/menu-grid/index.js

@@ -0,0 +1,9 @@
+import {
+  MenuGrid
+} from "../chunk-VYON56QO.js";
+import "../chunk-RHAOQ6K4.js";
+import "../chunk-EUXUH3YW.js";
+export {
+  MenuGrid
+};
+//# sourceMappingURL=index.js.map

package/dist/menu-grid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/menu-grid-item/index.d.ts

@@ -0,0 +1,53 @@
+import * as lit from 'lit';
+import { LitElement } from 'lit';
+
+/**
+ * One entry in an `st-menu-grid` — icon (via `slot="icon"`) + title on one line, an optional
+ * description below, and an optional corner badge ("New", "Popular", ...). A 1:1 port of
+ * `SankhyaUI`'s React `MenuGridItem` (`SankhyaCMS/SankhyaUI/src/components/Menu`): same markup and
+ * CSS, with its `motion` effects redone in CSS — fades up the first time it scrolls into view,
+ * scales to 1.02 on hover / 0.98 while pressed, the icon tilts on hover, the badge pops in.
+ * Colors come from the suite theme rather than per-item utility classes.
+ *
+ * An `http(s)` `href` opens in a new tab, like the source. Any other `href` fires a *cancelable*
+ * `menu-grid-item-select` event (detail: `{ href }`) first: a host doing client-side routing calls
+ * `event.preventDefault()` on it, which also cancels the anchor's own navigation (the source used
+ * react-router's `Link` here; the suite apps have no router).
+ */
+declare class MenuGridItem extends LitElement {
+    /** `focus()` on the element focuses its link, so `st-dropdown` can arrow-key between items. */
+    static shadowRootOptions: {
+        delegatesFocus: boolean;
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry | null;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    static styles: lit.CSSResult;
+    title: string;
+    description: string;
+    href: string;
+    /** Small corner label, e.g. "New"/"Beta" — omit for none. */
+    badge: string;
+    compact: boolean;
+    /** Suppresses the description even when `description` is set (source: `showDescription`, default `true`). */
+    showDescription: boolean;
+    /** Whether `slot="icon"` has content, so an omitted icon leaves no empty box. */
+    private hasIcon;
+    /** True until the item first scrolls into view (the source's `whileInView ... once`). */
+    private pending;
+    private observer?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private onIconSlotChange;
+    private get isExternal();
+    private onClick;
+    render(): lit.TemplateResult<1>;
+}
+
+interface MenuGridItemSelectEventDetail {
+    href: string;
+}
+
+export { MenuGridItem, type MenuGridItemSelectEventDetail };

package/dist/menu-grid-item/index.js

@@ -0,0 +1,9 @@
+import {
+  MenuGridItem
+} from "../chunk-4HKSA5UT.js";
+import "../chunk-RHAOQ6K4.js";
+import "../chunk-EUXUH3YW.js";
+export {
+  MenuGridItem
+};
+//# sourceMappingURL=index.js.map

package/dist/menu-grid-item/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/menu-item/index.d.ts

@@ -0,0 +1,50 @@
+import * as lit from 'lit';
+import { LitElement } from 'lit';
+
+/**
+ * A single flat nav row — icon (`slot="icon"`) + title + badge on one line, an optional
+ * description below — as opposed to `st-menu-grid-item`'s card for a multi-column grid. A 1:1
+ * port of `SankhyaUI`'s React `MenuItem` (`SankhyaCMS/SankhyaUI/src/components/Menu`): same
+ * markup and CSS, with its `motion` effects redone in CSS — nudges right and scales to 1.01 on
+ * hover / 0.99 while pressed, the icon tilts on hover, the badge pops in, the description fades
+ * in. Colors come from the suite theme rather than per-item utility classes.
+ *
+ * Renders a real `<a href>` but fires a *cancelable* `menu-item-select` event (detail: `{ href }`)
+ * before navigating — a host doing client-side routing calls `event.preventDefault()` on it (the
+ * source used react-router's `Link` here; the suite apps have no router).
+ */
+declare class MenuItem extends LitElement {
+    /** `focus()` on the element focuses its link, so `st-dropdown` can arrow-key between items. */
+    static shadowRootOptions: {
+        delegatesFocus: boolean;
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry | null;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    static styles: lit.CSSResult;
+    title: string;
+    href: string;
+    description: string;
+    /** Small trailing label, e.g. a count or "New"/"Beta" — omit for none. */
+    badge: string;
+    /** Highlights this row as the current page (source: `isActive`). */
+    active: boolean;
+    compact: boolean;
+    /** Suppresses the description even when `description` is set (source: `showDescription`, default `true`). */
+    showDescription: boolean;
+    /** `target` for the `<a>` (source default `_self`). */
+    target: string;
+    /** Whether `slot="icon"` has content, so an omitted icon leaves no empty box. */
+    private hasIcon;
+    private onIconSlotChange;
+    private onClick;
+    render(): lit.TemplateResult<1>;
+}
+
+interface MenuItemSelectEventDetail {
+    href: string;
+}
+
+export { MenuItem, type MenuItemSelectEventDetail };

package/dist/menu-item/index.js

@@ -0,0 +1,9 @@
+import {
+  MenuItem
+} from "../chunk-LHU23TF6.js";
+import "../chunk-RHAOQ6K4.js";
+import "../chunk-EUXUH3YW.js";
+export {
+  MenuItem
+};
+//# sourceMappingURL=index.js.map

package/dist/menu-item/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/promo-banner/index.d.ts

@@ -0,0 +1,22 @@
+import * as lit from 'lit';
+import { LitElement } from 'lit';
+
+/**
+ * Rounded call-to-action banner (title, subtitle, one outlined button) on a dark panel or a
+ * background image. Port of `SankhyaUI`'s React `PromoBanner`; the button fires an `action` event
+ * (detail `{ href }`, empty unless set) in place of `onAction`.
+ */
+declare class PromoBanner extends LitElement {
+    static styles: lit.CSSResult;
+    title: string;
+    subtitle: string;
+    actionLabel: string;
+    href: string;
+    imageSrc: string;
+    inverted: boolean;
+    protected willUpdate(): void;
+    private onAction;
+    render(): lit.TemplateResult<1>;
+}
+
+export { PromoBanner };

package/dist/promo-banner/index.js

@@ -0,0 +1,10 @@
+import {
+  PromoBanner
+} from "../chunk-3ERKQNZT.js";
+import "../chunk-3VE6VFJ4.js";
+import "../chunk-RHAOQ6K4.js";
+import "../chunk-EUXUH3YW.js";
+export {
+  PromoBanner
+};
+//# sourceMappingURL=index.js.map

package/dist/promo-banner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/schema/index.d.ts

@@ -0,0 +1,72 @@
+/** Dependency-free node types, safe to import from the content API layer. */
+/** Action reference in JSON, resolved against the `handlers` prop of `DynamicRenderer`. */
+type ActionRef = `@action:${string}`;
+/** Keys the renderer owns; everything else on a node is passed to the component as a prop. */
+interface NodeEnvelope<TNode> {
+    id?: string;
+    /** Named slot in the parent (e.g. Header: "utility"). Omit for the default slot. */
+    slot?: string;
+    /** Editor-only label, never passed to the component. */
+    label?: string;
+    children?: TNode[];
+}
+/**
+ * A node as it appears in JSON: flat, no `data` wrapper.
+ * `{ "type": "Hero", "id": "home-hero", "title": "...", "children": [...] }`
+ */
+interface ComponentNode extends NodeEnvelope<ComponentNode> {
+    type: string;
+    [prop: string]: unknown;
+}
+/** A page is a list of nodes. */
+type PageContent = ComponentNode[];
+declare function isComponentNode(value: unknown): value is ComponentNode;
+
+/**
+ * Returns a copy of `nodes` where the node with the given `id` has `props` merged in.
+ * Use it to inject runtime state (e.g. the selected language) into fetched JSON without mutating it.
+ */
+declare function patchNodeById(nodes: ComponentNode[], id: string, props: Record<string, unknown>): ComponentNode[];
+
+/**
+ * The JSON `type` of every base component, and the Lit element that renders it.
+ * This is the contract page JSON is written against — renderers (React, or any other binding)
+ * map each `type` to their own component for that element.
+ */
+declare const componentTags: {
+    readonly BentoGrid: "st-bento-grid";
+    readonly Card: "st-card";
+    readonly Carousel: "st-carousel";
+    readonly ContentBlock: "st-content-block";
+    readonly CookieConsent: "st-cookie-consent";
+    readonly Dropdown: "st-dropdown";
+    readonly FeatureItem: "st-feature-item";
+    readonly FeatureSplit: "st-feature-split";
+    readonly FeaturesSection: "st-features-section";
+    readonly Footer: "st-footer";
+    readonly Header: "st-header";
+    readonly Hero: "st-hero";
+    readonly IconButton: "st-icon-button";
+    readonly ItemsAccordion: "st-items-accordion";
+    readonly MenuGrid: "st-menu-grid";
+    readonly MenuGridItem: "st-menu-grid-item";
+    readonly MenuItem: "st-menu-item";
+    readonly PromoBanner: "st-promo-banner";
+    readonly Select: "st-select";
+    readonly Stats: "st-stats";
+    readonly Testimonials: "st-testimonials";
+};
+/** Every `type` the base set knows. */
+type ComponentType = keyof typeof componentTags;
+declare function isBaseComponentType(type: string): type is ComponentType;
+
+/**
+ * Returns the schema violations for a node and its descendants (empty when valid).
+ * `isKnownType` defaults to the base component set; pass a wider predicate when a renderer also
+ * registers custom components.
+ */
+declare function validateNode(node: unknown, where?: string, isKnownType?: (type: string) => boolean): string[];
+/** Validates a page: a node or a list of nodes. */
+declare function validatePage(page: unknown, isKnownType?: (type: string) => boolean): string[];
+
+export { type ActionRef, type ComponentNode, type ComponentType, type NodeEnvelope, type PageContent, componentTags, isBaseComponentType, isComponentNode, patchNodeById, validateNode, validatePage };

package/dist/schema/index.js

@@ -0,0 +1,75 @@
+import "../chunk-EUXUH3YW.js";
+
+// src/schema/node.ts
+function isComponentNode(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && typeof value.type === "string" && value.type.trim().length > 0;
+}
+
+// src/schema/nodeUtils.ts
+function patchNodeById(nodes, id, props) {
+  return nodes.map((node) => {
+    const patched = node.id === id ? { ...node, ...props } : node;
+    return patched.children ? { ...patched, children: patchNodeById(patched.children, id, props) } : patched;
+  });
+}
+
+// src/schema/components.ts
+var componentTags = {
+  BentoGrid: "st-bento-grid",
+  Card: "st-card",
+  Carousel: "st-carousel",
+  ContentBlock: "st-content-block",
+  CookieConsent: "st-cookie-consent",
+  Dropdown: "st-dropdown",
+  FeatureItem: "st-feature-item",
+  FeatureSplit: "st-feature-split",
+  FeaturesSection: "st-features-section",
+  Footer: "st-footer",
+  Header: "st-header",
+  Hero: "st-hero",
+  IconButton: "st-icon-button",
+  ItemsAccordion: "st-items-accordion",
+  MenuGrid: "st-menu-grid",
+  MenuGridItem: "st-menu-grid-item",
+  MenuItem: "st-menu-item",
+  PromoBanner: "st-promo-banner",
+  Select: "st-select",
+  Stats: "st-stats",
+  Testimonials: "st-testimonials"
+};
+function isBaseComponentType(type) {
+  return Object.hasOwn(componentTags, type);
+}
+
+// src/schema/validate.ts
+var LEGACY_KEYS = ["data", "embeddedView", "data-position", "image", "contentUrl"];
+function validateNode(node, where = "node", isKnownType = isBaseComponentType) {
+  if (typeof node !== "object" || node === null || Array.isArray(node)) return [`${where}: node must be an object`];
+  const n = node;
+  const found = [];
+  if (typeof n.type !== "string" || !isKnownType(n.type)) found.push(`${where}: unknown type "${String(n.type)}"`);
+  for (const legacy of LEGACY_KEYS) {
+    if (legacy in n) found.push(`${where}: legacy key "${legacy}"`);
+  }
+  if (Array.isArray(n.items) && n.items.some((item) => typeof item === "object" && item !== null && "type" in item)) {
+    found.push(`${where}: "items" must hold plain data; nest components under "children"`);
+  }
+  if (n.children !== void 0) {
+    if (!Array.isArray(n.children)) found.push(`${where}: children must be an array`);
+    else n.children.forEach((child, i) => found.push(...validateNode(child, `${where}.children[${i}]`, isKnownType)));
+  }
+  return found;
+}
+function validatePage(page, isKnownType) {
+  const nodes = Array.isArray(page) ? page : [page];
+  return nodes.flatMap((node, i) => validateNode(node, `[${i}]`, isKnownType));
+}
+export {
+  componentTags,
+  isBaseComponentType,
+  isComponentNode,
+  patchNodeById,
+  validateNode,
+  validatePage
+};
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schema/node.ts","../../src/schema/nodeUtils.ts","../../src/schema/components.ts","../../src/schema/validate.ts"],"sourcesContent":["/** Dependency-free node types, safe to import from the content API layer. */\r\n\r\n/** Action reference in JSON, resolved against the `handlers` prop of `DynamicRenderer`. */\r\nexport type ActionRef = `@action:${string}`;\r\n\r\n/** Keys the renderer owns; everything else on a node is passed to the component as a prop. */\r\nexport interface NodeEnvelope<TNode> {\r\n    id?: string;\r\n    /** Named slot in the parent (e.g. Header: \"utility\"). Omit for the default slot. */\r\n    slot?: string;\r\n    /** Editor-only label, never passed to the component. */\r\n    label?: string;\r\n    children?: TNode[];\r\n}\r\n\r\n/**\r\n * A node as it appears in JSON: flat, no `data` wrapper.\r\n * `{ \"type\": \"Hero\", \"id\": \"home-hero\", \"title\": \"...\", \"children\": [...] }`\r\n */\r\nexport interface ComponentNode extends NodeEnvelope<ComponentNode> {\r\n    type: string;\r\n    [prop: string]: unknown;\r\n}\r\n\r\n/** A page is a list of nodes. */\r\nexport type PageContent = ComponentNode[];\r\n\r\nexport function isComponentNode(value: unknown): value is ComponentNode {\r\n    return (\r\n        typeof value === 'object' &&\r\n        value !== null &&\r\n        !Array.isArray(value) &&\r\n        typeof (value as { type?: unknown }).type === 'string' &&\r\n        (value as { type: string }).type.trim().length > 0\r\n    );\r\n}\r\n","import type { ComponentNode } from './node';\n\n/**\n * Returns a copy of `nodes` where the node with the given `id` has `props` merged in.\n * Use it to inject runtime state (e.g. the selected language) into fetched JSON without mutating it.\n */\nexport function patchNodeById(nodes: ComponentNode[], id: string, props: Record<string, unknown>): ComponentNode[] {\n    return nodes.map(node => {\n        const patched = node.id === id ? { ...node, ...props } : node;\n        return patched.children\n            ? { ...patched, children: patchNodeById(patched.children, id, props) }\n            : patched;\n    });\n}\n","/**\n * The JSON `type` of every base component, and the Lit element that renders it.\n * This is the contract page JSON is written against — renderers (React, or any other binding)\n * map each `type` to their own component for that element.\n */\nexport const componentTags = {\n    BentoGrid: 'st-bento-grid',\n    Card: 'st-card',\n    Carousel: 'st-carousel',\n    ContentBlock: 'st-content-block',\n    CookieConsent: 'st-cookie-consent',\n    Dropdown: 'st-dropdown',\n    FeatureItem: 'st-feature-item',\n    FeatureSplit: 'st-feature-split',\n    FeaturesSection: 'st-features-section',\n    Footer: 'st-footer',\n    Header: 'st-header',\n    Hero: 'st-hero',\n    IconButton: 'st-icon-button',\n    ItemsAccordion: 'st-items-accordion',\n    MenuGrid: 'st-menu-grid',\n    MenuGridItem: 'st-menu-grid-item',\n    MenuItem: 'st-menu-item',\n    PromoBanner: 'st-promo-banner',\n    Select: 'st-select',\n    Stats: 'st-stats',\n    Testimonials: 'st-testimonials'\n} as const;\n\n/** Every `type` the base set knows. */\nexport type ComponentType = keyof typeof componentTags;\n\nexport function isBaseComponentType(type: string): type is ComponentType {\n    return Object.hasOwn(componentTags, type);\n}\n","import { isBaseComponentType } from './components';\nimport type { ComponentNode } from './node';\n\n/** Keys from the pre-flat schema; their presence means the JSON still needs `scripts/migrate-json.mjs`. */\nconst LEGACY_KEYS = ['data', 'embeddedView', 'data-position', 'image', 'contentUrl'] as const;\n\n/**\n * Returns the schema violations for a node and its descendants (empty when valid).\n * `isKnownType` defaults to the base component set; pass a wider predicate when a renderer also\n * registers custom components.\n */\nexport function validateNode(node: unknown, where = 'node', isKnownType: (type: string) => boolean = isBaseComponentType): string[] {\n    if (typeof node !== 'object' || node === null || Array.isArray(node)) return [`${where}: node must be an object`];\n    const n = node as ComponentNode;\n    const found: string[] = [];\n    if (typeof n.type !== 'string' || !isKnownType(n.type)) found.push(`${where}: unknown type \"${String(n.type)}\"`);\n    for (const legacy of LEGACY_KEYS) {\n        if (legacy in n) found.push(`${where}: legacy key \"${legacy}\"`);\n    }\n    if (Array.isArray(n.items) && n.items.some(item => typeof item === 'object' && item !== null && 'type' in item)) {\n        found.push(`${where}: \"items\" must hold plain data; nest components under \"children\"`);\n    }\n    if (n.children !== undefined) {\n        if (!Array.isArray(n.children)) found.push(`${where}: children must be an array`);\n        else n.children.forEach((child, i) => found.push(...validateNode(child, `${where}.children[${i}]`, isKnownType)));\n    }\n    return found;\n}\n\n/** Validates a page: a node or a list of nodes. */\nexport function validatePage(page: unknown, isKnownType?: (type: string) => boolean): string[] {\n    const nodes = Array.isArray(page) ? page : [page];\n    return nodes.flatMap((node, i) => validateNode(node, `[${i}]`, isKnownType));\n}\n"],"mappings":";;;AA2BO,SAAS,gBAAgB,OAAwC;AACpE,SACI,OAAO,UAAU,YACjB,UAAU,QACV,CAAC,MAAM,QAAQ,KAAK,KACpB,OAAQ,MAA6B,SAAS,YAC7C,MAA2B,KAAK,KAAK,EAAE,SAAS;AAEzD;;;AC7BO,SAAS,cAAc,OAAwB,IAAY,OAAiD;AAC/G,SAAO,MAAM,IAAI,UAAQ;AACrB,UAAM,UAAU,KAAK,OAAO,KAAK,EAAE,GAAG,MAAM,GAAG,MAAM,IAAI;AACzD,WAAO,QAAQ,WACT,EAAE,GAAG,SAAS,UAAU,cAAc,QAAQ,UAAU,IAAI,KAAK,EAAE,IACnE;AAAA,EACV,CAAC;AACL;;;ACRO,IAAM,gBAAgB;AAAA,EACzB,WAAW;AAAA,EACX,MAAM;AAAA,EACN,UAAU;AAAA,EACV,cAAc;AAAA,EACd,eAAe;AAAA,EACf,UAAU;AAAA,EACV,aAAa;AAAA,EACb,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,cAAc;AAAA,EACd,UAAU;AAAA,EACV,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,cAAc;AAClB;AAKO,SAAS,oBAAoB,MAAqC;AACrE,SAAO,OAAO,OAAO,eAAe,IAAI;AAC5C;;;AC9BA,IAAM,cAAc,CAAC,QAAQ,gBAAgB,iBAAiB,SAAS,YAAY;AAO5E,SAAS,aAAa,MAAe,QAAQ,QAAQ,cAAyC,qBAA+B;AAChI,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,IAAI,EAAG,QAAO,CAAC,GAAG,KAAK,0BAA0B;AAChH,QAAM,IAAI;AACV,QAAM,QAAkB,CAAC;AACzB,MAAI,OAAO,EAAE,SAAS,YAAY,CAAC,YAAY,EAAE,IAAI,EAAG,OAAM,KAAK,GAAG,KAAK,mBAAmB,OAAO,EAAE,IAAI,CAAC,GAAG;AAC/G,aAAW,UAAU,aAAa;AAC9B,QAAI,UAAU,EAAG,OAAM,KAAK,GAAG,KAAK,iBAAiB,MAAM,GAAG;AAAA,EAClE;AACA,MAAI,MAAM,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,KAAK,UAAQ,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU,IAAI,GAAG;AAC7G,UAAM,KAAK,GAAG,KAAK,kEAAkE;AAAA,EACzF;AACA,MAAI,EAAE,aAAa,QAAW;AAC1B,QAAI,CAAC,MAAM,QAAQ,EAAE,QAAQ,EAAG,OAAM,KAAK,GAAG,KAAK,6BAA6B;AAAA,QAC3E,GAAE,SAAS,QAAQ,CAAC,OAAO,MAAM,MAAM,KAAK,GAAG,aAAa,OAAO,GAAG,KAAK,aAAa,CAAC,KAAK,WAAW,CAAC,CAAC;AAAA,EACpH;AACA,SAAO;AACX;AAGO,SAAS,aAAa,MAAe,aAAmD;AAC3F,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAChD,SAAO,MAAM,QAAQ,CAAC,MAAM,MAAM,aAAa,MAAM,IAAI,CAAC,KAAK,WAAW,CAAC;AAC/E;","names":[]}

package/dist/select/index.d.ts

@@ -0,0 +1,77 @@
+import * as lit from 'lit';
+import { LitElement, PropertyValues } from 'lit';
+
+interface SelectChangedEventDetail {
+    value: string;
+}
+interface SelectOption {
+    value: string;
+    label: string;
+    /** Optional web URL this option points to (e.g. a SharePoint library) — set when a consumer wants to link out to it, such as a breadcrumb's first crumb. */
+    url?: string;
+}
+
+/**
+ * A fully custom-styled replacement for native `<select>`, used everywhere
+ * the wizard needs a single-choice dropdown (template source, list, document
+ * library, admin roles, ...).
+ *
+ * Built on the CSS Customizable Select API (`appearance: base-select`) —
+ * still a real `<select>`/`<option>` element tree, so focus, keyboard
+ * (arrows/Home/End/typeahead), and ARIA all come from the browser for free,
+ * but the trigger (`<button>`/`<selectedcontent>`) and popup
+ * (`::picker(select)`) are fully styleable instead of OS-rendered. Chromium
+ * only for now (Firefox/Safari fall back to an unstyled native `<select>` —
+ * the extra `<button>`/`<selectedcontent>` markup is simply not rendered by
+ * browsers that don't support the parsing/CSS additions, so the control
+ * still works there, just without the custom look).
+ *
+ * `options` intentionally has no "unselected" placeholder entry — set
+ * `value=""` (or any value with no matching option) and it falls back to
+ * showing `placeholder` in the trigger instead, letting callers swap the
+ * placeholder text dynamically (e.g. "Select a list" vs "Select a list
+ * first") without needing a synthetic option in the list. Internally this is
+ * a real hidden/disabled `<option value="">`, since a native `<select>`
+ * always has *some* option selected.
+ *
+ * Fires `select-change` (detail: `{ value }`) only when the value actually
+ * changes, matching native `<select>`'s `change` event semantics.
+ *
+ * `link-href` optionally renders an external-link button in front of
+ * `field-label` — the same glyph/placement as the "open library" links
+ * placed next to the Templates/Save-location breadcrumbs — for callers that
+ * want a one-click way to open whatever the current selection points at
+ * (e.g. the SharePoint site or library) in a new tab.
+ */
+declare class Select extends LitElement {
+    static styles: lit.CSSResult;
+    options: SelectOption[];
+    value: string;
+    placeholder: string;
+    /** Renders an internal `<label>` above the trigger, associated via `aria-labelledby`. Leave empty when the field is labeled some other way (e.g. context alone). */
+    fieldLabel: string;
+    /**
+     * Optional URL for an external-link button rendered in front of
+     * `field-label` (same glyph/placement as the "open library" links next to
+     * the Templates/Save-location breadcrumbs) — e.g. a link to the
+     * SharePoint site or library the current selection points at. Ignored
+     * when `field-label` is empty, since there'd be nothing to place it in
+     * front of.
+     */
+    linkHref: string;
+    /** Accessible name/title for the `link-href` button. */
+    linkLabel: string;
+    /** Accessible name for the trigger when there's no visible `field-label` (e.g. a filter-row select). Ignored when `field-label` is set. */
+    selectLabel: string;
+    disabled: boolean;
+    /** Borderless variant for a header/toolbar utility slot — see the `:host([ghost])` styles. */
+    ghost: boolean;
+    private readonly selectEl;
+    private readonly instanceId;
+    private readonly fieldLabelId;
+    protected updated(changed: PropertyValues): void;
+    render(): lit.TemplateResult<1>;
+    private onChange;
+}
+
+export { Select, type SelectChangedEventDetail, type SelectOption };

package/dist/select/index.js

@@ -0,0 +1,10 @@
+import {
+  Select
+} from "../chunk-5UFRGZWG.js";
+import "../chunk-3TCP25JG.js";
+import "../chunk-RHAOQ6K4.js";
+import "../chunk-EUXUH3YW.js";
+export {
+  Select
+};
+//# sourceMappingURL=index.js.map

package/dist/select/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}