@sigx/lynx-zero 0.4.9

package/dist/theme/use-theme-colors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `useThemeColors()` — resolve the *active, scoped* theme palette to concrete
+ * color values for consumers that can't read CSS custom properties.
+ *
+ * Native widgets are the audience: platform text inputs, `<sigx-richtext>`,
+ * SVG fills — anything where `var(--color-*)` never resolves because the
+ * value is consumed outside Lynx's CSS pipeline. Components pass these
+ * resolved literals via inline `style` or native props instead.
+ *
+ * Scoped + reactive: resolves through `useTheme()` (the nearest
+ * `<ThemeProvider>`'s controller, falling back to the global one), and the
+ * getters read `theme.name` — call them inside render and a theme switch
+ * recolors the consumer.
+ *
+ * ```tsx
+ * const colors = useThemeColors();
+ * return () => (
+ *   <input style={{
+ *     color: colors.colorOf('base-content'),
+ *     '-x-placeholder-color': colors.colorOf('base-content', 0.45),
+ *   }} />
+ * );
+ * ```
+ */
+import type { ColorToken } from '../contract.js';
+export interface ThemeColors {
+    /**
+     * The active palette's value for `token`, normalized to hex — optionally
+     * with `alpha` (0–1) appended as a hex byte (`#RRGGBBAA`). Returns `''`
+     * when no theme is registered yet (pre-DS-import edge case).
+     */
+    colorOf(token: ColorToken, alpha?: number): string;
+}
+export declare function useThemeColors(): ThemeColors;
+/**
+ * Normalize an engine-safe palette color to full-form hex
+ * (`#RRGGBB`/`#RRGGBBAA`) — the registry allows `rgb()`/`rgba()` entries and
+ * shorthand hex, but native color parsers may accept only the full forms.
+ * Unknown notations pass through unchanged.
+ */
+export declare function toHexColor(color: string): string;
+/**
+ * Append an alpha channel (0–1) to a hex color
+ * (`#RGB`/`#RRGGBB`/`#RRGGBBAA` → `#RRGGBBAA`). Non-hex input passes
+ * through unchanged; non-finite alpha is treated as opaque.
+ */
+export declare function withAlpha(hex: string, alpha: number): string;
+//# sourceMappingURL=use-theme-colors.d.ts.map

package/dist/theme/use-theme-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme-colors.d.ts","sourceRoot":"","sources":["../../src/theme/use-theme-colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACpD;AAED,wBAAgB,cAAc,IAAI,WAAW,CAY5C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBhD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAc5D"}

package/dist/theme/use-theme-colors.js

@@ -0,0 +1,69 @@
+import { colorsOf, fallbackPalette } from './registry.js';
+import { useTheme } from './ThemeProvider.js';
+export function useThemeColors() {
+    const theme = useTheme();
+    return {
+        colorOf(token, alpha) {
+            // Reading `theme.name` here is what makes call sites reactive.
+            const palette = colorsOf(theme.name) ?? fallbackPalette();
+            const raw = palette?.[token];
+            if (!raw)
+                return '';
+            const hex = toHexColor(raw);
+            return alpha === undefined ? hex : withAlpha(hex, alpha);
+        },
+    };
+}
+/**
+ * Normalize an engine-safe palette color to full-form hex
+ * (`#RRGGBB`/`#RRGGBBAA`) — the registry allows `rgb()`/`rgba()` entries and
+ * shorthand hex, but native color parsers may accept only the full forms.
+ * Unknown notations pass through unchanged.
+ */
+export function toHexColor(color) {
+    const c = color.trim();
+    if (c.startsWith('#')) {
+        const h = c.slice(1);
+        // Expand #RGB / #RGBA to the full form; leave other lengths as-is.
+        if (h.length === 3 || h.length === 4) {
+            return `#${h.split('').map((ch) => ch + ch).join('')}`;
+        }
+        return c;
+    }
+    const m = /^rgba?\(\s*(\d+)\s*[, ]\s*(\d+)\s*[, ]\s*(\d+)\s*(?:[,/]\s*([\d.]+%?)\s*)?\)$/i.exec(c);
+    if (!m)
+        return c;
+    const byte = (v) => Math.max(0, Math.min(255, Math.round(v))).toString(16).padStart(2, '0');
+    let hex = `#${byte(Number(m[1]))}${byte(Number(m[2]))}${byte(Number(m[3]))}`;
+    if (m[4] !== undefined) {
+        const a = m[4].endsWith('%') ? Number(m[4].slice(0, -1)) / 100 : Number(m[4]);
+        hex += byte(Math.max(0, Math.min(1, a)) * 255);
+    }
+    return hex;
+}
+/**
+ * Append an alpha channel (0–1) to a hex color
+ * (`#RGB`/`#RRGGBB`/`#RRGGBBAA` → `#RRGGBBAA`). Non-hex input passes
+ * through unchanged; non-finite alpha is treated as opaque.
+ */
+export function withAlpha(hex, alpha) {
+    const input = hex.trim();
+    if (!input.startsWith('#'))
+        return input;
+    if (!Number.isFinite(alpha))
+        return input;
+    let h = input.slice(1);
+    if (h.length === 3)
+        h = h.split('').map((c) => c + c).join('');
+    if (h.length === 8)
+        h = h.slice(0, 6);
+    // Anything that isn't #RRGGBB by now (#RGBA, bad lengths) is not a shape
+    // we can safely re-alpha — return it unchanged rather than corrupt it.
+    if (h.length !== 6)
+        return input;
+    const byte = Math.round(Math.max(0, Math.min(1, alpha)) * 255)
+        .toString(16)
+        .padStart(2, '0');
+    return `#${h}${byte}`;
+}
+//# sourceMappingURL=use-theme-colors.js.map

package/dist/theme/use-theme-colors.js.map

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

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@sigx/lynx-zero",
+  "version": "0.4.9",
+  "description": "Design-system-neutral UI foundation for sigx-lynx — the shared props/token contract and style utilities that design-system packages (daisyui, heroui, …) build on",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./screen-theme": {
+      "types": "./dist/theme/use-screen-theme.d.ts",
+      "import": "./dist/theme/use-screen-theme.js"
+    },
+    "./preset": {
+      "types": "./dist/preset/index.d.ts",
+      "import": "./dist/preset/index.js",
+      "default": "./dist/preset/index.js"
+    },
+    "./styles/tokens.css": "./dist/styles/tokens.css"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "keywords": [
+    "sigx",
+    "lynx",
+    "ui",
+    "design-system",
+    "headless",
+    "tokens"
+  ],
+  "author": "Andreas Ekdahl",
+  "license": "MIT",
+  "dependencies": {
+    "@sigx/lynx": "^0.4.9",
+    "@sigx/lynx-motion": "^0.4.9",
+    "@sigx/lynx-appearance": "^0.4.9",
+    "@sigx/lynx-gestures": "^0.4.9"
+  },
+  "peerDependencies": {
+    "tailwindcss": "^3.0.0 || ^4.0.0",
+    "@sigx/lynx-navigation": "^0.4.9"
+  },
+  "peerDependenciesMeta": {
+    "@sigx/lynx-navigation": {
+      "optional": true
+    },
+    "tailwindcss": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@typescript/native-preview": "7.0.0-dev.20260521.1",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^6.0.3",
+    "@sigx/lynx-navigation": "^0.4.9",
+    "@sigx/lynx-testing": "^0.4.9"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/signalxjs/lynx.git",
+    "directory": "packages/lynx-zero"
+  },
+  "homepage": "https://github.com/signalxjs/lynx/tree/main/packages/lynx-zero",
+  "bugs": {
+    "url": "https://github.com/signalxjs/lynx/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node ../../scripts/clean.mjs dist && tsgo && node ../../scripts/copy-assets.mjs src/styles dist/styles",
+    "dev": "tsgo --watch",
+    "clean": "node ../../scripts/clean.mjs dist .turbo"
+  }
+}