@arbidocs/blocks 0.3.184 → 0.4.0

package/dist/lib/balanced-columns.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The column count for a grid of `count` equal tiles in `width` pixels, chosen so the last row is
+ * never left with a lone orphan: of the counts that fit (each column at least `minTile` wide),
+ * take the one that leaves the fewest empty cells in the last row, preferring more columns on a
+ * tie (never fewer than two columns when two fit). Four tiles resolve to 2x2 where three would fit
+ * and 4 across when there is room for four; six resolve to 3x2.
+ */
+export declare function balancedColumns(count: number, width: number, minTile?: number, gap?: number): number;

package/dist/lib/format.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Host-app formatting helpers — currency, initials, dates, durations and
+ * percentages. Dates default to en-GB ("d MMM yyyy"); currency takes an explicit ISO code. Nothing here is
+ * brand-specific, so every host app shares them.
+ *
+ * Dependency-free on purpose (uses the platform `Intl` APIs) so the package
+ * stays light and needs no date library.
+ */
+/** Format an amount in an ISO 4217 currency, e.g. £1,240,000 or £12.4k when `compact`. */
+export declare function formatCurrency(value: number, { currency, locale, compact, }: {
+    currency: string;
+    locale?: string;
+    compact?: boolean;
+}): string;
+/** Initials from a person's name, e.g. "Amara N. Okafor" -> "AO". */
+export declare function initials(name: string): string;
+/** "12 Mar 2026" */
+export declare function fmtDate(iso: string): string;
+/** "12 Mar 2026, 14:30" */
+export declare function fmtDateTime(iso: string): string;
+/** "3 days ago" / "in 2 hours" — largest whole unit, like date-fns strict. */
+export declare function fromNow(iso: string, from?: Date): string;
+/** Signed day count to a date from a reference day. Negative = overdue. */
+export declare function daysUntil(iso: string, from?: Date): number;
+/** Compact hours, e.g. 12.5h */
+export declare function hrs(n: number): string;
+/** Percentage with no decimals, e.g. 82% */
+export declare function pct(n: number): string;
+/**
+ * Page references for a set of cited pages: "p 2", "pp 2, 5", "pp 2–4, 9".
+ *
+ * Pages, not passage counts — the page is what a reader turns to; how many
+ * passages sit inside it is detail they did not ask for. Consecutive pages
+ * collapse into a range, the same way a contiguous run of passages collapses
+ * into a single mark in the viewer.
+ */
+export declare function formatPageRefs(pages: number[]): string;

package/dist/lib/observe-resize.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Observe an element's size. Where `ResizeObserver` does not exist (jsdom, very old webviews)
+ * this is a no-op, so blocks render everywhere without a host-provided polyfill. Returns the
+ * disconnect function.
+ */
+export declare function observeResize(element: Element, callback: ResizeObserverCallback): () => void;

package/dist/lib/password-strength.d.ts

@@ -0,0 +1,24 @@
+/** Bits of estimated entropy at which the meter reads "Strong". */
+export declare const STRONG_BITS = 75;
+export type StrengthScore = 0 | 1 | 2;
+export interface PasswordStrength {
+    /** 0 = rejected, 1 = accepted (minimal), 2 = strong. */
+    score: StrengthScore;
+    label: string;
+}
+/**
+ * Estimated entropy in bits (length x log2(alphabet)). Length is the dominant term, which is also
+ * what NIST SP 800-63B recommends over composition rules: a 25-character passphrase of plain words
+ * outranks "Password123!".
+ */
+export declare function estimateEntropyBits(password: string): number;
+/**
+ * Three states matching the three colours the form uses: rejected (does not meet the host's
+ * requirements), accepted ("could be better") and strong.
+ */
+export declare function getPasswordStrength(password: string, meetsRequirements: boolean): PasswordStrength;
+/**
+ * Advice computed from the same entropy estimate as the meter, so the hint can never tell you to
+ * do something that would not actually move it.
+ */
+export declare function getStrengthHint(password: string): string;

package/dist/lib/sidebar-mode.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Headless sidebar behaviour (no DOM, no store): how the sidebar lays out for a given set of
+ * inputs, and the settle timing that keeps labels/tips from squeezing during the width transition.
+ *
+ *  - `drawer`    small-screen off-canvas panel (opened by the app bar's menu button)
+ *  - `collapsed` hidden (width 0) and only revealed while `isPeeking` is on
+ *  - `pinned`    full width, inline, pushes the content
+ *  - `rail`      icon strip that floats open to full width while hovered
+ */
+export type SidebarMode = 'drawer' | 'collapsed' | 'pinned' | 'rail';
+export interface SidebarModeInput {
+    isSmallScreen: boolean;
+    /** The phone drawer was requested open. */
+    isDrawerRequested: boolean;
+    isCollapsed: boolean;
+    isPinned: boolean;
+    isHovering: boolean;
+    /** The pointer is over the collapsed-sidebar reveal target. */
+    isPeeking?: boolean;
+    /**
+     * Tablet-width viewport (above the phone drawer breakpoint but too narrow to give the content a
+     * usable column next to a 255px panel): pinning is ignored and the sidebar stays an icon rail.
+     */
+    isNarrow?: boolean;
+}
+export interface SidebarLayout {
+    mode: SidebarMode;
+    /** Labels should be shown (the panel is, or is becoming, full width). */
+    expanded: boolean;
+    /** Phones: nothing is rendered until the drawer opens. */
+    hidden: boolean;
+    /** Hover state that actually applies (never on touch-sized screens). */
+    hovering: boolean;
+}
+export declare function resolveSidebarLayout(input: SidebarModeInput): SidebarLayout;
+/**
+ * Settle timing around the width transition (default 300ms):
+ *  - `labelsExpanded` switches on immediately but off only after the transition, so labels do not
+ *    snap to icon-only while the panel is still wide;
+ *  - `tipsVisible` is the opposite: width-bound content (a tip card) appears only once the panel
+ *    has fully opened and disappears the instant collapse starts.
+ */
+export declare function useSidebarSettle(expanded: boolean, settleMs?: number): {
+    labelsExpanded: boolean;
+    tipsVisible: boolean;
+};

package/dist/lib/testid.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Compose a stable, kebab-case data-testid from parts.
+ * Convention: {area}-{element}[-{qualifier}...]
+ *   tid("orders", "row", "CLM-2026-0042") -> "orders-row-clm-2026-0042"
+ * Keeps Playwright selectors predictable across a host app.
+ */
+export declare function tid(...parts: Array<string | number | undefined | false>): string;

package/dist/lib/use-drawer.d.ts

@@ -0,0 +1,11 @@
+import { type RefObject } from 'react';
+/**
+ * Behaviour of a modal surface (off-canvas drawer, full-screen dock) while it is open: the page
+ * behind does not scroll, Escape closes it, focus moves inside and Tab/Shift+Tab cycle within it
+ * (portalled popovers opened from inside stay reachable: only the wrap-around is intercepted),
+ * and focus returns to the opener on close. Restores the previous body overflow on close/unmount.
+ *
+ * Pass `containerRef` (the element carrying `role="dialog"`) to get the focus handling; without it
+ * only scroll lock and Escape apply.
+ */
+export declare function useDrawerBehavior(isOpen: boolean, onClose: () => void, containerRef?: RefObject<HTMLElement | null>): void;

package/dist/lib/useControllableState.d.ts

@@ -0,0 +1,5 @@
+/**
+ * State that is controlled when `value` is passed and uncontrolled (seeded by `defaultValue`)
+ * otherwise. `onChange` fires in both modes.
+ */
+export declare function useControllableState<T>(value: T | undefined, defaultValue: T, onChange?: (next: T) => void): [T, (next: T) => void];

package/dist/lib/useDismissibleCard.d.ts

@@ -0,0 +1,15 @@
+import { type RefObject } from 'react';
+export interface UseDismissibleCardOptions {
+    isOpen: boolean;
+    onClose: () => void;
+    /** The card's content: clicks inside never dismiss. */
+    contentRef: RefObject<HTMLElement | null>;
+    /** Focused when the card opens (the panel is opened to find something: typing just works). */
+    focusRef?: RefObject<HTMLElement | null>;
+}
+/**
+ * Behaviour of a click-opened card: focus its search box on open, Escape closes it, and a press
+ * outside it (or outside any portaled popper that belongs to it, e.g. a dropdown menu opened from
+ * inside) closes it too. Bound only while open.
+ */
+export declare function useDismissibleCard({ isOpen, onClose, contentRef, focusRef, }: UseDismissibleCardOptions): void;

package/dist/lib/useListKeyNav.d.ts

@@ -0,0 +1,42 @@
+import { type KeyboardEvent } from 'react';
+/** Id of the option at `index` in the listbox `listboxId`. Rows and the combobox agree on it. */
+export declare function listOptionId(listboxId: string, index: number): string;
+export interface UseListKeyNavOptions<T> {
+    /** Whether the list is currently shown. Keys fall through when false. */
+    open: boolean;
+    items: ReadonlyArray<T>;
+    /** Enter / Tab on the highlighted row. */
+    onPick: (item: T) => void;
+    /** Escape. */
+    onDismiss?: () => void;
+    /** Changing this resets the highlight to the first row (e.g. the filter query). */
+    resetKey?: unknown;
+}
+/** ARIA attributes that make the text field the combobox that owns the list. */
+export interface ListComboboxProps {
+    role: 'combobox';
+    'aria-autocomplete': 'list';
+    'aria-haspopup': 'listbox';
+    'aria-expanded': true;
+    'aria-controls': string;
+    'aria-activedescendant': string;
+}
+export interface UseListKeyNav {
+    /** Pass to the list (`listboxId`) so the field's `aria-controls` points at it. */
+    listboxId: string;
+    /**
+     * Spread onto the text field (`<input>` or `<textarea>`). Empty while the list is closed, so a
+     * prompt that is usually just a text box is not announced as a collapsed combobox; it becomes
+     * the combobox (expanded, with its active option) the moment the list opens.
+     */
+    comboboxProps: ListComboboxProps | Record<string, never>;
+    selectedIndex: number;
+    setSelectedIndex: (index: number) => void;
+    /** Call first in the textarea `onKeyDown`. Returns true when the key was consumed. */
+    handleKeyDown: (event: KeyboardEvent<HTMLElement>) => boolean;
+}
+/**
+ * Headless keyboard navigation for an autocomplete list that sits over a text field:
+ * ArrowUp/ArrowDown wrap, Enter/Tab pick, Escape dismisses. Only consumes keys while open.
+ */
+export declare function useListKeyNav<T>({ open, items, onPick, onDismiss, resetKey, }: UseListKeyNavOptions<T>): UseListKeyNav;

package/dist/lib/useLongPaste.d.ts

@@ -0,0 +1,15 @@
+import { type ClipboardEvent } from 'react';
+/** True when the text is big enough that a composer should fold it behind a "Pasted text" chip. */
+export declare function isLongPastedText(value: string): boolean;
+export interface UseLongPaste {
+    /** The draft is long AND the user pasted it (typing a long text never folds it). */
+    isCollapsed: boolean;
+    /** Wire to the textarea `onPaste`. Folds when the post-paste draft is long. */
+    onPaste: (event: ClipboardEvent<HTMLTextAreaElement>, currentValue: string) => void;
+    /** Wire to the textarea `onChange`: unfolds once the draft is short again. */
+    onValueChange: (nextValue: string) => void;
+    /** Unfold (the "Expand" chip). */
+    expand: () => void;
+}
+/** Headless long-paste folding for a composer draft. */
+export declare function useLongPaste(value: string): UseLongPaste;

package/dist/lib/useRestoreFocus.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Props for a Radix `DialogContent` that put focus back where it was when the dialog opened.
+ *
+ * Radix Dialog returns focus to its `Trigger` on close and, when the dialog is opened from state
+ * (no `DialogTrigger`, as every controlled dialog in the blocks is), drops it to `<body>`:
+ * a keyboard or screen-reader user loses their place. Spread the result on `DialogContent`.
+ */
+export declare function useRestoreFocus(): {
+    onOpenAutoFocus: (event: Event) => void;
+    onCloseAutoFocus: (event: Event) => void;
+};

package/dist/lib/useScopeSelection.d.ts

@@ -0,0 +1,34 @@
+/** Which folders and labels a run is limited to. Empty = everything. */
+export interface DocumentScope {
+    /** Folder paths; `''` is the "unfiled" bucket. */
+    folders: string[];
+    /** Label (tag) ids. */
+    labels: string[];
+}
+export interface UseScopeSelectionOptions {
+    /** Every folder path in the tree (not including the unfiled bucket). */
+    folderPaths: string[];
+    /** Whether the unfiled bucket is shown as a row. */
+    hasUnfiled: boolean;
+    scope: DocumentScope;
+    onScopeChange: (scope: DocumentScope) => void;
+}
+/**
+ * Headless selection logic for a folder + label scope picker.
+ *
+ * Folders use hierarchical selection: ticking "contracts" also ticks
+ * "contracts/2024", and unticking removes the whole subtree. "All" ticks every
+ * row, which is NOT the same as an empty scope: empty means "the whole
+ * workspace, whatever lands in it later", all-ticked means "these folders, as
+ * they are now".
+ */
+export declare function useScopeSelection({ folderPaths, hasUnfiled, scope, onScopeChange, }: UseScopeSelectionOptions): {
+    selectedFolders: Set<string>;
+    selectedLabels: Set<string>;
+    allSelected: boolean;
+    someSelected: boolean;
+    hasSelection: boolean;
+    toggleFolder: (path: string) => void;
+    toggleAllFolders: () => void;
+    toggleLabel: (labelId: string) => void;
+};

package/dist/nav/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Navigation shapes shared by host app shells. The concrete nav manifest (which
+ * modules, in what order) is per-app data the app supplies; these interfaces
+ * give it a typed contract the shared shell can render.
+ */
+import type { LucideIcon } from 'lucide-react';
+export interface AppNavItem {
+    to: string;
+    label: string;
+    icon: LucideIcon;
+    id: string;
+    /** true for ARBI-powered modules (document management + agentic AI). */
+    arbi?: boolean;
+    end?: boolean;
+}
+export interface AppNavSection {
+    heading: string;
+    items: AppNavItem[];
+}

package/dist/provider/BlocksProvider.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode } from 'react';
+import type { BlockLinkComponent } from '../components/blockLink';
+/**
+ * The only way blocks reach the host app's environment. Blocks never import a router, a toast
+ * library or an app store; the host injects what it has, and every field has a safe default so a
+ * block renders correctly with no provider at all.
+ */
+export interface BlocksEnvironment {
+    /** Router-aware link (keeps navigation in-SPA). Default: a plain `<a href>`. */
+    linkComponent?: BlockLinkComponent;
+    /** Imperative navigation for buttons and keyboard shortcuts. Default: `window.location.assign`. */
+    navigate: (href: string) => void;
+    /** Surface a transient message. Default: no-op. */
+    notify: (message: string, kind?: 'success' | 'error' | 'info') => void;
+}
+export interface BlocksProviderProps extends Partial<BlocksEnvironment> {
+    children: ReactNode;
+}
+export declare function BlocksProvider({ children, linkComponent, navigate, notify }: BlocksProviderProps): import("react").JSX.Element;
+export declare function useBlocksEnvironment(): BlocksEnvironment;

package/dist/provider/TooltipScope.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+/**
+ * A TooltipProvider that mounts once: inside another `BlocksTooltipProvider` (e.g. a Sidebar under
+ * Shell.Root) it renders its children as-is, so tooltips share one delay group. Blocks that show
+ * tooltips use this instead of the kit's provider.
+ */
+export declare function BlocksTooltipProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/record/index.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-var test = require('@playwright/test');
-
 // src/record/index.ts
 var DEFAULTS = {
   displayFont: "ui-serif, Georgia, serif",
@@ -149,14 +147,14 @@ function createCinematic(config) {
       await page.getByTestId(ids.email).fill(config.creds.email);
       await page.getByTestId(ids.password).fill(config.creds.password);
       await page.getByTestId(ids.submit).click();
-      await test.expect(page).toHaveURL(appUrlPattern, { timeout: 45e3 });
+      await page.waitForURL(appUrlPattern, { timeout: 45e3 });
       return;
     }
     await caption(page, opts.caption ?? `${b.firmLabel} \u2014 signing in.`, 1600);
     await type(page, ids.email, config.creds.email);
     await type(page, ids.password, config.creds.password);
     await click(page, ids.submit);
-    await test.expect(page).toHaveURL(appUrlPattern, { timeout: 45e3 });
+    await page.waitForURL(appUrlPattern, { timeout: 45e3 });
     await beat(page, 800);
   }
   return {

package/dist/record/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/record/index.ts"],"names":["kicker","title","subtitle","expect"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Cinematic recording harness — firm-agnostic.\n *\n * Turns a Playwright run into a narrated product demo: a visible cursor that\n * glides between targets, a click ripple, a caption bar that narrates each step,\n * full-screen chapter \"cover\" cards, and human-speed pacing. Every firm app gets\n * the same polished demo capability from one factory — brand colours, fonts,\n * credentials and the login flow arrive as config, so nothing here names a firm.\n *\n * Pair with a Playwright project that records video (see the firm's\n * `playwright.record.config.ts`: video on, a large viewport, some slowMo).\n *\n * Usage in a `*.record.ts` spec:\n *   const cine = createCinematic({ brand, creds })\n *   await cine.installStage(page)          // before the first navigation\n *   await cine.cover(page, { kicker, title, subtitle })\n *   await cine.login(page)\n *   await cine.uncover(page)\n *   await cine.caption(page, \"Opening the flagship matter…\")\n *   await cine.click(page, \"matters-row-…\")\n *\n * `@playwright/test` is a peer dependency — it is only imported by e2e specs, so\n * it never reaches an app bundle.\n */\nimport { type Page, type Locator, expect } from '@playwright/test'\n\n/** Brand skin for the on-screen chrome. All optional — sensible neutral defaults. */\nexport interface CinematicBrand {\n  /** Footer line on chapter cards, e.g. \"Meridian · AI-native counsel\". */\n  firmLabel: string\n  /** Serif display font for cover titles (CSS font-family value). */\n  displayFont?: string\n  /** Sans font for captions + cover body. */\n  sansFont?: string\n  /** Cursor dot radial-gradient stops. */\n  cursor?: { from: string; to: string }\n  /** Click-ripple ring colour. */\n  ripple?: string\n  /** Chapter-card background gradient stops. */\n  cover?: { from: string; mid: string; to: string }\n  /** Accent (kicker text + rule) on chapter cards. */\n  accent?: string\n  /** Caption bar background base colour. */\n  ink?: string\n  /** Cover title text colour. */\n  coverTitle?: string\n}\n\nexport interface CinematicCreds {\n  email: string\n  password: string\n}\n\nexport interface CinematicConfig {\n  brand: CinematicBrand\n  creds: CinematicCreds\n  /** Login route (default \"/app/login\"). */\n  loginPath?: string\n  /** URL the app lands on after auth (default /\\/app$/). */\n  appUrlPattern?: RegExp\n  /** Login form testids (defaults match the shared AppShell/login convention). */\n  testIds?: { email?: string; password?: string; submit?: string }\n}\n\nexport interface Cinematic {\n  installStage(page: Page): Promise<void>\n  cover(\n    page: Page,\n    opts: { kicker: string; title: string; subtitle?: string },\n    holdMs?: number\n  ): Promise<void>\n  uncover(page: Page): Promise<void>\n  caption(page: Page, text: string, holdMs?: number): Promise<void>\n  clearCaption(page: Page): Promise<void>\n  beat(page: Page, ms?: number): Promise<void>\n  glideTo(page: Page, target: string | Locator): Promise<Locator>\n  click(page: Page, target: string | Locator): Promise<void>\n  type(page: Page, target: string | Locator, text: string): Promise<void>\n  /** Sign in. `{ show: false }` authenticates fast + silent (no animation/caption). */\n  login(page: Page, opts?: { show?: boolean; caption?: string }): Promise<void>\n}\n\nconst DEFAULTS = {\n  displayFont: 'ui-serif, Georgia, serif',\n  sansFont: 'Inter, ui-sans-serif, system-ui, sans-serif',\n  cursor: { from: 'rgba(31,111,235,.98)', to: 'rgba(11,42,74,.92)' },\n  ripple: 'rgba(11,42,74,.85)',\n  cover: { from: '#0b1622', mid: '#0e1b2c', to: '#1f6feb' },\n  accent: '#c9a24b',\n  ink: '#0e1b2d',\n  coverTitle: '#f4f6f8',\n}\n\nexport function createCinematic(config: CinematicConfig): Cinematic {\n  const b = config.brand\n  const skin = {\n    firmLabel: b.firmLabel,\n    displayFont: b.displayFont ?? DEFAULTS.displayFont,\n    sansFont: b.sansFont ?? DEFAULTS.sansFont,\n    cursorFrom: b.cursor?.from ?? DEFAULTS.cursor.from,\n    cursorTo: b.cursor?.to ?? DEFAULTS.cursor.to,\n    ripple: b.ripple ?? DEFAULTS.ripple,\n    coverFrom: b.cover?.from ?? DEFAULTS.cover.from,\n    coverMid: b.cover?.mid ?? DEFAULTS.cover.mid,\n    coverTo: b.cover?.to ?? DEFAULTS.cover.to,\n    accent: b.accent ?? DEFAULTS.accent,\n    ink: b.ink ?? DEFAULTS.ink,\n    coverTitle: b.coverTitle ?? DEFAULTS.coverTitle,\n  }\n  const loginPath = config.loginPath ?? '/app/login'\n  const appUrlPattern = config.appUrlPattern ?? /\\/app$/\n  const ids = {\n    email: config.testIds?.email ?? 'auth-email',\n    password: config.testIds?.password ?? 'auth-password',\n    submit: config.testIds?.submit ?? 'auth-login-submit',\n  }\n\n  const resolve = (page: Page, t: string | Locator): Locator =>\n    typeof t === 'string' ? page.getByTestId(t) : t\n\n  async function installStage(page: Page): Promise<void> {\n    await page.addInitScript((s: typeof skin) => {\n      const boot = () => {\n        if (document.getElementById('__cine_cursor')) return\n\n        const cursor = document.createElement('div')\n        cursor.id = '__cine_cursor'\n        cursor.style.cssText =\n          'position:fixed;left:0;top:0;z-index:2147483647;width:22px;height:22px;' +\n          'margin:-11px 0 0 -11px;border-radius:50%;pointer-events:none;' +\n          'transition:transform .09s ease-out;' +\n          `background:radial-gradient(circle at 35% 35%, ${s.cursorFrom}, ${s.cursorTo});` +\n          'box-shadow:0 0 0 3px rgba(255,255,255,.6),0 2px 10px rgba(0,0,0,.4);'\n        document.body.appendChild(cursor)\n\n        window.addEventListener(\n          'mousemove',\n          (e) => {\n            cursor.style.transform = `translate(${(e as MouseEvent).clientX}px,${(e as MouseEvent).clientY}px)`\n          },\n          true\n        )\n        window.addEventListener(\n          'mousedown',\n          (e) => {\n            const m = e as MouseEvent\n            const r = document.createElement('div')\n            r.style.cssText =\n              `position:fixed;left:${m.clientX}px;top:${m.clientY}px;z-index:2147483646;` +\n              'width:12px;height:12px;margin:-6px 0 0 -6px;border-radius:50%;pointer-events:none;' +\n              `border:2px solid ${s.ripple};animation:__cine_ripple .55s ease-out forwards;`\n            document.body.appendChild(r)\n            setTimeout(() => r.remove(), 600)\n          },\n          true\n        )\n\n        const cap = document.createElement('div')\n        cap.id = '__cine_cap'\n        cap.style.cssText =\n          'position:fixed;left:50%;bottom:34px;transform:translateX(-50%) translateY(8px);' +\n          'z-index:2147483646;max-width:72%;padding:13px 24px;border-radius:13px;' +\n          `font:500 17px/1.45 ${s.sansFont};color:#fff;letter-spacing:.01em;` +\n          `background:${s.ink}e0;backdrop-filter:blur(7px);` +\n          'box-shadow:0 10px 34px rgba(0,0,0,.4);text-align:center;opacity:0;transition:opacity .35s,transform .35s;'\n        document.body.appendChild(cap)\n\n        const style = document.createElement('style')\n        style.textContent =\n          '@keyframes __cine_ripple{to{width:46px;height:46px;margin:-23px 0 0 -23px;opacity:0}}'\n        document.head.appendChild(style)\n\n        ;(window as unknown as { __cine_cap: (t: string) => void }).__cine_cap = (t: string) => {\n          cap.textContent = t\n          cap.style.opacity = t ? '1' : '0'\n          cap.style.transform = `translateX(-50%) translateY(${t ? 0 : 8}px)`\n        }\n      }\n      if (document.body) boot()\n      else document.addEventListener('DOMContentLoaded', boot)\n    }, skin)\n  }\n\n  async function cover(\n    page: Page,\n    { kicker, title, subtitle }: { kicker: string; title: string; subtitle?: string },\n    holdMs = 2600\n  ): Promise<void> {\n    await page.evaluate(\n      ({ kicker, title, subtitle, s }) => {\n        document.getElementById('__cine_cover')?.remove()\n        const el = document.createElement('div')\n        el.id = '__cine_cover'\n        el.style.cssText =\n          'position:fixed;inset:0;z-index:2147483647;display:flex;flex-direction:column;' +\n          'align-items:center;justify-content:center;text-align:center;padding:0 8%;' +\n          `background:linear-gradient(135deg,${s.coverFrom} 0%,${s.coverMid} 48%,${s.coverTo} 165%);` +\n          `opacity:0;transition:opacity .5s ease;font-family:${s.sansFont};`\n        el.innerHTML =\n          `<div style=\"text-transform:uppercase;letter-spacing:.26em;font-size:13px;font-weight:600;color:${s.accent};margin-bottom:22px\">${kicker}</div>` +\n          `<div style=\"font-family:${s.displayFont};font-weight:600;font-size:52px;line-height:1.08;letter-spacing:-.02em;color:${s.coverTitle};max-width:16ch\">${title}</div>` +\n          (subtitle\n            ? `<div style=\"margin-top:22px;font-size:19px;line-height:1.5;color:${s.coverTitle}b8;max-width:46ch\">${subtitle}</div>`\n            : '') +\n          `<div style=\"margin-top:44px;display:flex;align-items:center;gap:10px;color:${s.coverTitle}80;font-size:13px;letter-spacing:.02em\">` +\n          `<span style=\"width:26px;height:1px;background:${s.accent}\"></span>${s.firmLabel}</div>`\n        document.body.appendChild(el)\n        requestAnimationFrame(() => (el.style.opacity = '1'))\n      },\n      { kicker, title, subtitle: subtitle ?? '', s: skin }\n    )\n    await page.waitForTimeout(holdMs)\n  }\n\n  async function uncover(page: Page): Promise<void> {\n    await page.evaluate(() => {\n      const el = document.getElementById('__cine_cover')\n      if (!el) return\n      el.style.opacity = '0'\n      setTimeout(() => el.remove(), 520)\n    })\n    await page.waitForTimeout(560)\n  }\n\n  async function caption(page: Page, text: string, holdMs?: number): Promise<void> {\n    await page.evaluate(\n      (t) => (window as unknown as { __cine_cap?: (s: string) => void }).__cine_cap?.(t),\n      text\n    )\n    const hold = holdMs ?? Math.min(4200, 900 + text.length * 45)\n    await page.waitForTimeout(hold)\n  }\n\n  async function clearCaption(page: Page): Promise<void> {\n    await page.evaluate(() =>\n      (window as unknown as { __cine_cap?: (s: string) => void }).__cine_cap?.('')\n    )\n  }\n\n  async function beat(page: Page, ms = 650): Promise<void> {\n    await page.waitForTimeout(ms)\n  }\n\n  async function glideTo(page: Page, target: string | Locator): Promise<Locator> {\n    const loc = resolve(page, target).first()\n    await loc.scrollIntoViewIfNeeded().catch(() => {})\n    const box = await loc.boundingBox()\n    if (box) {\n      await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2, { steps: 26 })\n      await page.waitForTimeout(180)\n    }\n    return loc\n  }\n\n  async function click(page: Page, target: string | Locator): Promise<void> {\n    const loc = await glideTo(page, target)\n    await loc.click()\n    await page.waitForTimeout(260)\n  }\n\n  async function type(page: Page, target: string | Locator, text: string): Promise<void> {\n    const loc = await glideTo(page, target)\n    await loc.click()\n    await loc.fill('')\n    await loc.pressSequentially(text, { delay: 42 })\n    await page.waitForTimeout(240)\n  }\n\n  async function login(page: Page, opts: { show?: boolean; caption?: string } = {}): Promise<void> {\n    await page.goto(loginPath)\n    if (opts.show === false) {\n      await page.getByTestId(ids.email).fill(config.creds.email)\n      await page.getByTestId(ids.password).fill(config.creds.password)\n      await page.getByTestId(ids.submit).click()\n      await expect(page).toHaveURL(appUrlPattern, { timeout: 45_000 })\n      return\n    }\n    await caption(page, opts.caption ?? `${b.firmLabel} — signing in.`, 1600)\n    await type(page, ids.email, config.creds.email)\n    await type(page, ids.password, config.creds.password)\n    await click(page, ids.submit)\n    await expect(page).toHaveURL(appUrlPattern, { timeout: 45_000 })\n    await beat(page, 800)\n  }\n\n  return {\n    installStage,\n    cover,\n    uncover,\n    caption,\n    clearCaption,\n    beat,\n    glideTo,\n    click,\n    type,\n    login,\n  }\n}\n"]}
+{"version":3,"sources":["../../src/record/index.ts"],"names":["kicker","title","subtitle"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Cinematic recording harness — host-agnostic.\n *\n * Turns a Playwright run into a narrated product demo: a visible cursor that\n * glides between targets, a click ripple, a caption bar that narrates each step,\n * full-screen chapter \"cover\" cards, and human-speed pacing. Every host app gets\n * the same polished demo capability from one factory — brand colours, fonts,\n * credentials and the login flow arrive as config, so nothing here names a host.\n *\n * Pair with a Playwright project that records video (see the host's\n * `playwright.record.config.ts`: video on, a large viewport, some slowMo).\n *\n * Usage in a `*.record.ts` spec:\n *   const cine = createCinematic({ brand, creds })\n *   await cine.installStage(page)          // before the first navigation\n *   await cine.cover(page, { kicker, title, subtitle })\n *   await cine.login(page)\n *   await cine.uncover(page)\n *   await cine.caption(page, \"Opening the flagship matter…\")\n *   await cine.click(page, \"matters-row-…\")\n *\n * `@playwright/test` is an optional peer used for TYPES only (no runtime import), so\n * importing this entry never loads Playwright.\n */\nimport type { Page, Locator } from '@playwright/test'\n\n/** Brand skin for the on-screen chrome. All optional — sensible neutral defaults. */\nexport interface CinematicBrand {\n  /** Footer line on chapter cards, e.g. \"Meridian · AI-native counsel\". */\n  firmLabel: string\n  /** Serif display font for cover titles (CSS font-family value). */\n  displayFont?: string\n  /** Sans font for captions + cover body. */\n  sansFont?: string\n  /** Cursor dot radial-gradient stops. */\n  cursor?: { from: string; to: string }\n  /** Click-ripple ring colour. */\n  ripple?: string\n  /** Chapter-card background gradient stops. */\n  cover?: { from: string; mid: string; to: string }\n  /** Accent (kicker text + rule) on chapter cards. */\n  accent?: string\n  /** Caption bar background base colour. */\n  ink?: string\n  /** Cover title text colour. */\n  coverTitle?: string\n}\n\nexport interface CinematicCreds {\n  email: string\n  password: string\n}\n\nexport interface CinematicConfig {\n  brand: CinematicBrand\n  creds: CinematicCreds\n  /** Login route (default \"/app/login\"). */\n  loginPath?: string\n  /** URL the app lands on after auth (default /\\/app$/). */\n  appUrlPattern?: RegExp\n  /** Login form testids (defaults match the shared AppShell/login convention). */\n  testIds?: { email?: string; password?: string; submit?: string }\n}\n\nexport interface Cinematic {\n  installStage(page: Page): Promise<void>\n  cover(\n    page: Page,\n    opts: { kicker: string; title: string; subtitle?: string },\n    holdMs?: number\n  ): Promise<void>\n  uncover(page: Page): Promise<void>\n  caption(page: Page, text: string, holdMs?: number): Promise<void>\n  clearCaption(page: Page): Promise<void>\n  beat(page: Page, ms?: number): Promise<void>\n  glideTo(page: Page, target: string | Locator): Promise<Locator>\n  click(page: Page, target: string | Locator): Promise<void>\n  type(page: Page, target: string | Locator, text: string): Promise<void>\n  /** Sign in. `{ show: false }` authenticates fast + silent (no animation/caption). */\n  login(page: Page, opts?: { show?: boolean; caption?: string }): Promise<void>\n}\n\nconst DEFAULTS = {\n  displayFont: 'ui-serif, Georgia, serif',\n  sansFont: 'Inter, ui-sans-serif, system-ui, sans-serif',\n  cursor: { from: 'rgba(31,111,235,.98)', to: 'rgba(11,42,74,.92)' },\n  ripple: 'rgba(11,42,74,.85)',\n  cover: { from: '#0b1622', mid: '#0e1b2c', to: '#1f6feb' },\n  accent: '#c9a24b',\n  ink: '#0e1b2d',\n  coverTitle: '#f4f6f8',\n}\n\nexport function createCinematic(config: CinematicConfig): Cinematic {\n  const b = config.brand\n  const skin = {\n    firmLabel: b.firmLabel,\n    displayFont: b.displayFont ?? DEFAULTS.displayFont,\n    sansFont: b.sansFont ?? DEFAULTS.sansFont,\n    cursorFrom: b.cursor?.from ?? DEFAULTS.cursor.from,\n    cursorTo: b.cursor?.to ?? DEFAULTS.cursor.to,\n    ripple: b.ripple ?? DEFAULTS.ripple,\n    coverFrom: b.cover?.from ?? DEFAULTS.cover.from,\n    coverMid: b.cover?.mid ?? DEFAULTS.cover.mid,\n    coverTo: b.cover?.to ?? DEFAULTS.cover.to,\n    accent: b.accent ?? DEFAULTS.accent,\n    ink: b.ink ?? DEFAULTS.ink,\n    coverTitle: b.coverTitle ?? DEFAULTS.coverTitle,\n  }\n  const loginPath = config.loginPath ?? '/app/login'\n  const appUrlPattern = config.appUrlPattern ?? /\\/app$/\n  const ids = {\n    email: config.testIds?.email ?? 'auth-email',\n    password: config.testIds?.password ?? 'auth-password',\n    submit: config.testIds?.submit ?? 'auth-login-submit',\n  }\n\n  const resolve = (page: Page, t: string | Locator): Locator =>\n    typeof t === 'string' ? page.getByTestId(t) : t\n\n  async function installStage(page: Page): Promise<void> {\n    await page.addInitScript((s: typeof skin) => {\n      const boot = () => {\n        if (document.getElementById('__cine_cursor')) return\n\n        const cursor = document.createElement('div')\n        cursor.id = '__cine_cursor'\n        cursor.style.cssText =\n          'position:fixed;left:0;top:0;z-index:2147483647;width:22px;height:22px;' +\n          'margin:-11px 0 0 -11px;border-radius:50%;pointer-events:none;' +\n          'transition:transform .09s ease-out;' +\n          `background:radial-gradient(circle at 35% 35%, ${s.cursorFrom}, ${s.cursorTo});` +\n          'box-shadow:0 0 0 3px rgba(255,255,255,.6),0 2px 10px rgba(0,0,0,.4);'\n        document.body.appendChild(cursor)\n\n        window.addEventListener(\n          'mousemove',\n          (e) => {\n            cursor.style.transform = `translate(${(e as MouseEvent).clientX}px,${(e as MouseEvent).clientY}px)`\n          },\n          true\n        )\n        window.addEventListener(\n          'mousedown',\n          (e) => {\n            const m = e as MouseEvent\n            const r = document.createElement('div')\n            r.style.cssText =\n              `position:fixed;left:${m.clientX}px;top:${m.clientY}px;z-index:2147483646;` +\n              'width:12px;height:12px;margin:-6px 0 0 -6px;border-radius:50%;pointer-events:none;' +\n              `border:2px solid ${s.ripple};animation:__cine_ripple .55s ease-out forwards;`\n            document.body.appendChild(r)\n            setTimeout(() => r.remove(), 600)\n          },\n          true\n        )\n\n        const cap = document.createElement('div')\n        cap.id = '__cine_cap'\n        cap.style.cssText =\n          'position:fixed;left:50%;bottom:34px;transform:translateX(-50%) translateY(8px);' +\n          'z-index:2147483646;max-width:72%;padding:13px 24px;border-radius:13px;' +\n          `font:500 17px/1.45 ${s.sansFont};color:#fff;letter-spacing:.01em;` +\n          `background:${s.ink}e0;backdrop-filter:blur(7px);` +\n          'box-shadow:0 10px 34px rgba(0,0,0,.4);text-align:center;opacity:0;transition:opacity .35s,transform .35s;'\n        document.body.appendChild(cap)\n\n        const style = document.createElement('style')\n        style.textContent =\n          '@keyframes __cine_ripple{to{width:46px;height:46px;margin:-23px 0 0 -23px;opacity:0}}'\n        document.head.appendChild(style)\n\n        ;(window as unknown as { __cine_cap: (t: string) => void }).__cine_cap = (t: string) => {\n          cap.textContent = t\n          cap.style.opacity = t ? '1' : '0'\n          cap.style.transform = `translateX(-50%) translateY(${t ? 0 : 8}px)`\n        }\n      }\n      if (document.body) boot()\n      else document.addEventListener('DOMContentLoaded', boot)\n    }, skin)\n  }\n\n  async function cover(\n    page: Page,\n    { kicker, title, subtitle }: { kicker: string; title: string; subtitle?: string },\n    holdMs = 2600\n  ): Promise<void> {\n    await page.evaluate(\n      ({ kicker, title, subtitle, s }) => {\n        document.getElementById('__cine_cover')?.remove()\n        const el = document.createElement('div')\n        el.id = '__cine_cover'\n        el.style.cssText =\n          'position:fixed;inset:0;z-index:2147483647;display:flex;flex-direction:column;' +\n          'align-items:center;justify-content:center;text-align:center;padding:0 8%;' +\n          `background:linear-gradient(135deg,${s.coverFrom} 0%,${s.coverMid} 48%,${s.coverTo} 165%);` +\n          `opacity:0;transition:opacity .5s ease;font-family:${s.sansFont};`\n        el.innerHTML =\n          `<div style=\"text-transform:uppercase;letter-spacing:.26em;font-size:13px;font-weight:600;color:${s.accent};margin-bottom:22px\">${kicker}</div>` +\n          `<div style=\"font-family:${s.displayFont};font-weight:600;font-size:52px;line-height:1.08;letter-spacing:-.02em;color:${s.coverTitle};max-width:16ch\">${title}</div>` +\n          (subtitle\n            ? `<div style=\"margin-top:22px;font-size:19px;line-height:1.5;color:${s.coverTitle}b8;max-width:46ch\">${subtitle}</div>`\n            : '') +\n          `<div style=\"margin-top:44px;display:flex;align-items:center;gap:10px;color:${s.coverTitle}80;font-size:13px;letter-spacing:.02em\">` +\n          `<span style=\"width:26px;height:1px;background:${s.accent}\"></span>${s.firmLabel}</div>`\n        document.body.appendChild(el)\n        requestAnimationFrame(() => (el.style.opacity = '1'))\n      },\n      { kicker, title, subtitle: subtitle ?? '', s: skin }\n    )\n    await page.waitForTimeout(holdMs)\n  }\n\n  async function uncover(page: Page): Promise<void> {\n    await page.evaluate(() => {\n      const el = document.getElementById('__cine_cover')\n      if (!el) return\n      el.style.opacity = '0'\n      setTimeout(() => el.remove(), 520)\n    })\n    await page.waitForTimeout(560)\n  }\n\n  async function caption(page: Page, text: string, holdMs?: number): Promise<void> {\n    await page.evaluate(\n      (t) => (window as unknown as { __cine_cap?: (s: string) => void }).__cine_cap?.(t),\n      text\n    )\n    const hold = holdMs ?? Math.min(4200, 900 + text.length * 45)\n    await page.waitForTimeout(hold)\n  }\n\n  async function clearCaption(page: Page): Promise<void> {\n    await page.evaluate(() =>\n      (window as unknown as { __cine_cap?: (s: string) => void }).__cine_cap?.('')\n    )\n  }\n\n  async function beat(page: Page, ms = 650): Promise<void> {\n    await page.waitForTimeout(ms)\n  }\n\n  async function glideTo(page: Page, target: string | Locator): Promise<Locator> {\n    const loc = resolve(page, target).first()\n    await loc.scrollIntoViewIfNeeded().catch(() => {})\n    const box = await loc.boundingBox()\n    if (box) {\n      await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2, { steps: 26 })\n      await page.waitForTimeout(180)\n    }\n    return loc\n  }\n\n  async function click(page: Page, target: string | Locator): Promise<void> {\n    const loc = await glideTo(page, target)\n    await loc.click()\n    await page.waitForTimeout(260)\n  }\n\n  async function type(page: Page, target: string | Locator, text: string): Promise<void> {\n    const loc = await glideTo(page, target)\n    await loc.click()\n    await loc.fill('')\n    await loc.pressSequentially(text, { delay: 42 })\n    await page.waitForTimeout(240)\n  }\n\n  async function login(page: Page, opts: { show?: boolean; caption?: string } = {}): Promise<void> {\n    await page.goto(loginPath)\n    if (opts.show === false) {\n      await page.getByTestId(ids.email).fill(config.creds.email)\n      await page.getByTestId(ids.password).fill(config.creds.password)\n      await page.getByTestId(ids.submit).click()\n      await page.waitForURL(appUrlPattern, { timeout: 45_000 })\n      return\n    }\n    await caption(page, opts.caption ?? `${b.firmLabel} — signing in.`, 1600)\n    await type(page, ids.email, config.creds.email)\n    await type(page, ids.password, config.creds.password)\n    await click(page, ids.submit)\n    await page.waitForURL(appUrlPattern, { timeout: 45_000 })\n    await beat(page, 800)\n  }\n\n  return {\n    installStage,\n    cover,\n    uncover,\n    caption,\n    clearCaption,\n    beat,\n    glideTo,\n    click,\n    type,\n    login,\n  }\n}\n"]}

package/dist/record/index.d.ts

@@ -1,15 +1,13 @@
-import { Page, Locator } from '@playwright/test';
-
 /**
- * Cinematic recording harness — firm-agnostic.
+ * Cinematic recording harness — host-agnostic.
  *
  * Turns a Playwright run into a narrated product demo: a visible cursor that
  * glides between targets, a click ripple, a caption bar that narrates each step,
- * full-screen chapter "cover" cards, and human-speed pacing. Every firm app gets
+ * full-screen chapter "cover" cards, and human-speed pacing. Every host app gets
  * the same polished demo capability from one factory — brand colours, fonts,
- * credentials and the login flow arrive as config, so nothing here names a firm.
+ * credentials and the login flow arrive as config, so nothing here names a host.
  *
- * Pair with a Playwright project that records video (see the firm's
+ * Pair with a Playwright project that records video (see the host's
  * `playwright.record.config.ts`: video on, a large viewport, some slowMo).
  *
  * Usage in a `*.record.ts` spec:
@@ -21,12 +19,12 @@ import { Page, Locator } from '@playwright/test';
  *   await cine.caption(page, "Opening the flagship matter…")
  *   await cine.click(page, "matters-row-…")
  *
- * `@playwright/test` is a peer dependency — it is only imported by e2e specs, so
- * it never reaches an app bundle.
+ * `@playwright/test` is an optional peer used for TYPES only (no runtime import), so
+ * importing this entry never loads Playwright.
  */
-
+import type { Page, Locator } from '@playwright/test';
 /** Brand skin for the on-screen chrome. All optional — sensible neutral defaults. */
-interface CinematicBrand {
+export interface CinematicBrand {
     /** Footer line on chapter cards, e.g. "Meridian · AI-native counsel". */
     firmLabel: string;
     /** Serif display font for cover titles (CSS font-family value). */
@@ -53,11 +51,11 @@ interface CinematicBrand {
     /** Cover title text colour. */
     coverTitle?: string;
 }
-interface CinematicCreds {
+export interface CinematicCreds {
     email: string;
     password: string;
 }
-interface CinematicConfig {
+export interface CinematicConfig {
     brand: CinematicBrand;
     creds: CinematicCreds;
     /** Login route (default "/app/login"). */
@@ -71,7 +69,7 @@ interface CinematicConfig {
         submit?: string;
     };
 }
-interface Cinematic {
+export interface Cinematic {
     installStage(page: Page): Promise<void>;
     cover(page: Page, opts: {
         kicker: string;
@@ -91,6 +89,4 @@ interface Cinematic {
         caption?: string;
     }): Promise<void>;
 }
-declare function createCinematic(config: CinematicConfig): Cinematic;
-
-export { type Cinematic, type CinematicBrand, type CinematicConfig, type CinematicCreds, createCinematic };
+export declare function createCinematic(config: CinematicConfig): Cinematic;

package/dist/record/index.js

@@ -1,5 +1,3 @@
-import { expect } from '@playwright/test';
-
 // src/record/index.ts
 var DEFAULTS = {
   displayFont: "ui-serif, Georgia, serif",
@@ -147,14 +145,14 @@ function createCinematic(config) {
       await page.getByTestId(ids.email).fill(config.creds.email);
       await page.getByTestId(ids.password).fill(config.creds.password);
       await page.getByTestId(ids.submit).click();
-      await expect(page).toHaveURL(appUrlPattern, { timeout: 45e3 });
+      await page.waitForURL(appUrlPattern, { timeout: 45e3 });
       return;
     }
     await caption(page, opts.caption ?? `${b.firmLabel} \u2014 signing in.`, 1600);
     await type(page, ids.email, config.creds.email);
     await type(page, ids.password, config.creds.password);
     await click(page, ids.submit);
-    await expect(page).toHaveURL(appUrlPattern, { timeout: 45e3 });
+    await page.waitForURL(appUrlPattern, { timeout: 45e3 });
     await beat(page, 800);
   }
   return {