rikiki-deck 0.4.0 → 0.5.0

package/docs/llms/rikiki-reference.md

@@ -1,6 +1,6 @@
 # Rikiki · LLM reference
 
-This reference documents rikiki v0.4.0.
+This reference documents rikiki v0.5.0.
 
 Exhaustive, self-consistent reference for authoring valid **rikiki** decks. Every
 tag, attribute, slot, and token below was derived from the source in this repo
@@ -129,10 +129,20 @@ Chevron styling tokens: `--deck-root-nav-color`, `--deck-root-nav-bg`,
 | `nav` | `2d` | Opt into 2D (chapter/slide) navigation · see above |
 | `mouse-nav` | *(absent)* / `none` / subset of `click wheel arrows aux` | Mouse navigation config · see above |
 | `transition` | `slide` (default-ish) / `slide-up` / `slide-down` / `slide-right` / `fade` / `zoom` / `flip` | Deck-wide slide transition (see table below) |
+| `fluid` | *(boolean)* | Fluid rendering · the deck fills its box and reflows like a web page (no logical canvas, no zoom-to-fit scale, no letterbox). Default is zoom-to-fit · see Rendering & sizing below |
+| `width` / `height` | integers (default `1920` / `1080`) | Logical canvas size for zoom-to-fit · only the aspect ratio and the rem baseline depend on these. Ignored in `fluid` mode |
 | `autoplay` | integer ms (e.g. `8000`) | Auto-advance every N ms; pauses on hover, resets on any manual nav. `0`/absent = off |
 | `loop` | *(boolean)* | With `autoplay`, wraps from the last slide back to the first |
 | `swipe` | *(boolean)* | Pointer-driven horizontal swipe (touch + mouse): a swipe ≥ 60 px advances / goes back |
 
+**Rendering & sizing.** By default a deck renders into a fixed logical canvas
+(`width`×`height`, 1920×1080 by default) scaled uniformly to fit the host box,
+so a slide's layout is identical at any window size and the deck is letterboxed
+when the aspect differs. Set `fluid` to opt out: the deck then fills its box and
+reflows like a web page. Either mode is embed-safe · a `<deck-root>` placed
+inside a larger document scales to (or fills) its own container and never
+touches the host page's scroll or typography.
+
 **Transition values** (deck-wide via `transition="…"` on `<deck-root>`, or
 per-slide via `data-transition="…"` on a slide host). When unset, the effective
 default is `fade`:

package/llms.txt

@@ -5,7 +5,7 @@
 > stylesheet, then the component bundle, then write a `<deck-root>` wrapping
 > `deck-*` slide elements. No build step to author or run a deck.
 
-This reference documents rikiki v0.4.0.
+This reference documents rikiki v0.5.0.
 
 The framework is opinionated:
 

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "rikiki-deck",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "A tiny Lit Web Components framework for technical presentations · zero-build for consumers, TypeScript for contributors.",
+  "author": "Cédric Chariere Fiedler <cedric@siliceum.com>",
   "homepage": "https://rikiki.tordu-jardin.fr",
   "repository": {
     "type": "git",
@@ -39,7 +40,7 @@
     "docs/llms"
   ],
   "scripts": {
-    "build": "node build-vendor.mjs && node build.mjs && node build-standalone.mjs && tsc --emitDeclarationOnly",
+    "build": "node build-vendor.mjs && node build.mjs && node build-standalone.mjs && tsc --emitDeclarationOnly -p tsconfig.build.json",
     "vendor": "node build-vendor.mjs",
     "watch": "node build.mjs --watch",
     "typecheck": "tsc --noEmit",
@@ -48,9 +49,16 @@
     "deck": "node build/vite-deck.mjs",
     "deck:example": "node build/vite-deck.mjs decks/example/deck.config.js",
     "test": "vitest run",
-    "bump": "node scripts/bump-version.mjs"
+    "test:e2e": "playwright test",
+    "test:smoke": "playwright test --grep @smoke",
+    "lint": "biome check src scripts",
+    "format": "biome format --write src scripts",
+    "bump": "node scripts/bump-version.mjs",
+    "prepublishOnly": "npm run build && npm test"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@playwright/test": "^1.60.0",
     "esbuild": "^0.24.0",
     "lit": "^3.3.3",
     "marked": "^12.0.2",

package/themes/rikiki.css

@@ -177,7 +177,8 @@
   --rik-font-mono:                    'Space Mono', 'JetBrains Mono', ui-monospace, monospace;
 
   /* Typography · body scale · modular ratio 1.25 (major third) from 1rem.
-     html root-size is `clamp(14px, 2.35vh, 42px)` so rems scale with viewport.
+     html root-size is constant (`canvas-h × 0.0235` ≈ 25px); the deck-root
+     transform scales the whole canvas to fit, so rems never touch the viewport.
      New `--rik-text-*` aliases follow a documented t-shirt scale; the
      historical `--rik-font-size-*` names map to the same values for back-compat. */
   --rik-text-2xs:                     0.64rem;     /* 1 / 1.25^2 */
@@ -277,14 +278,10 @@
 *, *::before, *::after { box-sizing: border-box; }
 body, h1, h2, h3, h4, p, ul, ol, li, blockquote, pre, table, td, th,
 figure, dl, dd { margin: 0; padding: 0; }
-html { font-size: clamp(14px, 2.35vh, 42px); }
-/* Fixed-viewport decks (<deck-root fixed>) anchor the root font-size to the
-   logical canvas height instead of the window, so every rem-based size scales
-   with the letterboxed stage rather than the screen · no reflow off-ratio. */
-html:has(deck-root[fixed]) {
-  font-size: calc(min(100vh, 100vw * var(--deck-canvas-h, 1080) / var(--deck-canvas-w, 1920)) * 0.0235);
-}
-html, body { width: 100%; height: 100%; overflow: hidden; background: var(--rik-surface-page); }
+/* The rem baseline and the no-scroll reset are injected globally by deck-root
+   (theme-independent · see _injectGlobals). The theme only owns the page surface
+   and the type below. */
+html, body { background: var(--rik-surface-page); }
 body { font-family: var(--rik-font-sans); color: var(--rik-text-default); }
 
 ::selection { background: var(--rik-selection__bg); color: var(--rik-selection__text); }

package/themes/siliceum.css

@@ -236,14 +236,10 @@
 *, *::before, *::after { box-sizing: border-box; }
 body, h1, h2, h3, h4, p, ul, ol, li, blockquote, pre, table, td, th,
 figure, dl, dd { margin: 0; padding: 0; }
-html { font-size: clamp(14px, 2.35vh, 42px); }
-/* Fixed-viewport decks (<deck-root fixed>) anchor the root font-size to the
-   logical canvas height instead of the window, so every rem-based size scales
-   with the letterboxed stage rather than the screen · no reflow off-ratio. */
-html:has(deck-root[fixed]) {
-  font-size: calc(min(100vh, 100vw * var(--deck-canvas-h, 1080) / var(--deck-canvas-w, 1920)) * 0.0235);
-}
-html, body { width: 100%; height: 100%; overflow: hidden; background: var(--rik-surface-page); }
+/* The rem baseline and the no-scroll reset are injected globally by deck-root
+   (theme-independent · see _injectGlobals). The theme only owns the page surface
+   and the type below. */
+html, body { background: var(--rik-surface-page); }
 body { font-family: var(--rik-font-sans); color: var(--rik-text-default); }
 
 ::selection { background: var(--rik-selection__bg); color: var(--rik-selection__text); }