rikiki-deck 0.6.0 → 0.7.2

package/dist/keymap.d.ts

@@ -0,0 +1,40 @@
+import type { DeckOutline, DeckPosition, StepsOf } from '../domain/deck-outline.js';
+import type { NavigationPolicy } from '../domain/navigation.js';
+/** What the deck should do · an intent, not a mutation. */
+export type DeckIntent = 'none' | 'close-overview' | 'open-overview' | 'clear-blank' | 'blank-black' | 'blank-white' | 'zoom-in' | 'zoom-out' | 'zoom-reset' | 'toggle-help' | 'close-help' | 'toggle-presenter' | 'first' | 'last' | 'advance' | 'back' | 'next-chapter' | 'prev-chapter' | 'next-in-chapter' | 'prev-in-chapter';
+/** Everything the keymap needs to know · a snapshot, so it stays pure. */
+export interface KeyState {
+    readonly key: string;
+    /** The overview overlay is open · it swallows almost everything. */
+    readonly overview: boolean;
+    /** The screen is blanked · any key restores it and does nothing else. */
+    readonly blanked: boolean;
+    readonly zoomEnabled: boolean;
+    /** Already magnified beyond fit · only then does `0` mean "reset". */
+    readonly zoomed: boolean;
+    readonly twoD: boolean;
+}
+export interface KeyDecision {
+    readonly intent: DeckIntent;
+    /** Whether the engine should call preventDefault · preserved key by key,
+     *  because the browser's own behaviour for Escape, Home/End and `?` is
+     *  deliberately left alone. */
+    readonly preventDefault: boolean;
+}
+/** Map a key press to an intent.
+ *
+ *  Order matters and mirrors what a presenter expects: an open overlay wins
+ *  over everything, a blanked screen wins over navigation, and zoom keys are
+ *  only claimed when zoom is actually available. */
+export declare function keyIntent(state: KeyState): KeyDecision;
+/** Which intents are a move, and therefore resolve to a position. */
+export type MoveIntent = Extract<DeckIntent, 'first' | 'last' | 'advance' | 'back' | 'next-chapter' | 'prev-chapter' | 'next-in-chapter' | 'prev-in-chapter'>;
+export declare const isMove: (intent: DeckIntent) => intent is MoveIntent;
+/**
+ * Where a move intent lands.
+ *
+ * The four 2D intents fall back to linear navigation at the edges, on purpose:
+ * holding ArrowDown walks the whole deck rather than stopping dead at every
+ * chapter boundary, and ArrowRight past the last chapter still advances.
+ */
+export declare function resolveMove(intent: MoveIntent, outline: DeckOutline, policy: NavigationPolicy, from: DeckPosition, stepsOf: StepsOf): DeckPosition | null;

package/dist/keymap.js

@@ -0,0 +1 @@
+function D(t,e){for(let n=0;n<t.chapters.length;n++){let i=t.chapters[n],r=e-i.start;if(r>=0&&r<i.length)return{chapter:n,index:r}}return{chapter:0,index:0}}function x(t,e){if(t.chapters.length===0)return null;let n=l(e.chapter,0,t.chapters.length-1),i=t.chapters[n],r=l(e.index,0,i.length-1);return i.start+r}function l(t,e,n){return Number.isNaN(t)?e:Math.max(e,Math.min(n,t))}var h=t=>t.slideCount<=0;function b(t,e,n){if(h(t))return null;let i=l(e.slide,0,t.slideCount-1),r=Math.max(0,n(i));return{slide:i,step:l(e.step,0,r)}}function v(t,e,n,i){if(h(t))return null;let r=Math.max(0,i(n.slide));return n.step<r?{slide:n.slide,step:n.step+1}:n.slide<t.slideCount-1?{slide:n.slide+1,step:0}:e.loop?{slide:0,step:0}:null}function m(t,e,n,i){if(h(t))return null;if(n.step>0)return{slide:n.slide,step:n.step-1};if(n.slide>0){let r=n.slide-1;return{slide:r,step:Math.max(0,i(r))}}if(e.loop){let r=t.slideCount-1;return{slide:r,step:Math.max(0,i(r))}}return null}function y(t,e,n){return b(t,{slide:e,step:0},n)}function s(t,e,n){let i=x(t,e);return i===null?null:b(t,{slide:i,step:0},n)}function g(t,e){return y(t,0,e)}function P(t,e){return y(t,t.slideCount-1,e)}var f={intent:"none",preventDefault:!1},o=(t,e=!0)=>({intent:t,preventDefault:e}),a=(t,...e)=>e.some(n=>n.toLowerCase()===t.toLowerCase());function M(t){let{key:e}=t;return t.overview?a(e,"Escape","o","Enter")?o("close-overview"):f:t.blanked?o("clear-blank"):a(e,".","b")?o("blank-black"):a(e,",","w")?o("blank-white"):t.zoomEnabled&&(e==="+"||e==="=")?o("zoom-in"):t.zoomEnabled&&e==="-"?o("zoom-out"):e==="0"&&t.zoomed?o("zoom-reset"):a(e,"?","h")?o("toggle-help",!1):e==="Escape"?o("close-help",!1):e==="Home"?o("first",!1):e==="End"?o("last",!1):a(e,"o")?o("open-overview"):a(e,"p")?o("toggle-presenter"):e===" "||e==="PageDown"?o("advance"):e==="PageUp"?o("back"):t.twoD?e==="ArrowRight"?o("next-chapter"):e==="ArrowLeft"?o("prev-chapter"):e==="ArrowDown"?o("next-in-chapter"):e==="ArrowUp"?o("prev-in-chapter"):f:e==="ArrowRight"||e==="ArrowDown"?o("advance"):e==="ArrowLeft"||e==="ArrowUp"?o("back"):f}var w=new Set(["first","last","advance","back","next-chapter","prev-chapter","next-in-chapter","prev-in-chapter"]),N=t=>w.has(t);function z(t,e,n,i,r){let u=()=>v(e,n,i,r),d=()=>m(e,n,i,r),{chapter:c,index:p}=D(e,i.slide);switch(t){case"first":return g(e,r);case"last":return P(e,r);case"advance":return u();case"back":return d();case"next-chapter":return c+1<e.chapters.length?s(e,{chapter:c+1,index:0},r):u();case"prev-chapter":return c>0?s(e,{chapter:c-1,index:0},r):d();case"next-in-chapter":{let k=e.chapters[c];return k&&p+1<k.length?s(e,{chapter:c,index:p+1},r):u()}case"prev-in-chapter":return p>0?s(e,{chapter:c,index:p-1},r):d()}}export{N as isMove,M as keyIntent,z as resolveMove};

package/dist/mouse-nav.d.ts

@@ -0,0 +1,12 @@
+/** The pointer mechanisms a deck can claim. */
+export type MouseMechanism = 'click' | 'wheel' | 'arrows' | 'aux';
+export declare const MOUSE_MECHANISMS: readonly MouseMechanism[];
+/**
+ * Is `mechanism` enabled by this `mouse-nav` value?
+ *
+ * Absent or `all` enables everything (the default), `none` disables everything,
+ * and anything else is a space-separated allowlist. An unknown word simply
+ * matches nothing, so `mouse-nav="whel"` disables the wheel rather than
+ * silently enabling it.
+ */
+export declare function mouseEnabled(raw: string | null | undefined, mechanism: MouseMechanism): boolean;

package/dist/mouse-nav.js

@@ -0,0 +1 @@
+var r=["click","wheel","arrows","aux"];function o(n,l){let e=(n??"all").trim();return e==="none"?!1:e===""||e==="all"?!0:e.split(/\s+/).includes(l)}export{r as MOUSE_MECHANISMS,o as mouseEnabled};

package/dist/navigation.d.ts

@@ -0,0 +1,25 @@
+import { type DeckCoords, type DeckOutline, type DeckPosition, type StepsOf } from './deck-outline.js';
+/** The author's navigation choices. */
+export interface NavigationPolicy {
+    /** Wrap around at both ends. */
+    readonly loop: boolean;
+}
+export declare const LINEAR: NavigationPolicy;
+/** Bring any position inside the deck · the invariant every verb returns under.
+ *  Null for an empty deck, which has no valid position at all. */
+export declare function clampPosition(outline: DeckOutline, position: DeckPosition, stepsOf: StepsOf): DeckPosition | null;
+/** One step forward, then one slide forward, then wrap if the deck loops.
+ *  Null at the very end of a deck that does not loop. */
+export declare function advance(outline: DeckOutline, policy: NavigationPolicy, from: DeckPosition, stepsOf: StepsOf): DeckPosition | null;
+/** One step back, then into the previous slide AT ITS LAST STEP, then wrap.
+ *  Null at the very start of a deck that does not loop. */
+export declare function back(outline: DeckOutline, policy: NavigationPolicy, from: DeckPosition, stepsOf: StepsOf): DeckPosition | null;
+/** Jump to a slide, at its first step. Out-of-range clamps into the deck. */
+export declare function goToSlide(outline: DeckOutline, slide: number, stepsOf: StepsOf): DeckPosition | null;
+/** Jump to a chapter coordinate, at the target slide's first step. */
+export declare function goToCoords(outline: DeckOutline, coords: DeckCoords, stepsOf: StepsOf): DeckPosition | null;
+export declare function first(outline: DeckOutline, stepsOf: StepsOf): DeckPosition | null;
+export declare function last(outline: DeckOutline, stepsOf: StepsOf): DeckPosition | null;
+/** True when two positions name the same place · lets a caller skip the work
+ *  of applying a move that changes nothing. */
+export declare function samePosition(a: DeckPosition | null, b: DeckPosition | null): boolean;

package/dist/navigation.js

@@ -0,0 +1 @@
+function s(e,t){if(e.chapters.length===0)return null;let n=l(t.chapter,0,e.chapters.length-1),r=e.chapters[n],o=l(t.index,0,r.length-1);return r.start+o}function l(e,t,n){return Number.isNaN(e)?t:Math.max(t,Math.min(n,e))}var d={loop:!1},i=e=>e.slideCount<=0;function c(e,t,n){if(i(e))return null;let r=l(t.slide,0,e.slideCount-1),o=Math.max(0,n(r));return{slide:r,step:l(t.step,0,o)}}function h(e,t,n,r){if(i(e))return null;let o=Math.max(0,r(n.slide));return n.step<o?{slide:n.slide,step:n.step+1}:n.slide<e.slideCount-1?{slide:n.slide+1,step:0}:t.loop?{slide:0,step:0}:null}function f(e,t,n,r){if(i(e))return null;if(n.step>0)return{slide:n.slide,step:n.step-1};if(n.slide>0){let o=n.slide-1;return{slide:o,step:Math.max(0,r(o))}}if(t.loop){let o=e.slideCount-1;return{slide:o,step:Math.max(0,r(o))}}return null}function u(e,t,n){return c(e,{slide:t,step:0},n)}function k(e,t,n){let r=s(e,t);return r===null?null:c(e,{slide:r,step:0},n)}function D(e,t){return u(e,0,t)}function x(e,t){return u(e,e.slideCount-1,t)}function O(e,t){return e===null||t===null?e===t:e.slide===t.slide&&e.step===t.step}export{d as LINEAR,h as advance,f as back,c as clampPosition,D as first,k as goToCoords,u as goToSlide,x as last,O as samePosition};

package/dist/parse-csv.d.ts

@@ -0,0 +1,9 @@
+/** Parse CSV text into a matrix of rows × cells.
+ *
+ *  A blank spacer line (a single UNQUOTED empty field) is dropped so an author
+ *  can space the source out for readability. A quoted `""` is a value the author
+ *  wrote on purpose and survives · dropping it silently loses data.
+ *
+ *  Row terminators: `\n`, `\r\n` and a lone `\r` (some spreadsheet exports).
+ *  The delimiter may be more than one character. */
+export declare function parseCsv(text: string, delimiter?: string): string[][];

package/dist/parse-csv.js

@@ -0,0 +1,3 @@
+function h(l,r=","){let u=[],a=[],t=[],n="",i=!1,o=!1,g=()=>{t.push(n),n=""},f=()=>{g(),u.push(t),a.push(o),t=[],o=!1};for(let e=0;e<l.length;e++){let s=l[e];if(i){s==='"'?l[e+1]==='"'?(n+='"',e++):i=!1:n+=s;continue}s==='"'?(i=!0,o=!0):l.startsWith(r,e)?(g(),e+=r.length-1):s===`
+`?f():s==="\r"?l[e+1]!==`
+`&&f():n+=s}return(n.length>0||t.length>0)&&f(),u.filter((e,s)=>a[s]||!(e.length===1&&e[0]===""))}export{h as parseCsv};

package/dist/shared-styles.js

@@ -1 +1 @@
-import{css as r}from"./vendor/lit.js";var e=r`:host{display:none;position:absolute;inset:0;padding:var(--rik-slide-padding-y) var(--rik-slide-padding-x);flex-direction:column;overflow:hidden;background:var(--rik-surface-page);font-family:var(--rik-font-sans);color:var(--rik-text-default)}:host([active]){display:flex}`,t=r`h1{font-size:var(--rik-font-size-h1);font-weight:700;color:var(--rik-text-default);letter-spacing:-0.022em;line-height:1.15;margin-bottom:var(--rik-space-4);padding-bottom:var(--rik-space-2);border-bottom:3px solid var(--rik-accent);display:inline-block;align-self:flex-start;flex:0 0 auto}h1 .accent{color:var(--rik-accent)}::slotted(p),p{font-size:var(--rik-font-size-body);line-height:1.65;color:var(--rik-text-default--muted);margin:0}::slotted(strong),strong{color:var(--rik-text-default);font-weight:700}::slotted(code),code{font-family:var(--rik-font-mono);font-size:var(--rik-font-size-mono-sm);background:rgba(0,0,0,0.06);padding:2px 6px;border-radius:var(--rik-radius-sm);color:var(--rik-text-default)}`,a=r`.lbl{display:inline-block;padding:var(--deck-eyebrow-padding-y,4px) var(--deck-eyebrow-padding-x,12px);background:var(--deck-eyebrow-bg,var(--rik-accent));color:var(--deck-eyebrow-color,var(--rik-accent__on,var(--rik-surface-inverse)));border-radius:var(--deck-eyebrow-radius,var(--rik-radius-pill));font-size:var(--rik-font-size-xs);font-weight:700;letter-spacing:0.1em;text-transform:uppercase;margin-bottom:var(--rik-space-1);align-self:flex-start}.lead{font-size:var(--rik-font-size-lead);color:var(--rik-text-default--faint);line-height:1.5;margin-bottom:var(--rik-space-4);max-width:75ch;flex:0 0 auto}.kicker{font-size:var(--rik-font-size-xs);font-weight:700;letter-spacing:0.14em;text-transform:uppercase;color:var(--rik-text-default--faint);margin-bottom:var(--rik-space-3);display:block}.kicker.on-dark{color:rgba(255,255,255,0.35)}.caption{font-size:var(--rik-font-size-sm);color:var(--rik-text-default--faint);line-height:1.55}.caption.on-dark{color:rgba(255,255,255,0.5)}.col-label{font-size:var(--rik-font-size-xs);font-weight:700;letter-spacing:0.08em;text-transform:uppercase;color:var(--rik-text-default--faint);margin-bottom:var(--rik-space-2)}`,i=[e,t,a];export{a as helpers,i as slideBase,e as slideShell,t as typo};
+import{css as t}from"./vendor/lit.js";var e=t`:host{display:none;position:absolute;inset:0;padding:var(--rik-slide-padding-y) var(--rik-slide-padding-x);flex-direction:column;overflow:hidden;background:var(--rik-surface-page);font-family:var(--rik-font-sans);color:var(--rik-text-default)}:host([active]){display:flex}.body,.col{justify-content:var(--_spread,var(--rik-slide-spread,center))}:host([fill]) .body > ::slotted(*),:host([fill]) .col > ::slotted(*){flex:1 1 0;min-height:0}:host([fill]) .body,:host([fill]) .col{justify-content:stretch}@media print{:host{display:flex;position:relative;inset:auto;width:calc(var(--deck-canvas-w,1920) * 1px);height:calc(var(--deck-canvas-h,1080) * 1px);break-inside:avoid;break-after:page;-webkit-print-color-adjust:exact;print-color-adjust:exact}:host(:last-child){break-after:auto}}`,r=t`h1{font-size:var(--rik-font-size-h1);font-weight:700;color:var(--rik-text-default);letter-spacing:-0.022em;line-height:1.15;margin-bottom:var(--rik-space-4);padding-bottom:var(--rik-space-2);border-bottom:3px solid var(--rik-accent);display:inline-block;align-self:flex-start;flex:0 0 auto}h1 .accent{color:var(--rik-accent)}::slotted(p),p{font-size:var(--rik-font-size-body);line-height:1.65;color:var(--rik-text-default--muted);margin:0}::slotted(strong),strong{color:var(--rik-text-default);font-weight:700}::slotted(code),code{font-family:var(--rik-font-mono);font-size:var(--rik-font-size-mono-sm);background:rgba(0,0,0,0.06);padding:2px 6px;border-radius:var(--rik-radius-sm);color:var(--rik-text-default)}`,o=t`.lbl{display:inline-block;padding:var(--deck-eyebrow-padding-y,0) var(--deck-eyebrow-padding-x,0);background:var(--deck-eyebrow-bg,transparent);color:var(--deck-eyebrow-color,var(--rik-accent__text));border-radius:var(--deck-eyebrow-radius,0);font-size:var(--rik-font-size-body);font-weight:600;margin-bottom:var(--rik-space-1);align-self:flex-start}.lead{font-size:var(--rik-font-size-lead);color:var(--rik-text-default--faint);line-height:1.5;margin-bottom:var(--rik-space-4);max-width:75ch;flex:0 0 auto}.kicker{font-size:var(--rik-font-size-xs);font-weight:700;letter-spacing:0.14em;text-transform:uppercase;color:var(--rik-text-default--faint);margin-bottom:var(--rik-space-3);display:block}.kicker.on-dark{color:rgba(255,255,255,0.35)}.caption{font-size:var(--rik-font-size-sm);color:var(--rik-text-default--faint);line-height:1.55}.caption.on-dark{color:rgba(255,255,255,0.5)}.col-label{font-size:var(--rik-font-size-xs);font-weight:700;letter-spacing:0.08em;text-transform:uppercase;color:var(--rik-text-default--faint);margin-bottom:var(--rik-space-2)}`,i=[e,r,o];export{o as helpers,i as slideBase,e as slideShell,r as typo};

package/dist/shiki.d.ts

@@ -0,0 +1,8 @@
+interface InstallOpts {
+    /** Bundled theme · currently 'one-dark-pro'. */
+    theme?: string;
+    /** Bundled languages · ts, js, html, css and json (long aliases accepted). */
+    langs?: string[];
+}
+export declare function installShiki(opts?: InstallOpts): Promise<void>;
+export {};

package/dist/signature.d.ts

@@ -0,0 +1,2 @@
+/** The shared signature · imported by every component in src/extras/. */
+export declare const signature: import("lit").CSSResult;

package/dist/signature.js

@@ -0,0 +1 @@
+import{css as r}from"./vendor/lit.js";var a=r`.mass{background:var(--rik-extras-mass,var(--rik-surface-inverse));color:var(--rik-extras-mass-text,var(--rik-text-inverse));padding:var(--rik-space-3) var(--rik-space-4);border-radius:var(--rik-radius-sm)}.statement{font-family:var(--rik-font-display,var(--rik-font-sans));font-size:var(--rik-extras-statement,var(--rik-font-size-mega));font-weight:800;line-height:0.95;letter-spacing:-0.02em;font-variant-numeric:tabular-nums;overflow-wrap:anywhere}.reading{font-family:var(--rik-font-sans);font-size:var(--rik-extras-reading,var(--rik-font-size-body));font-weight:400;line-height:1.35;max-width:62ch}.quiet{color:var(--rik-extras-quiet,var(--rik-text-default--muted))}.edge{border:0;border-top:1px solid var(--rik-extras-edge,var(--rik-border-default));margin:0}@media (prefers-reduced-motion:reduce){*{transition:none !important;animation:none !important}}`;export{a as signature};

package/dist/slide-fill.d.ts

@@ -0,0 +1,8 @@
+/** The `spread` vocabulary, and the flexbox value each one means. */
+export declare const SPREAD: Map<string, string>;
+/** Resolve a `spread` attribute to its flexbox value.
+ *
+ *  An unknown value falls back to the default distribution instead of being
+ *  passed through: a typo must degrade to the documented default, never remove
+ *  the layout it was meant to change. */
+export declare function spreadValue(raw: string | null | undefined): string;

package/dist/slide-fill.js

@@ -0,0 +1 @@
+var t=new Map([["start","flex-start"],["center","center"],["end","flex-end"],["between","space-between"],["around","space-around"],["evenly","space-evenly"]]);function r(n){let e=(n??"").trim().toLowerCase();return e===""||e==="theme"?"":t.get(e)??""}export{t as SPREAD,r as spreadValue};