@joewinke/jatui 0.8.6 → 0.9.0

package/dist/video/settings.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Settings plumbing for VideoPlayer (mos-5lzns.28) — ported discipline from
+ * extension-library's `settings.js`, adapted to a prop-driven component.
+ *
+ * The extension's registry exists so the settings panel is generated from one
+ * array and "a setting added there appears in the UI by existing". jatui's
+ * player is prop-driven (the HOST owns the panel), so this module owns the
+ * smaller half of the contract that still matters here:
+ *
+ * · `coerce` never throws and never returns junk. A bool accepts
+ *   true/"1"/"true"; a range parses and clamps to [min, max]; an enum must
+ *   match a declared option or the value is discarded. Anything
+ *   unrecognised returns undefined and the caller falls back to the
+ *   declared default. A corrupted blob degrades to defaults, not to a
+ *   broken player.
+ * · One registry (`VIDEO_SETTINGS`) lists every knob the player's automatic
+ *   behaviours read, with the sub-task that owns each. A knob that is here
+ *   but unread by any module is a switch that visibly does nothing — the
+ *   extension calls that "declared but not yet wired" and refuses to fix it
+ *   quietly. Keep the same discipline: land the knob WITH its reader.
+ *
+ * Nothing under src/lib/video/ reads a setting directly except through the
+ * value its owning feature passes in as an `opts` argument — the advisor
+ * rule (see README). That keeps every module node-testable and keeps the
+ * arbitration in the component.
+ */
+export type SettingType = 'bool' | 'range' | 'enum';
+export interface SettingSpec {
+    id: string;
+    type: SettingType;
+    default: boolean | number | string;
+    /** range only */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** enum only */
+    options?: string[];
+    /** Which sub-task wires the reader. A spec without a live reader is a lie. */
+    owner: string;
+    /** Set true once the owning task lands (check: grep the module for the id). */
+    wired?: boolean;
+}
+/**
+ * The registry. Populated as the behaviours land — .30 oneAxis, .31 audio,
+ * .32 rate/speaker/silence, .33 night, .34 presence. An empty registry is
+ * the honest state while every behaviour is prop-driven.
+ */
+export declare const VIDEO_SETTINGS: SettingSpec[];
+/** Coerce a raw stored value against a spec — never throws, never returns junk. */
+export declare function coerce<T extends SettingSpec>(spec: T, raw: unknown): T['default'] | undefined;

package/dist/video/settings.js

@@ -0,0 +1,62 @@
+/**
+ * Settings plumbing for VideoPlayer (mos-5lzns.28) — ported discipline from
+ * extension-library's `settings.js`, adapted to a prop-driven component.
+ *
+ * The extension's registry exists so the settings panel is generated from one
+ * array and "a setting added there appears in the UI by existing". jatui's
+ * player is prop-driven (the HOST owns the panel), so this module owns the
+ * smaller half of the contract that still matters here:
+ *
+ * · `coerce` never throws and never returns junk. A bool accepts
+ *   true/"1"/"true"; a range parses and clamps to [min, max]; an enum must
+ *   match a declared option or the value is discarded. Anything
+ *   unrecognised returns undefined and the caller falls back to the
+ *   declared default. A corrupted blob degrades to defaults, not to a
+ *   broken player.
+ * · One registry (`VIDEO_SETTINGS`) lists every knob the player's automatic
+ *   behaviours read, with the sub-task that owns each. A knob that is here
+ *   but unread by any module is a switch that visibly does nothing — the
+ *   extension calls that "declared but not yet wired" and refuses to fix it
+ *   quietly. Keep the same discipline: land the knob WITH its reader.
+ *
+ * Nothing under src/lib/video/ reads a setting directly except through the
+ * value its owning feature passes in as an `opts` argument — the advisor
+ * rule (see README). That keeps every module node-testable and keeps the
+ * arbitration in the component.
+ */
+/**
+ * The registry. Populated as the behaviours land — .30 oneAxis, .31 audio,
+ * .32 rate/speaker/silence, .33 night, .34 presence. An empty registry is
+ * the honest state while every behaviour is prop-driven.
+ */
+export const VIDEO_SETTINGS = [
+// { id: 'player.oneAxis', type: 'bool', default: true, owner: 'mos-5lzns.30' },
+// { id: 'audio.level', type: 'bool', default: true, owner: 'mos-5lzns.31' },
+// { id: 'player.speakerRate', type: 'bool', default: false, owner: 'mos-5lzns.32' },
+// { id: 'night.mode', type: 'enum', default: 'auto', options: ['auto','on','off'], owner: 'mos-5lzns.33' },
+// { id: 'sleep.enabled', type: 'bool', default: true, owner: 'mos-5lzns.34' },
+];
+/** Coerce a raw stored value against a spec — never throws, never returns junk. */
+export function coerce(spec, raw) {
+    if (spec.type === 'bool') {
+        if (raw === true || raw === '1' || raw === 'true')
+            return true;
+        if (raw === false || raw === '0' || raw === 'false')
+            return false;
+        return undefined;
+    }
+    if (spec.type === 'range') {
+        const n = typeof raw === 'number' ? raw : Number(raw);
+        if (!Number.isFinite(n))
+            return undefined;
+        const min = spec.min ?? -Infinity;
+        const max = spec.max ?? Infinity;
+        return Math.min(max, Math.max(min, n));
+    }
+    // enum: must match a declared option or the value is discarded
+    if (typeof raw !== 'string')
+        return undefined;
+    if (!spec.options?.includes(raw))
+        return undefined;
+    return raw;
+}

package/dist/video/time.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure time/format helpers for VideoPlayer (mos-5lzns.28 internal split).
+ *
+ * DOM-free and dependency-free — the same "advisor" discipline the
+ * extension-library player uses for its `lib/` modules: pure functions,
+ * safe on garbage input, node-testable.
+ */
+/** `formatTime(90.4, false)` → `"1:30"`; with hours → `"0:01:30"`. */
+export declare function formatTime(totalSeconds: number, withHours: boolean): string;
+/** `formatDuration(3730)` → `"1h 2m"`; minutes scale → `"3m 40s"`; below → `"12s"`. */
+export declare function formatDuration(totalSeconds: number): string;
+export declare function truncate(s: string, n: number): string;
+/**
+ * `aspect` → a CSS `aspect-ratio` value. Accepts `"W:H"`, a bare ratio number,
+ * or null/"auto" (⇒ null; the video's intrinsic ratio drives the box). Shared
+ * with <Flythrough>/<LessonEmbed> conceptually, kept as a pure function so the
+ * primitive has no cross-file coupling for one small helper.
+ */
+export declare function aspectRatioCss(aspect: string | number | null | undefined): string | null;

package/dist/video/time.js

@@ -0,0 +1,55 @@
+/**
+ * Pure time/format helpers for VideoPlayer (mos-5lzns.28 internal split).
+ *
+ * DOM-free and dependency-free — the same "advisor" discipline the
+ * extension-library player uses for its `lib/` modules: pure functions,
+ * safe on garbage input, node-testable.
+ */
+/** `formatTime(90.4, false)` → `"1:30"`; with hours → `"0:01:30"`. */
+export function formatTime(totalSeconds, withHours) {
+    const t = Number.isFinite(totalSeconds) && totalSeconds > 0 ? totalSeconds : 0;
+    const pad = (n) => String(n).padStart(2, '0');
+    const s = Math.floor(t % 60);
+    if (withHours) {
+        return `${Math.floor(t / 3600)}:${pad(Math.floor((t % 3600) / 60))}:${pad(s)}`;
+    }
+    return `${Math.floor(t / 60)}:${pad(s)}`;
+}
+/** `formatDuration(3730)` → `"1h 2m"`; minutes scale → `"3m 40s"`; below → `"12s"`. */
+export function formatDuration(totalSeconds) {
+    const s = Math.round(Math.max(0, totalSeconds));
+    const h = Math.floor(s / 3600);
+    const m = Math.floor((s % 3600) / 60);
+    if (h > 0)
+        return `${h}h ${m}m`;
+    if (m > 0)
+        return `${m}m ${s % 60}s`;
+    return `${s}s`;
+}
+export function truncate(s, n) {
+    return s.length > n ? s.slice(0, n - 1).trimEnd() + '…' : s;
+}
+/**
+ * `aspect` → a CSS `aspect-ratio` value. Accepts `"W:H"`, a bare ratio number,
+ * or null/"auto" (⇒ null; the video's intrinsic ratio drives the box). Shared
+ * with <Flythrough>/<LessonEmbed> conceptually, kept as a pure function so the
+ * primitive has no cross-file coupling for one small helper.
+ */
+export function aspectRatioCss(aspect) {
+    if (aspect == null)
+        return null;
+    const trimmed = String(aspect).trim();
+    if (trimmed === '' || trimmed === 'auto')
+        return null;
+    const colon = trimmed.match(/^(\d+(?:\.\d+)?)\s*[:/]\s*(\d+(?:\.\d+)?)$/);
+    if (colon) {
+        const w = parseFloat(colon[1]);
+        const h = parseFloat(colon[2]);
+        if (w > 0 && h > 0)
+            return `${w} / ${h}`;
+    }
+    const num = Number(trimmed);
+    if (Number.isFinite(num) && num > 0)
+        return String(num);
+    return null;
+}

package/dist/video/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * VideoPlayer public data contracts (mos-5lzns.28 internal split).
+ *
+ * Moved verbatim from `components/VideoPlayer.svelte` so the intelligence
+ * modules under `src/lib/video/` can type their inputs without importing a
+ * .svelte file. The component re-exports these (`export type … from`),
+ * so the package's public type surface — `import type { VideoChapter, … }
+ * from 'jatui'` — is unchanged.
+ *
+ * Every field that feeds a pane is OPTIONAL at the component level: a bare
+ * mp4 with none of this still gets the band, wheel volume and the keyboard
+ * map. Panes light up as their data arrives; nothing shifts layout.
+ */
+/** A model-authored marker: the video's structure. */
+export interface VideoChapter {
+    startSec: number;
+    title: string;
+    /** Optional captured still, shown in the band's hover card. */
+    thumbUrl?: string | null;
+}
+/** A diarized turn (or an ad read, `ad: true`). Structurally accepts meeting data. */
+export interface VideoSpeakerTurn {
+    startSec: number;
+    endSec: number;
+    speakerIdentity?: string | null;
+    speakerName?: string | null;
+    /** Explicit oklch hue (0–360). Omit to take the next palette colour. */
+    hue?: number | null;
+    /** Ad read — shares the lane but reads as not-a-person. */
+    ad?: boolean;
+}
+/** Transcript line. Structurally compatible with TranscriptPlayer's `TranscriptSegment`. */
+export interface VideoTranscriptSegment {
+    id: string;
+    startSec: number;
+    endSec: number;
+    speakerIdentity?: string | null;
+    speakerName?: string | null;
+    text: string;
+}
+/** A user-authored marker. Structurally compatible with `TranscriptBookmark`. */
+export interface VideoBookmark {
+    playbackSec: number;
+    label?: string | null;
+    note?: string | null;
+    participantName?: string | null;
+}
+/** Precomputed audio envelope. `peaks` are normalised against their own max. */
+export interface VideoWaveform {
+    peaks: number[];
+    /** Seconds the peaks span. Defaults to the video's duration. */
+    durationSec?: number;
+}
+/** Per-speaker totals. Structurally compatible with `TranscriptSpeakerTalkTime`. */
+export interface VideoSpeakerTalkTime {
+    speakerIdentity?: string | null;
+    speakerName?: string | null;
+    seconds: number;
+}

package/dist/video/types.js

@@ -0,0 +1,14 @@
+/**
+ * VideoPlayer public data contracts (mos-5lzns.28 internal split).
+ *
+ * Moved verbatim from `components/VideoPlayer.svelte` so the intelligence
+ * modules under `src/lib/video/` can type their inputs without importing a
+ * .svelte file. The component re-exports these (`export type … from`),
+ * so the package's public type surface — `import type { VideoChapter, … }
+ * from 'jatui'` — is unchanged.
+ *
+ * Every field that feeds a pane is OPTIONAL at the component level: a bare
+ * mp4 with none of this still gets the band, wheel volume and the keyboard
+ * map. Panes light up as their data arrives; nothing shifts layout.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.8.6",
+  "version": "0.9.0",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",