@eifi1/ui-kit 0.29.0 → 0.31.0

package/dist/demo/demo-banner.d.ts

@@ -0,0 +1,51 @@
+import * as react from 'react';
+import { ComponentPropsWithoutRef } from 'react';
+import { AccessChoice } from '../landing/access.js';
+import { LandingLabels } from '../landing/landing-labels.js';
+import { DemoExpiry } from './demo-countdown.js';
+import { DemoLabels } from './demo-labels.js';
+import { DemoModel } from './demo-session.js';
+
+interface DemoBannerProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "onClick"> {
+    /** The demo's end: `expires_at` from the `TokenResponse`, or `demo_expires_at` from
+     *  `/auth/me` (§5.3). */
+    expiresAt: DemoExpiry | null | undefined;
+    /** Which line the banner says about the data (§2.3). */
+    model: DemoModel;
+    /** "Request access". */
+    access: AccessChoice;
+    /** "Sign in" — let through for a demo session by `RedirectIfAuthed allowDemo`. Default
+     *  `/login`. */
+    signInHref?: string;
+    /** The countdown reached zero: clear the session and replace to `/demo/ended` (§5.5). */
+    onEnded?: () => void;
+    /** Where the collapsed state is kept for the tab's session. Default
+     *  `kit.demoBanner.collapsed`. */
+    collapseKey?: string;
+    /** The clock, for tests and previews. Default `Date.now`. Keep it stable. */
+    now?: () => number;
+    labels?: Partial<DemoLabels>;
+    /** The access words (`landing` namespace) for this instance. */
+    landingLabels?: Partial<LandingLabels>;
+}
+/**
+ * The demo's strip under the top bar, on every page of a demo session
+ * (docs/landing-demo-harmonization.md §5.4) — a kit `AlertBanner` strip:
+ *
+ * - the time left, "Demo · 23 h 12 min left" — minutes only in the last hour, and the
+ *   warning tone in the last ten minutes (`useDemoCountdown`);
+ * - one line on the model: R "You're looking at sample data. Changes aren't possible.",
+ *   S "Your own work is deleted when the demo ends.";
+ * - "Request access" (the mail) and "Sign in".
+ *
+ * It collapses to the countdown alone, for the tab's session (`sessionStorage`) — never
+ * hidden for good: it is a live state, like keksdose's preview banner, which a demo user
+ * gets instead of. At zero it calls `onEnded`.
+ *
+ * The countdown is no live region: a sentence read out every minute would drown the
+ * page. A screen-reader user meets it at the top of the page, and the end page says
+ * the rest.
+ */
+declare function DemoBanner({ expiresAt, model, access, signInHref, onEnded, collapseKey, now, labels: labelsProp, landingLabels, className, ...rest }: DemoBannerProps): react.JSX.Element;
+
+export { DemoBanner, type DemoBannerProps };

package/dist/demo/demo-banner.js

@@ -0,0 +1,97 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { ChevronDown, ChevronUp, Timer } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { AlertBanner } from "../components/alert-banner.js";
+import { Button, IconButton } from "../components/ui.js";
+import { useAccessAction } from "../landing/access.js";
+import { useLandingLabels } from "../landing/landing-labels.js";
+import { useDemoCountdown } from "./demo-countdown.js";
+import { useDemoLabels } from "./demo-labels.js";
+const COLLAPSE_KEY = "kit.demoBanner.collapsed";
+function readSession(key) {
+  if (typeof window === "undefined") return null;
+  try {
+    return window.sessionStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function writeSession(key, value) {
+  if (typeof window === "undefined") return;
+  try {
+    if (value === null) window.sessionStorage.removeItem(key);
+    else window.sessionStorage.setItem(key, value);
+  } catch {
+  }
+}
+function timeText(countdown, labels) {
+  if (countdown.minutesLeft === null) return labels.badge;
+  if (countdown.ended) return labels.endedTitle;
+  return countdown.lastHour ? labels.minutesLeft(countdown.minutes) : labels.hoursLeft(countdown.hours, countdown.minutes);
+}
+function DemoBanner({
+  expiresAt,
+  model,
+  access,
+  signInHref = "/login",
+  onEnded,
+  collapseKey = COLLAPSE_KEY,
+  now,
+  labels: labelsProp,
+  landingLabels,
+  className,
+  ...rest
+}) {
+  const labels = useDemoLabels(labelsProp);
+  const landing = useLandingLabels(landingLabels);
+  const accessLink = useAccessAction(access, landingLabels);
+  const countdown = useDemoCountdown(expiresAt, { now, onEnded });
+  const [collapsed, setCollapsed] = useState(() => readSession(collapseKey) === "1");
+  const toggle = () => {
+    const next = !collapsed;
+    setCollapsed(next);
+    writeSession(collapseKey, next ? "1" : null);
+  };
+  return /* @__PURE__ */ jsxs(
+    AlertBanner,
+    {
+      ...rest,
+      variant: "strip",
+      size: "sm",
+      tone: countdown.warning || countdown.ended ? "warning" : "info",
+      icon: /* @__PURE__ */ jsx(Timer, {}),
+      "data-demo-model": model,
+      className: cn("sm:text-sm", className),
+      action: /* @__PURE__ */ jsxs(Fragment, { children: [
+        !collapsed && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(Button, { href: accessLink.href, variant: "brand", size: "sm", children: accessLink.label }),
+          /* @__PURE__ */ jsx(Button, { href: signInHref, variant: "secondary", size: "sm", children: landing.signIn })
+        ] }),
+        /* @__PURE__ */ jsx(
+          IconButton,
+          {
+            size: "2xs",
+            variant: "ghost",
+            label: labels.details,
+            "aria-expanded": !collapsed,
+            onClick: toggle,
+            children: collapsed ? /* @__PURE__ */ jsx(ChevronDown, {}) : /* @__PURE__ */ jsx(ChevronUp, {})
+          }
+        )
+      ] }),
+      children: [
+        /* @__PURE__ */ jsx("span", { className: "font-semibold", children: timeText(countdown, labels) }),
+        !collapsed && /* @__PURE__ */ jsxs(Fragment, { children: [
+          " ",
+          /* @__PURE__ */ jsx("span", { children: model === "read-only" ? labels.readOnly : labels.sandbox })
+        ] })
+      ]
+    }
+  );
+}
+export {
+  DemoBanner
+};
+//# sourceMappingURL=demo-banner.js.map

package/dist/demo/demo-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/demo/demo-banner.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ComponentPropsWithoutRef } from \"react\";\nimport { ChevronDown, ChevronUp, Timer } from \"lucide-react\";\n\nimport { cn } from \"../lib/cn\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { Button, IconButton } from \"../components/ui\";\nimport { useAccessAction } from \"../landing/access\";\nimport type { AccessChoice } from \"../landing/access\";\nimport { useLandingLabels } from \"../landing/landing-labels\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport { useDemoCountdown } from \"./demo-countdown\";\nimport type { DemoCountdown, DemoExpiry } from \"./demo-countdown\";\nimport { useDemoLabels } from \"./demo-labels\";\nimport type { DemoLabels } from \"./demo-labels\";\nimport type { DemoModel } from \"./demo-session\";\n\n/** The default `sessionStorage` key of the collapsed state. */\nconst COLLAPSE_KEY = \"kit.demoBanner.collapsed\";\n\n/** `sessionStorage`, guarded like `lib/safe-storage`'s `localStorage`: blocked storage\n *  reads as \"not set\" and writes nothing. */\nfunction readSession(key: string): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.sessionStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeSession(key: string, value: string | null): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (value === null) window.sessionStorage.removeItem(key);\n    else window.sessionStorage.setItem(key, value);\n  } catch {\n    // storage blocked: the banner just opens again next time\n  }\n}\n\n/** \"Demo · 23 h 12 min left\", \"Demo · 50 min left\", the end, or plain \"Demo\". */\nfunction timeText(countdown: DemoCountdown, labels: DemoLabels): string {\n  if (countdown.minutesLeft === null) return labels.badge;\n  if (countdown.ended) return labels.endedTitle;\n  return countdown.lastHour\n    ? labels.minutesLeft(countdown.minutes)\n    : labels.hoursLeft(countdown.hours, countdown.minutes);\n}\n\nexport interface DemoBannerProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"children\" | \"onClick\"> {\n  /** The demo's end: `expires_at` from the `TokenResponse`, or `demo_expires_at` from\n   *  `/auth/me` (§5.3). */\n  expiresAt: DemoExpiry | null | undefined;\n  /** Which line the banner says about the data (§2.3). */\n  model: DemoModel;\n  /** \"Request access\". */\n  access: AccessChoice;\n  /** \"Sign in\" — let through for a demo session by `RedirectIfAuthed allowDemo`. Default\n   *  `/login`. */\n  signInHref?: string;\n  /** The countdown reached zero: clear the session and replace to `/demo/ended` (§5.5). */\n  onEnded?: () => void;\n  /** Where the collapsed state is kept for the tab's session. Default\n   *  `kit.demoBanner.collapsed`. */\n  collapseKey?: string;\n  /** The clock, for tests and previews. Default `Date.now`. Keep it stable. */\n  now?: () => number;\n  labels?: Partial<DemoLabels>;\n  /** The access words (`landing` namespace) for this instance. */\n  landingLabels?: Partial<LandingLabels>;\n}\n\n/**\n * The demo's strip under the top bar, on every page of a demo session\n * (docs/landing-demo-harmonization.md §5.4) — a kit `AlertBanner` strip:\n *\n * - the time left, \"Demo · 23 h 12 min left\" — minutes only in the last hour, and the\n *   warning tone in the last ten minutes (`useDemoCountdown`);\n * - one line on the model: R \"You're looking at sample data. Changes aren't possible.\",\n *   S \"Your own work is deleted when the demo ends.\";\n * - \"Request access\" (the mail) and \"Sign in\".\n *\n * It collapses to the countdown alone, for the tab's session (`sessionStorage`) — never\n * hidden for good: it is a live state, like keksdose's preview banner, which a demo user\n * gets instead of. At zero it calls `onEnded`.\n *\n * The countdown is no live region: a sentence read out every minute would drown the\n * page. A screen-reader user meets it at the top of the page, and the end page says\n * the rest.\n */\nexport function DemoBanner({\n  expiresAt,\n  model,\n  access,\n  signInHref = \"/login\",\n  onEnded,\n  collapseKey = COLLAPSE_KEY,\n  now,\n  labels: labelsProp,\n  landingLabels,\n  className,\n  ...rest\n}: DemoBannerProps) {\n  const labels = useDemoLabels(labelsProp);\n  const landing = useLandingLabels(landingLabels);\n  const accessLink = useAccessAction(access, landingLabels);\n  const countdown = useDemoCountdown(expiresAt, { now, onEnded });\n  const [collapsed, setCollapsed] = useState(() => readSession(collapseKey) === \"1\");\n\n  const toggle = () => {\n    const next = !collapsed;\n    setCollapsed(next);\n    writeSession(collapseKey, next ? \"1\" : null);\n  };\n\n  return (\n    <AlertBanner\n      {...rest}\n      variant=\"strip\"\n      size=\"sm\"\n      tone={countdown.warning || countdown.ended ? \"warning\" : \"info\"}\n      icon={<Timer />}\n      data-demo-model={model}\n      className={cn(\"sm:text-sm\", className)}\n      action={\n        <>\n          {!collapsed && (\n            <>\n              <Button href={accessLink.href} variant=\"brand\" size=\"sm\">\n                {accessLink.label}\n              </Button>\n              <Button href={signInHref} variant=\"secondary\" size=\"sm\">\n                {landing.signIn}\n              </Button>\n            </>\n          )}\n          <IconButton\n            size=\"2xs\"\n            variant=\"ghost\"\n            label={labels.details}\n            aria-expanded={!collapsed}\n            onClick={toggle}\n          >\n            {collapsed ? <ChevronDown /> : <ChevronUp />}\n          </IconButton>\n        </>\n      }\n    >\n      <span className=\"font-semibold\">{timeText(countdown, labels)}</span>\n      {!collapsed && (\n        <>\n          {\" \"}\n          <span>{model === \"read-only\" ? labels.readOnly : labels.sandbox}</span>\n        </>\n      )}\n    </AlertBanner>\n  );\n}\n"],"mappings":";AA0HY,SAMA,UANA,KAMA,YANA;AA1HZ,SAAS,gBAAgB;AAEzB,SAAS,aAAa,WAAW,aAAa;AAE9C,SAAS,UAAU;AACnB,SAAS,mBAAmB;AAC5B,SAAS,QAAQ,kBAAkB;AACnC,SAAS,uBAAuB;AAEhC,SAAS,wBAAwB;AAEjC,SAAS,wBAAwB;AAEjC,SAAS,qBAAqB;AAK9B,MAAM,eAAe;AAIrB,SAAS,YAAY,KAA4B;AAC/C,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,MAAI;AACF,WAAO,OAAO,eAAe,QAAQ,GAAG;AAAA,EAC1C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,aAAa,KAAa,OAA4B;AAC7D,MAAI,OAAO,WAAW,YAAa;AACnC,MAAI;AACF,QAAI,UAAU,KAAM,QAAO,eAAe,WAAW,GAAG;AAAA,QACnD,QAAO,eAAe,QAAQ,KAAK,KAAK;AAAA,EAC/C,QAAQ;AAAA,EAER;AACF;AAGA,SAAS,SAAS,WAA0B,QAA4B;AACtE,MAAI,UAAU,gBAAgB,KAAM,QAAO,OAAO;AAClD,MAAI,UAAU,MAAO,QAAO,OAAO;AACnC,SAAO,UAAU,WACb,OAAO,YAAY,UAAU,OAAO,IACpC,OAAO,UAAU,UAAU,OAAO,UAAU,OAAO;AACzD;AA2CO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,SAAS,cAAc,UAAU;AACvC,QAAM,UAAU,iBAAiB,aAAa;AAC9C,QAAM,aAAa,gBAAgB,QAAQ,aAAa;AACxD,QAAM,YAAY,iBAAiB,WAAW,EAAE,KAAK,QAAQ,CAAC;AAC9D,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,MAAM,YAAY,WAAW,MAAM,GAAG;AAEjF,QAAM,SAAS,MAAM;AACnB,UAAM,OAAO,CAAC;AACd,iBAAa,IAAI;AACjB,iBAAa,aAAa,OAAO,MAAM,IAAI;AAAA,EAC7C;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,MAAM,UAAU,WAAW,UAAU,QAAQ,YAAY;AAAA,MACzD,MAAM,oBAAC,SAAM;AAAA,MACb,mBAAiB;AAAA,MACjB,WAAW,GAAG,cAAc,SAAS;AAAA,MACrC,QACE,iCACG;AAAA,SAAC,aACA,iCACE;AAAA,8BAAC,UAAO,MAAM,WAAW,MAAM,SAAQ,SAAQ,MAAK,MACjD,qBAAW,OACd;AAAA,UACA,oBAAC,UAAO,MAAM,YAAY,SAAQ,aAAY,MAAK,MAChD,kBAAQ,QACX;AAAA,WACF;AAAA,QAEF;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,SAAQ;AAAA,YACR,OAAO,OAAO;AAAA,YACd,iBAAe,CAAC;AAAA,YAChB,SAAS;AAAA,YAER,sBAAY,oBAAC,eAAY,IAAK,oBAAC,aAAU;AAAA;AAAA,QAC5C;AAAA,SACF;AAAA,MAGF;AAAA,4BAAC,UAAK,WAAU,iBAAiB,mBAAS,WAAW,MAAM,GAAE;AAAA,QAC5D,CAAC,aACA,iCACG;AAAA;AAAA,UACD,oBAAC,UAAM,oBAAU,cAAc,OAAO,WAAW,OAAO,SAAQ;AAAA,WAClE;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}

package/dist/demo/demo-countdown.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The demo's countdown (docs/landing-demo-harmonization.md §5.3, §5.4): the time left to
+ * the demo account's end, from `expires_at` (the `TokenResponse`) or `demo_expires_at`
+ * (`/auth/me`). The client never decodes the JWT.
+ */
+/** When the demo ends: an ISO timestamp from the server, epoch milliseconds, or a
+ *  `Date`. */
+type DemoExpiry = string | number | Date;
+/** The last stretch, in minutes, in which the banner turns to the warning tone (§5.4). */
+declare const DEMO_WARNING_MINUTES = 10;
+/** Below this many minutes the countdown shows minutes only (§5.4). */
+declare const DEMO_MINUTES_ONLY = 60;
+interface DemoCountdown {
+    /**
+     * Whole minutes left, ROUNDED UP — 30 s left is "1 min", and 0 only once the demo has
+     * ended. `null` when `expiresAt` cannot be read: the countdown then shows no time and
+     * never ends by itself (a parse slip must not throw a visitor out).
+     */
+    minutesLeft: number | null;
+    /** The display split: whole hours, and the minutes past them. In the last hour
+     *  (`lastHour`) `hours` is 0 and `minutes` is `minutesLeft`. */
+    hours: number;
+    minutes: number;
+    /** `minutesLeft <= 60`: show minutes only. */
+    lastHour: boolean;
+    /** `minutesLeft <= 10`: the warning tone. */
+    warning: boolean;
+    /** The demo's time is up. */
+    ended: boolean;
+}
+/**
+ * The countdown at `now` — pure, for a test or a server-rendered value. See
+ * {@link DemoCountdown} for the rounding and the thresholds.
+ */
+declare function demoCountdown(expiresAt: DemoExpiry | null | undefined, now: number): DemoCountdown;
+interface DemoCountdownOptions {
+    /**
+     * The clock, in epoch milliseconds. Default `Date.now`. A test passes its own (or uses
+     * fake timers, which move `Date.now` too). Keep it a stable function — a new one each
+     * render re-arms the timer each render.
+     */
+    now?: () => number;
+    /** Called once when the countdown reaches zero — also on mount, if it already has.
+     *  The app clears the session and replaces to `/demo/ended` (§5.5). */
+    onEnded?: () => void;
+}
+/**
+ * The time left to `expiresAt`, re-rendering when the shown minute changes — one timer
+ * to the next minute boundary, not a tick a second — and once more when the tab comes
+ * back from the background (a hidden tab's timers are throttled).
+ *
+ * `onEnded` fires at zero (§5.5). The countdown is the client's, from `expires_at`; the
+ * server's answer to a request after the end (a 401) ends the demo as well — the app's
+ * 401 handler, not this hook.
+ */
+declare function useDemoCountdown(expiresAt: DemoExpiry | null | undefined, { now, onEnded }?: DemoCountdownOptions): DemoCountdown;
+
+export { DEMO_MINUTES_ONLY, DEMO_WARNING_MINUTES, type DemoCountdown, type DemoCountdownOptions, type DemoExpiry, demoCountdown, useDemoCountdown };

package/dist/demo/demo-countdown.js

@@ -0,0 +1,79 @@
+"use client";
+import { useCallback, useEffect, useEffectEvent, useSyncExternalStore } from "react";
+const DEMO_WARNING_MINUTES = 10;
+const DEMO_MINUTES_ONLY = 60;
+const MINUTE = 6e4;
+function expiryMs(expiresAt) {
+  if (expiresAt === null || expiresAt === void 0) return Number.NaN;
+  if (typeof expiresAt === "number") return expiresAt;
+  if (expiresAt instanceof Date) return expiresAt.getTime();
+  return Date.parse(expiresAt);
+}
+function minutesAt(expiry, now) {
+  if (!Number.isFinite(expiry)) return null;
+  return Math.max(0, Math.ceil((expiry - now) / MINUTE));
+}
+function demoCountdown(expiresAt, now) {
+  return countdownOf(minutesAt(expiryMs(expiresAt), now));
+}
+function countdownOf(minutesLeft) {
+  if (minutesLeft === null) {
+    return { minutesLeft, hours: 0, minutes: 0, lastHour: false, warning: false, ended: false };
+  }
+  const lastHour = minutesLeft <= DEMO_MINUTES_ONLY;
+  return {
+    minutesLeft,
+    hours: lastHour ? 0 : Math.floor(minutesLeft / 60),
+    minutes: lastHour ? minutesLeft : minutesLeft % 60,
+    lastHour,
+    warning: minutesLeft <= DEMO_WARNING_MINUTES,
+    ended: minutesLeft === 0
+  };
+}
+function useDemoCountdown(expiresAt, { now = Date.now, onEnded } = {}) {
+  const expiry = expiryMs(expiresAt);
+  const subscribe = useCallback(
+    (notify) => {
+      if (!Number.isFinite(expiry)) return () => {
+      };
+      let timer;
+      const arm = () => {
+        const left = expiry - now();
+        if (left <= 0) return;
+        const delay = left - (Math.ceil(left / MINUTE) - 1) * MINUTE;
+        timer = setTimeout(() => {
+          notify();
+          arm();
+        }, delay);
+      };
+      const onVisible = () => {
+        if (document.visibilityState !== "visible") return;
+        clearTimeout(timer);
+        notify();
+        arm();
+      };
+      arm();
+      document.addEventListener("visibilitychange", onVisible);
+      return () => {
+        clearTimeout(timer);
+        document.removeEventListener("visibilitychange", onVisible);
+      };
+    },
+    [expiry, now]
+  );
+  const snapshot = () => minutesAt(expiry, now());
+  const minutesLeft = useSyncExternalStore(subscribe, snapshot, snapshot);
+  const countdown = countdownOf(minutesLeft);
+  const fireEnded = useEffectEvent(() => onEnded?.());
+  useEffect(() => {
+    if (countdown.ended) fireEnded();
+  }, [countdown.ended]);
+  return countdown;
+}
+export {
+  DEMO_MINUTES_ONLY,
+  DEMO_WARNING_MINUTES,
+  demoCountdown,
+  useDemoCountdown
+};
+//# sourceMappingURL=demo-countdown.js.map

package/dist/demo/demo-countdown.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/demo/demo-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useEffectEvent, useSyncExternalStore } from \"react\";\n\n/**\n * The demo's countdown (docs/landing-demo-harmonization.md §5.3, §5.4): the time left to\n * the demo account's end, from `expires_at` (the `TokenResponse`) or `demo_expires_at`\n * (`/auth/me`). The client never decodes the JWT.\n */\n\n/** When the demo ends: an ISO timestamp from the server, epoch milliseconds, or a\n *  `Date`. */\nexport type DemoExpiry = string | number | Date;\n\n/** The last stretch, in minutes, in which the banner turns to the warning tone (§5.4). */\nexport const DEMO_WARNING_MINUTES = 10;\n/** Below this many minutes the countdown shows minutes only (§5.4). */\nexport const DEMO_MINUTES_ONLY = 60;\n\nconst MINUTE = 60_000;\n\nexport interface DemoCountdown {\n  /**\n   * Whole minutes left, ROUNDED UP — 30 s left is \"1 min\", and 0 only once the demo has\n   * ended. `null` when `expiresAt` cannot be read: the countdown then shows no time and\n   * never ends by itself (a parse slip must not throw a visitor out).\n   */\n  minutesLeft: number | null;\n  /** The display split: whole hours, and the minutes past them. In the last hour\n   *  (`lastHour`) `hours` is 0 and `minutes` is `minutesLeft`. */\n  hours: number;\n  minutes: number;\n  /** `minutesLeft <= 60`: show minutes only. */\n  lastHour: boolean;\n  /** `minutesLeft <= 10`: the warning tone. */\n  warning: boolean;\n  /** The demo's time is up. */\n  ended: boolean;\n}\n\n/** `expiresAt` as epoch milliseconds, or NaN. */\nfunction expiryMs(expiresAt: DemoExpiry | null | undefined): number {\n  if (expiresAt === null || expiresAt === undefined) return Number.NaN;\n  if (typeof expiresAt === \"number\") return expiresAt;\n  if (expiresAt instanceof Date) return expiresAt.getTime();\n  return Date.parse(expiresAt);\n}\n\n/** Whole minutes left at `now`, rounded up, never below 0; null for an unreadable end. */\nfunction minutesAt(expiry: number, now: number): number | null {\n  if (!Number.isFinite(expiry)) return null;\n  return Math.max(0, Math.ceil((expiry - now) / MINUTE));\n}\n\n/**\n * The countdown at `now` — pure, for a test or a server-rendered value. See\n * {@link DemoCountdown} for the rounding and the thresholds.\n */\nexport function demoCountdown(expiresAt: DemoExpiry | null | undefined, now: number): DemoCountdown {\n  return countdownOf(minutesAt(expiryMs(expiresAt), now));\n}\n\nfunction countdownOf(minutesLeft: number | null): DemoCountdown {\n  if (minutesLeft === null) {\n    return { minutesLeft, hours: 0, minutes: 0, lastHour: false, warning: false, ended: false };\n  }\n  const lastHour = minutesLeft <= DEMO_MINUTES_ONLY;\n  return {\n    minutesLeft,\n    hours: lastHour ? 0 : Math.floor(minutesLeft / 60),\n    minutes: lastHour ? minutesLeft : minutesLeft % 60,\n    lastHour,\n    warning: minutesLeft <= DEMO_WARNING_MINUTES,\n    ended: minutesLeft === 0,\n  };\n}\n\nexport interface DemoCountdownOptions {\n  /**\n   * The clock, in epoch milliseconds. Default `Date.now`. A test passes its own (or uses\n   * fake timers, which move `Date.now` too). Keep it a stable function — a new one each\n   * render re-arms the timer each render.\n   */\n  now?: () => number;\n  /** Called once when the countdown reaches zero — also on mount, if it already has.\n   *  The app clears the session and replaces to `/demo/ended` (§5.5). */\n  onEnded?: () => void;\n}\n\n/**\n * The time left to `expiresAt`, re-rendering when the shown minute changes — one timer\n * to the next minute boundary, not a tick a second — and once more when the tab comes\n * back from the background (a hidden tab's timers are throttled).\n *\n * `onEnded` fires at zero (§5.5). The countdown is the client's, from `expires_at`; the\n * server's answer to a request after the end (a 401) ends the demo as well — the app's\n * 401 handler, not this hook.\n */\nexport function useDemoCountdown(\n  expiresAt: DemoExpiry | null | undefined,\n  { now = Date.now, onEnded }: DemoCountdownOptions = {},\n): DemoCountdown {\n  const expiry = expiryMs(expiresAt);\n  const subscribe = useCallback(\n    (notify: () => void) => {\n      if (!Number.isFinite(expiry)) return () => {};\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const arm = () => {\n        const left = expiry - now();\n        if (left <= 0) return;\n        // The rounded-up minute changes when `left` crosses the next whole minute below.\n        const delay = left - (Math.ceil(left / MINUTE) - 1) * MINUTE;\n        timer = setTimeout(() => {\n          notify();\n          arm();\n        }, delay);\n      };\n      const onVisible = () => {\n        if (document.visibilityState !== \"visible\") return;\n        clearTimeout(timer);\n        notify();\n        arm();\n      };\n      arm();\n      document.addEventListener(\"visibilitychange\", onVisible);\n      return () => {\n        clearTimeout(timer);\n        document.removeEventListener(\"visibilitychange\", onVisible);\n      };\n    },\n    [expiry, now],\n  );\n  const snapshot = () => minutesAt(expiry, now());\n  const minutesLeft = useSyncExternalStore(subscribe, snapshot, snapshot);\n  const countdown = countdownOf(minutesLeft);\n\n  const fireEnded = useEffectEvent(() => onEnded?.());\n  useEffect(() => {\n    if (countdown.ended) fireEnded();\n  }, [countdown.ended]);\n\n  return countdown;\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,gBAAgB,4BAA4B;AAatE,MAAM,uBAAuB;AAE7B,MAAM,oBAAoB;AAEjC,MAAM,SAAS;AAsBf,SAAS,SAAS,WAAkD;AAClE,MAAI,cAAc,QAAQ,cAAc,OAAW,QAAO,OAAO;AACjE,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,MAAI,qBAAqB,KAAM,QAAO,UAAU,QAAQ;AACxD,SAAO,KAAK,MAAM,SAAS;AAC7B;AAGA,SAAS,UAAU,QAAgB,KAA4B;AAC7D,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO;AACrC,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,SAAS,OAAO,MAAM,CAAC;AACvD;AAMO,SAAS,cAAc,WAA0C,KAA4B;AAClG,SAAO,YAAY,UAAU,SAAS,SAAS,GAAG,GAAG,CAAC;AACxD;AAEA,SAAS,YAAY,aAA2C;AAC9D,MAAI,gBAAgB,MAAM;AACxB,WAAO,EAAE,aAAa,OAAO,GAAG,SAAS,GAAG,UAAU,OAAO,SAAS,OAAO,OAAO,MAAM;AAAA,EAC5F;AACA,QAAM,WAAW,eAAe;AAChC,SAAO;AAAA,IACL;AAAA,IACA,OAAO,WAAW,IAAI,KAAK,MAAM,cAAc,EAAE;AAAA,IACjD,SAAS,WAAW,cAAc,cAAc;AAAA,IAChD;AAAA,IACA,SAAS,eAAe;AAAA,IACxB,OAAO,gBAAgB;AAAA,EACzB;AACF;AAuBO,SAAS,iBACd,WACA,EAAE,MAAM,KAAK,KAAK,QAAQ,IAA0B,CAAC,GACtC;AACf,QAAM,SAAS,SAAS,SAAS;AACjC,QAAM,YAAY;AAAA,IAChB,CAAC,WAAuB;AACtB,UAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO,MAAM;AAAA,MAAC;AAC5C,UAAI;AACJ,YAAM,MAAM,MAAM;AAChB,cAAM,OAAO,SAAS,IAAI;AAC1B,YAAI,QAAQ,EAAG;AAEf,cAAM,QAAQ,QAAQ,KAAK,KAAK,OAAO,MAAM,IAAI,KAAK;AACtD,gBAAQ,WAAW,MAAM;AACvB,iBAAO;AACP,cAAI;AAAA,QACN,GAAG,KAAK;AAAA,MACV;AACA,YAAM,YAAY,MAAM;AACtB,YAAI,SAAS,oBAAoB,UAAW;AAC5C,qBAAa,KAAK;AAClB,eAAO;AACP,YAAI;AAAA,MACN;AACA,UAAI;AACJ,eAAS,iBAAiB,oBAAoB,SAAS;AACvD,aAAO,MAAM;AACX,qBAAa,KAAK;AAClB,iBAAS,oBAAoB,oBAAoB,SAAS;AAAA,MAC5D;AAAA,IACF;AAAA,IACA,CAAC,QAAQ,GAAG;AAAA,EACd;AACA,QAAM,WAAW,MAAM,UAAU,QAAQ,IAAI,CAAC;AAC9C,QAAM,cAAc,qBAAqB,WAAW,UAAU,QAAQ;AACtE,QAAM,YAAY,YAAY,WAAW;AAEzC,QAAM,YAAY,eAAe,MAAM,UAAU,CAAC;AAClD,YAAU,MAAM;AACd,QAAI,UAAU,MAAO,WAAU;AAAA,EACjC,GAAG,CAAC,UAAU,KAAK,CAAC;AAEpB,SAAO;AACT;","names":[]}

package/dist/demo/demo-ended.d.ts

@@ -0,0 +1,45 @@
+import * as react from 'react';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { AuthHeadingLevel } from '../auth/status-parts.js';
+import { AccessChoice } from '../landing/access.js';
+import { LandingLabels } from '../landing/landing-labels.js';
+import { DemoLabels } from './demo-labels.js';
+import { DemoModel } from './demo-session.js';
+
+interface DemoEndedProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "title"> {
+    /** Which line the page says about the data (§2.3). */
+    model: DemoModel;
+    /** "Request access". */
+    access: AccessChoice;
+    /** "Start a new demo". Default `/demo` — a new demo may start after one ends, within
+     *  the per-IP window (§2.7). */
+    restartHref?: string;
+    /** "Sign in". Default `/login`. */
+    signInHref?: string;
+    /** App content under the line. */
+    children?: ReactNode;
+    /** `false` adds no `noindex` — for a preview. Default `true` (§4.3). */
+    noIndex?: boolean;
+    /** Default `h2`, under `AuthLayout`'s `h1`. */
+    headingAs?: AuthHeadingLevel;
+    labels?: Partial<DemoLabels>;
+    /** The access words (`landing` namespace) for this instance. */
+    landingLabels?: Partial<LandingLabels>;
+}
+/**
+ * The `/demo/ended` page's content (docs/landing-demo-harmonization.md §5.5): "The demo
+ * has ended", one line on what became of the data, and three ways on — "Start a new
+ * demo", "Request access", "Sign in".
+ *
+ * Where a demo lands at `expires_at`, or on ANY 401 while the session is a demo: the
+ * client clears the session and replaces to `/demo/ended`, never to `/login`. keksdose's
+ * expired demo met an unexplained sign-in form. The server deletes the user at the next
+ * reap; nothing is kept.
+ *
+ * Content, like `NotFoundPage`: put it in the app's `AuthLayout` (its logo, language
+ * menu and legal footer). It marks the page `noindex`; robots.txt must NOT disallow it,
+ * or a crawler could never read that (§10.8).
+ */
+declare function DemoEnded({ model, access, restartHref, signInHref, children, noIndex, headingAs: Heading, labels: labelsProp, landingLabels, className, ...rest }: DemoEndedProps): react.JSX.Element;
+
+export { DemoEnded, type DemoEndedProps };

package/dist/demo/demo-ended.js

@@ -0,0 +1,42 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Hourglass } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { Button } from "../components/ui.js";
+import { useNoIndex } from "../hooks/use-noindex.js";
+import { useAccessAction } from "../landing/access.js";
+import { useLandingLabels } from "../landing/landing-labels.js";
+import { useDemoLabels } from "./demo-labels.js";
+function DemoEnded({
+  model,
+  access,
+  restartHref = "/demo",
+  signInHref = "/login",
+  children,
+  noIndex = true,
+  headingAs: Heading = "h2",
+  labels: labelsProp,
+  landingLabels,
+  className,
+  ...rest
+}) {
+  const labels = useDemoLabels(labelsProp);
+  const landing = useLandingLabels(landingLabels);
+  const accessLink = useAccessAction(access, landingLabels);
+  useNoIndex(noIndex);
+  return /* @__PURE__ */ jsxs("div", { ...rest, className: cn("flex flex-col items-center gap-2 py-4 text-center", className), children: [
+    /* @__PURE__ */ jsx(Hourglass, { "aria-hidden": true, className: "size-10 text-[var(--text-placeholder)]" }),
+    /* @__PURE__ */ jsx(Heading, { className: "mt-2 text-xl font-semibold text-[var(--text-primary)]", children: labels.endedTitle }),
+    /* @__PURE__ */ jsx("p", { className: "max-w-prose text-sm text-[var(--text-secondary)]", children: model === "sandbox" ? labels.endedSandbox : labels.endedReadOnly }),
+    children,
+    /* @__PURE__ */ jsxs("div", { className: "mt-4 flex w-full flex-col gap-2 sm:w-auto sm:flex-row sm:flex-wrap sm:justify-center", children: [
+      /* @__PURE__ */ jsx(Button, { href: restartHref, variant: "brand", children: labels.restart }),
+      /* @__PURE__ */ jsx(Button, { href: accessLink.href, variant: "secondary", children: accessLink.label }),
+      /* @__PURE__ */ jsx(Button, { href: signInHref, variant: "secondary", children: landing.signIn })
+    ] })
+  ] });
+}
+export {
+  DemoEnded
+};
+//# sourceMappingURL=demo-ended.js.map

package/dist/demo/demo-ended.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/demo/demo-ended.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, ReactNode } from \"react\";\nimport { Hourglass } from \"lucide-react\";\n\nimport { cn } from \"../lib/cn\";\nimport { Button } from \"../components/ui\";\nimport { useNoIndex } from \"../hooks/use-noindex\";\nimport type { AuthHeadingLevel } from \"../auth/status-parts\";\nimport { useAccessAction } from \"../landing/access\";\nimport type { AccessChoice } from \"../landing/access\";\nimport { useLandingLabels } from \"../landing/landing-labels\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport { useDemoLabels } from \"./demo-labels\";\nimport type { DemoLabels } from \"./demo-labels\";\nimport type { DemoModel } from \"./demo-session\";\n\nexport interface DemoEndedProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"children\" | \"title\"> {\n  /** Which line the page says about the data (§2.3). */\n  model: DemoModel;\n  /** \"Request access\". */\n  access: AccessChoice;\n  /** \"Start a new demo\". Default `/demo` — a new demo may start after one ends, within\n   *  the per-IP window (§2.7). */\n  restartHref?: string;\n  /** \"Sign in\". Default `/login`. */\n  signInHref?: string;\n  /** App content under the line. */\n  children?: ReactNode;\n  /** `false` adds no `noindex` — for a preview. Default `true` (§4.3). */\n  noIndex?: boolean;\n  /** Default `h2`, under `AuthLayout`'s `h1`. */\n  headingAs?: AuthHeadingLevel;\n  labels?: Partial<DemoLabels>;\n  /** The access words (`landing` namespace) for this instance. */\n  landingLabels?: Partial<LandingLabels>;\n}\n\n/**\n * The `/demo/ended` page's content (docs/landing-demo-harmonization.md §5.5): \"The demo\n * has ended\", one line on what became of the data, and three ways on — \"Start a new\n * demo\", \"Request access\", \"Sign in\".\n *\n * Where a demo lands at `expires_at`, or on ANY 401 while the session is a demo: the\n * client clears the session and replaces to `/demo/ended`, never to `/login`. keksdose's\n * expired demo met an unexplained sign-in form. The server deletes the user at the next\n * reap; nothing is kept.\n *\n * Content, like `NotFoundPage`: put it in the app's `AuthLayout` (its logo, language\n * menu and legal footer). It marks the page `noindex`; robots.txt must NOT disallow it,\n * or a crawler could never read that (§10.8).\n */\nexport function DemoEnded({\n  model,\n  access,\n  restartHref = \"/demo\",\n  signInHref = \"/login\",\n  children,\n  noIndex = true,\n  headingAs: Heading = \"h2\",\n  labels: labelsProp,\n  landingLabels,\n  className,\n  ...rest\n}: DemoEndedProps) {\n  const labels = useDemoLabels(labelsProp);\n  const landing = useLandingLabels(landingLabels);\n  const accessLink = useAccessAction(access, landingLabels);\n  useNoIndex(noIndex);\n  return (\n    <div {...rest} className={cn(\"flex flex-col items-center gap-2 py-4 text-center\", className)}>\n      <Hourglass aria-hidden className=\"size-10 text-[var(--text-placeholder)]\" />\n      <Heading className=\"mt-2 text-xl font-semibold text-[var(--text-primary)]\">{labels.endedTitle}</Heading>\n      <p className=\"max-w-prose text-sm text-[var(--text-secondary)]\">\n        {model === \"sandbox\" ? labels.endedSandbox : labels.endedReadOnly}\n      </p>\n      {children}\n      <div className=\"mt-4 flex w-full flex-col gap-2 sm:w-auto sm:flex-row sm:flex-wrap sm:justify-center\">\n        <Button href={restartHref} variant=\"brand\">\n          {labels.restart}\n        </Button>\n        <Button href={accessLink.href} variant=\"secondary\">\n          {accessLink.label}\n        </Button>\n        <Button href={signInHref} variant=\"secondary\">\n          {landing.signIn}\n        </Button>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";AAqEM,cAMA,YANA;AApEN,SAAS,iBAAiB;AAE1B,SAAS,UAAU;AACnB,SAAS,cAAc;AACvB,SAAS,kBAAkB;AAE3B,SAAS,uBAAuB;AAEhC,SAAS,wBAAwB;AAEjC,SAAS,qBAAqB;AAuCvB,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,aAAa;AAAA,EACb;AAAA,EACA,UAAU;AAAA,EACV,WAAW,UAAU;AAAA,EACrB,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAmB;AACjB,QAAM,SAAS,cAAc,UAAU;AACvC,QAAM,UAAU,iBAAiB,aAAa;AAC9C,QAAM,aAAa,gBAAgB,QAAQ,aAAa;AACxD,aAAW,OAAO;AAClB,SACE,qBAAC,SAAK,GAAG,MAAM,WAAW,GAAG,qDAAqD,SAAS,GACzF;AAAA,wBAAC,aAAU,eAAW,MAAC,WAAU,0CAAyC;AAAA,IAC1E,oBAAC,WAAQ,WAAU,yDAAyD,iBAAO,YAAW;AAAA,IAC9F,oBAAC,OAAE,WAAU,oDACV,oBAAU,YAAY,OAAO,eAAe,OAAO,eACtD;AAAA,IACC;AAAA,IACD,qBAAC,SAAI,WAAU,wFACb;AAAA,0BAAC,UAAO,MAAM,aAAa,SAAQ,SAChC,iBAAO,SACV;AAAA,MACA,oBAAC,UAAO,MAAM,WAAW,MAAM,SAAQ,aACpC,qBAAW,OACd;AAAA,MACA,oBAAC,UAAO,MAAM,YAAY,SAAQ,aAC/B,kBAAQ,QACX;AAAA,OACF;AAAA,KACF;AAEJ;","names":[]}

package/dist/demo/demo-labels.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The demo's words (docs/landing-demo-harmonization.md §5) — the `demo` namespace of
+ * `<UiKitProvider labels>`: `DemoStart`'s progress and refusals, `DemoBanner`'s
+ * countdown and model line, `DemoEnded`, and the reason of the read-only lock.
+ *
+ * "Demo" means the demo session and the shared demo data it shows (§2.10) — never
+ * keksdose's blur toggle, which is "Presentation mode" now. "Request access" and "Sign
+ * in" are the `landing` namespace's, so they read the same on every public page.
+ */
+interface DemoLabels {
+    /** `DemoStart` while the demo is being created. */
+    starting: string;
+    /** `demo_rate_limited`: too many demos from one network, given the wait in whole
+     *  minutes from `Retry-After` — or `undefined` without one. */
+    rateLimited: (minutes?: number) => string;
+    /** `demo_capacity`: the live cap is reached. */
+    capacity: string;
+    /** `demo_disabled` and `demo_not_ready`: the demo is off, or its data isn't there. */
+    unavailable: string;
+    /** Any other failure — the network, a 500. */
+    failed: string;
+    /** `DemoStart`'s way out after a refusal, to the landing. */
+    backToStart: string;
+    /** The banner's countdown with an hour or more left: "Demo · 23 h 12 min left". */
+    hoursLeft: (hours: number, minutes: number) => string;
+    /** …and in the last hour, minutes only: "Demo · 50 min left". */
+    minutesLeft: (minutes: number) => string;
+    /** The banner's word when the end is unknown (no readable `expiresAt`). */
+    badge: string;
+    /** The banner's line for model R, shared read-only data. */
+    readOnly: string;
+    /** The banner's line for model S, a sandbox of one's own. */
+    sandbox: string;
+    /** The name of the banner's show/hide toggle (`aria-expanded` says which). */
+    details: string;
+    /** The reason a locked commit shows in a read-only demo (model R) — for the app's
+     *  `<WriteLockProvider locked reason={…}>` (§5.4). */
+    writeLocked: string;
+    /** `DemoEnded`'s heading; also the banner's text at zero. */
+    endedTitle: string;
+    /** `DemoEnded`'s line for model R. */
+    endedReadOnly: string;
+    /** `DemoEnded`'s line for model S. */
+    endedSandbox: string;
+    /** `DemoEnded`'s first action, to `/demo`. */
+    restart: string;
+}
+declare const DEFAULT_DEMO_LABELS: DemoLabels;
+/** The `demo` namespace, resolved: English, then the provider, then `labels`. The app
+ *  reads `writeLocked` from here for its `WriteLockProvider`. */
+declare function useDemoLabels(labels?: Partial<DemoLabels>): DemoLabels;
+
+export { DEFAULT_DEMO_LABELS, type DemoLabels, useDemoLabels };

package/dist/demo/demo-labels.js

@@ -0,0 +1,29 @@
+"use client";
+import { useKitLabels } from "../i18n/kit-labels.js";
+const DEFAULT_DEMO_LABELS = {
+  starting: "Starting the demo\u2026",
+  rateLimited: (minutes) => minutes ? `Too many demos from this network. Try again in ${minutes} min.` : "Too many demos from this network. Try again later.",
+  capacity: "The demo is full right now. Try again later.",
+  unavailable: "The demo isn\u2019t available right now.",
+  failed: "The demo could not be started. Please try again.",
+  backToStart: "Back to the start page",
+  hoursLeft: (hours, minutes) => `Demo \xB7 ${hours} h ${minutes} min left`,
+  minutesLeft: (minutes) => `Demo \xB7 ${minutes} min left`,
+  badge: "Demo",
+  readOnly: "You\u2019re looking at sample data. Changes aren\u2019t possible.",
+  sandbox: "Your own work is deleted when the demo ends.",
+  details: "Demo details",
+  writeLocked: "Not possible in the demo.",
+  endedTitle: "The demo has ended",
+  endedReadOnly: "Sample data is reset regularly.",
+  endedSandbox: "Sample data is reset regularly; your own work from the demo is deleted.",
+  restart: "Start a new demo"
+};
+function useDemoLabels(labels) {
+  return useKitLabels("demo", DEFAULT_DEMO_LABELS, labels);
+}
+export {
+  DEFAULT_DEMO_LABELS,
+  useDemoLabels
+};
+//# sourceMappingURL=demo-labels.js.map

package/dist/demo/demo-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/demo/demo-labels.ts"],"sourcesContent":["import { useKitLabels } from \"../i18n/kit-labels\";\n\n/**\n * The demo's words (docs/landing-demo-harmonization.md §5) — the `demo` namespace of\n * `<UiKitProvider labels>`: `DemoStart`'s progress and refusals, `DemoBanner`'s\n * countdown and model line, `DemoEnded`, and the reason of the read-only lock.\n *\n * \"Demo\" means the demo session and the shared demo data it shows (§2.10) — never\n * keksdose's blur toggle, which is \"Presentation mode\" now. \"Request access\" and \"Sign\n * in\" are the `landing` namespace's, so they read the same on every public page.\n */\nexport interface DemoLabels {\n  /** `DemoStart` while the demo is being created. */\n  starting: string;\n  /** `demo_rate_limited`: too many demos from one network, given the wait in whole\n   *  minutes from `Retry-After` — or `undefined` without one. */\n  rateLimited: (minutes?: number) => string;\n  /** `demo_capacity`: the live cap is reached. */\n  capacity: string;\n  /** `demo_disabled` and `demo_not_ready`: the demo is off, or its data isn't there. */\n  unavailable: string;\n  /** Any other failure — the network, a 500. */\n  failed: string;\n  /** `DemoStart`'s way out after a refusal, to the landing. */\n  backToStart: string;\n  /** The banner's countdown with an hour or more left: \"Demo · 23 h 12 min left\". */\n  hoursLeft: (hours: number, minutes: number) => string;\n  /** …and in the last hour, minutes only: \"Demo · 50 min left\". */\n  minutesLeft: (minutes: number) => string;\n  /** The banner's word when the end is unknown (no readable `expiresAt`). */\n  badge: string;\n  /** The banner's line for model R, shared read-only data. */\n  readOnly: string;\n  /** The banner's line for model S, a sandbox of one's own. */\n  sandbox: string;\n  /** The name of the banner's show/hide toggle (`aria-expanded` says which). */\n  details: string;\n  /** The reason a locked commit shows in a read-only demo (model R) — for the app's\n   *  `<WriteLockProvider locked reason={…}>` (§5.4). */\n  writeLocked: string;\n  /** `DemoEnded`'s heading; also the banner's text at zero. */\n  endedTitle: string;\n  /** `DemoEnded`'s line for model R. */\n  endedReadOnly: string;\n  /** `DemoEnded`'s line for model S. */\n  endedSandbox: string;\n  /** `DemoEnded`'s first action, to `/demo`. */\n  restart: string;\n}\n\nexport const DEFAULT_DEMO_LABELS: DemoLabels = {\n  starting: \"Starting the demo…\",\n  rateLimited: (minutes) =>\n    minutes\n      ? `Too many demos from this network. Try again in ${minutes} min.`\n      : \"Too many demos from this network. Try again later.\",\n  capacity: \"The demo is full right now. Try again later.\",\n  unavailable: \"The demo isn’t available right now.\",\n  failed: \"The demo could not be started. Please try again.\",\n  backToStart: \"Back to the start page\",\n  hoursLeft: (hours, minutes) => `Demo · ${hours} h ${minutes} min left`,\n  minutesLeft: (minutes) => `Demo · ${minutes} min left`,\n  badge: \"Demo\",\n  readOnly: \"You’re looking at sample data. Changes aren’t possible.\",\n  sandbox: \"Your own work is deleted when the demo ends.\",\n  details: \"Demo details\",\n  writeLocked: \"Not possible in the demo.\",\n  endedTitle: \"The demo has ended\",\n  endedReadOnly: \"Sample data is reset regularly.\",\n  endedSandbox: \"Sample data is reset regularly; your own work from the demo is deleted.\",\n  restart: \"Start a new demo\",\n};\n\n/** The `demo` namespace, resolved: English, then the provider, then `labels`. The app\n *  reads `writeLocked` from here for its `WriteLockProvider`. */\nexport function useDemoLabels(labels?: Partial<DemoLabels>): DemoLabels {\n  return useKitLabels(\"demo\", DEFAULT_DEMO_LABELS, labels);\n}\n"],"mappings":";AAAA,SAAS,oBAAoB;AAkDtB,MAAM,sBAAkC;AAAA,EAC7C,UAAU;AAAA,EACV,aAAa,CAAC,YACZ,UACI,kDAAkD,OAAO,UACzD;AAAA,EACN,UAAU;AAAA,EACV,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,WAAW,CAAC,OAAO,YAAY,aAAU,KAAK,MAAM,OAAO;AAAA,EAC3D,aAAa,CAAC,YAAY,aAAU,OAAO;AAAA,EAC3C,OAAO;AAAA,EACP,UAAU;AAAA,EACV,SAAS;AAAA,EACT,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,cAAc;AAAA,EACd,SAAS;AACX;AAIO,SAAS,cAAc,QAA0C;AACtE,SAAO,aAAa,QAAQ,qBAAqB,MAAM;AACzD;","names":[]}

package/dist/demo/demo-session.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The two demo models (docs/landing-demo-harmonization.md §2.3):
+ *
+ * - `read-only` (R) — keksdose and kastlan: one pre-filled shared dataset a throwaway
+ *   demo user may look at but not change;
+ * - `sandbox` (S) — Kurvenschmiede: the demo user reads system-owned worked examples and
+ *   may create or copy work of its own, deleted with the demo account.
+ */
+type DemoModel = "read-only" | "sandbox";
+/** The fields of an `/auth/me` answer {@link isDemoSession} reads — server-kit's
+ *  `UserResponse.is_demo` (0.5: and `demo_expires_at`), or a client's camel-cased copy. */
+interface DemoSessionUser {
+    is_demo?: boolean | null;
+    isDemo?: boolean | null;
+}
+/**
+ * Whether the signed-in user is a demo (§5, §6.5): server-kit's `is_demo` on
+ * `/auth/me`, or a client's `isDemo`. `false` for no user at all.
+ *
+ * What the client branches on: the demo banner instead of keksdose's preview banner, the
+ * header's "Continue the demo", a 401 that ends at `/demo/ended` instead of `/login`, and
+ * the crash reporter, which files nothing for a demo:
+ *
+ * ```ts
+ * createCrashReporter({ …, suppress: () => isDemoSession(useAuth.getState().user) });
+ * ```
+ */
+declare function isDemoSession(me: DemoSessionUser | null | undefined): boolean;
+
+export { type DemoModel, type DemoSessionUser, isDemoSession };

package/dist/demo/demo-session.js

@@ -0,0 +1,8 @@
+"use client";
+function isDemoSession(me) {
+  return me?.is_demo === true || me?.isDemo === true;
+}
+export {
+  isDemoSession
+};
+//# sourceMappingURL=demo-session.js.map

package/dist/demo/demo-session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/demo/demo-session.ts"],"sourcesContent":["/**\n * The two demo models (docs/landing-demo-harmonization.md §2.3):\n *\n * - `read-only` (R) — keksdose and kastlan: one pre-filled shared dataset a throwaway\n *   demo user may look at but not change;\n * - `sandbox` (S) — Kurvenschmiede: the demo user reads system-owned worked examples and\n *   may create or copy work of its own, deleted with the demo account.\n */\nexport type DemoModel = \"read-only\" | \"sandbox\";\n\n/** The fields of an `/auth/me` answer {@link isDemoSession} reads — server-kit's\n *  `UserResponse.is_demo` (0.5: and `demo_expires_at`), or a client's camel-cased copy. */\nexport interface DemoSessionUser {\n  is_demo?: boolean | null;\n  isDemo?: boolean | null;\n}\n\n/**\n * Whether the signed-in user is a demo (§5, §6.5): server-kit's `is_demo` on\n * `/auth/me`, or a client's `isDemo`. `false` for no user at all.\n *\n * What the client branches on: the demo banner instead of keksdose's preview banner, the\n * header's \"Continue the demo\", a 401 that ends at `/demo/ended` instead of `/login`, and\n * the crash reporter, which files nothing for a demo:\n *\n * ```ts\n * createCrashReporter({ …, suppress: () => isDemoSession(useAuth.getState().user) });\n * ```\n */\nexport function isDemoSession(me: DemoSessionUser | null | undefined): boolean {\n  return me?.is_demo === true || me?.isDemo === true;\n}\n"],"mappings":";AA6BO,SAAS,cAAc,IAAiD;AAC7E,SAAO,IAAI,YAAY,QAAQ,IAAI,WAAW;AAChD;","names":[]}

package/dist/demo/demo-start.d.ts

@@ -0,0 +1,54 @@
+import * as react from 'react';
+import { ComponentPropsWithoutRef } from 'react';
+import { AccessChoice } from '../landing/access.js';
+import { LandingLabels } from '../landing/landing-labels.js';
+import { DemoLabels } from './demo-labels.js';
+
+interface DemoStartProps<T> extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
+    /**
+     * Create the demo: the app's `POST /auth/demo-session {locale}`. Resolve with what it
+     * answered (the `TokenResponse`, `refresh_token: null`, `expires_at`); reject with the
+     * client's error — the codes are read out of it. Called once per mount.
+     */
+    start: () => Promise<T>;
+    /** The demo exists: store the session (and, for kastlan, `kastlan.demoSession`) and
+     *  replace to the app's home. The page keeps saying "Starting the demo…" meanwhile. */
+    onStarted: (session: T) => void;
+    /** "Request access" beside a refusal. */
+    access: AccessChoice;
+    /** "Back to the start page". Default `/`. */
+    backHref?: string;
+    /** `false` adds no `noindex` — for a preview. Default `true`: `/demo` is never indexed
+     *  (§4.3). */
+    noIndex?: boolean;
+    labels?: Partial<DemoLabels>;
+    /** The access words (`landing` namespace) for this instance. */
+    landingLabels?: Partial<LandingLabels>;
+}
+/**
+ * The `/demo` page's content (docs/landing-demo-harmonization.md §5.2): it starts the
+ * demo ONCE — StrictMode's double mount included, keksdose's ref guard — and says
+ * "Starting the demo…" until the app has the session and has moved on.
+ *
+ * A refusal says why, in the visitor's words, and offers "Request access" and "Back to
+ * the start page":
+ *
+ * | code | says |
+ * |---|---|
+ * | `demo_rate_limited` (429) | "Too many demos from this network. Try again in N min." — N from `Retry-After` |
+ * | `demo_capacity` (429) | "The demo is full right now. Try again later." |
+ * | `demo_disabled` (404), `demo_not_ready` (503) | "The demo isn't available right now." |
+ * | anything else | "The demo could not be started. Please try again." |
+ *
+ * keksdose fell back to `/register` with a toast; registration is invitation-only now,
+ * so the way on is the access mail.
+ *
+ * Put it in the app's `AuthLayout`. A live demo session never reaches it: the `/demo`
+ * route sits in `RedirectIfAuthed` WITHOUT `allowDemo`, which continues the live demo at
+ * its resume target instead of starting a second one. A cold start is the kit's
+ * `ServerWakeNotice`'s, once the app's watcher counts this POST
+ * (`watchReadsAnd(/\/auth\/demo-session\b/)`).
+ */
+declare function DemoStart<T>({ start, onStarted, access, backHref, noIndex, labels: labelsProp, landingLabels, className, ...rest }: DemoStartProps<T>): react.JSX.Element;
+
+export { DemoStart, type DemoStartProps };