@nxds/core 0.7.2 → 0.9.0

package/README.md

@@ -1,6 +1,6 @@
 # @nxds/core
 
-The framework-agnostic engine behind Nexus Appearance: appearance model, runtime theme derivation, and first-paint snapshots. Use it directly for non-React targets like Electron, React Native, or native shells, or via `@nxds/react/appearance` in React apps. It also contains the design tokens in DTCG format and CSS generation documented below.
+The framework-agnostic engine behind nxds Appearance: appearance model, runtime theme derivation, and first-paint snapshots. Use it directly for non-React targets like Electron, React Native, or native shells, or via `@nxds/react/appearance` in React apps. It also contains the design tokens in DTCG format and CSS generation documented below.
 
 ## Install
 
@@ -10,17 +10,17 @@ pnpm add @nxds/core
 
 ## Primary Exports
 
-- `DEFAULT_NEXUS_APPEARANCE`, `sanitizeNexusAppearance`, `NexusAppearanceState`: the appearance model.
+- `DEFAULT_NXDS_APPEARANCE`, `sanitizeNxdsAppearance`, `NxdsAppearanceState`: the appearance model.
 - `BRAND_COLOR_PRESETS`, `BrandColorPreset`, `findBrandColorPreset`, `DEFAULT_BRAND_COLOR`: brand color choices for appearance editors. Default is `DEFAULT_BRAND_COLOR`; Indigo, Blue, Violet, Rose, Orange, Amber, Green, and Teal use each family's authored 600 hex. Assign a preset's `color` to `brandColor`; `findBrandColorPreset(brandColor)` returns the preset an opaque saved color matches in any CSS notation the engine parses (`#4F46E5`, `4f46e5`, `rgb(79 70 229)`), ignoring surrounding whitespace, or `undefined` for a custom or unparseable color.
-- `createNexusThemeContract`, `deriveTheme`, `themeToCss`: derive a full token set from appearance state and render it to CSS.
+- `createNxdsThemeContract`, `deriveTheme`, `themeToCss`: derive a full token set from appearance state and render it to CSS.
 - `measureThemeContrast`, `ThemeContrastCheck`, `Mode`, `Tier`: measure a derived theme against every registered APCA pair. See [Contrast report](#contrast-report).
-- `createNexusAppearanceSnapshotFromState`, `createNexusAppearanceBootstrapScript`, `resolveFirstPaint`, `DEFAULT_STORAGE_KEY`: first-paint, no-flash bootstrap.
+- `createNxdsAppearanceSnapshotFromState`, `createNxdsAppearanceBootstrapScript`, `resolveFirstPaint`, `DEFAULT_STORAGE_KEY`: first-paint, no-flash bootstrap.
 
 ## Advanced / Engine Exports
 
 `adjustContrast`, `PALETTE_KEYS`, `TIER_THRESHOLDS`, `isColor`: low-level palette and contrast utilities. Stability is not guaranteed pre-1.0.
 
-See the Nexus docs, Theming -> Appearance, for setup recipes.
+See the nxds docs, Theming -> Appearance, for setup recipes.
 
 ## Contrast report
 
@@ -28,14 +28,14 @@ See the Nexus docs, Theming -> Appearance, for setup recipes.
 
 ```ts
 import {
-  createNexusThemeContract,
-  DEFAULT_NEXUS_APPEARANCE,
+  createNxdsThemeContract,
+  DEFAULT_NXDS_APPEARANCE,
   deriveTheme,
   measureThemeContrast,
 } from '@nxds/core';
 
 const checks = measureThemeContrast(
-  deriveTheme(createNexusThemeContract(DEFAULT_NEXUS_APPEARANCE))
+  deriveTheme(createNxdsThemeContract(DEFAULT_NXDS_APPEARANCE))
 );
 const failing = checks.filter((check) => !check.pass);
 ```
@@ -77,20 +77,20 @@ Use the engine directly when a host shell owns DOM or native styling.
 
 ```ts
 import {
-  createNexusAppearanceSnapshotFromState,
-  createNexusThemeContract,
-  DEFAULT_NEXUS_APPEARANCE,
+  createNxdsAppearanceSnapshotFromState,
+  createNxdsThemeContract,
+  DEFAULT_NXDS_APPEARANCE,
   deriveTheme,
   resolveFirstPaint,
   themeToCss,
 } from '@nxds/core';
 
 const state = {
-  ...DEFAULT_NEXUS_APPEARANCE,
+  ...DEFAULT_NXDS_APPEARANCE,
   brandColor: '#2563eb',
   surfaceTone: 'slate',
 };
-const snapshot = createNexusAppearanceSnapshotFromState(state);
+const snapshot = createNxdsAppearanceSnapshotFromState(state);
 const firstPaint = resolveFirstPaint(snapshot, false);
 const themeStyle =
   document.querySelector<HTMLStyleElement>('style[data-theme]') ??
@@ -102,7 +102,7 @@ document.documentElement.classList.toggle(
   firstPaint.className === 'dark'
 );
 themeStyle.textContent = themeToCss(
-  deriveTheme(createNexusThemeContract(snapshot.state))
+  deriveTheme(createNxdsThemeContract(snapshot.state))
 );
 ```
 
@@ -155,7 +155,7 @@ Generated global CSS sets the native browser UI policy alongside the tokens: `:r
 ## Reference Resolution
 
 Semantic **color** is produced by the engine (`deriveTheme`), not authored as
-JSON. The build bakes each derived value into `nexus.css` as a `@theme inline`
+JSON. The build bakes each derived value into `nxds.css` as a `@theme inline`
 fallback that still accepts a runtime override:
 
 ```css
@@ -178,7 +178,7 @@ pnpm tokens:tailwind      # From the repo root: build core and generate @nxds/ta
 
 ### Output Files
 
-- `../tailwind/nexus.css` - Main Tailwind theme with `nx:` prefix
+- `../tailwind/nxds.css` - Main Tailwind theme with `nx:` prefix
 - `../tailwind/variables.css` - Primitive CSS variables with `--nx-*` prefix
 
 ## Future Platform Support

package/dist/runtime/catalogue.cjs

@@ -1107,7 +1107,7 @@ var STROKE_OPTIONS = [
   { value: "normal", label: "Normal" },
   { value: "strong", label: "Strong" }
 ];
-var DEFAULT_NEXUS_APPEARANCE = {
+var DEFAULT_NXDS_APPEARANCE = {
   mode: "light",
   brandColor: DEFAULT_BRAND_COLOR,
   surfaceTone: "zinc",
@@ -1142,7 +1142,7 @@ var ELEVATIONS = new Set(
 var STROKES = new Set(
   STROKE_OPTIONS.map((option) => option.value)
 );
-function createNexusThemeContract(state) {
+function createNxdsThemeContract(state) {
   const tone = BASE_TONE_SEEDS[state.surfaceTone];
   return {
     surfaceTone: state.surfaceTone,
@@ -8820,7 +8820,7 @@ var shadow_strong_light_default = {
 
 // tokens/semantic/breakpoints.json
 var breakpoints_default = {
-  $description: "Responsive breakpoints (rem). Values match Tailwind v4's own defaults exactly \u2014 Nexus declares them explicitly so they fall under the same reset-and-own discipline as every other namespace (color/spacing/radius/shadow) instead of being inherited implicitly. Tailwind v4 auto-discovers --breakpoint-* from @theme and uses them to generate the nx:sm:\u2026nx:2xl: responsive variants. Override at BUILD TIME by re-declaring a value in a consumer @theme block \u2014 NOT at runtime: @media cannot read var(), so Tailwind bakes the resolved value into the generated media queries at build time.",
+  $description: "Responsive breakpoints (rem). Values match Tailwind v4's own defaults exactly \u2014 nxds declares them explicitly so they fall under the same reset-and-own discipline as every other namespace (color/spacing/radius/shadow) instead of being inherited implicitly. Tailwind v4 auto-discovers --breakpoint-* from @theme and uses them to generate the nx:sm:\u2026nx:2xl: responsive variants. Override at BUILD TIME by re-declaring a value in a consumer @theme block \u2014 NOT at runtime: @media cannot read var(), so Tailwind bakes the resolved value into the generated media queries at build time.",
   "breakpoint-sm": {
     $value: {
       value: 40,
@@ -11167,8 +11167,8 @@ function styleLeaves(family, file) {
 }
 function runtimeAppearance(mode) {
   return {
-    ...DEFAULT_NEXUS_APPEARANCE,
-    prefs: { ...DEFAULT_NEXUS_APPEARANCE.prefs },
+    ...DEFAULT_NXDS_APPEARANCE,
+    prefs: { ...DEFAULT_NXDS_APPEARANCE.prefs },
     mode
   };
 }
@@ -11186,7 +11186,7 @@ function runtimeColorTokens() {
     return {
       mode,
       appearance,
-      values: deriveThemeMode(createNexusThemeContract(appearance), mode)
+      values: deriveThemeMode(createNxdsThemeContract(appearance), mode)
     };
   });
   return SEMANTIC_TOKEN_REGISTRY.map(({ name, category }) => {