@50arms/ui 0.0.0-stage → 35.1.0

package/dist/types/lib/values/currency.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `1234.5` → `"$1,234.50"` in `en-US`, `"1.234,50 $"` in `de-DE`. `null` / `undefined` → `"—"`. `0` → `"$0.00"`.
+ *
+ * `NaN` / `Infinity` are not real amounts either and render as the em dash —
+ * grouped with absence rather than with a malformed string, because unlike
+ * `formatDate`'s malformed-input case, there is no ORIGINAL
+ * user-facing string to show back: the caller already has a `number`, and a
+ * non-finite one is a computation defect upstream, not a typo to surface.
+ */
+export declare function formatCurrency(value: number | null | undefined, locale: string): string;
+/**
+ * A human-typed amount → a `number` in dollars, or `null`.
+ *
+ * Tolerates the punctuation someone actually types or pastes: the dollar sign
+ * (and `locale`'s own symbol for it), `locale`'s thousands separator, surrounding whitespace, and ACCOUNTING-style negatives —
+ * `"($1,234.56)"` for `-1234.56`, the convention every US invoice and EOB
+ * already uses for a credit or a refund. A leading `-` is accepted too.
+ * Returns `null` — never `NaN`, never a silent `0` — for anything that is not
+ * recognizably a number once that punctuation is stripped, so a caller can
+ * reject a bad edit instead of storing garbage.
+ */
+export declare function parseCurrency(input: string, locale: string): number | null;

package/dist/types/lib/values/date.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `"2026-09-11"` → `"09/11/2026"` in `en-US`, `"11.09.2026"` in `de-DE`.
+ *
+ * `null` / `undefined` / `""` render as the em dash — no date entered, the
+ * convention the rest of this package's formatters share (`formatTokens`,
+ * `formatBoolean`'s "Unknown" is the one deliberate exception; see its own
+ * docblock for why absence needs a different word there).
+ *
+ * A non-empty value that is NOT a valid `YYYY-MM-DD` date is returned
+ * UNCHANGED rather than folded into the same em dash. Absence and corruption
+ * are different facts — silently rendering a malformed stored value as "no
+ * date" hides a data problem behind a blank field; showing the raw string
+ * puts it in front of whoever is looking at the row.
+ */
+export declare function formatDate(value: string | null | undefined, locale: string): string;
+/**
+ * A human-typed date → the stored `YYYY-MM-DD`, or `null` if it is not one.
+ *
+ * Accepts the numeric date in `locale`'s own order (what `formatDate` prints, and what a person types
+ * into a text field) and bare ISO `YYYY-MM-DD` (what a paste from another
+ * system, or this library's own storage form, looks like) — nothing looser.
+ * `Date`-style leniency (`new Date("2026-2-30")` silently becoming the 2nd of
+ * March) is exactly the failure mode `parsePlainDate`'s calendar-length check
+ * exists to refuse, so this function refuses it too: `daysInMonth` bounds the
+ * day before anything is accepted.
+ *
+ * Returns `null`, never throws — a form validating a field checks the return
+ * value; it should not have to wrap every keystroke in `try`/`catch`.
+ */
+export declare function parseDate(input: string, locale: string): string | null;

package/dist/types/lib/values/datetime.d.ts

@@ -0,0 +1,48 @@
+export interface FormatDateTimeOptions {
+    /**
+     * IANA zone to render in, e.g. `"America/New_York"`. Omit to use the
+     * reader's own zone — the right default for an instant, and the reason
+     * this is a parameter at all rather than always-local: a report emailed to
+     * someone in a different zone, or a server rendering a PDF, needs to say
+     * WHOSE clock the printed time is on.
+     */
+    zone?: string;
+}
+/**
+ * A stored instant → `"09/11/2026, 1:18 PM"` (`en-US`) in `options.zone` (default: the
+ * reader's own).
+ *
+ * `null` / `undefined` / `""` render as the em dash. A non-empty value that
+ * does not parse as an instant is returned UNCHANGED — see `date.ts`'s
+ * docblock for why absence and corruption get different treatment.
+ */
+export declare function formatDateTime(value: string | number | null | undefined, locale: string, options?: FormatDateTimeOptions): string;
+export interface ParseDateTimeOptions {
+    /**
+     * The zone a bare (no AM/PM-less midnight, no offset) typed value's
+     * wall-clock reading is IN. Omit to use the reader's own zone — matching
+     * `formatDateTime`'s default, so parsing a value typed against that display
+     * uses the same zone it was rendered in.
+     */
+    zone?: string;
+}
+/**
+ * A human-typed date-time → the stored ISO instant, or `null`.
+ *
+ * TWO PATHS, DELIBERATELY NOT ONE. An ISO string carrying its own offset or
+ * `Z` is unambiguous — `Date.parse` resolves it correctly regardless of what
+ * zone this function is running in, and is used directly. Everything else is
+ * a WALL-CLOCK reading with no zone of its own (`"09/11/2026, 1:18 PM"`), and
+ * `Date.parse`'s native handling of that shape resolves it against the
+ * HOST's zone — which is wrong the instant `options.zone` names a different
+ * one, e.g. a server in UTC parsing a value entered by a reader in
+ * `America/New_York`. So the wall-clock path is hand-parsed into fields and
+ * handed to `plainDateTimeToInstant`, which resolves it against the
+ * REQUESTED zone rather than whatever zone the code happens to be running in.
+ *
+ * A wall-clock reading that lands in a DST gap or overlap does not throw —
+ * `plainDateTimeToInstant`'s default (`"compatible"`) disambiguation applies,
+ * matching every other date library's default and `Temporal`'s own. See
+ * `time-dst.test.ts` for what that resolves to at a transition.
+ */
+export declare function parseDateTime(input: string, locale: string, options?: ParseDateTimeOptions): string | null;

package/dist/types/lib/values/index.d.ts

@@ -0,0 +1,5 @@
+export { formatDate, parseDate } from "./date";
+export { formatDateTime, parseDateTime, type FormatDateTimeOptions, type ParseDateTimeOptions } from "./datetime";
+export { formatCurrency, parseCurrency } from "./currency";
+export { formatNumber, parseNumber, type FormatNumberOptions } from "./number";
+export { formatBoolean, parseBoolean, type FormatBooleanOptions } from "./boolean";

package/dist/types/lib/values/locale-date.d.ts

@@ -0,0 +1,34 @@
+import type { PlainDateTime } from "../time/types";
+type DateField = "year" | "month" | "day";
+export declare const DATE_OPTIONS: Intl.DateTimeFormatOptions;
+export declare const TIME_OPTIONS: Intl.DateTimeFormatOptions;
+/** A wall-clock reading as a `Date` whose UTC fields ARE the reading, so `timeZone: "UTC"` prints it untouched. */
+export declare function wallDate(wall: PlainDateTime): Date;
+export declare function plainSpaces(text: string): string;
+export interface DatePattern {
+    order: DateField[];
+    /** Regex source matching one numeric date in the locale's order and separator. */
+    source: string;
+}
+/**
+ * The locale's own digits and bidi marks → plain Latin digits and nothing, so a number typed in
+ * Eastern Arabic or Persian digits (ar-EG, fa-IR) reads the same as one typed in Latin.
+ */
+export declare function normalizeDigits(text: string, locale: string): string;
+export declare function datePattern(locale: string): DatePattern;
+/** The three captured numbers of a `datePattern` match, by field. */
+export declare function dateFields(order: DateField[], match: RegExpExecArray, offset?: number): {
+    year: number;
+    month: number;
+    day: number;
+};
+export interface ClockPattern {
+    /** True when the locale shows 1-12 with a day period ("AM"/"PM"), false for a 0-23 clock. */
+    twelveHour: boolean;
+    /** Lower-case, space-free forms of the locale's morning and afternoon words (12-hour clocks only). */
+    am: string;
+    pm: string;
+}
+export declare function normalizePeriod(text: string): string;
+export declare function clockPattern(locale: string): ClockPattern;
+export {};

package/dist/types/lib/values/number.d.ts

@@ -0,0 +1,27 @@
+export interface FormatNumberOptions {
+    /**
+     * Fixed fraction digits, e.g. `1` for a percentage rendered as `"42.0"`.
+     * Omit to show the value's own precision, up to 6 fraction digits, with no
+     * trailing zeros invented.
+     */
+    decimals?: number;
+}
+/**
+ * `1234.5` → `"1,234.5"` in `en-US`, `"1.234,5"` in `de-DE`. `null` / `undefined` → `"—"`.
+ *
+ * `NaN` / `Infinity` render as the em dash too, for the same reason
+ * `formatCurrency` groups them with absence rather than showing them back:
+ * the caller holds a `number`, not a string a person typed, so there is no
+ * original text to preserve.
+ */
+export declare function formatNumber(value: number | null | undefined, locale: string, options?: FormatNumberOptions): string;
+/**
+ * A human-typed number → a `number`, or `null`.
+ *
+ * Reads `locale`'s own convention — `"1,234.5"` in `en-US` and `"1.234,5"` in
+ * `de-DE` are both `1234.5` — and accepts a leading `-` for a negative value. Rejects, rather than
+ * silently truncating, anything `parseFloat` would otherwise accept a PREFIX
+ * of — `"12abc"` is not twelve, it is a typo, and `parseFloat` alone would
+ * return `12` and hide that.
+ */
+export declare function parseNumber(input: string, locale: string): number | null;

package/dist/types/pure.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `@50arms/ui/pure` — the half of this package that is not a UI.
+ *
+ * WHY A SECOND ENTRY EXISTS. The package exported exactly one, `.`, which is
+ * the whole design system. So an application's own formatting layer — a plain
+ * module that turns records into strings, imported by workers, tests, server
+ * code and components alike — could not reach `formatBytes` without importing
+ * React and every component in this library into a layer that is deliberately
+ * framework-free. The consumer's answer was to copy the function, which is how
+ * two places start rendering the same quantity to different precision.
+ *
+ * THE CONTRACT, AND IT IS THE ONLY REASON THIS ENTRY IS WORTH HAVING: nothing
+ * reachable from here imports React, `react-dom`, or the JSX runtime. An entry
+ * that quietly pulls the React graph back in is not a smaller import, it is the
+ * same import with a second name — and it would fail silently, because a
+ * consumer's bundle does not announce what got dragged into it.
+ *
+ * So the claim is checked against the BUILT ARTIFACT rather than reasoned about
+ * from the source: `pure-entry.test.ts` reads `dist/pure.js`, extracts every
+ * import specifier it actually emitted, and asserts none of them is React —
+ * plus a size ceiling, so React cannot have been inlined instead of imported.
+ * A source-graph sweep in the same file catches it one step earlier, before a
+ * build has run.
+ *
+ * WHAT BELONGS HERE. Decisions about how a value READS, with no dependencies:
+ * precision, units, the point at which a rounded figure stops telling the
+ * truth. Deliberately NOT the whole calendar layer — `formatDateRange`,
+ * `hoursInDay`, `monthGridDays` and the rest of `lib/time`'s CALENDAR-UI
+ * surface are equally pure but answer a question this entry's consumers do
+ * not have: they are grid-layout and scheduling math, not "turn a stored
+ * value into a string." `lib/values/date.ts` and `datetime.ts` are the
+ * question that WAS asked (a consumer's data grid duplicating this exact
+ * display/parse logic locally, instead of sourcing it from one place) and are
+ * exported below. They reuse `lib/time`'s zone arithmetic internally — that
+ * module has no React in it either, so pulling it in transitively costs real
+ * bytes but not the one thing this entry actually guards against.
+ *
+ * Everything exported here is ALSO exported from the main entry, so nothing
+ * about this is a migration and no existing import has to change.
+ */
+export { formatBytes, formatTokens, formatCompactNumber } from "./lib/format";
+export { formatDate, parseDate, formatDateTime, parseDateTime, type FormatDateTimeOptions, type ParseDateTimeOptions, formatCurrency, parseCurrency, formatNumber, parseNumber, type FormatNumberOptions, formatBoolean, parseBoolean, type FormatBooleanOptions, } from "./lib/values";
+export type { BooleanStrings, FormatsStrings, ReadErrorStrings, RelativeAgeStrings } from "./lib/i18n/areas/formats";
+export { confidenceLevel, CONFIDENCE_LEVEL_LABELS, type ConfidenceLevel } from "./lib/confidence";
+export { CHART_SERIES_COUNT, CHART_SERIES_TOKENS, CHART_SEQUENTIAL_TOKEN, CHART_SEQUENTIAL_COLOR, chartSeriesColor, } from "./lib/chart-palette";
+export type { LegalBlock, LegalDocumentValue, LegalSection } from "./lib/legal-document";
+export { DESIGN_FRAME_APPEARANCE, DESIGN_FRAME_READY, DESIGN_FRAME_ERROR, DESIGN_FRAME_ERROR_MAX_LENGTH, DESIGN_FRAME_HEIGHT, DESIGN_FRAME_HEIGHT_MAX, type DesignFrameAppearance, type DesignFrameAppearanceMessage, type DesignFrameReadyMessage, type DesignFrameErrorMessage, type DesignFrameHeightMessage, type DesignFrameInboundMessage, } from "./lib/design-frame/protocol";
+export { DANX_MINI_APP_METHODS, type DanxMiniApp } from "./lib/design-frame/mini-app";

package/package.json

@@ -1,6 +1,138 @@
 {
   "name": "@50arms/ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "35.1.0",
+  "type": "module",
+  "description": "50 Arms — a domain-agnostic React design system with motion as a first-class primitive.",
+  "license": "MIT",
+  "author": "Dan Newman",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/newms87/danxbot-ui.git"
+  },
+  "bugs": "https://github.com/newms87/danxbot-ui/issues",
+  "keywords": [
+    "react",
+    "design-system",
+    "component-library",
+    "tailwindcss",
+    "accessible",
+    "animation",
+    "ui"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "sideEffects": [
+    "*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pure": {
+      "types": "./dist/types/pure.d.ts",
+      "import": "./dist/pure.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./theme.css": "./dist/theme.css",
+    "./fonts.css": "./dist/fonts.css",
+    "./confidence.css": "./dist/confidence.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "gen:api": "node scripts/gen-api-manifest.mjs",
+    "predev": "npm run gen:api",
+    "pretypecheck": "npm run gen:api",
+    "prebuild:demo": "npm run gen:api",
+    "dev": "vite",
+    "typecheck": "tsc --noEmit",
+    "typecheck:previews": "tsc -p tsconfig.previews.json",
+    "audit:previews": "node scripts/audit-preview-classes.mjs",
+    "audit:cards": "node scripts/test-in-container.mjs --script audit-card-theme",
+    "audit:hover": "node scripts/test-in-container.mjs --script audit-hover",
+    "test": "node scripts/test-in-container.mjs",
+    "test:dist": "node scripts/test-in-container.mjs --with-dist",
+    "build:lib": "vite build --config vite.lib.config.ts && vite build --config vite.pure.config.ts && node scripts/postbuild-css.mjs && npm run build:types",
+    "fonts": "node scripts/fetch-fonts.mjs",
+    "icons": "node scripts/build-icons.mjs",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:demo": "vite build",
+    "build": "npm run build:lib && npm run build:demo",
+    "verify": "npm run typecheck && npm run build && npm run test:dist && npm run probe:slider && npm run typecheck:previews && npm run audit:previews && npm run audit:visual-stale",
+    "audit:visual-stale": "node scripts/audit-visual-stale.mjs",
+    "preview": "vite preview",
+    "preview:built": "vite preview --outDir demo-dist --port 5801 --strictPort",
+    "gates": "node scripts/test-in-container.mjs --script shoot a11y-scan shoot-overlays probe-scale probe-switch probe-slider probe-slider-snap probe-panel probe-popover-width probe-api probe-api-live probe-tabs-overflow probe-stat-row probe-packaging probe-containment probe-popover-containment probe-popover-panel-width probe-theme-menu-overflow probe-shell probe-nav-trigger-tap-target probe-attachment-touch probe-composer-inline probe-composer-stacked-send probe-message-width probe-dense-button probe-card-header probe-inline-edit probe-read-more probe-section-nav probe-attention probe-paged-window",
+    "a11y": "node scripts/test-in-container.mjs --script a11y-scan",
+    "shoot": "node scripts/test-in-container.mjs --script shoot",
+    "probe": "node scripts/test-in-container.mjs --script probe-scale probe-switch probe-slider probe-slider-snap probe-panel probe-popover-width probe-api probe-api-live probe-tabs-overflow probe-stat-row probe-packaging probe-containment probe-popover-containment probe-popover-panel-width probe-theme-menu-overflow probe-shell probe-nav-trigger-tap-target probe-attachment-touch probe-composer-inline probe-composer-stacked-send probe-message-width probe-dense-button probe-card-header probe-inline-edit probe-read-more probe-section-nav probe-attention probe-paged-window",
+    "sync": "node scripts/sync.mjs",
+    "visual": "node scripts/visual-docker.mjs",
+    "visual:update": "node scripts/visual-docker.mjs --update-snapshots",
+    "visual:report": "playwright show-report",
+    "audit:arrows": "node scripts/test-in-container.mjs --script audit-arrows",
+    "audit:motion": "node scripts/test-in-container.mjs --script audit-motion",
+    "audit:responsive": "node scripts/test-in-container.mjs --script audit-responsive",
+    "audit:dnd": "node scripts/test-in-container.mjs --script audit-dnd probe-dnd-sensors probe-dnd-a11y probe-drag-follow probe-drag-overflow probe-node-canvas probe-kanban",
+    "audit:axtree": "node scripts/test-in-container.mjs --script audit-axtree",
+    "audit:mutations": "node scripts/audit-mutations.mjs",
+    "audit:palette": "node scripts/test-in-container.mjs --script audit-palette",
+    "probe:calendar": "node scripts/test-in-container.mjs --script probe-calendar",
+    "audit": "npm run audit:previews && node scripts/test-in-container.mjs --script audit-card-theme audit-arrows audit-axtree audit-palette audit-motion audit-responsive audit-hover a11y-scan probe-calendar probe-calendar-drag audit-dnd probe-dnd-sensors probe-dnd-a11y probe-drag-follow probe-drag-overflow probe-node-canvas probe-kanban probe-markdown-caret probe-markdown-component probe-markdown-affordances",
+    "probe:calendar-drag": "node scripts/test-in-container.mjs --script probe-calendar-drag",
+    "audit:conventions": "node scripts/audit-conventions.mjs",
+    "audit:component-exports": "node scripts/audit-component-exports.mjs",
+    "probe:markdown": "node scripts/test-in-container.mjs --script probe-markdown-caret probe-markdown-component probe-markdown-affordances",
+    "probe:slider": "node scripts/test-in-container.mjs --script probe-slider",
+    "release": "node --no-deprecation scripts/publish.mjs"
+  },
+  "peerDependencies": {
+    "react": "^19",
+    "react-dom": "^19"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.7.0",
+    "@dagrejs/dagre": "^3.1.1",
+    "@tanstack/react-table": "^8.21.3",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.3.1",
+    "tailwind-variants": "^3.3.1"
+  },
+  "devDependencies": {
+    "@axe-core/playwright": "^4.13.0",
+    "@playwright/test": "^1.62.1",
+    "@tailwindcss/vite": "^4.1.14",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.8",
+    "@types/node": "^26.2.0",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.1",
+    "@vitejs/plugin-react": "^5.0.4",
+    "axe-core": "^4.13.0",
+    "fumadocs-core": "^16.14.5",
+    "fumadocs-mdx": "^15.3.0",
+    "happy-dom": "^20.11.2",
+    "lucide-react": "^0.545.0",
+    "playwright": "^1.62.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tailwindcss": "^4.1.14",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.9",
+    "vitest": "^4.1.11",
+    "zod": "^4.4.3"
+  },
+  "allowScripts": {
+    "esbuild@0.28.2": true
+  }
+}