@eifi1/ui-kit 0.50.1 → 0.51.0

package/dist/landing/public-page.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { cn } from "../lib/cn.js";
+import { useNoIndex } from "../hooks/use-noindex.js";
+import { PublicFooter } from "./landing-sections.js";
+import { usePageSeoIf } from "./page-seo.js";
+const WIDTH = { wide: "max-w-6xl", prose: "max-w-3xl" };
+function PublicPage({
+  header,
+  footer,
+  title,
+  description,
+  back,
+  actions,
+  seo,
+  width = "wide",
+  headingAs: Heading = "h1",
+  landmark = true,
+  className,
+  children,
+  ...rest
+}) {
+  useNoIndex(seo === "noindex");
+  usePageSeoIf(seo === "noindex" ? null : seo);
+  const Main = landmark ? "main" : "div";
+  return /* @__PURE__ */ jsxs("div", { ...rest, "data-slot": "public-page", className: cn("flex min-h-full flex-col", className), children: [
+    header,
+    /* @__PURE__ */ jsx(Main, { className: "flex-1", children: /* @__PURE__ */ jsxs("div", { "data-slot": "public-page-column", className: cn("mx-auto w-full px-4 py-12", WIDTH[width]), children: [
+      back != null && /* @__PURE__ */ jsx("div", { className: "mb-4 text-sm", children: back }),
+      /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between", children: [
+        /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+          /* @__PURE__ */ jsx(Heading, { className: "text-3xl font-bold tracking-tight break-words text-primary", children: title }),
+          description != null && /* @__PURE__ */ jsx("p", { className: "mt-3 max-w-2xl text-lg text-secondary", children: description })
+        ] }),
+        actions != null && /* @__PURE__ */ jsx("div", { "data-slot": "public-page-actions", className: "flex shrink-0 flex-wrap items-center gap-2", children: actions })
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "mt-8 space-y-8", children })
+    ] }) }),
+    footer === void 0 ? /* @__PURE__ */ jsx(PublicFooter, {}) : footer
+  ] });
+}
+export {
+  PublicPage
+};
+//# sourceMappingURL=public-page.js.map

package/dist/landing/public-page.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/landing/public-page.tsx"],"sourcesContent":["import type { ComponentPropsWithRef, ReactNode } from \"react\";\n\nimport { cn } from \"../lib/cn\";\nimport { useNoIndex } from \"../hooks/use-noindex\";\nimport { PublicFooter } from \"./landing-sections\";\nimport { usePageSeoIf, type PageSeo } from \"./page-seo\";\n\nexport interface PublicPageProps extends Omit<ComponentPropsWithRef<\"div\">, \"title\" | \"children\"> {\n  /** The app's public header — the one a signed-out visitor already sees on the landing\n   *  (`PublicHeader`, keksdose's `LandingHeader`, Kurvenschmiede's). */\n  header?: ReactNode;\n  /** Default: `<PublicFooter />`, the three legal links (§3.3: one click away from every\n   *  page a visitor can reach). Pass your own `PublicFooter` for a tagline; `null` for none. */\n  footer?: ReactNode;\n  /** The page's heading. */\n  title: ReactNode;\n  /** One or two sentences under the title: what the page is. */\n  description?: ReactNode;\n  /** Above the title — the app's \"← Back\" link (`<TextLink icon={ArrowLeft}>`). */\n  back?: ReactNode;\n  /** Beside the title from `sm` up, under it on a phone: the page's own controls (a\n   *  region and a month picker on keksdose's /prices). */\n  actions?: ReactNode;\n  /**\n   * What search engines are told, and it has no default on purpose: a public page is\n   * either one to find — then it names its canonical path (and title, description,\n   * structured data), through {@link usePageSeo} — or one to keep out of the index\n   * (`\"noindex\"`: a 404, a page a link was sent for). `null` declares nothing, for a page\n   * that is not the page: a preview inside another (the showcase).\n   */\n  seo: PageSeo | \"noindex\" | null;\n  /** The column. `\"wide\"` (default) is the landing's sections' width, for tiles and\n   *  tables; `\"prose\"` the legal pages' reading column. */\n  width?: \"wide\" | \"prose\";\n  /** Default `h1`; a lower level for a page shown inside another (a preview), as the\n   *  landing's sections take one. */\n  headingAs?: \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\";\n  /** `false` draws the column as a `<div>` instead of `<main>`, for a host that has its\n   *  own `<main>`. Default true. */\n  landmark?: boolean;\n  children: ReactNode;\n}\n\nconst WIDTH = { wide: \"max-w-6xl\", prose: \"max-w-3xl\" } as const;\n\n/**\n * A public page that is not the landing and not a legal page (0.51, Marcel 2026-10-26):\n * keksdose's regional price snapshot at /prices, and Kurvenschmiede's public pages. The\n * frame every public page has — the app's public header, a column, the public footer — is\n * {@link LegalPage}'s, without the legal parts: no numbered sections, no beta notice, no\n * \"Back to home\" of its own, and indexed unless it says otherwise.\n *\n * keksdose was about to compose it by hand (`PublicHeader` + a column + `PublicFooter` +\n * `usePageSeo`) for /prices, and Kurvenschmiede will have its next public page outside the\n * shell; each app would have drawn the frame its own way. (KS's visitor pages — /dashboard,\n * /control, /dynamics, /steering — are working screens and stay in the app shell, with\n * `VisitorLegalFooter`; this frame is not for them.)\n * The width is the landing's (`max-w-6xl`), so a link from a feature row lands on a page\n * whose edges line up with the one it came from.\n *\n * `seo` is required: a public page is found or it is not, and forgetting the canonical on\n * a page meant to be found is silent. The kit's words are none — the title, the copy and\n * the back link are the app's.\n */\nexport function PublicPage({\n  header,\n  footer,\n  title,\n  description,\n  back,\n  actions,\n  seo,\n  width = \"wide\",\n  headingAs: Heading = \"h1\",\n  landmark = true,\n  className,\n  children,\n  ...rest\n}: PublicPageProps) {\n  useNoIndex(seo === \"noindex\");\n  usePageSeoIf(seo === \"noindex\" ? null : seo);\n  const Main = landmark ? \"main\" : \"div\";\n  return (\n    <div {...rest} data-slot=\"public-page\" className={cn(\"flex min-h-full flex-col\", className)}>\n      {header}\n      <Main className=\"flex-1\">\n        <div data-slot=\"public-page-column\" className={cn(\"mx-auto w-full px-4 py-12\", WIDTH[width])}>\n          {back != null && <div className=\"mb-4 text-sm\">{back}</div>}\n          <div className=\"flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between\">\n            <div className=\"min-w-0\">\n              <Heading className=\"text-3xl font-bold tracking-tight break-words text-primary\">{title}</Heading>\n              {description != null && <p className=\"mt-3 max-w-2xl text-lg text-secondary\">{description}</p>}\n            </div>\n            {actions != null && (\n              <div data-slot=\"public-page-actions\" className=\"flex shrink-0 flex-wrap items-center gap-2\">\n                {actions}\n              </div>\n            )}\n          </div>\n          <div className=\"mt-8 space-y-8\">{children}</div>\n        </div>\n      </Main>\n      {footer === undefined ? <PublicFooter /> : footer}\n    </div>\n  );\n}\n"],"mappings":";AAuF2B,cAEf,YAFe;AArF3B,SAAS,UAAU;AACnB,SAAS,kBAAkB;AAC3B,SAAS,oBAAoB;AAC7B,SAAS,oBAAkC;AAsC3C,MAAM,QAAQ,EAAE,MAAM,aAAa,OAAO,YAAY;AAqB/C,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,WAAW,UAAU;AAAA,EACrB,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,aAAW,QAAQ,SAAS;AAC5B,eAAa,QAAQ,YAAY,OAAO,GAAG;AAC3C,QAAM,OAAO,WAAW,SAAS;AACjC,SACE,qBAAC,SAAK,GAAG,MAAM,aAAU,eAAc,WAAW,GAAG,4BAA4B,SAAS,GACvF;AAAA;AAAA,IACD,oBAAC,QAAK,WAAU,UACd,+BAAC,SAAI,aAAU,sBAAqB,WAAW,GAAG,6BAA6B,MAAM,KAAK,CAAC,GACxF;AAAA,cAAQ,QAAQ,oBAAC,SAAI,WAAU,gBAAgB,gBAAK;AAAA,MACrD,qBAAC,SAAI,WAAU,qEACb;AAAA,6BAAC,SAAI,WAAU,WACb;AAAA,8BAAC,WAAQ,WAAU,8DAA8D,iBAAM;AAAA,UACtF,eAAe,QAAQ,oBAAC,OAAE,WAAU,yCAAyC,uBAAY;AAAA,WAC5F;AAAA,QACC,WAAW,QACV,oBAAC,SAAI,aAAU,uBAAsB,WAAU,8CAC5C,mBACH;AAAA,SAEJ;AAAA,MACA,oBAAC,SAAI,WAAU,kBAAkB,UAAS;AAAA,OAC5C,GACF;AAAA,IACC,WAAW,SAAY,oBAAC,gBAAa,IAAK;AAAA,KAC7C;AAEJ;","names":[]}

package/dist/lib/server-wake.d.ts

@@ -72,8 +72,9 @@ export interface ServerWakeWatcher {
      */
     start(method?: string, url?: string, request?: ServerWakeRequest): boolean;
     /** A counted request settled — either way: an error still proves the server
-     *  answered or gave up. When the last one does, the notice goes away. Never takes
-     *  the counter below zero. */
+     *  answered or gave up. The stage then follows the oldest request still out (0.51), so
+     *  the notice goes away when the last one does, or sooner when the rest are recent.
+     *  Never takes the counter below zero. */
     end(): void;
     /** `start` + `end` around a promise (or a function returning one), for a request
      *  that does not go through an adapter. Resolves and rejects as the work does. */

package/dist/lib/server-wake.js

@@ -11,7 +11,7 @@ function createServerWake({
   wakingMs = 7e3,
   shouldWatch = watchReadsAnd()
 } = {}) {
-  let inFlight = 0;
+  const starts = [];
   let stage = "idle";
   let slowTimer = null;
   let wakingTimer = null;
@@ -27,22 +27,28 @@ function createServerWake({
     slowTimer = null;
     wakingTimer = null;
   };
+  const arm = () => {
+    clearTimers();
+    if (starts.length === 0) {
+      setStage("idle");
+      return;
+    }
+    const age = Date.now() - starts[0];
+    setStage(age >= wakingMs ? "waking" : age >= slowMs ? "slow" : "idle");
+    if (age < slowMs) slowTimer = setTimeout(() => setStage("slow"), slowMs - age);
+    if (age < wakingMs) wakingTimer = setTimeout(() => setStage("waking"), wakingMs - age);
+  };
   const start = (method, url, request = { method, url }) => {
     if (isOffline()) return false;
     if (!shouldWatch((method ?? "get").toLowerCase(), url ?? "", request)) return false;
-    inFlight += 1;
-    if (inFlight === 1) {
-      clearTimers();
-      slowTimer = setTimeout(() => setStage("slow"), slowMs);
-      wakingTimer = setTimeout(() => setStage("waking"), wakingMs);
-    }
+    starts.push(Date.now());
+    if (starts.length === 1) arm();
     return true;
   };
   const end = () => {
-    inFlight = Math.max(0, inFlight - 1);
-    if (inFlight > 0) return;
-    clearTimers();
-    setStage("idle");
+    if (starts.length === 0) return;
+    starts.shift();
+    arm();
   };
   return {
     start,
@@ -58,7 +64,7 @@ function createServerWake({
       return counted ? promise.finally(end) : promise;
     },
     reset() {
-      inFlight = 0;
+      starts.length = 0;
       clearTimers();
       setStage("idle");
     },
@@ -69,7 +75,7 @@ function createServerWake({
       };
     },
     getStage: () => stage,
-    getInFlight: () => inFlight
+    getInFlight: () => starts.length
   };
 }
 const serverWake = createServerWake();

package/dist/lib/server-wake.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/server-wake.ts"],"sourcesContent":["/**\n * \"Is the server asleep, or is the app broken?\" — the cold-start watchdog, lifted\n * from keksdose (feedback #199) so kastlan and Kurvenschmiede get it too.\n *\n * All three backends run on Cloud Run with `--min-instances=0`: after an idle\n * period the container is gone and the first request has to start it, which takes\n * several seconds and occasionally more. Nothing in the UI said so, and none of the\n * axios instances has a timeout, so the honest experience was a spinner that looked\n * stuck. This counts the in-flight requests a cold start would actually delay and\n * escalates in two steps, so a merely slow response says \"still loading\" and only a\n * genuinely long wait blames the sleeping server.\n *\n * Framework-free on purpose (no zustand, no axios, no React): a counter, two timers\n * and a listener set, read by `useServerWakeStage` through `useSyncExternalStore`.\n * The adapters below take the app's axios instance / fetch as an ARGUMENT, so the\n * kit never imports either.\n *\n * WHAT ARMS IT, and why the default is narrow:\n *   - reads (GET) — what every page does on open — always;\n *   - writes only when the app says so (`watchReadsAnd(/\\/auth\\/login\\b/)`): the\n *     auth POSTs that gate the app are the only writes a user waits on before the\n *     app exists at all, so a cold start there looks exactly like a broken login.\n * An UPLOAD must never be watched — a statement PDF or a photo takes seconds on a\n * perfectly warm server, and \"the server is waking up\" during a 4 s upload would\n * simply be false. With the default that holds by itself (an upload is a POST);\n * an app widening `shouldWatch` keeps its upload routes out of it.\n *\n * Nor a DOWNLOAD, for the same reason (kastlan 0.18): axios answers only once the\n * whole body is in, so a generated PDF or a large photo — a GET — ran past both\n * thresholds on a warm server, and held the count for every read beside it. The\n * default filter skips a request whose `responseType` is `\"blob\"`, `\"arraybuffer\"` or\n * `\"stream\"`; a custom filter gets the request as its third argument to do the same.\n * (`wrapFetch` ends the wait at the headers, so a download through it is harmless.)\n *\n * It never arms while the browser is offline, whatever `shouldWatch` says: that state\n * has its own, truthful indicator, and a request that never left the device is not\n * evidence of anything about the server.\n */\n\n/** `slow` = longer than a warm server ever takes; `waking` = long enough that a cold\n *  start is the only sensible explanation. */\nexport type ServerWakeStage = \"idle\" | \"slow\" | \"waking\";\n\n/** Decides which requests count. `method` arrives lower-cased (`\"get\"` when the\n *  request named none — axios's and fetch's default); `url` as the client had it;\n *  `request` is what the adapter saw — for axios the request config itself, so\n *  `responseType` or the app's own fields can decide. */\nexport type ServerWakeFilter = (method: string, url: string, request: ServerWakeRequest) => boolean;\n\nexport interface ServerWakeOptions {\n  /** Past this, a warm round trip is out of the question (a cold database query on a\n   *  free tier can still take a second, so it is not tighter). Default 2000 ms. */\n  slowMs?: number;\n  /** Past this, the container was almost certainly scaled to zero. Default 7000 ms. */\n  wakingMs?: number;\n  /** Which requests count. Default {@link watchReadsAnd}`()` — GETs only, downloads\n   *  excluded. The offline guard runs before it and cannot be overridden. */\n  shouldWatch?: ServerWakeFilter;\n}\n\n/** What a request is, for {@link ServerWakeWatcher.track} and a {@link ServerWakeFilter}. */\nexport interface ServerWakeRequest {\n  method?: string;\n  url?: string;\n  /** axios's `responseType`. `\"blob\"`, `\"arraybuffer\"` and `\"stream\"` mark a download,\n   *  which the default filter does not count. */\n  responseType?: string;\n}\n\nexport interface ServerWakeWatcher {\n  /**\n   * Count a request that is going out, and arm the escalation if it is the first.\n   * Returns whether it was counted — the caller MUST call {@link end} exactly once\n   * for every `true`, or the counter never returns to zero and the notice sticks.\n   * (The axios adapter stashes it on the request config for that reason.)\n   * `request` reaches the filter as its third argument; default `{ method, url }`.\n   */\n  start(method?: string, url?: string, request?: ServerWakeRequest): boolean;\n  /** A counted request settled — either way: an error still proves the server\n   *  answered or gave up. When the last one does, the notice goes away. Never takes\n   *  the counter below zero. */\n  end(): void;\n  /** `start` + `end` around a promise (or a function returning one), for a request\n   *  that does not go through an adapter. Resolves and rejects as the work does. */\n  track<T>(work: PromiseLike<T> | (() => PromiseLike<T>), request?: ServerWakeRequest): Promise<T>;\n  /** Back to a pristine watchdog — for tests, which share an instance across cases. */\n  reset(): void;\n  /** `useSyncExternalStore`'s pair. Listeners hear stage changes only. */\n  subscribe(listener: () => void): () => void;\n  getStage(): ServerWakeStage;\n  /** Counted requests currently outstanding. */\n  getInFlight(): number;\n}\n\n/** Response types that make a request a download — see the module comment. */\nconst DOWNLOAD_RESPONSE_TYPES = new Set([\"blob\", \"arraybuffer\", \"stream\"]);\n\n/**\n * The usual filter: every GET, plus any other request whose URL matches `writes` —\n * keksdose's `/\\/auth\\/(login|register|demo-session)\\b/` — but never a download\n * (`responseType` `\"blob\"`, `\"arraybuffer\"` or `\"stream\"`). Keep upload routes out of\n * the pattern (see the module comment).\n */\nexport function watchReadsAnd(writes?: RegExp): ServerWakeFilter {\n  return (method, url, request) =>\n    !DOWNLOAD_RESPONSE_TYPES.has(request?.responseType ?? \"\") &&\n    (method === \"get\" || (writes !== undefined && writes.test(url)));\n}\n\nfunction isOffline(): boolean {\n  return typeof navigator !== \"undefined\" && navigator.onLine === false;\n}\n\nexport function createServerWake({\n  slowMs = 2000,\n  wakingMs = 7000,\n  shouldWatch = watchReadsAnd(),\n}: ServerWakeOptions = {}): ServerWakeWatcher {\n  let inFlight = 0;\n  let stage: ServerWakeStage = \"idle\";\n  let slowTimer: ReturnType<typeof setTimeout> | null = null;\n  let wakingTimer: ReturnType<typeof setTimeout> | null = null;\n  const listeners = new Set<() => void>();\n\n  const setStage = (next: ServerWakeStage) => {\n    if (next === stage) return;\n    stage = next;\n    for (const listener of listeners) listener();\n  };\n\n  const clearTimers = () => {\n    if (slowTimer !== null) clearTimeout(slowTimer);\n    if (wakingTimer !== null) clearTimeout(wakingTimer);\n    slowTimer = null;\n    wakingTimer = null;\n  };\n\n  const start = (method?: string, url?: string, request: ServerWakeRequest = { method, url }): boolean => {\n    if (isOffline()) return false;\n    if (!shouldWatch((method ?? \"get\").toLowerCase(), url ?? \"\", request)) return false;\n    inFlight += 1;\n    // The clock runs from the FIRST outstanding request: a page firing a second read\n    // at 1.9 s is still waiting on the same sleeping server, not starting afresh.\n    if (inFlight === 1) {\n      clearTimers();\n      slowTimer = setTimeout(() => setStage(\"slow\"), slowMs);\n      wakingTimer = setTimeout(() => setStage(\"waking\"), wakingMs);\n    }\n    return true;\n  };\n\n  const end = () => {\n    inFlight = Math.max(0, inFlight - 1);\n    if (inFlight > 0) return;\n    clearTimers();\n    setStage(\"idle\");\n  };\n\n  return {\n    start,\n    end,\n    track<T>(work: PromiseLike<T> | (() => PromiseLike<T>), request: ServerWakeRequest = {}) {\n      const counted = start(request.method, request.url, request);\n      let promise: Promise<T>;\n      try {\n        promise = Promise.resolve(typeof work === \"function\" ? work() : work);\n      } catch (error) {\n        // A thunk that throws before it returns a promise settled too.\n        promise = Promise.reject(error);\n      }\n      return counted ? promise.finally(end) : promise;\n    },\n    reset() {\n      inFlight = 0;\n      clearTimers();\n      setStage(\"idle\");\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    getStage: () => stage,\n    getInFlight: () => inFlight,\n  };\n}\n\n/**\n * The shared instance: what `<ServerWakeNotice />`, `useServerWakeStage()`,\n * {@link attachServerWake} and {@link wrapFetch} use when no watcher is passed. GETs\n * only, default timings — an app that also watches its login POST creates its own\n * with {@link createServerWake} and passes it to both ends.\n */\nexport const serverWake: ServerWakeWatcher = createServerWake();\n\n// ── axios ─────────────────────────────────────────────────────────────────────\n\n/** The config fields the watchdog reads — what axios's request config has. The whole\n *  config reaches the filter, so an app's filter can read the rest of it. */\nexport interface ServerWakeAxiosConfig {\n  method?: string;\n  url?: string;\n  responseType?: string;\n}\n\n/** The slice of an interceptor manager the adapter uses. A method (not a function\n *  property) so axios's wider `use(onFulfilled?, onRejected?, options?)` fits it. */\ninterface InterceptorManagerLike<V> {\n  use(onFulfilled: (value: V) => V | Promise<V>, onRejected: (error: unknown) => unknown): number;\n  eject(id: number): void;\n}\n\n/** An axios instance, structurally — so the kit types the adapter without importing\n *  axios. `axios.create()`'s result fits it as is. */\nexport interface AxiosLikeInstance<C extends ServerWakeAxiosConfig, R extends { config: C }> {\n  interceptors: {\n    request: InterceptorManagerLike<C>;\n    response: InterceptorManagerLike<R>;\n  };\n}\n\n/** Whether the watchdog counted this request — the response side owes a matching\n *  `end()` only then. On the config, as keksdose's `_wake` was: it travels with the\n *  request onto the response and onto an error. Cleared once settled, so a 401 replay\n *  of the same config re-enters the request interceptor and is counted afresh — the\n *  pairing stays balanced. */\nconst COUNTED = \"_serverWake\";\ntype Marked = { [COUNTED]?: boolean };\n\n/**\n * Drive a watcher from an axios instance's interceptors: `attachServerWake(api)`.\n * Returns a function that ejects both interceptors again.\n *\n * Attach it BEFORE the app's own response interceptors: axios runs those in the order\n * they were added, so the wake one ends the wait before a 401 handler awaits a token\n * refresh — otherwise the notice would keep counting a request that has already been\n * answered. (Request-side order does not matter.)\n */\nexport function attachServerWake<C extends ServerWakeAxiosConfig, R extends { config: C }>(\n  instance: AxiosLikeInstance<C, R>,\n  watcher: ServerWakeWatcher = serverWake,\n): () => void {\n  const settle = (config: unknown) => {\n    const marked = config as Marked | undefined;\n    if (marked?.[COUNTED]) {\n      marked[COUNTED] = false;\n      watcher.end();\n    }\n  };\n  const request = instance.interceptors.request.use(\n    (config) => {\n      (config as C & Marked)[COUNTED] = watcher.start(config.method, config.url, config);\n      return config;\n    },\n    (error) => Promise.reject(error),\n  );\n  const response = instance.interceptors.response.use(\n    (res) => {\n      settle(res.config);\n      return res;\n    },\n    (error) => {\n      settle((error as { config?: unknown } | null)?.config);\n      return Promise.reject(error);\n    },\n  );\n  return () => {\n    instance.interceptors.request.eject(request);\n    instance.interceptors.response.eject(response);\n  };\n}\n\n// ── fetch ─────────────────────────────────────────────────────────────────────\n\n/**\n * A `fetch` that drives a watcher: `const apiFetch = wrapFetch(fetch)`. The wait ends\n * when the response's HEADERS arrive (or the call fails) — the server is awake by then,\n * however long the body takes.\n */\nexport function wrapFetch(\n  fetchImpl: typeof fetch = globalThis.fetch,\n  watcher: ServerWakeWatcher = serverWake,\n): typeof fetch {\n  return (input, init) => {\n    const request = typeof Request !== \"undefined\" && input instanceof Request ? input : undefined;\n    const method = init?.method ?? request?.method;\n    const url = typeof input === \"string\" ? input : input instanceof URL ? input.href : (request?.url ?? \"\");\n    return watcher.track(() => fetchImpl(input, init), { method, url });\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/lib/server-wake.ts"],"sourcesContent":["/**\n * \"Is the server asleep, or is the app broken?\" — the cold-start watchdog, lifted\n * from keksdose (feedback #199) so kastlan and Kurvenschmiede get it too.\n *\n * All three backends run on Cloud Run with `--min-instances=0`: after an idle\n * period the container is gone and the first request has to start it, which takes\n * several seconds and occasionally more. Nothing in the UI said so, and none of the\n * axios instances has a timeout, so the honest experience was a spinner that looked\n * stuck. This counts the in-flight requests a cold start would actually delay and\n * escalates in two steps, so a merely slow response says \"still loading\" and only a\n * genuinely long wait blames the sleeping server.\n *\n * Framework-free on purpose (no zustand, no axios, no React): a counter, two timers\n * and a listener set, read by `useServerWakeStage` through `useSyncExternalStore`.\n * The adapters below take the app's axios instance / fetch as an ARGUMENT, so the\n * kit never imports either.\n *\n * WHAT ARMS IT, and why the default is narrow:\n *   - reads (GET) — what every page does on open — always;\n *   - writes only when the app says so (`watchReadsAnd(/\\/auth\\/login\\b/)`): the\n *     auth POSTs that gate the app are the only writes a user waits on before the\n *     app exists at all, so a cold start there looks exactly like a broken login.\n * An UPLOAD must never be watched — a statement PDF or a photo takes seconds on a\n * perfectly warm server, and \"the server is waking up\" during a 4 s upload would\n * simply be false. With the default that holds by itself (an upload is a POST);\n * an app widening `shouldWatch` keeps its upload routes out of it.\n *\n * Nor a DOWNLOAD, for the same reason (kastlan 0.18): axios answers only once the\n * whole body is in, so a generated PDF or a large photo — a GET — ran past both\n * thresholds on a warm server, and held the count for every read beside it. The\n * default filter skips a request whose `responseType` is `\"blob\"`, `\"arraybuffer\"` or\n * `\"stream\"`; a custom filter gets the request as its third argument to do the same.\n * (`wrapFetch` ends the wait at the headers, so a download through it is harmless.)\n *\n * It never arms while the browser is offline, whatever `shouldWatch` says: that state\n * has its own, truthful indicator, and a request that never left the device is not\n * evidence of anything about the server.\n */\n\n/** `slow` = longer than a warm server ever takes; `waking` = long enough that a cold\n *  start is the only sensible explanation. */\nexport type ServerWakeStage = \"idle\" | \"slow\" | \"waking\";\n\n/** Decides which requests count. `method` arrives lower-cased (`\"get\"` when the\n *  request named none — axios's and fetch's default); `url` as the client had it;\n *  `request` is what the adapter saw — for axios the request config itself, so\n *  `responseType` or the app's own fields can decide. */\nexport type ServerWakeFilter = (method: string, url: string, request: ServerWakeRequest) => boolean;\n\nexport interface ServerWakeOptions {\n  /** Past this, a warm round trip is out of the question (a cold database query on a\n   *  free tier can still take a second, so it is not tighter). Default 2000 ms. */\n  slowMs?: number;\n  /** Past this, the container was almost certainly scaled to zero. Default 7000 ms. */\n  wakingMs?: number;\n  /** Which requests count. Default {@link watchReadsAnd}`()` — GETs only, downloads\n   *  excluded. The offline guard runs before it and cannot be overridden. */\n  shouldWatch?: ServerWakeFilter;\n}\n\n/** What a request is, for {@link ServerWakeWatcher.track} and a {@link ServerWakeFilter}. */\nexport interface ServerWakeRequest {\n  method?: string;\n  url?: string;\n  /** axios's `responseType`. `\"blob\"`, `\"arraybuffer\"` and `\"stream\"` mark a download,\n   *  which the default filter does not count. */\n  responseType?: string;\n}\n\nexport interface ServerWakeWatcher {\n  /**\n   * Count a request that is going out, and arm the escalation if it is the first.\n   * Returns whether it was counted — the caller MUST call {@link end} exactly once\n   * for every `true`, or the counter never returns to zero and the notice sticks.\n   * (The axios adapter stashes it on the request config for that reason.)\n   * `request` reaches the filter as its third argument; default `{ method, url }`.\n   */\n  start(method?: string, url?: string, request?: ServerWakeRequest): boolean;\n  /** A counted request settled — either way: an error still proves the server\n   *  answered or gave up. The stage then follows the oldest request still out (0.51), so\n   *  the notice goes away when the last one does, or sooner when the rest are recent.\n   *  Never takes the counter below zero. */\n  end(): void;\n  /** `start` + `end` around a promise (or a function returning one), for a request\n   *  that does not go through an adapter. Resolves and rejects as the work does. */\n  track<T>(work: PromiseLike<T> | (() => PromiseLike<T>), request?: ServerWakeRequest): Promise<T>;\n  /** Back to a pristine watchdog — for tests, which share an instance across cases. */\n  reset(): void;\n  /** `useSyncExternalStore`'s pair. Listeners hear stage changes only. */\n  subscribe(listener: () => void): () => void;\n  getStage(): ServerWakeStage;\n  /** Counted requests currently outstanding. */\n  getInFlight(): number;\n}\n\n/** Response types that make a request a download — see the module comment. */\nconst DOWNLOAD_RESPONSE_TYPES = new Set([\"blob\", \"arraybuffer\", \"stream\"]);\n\n/**\n * The usual filter: every GET, plus any other request whose URL matches `writes` —\n * keksdose's `/\\/auth\\/(login|register|demo-session)\\b/` — but never a download\n * (`responseType` `\"blob\"`, `\"arraybuffer\"` or `\"stream\"`). Keep upload routes out of\n * the pattern (see the module comment).\n */\nexport function watchReadsAnd(writes?: RegExp): ServerWakeFilter {\n  return (method, url, request) =>\n    !DOWNLOAD_RESPONSE_TYPES.has(request?.responseType ?? \"\") &&\n    (method === \"get\" || (writes !== undefined && writes.test(url)));\n}\n\nfunction isOffline(): boolean {\n  return typeof navigator !== \"undefined\" && navigator.onLine === false;\n}\n\nexport function createServerWake({\n  slowMs = 2000,\n  wakingMs = 7000,\n  shouldWatch = watchReadsAnd(),\n}: ServerWakeOptions = {}): ServerWakeWatcher {\n  // When each counted request went out, oldest first; its length is the count.\n  //\n  // The stage is the age of the OLDEST outstanding request (0.51). It used to be the age of\n  // the first request since the count was last zero, so overlapping reads that were each\n  // fast — one going out before the last came back, on a busy page — chained past 2 s and\n  // showed \"taking longer than usual\" with nothing slow at all (keksdose live #454, found\n  // there while chasing a read that really was slow).\n  //\n  // `end()` names no request, so it retires the OLDEST start. When a newer request comes\n  // back first, the start left standing for the older one is later than its own, so the\n  // age read is never MORE than the oldest request's real age: a notice can come late,\n  // never falsely.\n  const starts: number[] = [];\n  let stage: ServerWakeStage = \"idle\";\n  let slowTimer: ReturnType<typeof setTimeout> | null = null;\n  let wakingTimer: ReturnType<typeof setTimeout> | null = null;\n  const listeners = new Set<() => void>();\n\n  const setStage = (next: ServerWakeStage) => {\n    if (next === stage) return;\n    stage = next;\n    for (const listener of listeners) listener();\n  };\n\n  const clearTimers = () => {\n    if (slowTimer !== null) clearTimeout(slowTimer);\n    if (wakingTimer !== null) clearTimeout(wakingTimer);\n    slowTimer = null;\n    wakingTimer = null;\n  };\n\n  // The stage for the oldest outstanding request's age, and timers for what is still to\n  // come. With none outstanding: idle.\n  const arm = () => {\n    clearTimers();\n    if (starts.length === 0) {\n      setStage(\"idle\");\n      return;\n    }\n    const age = Date.now() - starts[0];\n    setStage(age >= wakingMs ? \"waking\" : age >= slowMs ? \"slow\" : \"idle\");\n    if (age < slowMs) slowTimer = setTimeout(() => setStage(\"slow\"), slowMs - age);\n    if (age < wakingMs) wakingTimer = setTimeout(() => setStage(\"waking\"), wakingMs - age);\n  };\n\n  const start = (method?: string, url?: string, request: ServerWakeRequest = { method, url }): boolean => {\n    if (isOffline()) return false;\n    if (!shouldWatch((method ?? \"get\").toLowerCase(), url ?? \"\", request)) return false;\n    starts.push(Date.now());\n    // A request joining others does not move the clock: a page firing a second read at\n    // 1.9 s is still waiting on the same sleeping server, not starting afresh.\n    if (starts.length === 1) arm();\n    return true;\n  };\n\n  const end = () => {\n    if (starts.length === 0) return;\n    // The server answered (or gave up on) one of them, so the oldest's clock is over; the\n    // next oldest's age decides, which may well put the notice away again.\n    starts.shift();\n    arm();\n  };\n\n  return {\n    start,\n    end,\n    track<T>(work: PromiseLike<T> | (() => PromiseLike<T>), request: ServerWakeRequest = {}) {\n      const counted = start(request.method, request.url, request);\n      let promise: Promise<T>;\n      try {\n        promise = Promise.resolve(typeof work === \"function\" ? work() : work);\n      } catch (error) {\n        // A thunk that throws before it returns a promise settled too.\n        promise = Promise.reject(error);\n      }\n      return counted ? promise.finally(end) : promise;\n    },\n    reset() {\n      starts.length = 0;\n      clearTimers();\n      setStage(\"idle\");\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    getStage: () => stage,\n    getInFlight: () => starts.length,\n  };\n}\n\n/**\n * The shared instance: what `<ServerWakeNotice />`, `useServerWakeStage()`,\n * {@link attachServerWake} and {@link wrapFetch} use when no watcher is passed. GETs\n * only, default timings — an app that also watches its login POST creates its own\n * with {@link createServerWake} and passes it to both ends.\n */\nexport const serverWake: ServerWakeWatcher = createServerWake();\n\n// ── axios ─────────────────────────────────────────────────────────────────────\n\n/** The config fields the watchdog reads — what axios's request config has. The whole\n *  config reaches the filter, so an app's filter can read the rest of it. */\nexport interface ServerWakeAxiosConfig {\n  method?: string;\n  url?: string;\n  responseType?: string;\n}\n\n/** The slice of an interceptor manager the adapter uses. A method (not a function\n *  property) so axios's wider `use(onFulfilled?, onRejected?, options?)` fits it. */\ninterface InterceptorManagerLike<V> {\n  use(onFulfilled: (value: V) => V | Promise<V>, onRejected: (error: unknown) => unknown): number;\n  eject(id: number): void;\n}\n\n/** An axios instance, structurally — so the kit types the adapter without importing\n *  axios. `axios.create()`'s result fits it as is. */\nexport interface AxiosLikeInstance<C extends ServerWakeAxiosConfig, R extends { config: C }> {\n  interceptors: {\n    request: InterceptorManagerLike<C>;\n    response: InterceptorManagerLike<R>;\n  };\n}\n\n/** Whether the watchdog counted this request — the response side owes a matching\n *  `end()` only then. On the config, as keksdose's `_wake` was: it travels with the\n *  request onto the response and onto an error. Cleared once settled, so a 401 replay\n *  of the same config re-enters the request interceptor and is counted afresh — the\n *  pairing stays balanced. */\nconst COUNTED = \"_serverWake\";\ntype Marked = { [COUNTED]?: boolean };\n\n/**\n * Drive a watcher from an axios instance's interceptors: `attachServerWake(api)`.\n * Returns a function that ejects both interceptors again.\n *\n * Attach it BEFORE the app's own response interceptors: axios runs those in the order\n * they were added, so the wake one ends the wait before a 401 handler awaits a token\n * refresh — otherwise the notice would keep counting a request that has already been\n * answered. (Request-side order does not matter.)\n */\nexport function attachServerWake<C extends ServerWakeAxiosConfig, R extends { config: C }>(\n  instance: AxiosLikeInstance<C, R>,\n  watcher: ServerWakeWatcher = serverWake,\n): () => void {\n  const settle = (config: unknown) => {\n    const marked = config as Marked | undefined;\n    if (marked?.[COUNTED]) {\n      marked[COUNTED] = false;\n      watcher.end();\n    }\n  };\n  const request = instance.interceptors.request.use(\n    (config) => {\n      (config as C & Marked)[COUNTED] = watcher.start(config.method, config.url, config);\n      return config;\n    },\n    (error) => Promise.reject(error),\n  );\n  const response = instance.interceptors.response.use(\n    (res) => {\n      settle(res.config);\n      return res;\n    },\n    (error) => {\n      settle((error as { config?: unknown } | null)?.config);\n      return Promise.reject(error);\n    },\n  );\n  return () => {\n    instance.interceptors.request.eject(request);\n    instance.interceptors.response.eject(response);\n  };\n}\n\n// ── fetch ─────────────────────────────────────────────────────────────────────\n\n/**\n * A `fetch` that drives a watcher: `const apiFetch = wrapFetch(fetch)`. The wait ends\n * when the response's HEADERS arrive (or the call fails) — the server is awake by then,\n * however long the body takes.\n */\nexport function wrapFetch(\n  fetchImpl: typeof fetch = globalThis.fetch,\n  watcher: ServerWakeWatcher = serverWake,\n): typeof fetch {\n  return (input, init) => {\n    const request = typeof Request !== \"undefined\" && input instanceof Request ? input : undefined;\n    const method = init?.method ?? request?.method;\n    const url = typeof input === \"string\" ? input : input instanceof URL ? input.href : (request?.url ?? \"\");\n    return watcher.track(() => fetchImpl(input, init), { method, url });\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/shell/app-shell.d.ts

@@ -134,12 +134,6 @@ export { DEFAULT_APP_SHELL_MORE_LABELS };
  * of Normal-sized room.
  */
 export declare const DEFAULT_MOBILE_MAX_ITEMS: Readonly<Record<TextSize, number>>;
-/**
- * @deprecated 0.49 — use {@link DEFAULT_MOBILE_MAX_ITEMS} and `AppShell`'s
- * `mobileMaxItems`: the bar is sized in cells, "More" included; removed in 0.51. This is
- * the same default counted as entries before "More" (one fewer).
- */
-export declare const DEFAULT_MOBILE_BAR_MAX: Readonly<Record<TextSize, number>>;
 /**
  * The phone bar's cells (0.49 KIT-6): every entry when there are at most `maxItems`,
  * else `maxItems − 1` entries and a "More" cell for the rest. Which entries stay is
@@ -222,7 +216,7 @@ export interface AppShellProps extends ComponentPropsWithoutRef<"div"> {
      *
      * Unset (0.32.2, kastlan's 0.32.1 report): `"wrap"` at Normal and `"scroll"` at Large
      * and Extra large, where a wrapped group of eight pages took six or seven rows and
-     * covered the page — the other half of what `mobileBarMax` does for the bar.
+     * covered the page — the other half of what `mobileMaxItems` does for the bar.
      */
     mobileSubNavLayout?: "wrap" | "scroll";
     /**
@@ -238,13 +232,6 @@ export interface AppShellProps extends ComponentPropsWithoutRef<"div"> {
      * `{ xlarge: 5 }` replaces it at one size only. Never fewer than one entry beside More.
      */
     mobileMaxItems?: number | Partial<Record<TextSize, number>>;
-    /**
-     * @deprecated 0.49 — use `mobileMaxItems`, which counts the bar's cells, "More"
-     * included: `mobileBarMax={4}` is `mobileMaxItems={5}`; removed in 0.51. Read as that
-     * (one more, per size), with a development warning; ignored when `mobileMaxItems` is
-     * given.
-     */
-    mobileBarMax?: number | Partial<Record<TextSize, number>>;
     /** The More cell's words over the provider's `appShellMore`. */
     moreLabels?: Partial<AppShellMoreLabels>;
     /**
@@ -270,4 +257,4 @@ export interface AppShellProps extends ComponentPropsWithoutRef<"div"> {
  * `NavLink`; domain-free — nav items, brand, footer and the top bar's actions
  * are all supplied by the app.
  */
-export declare function AppShell({ nav, topBar, children, footer, sidebarFooter, sidebarFooterItems, renderLink, collapseStorageKey: collapseStorageKeyProp, collapseLabel, expandLabel, subNav, mobileSubNav, mobileSubNavLayout: mobileSubNavLayoutProp, mobileMaxItems, mobileBarMax, moreLabels, toggleGroupLabel, embedded: embeddedProp, className, ref, ...rest }: AppShellProps): import("react").JSX.Element;
+export declare function AppShell({ nav, topBar, children, footer, sidebarFooter, sidebarFooterItems, renderLink, collapseStorageKey: collapseStorageKeyProp, collapseLabel, expandLabel, subNav, mobileSubNav, mobileSubNavLayout: mobileSubNavLayoutProp, mobileMaxItems, moreLabels, toggleGroupLabel, embedded: embeddedProp, className, ref, ...rest }: AppShellProps): import("react").JSX.Element;

package/dist/shell/app-shell.js

@@ -26,11 +26,6 @@ const DEFAULT_MOBILE_MAX_ITEMS = {
   large: 5,
   xlarge: 4
 };
-const DEFAULT_MOBILE_BAR_MAX = {
-  normal: DEFAULT_MOBILE_MAX_ITEMS.normal - 1,
-  large: DEFAULT_MOBILE_MAX_ITEMS.large - 1,
-  xlarge: DEFAULT_MOBILE_MAX_ITEMS.xlarge - 1
-};
 function pickMobileBar(entries, maxItems, priority) {
   const cells = Math.max(1, Math.floor(maxItems));
   if (entries.length <= cells) return { shown: [...entries], hidden: [] };
@@ -49,15 +44,9 @@ function splitMobileBar(entries, max) {
   if (entries.length <= limit + 1) return { shown: [...entries], hidden: [] };
   return { shown: entries.slice(0, limit), hidden: entries.slice(limit) };
 }
-function mobileCells(maxItems, barMax, size) {
-  if (maxItems !== void 0) {
-    return typeof maxItems === "number" ? maxItems : maxItems[size] ?? DEFAULT_MOBILE_MAX_ITEMS[size];
-  }
-  if (barMax !== void 0) {
-    const entries = typeof barMax === "number" ? barMax : barMax[size];
-    if (entries !== void 0) return entries + 1;
-  }
-  return DEFAULT_MOBILE_MAX_ITEMS[size];
+function mobileCells(maxItems, size) {
+  if (maxItems === void 0) return DEFAULT_MOBILE_MAX_ITEMS[size];
+  return typeof maxItems === "number" ? maxItems : maxItems[size] ?? DEFAULT_MOBILE_MAX_ITEMS[size];
 }
 function devWarnings() {
   return Boolean(import.meta.env?.DEV) && !import.meta.env?.VITEST;
@@ -77,15 +66,9 @@ function shortLabelNamesLabel(short, label) {
   return s === "" || l === "" || l.startsWith(s) || s.startsWith(l);
 }
 const TEXT_SIZE_WORDS = { normal: "Normal", large: "Large", xlarge: "Extra large" };
-function useNavDevWarnings(nav, deprecatedBarMax) {
+function useNavDevWarnings(nav) {
   useEffect(() => {
     if (!devWarnings()) return;
-    if (deprecatedBarMax) {
-      warnNavOnce(
-        "mobileBarMax",
-        `[ui-kit] AppShell mobileBarMax is deprecated: use mobileMaxItems, which counts the bar's cells with "More" (mobileBarMax={4} is mobileMaxItems={5}). Removed in 0.51.`
-      );
-    }
     for (const item of nav) {
       if (item.shortLabel === void 0 || item.shortLabelIsAlias) continue;
       if (shortLabelNamesLabel(item.shortLabel, item.label)) continue;
@@ -96,7 +79,7 @@ function useNavDevWarnings(nav, deprecatedBarMax) {
         `[ui-kit] AppShell nav "${item.to}": shortLabel "${item.shortLabel}" does not start with "${item.label.trim().split(/\s+/)[0]}", the first word of its label "${item.label}". The phone bar shows it ${where}, so the page has another name there than in the sidebar and its title. Shorten the label instead, or pass shortLabelIsAlias: true if the other word is meant.`
       );
     }
-  }, [nav, deprecatedBarMax]);
+  }, [nav]);
 }
 const AppShellNesting = createContext(false);
 function useNavHeightVar(ref, shellRef, embedded) {
@@ -136,7 +119,6 @@ function AppShell({
   mobileSubNav = true,
   mobileSubNavLayout: mobileSubNavLayoutProp,
   mobileMaxItems,
-  mobileBarMax,
   moreLabels,
   toggleGroupLabel,
   embedded: embeddedProp,
@@ -148,13 +130,13 @@ function AppShell({
   const { size: textSize } = useTextSize();
   const large = textSize !== "normal";
   const mobileSubNavLayout = mobileSubNavLayoutProp ?? (large ? "scroll" : "wrap");
-  const maxItems = mobileCells(mobileMaxItems, mobileBarMax, textSize);
+  const maxItems = mobileCells(mobileMaxItems, textSize);
   const { shown: barNav, hidden: moreNav } = pickMobileBar(
     nav.filter((item) => !item.mobileHidden),
     maxItems,
     (item) => item.mobilePriority
   );
-  useNavDevWarnings(nav, mobileBarMax !== void 0 && mobileMaxItems === void 0);
+  useNavDevWarnings(nav);
   const collapseStorageKey = collapseStorageKeyProp ?? (embedded ? null : "appLayout.sidebarCollapsed");
   const labels = useKitLabels("appShell", DEFAULT_APP_SHELL_LABELS, {
     collapse: collapseLabel,
@@ -838,7 +820,6 @@ function SidebarFlyout({ item, children }) {
 export {
   AppShell,
   DEFAULT_APP_SHELL_MORE_LABELS,
-  DEFAULT_MOBILE_BAR_MAX,
   DEFAULT_MOBILE_MAX_ITEMS,
   pickMobileBar,
   splitMobileBar