@cdx-ui/styles 0.0.1-beta.30 → 0.0.1-beta.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +6 -7
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -72,7 +72,7 @@ import { useCdxFonts } from '@cdx-ui/styles';
72
72
 
73
73
  - `useCdxFonts` — Hook that loads all preset display fonts (nine families, three per preset) plus platform web fonts (Inter, IBM Plex Mono) via `expo-font`. Returns `{ loaded: boolean; error: Error | null }`. Call in your root layout and gate rendering on the returned `loaded` boolean. See [Getting Started](../../docs/getting-started.md) for usage.
74
74
  - `ThemeMetadata` — metadata stored under `$extensions.com.candescent.theme` (name, preset, schema version).
75
- - `ThemeOverrideMetadata` — metadata for FI overrides under `$extensions.com.candescent.themeOverride` (base preset, schema version).
75
+ - `ThemeOverrideMetadata` — metadata for FI overrides under `$extensions.com.candescent.themeOverride` (base preset, schema version). See [Override Structure](../../docs/internal/token-architecture/16-override-structure.md) for the recommended payload format.
76
76
 
77
77
  ## Token pipeline
78
78
 
@@ -122,11 +122,10 @@ pnpm tokens:build
122
122
 
123
123
  **Generated artifacts** (from the same build pass):
124
124
 
125
- | Artifact | Ships to | Purpose |
126
- | ------------------- | ----------------- | ------------------------------------------------------------------ |
127
- | Runtime map | Package (JSON) | Theme object path → CSS custom property name for sparse flattening |
128
- | Preset patches | Package (JSON) | Sparse diff from build default → each non-default preset |
129
- | Validation manifest | API deploy bundle | Allow-listed paths and types for server-side override validation |
125
+ | Artifact | Ships to | Purpose |
126
+ | -------------- | -------------- | ------------------------------------------------------------------ |
127
+ | Runtime map | Package (JSON) | Theme object path → CSS custom property name for sparse flattening |
128
+ | Preset patches | Package (JSON) | Sparse diff from build default → each non-default preset |
130
129
 
131
130
  ### Validating font tokens
132
131
 
@@ -152,7 +151,7 @@ Light/dark mode switching is handled by Uniwind `@variant light/dark` blocks in
152
151
 
153
152
  ### FI overrides
154
153
 
155
- Financial institution white-labelling uses sparse JSON overridesonly the token paths that differ from the base preset. Overrides are validated server-side against a generated validation manifest and applied at runtime via the runtime map + `Uniwind.updateCSSVariables`. See [Theme Definition](../../docs/internal/token-architecture/02-theme-definition.md) for the full override flow.
154
+ Financial institution white-labelling uses the hybrid override format brand inputs (a single hex color expanded into a full palette at runtime) plus optional per-mode semantic token overrides. The Theme API is a pass-through store; validation is performed by the Theme Editor before save. Consuming apps apply overrides at runtime via palette generation + the runtime map + `Uniwind.updateCSSVariables`. See [Override Structure](../../docs/internal/token-architecture/16-override-structure.md) for the payload format and responsibility contract, and [Theme Definition](../../docs/internal/token-architecture/02-theme-definition.md) for the full theme object schema.
156
155
 
157
156
  ## Package structure
158
157
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cdx-ui/styles",
3
- "version": "0.0.1-beta.30",
3
+ "version": "0.0.1-beta.31",
4
4
  "main": "lib/commonjs/index.js",
5
5
  "module": "lib/module/index.js",
6
6
  "react-native": "src/index.ts",
@@ -53,7 +53,7 @@
53
53
  "@expo-google-fonts/manrope": "0.4.2",
54
54
  "@expo-google-fonts/outfit": "0.4.3",
55
55
  "@expo-google-fonts/public-sans": "0.4.2",
56
- "@cdx-ui/utils": "0.0.1-beta.30"
56
+ "@cdx-ui/utils": "0.0.1-beta.31"
57
57
  },
58
58
  "peerDependencies": {
59
59
  "react": "^18.2.0 || ^19.0.0",