rikiki-deck 0.6.0 → 0.7.2

package/dist/deep-link.d.ts

@@ -0,0 +1,29 @@
+import type { DeckOutline, DeckPosition, StepsOf } from '../domain/deck-outline.js';
+/** The URL, as the application is allowed to see it. Implemented by the browser
+ *  adapter; a test supplies a plain object. */
+export interface LocationPort {
+    /** The current fragment, `#` included, or an empty string. */
+    read(): string;
+    /** Replace the fragment without adding a history entry. Implementations
+     *  swallow the SecurityError an opaque origin throws · see the adapter. */
+    write(hash: string): void;
+}
+export interface DeepLinkContext {
+    readonly outline: DeckOutline;
+    readonly twoD: boolean;
+    readonly stepsOf: StepsOf;
+    /** False for an embedded deck · the fragment belongs to the host page. */
+    readonly ownsUrl: boolean;
+}
+/**
+ * The position the current URL asks for, or null when it asks for nothing.
+ *
+ * `coldLoad` matters: before the plugins have computed their step counts, the
+ * model would clamp `#4.2` down to step 0 and lose the link. Until a count
+ * exists the asked-for step is kept as-is; from then on it is clamped, so a
+ * link to a click that no longer exists settles on the last available one.
+ */
+export declare function readDeepLink(port: LocationPort, ctx: DeepLinkContext, coldLoad?: boolean): DeckPosition | null;
+/** Write a position to the URL, in the grammar `readDeepLink` will read back.
+ *  A deck that does not own the URL writes nothing at all. */
+export declare function publishDeepLink(port: LocationPort, position: DeckPosition, ctx: Pick<DeepLinkContext, 'outline' | 'twoD' | 'ownsUrl'>): void;

package/dist/deep-link.js

@@ -0,0 +1 @@
+var f=/^#(\d+)\.(\d+)(?:s(\d+))?$/,k=/^#(\d+)(?:\.(\d+))?$/;function l(e,t){if(t){let n=f.exec(e);if(n)return{kind:"coords",coords:{chapter:Number(n[1])-1,index:Number(n[2])-1},step:n[3]?Number(n[3]):0}}let o=k.exec(e);return o?{kind:"slide",slide:Number(o[1])-1,step:o[2]?Number(o[2]):0}:null}function c(e,t){if(t.twoD&&t.coords){let{chapter:o,index:n}=t.coords,r=e.step>0?`s${e.step}`:"";return`#${o+1}.${n+1}${r}`}return`#${e.slide+1}${e.step>0?`.${e.step}`:""}`}function u(e,t){for(let o=0;o<e.chapters.length;o++){let n=e.chapters[o],r=t-n.start;if(r>=0&&r<n.length)return{chapter:o,index:r}}return{chapter:0,index:0}}function p(e,t){if(e.chapters.length===0)return null;let o=s(t.chapter,0,e.chapters.length-1),n=e.chapters[o],r=s(t.index,0,n.length-1);return n.start+r}function s(e,t,o){return Number.isNaN(e)?t:Math.max(t,Math.min(o,e))}var D=e=>e.slideCount<=0;function i(e,t,o){if(D(e))return null;let n=s(t.slide,0,e.slideCount-1),r=Math.max(0,o(n));return{slide:n,step:s(t.step,0,r)}}function a(e,t,o){return i(e,{slide:t,step:0},o)}function d(e,t,o){let n=p(e,t);return n===null?null:i(e,{slide:n,step:0},o)}function C(e,t,o=!1){if(!t.ownsUrl)return null;let n=l(e.read(),t.twoD);if(!n)return null;let r=n.kind==="coords"?d(t.outline,n.coords,t.stepsOf):a(t.outline,n.slide,t.stepsOf);return r?t.stepsOf(r.slide)>0||!o?i(t.outline,{slide:r.slide,step:n.step},t.stepsOf):{slide:r.slide,step:Math.max(0,n.step)}:null}function w(e,t,o){if(!o.ownsUrl)return;let n=c(t,{twoD:o.twoD,coords:o.twoD?u(o.outline,t.slide):void 0});e.read()!==n&&e.write(n)}export{w as publishDeepLink,C as readDeepLink};

package/dist/escape-html.d.ts

@@ -0,0 +1,3 @@
+/** Escape the five HTML-significant characters · safe for both text nodes and
+ *  quoted attribute values. Non-string input coerces to the empty string. */
+export declare function escapeHtml(value: unknown): string;

package/dist/escape-html.js

@@ -0,0 +1 @@
+var r={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"};function e(n){return n==null?"":String(n).replace(/[&<>"']/g,t=>r[t])}export{e as escapeHtml};

package/dist/fit-controller.d.ts

@@ -0,0 +1,27 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/** Largest size in [min, max] for which `fits(px)` holds, found by bisection.
+ *  `fits` must be monotonic (true up to some threshold, false above). If even
+ *  `min` overflows, returns `min` · a tiny clip beats vanishing text. Pure and
+ *  DOM-free so the search is unit-testable with a mock predicate. */
+export declare function bestFitSize(min: number, max: number, fits: (px: number) => boolean, epsilon?: number): number;
+type FitHost = ReactiveControllerHost & HTMLElement;
+export interface FitOptions {
+    /** When false, the controller clears its sizing and stays idle. */
+    enabled?: () => boolean;
+    /** Floor size in rem (resolved against the root font-size). Default 1. */
+    minRem?: () => number;
+    /** Ceiling size in rem. Default 12. */
+    maxRem?: () => number;
+}
+export declare class FitController implements ReactiveController {
+    private host;
+    private opts;
+    private ro?;
+    constructor(host: FitHost, opts?: FitOptions);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /** Re-measure and size the host · safe to call after content or attribute
+     *  changes (the host's updated() hook should call it). */
+    refit(): void;
+}
+export {};

package/dist/fit-controller.js

@@ -0,0 +1 @@
+function c(n,e,t,s=.5){if(e<=n)return n;if(t(e))return e;let o=n,i=e;for(;i-o>s;){let r=(o+i)/2;t(r)?o=r:i=r}return o}var l=class{constructor(e,t={}){this.host=e;this.opts=t;e.addController(this)}hostConnected(){this.ro=new ResizeObserver(()=>this.refit()),this.ro.observe(this.host),this.refit(),document.fonts?.ready?.then(()=>{this.ro&&this.refit()})}hostDisconnected(){this.ro?.disconnect(),this.ro=void 0}refit(){let e=this.host;if(this.opts.enabled&&!this.opts.enabled()){e.style.removeProperty("font-size");return}if(e.clientWidth===0||e.clientHeight===0)return;let t=parseFloat(getComputedStyle(document.documentElement).fontSize)||16,s=(this.opts.minRem?.()??1)*t,o=(this.opts.maxRem?.()??12)*t,i=r=>(e.style.fontSize=`${r}px`,e.scrollWidth<=e.clientWidth&&e.scrollHeight<=e.clientHeight);e.style.fontSize=`${c(s,o,i)}px`}};export{l as FitController,c as bestFitSize};

package/dist/graph-layout.d.ts

@@ -0,0 +1,35 @@
+export interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+export type GraphLayout = 'free' | 'row' | 'column';
+/** Read an `at="x,y"` attribute · null when it is absent or unreadable, so the
+ *  caller can fall back to an arrangement rather than pinning to a corner. */
+export declare function parsePoint(raw: string | null | undefined): Point | null;
+/**
+ * Resolve a position for every node.
+ *
+ * `free` honours what the author wrote and centres anything unwritten. `row`
+ * and `column` space the nodes evenly and ignore `at` entirely · the two cases
+ * that would otherwise be typed out by hand on every chain diagram.
+ *
+ * The inset keeps the first and last node off the edge, where their labels
+ * would be cut by the slide padding.
+ */
+export declare function arrange(raw: readonly (string | null)[], layout?: GraphLayout, inset?: number): Point[];
+export interface EdgeGeometry {
+    readonly x1: number;
+    readonly y1: number;
+    readonly x2: number;
+    readonly y2: number;
+    /** Midpoint, where a label sits. */
+    readonly mx: number;
+    readonly my: number;
+}
+/**
+ * The segment between two nodes, shortened at both ends.
+ *
+ * The gap is what stops a line from running under a label · without it every
+ * edge appears to strike through the word it connects.
+ */
+export declare function edgeGeometry(from: Point, to: Point, gap?: number): EdgeGeometry;

package/dist/graph-layout.js

@@ -0,0 +1 @@
+var l=n=>Number.isFinite(n)?Math.max(0,Math.min(100,n)):50;function m(n){if(!n)return null;let[e="",t=""]=n.split(",");if(e.trim()===""||t.trim()==="")return null;let r=Number(e),y=Number(t);return!Number.isFinite(r)||!Number.isFinite(y)?null:{x:l(r),y:l(y)}}function a(n,e="free",t=12){let r=n.length;if(r===0)return[];if(e==="free")return n.map(u=>m(u)??{x:50,y:50});let y=100-t*2;return n.map((u,i)=>{let o=r===1?.5:i/(r-1),x=t+y*o;return e==="row"?{x,y:50}:{x:50,y:x}})}function c(n,e,t=6){let r=e.x-n.x,y=e.y-n.y,u=Math.hypot(r,y);if(u===0)return{x1:n.x,y1:n.y,x2:e.x,y2:e.y,mx:n.x,my:n.y};let i=Math.min(t,u/3),o=r/u,x=y/u;return{x1:n.x+o*i,y1:n.y+x*i,x2:e.x-o*i,y2:e.y-x*i,mx:(n.x+e.x)/2,my:(n.y+e.y)/2}}export{a as arrange,c as edgeGeometry,m as parsePoint};

package/dist/grid-tracks.d.ts

@@ -0,0 +1,17 @@
+/** `cols`/`rows` value · integer 1..12 → `repeat(N, minmax(0, 1fr))`, else the
+ *  value is passed through as an explicit track template ("1fr 2fr"). */
+export declare function expandTracks(value: string | undefined): string | null;
+/** `gap` value · integer 1..6 → `var(--rik-space-N)`, else any CSS length. */
+export declare function expandGap(value: string | undefined): string | null;
+export interface CellSpan {
+    /** grid-column value */
+    col: string;
+    /** grid-row value */
+    row: string;
+}
+/** Turn one axis of a span into a grid-* value · a positive integer becomes
+ *  `span N`, anything else (raw line syntax like "1 / 3") passes through. */
+export declare function toTrack(value: string | undefined): string;
+/** Parse a bento cell span. Accepts "CxR" (e.g. "2x1"), a bare column count
+ *  ("2" → span 2 columns, 1 row), or empty (→ a single auto-placed cell). */
+export declare function parseSpan(value: string | undefined): CellSpan;

package/dist/grid-tracks.js

@@ -0,0 +1 @@
+function e(r){if(!r)return null;let n=parseInt(r,10);return!Number.isNaN(n)&&String(n)===r.trim()&&n>=1&&n<=12?`repeat(${n}, minmax(0, 1fr))`:r}function o(r){if(!r)return null;let n=parseInt(r,10);return!Number.isNaN(n)&&String(n)===r.trim()&&n>=1&&n<=6?`var(--rik-space-${n})`:r}function t(r){if(!r)return"auto";let n=r.trim();return/^\d+$/.test(n)?`span ${n}`:n}function s(r){if(!r)return{col:"auto",row:"auto"};let[n,i]=r.toLowerCase().split("x");return{col:t(n),row:t(i)}}export{o as expandGap,e as expandTracks,s as parseSpan,t as toTrack};

package/dist/icon-set.d.ts

@@ -0,0 +1,6 @@
+export declare const ICONS: Readonly<Record<string, string>>;
+export type IconName = string;
+export declare const ICON_NAMES: string[];
+/** The path for a name · null when the set does not have it, so the component
+ *  can render a slotted SVG instead of an empty box. */
+export declare function iconPath(name: string | null | undefined): string | null;

package/dist/icon-set.js

@@ -0,0 +1 @@
+var e='{"check":"M20 6 9 17l-5-5","cross":"M18 6 6 18M6 6l12 12","alert":"M12 9v4m0 4h.01M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0Z","info":"M12 16v-4m0-4h.01M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0Z","question":"M9.1 9a3 3 0 0 1 5.8 1c0 2-3 3-3 3m.1 4h.01M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0Z","ban":"M4.9 4.9l14.2 14.2M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0Z","arrow":"M5 12h14m-6-6 6 6-6 6","arrow-down":"M12 5v14m6-6-6 6-6-6","clock":"M12 6v6l4 2m6-2a10 10 0 1 1-20 0 10 10 0 0 1 20 0Z","calendar":"M8 2v4m8-4v4M3 10h18M5 4h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2Z","refresh":"M21 12a9 9 0 1 1-3-6.7M21 3v6h-6","trend":"M22 7 13.5 15.5l-5-5L2 17M16 7h6v6","user":"M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2M16 7a4 4 0 1 1-8 0 4 4 0 0 1 8 0Z","team":"M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2M13 7a4 4 0 1 1-8 0 4 4 0 0 1 8 0Zm10 14v-2a4 4 0 0 0-3-3.9M16 3.1a4 4 0 0 1 0 7.8","target":"M12 8a4 4 0 1 0 0 8 4 4 0 0 0 0-8Zm0-6a10 10 0 1 0 0 20 10 10 0 0 0 0-20Zm0 9a1 1 0 1 0 0 2 1 1 0 0 0 0-2Z","flag":"M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1Zm0 0v7","lock":"M7 11V7a5 5 0 0 1 10 0v4M5 11h14a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2Z","search":"M21 21l-4.3-4.3M19 11a8 8 0 1 1-16 0 8 8 0 0 1 16 0Z","code":"M16 18l6-6-6-6M8 6l-6 6 6 6","database":"M3 5c0 1.7 4 3 9 3s9-1.3 9-3-4-3-9-3-9 1.3-9 3Zm0 0v14c0 1.7 4 3 9 3s9-1.3 9-3V5M3 12c0 1.7 4 3 9 3s9-1.3 9-3","cloud":"M17.5 19a4.5 4.5 0 0 0 0-9h-1.3A7 7 0 1 0 4 16.9","document":"M14 2v6h6M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8Zm-6 11h8m-8 4h8m-8-8h2","chart":"M3 3v18h18M7 16V9m5 7V5m5 11v-4","spark":"M12 2 15 9l7 3-7 3-3 7-3-7-7-3 7-3Z"}',M=Object.freeze(JSON.parse(e)),r=Object.keys(M);function t(a){return a?M[a.trim().toLowerCase()]??null:null}export{M as ICONS,r as ICON_NAMES,t as iconPath};

package/dist/index.d.ts

@@ -1,31 +1,37 @@
-import './runtime/deck-root.js';
-import './runtime/deck-transition.js';
-import './runtime/deck-help.js';
-import './runtime/deck-overview.js';
-import './runtime/deck-presenter.js';
-import './runtime/deck-notes.js';
-import './layouts/deck-cover.js';
-import './layouts/deck-section.js';
-import './layouts/deck-feature.js';
-import './layouts/deck-split.js';
-import './layouts/deck-feature-cards.js';
-import './layouts/deck-photo.js';
-import './layouts/deck-takeaway.js';
-import './molecules/deck-callout.js';
-import './molecules/deck-card.js';
-import './molecules/deck-md.js';
-import './molecules/deck-mermaid.js';
-import './molecules/deck-stat.js';
-import './molecules/deck-metric.js';
-import './molecules/deck-tier-list.js';
-import './molecules/deck-step-list.js';
-import './molecules/deck-shortcut.js';
-import './molecules/deck-stack.js';
-import './molecules/deck-grid.js';
-import './atoms/deck-badge.js';
-import './atoms/deck-kicker.js';
-import './atoms/deck-punch.js';
-import './atoms/deck-code.js';
-export type { DeckPlugin, DeckContext } from './runtime/deck-root.js';
-export type { DeckCodeHighlighter } from './atoms/deck-code.js';
-export { setDeckCodeHighlighter } from './atoms/deck-code-highlighter.js';
+import './engine/deck-root.js';
+import './engine/deck-transition.js';
+import './engine/deck-help.js';
+import './engine/deck-overview.js';
+import './engine/deck-presenter.js';
+import './engine/deck-notes.js';
+import './layout/deck-cover.js';
+import './layout/deck-section.js';
+import './layout/deck-feature.js';
+import './layout/deck-split.js';
+import './layout/deck-feature-cards.js';
+import './layout/deck-photo.js';
+import './layout/deck-takeaway.js';
+import './structure/deck-bento.js';
+import './structure/deck-cell.js';
+import './structure/deck-point.js';
+import './structure/deck-grid.js';
+import './structure/deck-stack.js';
+import './structure/deck-card.js';
+import './structure/deck-source.js';
+import './text/deck-md.js';
+import './text/deck-callout.js';
+import './text/deck-fit.js';
+import './text/deck-badge.js';
+import './text/deck-kicker.js';
+import './text/deck-punch.js';
+import './data/deck-stat.js';
+import './data/deck-metric.js';
+import './data/deck-tier-list.js';
+import './data/deck-step-list.js';
+import './data/deck-shortcut.js';
+import './data/deck-csv.js';
+import './media/deck-code.js';
+import './media/deck-mermaid.js';
+export type { DeckPlugin, DeckContext } from './engine/deck-root.js';
+export type { DeckCodeHighlighter } from './media/deck-code.js';
+export { setDeckCodeHighlighter } from './media/deck-code-highlighter.js';