@carlonicora/nextjs-jsonapi 6.20.5 → 6.21.0

package/dist/utils/schemas/user.object.schema.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const userObjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    avatar: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UserObject = z.infer<typeof userObjectSchema>;
+//# sourceMappingURL=user.object.schema.d.ts.map

package/dist/utils/schemas/user.object.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.object.schema.d.ts","sourceRoot":"","sources":["../../../src/utils/schemas/user.object.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/utils/table-options.d.ts

@@ -0,0 +1,39 @@
+import { Action, ModuleWithPermissions } from "../permissions";
+import { ReactElement } from "react";
+export declare class TableOptions {
+    private _components;
+    private _hasPermissionToModule;
+    constructor(hasPermissionToModule: <M extends ModuleWithPermissions>(params: {
+        module: M;
+        action: Action;
+        data?: any;
+    }) => boolean);
+    addOption<M extends ModuleWithPermissions>(component: ReactElement<any> | null, module?: M, action?: Action): void;
+    getComponents(): ReactElement<any>[];
+    getOptions(): ReactElement<any> | null;
+}
+export declare function getTableOptions(params: {
+    hasPermissionToModule: <M extends ModuleWithPermissions>(params: {
+        module: M;
+        action: Action;
+        data?: any;
+    }) => boolean;
+    options: {
+        component: ReactElement<any> | null;
+        module?: ModuleWithPermissions;
+        action?: Action;
+    }[];
+}): ReactElement<any> | null;
+export declare function getTableComponents(params: {
+    hasPermissionToModule: <M extends ModuleWithPermissions>(params: {
+        module: M;
+        action: Action;
+        data?: any;
+    }) => boolean;
+    options: {
+        component: ReactElement<any> | null;
+        module?: ModuleWithPermissions;
+        action?: Action;
+    }[];
+}): ReactElement<any>[];
+//# sourceMappingURL=table-options.d.ts.map

package/dist/utils/table-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-options.d.ts","sourceRoot":"","sources":["../../src/utils/table-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAyC,YAAY,EAAE,MAAM,OAAO,CAAC;AAE5E,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,sBAAsB,CAIhB;gBAGZ,qBAAqB,EAAE,CAAC,CAAC,SAAS,qBAAqB,EAAE,MAAM,EAAE;QAC/D,MAAM,EAAE,CAAC,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,KAAK,OAAO;IAMf,SAAS,CAAC,CAAC,SAAS,qBAAqB,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKlH,aAAa,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE;IAIpC,UAAU,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI;CASvC;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,qBAAqB,EAAE,CAAC,CAAC,SAAS,qBAAqB,EAAE,MAAM,EAAE;QAC/D,MAAM,EAAE,CAAC,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,KAAK,OAAO,CAAC;IACd,OAAO,EAAE;QAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrG,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAI3B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,qBAAqB,EAAE,CAAC,CAAC,SAAS,qBAAqB,EAAE,MAAM,EAAE;QAC/D,MAAM,EAAE,CAAC,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,KAAK,OAAO,CAAC;IACd,OAAO,EAAE;QAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrG,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAItB"}

package/dist/utils/toast.d.ts

@@ -0,0 +1,24 @@
+import { type ExternalToast } from "sonner";
+import type { ReactElement, JSXElementConstructor, ReactNode } from "react";
+export type ToastOptions = {
+    description?: ReactNode;
+    duration?: number;
+    id?: string;
+    onDismiss?: () => void;
+    action?: ExternalToast["action"];
+    dismissible?: boolean;
+};
+/** Standard toast - neutral/white */
+export declare function showToast(message: string, options?: ToastOptions): string | number;
+/** Error toast - destructive red */
+export declare function showError(message: string, options?: ToastOptions): string | number;
+/** Dismiss toast(s) */
+export declare function dismissToast(toastId?: string | number): string | number;
+/** Custom toast - ONLY for complex UI like upload progress */
+export declare function showCustomToast(render: (id: string | number) => ReactElement<unknown, string | JSXElementConstructor<unknown>>, options?: {
+    id?: string | number;
+    duration?: number;
+    dismissible?: boolean;
+    onDismiss?: () => void;
+}): string | number;
+//# sourceMappingURL=toast.d.ts.map

package/dist/utils/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../src/utils/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,mBAEhE;AAED,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,mBAEhE;AAED,uBAAuB;AACvB,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,mBAErD;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC,EAC/F,OAAO,CAAC,EAAE;IACR,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,mBAGF"}

package/dist/utils/use-mobile.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+export declare const MOBILE_BREAKPOINT = 768;
+export declare const VIEWPORT_COOKIE_NAME = "viewport_mobile";
+/**
+ * A boolean once measured or seeded synchronously; a promise while a
+ * session-seeded provider waits for the request's snapshot.
+ */
+export type ViewportContextValue = boolean | Promise<boolean> | undefined;
+/** Returns the process-wide viewport context, creating it on first use. */
+export declare function getViewportContext(): React.Context<ViewportContextValue>;
+/** @internal — consumed by contexts/ViewportContext.tsx */
+export declare function measureViewport(): boolean;
+/** @internal — consumed by contexts/ViewportContext.tsx */
+export declare function persistViewport(isMobile: boolean): void;
+/** @internal — consumed by contexts/ViewportContext.tsx */
+export declare function subscribeViewport(onChange: () => void): () => void;
+export declare function useIsMobile(): boolean;
+//# sourceMappingURL=use-mobile.d.ts.map

package/dist/utils/use-mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mobile.d.ts","sourceRoot":"","sources":["../../src/utils/use-mobile.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAmCtD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;AAE1E,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAKxE;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAEvD;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKlE;AAwBD,wBAAgB,WAAW,IAAI,OAAO,CAqBrC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "6.20.5",
+  "version": "6.21.0",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -55,7 +55,7 @@
     },
     "./contexts/styles.css": "./dist/contexts/index.css",
     "./blocknote/server": {
-      "types": "./dist/components/editors/server.d.ts",
+      "types": "./dist/components/editors/server-entry.d.ts",
       "import": "./dist/components/editors/server.mjs",
       "require": "./dist/components/editors/server.js"
     },
@@ -80,7 +80,7 @@
       "require": "./dist/features/help/index.js"
     },
     "./help/server": {
-      "types": "./dist/features/help/server.d.ts",
+      "types": "./dist/features/help/server-entry.d.ts",
       "import": "./dist/features/help/server.mjs",
       "require": "./dist/features/help/server.js"
     },
@@ -90,7 +90,7 @@
       "require": "./dist/features/blog/index.js"
     },
     "./blog/server": {
-      "types": "./dist/features/blog/server.d.ts",
+      "types": "./dist/features/blog/server-entry.d.ts",
       "import": "./dist/features/blog/server.mjs",
       "require": "./dist/features/blog/server.js"
     },
@@ -105,7 +105,7 @@
       "require": "./dist/features/analytics/index.js"
     },
     "./analytics/server": {
-      "types": "./dist/features/analytics/server.d.ts",
+      "types": "./dist/features/analytics/server-entry.d.ts",
       "import": "./dist/features/analytics/server.mjs",
       "require": "./dist/features/analytics/server.js"
     },
@@ -118,7 +118,7 @@
     "./messages/*": "./messages/*"
   },
   "scripts": {
-    "build": "rm -rf dist && NODE_OPTIONS='--max-old-space-size=8192' tsup && tsc -p scripts/generate-web-module/tsconfig.json",
+    "build": "rm -rf dist && tsup && node scripts/build-types.mjs && tsc -p scripts/generate-web-module/tsconfig.json",
     "dev": "node scripts/dev-watch.mjs",
     "clean": "rm -rf dist",
     "lint": "eslint \"src/**/*.ts\" \"src/**/*.tsx\" --fix && node scripts/check-rtl-classes.mjs && node scripts/validate-messages.mjs",

package/scripts/build-types.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// Release build's type declarations: one tsc pass, then the `@/…` alias rewrite.
+// See scripts/declarations.mjs.
+import { spawnSync } from "node:child_process";
+import { bin, rewriteAliases, root, writeDeclarationsTsconfig } from "./declarations.mjs";
+
+const tsconfig = await writeDeclarationsTsconfig();
+const result = spawnSync(bin("tsc"), ["-p", tsconfig, "--emitDeclarationOnly"], { cwd: root, stdio: "inherit" });
+if (result.status !== 0) process.exit(result.status ?? 1);
+
+const rewritten = await rewriteAliases();
+console.log(`[build-types] declarations emitted; rewrote path aliases in ${rewritten} file(s)`);

package/scripts/declarations.mjs

@@ -0,0 +1,97 @@
+// Type declarations, shared by the release build (scripts/build-types.mjs) and the
+// dev watcher (scripts/dev-watch.mjs).
+//
+// tsc emits one .d.ts per source file into dist/, next to the JavaScript tsup
+// builds. This replaced tsup's bundled `dts` pass, which needed an 8 GB heap
+// (and still ran out) where tsc needs about 1 GB.
+//
+// tsc keeps the `@/…` path aliases verbatim in the emitted declarations, and the
+// consuming app cannot resolve them (its own `@/` points at its own src), so after
+// every tsc pass the aliases are rewritten to relative paths.
+import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const dist = path.join(root, "dist");
+export const bin = (name) => path.join(root, "node_modules", ".bin", name);
+
+// Mirrors tsconfig.json `paths`, most specific first.
+const ALIASES = [
+  ["@/components/ui/", "shadcnui/ui/"],
+  ["@/lib/", "lib/"],
+  ["@/hooks/", "hooks/"],
+  ["@/", ""],
+];
+
+function resolveAlias(file, specifier) {
+  for (const [prefix, target] of ALIASES) {
+    if (!specifier.startsWith(prefix)) continue;
+    const absolute = path.join(dist, target + specifier.slice(prefix.length));
+    let relative = path.relative(path.dirname(file), absolute).split(path.sep).join("/");
+    if (!relative.startsWith(".")) relative = `./${relative}`;
+    return relative;
+  }
+  return specifier;
+}
+
+const seen = new Map();
+
+async function walk(dir, out) {
+  let entries;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    return out;
+  }
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) await walk(full, out);
+    else if (entry.name.endsWith(".d.ts")) out.push(full);
+  }
+  return out;
+}
+
+export async function rewriteAliases() {
+  const files = await walk(dist, []);
+  let rewritten = 0;
+  for (const file of files) {
+    const { mtimeMs } = await stat(file);
+    if (seen.get(file) === mtimeMs) continue;
+    const source = await readFile(file, "utf8");
+    const next = source.replace(/(["'])(@\/[^"']+)\1/g, (_, quote, spec) => `${quote}${resolveAlias(file, spec)}${quote}`);
+    if (next !== source) {
+      await writeFile(file, next);
+      rewritten++;
+    }
+    seen.set(file, (await stat(file)).mtimeMs);
+  }
+  return rewritten;
+}
+
+// tsc reads its own config, which extends the package's and always leaves the
+// tests out: some packages' tsconfig.json still includes them, so tsc would
+// report test-only type errors and emit declarations for them.
+export async function writeDeclarationsTsconfig() {
+  const file = path.join(root, "node_modules", ".cache", "declarations", "tsconfig.json");
+  await mkdir(path.dirname(file), { recursive: true });
+  await writeFile(
+    file,
+    JSON.stringify(
+      {
+        extends: "../../../tsconfig.json",
+        include: ["../../../src/**/*.ts", "../../../src/**/*.tsx"],
+        exclude: [
+          "../../../src/**/*.spec.ts",
+          "../../../src/**/*.spec.tsx",
+          "../../../src/**/*.test.ts",
+          "../../../src/**/*.test.tsx",
+          "../../../src/**/__tests__/**/*",
+        ],
+      },
+      null,
+      2,
+    ),
+  );
+  return file;
+}

package/scripts/dev-watch.mjs

@@ -1,78 +1,12 @@
 #!/usr/bin/env node
-// Dev watcher: code and types are rebuilt by two separate, light processes.
-//
-// `tsup --watch` with `dts` regenerates the BUNDLED declarations for every entry
-// on each save, which peaks near 7 GB and, on a machine already short of memory,
-// crashes the watcher (fsevents napi assertion) and takes the whole dev run down.
-// In dev we therefore run:
-//   1. tsup --watch with TSUP_NO_DTS=1 — JavaScript only, exactly as before;
-//   2. tsc --watch --emitDeclarationOnly — one .d.ts per source file, incremental.
-// tsc keeps the `@/…` path aliases verbatim in the emitted declarations, and the
-// consuming app cannot resolve them (its own `@/` points at its own src), so after
-// every tsc pass the aliases are rewritten to relative paths.
-//
-// The release build (`pnpm build`) is untouched: it still emits bundled types.
+// Dev watcher: code and types are rebuilt by two separate, light processes:
+//   1. tsup --watch — JavaScript only;
+//   2. tsc --watch --emitDeclarationOnly — one .d.ts per source file, incremental,
+//      followed after every pass by the `@/…` alias rewrite (scripts/declarations.mjs).
+// The release build emits the same declarations once (scripts/build-types.mjs).
 import { spawn } from "node:child_process";
-import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const dist = path.join(root, "dist");
-const bin = (name) => path.join(root, "node_modules", ".bin", name);
-
-// Mirrors tsconfig.json `paths`, most specific first.
-const ALIASES = [
-  ["@/components/ui/", "shadcnui/ui/"],
-  ["@/lib/", "lib/"],
-  ["@/hooks/", "hooks/"],
-  ["@/", ""],
-];
-
-function resolveAlias(file, specifier) {
-  for (const [prefix, target] of ALIASES) {
-    if (!specifier.startsWith(prefix)) continue;
-    const absolute = path.join(dist, target + specifier.slice(prefix.length));
-    let relative = path.relative(path.dirname(file), absolute).split(path.sep).join("/");
-    if (!relative.startsWith(".")) relative = `./${relative}`;
-    return relative;
-  }
-  return specifier;
-}
-
-const seen = new Map();
-
-async function walk(dir, out) {
-  let entries;
-  try {
-    entries = await readdir(dir, { withFileTypes: true });
-  } catch {
-    return out;
-  }
-  for (const entry of entries) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) await walk(full, out);
-    else if (entry.name.endsWith(".d.ts")) out.push(full);
-  }
-  return out;
-}
-
-async function rewriteAliases() {
-  const files = await walk(dist, []);
-  let rewritten = 0;
-  for (const file of files) {
-    const { mtimeMs } = await stat(file);
-    if (seen.get(file) === mtimeMs) continue;
-    const source = await readFile(file, "utf8");
-    const next = source.replace(/(["'])(@\/[^"']+)\1/g, (_, quote, spec) => `${quote}${resolveAlias(file, spec)}${quote}`);
-    if (next !== source) {
-      await writeFile(file, next);
-      rewritten++;
-    }
-    seen.set(file, (await stat(file)).mtimeMs);
-  }
-  if (rewritten > 0) console.log(`[dev-types] rewrote path aliases in ${rewritten} declaration file(s)`);
-}
+import { bin, rewriteAliases, root, writeDeclarationsTsconfig } from "./declarations.mjs";
 
 const children = [];
 
@@ -111,40 +45,22 @@ function shutdown(code) {
 process.on("SIGINT", () => shutdown(0));
 process.on("SIGTERM", () => shutdown(0));
 
-// tsc reads its own config, which extends the package's and always leaves the
-// tests out: some packages' tsconfig.json still includes them, and the bundled
-// dts build never saw them (it starts from the entry points), so tsc would flood
-// the dev output with test-only type errors and emit declarations for them.
-const devTsconfig = path.join(root, "node_modules", ".cache", "dev-watch", "tsconfig.json");
-await mkdir(path.dirname(devTsconfig), { recursive: true });
-await writeFile(
-  devTsconfig,
-  JSON.stringify(
-    {
-      extends: "../../../tsconfig.json",
-      include: ["../../../src/**/*.ts", "../../../src/**/*.tsx"],
-      exclude: [
-        "../../../src/**/*.spec.ts",
-        "../../../src/**/*.spec.tsx",
-        "../../../src/**/*.test.ts",
-        "../../../src/**/*.test.tsx",
-        "../../../src/**/__tests__/**/*",
-      ],
-    },
-    null,
-    2,
-  ),
-);
+const tsconfig = await writeDeclarationsTsconfig();
 
 let rewriting = Promise.resolve();
-run(bin("tsup"), ["--watch"], { TSUP_NO_DTS: "1" });
+run(bin("tsup"), ["--watch"]);
 run(
   bin("tsc"),
-  ["-p", devTsconfig, "--watch", "--emitDeclarationOnly", "--preserveWatchOutput"],
+  ["-p", tsconfig, "--watch", "--emitDeclarationOnly", "--preserveWatchOutput"],
   {},
   (line) => {
     if (line.includes("Watching for file changes")) {
-      rewriting = rewriting.then(rewriteAliases).catch((error) => console.error("[dev-types]", error));
+      rewriting = rewriting
+        .then(rewriteAliases)
+        .then((rewritten) => {
+          if (rewritten > 0) console.log(`[dev-types] rewrote path aliases in ${rewritten} declaration file(s)`);
+        })
+        .catch((error) => console.error("[dev-types]", error));
     }
   },
 );

package/src/components/containers/RoundPageContainer.tsx

@@ -244,9 +244,16 @@ export function RoundPageContainer({
   // demo bar, a credit warning). Unset, it is 0 and the height is unchanged; an
   // app that renders such a banner publishes its live height on <html>, or the
   // banner pushes the page past the viewport and the document scrolls it away.
+  // `--app-footer-h` is the same for a panel fixed to the bottom of the viewport
+  // (a drawer over the page): published while it is shown, it keeps the bottom
+  // of a full-height page above the panel instead of under it.
   const shellHeight = isFixed
-    ? `h-[calc(100svh-var(--app-header-h,3rem)-var(--app-banner-h,0px))]`
-    : `min-h-[calc(100svh-var(--app-header-h,3rem)-var(--app-banner-h,0px))]`;
+    ? `h-[calc(100svh-var(--app-header-h,3rem)-var(--app-banner-h,0px)-var(--app-footer-h,0px))]`
+    : `min-h-[calc(100svh-var(--app-header-h,3rem)-var(--app-banner-h,0px)-var(--app-footer-h,0px))]`;
+  // A page that grows with its content scrolls the document instead, so it gets the
+  // panel's height as bottom margin: its last lines can scroll above the panel. A
+  // full-height page already subtracts it from its height above, so it gets none.
+  const footerSpace = isFixed ? `` : `mb-[var(--app-footer-h,0px)]`;
   const clip = isFixed ? `overflow-hidden` : ``;
   const scrollY = isFixed ? `overflow-y-auto` : ``;
   // The bar is an in-flow sibling of the content (see MobileNavigationBar's own
@@ -364,6 +371,7 @@ export function RoundPageContainer({
           className={cn(
             "flex w-full flex-col",
             shellHeight,
+            footerSpace,
             // Deliberately NO bottom safe-area inset, here or in
             // MobileNavigationBar. iOS still reports 34px of bottom inset
             // (measured in an installed PWA), but nothing is drawn in that strip
@@ -409,6 +417,7 @@ export function RoundPageContainer({
         className={cn(
           `flex w-full flex-col`,
           shellHeight,
+          footerSpace,
           // Deliberately NO bottom safe-area inset, here or in
           // MobileNavigationBar. iOS still reports 34px of bottom inset
           // (measured in an installed PWA), but nothing is drawn in that strip

package/src/components/containers/__tests__/RoundPageContainer.padding.spec.tsx

@@ -61,4 +61,25 @@ describe("RoundPageContainer shell padding", () => {
     expect(shell.classList.contains("p-2")).toBe(true);
     expect(shell.classList.contains("ps-0")).toBe(false);
   });
+
+  it("keeps the page above a bottom panel: the height also subtracts --app-footer-h", async () => {
+    render(withShared(<RoundPageContainer testId="shell">content</RoundPageContainer>));
+    const shell = await screen.findByTestId("shell");
+    expect(shell.className).toContain("-var(--app-footer-h,0px))]");
+  });
+
+  it("a page that grows with its content gets the bottom panel's height as margin; a full-height one does not", async () => {
+    const { unmount } = render(
+      withShared(
+        <RoundPageContainer testId="doc" scroll="document">
+          content
+        </RoundPageContainer>,
+      ),
+    );
+    expect((await screen.findByTestId("doc")).classList.contains("mb-[var(--app-footer-h,0px)]")).toBe(true);
+    unmount();
+
+    render(withShared(<RoundPageContainer testId="fixed">content</RoundPageContainer>));
+    expect((await screen.findByTestId("fixed")).classList.contains("mb-[var(--app-footer-h,0px)]")).toBe(false);
+  });
 });

package/src/shadcnui/ui/__tests__/popover.container.spec.tsx

@@ -0,0 +1,22 @@
+import { render, screen } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+import { Popover, PopoverContent, PopoverTrigger } from "../popover";
+
+describe("PopoverContent container", () => {
+  it("portals the popup into the given container instead of <body>", async () => {
+    const container = document.createElement("div");
+    container.setAttribute("data-testid", "trap");
+    document.body.appendChild(container);
+
+    render(
+      <Popover defaultOpen>
+        <PopoverTrigger>open</PopoverTrigger>
+        <PopoverContent container={container}>inside</PopoverContent>
+      </Popover>,
+    );
+
+    const popup = await screen.findByText("inside");
+    expect(container.contains(popup)).toBe(true);
+    container.remove();
+  });
+});

package/src/shadcnui/ui/popover.tsx

@@ -20,15 +20,20 @@ function PopoverContent({
   side = "bottom",
   sideOffset = 4,
   anchor,
+  container,
   ...props
 }: PopoverPrimitive.Popup.Props &
-  Pick<PopoverPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset" | "anchor">) {
+  Pick<PopoverPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset" | "anchor"> &
+  // Where the popup is portalled (default: <body>). A popover opened from inside a
+  // focus-trapping surface (a modal dialog or drawer) passes that surface here, or
+  // the trap pulls focus back out of the popup and its inputs cannot be typed in.
+  Pick<PopoverPrimitive.Portal.Props, "container">) {
   // Pickers size themselves to their field (`w-(--anchor-width)`). In a narrow
   // field on a phone that leaves a ~100px list where every name wraps, so on a
   // phone they get a usable minimum width (capped to the screen).
   const matchesAnchorWidth = typeof className === "string" && className.includes("--anchor-width");
   return (
-    <PopoverPrimitive.Portal>
+    <PopoverPrimitive.Portal container={container}>
       <PopoverPrimitive.Positioner
         align={align}
         alignOffset={alignOffset}

package/dist/AbstractApiData-CKy8tbde.d.mts

@@ -1,53 +0,0 @@
-import { A as ApiDataInterface, J as JsonApiHydratedDataInterface } from './ApiDataInterface-BcZeXy5X.mjs';
-import { A as ApiRequestDataTypeInterface } from './ApiRequestDataTypeInterface-CYEcRUrh.mjs';
-
-declare abstract class AbstractApiData implements ApiDataInterface {
-    static identifierFields: string[];
-    get identifier(): string;
-    protected _jsonApi?: any;
-    protected _included?: any[];
-    protected _id?: string;
-    protected _type?: string;
-    protected _createdAt?: Date;
-    protected _updatedAt?: Date;
-    protected _self?: string;
-    get type(): string;
-    get id(): string;
-    get self(): string | undefined;
-    get createdAt(): Date;
-    get updatedAt(): Date;
-    get included(): any[];
-    get jsonApi(): any;
-    ingestJsonApi(_data: JsonApiHydratedDataInterface): void;
-    generateApiUrl(_params?: any): string;
-    createJsonApi(_data?: any): any;
-    protected _readIncluded<T extends ApiDataInterface>(data: JsonApiHydratedDataInterface, type: string, dataType: ApiRequestDataTypeInterface): T | T[] | undefined;
-    /**
-     * Read included relationships with polymorphic type resolution.
-     * Determines the correct model class based on the JSON:API type in included data.
-     */
-    protected _readIncludedPolymorphic<T extends ApiDataInterface>(data: JsonApiHydratedDataInterface, relationshipKey: string, candidateModules: ApiRequestDataTypeInterface[]): T | T[] | undefined;
-    /**
-     * Read included relationship data and augment with relationship meta properties.
-     * Handles both single relationships (one-to-one) and array relationships (one-to-many).
-     *
-     * For single relationships: meta is read from `relationships[type].meta`
-     * For array relationships: per-item meta is read from `relationships[type].data[].meta`
-     *
-     * @param data - Hydrated JSON:API data
-     * @param type - Relationship type key (e.g., "guide", "persons")
-     * @param dataType - Module reference for rehydration
-     * @returns Related object(s) augmented with meta properties, or undefined
-     */
-    protected _readIncludedWithMeta<T extends ApiDataInterface, M extends Record<string, any>>(data: JsonApiHydratedDataInterface, type: string, dataType: ApiRequestDataTypeInterface): (T & M) | (T & M)[] | undefined;
-    /**
-     * Copies relationship meta onto a rehydrated entity as own data properties. Object.assign throws
-     * when the model declares a getter-only accessor of the same name (an app's `Chunk` with
-     * `get relevance()`); an own property shadows that getter, so the model reads the meta value.
-     */
-    private static _mergeMeta;
-    dehydrate(): JsonApiHydratedDataInterface;
-    rehydrate(data: JsonApiHydratedDataInterface): this;
-}
-
-export { AbstractApiData as A };

package/dist/AbstractApiData-rgvs0cdY.d.ts

@@ -1,53 +0,0 @@
-import { A as ApiDataInterface, J as JsonApiHydratedDataInterface } from './ApiDataInterface-BcZeXy5X.js';
-import { A as ApiRequestDataTypeInterface } from './ApiRequestDataTypeInterface-CYEcRUrh.js';
-
-declare abstract class AbstractApiData implements ApiDataInterface {
-    static identifierFields: string[];
-    get identifier(): string;
-    protected _jsonApi?: any;
-    protected _included?: any[];
-    protected _id?: string;
-    protected _type?: string;
-    protected _createdAt?: Date;
-    protected _updatedAt?: Date;
-    protected _self?: string;
-    get type(): string;
-    get id(): string;
-    get self(): string | undefined;
-    get createdAt(): Date;
-    get updatedAt(): Date;
-    get included(): any[];
-    get jsonApi(): any;
-    ingestJsonApi(_data: JsonApiHydratedDataInterface): void;
-    generateApiUrl(_params?: any): string;
-    createJsonApi(_data?: any): any;
-    protected _readIncluded<T extends ApiDataInterface>(data: JsonApiHydratedDataInterface, type: string, dataType: ApiRequestDataTypeInterface): T | T[] | undefined;
-    /**
-     * Read included relationships with polymorphic type resolution.
-     * Determines the correct model class based on the JSON:API type in included data.
-     */
-    protected _readIncludedPolymorphic<T extends ApiDataInterface>(data: JsonApiHydratedDataInterface, relationshipKey: string, candidateModules: ApiRequestDataTypeInterface[]): T | T[] | undefined;
-    /**
-     * Read included relationship data and augment with relationship meta properties.
-     * Handles both single relationships (one-to-one) and array relationships (one-to-many).
-     *
-     * For single relationships: meta is read from `relationships[type].meta`
-     * For array relationships: per-item meta is read from `relationships[type].data[].meta`
-     *
-     * @param data - Hydrated JSON:API data
-     * @param type - Relationship type key (e.g., "guide", "persons")
-     * @param dataType - Module reference for rehydration
-     * @returns Related object(s) augmented with meta properties, or undefined
-     */
-    protected _readIncludedWithMeta<T extends ApiDataInterface, M extends Record<string, any>>(data: JsonApiHydratedDataInterface, type: string, dataType: ApiRequestDataTypeInterface): (T & M) | (T & M)[] | undefined;
-    /**
-     * Copies relationship meta onto a rehydrated entity as own data properties. Object.assign throws
-     * when the model declares a getter-only accessor of the same name (an app's `Chunk` with
-     * `get relevance()`); an own property shadows that getter, so the model reads the meta value.
-     */
-    private static _mergeMeta;
-    dehydrate(): JsonApiHydratedDataInterface;
-    rehydrate(data: JsonApiHydratedDataInterface): this;
-}
-
-export { AbstractApiData as A };