@krizaka/ui 2.3.0 → 2.5.0

package/dist/video-trimmer.js

@@ -0,0 +1,193 @@
+"use client";
+import {
+  clamp,
+  formatClock
+} from "./chunk-EUPTXKH7.js";
+
+// src/video-trimmer/video-trimmer.tsx
+import * as React from "react";
+import { tv } from "tailwind-variants";
+import { jsx, jsxs } from "react/jsx-runtime";
+var videoTrimmer = tv({
+  slots: {
+    root: "w-full select-none",
+    header: "mb-2 flex items-center justify-between font-mono text-[11px] tabular-nums text-fg-secondary",
+    kept: "rounded-full bg-accent-soft px-2.5 py-0.5 font-sans text-xs font-semibold text-fg",
+    track: "relative h-16 touch-none rounded-xl bg-surface-2 data-[disabled]:opacity-50",
+    strip: "pointer-events-none absolute inset-0 flex overflow-hidden rounded-xl",
+    frame: "h-full min-w-0 flex-1 object-cover",
+    shade: "pointer-events-none absolute inset-y-0 bg-scrim-strong",
+    range: "pointer-events-none absolute inset-y-0 border-y-[3px] border-accent",
+    handle: "absolute inset-y-0 z-10 flex w-6 cursor-ew-resize items-center justify-center bg-accent text-on-accent shadow-md focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-surface-0 data-[edge=start]:rounded-l-xl data-[edge=end]:-translate-x-full data-[edge=end]:rounded-r-xl",
+    grip: "flex gap-[3px] [&>span]:h-5 [&>span]:w-[2px] [&>span]:rounded-sm [&>span]:bg-on-accent/70",
+    playhead: "absolute -inset-y-1.5 z-20 w-[3px] -translate-x-1/2 cursor-ew-resize rounded-full bg-fg shadow-md focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring"
+  }
+});
+var videoTrimmerLabels = {
+  start: "Start",
+  end: "End",
+  playhead: "Playhead",
+  kept: (length) => `${length} kept`
+};
+var tenths = (seconds) => `${formatClock(seconds)}.${Math.floor(Math.max(0, seconds) % 1 * 10)}`;
+function VideoTrimmer({
+  duration,
+  value: valueProp,
+  defaultValue,
+  onValueChange,
+  onValueCommit,
+  time,
+  onSeek,
+  minLength = 0.5,
+  step = 0.1,
+  largeStep = 1,
+  frames,
+  children,
+  formatTime = tenths,
+  showHeader = true,
+  disabled,
+  classNames = {},
+  renderHandle,
+  labels: given
+}) {
+  const labels = { ...videoTrimmerLabels, ...given };
+  const s = videoTrimmer();
+  const track = React.useRef(null);
+  const grip = React.useRef(null);
+  const [inner, setInner] = React.useState(() => [defaultValue?.[0] ?? 0, defaultValue?.[1] ?? duration]);
+  const [start, end] = valueProp ?? inner;
+  const total = duration > 0 ? duration : 1;
+  const pct = (seconds) => clamp(seconds, 0, total) / total * 100;
+  const set = (next, commit = false) => {
+    if (!valueProp) setInner(next);
+    onValueChange?.(next);
+    if (commit) onValueCommit?.(next);
+  };
+  const move = (edge, to, commit = false) => {
+    const next = edge === "start" ? [clamp(to, 0, end - minLength), end] : [start, clamp(to, start + minLength, duration)];
+    set([Math.round(next[0] * 1e3) / 1e3, Math.round(next[1] * 1e3) / 1e3], commit);
+  };
+  const seek = (to) => onSeek?.(clamp(to, start, Math.max(start, end - 0.05)));
+  const at = (clientX) => {
+    const box = track.current?.getBoundingClientRect();
+    if (!box || box.width === 0) return 0;
+    return clamp((clientX - box.left) / box.width * duration, 0, duration);
+  };
+  const keys = (which) => (event) => {
+    const current = which === "start" ? start : which === "end" ? end : time ?? start;
+    const big = largeStep;
+    const small = event.shiftKey ? largeStep : step;
+    const target = {
+      ArrowLeft: current - small,
+      ArrowDown: current - small,
+      ArrowRight: current + small,
+      ArrowUp: current + small,
+      PageDown: current - big,
+      PageUp: current + big,
+      Home: 0,
+      End: duration
+    };
+    const to = target[event.key];
+    if (to === void 0 || disabled) return;
+    event.preventDefault();
+    if (which === "playhead") seek(to);
+    else move(which, to, true);
+  };
+  const handle = (edge) => {
+    const own = edge === "start" ? start : end;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        role: "slider",
+        tabIndex: disabled ? -1 : 0,
+        "aria-label": edge === "start" ? labels.start : labels.end,
+        "aria-valuemin": edge === "start" ? 0 : Math.round((start + minLength) * 10) / 10,
+        "aria-valuemax": edge === "start" ? Math.round((end - minLength) * 10) / 10 : Math.round(duration * 10) / 10,
+        "aria-valuenow": Math.round(own * 10) / 10,
+        "aria-valuetext": formatTime(own),
+        "aria-disabled": disabled || void 0,
+        "data-edge": edge,
+        className: s.handle({ className: classNames.handle }),
+        style: { left: `${pct(own)}%` },
+        onPointerDown: (event) => {
+          if (disabled) return;
+          event.stopPropagation();
+          track.current?.setPointerCapture?.(event.pointerId);
+          grip.current = edge;
+        },
+        onKeyDown: keys(edge),
+        children: renderHandle ? renderHandle(edge) : /* @__PURE__ */ jsxs("span", { className: s.grip({ className: classNames.grip }), children: [
+          /* @__PURE__ */ jsx("span", {}),
+          /* @__PURE__ */ jsx("span", {})
+        ] })
+      },
+      edge
+    );
+  };
+  return /* @__PURE__ */ jsxs("div", { className: s.root({ className: classNames.root }), children: [
+    showHeader && /* @__PURE__ */ jsxs("div", { className: s.header({ className: classNames.header }), children: [
+      /* @__PURE__ */ jsx("span", { children: formatTime(start) }),
+      /* @__PURE__ */ jsx("span", { className: s.kept({ className: classNames.kept }), children: labels.kept(formatTime(end - start)) }),
+      /* @__PURE__ */ jsx("span", { children: formatTime(end) })
+    ] }),
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref: track,
+        className: s.track({ className: classNames.track }),
+        "data-disabled": disabled ? "" : void 0,
+        onPointerDown: (event) => {
+          if (disabled) return;
+          track.current?.setPointerCapture?.(event.pointerId);
+          const t = at(event.clientX);
+          grip.current = onSeek ? "playhead" : Math.abs(t - start) < Math.abs(t - end) ? "start" : "end";
+          if (grip.current === "playhead") seek(t);
+          else move(grip.current, t);
+        },
+        onPointerMove: (event) => {
+          if (!grip.current) return;
+          const t = at(event.clientX);
+          if (grip.current === "playhead") seek(t);
+          else move(grip.current, t);
+        },
+        onPointerUp: () => {
+          if (grip.current && grip.current !== "playhead") onValueCommit?.([start, end]);
+          grip.current = null;
+        },
+        onPointerCancel: () => {
+          grip.current = null;
+        },
+        children: [
+          /* @__PURE__ */ jsx("div", { className: s.strip({ className: classNames.strip }), children: children ?? frames?.map((src, i) => /* @__PURE__ */ jsx("img", { src, alt: "", draggable: false, className: s.frame({ className: classNames.frame }) }, `${i}-${src}`)) }),
+          /* @__PURE__ */ jsx("div", { className: s.shade({ className: classNames.shade }), style: { left: 0, width: `${pct(start)}%`, borderRadius: "0.75rem 0 0 0.75rem" } }),
+          /* @__PURE__ */ jsx("div", { className: s.shade({ className: classNames.shade }), style: { right: 0, width: `${100 - pct(end)}%`, borderRadius: "0 0.75rem 0.75rem 0" } }),
+          /* @__PURE__ */ jsx("div", { className: s.range({ className: classNames.range }), style: { left: `${pct(start)}%`, right: `${100 - pct(end)}%` } }),
+          time !== void 0 && /* @__PURE__ */ jsx(
+            "div",
+            {
+              role: "slider",
+              tabIndex: disabled || !onSeek ? -1 : 0,
+              "aria-label": labels.playhead,
+              "aria-valuemin": Math.round(start * 10) / 10,
+              "aria-valuemax": Math.round(end * 10) / 10,
+              "aria-valuenow": Math.round(time * 10) / 10,
+              "aria-valuetext": formatTime(time),
+              "aria-readonly": !onSeek || void 0,
+              className: s.playhead({ className: classNames.playhead }),
+              style: { left: `${pct(time)}%` },
+              onKeyDown: onSeek ? keys("playhead") : void 0
+            }
+          ),
+          handle("start"),
+          handle("end")
+        ]
+      }
+    )
+  ] });
+}
+export {
+  VideoTrimmer,
+  videoTrimmer,
+  videoTrimmerLabels
+};
+//# sourceMappingURL=video-trimmer.js.map

package/dist/video-trimmer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/video-trimmer/video-trimmer.tsx"],"sourcesContent":["// Client. The trim timeline of a video editor: the clip as a filmstrip (or any track content), the part kept framed\n// between two edge handles — each a `slider` named by a prop, its value read as a time, never past the other one —\n// the outside dimmed, and a playhead to scrub. The handles sit on their value by their outer edge (the start handle\n// to the right of its value, the end handle to its left), so the frame encloses exactly what is kept. Every part\n// takes its own classes (`classNames`) and the handles their own content (`renderHandle`).\nimport * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nimport { clamp, formatClock } from \"../media\";\n\nexport const videoTrimmer = tv({\n  slots: {\n    root: \"w-full select-none\",\n    header: \"mb-2 flex items-center justify-between font-mono text-[11px] tabular-nums text-fg-secondary\",\n    kept: \"rounded-full bg-accent-soft px-2.5 py-0.5 font-sans text-xs font-semibold text-fg\",\n    track: \"relative h-16 touch-none rounded-xl bg-surface-2 data-[disabled]:opacity-50\",\n    strip: \"pointer-events-none absolute inset-0 flex overflow-hidden rounded-xl\",\n    frame: \"h-full min-w-0 flex-1 object-cover\",\n    shade: \"pointer-events-none absolute inset-y-0 bg-scrim-strong\",\n    range: \"pointer-events-none absolute inset-y-0 border-y-[3px] border-accent\",\n    handle:\n      \"absolute inset-y-0 z-10 flex w-6 cursor-ew-resize items-center justify-center bg-accent text-on-accent shadow-md \" +\n      \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-surface-0 \" +\n      \"data-[edge=start]:rounded-l-xl data-[edge=end]:-translate-x-full data-[edge=end]:rounded-r-xl\",\n    grip: \"flex gap-[3px] [&>span]:h-5 [&>span]:w-[2px] [&>span]:rounded-sm [&>span]:bg-on-accent/70\",\n    playhead:\n      \"absolute -inset-y-1.5 z-20 w-[3px] -translate-x-1/2 cursor-ew-resize rounded-full bg-fg shadow-md \" +\n      \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring\",\n  },\n});\n\ntype Part = keyof ReturnType<typeof videoTrimmer>;\n\nexport type VideoTrimmerLabels = {\n  /** The start handle (\"Start\"). */\n  start: string;\n  /** The end handle (\"End\"). */\n  end: string;\n  /** The playhead (\"Playhead\"). */\n  playhead: string;\n  /** The length kept, above the track: `(length) => length + \" kept\"` (the length already formatted). */\n  kept: (length: string) => string;\n};\n\nexport const videoTrimmerLabels: VideoTrimmerLabels = {\n  start: \"Start\",\n  end: \"End\",\n  playhead: \"Playhead\",\n  kept: (length) => `${length} kept`,\n};\n\nexport type VideoTrimmerProps = {\n  /** The length of the clip, in seconds. */\n  duration: number;\n  /** The part kept, `[start, end]` in seconds (controlled). */\n  value?: readonly [number, number];\n  /** The part kept at first, uncontrolled. Default: the whole clip. */\n  defaultValue?: readonly [number, number];\n  /** Called on every move of a handle. */\n  onValueChange?: (value: [number, number]) => void;\n  /** Called once a drag or a key press ends: render a preview, save. */\n  onValueCommit?: (value: [number, number]) => void;\n  /** The time played, in seconds: shows the playhead. */\n  time?: number;\n  /** Called when the playhead is moved (a drag on the track, the arrows on the playhead). */\n  onSeek?: (time: number) => void;\n  /** The shortest part that can be kept, in seconds. Default 0.5. */\n  minLength?: number;\n  /** One arrow press, in seconds. Default 0.1. */\n  step?: number;\n  /** Shift + arrow, Page Up / Page Down, in seconds. Default 1. */\n  largeStep?: number;\n  /** Pictures of the clip, in order: the filmstrip. */\n  frames?: readonly string[];\n  /** Track content instead of the filmstrip (a waveform, a coloured band). */\n  children?: React.ReactNode;\n  /** A time as read and shown. Default `m:ss` with tenths. */\n  formatTime?: (seconds: number) => string;\n  /** Shows the times and the length kept above the track. Default `true`. */\n  showHeader?: boolean;\n  /** Not available (a render is running). */\n  disabled?: boolean;\n  /** Classes per part: `root`, `header`, `kept`, `track`, `strip`, `frame`, `shade`, `range`, `handle`, `grip`, `playhead`. */\n  classNames?: Partial<Record<Part, string>>;\n  /** The content of a handle (default: two grip lines). */\n  renderHandle?: (edge: \"start\" | \"end\") => React.ReactNode;\n  /** The words, passed translated; English by default. */\n  labels?: Partial<VideoTrimmerLabels>;\n};\n\nconst tenths = (seconds: number) => `${formatClock(seconds)}.${Math.floor((Math.max(0, seconds) % 1) * 10)}`;\n\ntype Grip = \"start\" | \"end\" | \"playhead\";\n\n/** Keeps a part of a clip between two handles over its filmstrip, with a playhead to scrub — the keyboard included. */\nexport function VideoTrimmer({\n  duration,\n  value: valueProp,\n  defaultValue,\n  onValueChange,\n  onValueCommit,\n  time,\n  onSeek,\n  minLength = 0.5,\n  step = 0.1,\n  largeStep = 1,\n  frames,\n  children,\n  formatTime = tenths,\n  showHeader = true,\n  disabled,\n  classNames = {},\n  renderHandle,\n  labels: given,\n}: VideoTrimmerProps) {\n  const labels = { ...videoTrimmerLabels, ...given };\n  const s = videoTrimmer();\n  const track = React.useRef<HTMLDivElement>(null);\n  const grip = React.useRef<Grip | null>(null);\n  const [inner, setInner] = React.useState<[number, number]>(() => [defaultValue?.[0] ?? 0, defaultValue?.[1] ?? duration]);\n  const [start, end] = valueProp ?? inner;\n  const total = duration > 0 ? duration : 1;\n  const pct = (seconds: number) => (clamp(seconds, 0, total) / total) * 100;\n\n  const set = (next: [number, number], commit = false) => {\n    if (!valueProp) setInner(next);\n    onValueChange?.(next);\n    if (commit) onValueCommit?.(next);\n  };\n  const move = (edge: \"start\" | \"end\", to: number, commit = false) => {\n    const next: [number, number] =\n      edge === \"start\" ? [clamp(to, 0, end - minLength), end] : [start, clamp(to, start + minLength, duration)];\n    set([Math.round(next[0] * 1000) / 1000, Math.round(next[1] * 1000) / 1000], commit);\n  };\n  const seek = (to: number) => onSeek?.(clamp(to, start, Math.max(start, end - 0.05)));\n\n  const at = (clientX: number) => {\n    const box = track.current?.getBoundingClientRect();\n    if (!box || box.width === 0) return 0;\n    return clamp(((clientX - box.left) / box.width) * duration, 0, duration);\n  };\n\n  const keys = (which: Grip) => (event: React.KeyboardEvent) => {\n    const current = which === \"start\" ? start : which === \"end\" ? end : (time ?? start);\n    const big = largeStep;\n    const small = event.shiftKey ? largeStep : step;\n    const target: Record<string, number> = {\n      ArrowLeft: current - small,\n      ArrowDown: current - small,\n      ArrowRight: current + small,\n      ArrowUp: current + small,\n      PageDown: current - big,\n      PageUp: current + big,\n      Home: 0,\n      End: duration,\n    };\n    const to = target[event.key];\n    if (to === undefined || disabled) return;\n    event.preventDefault();\n    if (which === \"playhead\") seek(to);\n    else move(which, to, true);\n  };\n\n  const handle = (edge: \"start\" | \"end\") => {\n    const own = edge === \"start\" ? start : end;\n    return (\n      <div\n        key={edge}\n        role=\"slider\"\n        tabIndex={disabled ? -1 : 0}\n        aria-label={edge === \"start\" ? labels.start : labels.end}\n        aria-valuemin={edge === \"start\" ? 0 : Math.round((start + minLength) * 10) / 10}\n        aria-valuemax={edge === \"start\" ? Math.round((end - minLength) * 10) / 10 : Math.round(duration * 10) / 10}\n        aria-valuenow={Math.round(own * 10) / 10}\n        aria-valuetext={formatTime(own)}\n        aria-disabled={disabled || undefined}\n        data-edge={edge}\n        className={s.handle({ className: classNames.handle })}\n        style={{ left: `${pct(own)}%` }}\n        onPointerDown={(event) => {\n          if (disabled) return;\n          event.stopPropagation();\n          track.current?.setPointerCapture?.(event.pointerId);\n          grip.current = edge;\n        }}\n        onKeyDown={keys(edge)}\n      >\n        {renderHandle ? (\n          renderHandle(edge)\n        ) : (\n          <span className={s.grip({ className: classNames.grip })}>\n            <span />\n            <span />\n          </span>\n        )}\n      </div>\n    );\n  };\n\n  return (\n    <div className={s.root({ className: classNames.root })}>\n      {showHeader && (\n        <div className={s.header({ className: classNames.header })}>\n          <span>{formatTime(start)}</span>\n          <span className={s.kept({ className: classNames.kept })}>{labels.kept(formatTime(end - start))}</span>\n          <span>{formatTime(end)}</span>\n        </div>\n      )}\n      <div\n        ref={track}\n        className={s.track({ className: classNames.track })}\n        data-disabled={disabled ? \"\" : undefined}\n        onPointerDown={(event) => {\n          if (disabled) return;\n          track.current?.setPointerCapture?.(event.pointerId);\n          const t = at(event.clientX);\n          grip.current = onSeek ? \"playhead\" : Math.abs(t - start) < Math.abs(t - end) ? \"start\" : \"end\";\n          if (grip.current === \"playhead\") seek(t);\n          else move(grip.current, t);\n        }}\n        onPointerMove={(event) => {\n          if (!grip.current) return;\n          const t = at(event.clientX);\n          if (grip.current === \"playhead\") seek(t);\n          else move(grip.current, t);\n        }}\n        onPointerUp={() => {\n          if (grip.current && grip.current !== \"playhead\") onValueCommit?.([start, end]);\n          grip.current = null;\n        }}\n        onPointerCancel={() => {\n          grip.current = null;\n        }}\n      >\n        <div className={s.strip({ className: classNames.strip })}>\n          {children ?? frames?.map((src, i) => <img key={`${i}-${src}`} src={src} alt=\"\" draggable={false} className={s.frame({ className: classNames.frame })} />)}\n        </div>\n        <div className={s.shade({ className: classNames.shade })} style={{ left: 0, width: `${pct(start)}%`, borderRadius: \"0.75rem 0 0 0.75rem\" }} />\n        <div className={s.shade({ className: classNames.shade })} style={{ right: 0, width: `${100 - pct(end)}%`, borderRadius: \"0 0.75rem 0.75rem 0\" }} />\n        <div className={s.range({ className: classNames.range })} style={{ left: `${pct(start)}%`, right: `${100 - pct(end)}%` }} />\n        {time !== undefined && (\n          <div\n            role=\"slider\"\n            tabIndex={disabled || !onSeek ? -1 : 0}\n            aria-label={labels.playhead}\n            aria-valuemin={Math.round(start * 10) / 10}\n            aria-valuemax={Math.round(end * 10) / 10}\n            aria-valuenow={Math.round(time * 10) / 10}\n            aria-valuetext={formatTime(time)}\n            aria-readonly={!onSeek || undefined}\n            className={s.playhead({ className: classNames.playhead })}\n            style={{ left: `${pct(time)}%` }}\n            onKeyDown={onSeek ? keys(\"playhead\") : undefined}\n          />\n        )}\n        {handle(\"start\")}\n        {handle(\"end\")}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krizaka/ui",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "The Krizaka front-end platform's components: the primitives (button, card, dialog, toast, menu, field, tabs, chip, switch, slider, command palette, theme, countdown…) on the semantic --kz-* tokens, the animated marks (Krizaka, Orazaka, Orochia) and the motion signature — web and /native.",
   "keywords": [
     "krizaka",
@@ -210,12 +210,72 @@
       "types": "./dist/meter.d.ts",
       "import": "./dist/meter.js"
     },
+    "./pagination": {
+      "types": "./dist/pagination.d.ts",
+      "import": "./dist/pagination.js"
+    },
+    "./data-table": {
+      "types": "./dist/data-table.d.ts",
+      "import": "./dist/data-table.js"
+    },
+    "./filter-bar": {
+      "types": "./dist/filter-bar.d.ts",
+      "import": "./dist/filter-bar.js"
+    },
+    "./combobox": {
+      "types": "./dist/combobox.d.ts",
+      "import": "./dist/combobox.js"
+    },
+    "./tag-input": {
+      "types": "./dist/tag-input.d.ts",
+      "import": "./dist/tag-input.js"
+    },
+    "./date-picker": {
+      "types": "./dist/date-picker.d.ts",
+      "import": "./dist/date-picker.js"
+    },
+    "./search-field": {
+      "types": "./dist/search-field.d.ts",
+      "import": "./dist/search-field.js"
+    },
+    "./video-player": {
+      "types": "./dist/video-player.d.ts",
+      "import": "./dist/video-player.js"
+    },
+    "./file-upload": {
+      "types": "./dist/file-upload.d.ts",
+      "import": "./dist/file-upload.js"
+    },
+    "./media-capture": {
+      "types": "./dist/media-capture.d.ts",
+      "import": "./dist/media-capture.js"
+    },
+    "./video-trimmer": {
+      "types": "./dist/video-trimmer.d.ts",
+      "import": "./dist/video-trimmer.js"
+    },
+    "./audio-player": {
+      "types": "./dist/audio-player.d.ts",
+      "import": "./dist/audio-player.js"
+    },
+    "./image-cropper": {
+      "types": "./dist/image-cropper.d.ts",
+      "import": "./dist/image-cropper.js"
+    },
     "./motion.css": "./dist/motion.css",
     "./tailwind.css": "./tailwind.css",
     "./native": {
       "types": "./dist/native.d.ts",
       "import": "./dist/native.js"
     },
+    "./native/video-player": {
+      "types": "./dist/native/video-player.d.ts",
+      "import": "./dist/native/video-player.js"
+    },
+    "./native/media-capture": {
+      "types": "./dist/native/media-capture.d.ts",
+      "import": "./dist/native/media-capture.js"
+    },
     "./registry/examples/*": {
       "types": "./registry/examples/*.d.ts",
       "import": "./registry/examples/*.js"
@@ -238,7 +298,10 @@
     "*.css"
   ],
   "peerDependencies": {
-    "@krizaka/tailwind": ">=2.3.0",
+    "@krizaka/tailwind": ">=2.5.0",
+    "expo-camera": ">=16",
+    "expo-video": ">=2",
+    "hls.js": ">=1.5",
     "react": ">=18",
     "react-dom": ">=18",
     "react-native": ">=0.76",
@@ -264,6 +327,9 @@
     "babel-jest": "30.4.1",
     "eslint": "^9.39.0",
     "expect": "30.4.1",
+    "expo-camera": "57.0.6",
+    "expo-modules-core": "^57.0.21",
+    "expo-video": "57.0.5",
     "happy-dom": "^20.0.0",
     "jest": "30.4.2",
     "jest-environment-node": "30.4.1",
@@ -281,8 +347,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.0",
     "vitest": "^4.1.11",
-    "@krizaka/tokens": "2.3.0",
-    "@krizaka/config": "0.1.0"
+    "@krizaka/config": "0.1.0",
+    "@krizaka/tokens": "2.5.0"
   },
   "engines": {
     "node": ">=20"
@@ -294,6 +360,15 @@
     "@krizaka/tailwind": {
       "optional": true
     },
+    "expo-camera": {
+      "optional": true
+    },
+    "expo-video": {
+      "optional": true
+    },
+    "hls.js": {
+      "optional": true
+    },
     "react-dom": {
       "optional": true
     },
@@ -317,7 +392,7 @@
     {
       "name": "./native (bundled into the app by Metro, never downloaded: a regression guard, not a budget)",
       "path": "dist/native.js",
-      "limit": "15 kB",
+      "limit": "16 kB",
       "gzip": true
     },
     {
@@ -741,9 +816,162 @@
         "tailwind-variants",
         "clsx"
       ]
+    },
+    {
+      "name": "./pagination",
+      "path": "dist/pagination.js",
+      "limit": "2 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./data-table",
+      "path": "dist/data-table.js",
+      "limit": "9.5 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./filter-bar",
+      "path": "dist/filter-bar.js",
+      "limit": "34 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./combobox",
+      "path": "dist/combobox.js",
+      "limit": "13 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./tag-input",
+      "path": "dist/tag-input.js",
+      "limit": "13.5 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./date-picker",
+      "path": "dist/date-picker.js",
+      "limit": "29 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./search-field",
+      "path": "dist/search-field.js",
+      "limit": "3 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./video-player",
+      "path": "dist/video-player.js",
+      "limit": "15 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./file-upload",
+      "path": "dist/file-upload.js",
+      "limit": "5 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./media-capture",
+      "path": "dist/media-capture.js",
+      "limit": "3.8 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./video-trimmer",
+      "path": "dist/video-trimmer.js",
+      "limit": "2.4 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./audio-player",
+      "path": "dist/audio-player.js",
+      "limit": "2.8 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./image-cropper",
+      "path": "dist/image-cropper.js",
+      "limit": "12.5 kB",
+      "gzip": true,
+      "ignore": [
+        "tailwind-variants",
+        "clsx"
+      ]
+    },
+    {
+      "name": "./native/video-player (expo-video is the app's)",
+      "path": "dist/native/video-player.js",
+      "limit": "2 kB",
+      "gzip": true,
+      "ignore": [
+        "expo-video",
+        "expo-camera",
+        "@krizaka/ui"
+      ]
+    },
+    {
+      "name": "./native/media-capture (expo-camera is the app's)",
+      "path": "dist/native/media-capture.js",
+      "limit": "2.5 kB",
+      "gzip": true,
+      "ignore": [
+        "expo-video",
+        "expo-camera",
+        "@krizaka/ui"
+      ]
     }
   ],
   "dependencies": {
+    "@krizaka/intl": "^0.1.0",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "radix-ui": "^1.7.0",

package/registry/alert.json

@@ -147,7 +147,7 @@
     },
     {
       "path": "meta.ts",
-      "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which krizaka.com renders as\n// /docs/ui/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n  | \"alert\"\n  | \"avatar\"\n  | \"badge\"\n  | \"button\"\n  | \"card\"\n  | \"checkbox\"\n  | \"chip\"\n  | \"chip-link\"\n  | \"cn\"\n  | \"command\"\n  | \"confirm-button\"\n  | \"countdown\"\n  | \"dialog\"\n  | \"dropdown-menu\"\n  | \"empty-state\"\n  | \"field\"\n  | \"glow-card\"\n  | \"iso\"\n  | \"kbd\"\n  | \"loader\"\n  | \"marquee\"\n  | \"mascots\"\n  | \"meter\"\n  | \"nav-bar\"\n  | \"number-ticker\"\n  | \"page-header\"\n  | \"popover\"\n  | \"progress\"\n  | \"radio-group\"\n  | \"section-backdrop\"\n  | \"segmented\"\n  | \"separator\"\n  | \"skeleton\"\n  | \"slider\"\n  | \"slot\"\n  | \"spinner\"\n  | \"stat\"\n  | \"stepper\"\n  | \"switch\"\n  | \"tabs\"\n  | \"theme\"\n  | \"toast\"\n  | \"tooltip\"\n  | \"txt\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/** `stable`: its API only changes in a major. `beta`: it may still change in a minor. */\nexport type Status = \"stable\" | \"beta\";\n\n/** The group of the catalogue. */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"layout\" | \"foundations\";\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\nexport interface Example {\n  /** The file name, kebab-case (`primary`, `icon-button`). */\n  readonly name: string;\n  /** A short title (`Primary`, `Icon button`). */\n  readonly title: string;\n  /** One or two sentences: when this variant is the right one. */\n  readonly description: string;\n}\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n  /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n  readonly imports: readonly string[];\n  /** The examples, in reading order; the first one is the component's preview. */\n  readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n  /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n  readonly differences: readonly string[];\n}\n\nexport interface KeyboardInteraction {\n  /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n  readonly keys: string;\n  /** What they do. */\n  readonly action: string;\n}\n\nexport interface ComponentMeta {\n  /** The display name: `Button`, `Dropdown menu`. */\n  readonly title: string;\n  /** One sentence: what it is. */\n  readonly summary: string;\n  readonly status: Status;\n  readonly category: Category;\n  /** Must match the sides below: `both` ⇔ `web` and `native`. */\n  readonly platforms: Platform;\n  /** When to reach for it: concrete situations, one per item. */\n  readonly whenToUse: readonly string[];\n  /** When not to — and what to use instead (`use`), when another component is the answer. */\n  readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n  /** How to use it well: wording, placement, composition. */\n  readonly bestPractices: readonly string[];\n  readonly accessibility: {\n    /** The keyboard, when it does more than Tab and Enter. */\n    readonly keyboard: readonly KeyboardInteraction[];\n    /** Roles, names and announcements: what the component does, what the app must provide. */\n    readonly notes: readonly string[];\n  };\n  /** The components a reader of this page should know about. */\n  readonly related: readonly ComponentName[];\n  readonly web?: PlatformDocs;\n  readonly native?: NativeDocs;\n}\n"
+      "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which krizaka.com renders as\n// /docs/ui/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n  | \"alert\"\n  | \"audio-player\"\n  | \"avatar\"\n  | \"badge\"\n  | \"button\"\n  | \"card\"\n  | \"checkbox\"\n  | \"chip\"\n  | \"chip-link\"\n  | \"cn\"\n  | \"combobox\"\n  | \"command\"\n  | \"confirm-button\"\n  | \"countdown\"\n  | \"data-table\"\n  | \"date-picker\"\n  | \"dialog\"\n  | \"dropdown-menu\"\n  | \"empty-state\"\n  | \"field\"\n  | \"file-upload\"\n  | \"filter-bar\"\n  | \"glow-card\"\n  | \"image-cropper\"\n  | \"iso\"\n  | \"kbd\"\n  | \"loader\"\n  | \"marquee\"\n  | \"mascots\"\n  | \"media-capture\"\n  | \"meter\"\n  | \"nav-bar\"\n  | \"number-ticker\"\n  | \"page-header\"\n  | \"pagination\"\n  | \"popover\"\n  | \"progress\"\n  | \"radio-group\"\n  | \"search-field\"\n  | \"section-backdrop\"\n  | \"segmented\"\n  | \"separator\"\n  | \"skeleton\"\n  | \"slider\"\n  | \"slot\"\n  | \"spinner\"\n  | \"stat\"\n  | \"stepper\"\n  | \"switch\"\n  | \"tabs\"\n  | \"tag-input\"\n  | \"theme\"\n  | \"toast\"\n  | \"tooltip\"\n  | \"txt\"\n  | \"video-player\"\n  | \"video-trimmer\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/** `stable`: its API only changes in a major. `beta`: it may still change in a minor. */\nexport type Status = \"stable\" | \"beta\";\n\n/** The group of the catalogue. `media`: video, sound, camera, files, cropping. */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"media\" | \"layout\" | \"foundations\";\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\nexport interface Example {\n  /** The file name, kebab-case (`primary`, `icon-button`). */\n  readonly name: string;\n  /** A short title (`Primary`, `Icon button`). */\n  readonly title: string;\n  /** One or two sentences: when this variant is the right one. */\n  readonly description: string;\n}\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n  /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n  readonly imports: readonly string[];\n  /** The examples, in reading order; the first one is the component's preview. */\n  readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n  /**\n   * The entry to import from when it is not `@krizaka/ui/native`: a component that needs an Expo module (an optional\n   * peer) has its own, `@krizaka/ui/native/<name>`, so an app that does not use it never installs the module.\n   */\n  readonly entry?: string;\n  /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n  readonly differences: readonly string[];\n}\n\nexport interface KeyboardInteraction {\n  /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n  readonly keys: string;\n  /** What they do. */\n  readonly action: string;\n}\n\nexport interface ComponentMeta {\n  /** The display name: `Button`, `Dropdown menu`. */\n  readonly title: string;\n  /** One sentence: what it is. */\n  readonly summary: string;\n  readonly status: Status;\n  readonly category: Category;\n  /** Must match the sides below: `both` ⇔ `web` and `native`. */\n  readonly platforms: Platform;\n  /** When to reach for it: concrete situations, one per item. */\n  readonly whenToUse: readonly string[];\n  /** When not to — and what to use instead (`use`), when another component is the answer. */\n  readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n  /** How to use it well: wording, placement, composition. */\n  readonly bestPractices: readonly string[];\n  readonly accessibility: {\n    /** The keyboard, when it does more than Tab and Enter. */\n    readonly keyboard: readonly KeyboardInteraction[];\n    /** Roles, names and announcements: what the component does, what the app must provide. */\n    readonly notes: readonly string[];\n  };\n  /** The components a reader of this page should know about. */\n  readonly related: readonly ComponentName[];\n  readonly web?: PlatformDocs;\n  readonly native?: NativeDocs;\n}\n"
     }
   ],
   "dependencies": [