@stacksjs/ui 0.70.87 → 0.70.88

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/ui",
   "type": "module",
-  "version": "0.70.87",
+  "version": "0.70.88",
   "description": "The Stacks UI engine.",
   "author": "Chris Breuer",
   "contributors": [
@@ -62,8 +62,8 @@
   },
   "devDependencies": {
     "@stacksjs/build": "workspace:*",
-    "@stacksjs/config": "0.70.87",
+    "@stacksjs/config": "0.70.88",
     "better-dx": "^0.2.16",
-    "@stacksjs/router": "0.70.87"
+    "@stacksjs/router": "0.70.88"
   }
 }

package/dist/components/autocomplete.d.ts

@@ -1 +0,0 @@
-

package/dist/components/disclosure.d.ts

@@ -1,4 +0,0 @@
-// Disclosure primitives were part of the former Vue compatibility layer.
-// stx does not expose them, so keep this module intentionally empty instead
-// of publishing exports that fail at runtime.
-export {};

package/dist/components/disclosure.js

@@ -1 +0,0 @@
-export {};

package/dist/components/menu.d.ts

@@ -1,2 +0,0 @@
-// Menu primitives were part of the former Vue compatibility layer.
-export {};

package/dist/components/menu.js

@@ -1 +0,0 @@
-export {};

package/dist/components/modal.d.ts

@@ -1,6 +0,0 @@
-export {
-  Dialog,
-  DialogDescription,
-  DialogPanel,
-  DialogTitle,
-} from '@stacksjs/components';

package/dist/components/modal.js

@@ -1,6 +0,0 @@
-export {
-  Dialog,
-  DialogDescription,
-  DialogPanel,
-  DialogTitle
-} from "@stacksjs/components";

package/dist/components/popover.d.ts

@@ -1 +0,0 @@
-export { Popover, PopoverButton, PopoverPanel } from '@stacksjs/components';

package/dist/components/popover.js

@@ -1 +0,0 @@
-export { Popover, PopoverButton, PopoverPanel } from "@stacksjs/components";

package/dist/components/radio-group.d.ts

@@ -1,5 +0,0 @@
-export {
-  RadioGroup,
-  RadioGroupLabel,
-  RadioGroupOption,
-} from '@stacksjs/components';

package/dist/components/radio-group.js

@@ -1,5 +0,0 @@
-export {
-  RadioGroup,
-  RadioGroupLabel,
-  RadioGroupOption
-} from "@stacksjs/components";

package/dist/components/select.d.ts

@@ -1,6 +0,0 @@
-export {
-  Combobox,
-  ComboboxInput,
-  ComboboxOption,
-  ComboboxOptions,
-} from '@stacksjs/components';

package/dist/components/select.js

@@ -1,6 +0,0 @@
-export {
-  Combobox,
-  ComboboxInput,
-  ComboboxOption,
-  ComboboxOptions
-} from "@stacksjs/components";

package/dist/components/tabs.d.ts

@@ -1,2 +0,0 @@
-export type { Tab, TabPanelProps, TabsProps } from '@stacksjs/components';
-export { TabPanel, Tabs } from '@stacksjs/components';

package/dist/components/tabs.js

@@ -1 +0,0 @@
-export { TabPanel, Tabs } from "@stacksjs/components";

package/dist/components/toggle.d.ts

@@ -1 +0,0 @@
-export { Switch } from '@stacksjs/components';

package/dist/components/toggle.js

@@ -1 +0,0 @@
-export { Switch } from "@stacksjs/components";

package/dist/components/transition.d.ts

@@ -1,2 +0,0 @@
-export type { TransitionProps } from '@stacksjs/components';
-export { Transition } from '@stacksjs/components';

package/dist/components/transition.js

@@ -1 +0,0 @@
-export { Transition } from "@stacksjs/components";

package/dist/components.d.ts

@@ -1,10 +0,0 @@
-export * from './components/autocomplete';
-export * from './components/disclosure';
-export * from './components/menu';
-export * from './components/modal';
-export * from './components/popover';
-export * from './components/radio-group';
-export * from './components/select';
-export * from './components/tabs';
-export * from './components/toggle';
-export * from './components/transition';

package/dist/components.js

@@ -1,10 +0,0 @@
-export * from "./components/autocomplete";
-export * from "./components/disclosure";
-export * from "./components/menu";
-export * from "./components/modal";
-export * from "./components/popover";
-export * from "./components/radio-group";
-export * from "./components/select";
-export * from "./components/tabs";
-export * from "./components/toggle";
-export * from "./components/transition";

package/dist/fonts.d.ts

@@ -1,68 +0,0 @@
-/**
- * Render `<link rel="preload" as="font" crossorigin>` tags for every
- * font with `preload !== false`. Cross-origin attribute is always
- * emitted because most CDN-hosted fonts require it and same-origin
- * fonts ignore it harmlessly.
- *
- * Output is a single string with one tag per line, ready to drop into
- * a stx layout's `<head>` via `{{ renderFontPreloads(fonts) }}`.
- */
-export declare function renderFontPreloads(fonts?: FontEntry[]): string;
-/**
- * Render an `@font-face { ... }` block for every entry. `font-display:
- * swap` is the default; override per-entry with `display`.
- *
- * Wrap the result in `<style>` tags when inlining into a layout's
- * `<head>`, or write to a separate CSS file and `<link>` it.
- */
-export declare function renderFontFaceCss(fonts?: FontEntry[]): string;
-/**
- * Convenience helper: render BOTH the preload tags and the wrapped
- * `<style>...@font-face...</style>` block in one go, separated by a
- * newline. Drop this into the very top of your layout's `<head>` for
- * the maximal CLS win.
- *
- * @example
- * ```stx
- * <head>
- *   {{ renderFontHead(config.ui.fonts) }}
- *   <title>...</title>
- * </head>
- * ```
- */
-export declare function renderFontHead(fonts?: FontEntry[]): string;
-/**
- * Web-font preload + `@font-face` rendering helpers
- * (stacksjs/stacks#283 — prevent layout shifts).
- *
- * Layout shifts (the LS in CLS) happen when a page renders with the
- * fallback font, then re-flows once the web font loads. The two
- * mitigations this module ships against that:
- *
- *   1. **Preload** — emit `<link rel="preload" as="font" crossorigin>`
- *      for each font listed in the UI config, so the browser starts the
- *      font download in parallel with HTML parsing rather than waiting
- *      to discover the URL via CSS.
- *
- *   2. **`font-display: swap`** — the default `@font-face` block uses
- *      `font-display: swap`, which shows the fallback font immediately
- *      and swaps in the web font once available. Layout still shifts
- *      slightly at swap time, but the page is readable from t=0 instead
- *      of being blocked by the font fetch.
- *
- * Apps drop a list of fonts into `config/ui.ts` and call these helpers
- * from their layout's `<head>` — see {@link renderFontHead}. Both
- * outputs are safe to inline into HTML (no user-controlled values
- * interpolate; the FontEntry shape is config-only).
- */
-/** One configured web font. */
-export declare interface FontEntry {
-  family: string
-  src: string
-  format?: 'woff2' | 'woff' | 'truetype' | 'opentype'
-  weight?: number | string
-  style?: 'normal' | 'italic' | 'oblique'
-  display?: 'auto' | 'swap' | 'block' | 'fallback' | 'optional'
-  preload?: boolean
-  unicodeRange?: string
-}

package/dist/fonts.js

@@ -1,53 +0,0 @@
-const FORMAT_LABEL = {
-  woff2: "woff2",
-  woff: "woff",
-  truetype: "truetype",
-  opentype: "opentype"
-}, FORMAT_MIME = {
-  woff2: "font/woff2",
-  woff: "font/woff",
-  truetype: "font/ttf",
-  opentype: "font/otf"
-};
-export function renderFontPreloads(fonts = []) {
-  return fonts.filter((font) => font.preload !== !1).map((font) => {
-    const fmt = font.format ?? "woff2", type = FORMAT_MIME[fmt];
-    return `<link rel="preload" href="${escapeAttr(font.src)}" as="font" type="${type}" crossorigin>`;
-  }).join(`
-`);
-}
-export function renderFontFaceCss(fonts = []) {
-  return fonts.map((font) => {
-    const fmt = font.format ?? "woff2", fmtLabel = FORMAT_LABEL[fmt], weight = font.weight ?? "normal", style = font.style ?? "normal", display = font.display ?? "swap", ur = font.unicodeRange;
-    return `@font-face {
-  font-family: '${escapeFamily(font.family)}';
-  src: url('${escapeUrl(font.src)}') format('${fmtLabel}');
-  font-weight: ${weight};
-  font-style: ${style};
-  font-display: ${display};${ur ? `
-  unicode-range: ${ur};` : ""}
-}`;
-  }).join(`
-
-`);
-}
-export function renderFontHead(fonts = []) {
-  if (fonts.length === 0)
-    return "";
-  const preloads = renderFontPreloads(fonts), faces = renderFontFaceCss(fonts);
-  return `${preloads}
-<style>
-${faces}
-</style>`;
-}
-function escapeAttr(s) {
-  return String(s).replace(/[&<>"']/g, (c) => {
-    return { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c];
-  });
-}
-function escapeUrl(s) {
-  return String(s).replace(/['"`()<>{};\\\r\n\t*]/g, "");
-}
-function escapeFamily(s) {
-  return String(s).replace(/[^A-Z0-9 \-_.]/gi, "");
-}

package/dist/index.d.ts

@@ -1,22 +0,0 @@
-import { ui } from '@stacksjs/config';
-import * as CssEngine from '@cwcss/crosswind';
-export type { FontEntry } from './fonts';
-export type { PaginatorView } from './pagination';
-export { CssEngine, ui };
-// Web-font preload + @font-face helpers — used by stx layouts to
-// eliminate the FOUT/CLS that hits when a page renders with the
-// fallback font and then re-flows once the web font lands
-// (stacksjs/stacks#283).
-export {
-  renderFontFaceCss,
-  renderFontHead,
-  renderFontPreloads,
-} from './fonts';
-// Pagination view helpers — pure functions consumed by the
-// <Pagination> stx component (defaults/resources/components/Pagination.stx).
-// stacksjs/stacks#1909 P5.
-export {
-  buildPageSequence,
-  paginatorVariant,
-  urlForPage,
-} from './pagination';

package/dist/index.js

@@ -1,14 +0,0 @@
-import { ui } from "@stacksjs/config";
-import * as CssEngine from "@cwcss/crosswind";
-
-export { CssEngine, ui };
-export {
-  renderFontFaceCss,
-  renderFontHead,
-  renderFontPreloads
-} from "./fonts";
-export {
-  buildPageSequence,
-  paginatorVariant,
-  urlForPage
-} from "./pagination";

package/dist/pagination.d.ts

@@ -1,71 +0,0 @@
-/**
- * Build the page-number sequence for a full paginator, inserting an
- * ellipsis placeholder (`'…'`) for the gap between page 1 / the
- * current-page window / the last page.
- *
- * Examples (window=2):
- *
- *   current=5, last=12  → [1, '…', 3, 4, 5, 6, 7, '…', 12]
- *   current=1, last=3   → [1, 2, 3]                 (window covers all)
- *   current=1, last=1   → []                        (single page → no UI)
- *   current=5, last=5   → [1, 2, 3, 4, 5]           (last is current, no trailing ellipsis)
- *
- * Always anchors the sequence with `1` and `last_page` (when they
- * exist and differ from the current window) so users always have a
- * "jump to start" / "jump to end" affordance.
- *
- * @param current   1-indexed current page
- * @param last      1-indexed last page (`Paginator.last_page`)
- * @param window    Number of neighbors on EACH side of `current` to
- *                  show before the ellipsis kicks in. Default 2 gives
- *                  the canonical compact shape.
- */
-export declare function buildPageSequence(current: number, last: number, window?: number): Array<number | '…'>;
-/**
- * Compute the URL for a specific page number, re-templating the
- * `page=N` parameter on whichever existing paginator URL is present.
- * Preserves all other query params (search filters, sort, etc.) — the
- * URLs filled in by `enrichPaginatorUrls()` (P2) already carry them,
- * so the re-template just swaps the page number.
- *
- * Falls back to `?page=N` when no template URL is available — covers
- * the case where the paginator was built outside a request scope (CLI
- * / queue / cron) and rendered via a non-default view; produces a
- * relative link that still works against the active page.
- */
-export declare function urlForPage(view: PaginatorView, page: number): string;
-/**
- * Classify a paginator instance by shape so the view picks the right
- * UI variant. Returns one of `'full'` / `'simple'` / `'cursor'` based
- * on which fields are present. This mirrors `isPaginator` /
- * `isSimplePaginator` / `isCursorPaginator` in `@stacksjs/orm` but
- * lives here so the view layer doesn't need to import the orm.
- */
-export declare function paginatorVariant(p: unknown): 'full' | 'simple' | 'cursor' | 'unknown';
-/**
- * Pagination view helpers (stacksjs/stacks#1909, P5 from #1910).
- *
- * Pure functions consumed by the `<Pagination>` stx component
- * (`defaults/resources/components/Pagination.stx`). Extracted here so
- * the page-sequence + URL-templating logic is unit-testable independent
- * of the stx render pipeline, and so apps that want to roll their own
- * pagination UI can reuse the same algorithms.
- *
- * The functions operate on the canonical paginator shapes from
- * `@stacksjs/orm` (Paginator / SimplePaginator / CursorPaginator), but
- * accept any duck-typed object with the right fields so callers don't
- * need a runtime import dependency on the orm module just to format
- * page numbers.
- */
-/**
- * Subset of {@link Paginator} fields that the view-side helpers actually
- * touch. Keeping this minimal keeps the helper decoupled from the orm.
- */
-export declare interface PaginatorView {
-  current_page?: number
-  last_page?: number
-  prev_page_url?: string | null
-  next_page_url?: string | null
-  first_page_url?: string
-  last_page_url?: string
-}

package/dist/pagination.js

@@ -1,40 +0,0 @@
-export function buildPageSequence(current, last, window = 2) {
-  if (last <= 1)
-    return [];
-  const out = [], lo = Math.max(2, current - window), hi = Math.min(last - 1, current + window);
-  out.push(1);
-  if (lo === 3)
-    out.push(2);
-  else if (lo > 3)
-    out.push("\u2026");
-  for (let i = lo;i <= hi; i++)
-    out.push(i);
-  if (hi === last - 2)
-    out.push(last - 1);
-  else if (hi < last - 2)
-    out.push("\u2026");
-  if (last > 1)
-    out.push(last);
-  return out;
-}
-export function urlForPage(view, page) {
-  const template = view.next_page_url || view.prev_page_url || view.first_page_url || view.last_page_url;
-  if (template) {
-    if (/[?&]page=\d+/.test(template))
-      return template.replace(/([?&])page=\d+/, `$1page=${page}`);
-    return `${template}${template.includes("?") ? "&" : "?"}page=${page}`;
-  }
-  return `?page=${page}`;
-}
-export function paginatorVariant(p) {
-  if (p === null || typeof p !== "object")
-    return "unknown";
-  const v = p;
-  if ("next_cursor" in v)
-    return "cursor";
-  if ("total" in v && "last_page" in v)
-    return "full";
-  if ("current_page" in v && "per_page" in v)
-    return "simple";
-  return "unknown";
-}