@appinternalleads/ui 0.2.0

package/dist/cjs/sheets/records.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHECKLIST_TYPES = exports.CHECKLIST_LABELS = void 0;
+exports.dataRowsFromSheet = dataRowsFromSheet;
+exports.checklistFromSheet = checklistFromSheet;
+exports.sheetFromChecklist = sheetFromChecklist;
+const contract_1 = require("../components/directory/contract");
+const bind_1 = require("./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. */
+function dataRowsFromSheet(table) {
+    const clean = table.rows.filter(r => r.some(c => c.trim() !== ''));
+    const found = (0, contract_1.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. */
+exports.CHECKLIST_LABELS = { title: 'Task', section: 'Section', description: 'Description', required: 'Required', assignee: 'Assignee', done: 'Done' };
+/** The type each checklist column holds. */
+exports.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.
+ */
+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(`${exports.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 ?? bind_1.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. */
+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/cjs/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/cjs/tokens/DsProvider.js

@@ -0,0 +1,109 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TYPEFACES = exports.MONO_STACK_WEB = void 0;
+exports.DsProvider = DsProvider;
+exports.useDs = useDs;
+exports.DensityScope = DensityScope;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const tokens_1 = require("./tokens");
+const profile_1 = require("./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.
+ */
+exports.MONO_STACK_WEB = "ui-monospace, 'SF Mono', Menlo, monospace";
+const MONO = react_native_1.Platform.select({ ios: 'Menlo', android: 'monospace', web: exports.MONO_STACK_WEB, default: 'monospace' });
+exports.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: react_native_1.Platform.OS === 'android' ? undefined
+            : react_native_1.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: react_native_1.Platform.OS === 'android' ? 'serif' : 'Georgia',
+        mono: MONO,
+    },
+};
+/** No layers, so `useSubstrateStyle`'s `backgroundColor` is the whole page. */
+const FLAT_PAGE = Object.freeze([]);
+const DsContext = (0, react_1.createContext)(null);
+const isTypeface = (v) => v in exports.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';
+function DsProvider({ children, typefaceStore, theme = 'paper', page = 'flat', headings = 'title', density, }) {
+    const [typeface, setTypefaceState] = (0, react_1.useState)(() => {
+        const saved = typefaceStore?.read();
+        return saved && isTypeface(saved) ? saved : 'system';
+    });
+    const surface = react_native_1.Platform.OS === 'android' ? 'android' : 'ios';
+    const densityName = density ?? (0, profile_1.defaultDensityFor)(react_native_1.Platform.OS);
+    const setTypeface = (0, react_1.useCallback)((next) => {
+        typefaceStore?.write(next);
+        setTypefaceState(next);
+    }, [typefaceStore]);
+    const value = (0, react_1.useMemo)(() => {
+        const colors = (0, tokens_1.paletteFor)(MODE, surface, theme);
+        return {
+            mode: MODE,
+            surface,
+            theme,
+            colors,
+            edge: (0, tokens_1.edgeFor)(MODE, surface, theme),
+            edge2: (0, tokens_1.liftFor)(surface, 2, theme),
+            edge3: (0, tokens_1.liftFor)(surface, 3, theme),
+            focusEdge: (0, tokens_1.focusEdgeFor)(MODE),
+            substrate: page === 'flat' ? FLAT_PAGE : (0, tokens_1.substrateFor)(MODE, theme),
+            lift1: (0, tokens_1.liftFor)(surface, 1, theme),
+            lift2: (0, tokens_1.liftFor)(surface, 2, theme),
+            radii: theme === 'solarium' ? tokens_1.solariumRadii : tokens_1.radii,
+            headings,
+            action: (0, profile_1.actionColorsFor)(colors),
+            densityName,
+            density: profile_1.DENSITIES[densityName],
+            fonts: exports.TYPEFACES[typeface],
+            typeface,
+            setTypeface,
+        };
+    }, [surface, theme, page, headings, densityName, typeface, setTypeface]);
+    return (0, jsx_runtime_1.jsx)(DsContext.Provider, { value: value, children: children });
+}
+function useDs() {
+    const ctx = (0, react_1.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.
+ */
+function DensityScope({ density, children }) {
+    const parent = useDs();
+    const value = (0, react_1.useMemo)(() => (density === undefined || density === parent.densityName ? parent : { ...parent, densityName: density, density: profile_1.DENSITIES[density] }), [parent, density]);
+    return (0, jsx_runtime_1.jsx)(DsContext.Provider, { value: value, children: children });
+}
+//# sourceMappingURL=DsProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DsProvider.js","sourceRoot":"","sources":["../../../src/tokens/DsProvider.tsx"],"names":[],"mappings":";;;AA6KA,gCAuFC;AAED,sBAIC;AAOD,oCAOC;;AAxRD,iCAAyF;AACzF,+CAAmE;AACnE,qCAYkB;AAClB,uCAOmB;AA6BnB;;;;GAIG;AACU,QAAA,cAAc,GAAG,2CAA2C,CAAC;AAC1E,MAAM,IAAI,GAAG,uBAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,sBAAc,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AAEnG,QAAA,SAAS,GAAmC;IACvD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,mDAAmD;QACzD,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;KACX;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,sEAAsE;QAC5E;;6FAEqF;QACrF,IAAI,EAAE,uBAAQ,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;YACzC,CAAC,CAAC,uBAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,qEAAqE;gBAC/F,CAAC,CAAC,aAAa;QACjB,IAAI,EAAE,IAAI;KACX;IACD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,gDAAgD;QACtD,IAAI,EAAE,uBAAQ,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACrD,IAAI,EAAE,IAAI;KACX;CACF,CAAC;AA2DF,+EAA+E;AAC/E,MAAM,SAAS,GAAoC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAErE,MAAM,SAAS,GAAG,IAAA,qBAAa,EAAY,IAAI,CAAC,CAAC;AAEjD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAqB,EAAE,CAAC,CAAC,IAAI,iBAAS,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,IAAI,GAAS,OAAO,CAAC;AAkB3B,SAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,aAAa,EACb,KAAK,GAAG,OAAO,EACf,IAAI,GAAG,MAAM,EACb,QAAQ,GAAG,OAAO,EAClB,OAAO,GAqCR;IACC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,IAAA,gBAAQ,EAAe,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAG,aAAa,EAAE,IAAI,EAAE,CAAC;QACpC,OAAO,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAY,uBAAQ,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAEvE,MAAM,WAAW,GAAG,OAAO,IAAI,IAAA,2BAAiB,EAAC,uBAAQ,CAAC,EAAE,CAAC,CAAC;IAE9D,MAAM,WAAW,GAAG,IAAA,mBAAW,EAC7B,CAAC,IAAkB,EAAE,EAAE;QACrB,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,EACD,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,MAAM,KAAK,GAAG,IAAA,eAAO,EAAK,GAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO;YACP,KAAK;YACL,MAAM;YACN,IAAI,EAAE,IAAA,gBAAO,EAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;YACnC,KAAK,EAAE,IAAA,gBAAO,EAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC;YACjC,KAAK,EAAE,IAAA,gBAAO,EAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC;YACjC,SAAS,EAAE,IAAA,qBAAY,EAAC,IAAI,CAAC;YAC7B,SAAS,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,qBAAY,EAAC,IAAI,EAAE,KAAK,CAAC;YAClE,KAAK,EAAE,IAAA,gBAAO,EAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC;YACjC,KAAK,EAAE,IAAA,gBAAO,EAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC;YACjC,KAAK,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,sBAAa,CAAC,CAAC,CAAC,cAAK;YACnD,QAAQ;YACR,MAAM,EAAE,IAAA,yBAAe,EAAC,MAAM,CAAC;YAC/B,WAAW;YACX,OAAO,EAAE,mBAAS,CAAC,WAAW,CAAC;YAC/B,KAAK,EAAE,iBAAS,CAAC,QAAQ,CAAC;YAC1B,QAAQ;YACR,WAAW;SACZ,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAEzE,OAAO,uBAAC,SAAS,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAsB,CAAC;AAC3E,CAAC;AAED,SAAgB,KAAK;IACnB,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAwD;IACtG,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,IAAA,eAAO,EACnB,GAAG,EAAE,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAC3I,CAAC,MAAM,EAAE,OAAO,CAAC,CAClB,CAAC;IACF,OAAO,uBAAC,SAAS,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAsB,CAAC;AAC3E,CAAC"}

package/dist/cjs/tokens/HueProvider.js

@@ -0,0 +1,26 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HueProvider = HueProvider;
+exports.useHue = useHue;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const hue_1 = require("./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 = (0, react_1.createContext)('neutral');
+function HueProvider({ hue, children }) {
+    return (0, jsx_runtime_1.jsx)(HueContext.Provider, { value: hue, children: children });
+}
+/** The current hue's four values. The generic read — a descendant never names its own hue. */
+function useHue() {
+    const name = (0, react_1.useContext)(HueContext);
+    return { ...hue_1.HUE[name], name };
+}
+//# sourceMappingURL=HueProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HueProvider.js","sourceRoot":"","sources":["../../../src/tokens/HueProvider.tsx"],"names":[],"mappings":";;AAaA,kCAEC;AAGD,wBAGC;;AArBD,iCAAkE;AAClE,+BAAmD;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,IAAA,qBAAa,EAAM,SAAS,CAAC,CAAC;AAEjD,SAAgB,WAAW,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAqC;IAC9E,OAAO,uBAAC,UAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,YAAG,QAAQ,GAAuB,CAAC;AAC3E,CAAC;AAED,8FAA8F;AAC9F,SAAgB,MAAM;IACpB,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,SAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/cjs/tokens/contrast.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.luminance = luminance;
+exports.contrast = contrast;
+function channel(v) {
+    const c = v / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+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. */
+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/cjs/tokens/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../../../src/tokens/contrast.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAOH,8BASC;AAGD,4BAGC;AApBD,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,SAAgB,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,SAAgB,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/cjs/tokens/glass.js

@@ -0,0 +1,48 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGlassStyle = useGlassStyle;
+exports.useFieldStyle = useFieldStyle;
+exports.useSunkenStyle = useSunkenStyle;
+const DsProvider_1 = require("./DsProvider");
+const tokens_1 = require("./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. */
+function useGlassStyle() {
+    const { colors, edge } = (0, DsProvider_1.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.
+ */
+function useFieldStyle(focused = false, error = false) {
+    const { colors } = (0, DsProvider_1.useDs)();
+    return {
+        backgroundColor: colors.surface1,
+        boxShadow: error ? tokens_1.fieldEdge.error : focused ? tokens_1.fieldEdge.focus : tokens_1.fieldEdge.default,
+    };
+}
+/** A disabled field, or an inset well. The one surface that is not white. */
+function useSunkenStyle() {
+    const { colors } = (0, DsProvider_1.useDs)();
+    return {
+        backgroundColor: colors.surfaceSunken,
+        boxShadow: 'inset 0 0 0 1px rgba(42,39,36,0.08)',
+    };
+}
+//# sourceMappingURL=glass.js.map

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

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

package/dist/cjs/tokens/hue.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * **Solarium's hue system — six families, four values each.**
+ *
+ * Its own README calls the two-line recipe "the whole system": a class sets four CSS variables
+ * on a container and every descendant reads *the current hue* generically.
+ *
+ * ```
+ * .h-sky   sets  --h  --hd  --hs  --on
+ * .tile         background var(--hs), color var(--hd)   resting
+ * .tile.on      background var(--h),  color var(--on)   active
+ * ```
+ *
+ * **React Native has no cascade, so the container becomes a provider and `var(--h)` becomes
+ * `useHue()`.** That is the translation SPEC §3.1 accepted as the cost of one core, and it is the
+ * part the token port could not carry — `tokens.ts` holds solarium's individual hues, but a hue
+ * is only a system when a descendant can read it without being told which one it is in.
+ *
+ * **Hue means CATEGORY, never state.** Success and warning are mint and apricot and live outside
+ * this system entirely — a category that turns green because something succeeded has stopped
+ * being a category.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATA_TYPES = exports.TYPE_HUE = exports.DESTINATION_HUE = exports.HUE = exports.HUES = void 0;
+exports.hueForType = hueForType;
+exports.HUES = ['coral', 'butter', 'clay', 'sky', 'lilac', 'neutral'];
+exports.HUE = {
+    coral: { h: '#C1552C', hd: '#A8461F', hs: '#F6E3D7', on: '#FFFFFF' },
+    /**
+     * **Butter is the exception: its `on` is a dark brown, not white.** White on `#E9B949` is
+     * unreadable, and a system that returned `#fff` here uniformly would be wrong exactly once —
+     * which is the hardest kind of wrong to notice.
+     */
+    butter: { h: '#E9B949', hd: '#7D5F14', hs: '#FAF0D2', on: '#4D3B0B' },
+    clay: { h: '#D98E73', hd: '#96502F', hs: '#F9E8E0', on: '#FFFFFF' },
+    sky: { h: '#6E9FC4', hd: '#39648A', hs: '#E6EEF5', on: '#FFFFFF' },
+    lilac: { h: '#9C8FD0', hd: '#5F5099', hs: '#EEEBF7', on: '#FFFFFF' },
+    neutral: { h: '#B9B7AD', hd: '#6B6D63', hs: '#F1EFE7', on: '#FFFFFF' },
+};
+/**
+ * **Fixed assignments. A category keeps its hue across the entire product.**
+ *
+ * Never picked for visual balance on a given screen — that is what makes the colour mean
+ * something rather than decorate something.
+ */
+exports.DESTINATION_HUE = {
+    Chat: 'butter',
+    'Work Canvas': 'coral',
+    Automations: 'lilac',
+    'My Emails': 'lilac',
+    'My Designs': 'sky',
+    Playground: 'sky',
+    Dashboards: 'clay',
+    Settings: 'neutral',
+};
+/**
+ * **Data and block types, each to its hue — all ten, transcribed from
+ * `solarium/src/components/ui/hue.ts`.** This held only `schedule` and `date` until the Building
+ * Blocks handoff (2026-09-23), whose `threshold-flow/1` schema resolves a component's hue from a
+ * `type` in exactly this set.
+ *
+ * **`action` is coral, and that is not the same thing as `kind.action` being butter.** The
+ * handoff listed this as open; Solarium's own source answers it. `kind.action` is a KeyShort
+ * shortcut kind drawn in the lightning tile's butter — a different vocabulary that happens to
+ * share a word. A `type: 'action'` block is the primary-action category, and coral is the hue
+ * Solarium reserves for that.
+ */
+exports.TYPE_HUE = {
+    schedule: 'butter',
+    date: 'butter',
+    action: 'coral',
+    automation: 'lilac',
+    email: 'lilac',
+    agent: 'lilac',
+    file: 'sky',
+    design: 'sky',
+    data: 'clay',
+    unclassified: 'neutral',
+};
+exports.DATA_TYPES = Object.keys(exports.TYPE_HUE);
+/**
+ * A block's hue: from its `type`, with `hue` as an explicit override.
+ *
+ * The override is allowed and warned about, as the schema says — a category repainted for one
+ * screen is a category that no longer means anything, so a disagreement is surfaced in
+ * development rather than silently honoured. No `type` and no `hue` is `neutral`, the same
+ * fallback `HueProvider` uses.
+ */
+/* Guarded: a web bundle with no `process` shim must not throw on a colour lookup. */
+function isProduction() {
+    return typeof process !== 'undefined' && process.env?.NODE_ENV === 'production';
+}
+function hueForType(type, hue) {
+    const fromType = type ? exports.TYPE_HUE[type] : undefined;
+    if (hue && fromType && hue !== fromType && !isProduction()) {
+        console.warn(`[solarium] hue "${hue}" overrides TYPE_HUE.${type} ("${fromType}").`);
+    }
+    return hue ?? fromType ?? 'neutral';
+}
+//# sourceMappingURL=hue.js.map

package/dist/cjs/tokens/hue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hue.js","sourceRoot":"","sources":["../../../src/tokens/hue.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAgFH,gCAMC;AApFY,QAAA,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAMvE,QAAA,GAAG,GAAwB;IACtC,KAAK,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IACpE;;;;OAIG;IACH,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IACrE,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IACnE,GAAG,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IAClE,KAAK,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IACpE,OAAO,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;CACvE,CAAC;AAEF;;;;;GAKG;AACU,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,QAAQ;IACd,aAAa,EAAE,OAAO;IACtB,WAAW,EAAE,OAAO;IACpB,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,SAAS;CACmB,CAAC;AAEzC;;;;;;;;;;;GAWG;AACU,QAAA,QAAQ,GAAG;IACtB,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,OAAO;IACf,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,SAAS;CACe,CAAC;AAG5B,QAAA,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAQ,CAAe,CAAC;AAE9D;;;;;;;GAOG;AACH,qFAAqF;AACrF,SAAS,YAAY;IACnB,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAC;AAClF,CAAC;AAED,SAAgB,UAAU,CAAC,IAAe,EAAE,GAAS;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,IAAI,GAAG,IAAI,QAAQ,IAAI,GAAG,KAAK,QAAQ,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,mBAAmB,GAAG,wBAAwB,IAAI,MAAM,QAAQ,KAAK,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,GAAG,IAAI,QAAQ,IAAI,SAAS,CAAC;AACtC,CAAC"}

package/dist/cjs/tokens/index.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultDensityFor = exports.DENSITIES = exports.actionColorsFor = exports.motionFor = exports.OUTPUT_MOTION_TIMINGS = exports.MOTION = exports.DATA_REVEAL = exports.useHue = exports.HueProvider = exports.hueForType = exports.DATA_TYPES = exports.TYPE_HUE = exports.DESTINATION_HUE = exports.HUES = exports.HUE = exports.luminance = exports.contrast = exports.useSunkenStyle = exports.useGlassStyle = exports.useFieldStyle = exports.TYPEFACES = exports.useDs = exports.DsProvider = exports.DensityScope = void 0;
+/**
+ * The token layer, ported verbatim from `canvas-app/packages/ds` — the canonical copy.
+ *
+ * **This directory holds the only hex literals in the package.** Everything else references a
+ * token by name, and the ESLint rule in §9 of SPEC.md makes that checkable rather than
+ * aspirational. If you are about to write a colour anywhere else, you want a token instead.
+ */
+__exportStar(require("./tokens"), exports);
+var DsProvider_1 = require("./DsProvider");
+Object.defineProperty(exports, "DensityScope", { enumerable: true, get: function () { return DsProvider_1.DensityScope; } });
+Object.defineProperty(exports, "DsProvider", { enumerable: true, get: function () { return DsProvider_1.DsProvider; } });
+Object.defineProperty(exports, "useDs", { enumerable: true, get: function () { return DsProvider_1.useDs; } });
+Object.defineProperty(exports, "TYPEFACES", { enumerable: true, get: function () { return DsProvider_1.TYPEFACES; } });
+var glass_1 = require("./glass");
+Object.defineProperty(exports, "useFieldStyle", { enumerable: true, get: function () { return glass_1.useFieldStyle; } });
+Object.defineProperty(exports, "useGlassStyle", { enumerable: true, get: function () { return glass_1.useGlassStyle; } });
+Object.defineProperty(exports, "useSunkenStyle", { enumerable: true, get: function () { return glass_1.useSunkenStyle; } });
+var contrast_1 = require("./contrast");
+Object.defineProperty(exports, "contrast", { enumerable: true, get: function () { return contrast_1.contrast; } });
+Object.defineProperty(exports, "luminance", { enumerable: true, get: function () { return contrast_1.luminance; } });
+var hue_1 = require("./hue");
+Object.defineProperty(exports, "HUE", { enumerable: true, get: function () { return hue_1.HUE; } });
+Object.defineProperty(exports, "HUES", { enumerable: true, get: function () { return hue_1.HUES; } });
+Object.defineProperty(exports, "DESTINATION_HUE", { enumerable: true, get: function () { return hue_1.DESTINATION_HUE; } });
+Object.defineProperty(exports, "TYPE_HUE", { enumerable: true, get: function () { return hue_1.TYPE_HUE; } });
+Object.defineProperty(exports, "DATA_TYPES", { enumerable: true, get: function () { return hue_1.DATA_TYPES; } });
+Object.defineProperty(exports, "hueForType", { enumerable: true, get: function () { return hue_1.hueForType; } });
+var HueProvider_1 = require("./HueProvider");
+Object.defineProperty(exports, "HueProvider", { enumerable: true, get: function () { return HueProvider_1.HueProvider; } });
+Object.defineProperty(exports, "useHue", { enumerable: true, get: function () { return HueProvider_1.useHue; } });
+var profile_1 = require("./profile");
+Object.defineProperty(exports, "DATA_REVEAL", { enumerable: true, get: function () { return profile_1.DATA_REVEAL; } });
+Object.defineProperty(exports, "MOTION", { enumerable: true, get: function () { return profile_1.MOTION; } });
+Object.defineProperty(exports, "OUTPUT_MOTION_TIMINGS", { enumerable: true, get: function () { return profile_1.OUTPUT_MOTION_TIMINGS; } });
+Object.defineProperty(exports, "motionFor", { enumerable: true, get: function () { return profile_1.motionFor; } });
+Object.defineProperty(exports, "actionColorsFor", { enumerable: true, get: function () { return profile_1.actionColorsFor; } });
+Object.defineProperty(exports, "DENSITIES", { enumerable: true, get: function () { return profile_1.DENSITIES; } });
+Object.defineProperty(exports, "defaultDensityFor", { enumerable: true, get: function () { return profile_1.defaultDensityFor; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/tokens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tokens/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,2CAAyB;AACzB,2CAGsB;AAFpB,0GAAA,YAAY,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,mGAAA,KAAK,OAAA;AAAE,uGAAA,SAAS,OAAA;AAG5C,iCAAuE;AAA9D,sGAAA,aAAa,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,uGAAA,cAAc,OAAA;AACrD,uCAAiD;AAAxC,oGAAA,QAAQ,OAAA;AAAE,qGAAA,SAAS,OAAA;AAC5B,6BAA2H;AAAlH,0FAAA,GAAG,OAAA;AAAE,2FAAA,IAAI,OAAA;AAAE,sGAAA,eAAe,OAAA;AAAE,+FAAA,QAAQ,OAAA;AAAE,iGAAA,UAAU,OAAA;AAAE,iGAAA,UAAU,OAAA;AACrE,6CAAoD;AAA3C,0GAAA,WAAW,OAAA;AAAE,qGAAA,MAAM,OAAA;AAC5B,qCAGmB;AAFjB,sGAAA,WAAW,OAAA;AAAE,iGAAA,MAAM,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,4GAAA,iBAAiB,OAAA"}