@stridge/noctis-design-tokens 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/graph/components.js

@@ -1365,6 +1365,84 @@ const toolbar = {
 		}, "5rem", "Default width of a toolbar input field.", "The resting width of a `Toolbar.Input` — sized for a short value like a zoom percentage; override per use.")
 	]
 };
+const pagination = {
+	component: "pagination",
+	category: "navigation",
+	slotPrefix: "noctis",
+	anatomy: [
+		"pagination",
+		"pagination-info",
+		"pagination-page-size",
+		"pagination-page",
+		"pagination-controls",
+		"pagination-separator"
+	],
+	options: { size: ["sm", "md"] },
+	states: [],
+	consumes: [],
+	optionSlots: { size: "pagination" },
+	mints: [
+		raw("0cbc4655-bb4e-4fd5-9c04-057351efe727", {
+			kind: "component",
+			component: "pagination",
+			property: "gap"
+		}, "var(--noctis-space-3)", "Gap between the pagination's clusters.", "The spacing the pagination row holds between its info line, page-size picker, separator, page field, and controls."),
+		raw("41dfe2e5-18e2-4197-a956-8ff5b4fe0e41", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "info",
+			property: "font-size"
+		}, "var(--noctis-text-small)", "Info line font size.", "The type size of the “Showing X–Y of Z” status line."),
+		aliased("72cd3ff8-3ebe-4c30-9fdd-6130842a3274", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "info",
+			property: "color"
+		}, { role: "muted" }, "Info line text colour.", "The colour of the status line — the quieter muted role, since it is secondary to the controls."),
+		raw("1282b0be-d667-4311-a247-bfb08e980d7b", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "page-size",
+			property: "gap"
+		}, "var(--noctis-space-2)", "Gap inside the page-size cluster.", "The spacing between the page-size label and its select."),
+		raw("a907344a-4e70-4b2d-a92b-ad740a165f31", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "page",
+			property: "gap"
+		}, "var(--noctis-space-2)", "Gap inside the page field cluster.", "The spacing between the “Page” label, the page input, and the “of N” total."),
+		raw("d501c15c-b399-4366-80fb-66b43511ca19", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "page",
+			property: "inline-size"
+		}, "3.5rem", "Width of the editable page input.", "The resting width of the page-number field, sized for a few digits; override per use for larger page counts."),
+		aliased("d8abfead-9e96-437c-9af1-dbccf3fd34b9", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "page",
+			property: "block-size"
+		}, { raw: "var(--noctis-size-control-md)" }, "Height of the welded page input.", "The control height of the page field per size, kept level with the nav buttons beside it (the `Input` shell itself floors at `md`, so the welded field's height is pinned here); `sm` drops to `control-sm`.", { size: { sm: { raw: "var(--noctis-size-control-sm)" } } }),
+		aliased("d5bbc9bc-de84-4050-a437-d0d864c6c2ba", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "separator",
+			property: "color"
+		}, { role: "border" }, "Colour of the divider between pagination clusters.", "The hairline separator's colour — the default border role, so it reads as a quiet rule."),
+		raw("3f5f5f70-1e70-40e7-a05c-9b6ba5892b70", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "separator",
+			property: "inline-size"
+		}, "1px", "Thickness of the divider between pagination clusters.", "The thickness of the vertical hairline separator."),
+		raw("9fcd3857-34b8-42e4-95af-14e2c3e65744", {
+			kind: "component",
+			component: "pagination",
+			anatomy: "separator",
+			property: "block-size"
+		}, "1.5rem", "Height of the divider between pagination clusters.", "The height of the vertical hairline separator within the centred row.")
+	]
+};
 const accordion = {
 	component: "accordion",
 	category: "surfaces",
@@ -3230,7 +3308,7 @@ const radio = {
 * The avatar mints its box edge and its initials type, both retuned per the `size` axis (`xs`…`xl`),
 * plus the corner radius the `square` shape reads (the default `circle` shape is the literal
 * `--noctis-radius-full` extreme, never minted). Avatars are static-identity and accent-independent:
-* the fallback fill is a `--noctis-color-avatar-N` role chosen by a stable hash, so it carries its own
+* the fallback fill is a `--noctis-color-palette-N` role chosen by a stable hash, so it carries its own
 * light/dark values and never re-themes on the accent. Its sizes are a deliberate own scale (not the
 * control-height ladder) — an avatar is an image footprint, not a control.
 */
@@ -3340,6 +3418,87 @@ const avatar = {
 		}, "0px", "Corner inset of the presence/status indicator.", "How far the indicator is pulled in from the avatar's corner (logical); zero sits it flush against the edge, where the round box curves away from it.")
 	]
 };
+const badge = {
+	component: "badge",
+	category: "data",
+	slotPrefix: "noctis",
+	anatomy: [
+		"badge",
+		"badge-dot",
+		"badge-icon"
+	],
+	options: {
+		variant: [
+			"solid",
+			"soft",
+			"outline",
+			"dot"
+		],
+		tone: [
+			"neutral",
+			"accent",
+			"success",
+			"warning",
+			"danger",
+			"info",
+			"red",
+			"orange",
+			"amber",
+			"green",
+			"teal",
+			"blue",
+			"purple",
+			"pink"
+		],
+		size: ["sm", "md"]
+	},
+	states: [],
+	consumes: [],
+	optionSlots: {
+		variant: "badge",
+		tone: "badge",
+		size: "badge"
+	},
+	mints: [
+		aliased("dbb503f3-d915-428f-a2ba-c6bad40ae7d5", {
+			kind: "component",
+			component: "badge",
+			property: "padding-inline"
+		}, { raw: "0.5rem" }, "Inline padding of the chip.", "The horizontal inset between the chip edge and its content, per size.", { size: { sm: { raw: "0.4375rem" } } }),
+		aliased("aaecfaef-d3b1-4c85-a1bd-dde224acdbc6", {
+			kind: "component",
+			component: "badge",
+			property: "padding-block"
+		}, { raw: "0.1875rem" }, "Block padding of the chip.", "The vertical inset between the chip edge and its content, per size.", { size: { sm: { raw: "0.125rem" } } }),
+		aliased("c3e686b3-1588-401e-ac41-4ab58c34b8cc", {
+			kind: "component",
+			component: "badge",
+			property: "gap"
+		}, { raw: "0.3125rem" }, "Gap between the chip's dot/icon and its label.", "The spacing the chip holds between a leading dot or icon and the label text, per size.", { size: { sm: { raw: "0.25rem" } } }),
+		aliased("acd27e33-13ac-4d0e-a772-6ac25f34208c", {
+			kind: "component",
+			component: "badge",
+			property: "font-size"
+		}, { raw: "var(--noctis-text-mini)" }, "Label type size.", "The font size of the chip's label, per size; the 12px `mini` step at `md`, the 11px `micro` step at `sm`.", { size: { sm: { raw: "var(--noctis-text-micro)" } } }),
+		raw("27e0ac6b-60dc-4179-9d7e-ecad248c2ee7", {
+			kind: "component",
+			component: "badge",
+			property: "border-radius"
+		}, "var(--noctis-radius-full)", "Chip corner radius.", "The rounding of the chip; the full-round pill extreme so the chip reads as a label, not a button — override the public var for a squarer chip."),
+		aliased("d73ca89d-4d8c-4663-8f28-3ad69877ef92", {
+			kind: "component",
+			component: "badge",
+			anatomy: "dot",
+			property: "size"
+		}, { raw: "0.375rem" }, "Edge length of the leading status dot.", "The diameter of the optional status dot, per size; the dot inherits the label colour via `currentColor`, so it stays legible in every variant.", { size: { sm: { raw: "0.3125rem" } } }),
+		aliased("0fcef652-7887-4bc4-a85f-08137936f1c0", {
+			kind: "component",
+			component: "badge",
+			anatomy: "icon",
+			property: "size"
+		}, { raw: "0.875rem" }, "Edge length of a leading icon glyph.", "The width and height the chip clamps a leading icon to, per size, so the glyph tracks the label.", { size: { sm: { raw: "0.75rem" } } })
+	]
+};
 const colorSwatch = {
 	component: "color-swatch",
 	category: "fields",
@@ -4239,6 +4398,7 @@ const COMPONENT_DECLARATIONS = [
 	buttonGroup,
 	tabs,
 	toolbar,
+	pagination,
 	accordion,
 	toggle,
 	numberField,
@@ -4260,6 +4420,7 @@ const COMPONENT_DECLARATIONS = [
 	slider,
 	checkbox,
 	avatar,
+	badge,
 	otpField,
 	switchControl,
 	progress,

package/dist/graph/model.d.ts

@@ -24,7 +24,7 @@ type TokenBridge = {
   readonly name: string;
 };
 /** How a token is grouped in the reference view (display metadata, not the structural category). */
-type TokenGroup = "surface" | "text" | "border" | "accent" | "control" | "status" | "utility" | "chart" | "avatar";
+type TokenGroup = "surface" | "text" | "border" | "accent" | "control" | "status" | "utility" | "chart" | "palette";
 /**
  * A structured token name. The flat form carries an id verbatim (seed, foundation, and semantic
  * tokens — the category segment comes from `tier`/`category` at serialization, never the id);

package/dist/graph/model.js

@@ -55,7 +55,7 @@ const groupSchema = z.enum([
 	"status",
 	"utility",
 	"chart",
-	"avatar"
+	"palette"
 ]);
 const tokenBridgeSchema = z.discriminatedUnion("kind", [
 	z.object({ kind: z.literal("color") }).strict(),

package/dist/graph/statics.js

@@ -202,19 +202,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-1"
+			id: "palette-1"
 		},
 		value: {
 			raw: "oklch(0.62 0.17 264)",
 			rawLight: "oklch(0.58 0.18 264)"
 		},
-		description: "Generative avatar swatch 1.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 1.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 1",
+		label: "Palette 1",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-1",
+		group: "palette",
+		utility: "bg-palette-1",
 		bridge: { kind: "color" }
 	},
 	{
@@ -222,19 +222,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-2"
+			id: "palette-2"
 		},
 		value: {
 			raw: "oklch(0.62 0.15 196)",
 			rawLight: "oklch(0.56 0.15 196)"
 		},
-		description: "Generative avatar swatch 2.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 2.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 2",
+		label: "Palette 2",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-2",
+		group: "palette",
+		utility: "bg-palette-2",
 		bridge: { kind: "color" }
 	},
 	{
@@ -242,19 +242,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-3"
+			id: "palette-3"
 		},
 		value: {
 			raw: "oklch(0.62 0.16 152)",
 			rawLight: "oklch(0.56 0.16 152)"
 		},
-		description: "Generative avatar swatch 3.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 3.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 3",
+		label: "Palette 3",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-3",
+		group: "palette",
+		utility: "bg-palette-3",
 		bridge: { kind: "color" }
 	},
 	{
@@ -262,19 +262,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-4"
+			id: "palette-4"
 		},
 		value: {
 			raw: "oklch(0.64 0.15 130)",
 			rawLight: "oklch(0.58 0.15 130)"
 		},
-		description: "Generative avatar swatch 4.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 4.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 4",
+		label: "Palette 4",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-4",
+		group: "palette",
+		utility: "bg-palette-4",
 		bridge: { kind: "color" }
 	},
 	{
@@ -282,19 +282,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-5"
+			id: "palette-5"
 		},
 		value: {
 			raw: "oklch(0.66 0.16 70)",
 			rawLight: "oklch(0.62 0.16 70)"
 		},
-		description: "Generative avatar swatch 5.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 5.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 5",
+		label: "Palette 5",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-5",
+		group: "palette",
+		utility: "bg-palette-5",
 		bridge: { kind: "color" }
 	},
 	{
@@ -302,19 +302,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-6"
+			id: "palette-6"
 		},
 		value: {
 			raw: "oklch(0.62 0.18 40)",
 			rawLight: "oklch(0.58 0.19 40)"
 		},
-		description: "Generative avatar swatch 6.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 6.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 6",
+		label: "Palette 6",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-6",
+		group: "palette",
+		utility: "bg-palette-6",
 		bridge: { kind: "color" }
 	},
 	{
@@ -322,19 +322,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-7"
+			id: "palette-7"
 		},
 		value: {
 			raw: "oklch(0.6 0.2 18)",
 			rawLight: "oklch(0.56 0.21 18)"
 		},
-		description: "Generative avatar swatch 7.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 7.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 7",
+		label: "Palette 7",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-7",
+		group: "palette",
+		utility: "bg-palette-7",
 		bridge: { kind: "color" }
 	},
 	{
@@ -342,19 +342,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-8"
+			id: "palette-8"
 		},
 		value: {
 			raw: "oklch(0.6 0.18 330)",
 			rawLight: "oklch(0.56 0.19 330)"
 		},
-		description: "Generative avatar swatch 8.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 8.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 8",
+		label: "Palette 8",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-8",
+		group: "palette",
+		utility: "bg-palette-8",
 		bridge: { kind: "color" }
 	},
 	{
@@ -362,19 +362,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-9"
+			id: "palette-9"
 		},
 		value: {
 			raw: "oklch(0.6 0.18 300)",
 			rawLight: "oklch(0.56 0.19 300)"
 		},
-		description: "Generative avatar swatch 9.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 9.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 9",
+		label: "Palette 9",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-9",
+		group: "palette",
+		utility: "bg-palette-9",
 		bridge: { kind: "color" }
 	},
 	{
@@ -382,19 +382,19 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-10"
+			id: "palette-10"
 		},
 		value: {
 			raw: "oklch(0.6 0.15 285)",
 			rawLight: "oklch(0.56 0.16 285)"
 		},
-		description: "Generative avatar swatch 10.",
-		usage: "Avatar / initials background, indexed by a stable id hash.",
+		description: "Categorical palette swatch 10.",
+		usage: "Accent-independent categorical fill — avatar initials (chosen by id hash) and Badge decorative tones.",
 		introduced: "0.0.0",
-		label: "Avatar 10",
+		label: "Palette 10",
 		category: "color",
-		group: "avatar",
-		utility: "bg-avatar-10",
+		group: "palette",
+		utility: "bg-palette-10",
 		bridge: { kind: "color" }
 	},
 	{
@@ -402,16 +402,16 @@ const STATIC_SEMANTIC_TOKENS = [
 		tier: "semantic",
 		name: {
 			kind: "flat",
-			id: "avatar-foreground"
+			id: "palette-foreground"
 		},
 		value: { raw: "oklch(0.99 0 0)" },
-		description: "Initials text on an avatar background.",
-		usage: "Initials text on an avatar — the page background as a knockout.",
+		description: "Knockout text on a saturated palette swatch.",
+		usage: "Knockout text that reads on any saturated palette swatch — avatar initials, solid Badge labels.",
 		introduced: "0.0.0",
-		label: "Avatar foreground",
+		label: "Palette foreground",
 		category: "color",
-		group: "avatar",
-		utility: "text-avatar-foreground",
+		group: "palette",
+		utility: "text-palette-foreground",
 		bridge: { kind: "color" }
 	}
 ];

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { ComponentDeclaration, DesignToken, GraphValidationError, TokenBridge, T
 import { COMPONENT_DECLARATIONS } from "./graph/components.js";
 import { DESIGN_TOKENS, SemanticRoleId } from "./graph/index.js";
 import { internalVar, serializeTokenName } from "./graph/serialize.js";
-import { AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, ModePalette, avatarIndex } from "./palettes.js";
+import { CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, ModePalette, PALETTE, PALETTE_FOREGROUND, PALETTE_SWATCH_COUNT, avatarIndex } from "./palettes.js";
 import { BREAKPOINTS, DENSITY_VAR, EASINGS, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, RADII, RADIUS_VAR, SPEEDS, Z_INDEX } from "./scales.js";
 import { ACCENT_SWATCHES, BACKGROUND_SWATCHES, ThemeSwatch } from "./swatches.js";
 import { ELEVATION_SCOPES, ElevationScope, SEMANTIC_ROLES, STATIC_TOKENS, SemanticRole, StaticToken } from "./semantic.js";
@@ -23,4 +23,4 @@ import { ThemeOverrides, ThemePreset, defaultPreset, presets } from "@stridge/no
 /** Package identifier — the workspace-resolution marker consumed by the app scaffold. */
 declare const DESIGN_TOKENS_PACKAGE: "@stridge/noctis-design-tokens";
 //#endregion
-export { ACCENT_SWATCHES, AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, BACKGROUND_SWATCHES, BREAKPOINTS, CATEGORY_REGISTRY, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, COMPONENT_DECLARATIONS, COMPOSITE_PROPERTIES, type ComponentCategory, type ComponentDeclaration, type CompositeProperty, DENSITY_VAR, DESIGN_TOKENS, DESIGN_TOKENS_PACKAGE, type DesignToken, EASINGS, ELEVATION_SCOPES, type ElevationScope, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, GraphValidationError, type ModePalette, RADII, RADIUS_VAR, ROLE_VAR_PREFIX, SEMANTIC_ROLES, SPEEDS, STATE_REGISTRY, STATIC_TOKENS, type SemanticRole, type SemanticRoleId, type StaticToken, TOKEN_CATEGORIES, TOKEN_TIERS, type ThemeOverrides, type ThemePreset, type ThemeSwatch, type TokenBridge, type TokenCategory, type TokenDeprecation, type TokenGroup, type TokenName, type TokenState, type TokenTier, type TokenValue, Z_INDEX, applyThemeWithScopes, avatarIndex, bridgeVarName, componentDeclarationSchema, cssVarName, defaultPreset, defaultThemeCss, designTokenSchema, internalVar, presets, serializeTokenName, validateGraph };
+export { ACCENT_SWATCHES, BACKGROUND_SWATCHES, BREAKPOINTS, CATEGORY_REGISTRY, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, COMPONENT_DECLARATIONS, COMPOSITE_PROPERTIES, type ComponentCategory, type ComponentDeclaration, type CompositeProperty, DENSITY_VAR, DESIGN_TOKENS, DESIGN_TOKENS_PACKAGE, type DesignToken, EASINGS, ELEVATION_SCOPES, type ElevationScope, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, GraphValidationError, type ModePalette, PALETTE, PALETTE_FOREGROUND, PALETTE_SWATCH_COUNT, RADII, RADIUS_VAR, ROLE_VAR_PREFIX, SEMANTIC_ROLES, SPEEDS, STATE_REGISTRY, STATIC_TOKENS, type SemanticRole, type SemanticRoleId, type StaticToken, TOKEN_CATEGORIES, TOKEN_TIERS, type ThemeOverrides, type ThemePreset, type ThemeSwatch, type TokenBridge, type TokenCategory, type TokenDeprecation, type TokenGroup, type TokenName, type TokenState, type TokenTier, type TokenValue, Z_INDEX, applyThemeWithScopes, avatarIndex, bridgeVarName, componentDeclarationSchema, cssVarName, defaultPreset, defaultThemeCss, designTokenSchema, internalVar, presets, serializeTokenName, validateGraph };

package/dist/index.js

@@ -5,7 +5,7 @@ import { CATEGORY_REGISTRY, COMPOSITE_PROPERTIES, ROLE_VAR_PREFIX, STATE_REGISTR
 import { internalVar, serializeTokenName } from "./graph/serialize.js";
 import { GraphValidationError, bridgeVarName, componentDeclarationSchema, cssVarName, designTokenSchema, validateGraph } from "./graph/model.js";
 import { DESIGN_TOKENS } from "./graph/index.js";
-import { AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, avatarIndex } from "./palettes.js";
+import { CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, PALETTE, PALETTE_FOREGROUND, PALETTE_SWATCH_COUNT, avatarIndex } from "./palettes.js";
 import { BREAKPOINTS, DENSITY_VAR, EASINGS, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, RADII, RADIUS_VAR, SPEEDS, Z_INDEX } from "./scales.js";
 import { ACCENT_SWATCHES, BACKGROUND_SWATCHES } from "./swatches.js";
 import { ELEVATION_SCOPES, SEMANTIC_ROLES, STATIC_TOKENS } from "./semantic.js";
@@ -22,4 +22,4 @@ import { defaultPreset, presets } from "@stridge/noctis-theme-engine";
 /** Package identifier — the workspace-resolution marker consumed by the app scaffold. */
 const DESIGN_TOKENS_PACKAGE = "@stridge/noctis-design-tokens";
 //#endregion
-export { ACCENT_SWATCHES, AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, BACKGROUND_SWATCHES, BREAKPOINTS, CATEGORY_REGISTRY, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, COMPONENT_DECLARATIONS, COMPOSITE_PROPERTIES, DENSITY_VAR, DESIGN_TOKENS, DESIGN_TOKENS_PACKAGE, EASINGS, ELEVATION_SCOPES, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, GraphValidationError, RADII, RADIUS_VAR, ROLE_VAR_PREFIX, SEMANTIC_ROLES, SPEEDS, STATE_REGISTRY, STATIC_TOKENS, TOKEN_CATEGORIES, TOKEN_TIERS, Z_INDEX, applyThemeWithScopes, avatarIndex, bridgeVarName, componentDeclarationSchema, cssVarName, defaultPreset, defaultThemeCss, designTokenSchema, internalVar, presets, serializeTokenName, validateGraph };
+export { ACCENT_SWATCHES, BACKGROUND_SWATCHES, BREAKPOINTS, CATEGORY_REGISTRY, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, COMPONENT_DECLARATIONS, COMPOSITE_PROPERTIES, DENSITY_VAR, DESIGN_TOKENS, DESIGN_TOKENS_PACKAGE, EASINGS, ELEVATION_SCOPES, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, GraphValidationError, PALETTE, PALETTE_FOREGROUND, PALETTE_SWATCH_COUNT, RADII, RADIUS_VAR, ROLE_VAR_PREFIX, SEMANTIC_ROLES, SPEEDS, STATE_REGISTRY, STATIC_TOKENS, TOKEN_CATEGORIES, TOKEN_TIERS, Z_INDEX, applyThemeWithScopes, avatarIndex, bridgeVarName, componentDeclarationSchema, cssVarName, defaultPreset, defaultThemeCss, designTokenSchema, internalVar, presets, serializeTokenName, validateGraph };

package/dist/palettes.d.ts

@@ -2,10 +2,11 @@
 /**
  * Static, accent-independent palettes the engine does not generate.
  *
- * Charts and avatars need **categorical distinctness that stays stable** regardless of the
- * active theme accent, so these are authored in OKLCH (not derived from the seed) with
- * explicit light and dark values. They are emitted as Tailwind colors (`bg-chart-1`,
- * `bg-avatar-3`, `text-chart-positive`) and switch on the resolved mode via `data-theme`.
+ * Charts and categorical UI (avatar swatches, badge decorative tones) need **categorical
+ * distinctness that stays stable** regardless of the active theme accent, so these are authored in
+ * OKLCH (not derived from the seed) with explicit light and dark values. They are emitted as Tailwind
+ * colors (`bg-chart-1`, `bg-palette-3`, `text-chart-positive`) and switch on the resolved mode via
+ * `data-theme`.
  *
  * Hue choices are spread across the wheel and separated in lightness as well as hue, so the
  * series remain distinguishable under the common forms of color-vision deficiency (the worst
@@ -22,18 +23,19 @@ interface ModePalette {
  */
 declare const CHART_PALETTE: ModePalette;
 /**
- * Avatar / identity backgrounds (10). Saturated mid-lightness colors chosen so white initials
- * read clearly on every swatch; picked deterministically by hashing a stable id.
+ * The categorical palette (10). Saturated mid-lightness colors chosen so a white knockout reads
+ * clearly on every swatch — shared by Avatar fallback backgrounds (picked by hashing a stable id) and
+ * Badge decorative tones (mapped by name). Accent-independent, so categorical identity stays stable.
  */
-declare const AVATAR_PALETTE: ModePalette;
-/** Number of distinct chart series and avatar swatches. */
+declare const PALETTE: ModePalette;
+/** Number of distinct chart series and categorical palette swatches. */
 declare const CHART_SERIES_COUNT: number;
-declare const AVATAR_SWATCH_COUNT: number;
-/** On-avatar text — a fixed knockout that reads on every (saturated) avatar swatch. */
-declare const AVATAR_FOREGROUND: "oklch(0.99 0 0)";
+declare const PALETTE_SWATCH_COUNT: number;
+/** Knockout text on a palette swatch — a fixed near-white that reads on every (saturated) swatch. */
+declare const PALETTE_FOREGROUND: "oklch(0.99 0 0)";
 /**
- * Pick a stable avatar swatch index (1-based, matching `bg-avatar-N`) for an id. A small FNV-1a
- * hash keeps the mapping deterministic across renders and sessions.
+ * Pick a stable palette swatch index (1-based, matching `bg-palette-N`) for an id — Avatar's identity
+ * hash. A small FNV-1a hash keeps the mapping deterministic across renders and sessions.
  */
 declare function avatarIndex(id: string): number;
 /** Chart roles that alias engine semantics (kept here so the swatch/reference lists them together). */
@@ -67,4 +69,4 @@ declare const CHART_SEMANTIC_ROLES: readonly [{
   readonly description: "Chart tooltip surface.";
 }];
 //#endregion
-export { AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, ModePalette, avatarIndex };
+export { CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, ModePalette, PALETTE, PALETTE_FOREGROUND, PALETTE_SWATCH_COUNT, avatarIndex };

package/dist/palettes.js

@@ -26,10 +26,11 @@ const CHART_PALETTE = {
 	]
 };
 /**
-* Avatar / identity backgrounds (10). Saturated mid-lightness colors chosen so white initials
-* read clearly on every swatch; picked deterministically by hashing a stable id.
+* The categorical palette (10). Saturated mid-lightness colors chosen so a white knockout reads
+* clearly on every swatch — shared by Avatar fallback backgrounds (picked by hashing a stable id) and
+* Badge decorative tones (mapped by name). Accent-independent, so categorical identity stays stable.
 */
-const AVATAR_PALETTE = {
+const PALETTE = {
 	dark: [
 		"oklch(0.62 0.17 264)",
 		"oklch(0.62 0.15 196)",
@@ -55,14 +56,14 @@ const AVATAR_PALETTE = {
 		"oklch(0.56 0.16 285)"
 	]
 };
-/** Number of distinct chart series and avatar swatches. */
+/** Number of distinct chart series and categorical palette swatches. */
 const CHART_SERIES_COUNT = CHART_PALETTE.dark.length;
-const AVATAR_SWATCH_COUNT = AVATAR_PALETTE.dark.length;
-/** On-avatar text — a fixed knockout that reads on every (saturated) avatar swatch. */
-const AVATAR_FOREGROUND = "oklch(0.99 0 0)";
+const PALETTE_SWATCH_COUNT = PALETTE.dark.length;
+/** Knockout text on a palette swatch — a fixed near-white that reads on every (saturated) swatch. */
+const PALETTE_FOREGROUND = "oklch(0.99 0 0)";
 /**
-* Pick a stable avatar swatch index (1-based, matching `bg-avatar-N`) for an id. A small FNV-1a
-* hash keeps the mapping deterministic across renders and sessions.
+* Pick a stable palette swatch index (1-based, matching `bg-palette-N`) for an id — Avatar's identity
+* hash. A small FNV-1a hash keeps the mapping deterministic across renders and sessions.
 */
 function avatarIndex(id) {
 	let hash = 2166136261;
@@ -70,7 +71,7 @@ function avatarIndex(id) {
 		hash ^= id.charCodeAt(i);
 		hash = Math.imul(hash, 16777619);
 	}
-	return (hash >>> 0) % AVATAR_SWATCH_COUNT + 1;
+	return (hash >>> 0) % PALETTE_SWATCH_COUNT + 1;
 }
 /** Chart roles that alias engine semantics (kept here so the swatch/reference lists them together). */
 const CHART_SEMANTIC_ROLES = [
@@ -111,4 +112,4 @@ const CHART_SEMANTIC_ROLES = [
 	}
 ];
 //#endregion
-export { AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, avatarIndex };
+export { CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, PALETTE, PALETTE_FOREGROUND, PALETTE_SWATCH_COUNT, avatarIndex };