@silverpoint/core 0.3.0 → 0.7.0

package/dist/timeline.d.ts

@@ -0,0 +1,90 @@
+import { S as SpTimelineProps, T as TimelineData } from './types-DHBJ0PzV.js';
+export { a as TimelineDate, b as TimelineEra, c as TimelineSlide, d as TimelineText } from './types-DHBJ0PzV.js';
+import { U as UiResolved, a as UiElement } from './view-DteS9glE.js';
+import './types-D5ys35fF.js';
+import './props-BZ9CcrGv.js';
+
+/** The frame kinds TimelineJS's pieces borrow, one hidden probe each (DD-042). */
+declare const TIMELINE_FRAMES: readonly ["control", "card", "round", "box", "pill"];
+/** The tonal levels its eras and selection borrow, one hidden probe each. */
+declare const TIMELINE_TONES: readonly ["1", "2", "3", "4"];
+/** A resolved style, as much of `CSSStyleDeclaration` as this reads. */
+interface InkStyle {
+    getPropertyValue(name: string): string;
+}
+interface InkView {
+    getComputedStyle(element: never): InkStyle;
+    readonly MutationObserver: new (callback: () => void) => {
+        observe(target: never, options: {
+            readonly attributes: boolean;
+            readonly attributeFilter: string[];
+        }): void;
+        disconnect(): void;
+    };
+}
+/** The timeline's surface: where the `--sp-kl-*` properties are written. */
+interface TimelineInkHost {
+    getAttribute(name: string): string | null;
+    setAttribute(name: string, value: string): void;
+    readonly style: {
+        setProperty(name: string, value: string): void;
+    };
+    readonly ownerDocument: {
+        readonly defaultView: InkView | null;
+    } | null;
+}
+/** The hidden probe holding one `sp-frame` per kind and one `sp-tone` per level. */
+interface TimelineInkProbe {
+    querySelector(selector: string): unknown;
+}
+/**
+ * The hand on TimelineJS's own DOM (REQ-512, DD-042): reads the ground's resolved frame masks and
+ * tones from the probes and republishes them on the host as `--sp-kl-*`; every mask is `none`
+ * outside the `ink` mode or when `inked` is false. It re-reads when the host's ground, substrate,
+ * mode or frame changes, until the returned cleanup runs. Client only.
+ */
+declare function timelineInk(host: TimelineInkHost, probe: TimelineInkProbe, inked?: boolean): () => void;
+
+/**
+ * `SpTimeline`'s server markup (REQ-513, DD-042): the surface, the hidden probes `timelineInk`
+ * reads, and an empty mount TimelineJS fills on the client. Nothing of `data` is drawn here but the
+ * region's name; TimelineJS's DOM is third-party markup, outside the tree gate (Art. 3 as amended).
+ */
+declare function timelineView(props: SpTimelineProps, r: UiResolved, state?: {
+    readonly failed?: boolean;
+}): UiElement;
+
+/** TimelineJS's events and the name each framework forwards them under (REQ-514). */
+declare const TIMELINE_EVENTS: readonly [readonly ["change", "change"], readonly ["loaded", "loaded"], readonly ["nav_next", "navNext"], readonly ["nav_previous", "navPrevious"], readonly ["zoom_in", "zoomIn"], readonly ["zoom_out", "zoomOut"], readonly ["back_to_start", "backToStart"]];
+/** The options TimelineJS receives: `font` and `theme` belong to the skin and are dropped (REQ-514). */
+declare function timelineOptions(options?: Readonly<Record<string, unknown>>): Record<string, unknown>;
+/** As much of TimelineJS's module as `timelineMount` uses. */
+interface TimelineJsModule {
+    readonly Timeline: new (element: never, data: TimelineData, options: Record<string, unknown>) => {
+        on(event: string, handler: (payload: unknown) => void): unknown;
+    };
+}
+/** The surface `timelineView` drew, found in the page. */
+interface TimelineMountHost extends TimelineInkHost {
+    querySelector(selector: string): unknown;
+}
+interface TimelineMountOptions {
+    readonly load: () => Promise<TimelineJsModule>;
+    readonly data: TimelineData;
+    readonly options?: Readonly<Record<string, unknown>>;
+    readonly inked?: boolean;
+    /** One of `TIMELINE_EVENTS`' forwarded names, with a payload only for `change` and `loaded`. */
+    readonly emit: (event: string, ...value: unknown[]) => void;
+    readonly failed: () => void;
+}
+/**
+ * The client half of `SpTimeline` (REQ-513..REQ-515, DD-042): inks the surface from its probes,
+ * loads TimelineJS through the adapter's `load`, builds it in the mount and forwards its events
+ * under `TIMELINE_EVENTS`' names, with a copy of the data. A load that fails, or a TimelineJS that
+ * throws as it is built, warns `SP025` and calls `failed`; nothing throws.
+ * TimelineJS is built in a container of its own inside the mount, since it rewrites its container's
+ * `className`; the returned cleanup cancels a pending load, stops the inking and removes that container.
+ */
+declare function timelineMount(host: TimelineMountHost, mount: TimelineMountOptions): () => void;
+
+export { SpTimelineProps, TIMELINE_EVENTS, TIMELINE_FRAMES, TIMELINE_TONES, TimelineData, type TimelineInkHost, type TimelineInkProbe, type TimelineJsModule, type TimelineMountHost, type TimelineMountOptions, timelineInk, timelineMount, timelineOptions, timelineView };

package/dist/timeline.js

@@ -0,0 +1,125 @@
+import { uiRequireName } from './chunk-G7N4X5XD.js';
+import { cssLength, el, root, frame, slot } from './chunk-6YFO7OP3.js';
+import { diagnose } from './chunk-WYFRHI4S.js';
+
+// src/timeline/ink.ts
+var TIMELINE_FRAMES = Object.freeze(["control", "card", "round", "box", "pill"]);
+var TIMELINE_TONES = Object.freeze(["1", "2", "3", "4"]);
+function timelineInk(host, probe, inked = true) {
+  const view = host.ownerDocument?.defaultView;
+  if (!view) return () => {
+  };
+  const read = (selector, name, fallback) => {
+    const piece = probe.querySelector(selector);
+    return (piece ? view.getComputedStyle(piece).getPropertyValue(name).trim() : "") || fallback;
+  };
+  const ink = () => {
+    const usable = inked && host.getAttribute("data-mode") === "ink";
+    let anyMask = false;
+    let anyTone = false;
+    for (const kind of TIMELINE_FRAMES) {
+      const piece = `[part='sp-frame'][data-kind='${kind}']`;
+      const mask = usable ? read(piece, "--sp-ui-mask", "none") : "none";
+      anyMask ||= mask !== "none";
+      host.style.setProperty(`--sp-kl-mask-${kind}`, mask);
+      host.style.setProperty(`--sp-kl-mask-position-${kind}`, read(piece, "--sp-ui-mask-position", "center"));
+      host.style.setProperty(`--sp-kl-mask-size-${kind}`, read(piece, "--sp-ui-mask-size", "100% 100%"));
+    }
+    for (const level of TIMELINE_TONES) {
+      const piece = `[part='sp-tone'][data-tone='${level}']`;
+      const tone = read(piece, "--sp-ui-tone", "none");
+      anyTone ||= tone !== "none";
+      host.style.setProperty(`--sp-kl-tone-${level}`, tone);
+      host.style.setProperty(`--sp-kl-tone-size-${level}`, read(piece, "--sp-ui-tone-size", "auto"));
+    }
+    host.setAttribute("data-kl-inked", String(anyMask));
+    host.setAttribute("data-kl-toned", String(anyTone));
+  };
+  ink();
+  const observer = new view.MutationObserver(ink);
+  observer.observe(host, { attributes: true, attributeFilter: ["data-mode", "data-substrate", "data-ground", "data-frame", "class"] });
+  return () => observer.disconnect();
+}
+
+// src/timeline/view.ts
+function timelineView(props, r, state = {}) {
+  const card = props.card !== false;
+  const label = props.label ?? props.data.title?.text?.headline;
+  uiRequireName("SpTimeline", void 0, label);
+  const height = cssLength(props.height, "SpTimeline", "height") ?? "600px";
+  return el(
+    "section",
+    root("timeline", props, r, {
+      id: props.id,
+      "aria-label": label,
+      "data-kl-card": String(card),
+      // timelineInk sets it on the client, once a probe resolves a mask.
+      "data-kl-inked": "false",
+      style: `height:${height}`
+    }),
+    [
+      ...card ? [frame("card")] : [],
+      el(
+        "span",
+        { class: "sp-kl-probe", "aria-hidden": "true" },
+        [
+          ...TIMELINE_FRAMES.map((kind) => el("span", { part: "sp-frame", "data-kind": kind })),
+          ...TIMELINE_TONES.map((level) => el("span", { part: "sp-tone", "data-tone": level }))
+        ],
+        "probe"
+      ),
+      // Once the load has failed, the consumer's fallback fills the mount (REQ-515); never on the server.
+      el("div", { class: "sp-kl-mount" }, state.failed ? [slot("fallback")] : [], "mount")
+    ]
+  );
+}
+
+// src/timeline/mount.ts
+var TIMELINE_EVENTS = Object.freeze([
+  ["change", "change"],
+  ["loaded", "loaded"],
+  ["nav_next", "navNext"],
+  ["nav_previous", "navPrevious"],
+  ["zoom_in", "zoomIn"],
+  ["zoom_out", "zoomOut"],
+  ["back_to_start", "backToStart"]
+]);
+function timelineOptions(options) {
+  const { font: _font, theme: _theme, ...rest } = options ?? {};
+  return rest;
+}
+function timelineMount(host, mount) {
+  const stopInk = timelineInk(host, host.querySelector(".sp-kl-probe") ?? host, mount.inked);
+  const target = host.querySelector(".sp-kl-mount");
+  let live = true;
+  let box;
+  const fail = (error) => {
+    if (!live) return;
+    box?.remove();
+    box = void 0;
+    diagnose("SP025", "SpTimeline", { property: "load", message: error instanceof Error ? error.message : void 0 });
+    mount.failed();
+  };
+  mount.load().then(({ Timeline }) => {
+    if (!live || !target?.ownerDocument) return;
+    box = target.ownerDocument.createElement("div");
+    target.append(box);
+    const timeline = new Timeline(box, structuredClone(mount.data), timelineOptions(mount.options));
+    for (const [name, as] of TIMELINE_EVENTS) {
+      timeline.on(name, (payload) => {
+        if (name === "change") mount.emit(as, payload?.unique_id);
+        else if (name === "loaded") mount.emit(as, payload);
+        else mount.emit(as);
+      });
+    }
+  }).catch(fail);
+  return () => {
+    live = false;
+    stopInk();
+    box?.remove();
+  };
+}
+
+export { TIMELINE_EVENTS, TIMELINE_FRAMES, TIMELINE_TONES, timelineInk, timelineMount, timelineOptions, timelineView };
+//# sourceMappingURL=timeline.js.map
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timeline/ink.ts","../src/timeline/view.ts","../src/timeline/mount.ts"],"names":[],"mappings":"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","file":"timeline.js","sourcesContent":["/** The frame kinds TimelineJS's pieces borrow, one hidden probe each (DD-042). */\nexport const TIMELINE_FRAMES = Object.freeze(['control', 'card', 'round', 'box', 'pill'] as const);\n/** The tonal levels its eras and selection borrow, one hidden probe each. */\nexport const TIMELINE_TONES = Object.freeze(['1', '2', '3', '4'] as const);\n\n/** A resolved style, as much of `CSSStyleDeclaration` as this reads. */\ninterface InkStyle {\n  getPropertyValue(name: string): string;\n}\n\ninterface InkView {\n  getComputedStyle(element: never): InkStyle;\n  readonly MutationObserver: new (callback: () => void) => {\n    observe(target: never, options: { readonly attributes: boolean; readonly attributeFilter: string[] }): void;\n    disconnect(): void;\n  };\n}\n\n/** The timeline's surface: where the `--sp-kl-*` properties are written. */\nexport interface TimelineInkHost {\n  getAttribute(name: string): string | null;\n  setAttribute(name: string, value: string): void;\n  readonly style: { setProperty(name: string, value: string): void };\n  readonly ownerDocument: { readonly defaultView: InkView | null } | null;\n}\n\n/** The hidden probe holding one `sp-frame` per kind and one `sp-tone` per level. */\nexport interface TimelineInkProbe {\n  querySelector(selector: string): unknown;\n}\n\n/**\n * The hand on TimelineJS's own DOM (REQ-512, DD-042): reads the ground's resolved frame masks and\n * tones from the probes and republishes them on the host as `--sp-kl-*`; every mask is `none`\n * outside the `ink` mode or when `inked` is false. It re-reads when the host's ground, substrate,\n * mode or frame changes, until the returned cleanup runs. Client only.\n */\nexport function timelineInk(host: TimelineInkHost, probe: TimelineInkProbe, inked = true): () => void {\n  const view = host.ownerDocument?.defaultView;\n  if (!view) return () => {};\n  const read = (selector: string, name: string, fallback: string): string => {\n    const piece = probe.querySelector(selector);\n    return (piece ? view.getComputedStyle(piece as never).getPropertyValue(name).trim() : '') || fallback;\n  };\n  const ink = () => {\n    const usable = inked && host.getAttribute('data-mode') === 'ink';\n    let anyMask = false;\n    let anyTone = false;\n    for (const kind of TIMELINE_FRAMES) {\n      const piece = `[part='sp-frame'][data-kind='${kind}']`;\n      const mask = usable ? read(piece, '--sp-ui-mask', 'none') : 'none';\n      anyMask ||= mask !== 'none';\n      host.style.setProperty(`--sp-kl-mask-${kind}`, mask);\n      host.style.setProperty(`--sp-kl-mask-position-${kind}`, read(piece, '--sp-ui-mask-position', 'center'));\n      host.style.setProperty(`--sp-kl-mask-size-${kind}`, read(piece, '--sp-ui-mask-size', '100% 100%'));\n    }\n    for (const level of TIMELINE_TONES) {\n      const piece = `[part='sp-tone'][data-tone='${level}']`;\n      const tone = read(piece, '--sp-ui-tone', 'none');\n      anyTone ||= tone !== 'none';\n      host.style.setProperty(`--sp-kl-tone-${level}`, tone);\n      host.style.setProperty(`--sp-kl-tone-size-${level}`, read(piece, '--sp-ui-tone-size', 'auto'));\n    }\n    host.setAttribute('data-kl-inked', String(anyMask));\n    host.setAttribute('data-kl-toned', String(anyTone));\n  };\n  ink();\n  const observer = new view.MutationObserver(ink);\n  observer.observe(host as never, { attributes: true, attributeFilter: ['data-mode', 'data-substrate', 'data-ground', 'data-frame', 'class'] });\n  return () => observer.disconnect();\n}\n","import { uiRequireName } from '../ui/names';\nimport type { UiElement, UiResolved } from '../ui/view';\nimport { cssLength, el, frame, root, slot } from '../ui/view-kit';\nimport { TIMELINE_FRAMES, TIMELINE_TONES } from './ink';\nimport type { SpTimelineProps } from './types';\n\n/**\n * `SpTimeline`'s server markup (REQ-513, DD-042): the surface, the hidden probes `timelineInk`\n * reads, and an empty mount TimelineJS fills on the client. Nothing of `data` is drawn here but the\n * region's name; TimelineJS's DOM is third-party markup, outside the tree gate (Art. 3 as amended).\n */\nexport function timelineView(props: SpTimelineProps, r: UiResolved, state: { readonly failed?: boolean } = {}): UiElement {\n  const card = props.card !== false;\n  const label = props.label ?? props.data.title?.text?.headline;\n  uiRequireName('SpTimeline', undefined, label);\n  const height = cssLength(props.height, 'SpTimeline', 'height') ?? '600px';\n  return el(\n    'section',\n    root('timeline', props, r, {\n      id: props.id,\n      'aria-label': label,\n      'data-kl-card': String(card),\n      // timelineInk sets it on the client, once a probe resolves a mask.\n      'data-kl-inked': 'false',\n      style: `height:${height}`,\n    }),\n    [\n      ...(card ? [frame('card')] : []),\n      el(\n        'span',\n        { class: 'sp-kl-probe', 'aria-hidden': 'true' },\n        [\n          ...TIMELINE_FRAMES.map((kind) => el('span', { part: 'sp-frame', 'data-kind': kind })),\n          ...TIMELINE_TONES.map((level) => el('span', { part: 'sp-tone', 'data-tone': level })),\n        ],\n        'probe',\n      ),\n      // Once the load has failed, the consumer's fallback fills the mount (REQ-515); never on the server.\n      el('div', { class: 'sp-kl-mount' }, state.failed ? [slot('fallback')] : [], 'mount'),\n    ],\n  );\n}\n","import { diagnose } from '../diagnostics/diagnose';\nimport { timelineInk, type TimelineInkHost, type TimelineInkProbe } from './ink';\nimport type { TimelineData } from './types';\n\n/** TimelineJS's events and the name each framework forwards them under (REQ-514). */\nexport const TIMELINE_EVENTS = Object.freeze([\n  ['change', 'change'],\n  ['loaded', 'loaded'],\n  ['nav_next', 'navNext'],\n  ['nav_previous', 'navPrevious'],\n  ['zoom_in', 'zoomIn'],\n  ['zoom_out', 'zoomOut'],\n  ['back_to_start', 'backToStart'],\n] as const);\n\n/** The options TimelineJS receives: `font` and `theme` belong to the skin and are dropped (REQ-514). */\nexport function timelineOptions(options?: Readonly<Record<string, unknown>>): Record<string, unknown> {\n  const { font: _font, theme: _theme, ...rest } = options ?? {};\n  return rest;\n}\n\n/** As much of TimelineJS's module as `timelineMount` uses. */\nexport interface TimelineJsModule {\n  readonly Timeline: new (element: never, data: TimelineData, options: Record<string, unknown>) => {\n    on(event: string, handler: (payload: unknown) => void): unknown;\n  };\n}\n\n/** TimelineJS's container. */\ninterface TimelineMountBox {\n  remove(): void;\n}\n\n/** The surface's mount, as much of it as `timelineMount` uses. */\ninterface TimelineMountTarget {\n  append(child: never): void;\n  readonly ownerDocument: { createElement(tag: 'div'): TimelineMountBox } | null;\n}\n\n/** The surface `timelineView` drew, found in the page. */\nexport interface TimelineMountHost extends TimelineInkHost {\n  querySelector(selector: string): unknown;\n}\n\nexport interface TimelineMountOptions {\n  readonly load: () => Promise<TimelineJsModule>;\n  readonly data: TimelineData;\n  readonly options?: Readonly<Record<string, unknown>>;\n  readonly inked?: boolean;\n  /** One of `TIMELINE_EVENTS`' forwarded names, with a payload only for `change` and `loaded`. */\n  readonly emit: (event: string, ...value: unknown[]) => void;\n  readonly failed: () => void;\n}\n\n/**\n * The client half of `SpTimeline` (REQ-513..REQ-515, DD-042): inks the surface from its probes,\n * loads TimelineJS through the adapter's `load`, builds it in the mount and forwards its events\n * under `TIMELINE_EVENTS`' names, with a copy of the data. A load that fails, or a TimelineJS that\n * throws as it is built, warns `SP025` and calls `failed`; nothing throws.\n * TimelineJS is built in a container of its own inside the mount, since it rewrites its container's\n * `className`; the returned cleanup cancels a pending load, stops the inking and removes that container.\n */\nexport function timelineMount(host: TimelineMountHost, mount: TimelineMountOptions): () => void {\n  const stopInk = timelineInk(host, host.querySelector('.sp-kl-probe') as TimelineInkProbe ?? host, mount.inked);\n  const target = host.querySelector('.sp-kl-mount') as TimelineMountTarget | null;\n  let live = true;\n  /** TimelineJS's container: a `<div>` of its own, which it may restyle; the mount stays the framework's. */\n  let box: TimelineMountBox | undefined;\n  const fail = (error: unknown) => {\n    if (!live) return;\n    // Whatever TimelineJS wrote before it threw goes with its container: the mount is the fallback's.\n    box?.remove();\n    box = undefined;\n    diagnose('SP025', 'SpTimeline', { property: 'load', message: error instanceof Error ? error.message : undefined });\n    mount.failed();\n  };\n  mount\n    .load()\n    .then(({ Timeline }) => {\n      if (!live || !target?.ownerDocument) return;\n      box = target.ownerDocument.createElement('div');\n      target.append(box as never);\n      // TimelineJS writes into its data (each slide's `unique_id`): a copy, never the consumer's.\n      const timeline = new Timeline(box as never, structuredClone(mount.data), timelineOptions(mount.options));\n      for (const [name, as] of TIMELINE_EVENTS) {\n        timeline.on(name, (payload) => {\n          if (name === 'change') mount.emit(as, (payload as { unique_id?: string } | undefined)?.unique_id);\n          else if (name === 'loaded') mount.emit(as, payload);\n          else mount.emit(as);\n        });\n      }\n    })\n    .catch(fail);\n  return () => {\n    live = false;\n    stopInk();\n    box?.remove();\n  };\n}\n"]}

package/dist/{types-CbVMKvyQ.d.ts → types-BT3Xm7fP.d.ts}

@@ -1,4 +1,4 @@
-import { e as GroundRef, f as SubstrateName, I as InkMode, P as ProviderConfig } from './props-3G1XYd-r.js';
+import { t as GroundRef, u as SubstrateName, q as InkMode, au as Palette, v as ProviderConfig } from './props-BZ9CcrGv.js';
 
 /** The three container breakpoints; their widths are fixed (TD DD-014). */
 type DashboardBreakpoint = 'sm' | 'md' | 'lg';
@@ -53,6 +53,8 @@ type DashboardProps = DashboardName & {
     substrate?: SubstrateName;
     mode?: InkMode;
     locale?: string;
+    /** The section's colours, written on its root and merged under every chart's and component's own (REQ-462). */
+    palette?: Palette;
     className?: string;
 };
 interface DashboardCellProps {