@appinternalleads/ui 0.2.0

package/dist/esm/sheets/records.js

@@ -0,0 +1,138 @@
+import { inferColumns } from '../components/directory/contract';
+import { LIST_MAX_ITEMS } from './bind';
+/**
+ * **A sheet as records** — for the components whose input IS rows rather than a list inside a
+ * config: Table and Grid (every row a record, every column a column), and Checklist (every row a
+ * task). Column types are discovered with the same `inferColumns` Directory uses, so a sheet reads
+ * the same way everywhere.
+ */
+const MONEY = /^[\s]*[$£€]/;
+const CURRENCY = { $: 'USD', '£': 'GBP', '€': 'EUR' };
+const URL_SHAPE = /^https?:\/\//i;
+const num = (s) => Number(s.replace(/[\s,$£€%]/g, ''));
+/** A sheet → Table / Grid columns and rows. The first column is the title, as the data-view contract says. */
+export function dataRowsFromSheet(table) {
+    const clean = table.rows.filter(r => r.some(c => c.trim() !== ''));
+    const found = inferColumns(table.headers, clean);
+    const used = new Set();
+    const columns = found.map((c, i) => {
+        let id = c.key.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '') || `col_${i + 1}`;
+        while (used.has(id))
+            id = `${id}_${i + 1}`;
+        used.add(id);
+        const values = clean.map(r => (r[i] ?? '').trim()).filter(Boolean);
+        const col = { id, label: c.label, type: 'text', width: Math.min(260, Math.max(110, c.label.length * 9 + 40)) };
+        if (i === 0)
+            return col;
+        if (values.length && values.every(v => URL_SHAPE.test(v)))
+            return { ...col, type: 'link', href: '', external: true };
+        if (values.length && values.every(v => MONEY.test(v) && Number.isFinite(num(v)))) {
+            return { ...col, type: 'currency', currency: CURRENCY[values[0].trim()[0]] ?? 'USD' };
+        }
+        if (c.type === 'number')
+            return { ...col, type: 'number' };
+        if (c.type === 'date')
+            return { ...col, type: 'date' };
+        if (c.type === 'enum' || c.type === 'boolean') {
+            return { ...col, type: 'status', tones: Object.fromEntries((c.distinctValues ?? [...new Set(values)]).map(v => [v, 'plain'])) };
+        }
+        return col;
+    });
+    const rows = clean.map((r, ri) => {
+        const row = { id: `r${ri + 1}` };
+        columns.forEach((col, ci) => {
+            const raw = (r[ci] ?? '').trim();
+            if (raw === '') {
+                row[col.id] = null;
+                return;
+            }
+            row[col.id] = col.type === 'number' || col.type === 'currency' ? num(raw)
+                : col.type === 'date' ? Date.parse(raw)
+                    : raw;
+        });
+        return row;
+    });
+    return { columns, rows };
+}
+const norm = (s) => s.toLowerCase().replace(/[^a-z0-9]/g, '');
+/** The checklist fields a sheet fills, as a person reads them. */
+export const CHECKLIST_LABELS = { title: 'Task', section: 'Section', description: 'Description', required: 'Required', assignee: 'Assignee', done: 'Done' };
+/** The type each checklist column holds. */
+export const CHECKLIST_TYPES = { title: 'text', section: 'text', description: 'text', required: 'yes/no', assignee: 'text', done: 'yes/no' };
+const YES = /^(y|yes|true|1|x|✓|✔|done|complete|completed)$/i;
+const NO = /^(n|no|false|0|optional)$/i;
+/**
+ * A sheet → a checklist: one row per task. Columns (any order, any case): **Task** or **Title**
+ * (required), **Section**, **Description**, **Required** (no / optional → optional), **Assignee**
+ * (a person id the host's people boundary resolves), **Done**. A column named exactly wins; failing
+ * that, one whose name ends with it ("Book title" → Title). Rows keep the sheet's order; a new
+ * Section value starts a new section. At most `maxTasks` rows are read.
+ */
+export function checklistFromSheet(table, base, opts = {}) {
+    const mapping = opts.mapping ?? {};
+    const mappingErrors = [];
+    const fixed = {};
+    /* A field assigned by hand — a column, a value for every row, or nothing — wins over the names below. */
+    const col = (field, ...names) => {
+        if (field in mapping) {
+            const to = mapping[field];
+            if (to === null)
+                return -1;
+            if (typeof to === 'object') {
+                fixed[field] = to.value;
+                return -1;
+            }
+            const i = table.headers.findIndex(h => h.trim().toLowerCase() === (to ?? '').trim().toLowerCase());
+            if (i < 0)
+                mappingErrors.push(`${CHECKLIST_LABELS[field] ?? field} is assigned the column “${to}”, which the sheet does not have.`);
+            return i;
+        }
+        const exact = table.headers.findIndex(h => names.includes(norm(h)));
+        return exact >= 0 ? exact : table.headers.findIndex(h => names.some(n => norm(h).endsWith(n)));
+    };
+    const c = { title: col('title', 'task', 'title', 'name'), section: col('section', 'section', 'group', 'phase'), description: col('description', 'description', 'details', 'notes'), required: col('required', 'required'), assignee: col('assignee', 'assignee', 'assigneeid', 'owner'), done: col('done', 'done', 'complete', 'completed', 'status') };
+    const missing = c.title < 0 && fixed.title === undefined ? ['Task (or Title)'] : [];
+    const sections = [];
+    const at = (r, i) => (i >= 0 ? (r[i] ?? '').trim() : '');
+    const value = (r, field) => (fixed[field] !== undefined ? fixed[field].trim() : at(r, c[field]));
+    const all = table.rows.filter(r => r.some(x => x.trim() !== ''));
+    const rows = all.slice(0, opts.maxTasks ?? LIST_MAX_ITEMS);
+    rows.forEach((r, i) => {
+        const title = value(r, 'title');
+        if (!title)
+            return;
+        const sectionTitle = value(r, 'section');
+        let section = sections[sections.length - 1];
+        if (!section || (section.title ?? '') !== sectionTitle) {
+            section = { id: `s${sections.length + 1}`, ...(sectionTitle ? { title: sectionTitle } : {}), tasks: [] };
+            sections.push(section);
+        }
+        const req = value(r, 'required');
+        const assignee = value(r, 'assignee');
+        const description = value(r, 'description');
+        section.tasks.push({
+            id: `t${i + 1}`,
+            title,
+            ...(description ? { description } : {}),
+            done: YES.test(value(r, 'done')),
+            ...(req && NO.test(req) ? { required: false } : {}),
+            ...(assignee ? { assigneeId: assignee } : {}),
+        });
+    });
+    const columns = [
+        ...Object.entries(c).filter(([, i]) => i >= 0).sort((a, b) => a[1] - b[1])
+            .map(([field, i]) => ({ header: table.headers[i], field, ...(field in mapping ? { manual: true } : {}) })),
+        ...Object.entries(fixed).map(([field, v]) => ({ header: `“${v}” in every row`, field, fixed: true, manual: true })),
+    ];
+    return { checklist: { ...base, sections: sections.length ? sections : [{ id: 's1', tasks: [] }] }, missing, total: all.length, used: rows.length, columns, mappingErrors };
+}
+/** A checklist → the sheet `checklistFromSheet` reads — the template to start from. */
+export function sheetFromChecklist(checklist) {
+    return {
+        headers: ['Section', 'Task', 'Description', 'Required', 'Assignee', 'Done'],
+        rows: checklist.sections.flatMap(s => s.tasks.map(t => [
+            s.title ?? '', t.title, t.description ?? '', t.required === false ? 'no' : 'yes', t.assigneeId ?? '', t.done ? 'yes' : 'no',
+        ])),
+    };
+}
+//# sourceMappingURL=records.js.map

package/dist/esm/sheets/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../../src/sheets/records.ts"],"names":[],"mappings":"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"}

package/dist/esm/tokens/DsProvider.d.ts

@@ -0,0 +1,154 @@
+import React from 'react';
+import { type BackgroundImageValue } from 'react-native';
+import { radii, solariumRadii, type Colors, type Mode, type Surface, type Theme } from './tokens';
+import { type ActionColors, type Density, type DensityName } from './profile';
+/**
+ * ONE thing the user picks — typeface — and one the device decides, the surface.
+ *
+ * Mode and accent used to live here too. Warm paper has one accent and one mode, so both
+ * are gone; the provider is what it always should have been, which is where the material
+ * is resolved so no screen ever inlines a shadow.
+ *
+ * **Two shipped preferences were removed by this shift and both are real losses:** the
+ * five user accents (Pine, Azure, Violet, Magenta, Amber) and dark mode. Restoring the
+ * accents means re-scoping `accentFill` / `accentInk` / `accentTint`, and each new accent
+ * needs its own tint at the same lightness as `#F7E7DE` — a tint even slightly too dark
+ * stops reading as paper, which is the actual work.
+ */
+export type TypefaceName = 'system' | 'humanist' | 'serif';
+/** See `Ds.headings`. */
+export type Headings = 'title' | 'screen';
+export type Typeface = {
+    label: string;
+    note: string;
+    /** undefined = the platform's own face. */
+    sans: string | undefined;
+    mono: string;
+};
+/**
+ * The mono face. On the web, the Solarium handoffs' stack — `ui-monospace` (SF Mono on Apple
+ * platforms), then SF Mono and Menlo by name, then the generic `monospace` (which alone resolves
+ * to Courier in most browsers). Native takes one family name, not a stack, so it names one.
+ */
+export declare const MONO_STACK_WEB = "ui-monospace, 'SF Mono', Menlo, monospace";
+export declare const TYPEFACES: Record<TypefaceName, Typeface>;
+type Ds = {
+    /** There is one mode. Kept on the context so call sites compile — see `tokens.ts`. */
+    mode: Mode;
+    surface: Surface;
+    /** Which palette this app is painted in. `paper` unless the app asked for otherwise. */
+    theme: Theme;
+    colors: Colors;
+    /** Lift-1: rows, cards, sheets. The compatibility name most components ask for. */
+    edge: string;
+    /** Lift-2: the tab bar and nav bar. */
+    edge2: string;
+    /** Lift-3: dialogs. */
+    edge3: string;
+    /** Focus darkens the field hairline. There is no colour ring anywhere in this system. */
+    focusEdge: string;
+    /**
+     * The page gradient — the warmth of the paper, full-bleed, never interactive.
+     *
+     * **Empty when the app asked for a flat page**, which is a real state and not a missing
+     * value: `experimental_backgroundImage: []` draws no layers, so the `backgroundColor`
+     * beneath it is the page. Read it through `useSubstrateStyle()` rather than testing it.
+     */
+    substrate: readonly BackgroundImageValue[];
+    /**
+     * **Lift-1 and lift-2, on the context rather than imported.**
+     *
+     * `lift1` and `lift2` are still exported from `tokens.ts` as module constants, and they
+     * cannot be theme-aware: they are evaluated at import time, before an app has had the
+     * chance to say which theme it wants. Reading them from here is what makes a component
+     * follow the theme, so a screen moves from the import to these fields as it is reskinned.
+     */
+    lift1: string;
+    lift2: string;
+    /** The radius ladder for this theme. Solarium's rungs differ; see `solariumRadii`. */
+    radii: typeof radii | typeof solariumRadii;
+    /**
+     * **Which heading rungs the shared chrome renders** — `AppHeader`'s title and the mono
+     * eyebrow on `SectionHeader`/`SectionLabel`.
+     *
+     * `title` is v2's 22px title and 12px eyebrow, which canvas-app and Build keep. `screen` is
+     * the KeyShort handoff's 32px `screenTitle` and 10px/0.12em `eyebrowDense`, on every screen
+     * alike. A provider knob for the same reason `theme` and `page` are: one package serves
+     * three apps, and a rung change in a component shared by 26 files is an app's decision,
+     * not the design system's. D4/D5 in the KeyShort task board.
+     */
+    headings: Headings;
+    /** The primary action's fill, its hover, its ink, and the switch tracks. */
+    action: ActionColors;
+    /** Row and control sizing. Web `default`, native `comfortable`, unless the app said. */
+    densityName: DensityName;
+    density: Density;
+    fonts: Typeface;
+    typeface: TypefaceName;
+    /** Pass null to go back to following the system. */
+    setTypeface: (t: TypefaceName) => void;
+};
+/**
+ * Where the typeface choice is kept, supplied by the app.
+ *
+ * The design system deliberately does NOT reach for storage itself. It used to read MMKV
+ * directly, which was fine while there was one app and became wrong the moment there were
+ * two: that store is keyed `keyboard-app`, so a shared design system reading it would have
+ * had one app persisting into the other's preferences.
+ *
+ * Omit it and the choice simply doesn't survive a relaunch — the right default for a
+ * consumer that has no opinion, and never a crash.
+ */
+export type TypefaceStore = {
+    read: () => string | undefined;
+    write: (t: TypefaceName) => void;
+};
+export declare function DsProvider({ children, typefaceStore, theme, page, headings, density, }: {
+    children: React.ReactNode;
+    typefaceStore?: TypefaceStore;
+    /** Heading rungs for the shared chrome — see `Ds.headings`. Defaults to v2's, so an app that
+     *  says nothing is untouched. */
+    headings?: Headings;
+    /**
+     * **Which palette to paint in. Defaults to `paper`, so Key and Build are untouched.**
+     *
+     * A prop rather than a build-time constant because this package is one copy across three
+     * apps — see the `Theme` note in `tokens.ts`. Ambi passes `solarium`; an app that says
+     * nothing keeps exactly the system it has today.
+     */
+    theme?: Theme;
+    /**
+     * **Whether this app's page carries the theme's gradient, or is the flat ground.**
+     *
+     * A second per-app knob for the same reason as `theme`, and it exists because the page turns
+     * out to be an APP's decision rather than a palette's. Solarium's own ground is the flat
+     * `--ground`; the vertical gradient under `solarium` is Ambi's, specified by its handoff so
+     * that warmth collects under a composer pinned to the bottom of the screen. Key has a tab bar
+     * there, not a composer, and its handoff paints the page flat — so on Key the gradient reads
+     * as an unexplained pink wash across the lower third.
+     *
+     * **`flat` is the default (S3b, 12 Sep 2026, product decision) — inverted from `gradient`.**
+     * Solarium's own base page is flat; Ambi's gradient is Ambi's own addition on top of it, so an
+     * app that asks for nothing now gets the palette's actual ground rather than a design choice
+     * that happens to belong to one specific app. This DID repaint every consumer that was
+     * silently relying on the old default without saying so — not just the canvas app the
+     * decision named. Both Ambi (`canvas-app/App.tsx`) and Build (`turbo-waddle-building/App.tsx`)
+     * now pass `page="gradient"` explicitly to hold their exact prior appearance; Key already
+     * passed `page="flat"` explicitly and is unaffected either way.
+     */
+    page?: 'gradient' | 'flat';
+    /** Row and control density. Omit for the platform default. */
+    density?: DensityName;
+}): React.JSX.Element;
+export declare function useDs(): Ds;
+/**
+ * **Override density for one subtree, keeping everything else the provider says.** A component's
+ * `density` prop is the host's presentation choice for that one component; wrapping it in a second
+ * `DsProvider` would also reset its theme and page. `undefined` inherits.
+ */
+export declare function DensityScope({ density, children }: {
+    density?: DensityName;
+    children: React.ReactNode;
+}): React.JSX.Element;
+export {};
+//# sourceMappingURL=DsProvider.d.ts.map

package/dist/esm/tokens/DsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DsProvider.d.ts","sourceRoot":"","sources":["../../../src/tokens/DsProvider.tsx"],"names":[],"mappings":"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"}

package/dist/esm/tokens/DsProvider.js

@@ -0,0 +1,103 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useState } from 'react';
+import { Platform } from 'react-native';
+import { edgeFor, focusEdgeFor, liftFor, paletteFor, substrateFor, radii, solariumRadii, } from './tokens';
+import { actionColorsFor, defaultDensityFor, DENSITIES, } from './profile';
+/**
+ * The mono face. On the web, the Solarium handoffs' stack — `ui-monospace` (SF Mono on Apple
+ * platforms), then SF Mono and Menlo by name, then the generic `monospace` (which alone resolves
+ * to Courier in most browsers). Native takes one family name, not a stack, so it names one.
+ */
+export const MONO_STACK_WEB = "ui-monospace, 'SF Mono', Menlo, monospace";
+const MONO = Platform.select({ ios: 'Menlo', android: 'monospace', web: MONO_STACK_WEB, default: 'monospace' });
+export const TYPEFACES = {
+    system: {
+        label: 'System',
+        note: 'The platform’s own face. What the design assumes.',
+        sans: undefined,
+        mono: MONO,
+    },
+    humanist: {
+        label: 'Humanist',
+        note: 'Warmer, wider letterforms. Falls back to the system face on Android.',
+        /* On the web, the Solarium onboarding handoff's stack: Avenir Next where the OS has it, then
+           Nunito Sans — which the HOST loads (the library ships no font files; 0.2.0 lists them as an
+           open dependency) — then Trebuchet and the system face. Native names one family. */
+        sans: Platform.OS === 'android' ? undefined
+            : Platform.OS === 'web' ? "'Avenir Next', 'Nunito Sans', 'Trebuchet MS', system-ui, sans-serif"
+                : 'Avenir Next',
+        mono: MONO,
+    },
+    serif: {
+        label: 'Serif',
+        note: 'Georgia on iOS, the platform serif on Android.',
+        sans: Platform.OS === 'android' ? 'serif' : 'Georgia',
+        mono: MONO,
+    },
+};
+/** No layers, so `useSubstrateStyle`'s `backgroundColor` is the whole page. */
+const FLAT_PAGE = Object.freeze([]);
+const DsContext = createContext(null);
+const isTypeface = (v) => v in TYPEFACES;
+/**
+ * The system setting is deliberately NOT read. Warm neutrals do not invert — flipping this
+ * ink ramp against a dark ground gives muddy khaki, not a dark theme, and a dark page is
+ * not paper, it is glass. A dark theme here is a separate ramp, not a transform, and until
+ * it exists a dark system setting is answered by staying light.
+ */
+const MODE = 'light';
+export function DsProvider({ children, typefaceStore, theme = 'paper', page = 'flat', headings = 'title', density, }) {
+    const [typeface, setTypefaceState] = useState(() => {
+        const saved = typefaceStore?.read();
+        return saved && isTypeface(saved) ? saved : 'system';
+    });
+    const surface = Platform.OS === 'android' ? 'android' : 'ios';
+    const densityName = density ?? defaultDensityFor(Platform.OS);
+    const setTypeface = useCallback((next) => {
+        typefaceStore?.write(next);
+        setTypefaceState(next);
+    }, [typefaceStore]);
+    const value = useMemo(() => {
+        const colors = paletteFor(MODE, surface, theme);
+        return {
+            mode: MODE,
+            surface,
+            theme,
+            colors,
+            edge: edgeFor(MODE, surface, theme),
+            edge2: liftFor(surface, 2, theme),
+            edge3: liftFor(surface, 3, theme),
+            focusEdge: focusEdgeFor(MODE),
+            substrate: page === 'flat' ? FLAT_PAGE : substrateFor(MODE, theme),
+            lift1: liftFor(surface, 1, theme),
+            lift2: liftFor(surface, 2, theme),
+            radii: theme === 'solarium' ? solariumRadii : radii,
+            headings,
+            action: actionColorsFor(colors),
+            densityName,
+            density: DENSITIES[densityName],
+            fonts: TYPEFACES[typeface],
+            typeface,
+            setTypeface,
+        };
+    }, [surface, theme, page, headings, densityName, typeface, setTypeface]);
+    return _jsx(DsContext.Provider, { value: value, children: children });
+}
+export function useDs() {
+    const ctx = useContext(DsContext);
+    if (!ctx)
+        throw new Error('useDs must be used inside <DsProvider>');
+    return ctx;
+}
+/**
+ * **Override density for one subtree, keeping everything else the provider says.** A component's
+ * `density` prop is the host's presentation choice for that one component; wrapping it in a second
+ * `DsProvider` would also reset its theme and page. `undefined` inherits.
+ */
+export function DensityScope({ density, children }) {
+    const parent = useDs();
+    const value = useMemo(() => (density === undefined || density === parent.densityName ? parent : { ...parent, densityName: density, density: DENSITIES[density] }), [parent, density]);
+    return _jsx(DsContext.Provider, { value: value, children: children });
+}
+//# sourceMappingURL=DsProvider.js.map

package/dist/esm/tokens/DsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DsProvider.js","sourceRoot":"","sources":["../../../src/tokens/DsProvider.tsx"],"names":[],"mappings":"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"}

package/dist/esm/tokens/HueProvider.d.ts

@@ -0,0 +1,11 @@
+import { type ReactNode } from 'react';
+import { type Hue, type HueSet } from './hue';
+export declare function HueProvider({ hue, children }: {
+    hue: Hue;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The current hue's four values. The generic read — a descendant never names its own hue. */
+export declare function useHue(): HueSet & {
+    name: Hue;
+};
+//# sourceMappingURL=HueProvider.d.ts.map

package/dist/esm/tokens/HueProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HueProvider.d.ts","sourceRoot":"","sources":["../../../src/tokens/HueProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAO,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,OAAO,CAAC;AAYnD,wBAAgB,WAAW,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE/E;AAED,8FAA8F;AAC9F,wBAAgB,MAAM,IAAI,MAAM,GAAG;IAAE,IAAI,EAAE,GAAG,CAAA;CAAE,CAG/C"}

package/dist/esm/tokens/HueProvider.js

@@ -0,0 +1,22 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+import { HUE } from './hue';
+/**
+ * The hue scope — what `.h-sky` was.
+ *
+ * **`neutral` is the fallback, so a hue-reading component mounted outside any scope still
+ * renders.** Solarium's CSS makes the same choice with a `:root` default; without it the
+ * component would read `undefined` and paint nothing, which looks like a broken build rather
+ * than a missing wrapper.
+ */
+const HueContext = createContext('neutral');
+export function HueProvider({ hue, children }) {
+    return _jsx(HueContext.Provider, { value: hue, children: children });
+}
+/** The current hue's four values. The generic read — a descendant never names its own hue. */
+export function useHue() {
+    const name = useContext(HueContext);
+    return { ...HUE[name], name };
+}
+//# sourceMappingURL=HueProvider.js.map

package/dist/esm/tokens/HueProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HueProvider.js","sourceRoot":"","sources":["../../../src/tokens/HueProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,GAAG,EAAyB,MAAM,OAAO,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,aAAa,CAAM,SAAS,CAAC,CAAC;AAEjD,MAAM,UAAU,WAAW,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAqC;IAC9E,OAAO,KAAC,UAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,YAAG,QAAQ,GAAuB,CAAC;AAC3E,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,MAAM;IACpB,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/esm/tokens/contrast.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WCAG 2.1 relative luminance and contrast ratio.
+ *
+ * Lives beside the tokens rather than in the tests, because the palette is the thing being
+ * measured and a ratio computed somewhere else is a ratio that can disagree with it.
+ */
+export declare function luminance(hex: string): number;
+/** Rounded to two places, which is the precision the handoff states its own numbers in. */
+export declare function contrast(a: string, b: string): number;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/esm/tokens/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../../src/tokens/contrast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS7C;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/esm/tokens/contrast.js

@@ -0,0 +1,25 @@
+/**
+ * WCAG 2.1 relative luminance and contrast ratio.
+ *
+ * Lives beside the tokens rather than in the tests, because the palette is the thing being
+ * measured and a ratio computed somewhere else is a ratio that can disagree with it.
+ */
+function channel(v) {
+    const c = v / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+export function luminance(hex) {
+    const m = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
+    if (!m?.[1])
+        throw new Error(`Not a 6-digit hex: ${hex}`);
+    const n = parseInt(m[1], 16);
+    return (0.2126 * channel((n >> 16) & 255) +
+        0.7152 * channel((n >> 8) & 255) +
+        0.0722 * channel(n & 255));
+}
+/** Rounded to two places, which is the precision the handoff states its own numbers in. */
+export function contrast(a, b) {
+    const [x, y] = [luminance(a), luminance(b)].sort((p, q) => q - p);
+    return Math.round(((x + 0.05) / (y + 0.05)) * 100) / 100;
+}
+//# sourceMappingURL=contrast.js.map

package/dist/esm/tokens/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../../../src/tokens/contrast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,SAAS,OAAO,CAAC,CAAS;IACxB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAClB,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,CACL,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC;QACjC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QAChC,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAqB,CAAC;IACtF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC"}

package/dist/esm/tokens/glass.d.ts

@@ -0,0 +1,26 @@
+import { type ViewStyle } from 'react-native';
+/**
+ * Paper, not glass.
+ *
+ * This file used to return a translucent fill and a four-sided specular rim. Both are gone:
+ * the page is paper now, so depth is a real drop shadow plus a hairline, and every raised
+ * surface is the same white. A card tinted away from the page reads as a highlight, and
+ * once everything is highlighted nothing is.
+ *
+ * The names survive so the screens built against them keep working — that was the bet the
+ * token layer made, and it held.
+ */
+/** A raised surface: rows, cards, sheets. Radius and padding are the caller's. */
+export declare function useGlassStyle(): ViewStyle;
+/**
+ * An input. **A field is a hole in the paper, not an object on it, so it never lifts** —
+ * this returns the field edge, not a lift.
+ *
+ * `focused` darkens the hairline from 9% to 28% and nothing else: the edge IS the focus
+ * indicator, and there is no colour focus ring anywhere in this system. It has to stay
+ * visible at 200% text size.
+ */
+export declare function useFieldStyle(focused?: boolean, error?: boolean): ViewStyle;
+/** A disabled field, or an inset well. The one surface that is not white. */
+export declare function useSunkenStyle(): ViewStyle;
+//# sourceMappingURL=glass.d.ts.map

package/dist/esm/tokens/glass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass.d.ts","sourceRoot":"","sources":["../../../src/tokens/glass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C;;;;;;;;;;GAUG;AAEH,kFAAkF;AAClF,wBAAgB,aAAa,IAAI,SAAS,CAGzC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,UAAQ,EAAE,KAAK,UAAQ,GAAG,SAAS,CAMvE;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,IAAI,SAAS,CAM1C"}

package/dist/esm/tokens/glass.js

@@ -0,0 +1,43 @@
+'use client';
+import { useDs } from './DsProvider';
+import { fieldEdge } from './tokens';
+/**
+ * Paper, not glass.
+ *
+ * This file used to return a translucent fill and a four-sided specular rim. Both are gone:
+ * the page is paper now, so depth is a real drop shadow plus a hairline, and every raised
+ * surface is the same white. A card tinted away from the page reads as a highlight, and
+ * once everything is highlighted nothing is.
+ *
+ * The names survive so the screens built against them keep working — that was the bet the
+ * token layer made, and it held.
+ */
+/** A raised surface: rows, cards, sheets. Radius and padding are the caller's. */
+export function useGlassStyle() {
+    const { colors, edge } = useDs();
+    return { backgroundColor: colors.surface1, boxShadow: edge };
+}
+/**
+ * An input. **A field is a hole in the paper, not an object on it, so it never lifts** —
+ * this returns the field edge, not a lift.
+ *
+ * `focused` darkens the hairline from 9% to 28% and nothing else: the edge IS the focus
+ * indicator, and there is no colour focus ring anywhere in this system. It has to stay
+ * visible at 200% text size.
+ */
+export function useFieldStyle(focused = false, error = false) {
+    const { colors } = useDs();
+    return {
+        backgroundColor: colors.surface1,
+        boxShadow: error ? fieldEdge.error : focused ? fieldEdge.focus : fieldEdge.default,
+    };
+}
+/** A disabled field, or an inset well. The one surface that is not white. */
+export function useSunkenStyle() {
+    const { colors } = useDs();
+    return {
+        backgroundColor: colors.surfaceSunken,
+        boxShadow: 'inset 0 0 0 1px rgba(42,39,36,0.08)',
+    };
+}
+//# sourceMappingURL=glass.js.map

package/dist/esm/tokens/glass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass.js","sourceRoot":"","sources":["../../../src/tokens/glass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;;;;;;;;;GAUG;AAEH,kFAAkF;AAClF,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;IACjC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK;IAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAC3B,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,QAAQ;QAChC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO;KACnF,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAC3B,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,aAAa;QACrC,SAAS,EAAE,qCAAqC;KACjD,CAAC;AACJ,CAAC"}