@nxds/core 0.11.0 → 0.13.0

package/dist/runtime/catalogue.d.cts

@@ -1,5 +1,5 @@
-import { N as NxdsPresetField, a as NxdsAppearancePrefs, b as NxdsAppearanceState } from './surface-ladder-C8HTwT7z.cjs';
-export { D as DARK_SURFACE_LADDER, L as LIGHT_SURFACE_LADDER, S as SURFACE_TOKENS, c as ShadeAnchor } from './surface-ladder-C8HTwT7z.cjs';
+import { N as NxdsColorAppearance, a as NxdsAppearancePrefs, b as NxdsPresetField } from './surface-ladder-DZQFqJvm.cjs';
+export { D as DARK_SURFACE_LADDER, L as LIGHT_SURFACE_LADDER, S as SURFACE_TOKENS, c as ShadeAnchor } from './surface-ladder-DZQFqJvm.cjs';
 import { M as Mode } from './palette-BKTIQ0WC.cjs';
 
 /** An authored DTCG `$value`: a scalar, a reference string, or a composite. */
@@ -11,6 +11,14 @@ type TokenValue = string | number | boolean | null | readonly TokenValue[] | {
 type DeepReadonly<T> = T extends object ? {
     readonly [Key in keyof T]: DeepReadonly<T[Key]>;
 } : T;
+/**
+ * The appearance fields the catalogue derives values from: runtime colours
+ * from the brand colour, surface tone and contrasts, and type sizes from the
+ * UI and code font sizes.
+ */
+type CatalogueAppearance = NxdsColorAppearance & {
+    readonly prefs: Pick<NxdsAppearancePrefs, 'uiFontSize' | 'codeFontSize'>;
+};
 /** Token families the catalogue covers. */
 type CatalogueFamily = 'borderwidth' | 'breakpoint' | 'color' | 'motion' | 'radius' | 'shadow' | 'spacing' | 'typography' | 'z-index';
 /**
@@ -63,8 +71,10 @@ interface CatalogueVariant {
     readonly preset: string | null;
     /** The authored leaf, or `null` for a colour the engine derives. */
     readonly source: CatalogueSource | null;
-    /** The full appearance config a derived colour was computed from. */
-    readonly appearance: DeepReadonly<NxdsAppearanceState> | null;
+    /** The appearance fields a derived colour was computed from, and its mode. */
+    readonly appearance: DeepReadonly<NxdsColorAppearance & {
+        readonly mode: Mode;
+    }> | null;
     readonly authoredValue: TokenValue | null;
     /**
      * What the generated CSS declares: one custom property for a scalar or a
@@ -107,9 +117,13 @@ interface CatalogueToken {
  * Every nxds token, identified by its `--nx-*` name: primitives, runtime
  * colours, spacing, z-index, breakpoints, and typography and shadow styles.
  * Shadow layer primitives only compose the shadow styles.
- * Runtime colours are computed from `DEFAULT_NXDS_APPEARANCE` in explicit
- * light and dark modes; each variant records the appearance it used.
+ * Runtime colours are computed from `appearance` in explicit light and dark
+ * modes; each variant records the colour fields and mode it used. Type sizes
+ * and line heights follow its UI font size, and the code size its code font
+ * size. Font families and the preset families keep
+ * their authored values: every preset's variants are listed, and the
+ * appearance only says which one is in use.
  */
-declare function createTokenCatalogue(): readonly CatalogueToken[];
+declare function createTokenCatalogue(appearance?: CatalogueAppearance): readonly CatalogueToken[];
 
-export { type CatalogueAlias, type CatalogueControl, type CatalogueDeclaration, type CatalogueFamily, type CatalogueReference, type CatalogueSource, type CatalogueToken, type CatalogueTokenName, type CatalogueVariant, type TokenValue, createTokenCatalogue };
+export { type CatalogueAlias, type CatalogueAppearance, type CatalogueControl, type CatalogueDeclaration, type CatalogueFamily, type CatalogueReference, type CatalogueSource, type CatalogueToken, type CatalogueTokenName, type CatalogueVariant, type TokenValue, createTokenCatalogue };

package/dist/runtime/catalogue.d.ts

@@ -1,5 +1,5 @@
-import { N as NxdsPresetField, a as NxdsAppearancePrefs, b as NxdsAppearanceState } from './surface-ladder-B950TU4_.js';
-export { D as DARK_SURFACE_LADDER, L as LIGHT_SURFACE_LADDER, S as SURFACE_TOKENS, c as ShadeAnchor } from './surface-ladder-B950TU4_.js';
+import { N as NxdsColorAppearance, a as NxdsAppearancePrefs, b as NxdsPresetField } from './surface-ladder-Cqo5DfZW.js';
+export { D as DARK_SURFACE_LADDER, L as LIGHT_SURFACE_LADDER, S as SURFACE_TOKENS, c as ShadeAnchor } from './surface-ladder-Cqo5DfZW.js';
 import { M as Mode } from './palette-BKTIQ0WC.js';
 
 /** An authored DTCG `$value`: a scalar, a reference string, or a composite. */
@@ -11,6 +11,14 @@ type TokenValue = string | number | boolean | null | readonly TokenValue[] | {
 type DeepReadonly<T> = T extends object ? {
     readonly [Key in keyof T]: DeepReadonly<T[Key]>;
 } : T;
+/**
+ * The appearance fields the catalogue derives values from: runtime colours
+ * from the brand colour, surface tone and contrasts, and type sizes from the
+ * UI and code font sizes.
+ */
+type CatalogueAppearance = NxdsColorAppearance & {
+    readonly prefs: Pick<NxdsAppearancePrefs, 'uiFontSize' | 'codeFontSize'>;
+};
 /** Token families the catalogue covers. */
 type CatalogueFamily = 'borderwidth' | 'breakpoint' | 'color' | 'motion' | 'radius' | 'shadow' | 'spacing' | 'typography' | 'z-index';
 /**
@@ -63,8 +71,10 @@ interface CatalogueVariant {
     readonly preset: string | null;
     /** The authored leaf, or `null` for a colour the engine derives. */
     readonly source: CatalogueSource | null;
-    /** The full appearance config a derived colour was computed from. */
-    readonly appearance: DeepReadonly<NxdsAppearanceState> | null;
+    /** The appearance fields a derived colour was computed from, and its mode. */
+    readonly appearance: DeepReadonly<NxdsColorAppearance & {
+        readonly mode: Mode;
+    }> | null;
     readonly authoredValue: TokenValue | null;
     /**
      * What the generated CSS declares: one custom property for a scalar or a
@@ -107,9 +117,13 @@ interface CatalogueToken {
  * Every nxds token, identified by its `--nx-*` name: primitives, runtime
  * colours, spacing, z-index, breakpoints, and typography and shadow styles.
  * Shadow layer primitives only compose the shadow styles.
- * Runtime colours are computed from `DEFAULT_NXDS_APPEARANCE` in explicit
- * light and dark modes; each variant records the appearance it used.
+ * Runtime colours are computed from `appearance` in explicit light and dark
+ * modes; each variant records the colour fields and mode it used. Type sizes
+ * and line heights follow its UI font size, and the code size its code font
+ * size. Font families and the preset families keep
+ * their authored values: every preset's variants are listed, and the
+ * appearance only says which one is in use.
  */
-declare function createTokenCatalogue(): readonly CatalogueToken[];
+declare function createTokenCatalogue(appearance?: CatalogueAppearance): readonly CatalogueToken[];
 
-export { type CatalogueAlias, type CatalogueControl, type CatalogueDeclaration, type CatalogueFamily, type CatalogueReference, type CatalogueSource, type CatalogueToken, type CatalogueTokenName, type CatalogueVariant, type TokenValue, createTokenCatalogue };
+export { type CatalogueAlias, type CatalogueAppearance, type CatalogueControl, type CatalogueDeclaration, type CatalogueFamily, type CatalogueReference, type CatalogueSource, type CatalogueToken, type CatalogueTokenName, type CatalogueVariant, type TokenValue, createTokenCatalogue };