@wow-two-beta/ui-vue 0.0.5 → 0.0.6

package/dist/foundation/commands/CommandsContext.d.ts

@@ -1,30 +0,0 @@
-import { ComputedRef, InjectionKey, MaybeRefOrGetter } from 'vue';
-import { Command } from './Command';
-import { CommandErrorHandler, CommandRegistry } from './CommandRegistry';
-/** The injection key — React's `createContext(undefined)` becomes a key plus an explicit throw at the read site. */
-export declare const CommandsKey: InjectionKey<CommandRegistry>;
-/**
- * The provider half — used by `CommandsProvider`, and by any component that owns a registry.
- *
- * @param registry An existing registry to share (module-scope singleton, a test's registry). Omitted → one is
- *   created and owned here.
- * @param onError Where a failing command's error goes. Read live, and ignored when `registry` is supplied —
- *   that registry carries its own handler.
- * @returns The registry that was provided.
- */
-export declare function provideCommands(registry?: MaybeRefOrGetter<CommandRegistry | undefined>, onError?: MaybeRefOrGetter<CommandErrorHandler | undefined>): CommandRegistry;
-/** Reads the ambient registry. Throws when no {@link CommandsKey} provider is mounted — see the file header. */
-export declare function useCommands(): CommandRegistry;
-/**
- * Reads one command from the ambient registry by id, updating when that command is registered, replaced, or
- * removed. `undefined` while nothing owns the id — a palette row can render a disabled placeholder from it.
- */
-export declare function useCommand(id: MaybeRefOrGetter<string>): ComputedRef<Command | undefined>;
-/**
- * Registers commands for as long as the calling scope lives, unregistering when it is disposed. The array may be
- * an inline literal, a ref, or a getter — registration re-runs when the commands' text metadata changes, and
- * `run` / `when` always call through to the latest value.
- *
- * Pass `registry` to target a specific registry; otherwise the ambient one is used (and a missing provider throws).
- */
-export declare function useRegisterCommands(commands: MaybeRefOrGetter<readonly Command[]>, registry?: CommandRegistry): void;

package/dist/foundation/commands/CommandsProvider.vue.d.ts

@@ -1,18 +0,0 @@
-import { CommandErrorHandler, CommandRegistry } from './CommandRegistry';
-import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
-/** Props for `CommandsProvider`. */
-export interface CommandsProviderProps {
-    /** An existing registry to share (module-scope singleton, a test's registry). Omitted → the provider owns one. */
-    registry?: CommandRegistry;
-    /** Where a failing command's error goes. Ignored when `registry` is supplied — that registry carries its own handler. */
-    onError?: CommandErrorHandler;
-}
-declare const _default: __VLS_WithSlots< DefineComponent<CommandsProviderProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<CommandsProviderProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
-    default?: (props: {}) => any;
-}>;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/foundation/commands/UseCommandRegistry.d.ts

@@ -1,19 +0,0 @@
-import { ComputedRef, ShallowRef } from 'vue';
-import { Command } from './Command';
-import { CommandRegistry } from './CommandRegistry';
-/**
- * Subscribes to a registry's mutations and returns its current version counter. The building block behind
- * {@link useCommandList} / {@link useAvailableCommands}; use it directly to derive a custom projection
- * (`computed(() => (version.value, registry.list().filter(mine)))`).
- */
-export declare function useCommandRegistryVersion(registry: CommandRegistry): Readonly<ShallowRef<number>>;
-/** Every registered command in insertion order, updating the caller whenever the registry mutates. */
-export declare function useCommandList(registry: CommandRegistry): ComputedRef<readonly Command[]>;
-/**
- * The commands a palette should show — `available()` re-evaluated on every registry mutation.
- *
- * Availability also depends on whatever `when()` reads, and a registry mutation is the only trigger here: a
- * `when` predicate closing over unrelated state won't re-run on its own. Keep predicates over state the registry
- * sees (re-register on change — `useRegisterCommands` does this for you), not over free-floating variables.
- */
-export declare function useAvailableCommands(registry: CommandRegistry): ComputedRef<readonly Command[]>;

package/dist/foundation/commands/UseCommandShortcuts.d.ts

@@ -1,18 +0,0 @@
-import { MaybeRefOrGetter } from 'vue';
-import { HotkeyOptions } from '../shortcuts';
-import { CommandContext } from './Command';
-import { CommandRegistry } from './CommandRegistry';
-/** Tunes command-shortcut binding — every `useHotkeyMap` option, plus the payload passed to the command. */
-export interface CommandShortcutOptions extends HotkeyOptions {
-    /** Forwarded to `registry.run(id, context)` on every trigger. Read live, so changing it needs no re-binding. */
-    readonly context?: MaybeRefOrGetter<CommandContext>;
-    /** Notified after a triggered command settles — the seam for closing a palette or logging the outcome. */
-    readonly onRun?: (id: string) => void;
-}
-/**
- * Binds the chord of every available command in `registry`, running the command on trigger. Re-binds whenever the
- * registry changes. Commands without a `shortcut`, and commands `when()`/`enabled` currently blocks, bind nothing.
- *
- * Failures are swallowed by design — `registry.run` never throws and routes errors to the registry's `onError`.
- */
-export declare function useCommandShortcuts(registry: CommandRegistry, options?: CommandShortcutOptions): void;

package/dist/foundation/device/UseBreakpoint.d.ts

@@ -1,20 +0,0 @@
-import { ComputedRef, MaybeRefOrGetter } from 'vue';
-import { BreakpointScale } from './Breakpoints';
-/**
- * Resolves the active breakpoint from a caller-supplied scale: the key of the widest breakpoint the viewport
- * currently satisfies.
- *
- * No scale is built in — this library is Tailwind-v4 token-driven and the app owns its `@theme` breakpoints. Pass
- * `TAILWIND_BREAKPOINTS` to opt into Tailwind's defaults, or your own map to match your tokens.
- *
- * The scale may be a ref or getter; changing it re-points the existing subscriptions.
- *
- * Reads `null` under SSR, where no media query matches. Layout that must be right before JS runs belongs in CSS;
- * this composable is for behaviour a media query alone cannot express — which list virtualiser to mount, how many
- * items to prefetch.
- *
- * @param scale Breakpoint key to minimum viewport width in CSS pixels. Entries beyond `MAX_BREAKPOINTS`, counted
- * widest-first, are ignored; invalid widths are dropped.
- * @returns The active breakpoint key, or `null` when the viewport is narrower than every entry in the scale.
- */
-export declare function useBreakpoint<TScale extends BreakpointScale>(scale: MaybeRefOrGetter<TScale>): ComputedRef<Extract<keyof TScale, string> | null>;

package/dist/foundation/device/UseDisplayMode.d.ts

@@ -1,23 +0,0 @@
-import { ComputedRef } from 'vue';
-import { DisplayMode } from './DisplayMode';
-/**
- * Reports how the document is being presented — its {@link DisplayMode}.
- *
- * Falls back to `'browser'` when no mode query matches, which is also what SSR and any browser without
- * `display-mode` support produce. `'browser'` therefore means "an ordinary tab, as far as can be told", not a
- * proof that the app is uninstalled.
- *
- * @returns The active {@link DisplayMode}.
- */
-export declare function useDisplayMode(): ComputedRef<DisplayMode>;
-/**
- * Whether the app is running as an installed app rather than in a browser tab — any display mode other than
- * `'browser'`.
- *
- * Reads `false` under SSR and on iOS < 16.4 (see this file's header). Use it to ADD an installed-only affordance
- * — suppressing an "Install app" prompt, showing a custom title bar — never to withhold functionality, because a
- * `false` here can mean "installed, but undetectable".
- *
- * @returns `true` when the app is presented outside an ordinary browser tab.
- */
-export declare function useIsInstalled(): ComputedRef<boolean>;

package/dist/foundation/device/UsePointer.d.ts

@@ -1,25 +0,0 @@
-import { ComputedRef } from 'vue';
-import { PointerType } from './PointerType';
-/**
- * Reports the precision of the primary pointing device — `'fine'` (mouse, trackpad, stylus), `'coarse'` (finger),
- * or `'none'`.
- *
- * Reactive: a tablet gaining a mouse flips `'coarse'` → `'fine'` without a reload.
- *
- * Under SSR this reads `'none'` (there are no media features to read) and corrects on hydration. Treat `'none'`
- * as "no pointer known", not as a fact — never hide an essential affordance behind it.
- *
- * @returns The active {@link PointerType}.
- */
-export declare function usePointerType(): ComputedRef<PointerType>;
-/**
- * Whether the primary pointing device can hover — the `(hover: hover)` media feature.
- *
- * Gate hover-only affordances on this: a tooltip that opens on mouseover, a table row's hover-revealed actions. On
- * a touchscreen a hover-only control is simply unreachable and needs a tap target or an always-visible equivalent.
- *
- * Reads `false` under SSR, so hover-revealed content must never be the only path to an action.
- *
- * @returns `true` when the primary pointer can hover.
- */
-export declare function useHoverCapability(): ComputedRef<boolean>;

package/dist/foundation/format/Text.d.ts

@@ -1,51 +0,0 @@
-/** Tunes truncation. */
-export interface TruncateOptions {
-    /** The overflow indicator appended when the text is cut. Defaults to `…`. */
-    readonly ellipsis?: string;
-    /** Cut back to the last word boundary so a word is never split mid-way. Defaults to `false`. */
-    readonly wordBoundary?: boolean;
-}
-/**
- * Truncates `text` to at most `maxLength` characters *including* the ellipsis. Returns the text unchanged when it
- * already fits. With `wordBoundary`, trims back to the last space before the cut so no word is split.
- */
-export declare function truncate(text: string, maxLength: number, options?: TruncateOptions): string;
-/** Upper-cases the first character, leaving the rest untouched (`"hi there"` → `"Hi there"`). */
-export declare function capitalize(text: string): string;
-/** Upper-cases the first letter of each whitespace-separated word (rest of each word lowercased). */
-export declare function titleCase(text: string): string;
-/** Tunes slug generation. */
-export interface SlugifyOptions {
-    /** The word separator. Defaults to `-`. */
-    readonly separator?: string;
-}
-/**
- * Builds a URL-safe slug: strips diacritics (NFKD normalize + drop combining marks), lower-cases, replaces every
- * run of non-alphanumeric characters with the separator, and trims leading/trailing separators.
- * `"Héllo, World!"` → `"hello-world"`.
- */
-export declare function slugify(text: string, options?: SlugifyOptions): string;
-/** Tunes initials extraction. */
-export interface InitialsOptions {
-    /** Maximum number of initials to take. Defaults to `2`. */
-    readonly max?: number;
-}
-/**
- * Extracts up-to-`max` upper-cased initials from a name — the first letter of the first and last significant
- * words. `"John Ronald Reuel Tolkien"` → `"JT"`. Returns `""` for a blank name.
- */
-export declare function initials(name: string, options?: InitialsOptions): string;
-/** Tunes masking. */
-export interface MaskOptions {
-    /** Number of characters left visible. Defaults to `4`. */
-    readonly visible?: number;
-    /** The mask character. Defaults to `•`. */
-    readonly mask?: string;
-    /** Which end stays visible — `end` shows the suffix, `start` the prefix. Defaults to `end`. */
-    readonly side?: 'start' | 'end';
-}
-/**
- * Masks all but the last (or first) `visible` characters — for rendering partial secrets / PII (`"4242…4242"` →
- * `"••••••••••••4242"`). When the text is no longer than `visible`, every character is masked.
- */
-export declare function maskString(text: string, options?: MaskOptions): string;

package/dist/foundation/format/index.js

@@ -1,100 +0,0 @@
-import { f } from "../../chunks/Bytes-7Jxs6Bq6.js";
-const MS_PER = { d: 864e5, h: 36e5, m: 6e4, s: 1e3 };
-function formatDuration(milliseconds, options) {
-  if (!Number.isFinite(milliseconds)) {
-    throw new RangeError(`formatDuration: expected a finite number, got ${milliseconds}`);
-  }
-  const maxUnits = Math.max(1, options?.units ?? 2);
-  const sign = milliseconds < 0 ? "-" : "";
-  let remaining = Math.abs(milliseconds);
-  const segments = [];
-  for (const [unit, size] of Object.entries(MS_PER)) {
-    const amount = Math.floor(remaining / size);
-    if (amount > 0) {
-      segments.push(`${amount}${unit}`);
-      remaining -= amount * size;
-    }
-  }
-  const millis = Math.floor(remaining);
-  if ((segments.length === 0 || options?.ms === true) && millis > 0) segments.push(`${millis}ms`);
-  if (segments.length === 0) return "0s";
-  return `${sign}${segments.slice(0, maxUnits).join(" ")}`;
-}
-function truncate(text, maxLength, options) {
-  if (maxLength < 0) throw new RangeError(`truncate: maxLength must be ≥ 0, got ${maxLength}`);
-  if (text.length <= maxLength) return text;
-  const ellipsis = options?.ellipsis ?? "…";
-  if (maxLength <= ellipsis.length) return ellipsis.slice(0, maxLength);
-  let end = maxLength - ellipsis.length;
-  let head = text.slice(0, end);
-  if (options?.wordBoundary === true) {
-    const lastSpace = head.lastIndexOf(" ");
-    if (lastSpace > 0) {
-      end = lastSpace;
-      head = text.slice(0, end);
-    }
-  }
-  return head.trimEnd() + ellipsis;
-}
-function capitalize(text) {
-  return text.length === 0 ? text : text.charAt(0).toUpperCase() + text.slice(1);
-}
-function titleCase(text) {
-  return text.split(/(\s+)/).map((part) => /\s/.test(part) || part.length === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("");
-}
-function slugify(text, options) {
-  const separator = options?.separator ?? "-";
-  const escaped = separator.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return text.normalize("NFKD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, separator).replace(new RegExp(`^${escaped}+|${escaped}+$`, "g"), "");
-}
-function initials(name, options) {
-  const max = Math.max(1, options?.max ?? 2);
-  const words = name.trim().split(/\s+/).filter((word) => word.length > 0);
-  if (words.length === 0) return "";
-  const last = words[words.length - 1];
-  const picked = words.length <= max ? words : [...words.slice(0, max - 1), last];
-  return picked.slice(0, max).map((word) => word.charAt(0).toUpperCase()).join("");
-}
-function maskString(text, options) {
-  const visible = Math.max(0, options?.visible ?? 4);
-  const maskChar = options?.mask ?? "•";
-  const side = options?.side ?? "end";
-  if (text.length <= visible) return maskChar.repeat(text.length);
-  const masked = maskChar.repeat(text.length - visible);
-  return side === "start" ? text.slice(0, visible) + masked : masked + text.slice(text.length - visible);
-}
-function pluralize(count, singular, plural) {
-  return Math.abs(count) === 1 ? singular : plural ?? `${singular}s`;
-}
-function ordinalSuffix(value) {
-  const abs = Math.abs(Math.trunc(value));
-  const lastTwo = abs % 100;
-  if (lastTwo >= 11 && lastTwo <= 13) return "th";
-  switch (abs % 10) {
-    case 1:
-      return "st";
-    case 2:
-      return "nd";
-    case 3:
-      return "rd";
-    default:
-      return "th";
-  }
-}
-function ordinal(value) {
-  return `${Math.trunc(value)}${ordinalSuffix(value)}`;
-}
-export {
-  capitalize,
-  f as formatBytes,
-  formatDuration,
-  initials,
-  maskString,
-  ordinal,
-  ordinalSuffix,
-  pluralize,
-  slugify,
-  titleCase,
-  truncate
-};
-//# sourceMappingURL=index.js.map

package/dist/foundation/format/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":["../../../src/foundation/format/Duration.ts","../../../src/foundation/format/Text.ts","../../../src/foundation/format/Count.ts"],"sourcesContent":["// Duration humanizing — compact elapsed-time rendering `Intl` doesn't cover. `formatDuration(200_000)` → `3m 20s`.\n// Shows the N most-significant non-zero segments (default 2) across d/h/m/s(/ms), sign-preserving. Locale-free:\n// for a localized \"3 minutes ago\" phrasing use the i18n `relativeTime` formatter instead — this is the terse form.\n\n/** Tunes duration formatting. */\nexport interface FormatDurationOptions {\n  /** Maximum number of unit segments to show, most-significant first. Defaults to `2` (`1h 3m`). */\n  readonly units?: number;\n\n  /** Include a millisecond segment even for durations ≥ 1s. Defaults to `false` (ms only shows sub-second). */\n  readonly ms?: boolean;\n}\n\nconst MS_PER = { d: 86_400_000, h: 3_600_000, m: 60_000, s: 1000 } as const;\n\n/**\n * Formats a millisecond duration as a compact string (`1d 2h`, `3m 20s`, `500ms`, `0s`). Emits at most `units`\n * non-zero segments in descending order; a sub-second duration renders as `ms`. Sign is preserved. Throws a\n * `RangeError` on a non-finite input.\n */\nexport function formatDuration(milliseconds: number, options?: FormatDurationOptions): string {\n  if (!Number.isFinite(milliseconds)) {\n    throw new RangeError(`formatDuration: expected a finite number, got ${milliseconds}`);\n  }\n\n  const maxUnits = Math.max(1, options?.units ?? 2);\n  const sign = milliseconds < 0 ? '-' : '';\n  let remaining = Math.abs(milliseconds);\n\n  const segments: string[] = [];\n  for (const [unit, size] of Object.entries(MS_PER) as [keyof typeof MS_PER, number][]) {\n    const amount = Math.floor(remaining / size);\n    if (amount > 0) {\n      segments.push(`${amount}${unit}`);\n      remaining -= amount * size;\n    }\n  }\n\n  const millis = Math.floor(remaining);\n  // Sub-second total (no d/h/m/s segments) always shows ms; `ms: true` appends it to longer durations too.\n  if ((segments.length === 0 || options?.ms === true) && millis > 0) segments.push(`${millis}ms`);\n\n  if (segments.length === 0) return '0s';\n  return `${sign}${segments.slice(0, maxUnits).join(' ')}`;\n}\n","// String humanizers — truncation, casing, slugs, initials, and masking. All pure and locale-light (casing uses\n// the default locale's `toUpperCase`/`toLowerCase`); no `Intl` dependency.\n\n/** Tunes truncation. */\nexport interface TruncateOptions {\n  /** The overflow indicator appended when the text is cut. Defaults to `…`. */\n  readonly ellipsis?: string;\n\n  /** Cut back to the last word boundary so a word is never split mid-way. Defaults to `false`. */\n  readonly wordBoundary?: boolean;\n}\n\n/**\n * Truncates `text` to at most `maxLength` characters *including* the ellipsis. Returns the text unchanged when it\n * already fits. With `wordBoundary`, trims back to the last space before the cut so no word is split.\n */\nexport function truncate(text: string, maxLength: number, options?: TruncateOptions): string {\n  if (maxLength < 0) throw new RangeError(`truncate: maxLength must be ≥ 0, got ${maxLength}`);\n  if (text.length <= maxLength) return text;\n\n  const ellipsis = options?.ellipsis ?? '…';\n  if (maxLength <= ellipsis.length) return ellipsis.slice(0, maxLength);\n\n  let end = maxLength - ellipsis.length;\n  let head = text.slice(0, end);\n  if (options?.wordBoundary === true) {\n    const lastSpace = head.lastIndexOf(' ');\n    if (lastSpace > 0) {\n      end = lastSpace;\n      head = text.slice(0, end);\n    }\n  }\n  return head.trimEnd() + ellipsis;\n}\n\n/** Upper-cases the first character, leaving the rest untouched (`\"hi there\"` → `\"Hi there\"`). */\nexport function capitalize(text: string): string {\n  return text.length === 0 ? text : text.charAt(0).toUpperCase() + text.slice(1);\n}\n\n/** Upper-cases the first letter of each whitespace-separated word (rest of each word lowercased). */\nexport function titleCase(text: string): string {\n  return text\n    .split(/(\\s+)/)\n    .map((part) => (/\\s/.test(part) || part.length === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()))\n    .join('');\n}\n\n/** Tunes slug generation. */\nexport interface SlugifyOptions {\n  /** The word separator. Defaults to `-`. */\n  readonly separator?: string;\n}\n\n/**\n * Builds a URL-safe slug: strips diacritics (NFKD normalize + drop combining marks), lower-cases, replaces every\n * run of non-alphanumeric characters with the separator, and trims leading/trailing separators.\n * `\"Héllo, World!\"` → `\"hello-world\"`.\n */\nexport function slugify(text: string, options?: SlugifyOptions): string {\n  const separator = options?.separator ?? '-';\n  const escaped = separator.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  return text\n    .normalize('NFKD')\n    .replace(/[̀-ͯ]/g, '') // combining diacritical marks split off by NFKD\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, separator)\n    .replace(new RegExp(`^${escaped}+|${escaped}+$`, 'g'), '');\n}\n\n/** Tunes initials extraction. */\nexport interface InitialsOptions {\n  /** Maximum number of initials to take. Defaults to `2`. */\n  readonly max?: number;\n}\n\n/**\n * Extracts up-to-`max` upper-cased initials from a name — the first letter of the first and last significant\n * words. `\"John Ronald Reuel Tolkien\"` → `\"JT\"`. Returns `\"\"` for a blank name.\n */\nexport function initials(name: string, options?: InitialsOptions): string {\n  const max = Math.max(1, options?.max ?? 2);\n  const words = name.trim().split(/\\s+/).filter((word) => word.length > 0);\n  if (words.length === 0) return '';\n\n  // First `max-1` words plus the last word — so a long name yields \"first…last\" initials, not the first N.\n  // `words` is non-empty here, so the last element is present (the cast satisfies `noUncheckedIndexedAccess`).\n  const last = words[words.length - 1] as string;\n  const picked = words.length <= max ? words : [...words.slice(0, max - 1), last];\n  return picked\n    .slice(0, max)\n    .map((word) => word.charAt(0).toUpperCase())\n    .join('');\n}\n\n/** Tunes masking. */\nexport interface MaskOptions {\n  /** Number of characters left visible. Defaults to `4`. */\n  readonly visible?: number;\n\n  /** The mask character. Defaults to `•`. */\n  readonly mask?: string;\n\n  /** Which end stays visible — `end` shows the suffix, `start` the prefix. Defaults to `end`. */\n  readonly side?: 'start' | 'end';\n}\n\n/**\n * Masks all but the last (or first) `visible` characters — for rendering partial secrets / PII (`\"4242…4242\"` →\n * `\"••••••••••••4242\"`). When the text is no longer than `visible`, every character is masked.\n */\nexport function maskString(text: string, options?: MaskOptions): string {\n  const visible = Math.max(0, options?.visible ?? 4);\n  const maskChar = options?.mask ?? '•';\n  const side = options?.side ?? 'end';\n\n  if (text.length <= visible) return maskChar.repeat(text.length);\n\n  const masked = maskChar.repeat(text.length - visible);\n  return side === 'start' ? text.slice(0, visible) + masked : masked + text.slice(text.length - visible);\n}\n","// Count humanizers — English pluralization and ordinals. Deliberately English-only helpers, distinct from the\n// i18n `plural` formatter (which returns the locale's LDML plural *category*, not a word). Compose these with the\n// i18n number formatter for the count itself: `` `${fmt.number(n)} ${pluralize(n, 'item')}` ``.\n\n/**\n * Returns the correct English word form for `count` — `singular` when the count is exactly 1 (or -1), else\n * `plural` (defaulting to `singular + 's'`). Word only, so it composes with any number rendering.\n * `pluralize(2, 'item')` → `\"items\"`; `pluralize(1, 'child', 'children')` → `\"child\"`.\n */\nexport function pluralize(count: number, singular: string, plural?: string): string {\n  return Math.abs(count) === 1 ? singular : plural ?? `${singular}s`;\n}\n\n/** Returns the English ordinal suffix for an integer — `\"st\"`, `\"nd\"`, `\"rd\"`, or `\"th\"` (11–13 are always `\"th\"`). */\nexport function ordinalSuffix(value: number): string {\n  const abs = Math.abs(Math.trunc(value));\n  const lastTwo = abs % 100;\n  if (lastTwo >= 11 && lastTwo <= 13) return 'th';\n  switch (abs % 10) {\n    case 1:\n      return 'st';\n    case 2:\n      return 'nd';\n    case 3:\n      return 'rd';\n    default:\n      return 'th';\n  }\n}\n\n/** Renders an integer with its English ordinal suffix — `ordinal(1)` → `\"1st\"`, `ordinal(22)` → `\"22nd\"`. */\nexport function ordinal(value: number): string {\n  return `${Math.trunc(value)}${ordinalSuffix(value)}`;\n}\n"],"names":[],"mappings":"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"}

package/dist/foundation/geolocation/GeolocationReading.d.ts

@@ -1,30 +0,0 @@
-import { Position } from './Coordinates';
-import { PositionResult, PositionStatus } from './PositionResult';
-/**
- * Where a geolocation consumer sits in its lifecycle: the platform's outcomes, plus the two states that exist
- * only in the UI — `idle` (nothing requested yet) and `locating` (a request is in flight).
- */
-export type GeolocationState = 'idle' | 'locating' | PositionStatus;
-/** The state both {@link useGeolocation} and {@link useWatchPosition} expose. */
-export interface GeolocationReading {
-    /** The lifecycle state — drive the whole UI off this one switch. */
-    readonly status: GeolocationState;
-    /**
-     * The most recent successful fix, or `null` before the first one. Deliberately NOT cleared by a later
-     * failure — check `status === 'ok'` when only a currently-valid reading will do.
-     */
-    readonly position: Position | null;
-    /** The error behind a `failed` status, or `null` for every other status. Never stale. */
-    readonly error: Error | null;
-}
-/** The starting state: nothing requested, nothing known. */
-export declare const IdleGeolocationReading: GeolocationReading;
-/**
- * Folds one {@link PositionResult} into the current reading. Pure; exported for the two composables and for tests,
- * absent from the barrel.
- *
- * @param previous The reading being updated — its `position` is what carries a past fix forward.
- * @param result The outcome to apply.
- * @returns The next reading.
- */
-export declare function applyPositionResult(previous: GeolocationReading, result: PositionResult): GeolocationReading;

package/dist/foundation/geolocation/PositionResult.d.ts

@@ -1,74 +0,0 @@
-import { Position } from './Coordinates';
-/** The message on the `Error` reported when the platform hands back a position nothing can be read out of. */
-export declare const UnreadablePositionMessage = "Geolocation reported a position with no readable coordinates.";
-/**
- * The outcome of a position request — one-shot or one emission of a watch.
- *
- * - `ok` — a fix, as a plain {@link Position} snapshot.
- * - `denied` — code 1. Permanent for this origin until the user changes it; do not re-prompt.
- * - `unavailable` — code 2. Transient; retry is reasonable.
- * - `timeout` — code 3. Transient; retry, possibly with a larger `timeout`.
- * - `unsupported` — no Geolocation API here (SSR, stripped webview). Not a failure; a capability answer.
- * - `failed` — anything else, carrying the normalized `Error`: an unrecognized code, an unreadable position, or
- *   a platform call that threw.
- */
-export type PositionResult = {
-    readonly status: 'ok';
-    readonly position: Position;
-} | {
-    readonly status: 'denied';
-} | {
-    readonly status: 'unavailable';
-} | {
-    readonly status: 'timeout';
-} | {
-    readonly status: 'unsupported';
-} | {
-    readonly status: 'failed';
-    readonly error: Error;
-};
-/** The `status` discriminant of a {@link PositionResult} — for a consumer's own switch or status→copy map. */
-export type PositionStatus = PositionResult['status'];
-/**
- * Tunes a position request. Mirrors the platform's `PositionOptions`, restated here so the public API of this
- * slice owns its own input type and can document what each field actually costs.
- */
-export interface PositionRequestOptions {
-    /**
-     * Asks for the most accurate fix the device can give — GPS rather than wifi/cell triangulation. Slower to
-     * acquire and materially more battery-hungry; leave it off unless the accuracy genuinely changes the UI.
-     */
-    readonly enableHighAccuracy?: boolean;
-    /**
-     * Milliseconds to wait for a fix before answering `timeout`. Unset means wait indefinitely — which is why a
-     * request with no timeout can leave a UI spinning forever indoors. A cold GPS fix can need 10–30s.
-     */
-    readonly timeout?: number;
-    /**
-     * Milliseconds a cached fix may be old and still be handed back instantly. `0` (the platform default) forces
-     * a fresh acquisition every time; a few seconds is usually a better trade for a UI that asks repeatedly.
-     */
-    readonly maximumAge?: number;
-}
-/**
- * Translates a value from a geolocation error callback into its {@link PositionResult}. Exported for the two
- * sibling entry points; absent from the barrel.
- *
- * Never throws — a hostile error object degrades to `failed`, never to an exception thrown inside a platform
- * callback.
- *
- * @param raw The value handed to a `getCurrentPosition` / `watchPosition` error callback.
- */
-export declare function toPositionResult(raw: unknown): PositionResult;
-/**
- * Translates a value from a geolocation success callback into its {@link PositionResult}, converting the host
- * object into a plain snapshot on the way. Exported for the two sibling entry points; absent from the barrel.
- *
- * A success callback that carries nothing readable becomes `failed` rather than `ok` with a hollow position —
- * a consumer must never receive a `status: 'ok'` it cannot plot.
- *
- * Never throws.
- *
- * @param raw The value handed to a `getCurrentPosition` / `watchPosition` success callback.
- */
-export declare function toPositionSuccess(raw: unknown): PositionResult;

package/dist/foundation/geolocation/UseGeolocation.d.ts

@@ -1,38 +0,0 @@
-import { ComputedRef, MaybeRefOrGetter } from 'vue';
-import { Position } from './Coordinates';
-import { GeolocationState } from './GeolocationReading';
-import { PositionRequestOptions, PositionResult } from './PositionResult';
-/**
- * What {@link useGeolocation} returns — the reactive form of a {@link GeolocationReading} plus the action that
- * refreshes it.
- */
-export interface GeolocationControls {
-    /** The lifecycle state — drive the whole UI off this one switch. */
-    readonly status: ComputedRef<GeolocationState>;
-    /**
-     * The most recent successful fix, or `null` before the first one. Deliberately NOT cleared by a later
-     * failure — check `status.value === 'ok'` when only a currently-valid reading will do.
-     */
-    readonly position: ComputedRef<Position | null>;
-    /** The error behind a `failed` status, or `null` for every other status. Never stale. */
-    readonly error: ComputedRef<Error | null>;
-    /** Convenience for `status === 'locating'` — the flag a button's `disabled` / spinner wants. */
-    readonly locating: ComputedRef<boolean>;
-    /**
-     * Requests a fix, writing the outcome to this composable's state and also resolving to it. Never throws,
-     * never rejects. Call it from a user gesture — it is what raises the permission prompt.
-     *
-     * @param overrides Options for this call only, replacing the composable-level ones. Omit to use those.
-     */
-    readonly request: (overrides?: PositionRequestOptions) => Promise<PositionResult>;
-}
-/**
- * Exposes the device's position as reactive state, with a `request()` that fetches it on demand.
- *
- * Requests nothing on mount — see the header for why that is deliberate. Inherits the slice's never-throws
- * contract: `request` resolves to a {@link PositionResult}, never rejects.
- *
- * @param options Default tuning for every `request()` call. A ref or getter is read at call time, so the value
- *   in effect is always the current one.
- */
-export declare function useGeolocation(options?: MaybeRefOrGetter<PositionRequestOptions | undefined>): GeolocationControls;

package/dist/foundation/geolocation/UseWatchPosition.d.ts

@@ -1,16 +0,0 @@
-import { MaybeRefOrGetter, ShallowRef } from 'vue';
-import { GeolocationReading } from './GeolocationReading';
-import { PositionRequestOptions } from './PositionResult';
-/**
- * Tracks the device's position for as long as the scope lives, clearing the watch when it is disposed.
- *
- * Starts on mount — see the header. Every fix and every failure arrives through the same
- * {@link GeolocationReading} shape `useGeolocation` exposes, minus the manual `request`; the last successful
- * fix survives a later failure, so a map keeps its pin when the signal drops.
- *
- * Inherits the slice's never-throws contract.
- *
- * @param options Accuracy / timeout / cache-age tuning. Changing any of the three values restarts the watch.
- * @returns The current reading. Holds {@link IdleGeolocationReading} during SSR and until mount.
- */
-export declare function useWatchPosition(options?: MaybeRefOrGetter<PositionRequestOptions | undefined>): Readonly<ShallowRef<GeolocationReading>>;

package/dist/foundation/gestures/UseDrag.d.ts

@@ -1,75 +0,0 @@
-import { MaybeRefOrGetter } from 'vue';
-import { GestureAxis } from './GestureAxis';
-/** What a drag handler receives — the full state of the gesture at the moment of the call. */
-export interface DragPayload {
-    /** Horizontal distance from the press origin, in CSS pixels. Zeroed when `axis` is `'y'`. */
-    readonly dx: number;
-    /** Vertical distance from the press origin, in CSS pixels. Zeroed when `axis` is `'x'`. */
-    readonly dy: number;
-    /** Current pointer position — the event's `clientX`, viewport-relative and never axis-constrained. */
-    readonly x: number;
-    /** Current pointer position — the event's `clientY`, viewport-relative and never axis-constrained. */
-    readonly y: number;
-    /** Horizontal speed in px/ms over the recent movement window, NOT over the whole drag. Signed. */
-    readonly velocityX: number;
-    /** Vertical speed in px/ms over the recent movement window, NOT over the whole drag. Signed. */
-    readonly velocityY: number;
-    /** Milliseconds since the pointer went down — the whole gesture, unlike the velocity fields. */
-    readonly elapsedMs: number;
-    /** The DOM pointer event that produced this payload, for `preventDefault`, modifier keys, or `pointerType`. */
-    readonly event: PointerEvent;
-}
-/** The callbacks a drag can fire. Every one is optional. */
-export interface DragHandlers {
-    /**
-     * Fired once the drag is recognized — immediately on pointer-down when `threshold` is `0`, otherwise on the
-     * first move that clears it.
-     */
-    readonly onDragStart?: (payload: DragPayload) => void;
-    /** Fired on each subsequent pointer move while the drag is active. */
-    readonly onDragMove?: (payload: DragPayload) => void;
-    /**
-     * Fired on pointer-up or pointer-cancel, but ONLY if the drag was recognized — a press that never cleared the
-     * threshold produces no start and therefore no end. Read `event.type` to tell a completion from a cancellation.
-     */
-    readonly onDragEnd?: (payload: DragPayload) => void;
-}
-/** Tunes how a drag is recognized. */
-export interface DragOptions {
-    /**
-     * CSS pixels the pointer must travel before the drag is recognized. Defaults to `0` — recognized on
-     * pointer-down.
-     *
-     * Raise it to a few pixels whenever the same element is also clickable: below the threshold the interaction
-     * stays a press, so a click survives the hand tremor that accompanies every real tap.
-     */
-    readonly threshold?: number;
-    /** Axis the drag is locked to — gates recognition AND zeroes the off-axis delta. Defaults to `'both'`. */
-    readonly axis?: GestureAxis;
-    /**
-     * Whether the drag is inert. Checked when the pointer goes DOWN; a gesture already in flight completes normally
-     * rather than stranding a consumer mid-drag with no `onDragEnd`.
-     */
-    readonly disabled?: boolean;
-    /**
-     * Input devices allowed to drive the drag — conventionally `'mouse'`, `'touch'`, `'pen'`. Omit for no filter.
-     * An empty array accepts nothing, which is the literal reading and makes an accidentally-empty list obvious.
-     */
-    readonly pointerTypes?: readonly string[];
-}
-/**
- * Tracks a single-pointer drag on `target`, reporting distance, position, and recent velocity.
- *
- * Takes the element as a ref or getter rather than handing one back, so the caller keeps ownership of its
- * `useTemplateRef`. Options are read through `toValue` at call time, so a reactive `disabled` or `axis` takes
- * effect without re-attaching the listener; only the element identity re-binds. When the scope is disposed every
- * listener is detached and any held pointer capture released.
- *
- * Nothing throws: a missing element, an unavailable `setPointerCapture`, or a pointer that vanishes without an
- * up event all resolve quietly.
- *
- * @param target The element to watch. A `null` value simply binds nothing.
- * @param handlers Drag lifecycle callbacks.
- * @param options Recognition tuning — threshold, axis, disabled, pointer-type filter.
- */
-export declare function useDrag(target: MaybeRefOrGetter<HTMLElement | null | undefined>, handlers: DragHandlers, options?: MaybeRefOrGetter<DragOptions | undefined>): void;

package/dist/foundation/gestures/UseLongPress.d.ts

@@ -1,42 +0,0 @@
-import { MaybeRefOrGetter } from 'vue';
-/** What the long-press handler receives when the hold completes. */
-export interface LongPressPayload {
-    /** Where the press began — `clientX` of the pointer-down, not of the moment the timer elapsed. */
-    readonly x: number;
-    /** Where the press began — `clientY` of the pointer-down. */
-    readonly y: number;
-    /**
-     * The `pointerdown` event that opened the hold. There is no event for the completion itself: a timer fired, and
-     * inventing a synthetic one would misreport `timeStamp` and `target`.
-     */
-    readonly event: PointerEvent;
-}
-/** Tunes how a hold is recognized. */
-export interface LongPressOptions {
-    /**
-     * Hold duration in milliseconds before the handler fires. Defaults to `PressExtensions.longPressDelay.default`
-     * and is clamped into that same shared `[min, max]` range — this composable defines no bounds of its own.
-     */
-    readonly delayMs?: number;
-    /** CSS pixels the pointer may drift before the hold is abandoned. Defaults to `10`. */
-    readonly moveTolerance?: number;
-    /** Whether the gesture is inert. Checked when the pointer goes down. */
-    readonly disabled?: boolean;
-    /** Input devices allowed to drive the hold. Omit for no filter; an empty array accepts nothing. */
-    readonly pointerTypes?: readonly string[];
-}
-/**
- * Fires `handler` after the pointer has been held on `target` for `delayMs` without drifting beyond
- * `moveTolerance`.
- *
- * Cancels on pointer-up, on pointer-cancel, and on any move past the tolerance. The pending timer is cleared when
- * the scope is disposed, so a component that disappears mid-hold can never fire into a dead tree.
- *
- * Takes the element as a ref or getter rather than handing one back. Options are read through `toValue` at call
- * time, so a reactive `disabled` or `delayMs` takes effect without re-attaching. Nothing throws.
- *
- * @param target The element to watch.
- * @param handler Called once when the hold completes.
- * @param options Delay, move tolerance, disabled, pointer-type filter.
- */
-export declare function useLongPress(target: MaybeRefOrGetter<HTMLElement | null | undefined>, handler: (payload: LongPressPayload) => void, options?: MaybeRefOrGetter<LongPressOptions | undefined>): void;