@getvitops/generator 0.8.0 → 0.9.0

package/dist/index.d.mts

@@ -12,11 +12,11 @@ declare const DesignSystemSchema: z.ZodMiniObject<{
     }, z.z.core.$strip>]>>;
     roles: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
     utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-      fill: "fill";
       bg: "bg";
       text: "text";
       border: "border";
       outline: "outline";
+      fill: "fill";
       stroke: "stroke";
     }>>>;
   }, z.z.core.$strip>;
@@ -102,11 +102,11 @@ declare const jsonSchema: {
       }, z.z.core.$strip>]>>;
       roles: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
       utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-        fill: "fill";
         bg: "bg";
         text: "text";
         border: "border";
         outline: "outline";
+        fill: "fill";
         stroke: "stroke";
       }>>>;
     }, z.z.core.$strip>;
@@ -254,6 +254,27 @@ type ValidationResult = {
  */
 declare function validate(input: unknown): ValidationResult;
 //#endregion
+//#region src/tokens.d.ts
+declare const NUMERIC_STEPS: readonly ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
+type NumStep = (typeof NUMERIC_STEPS)[number];
+interface ExpandedHue {
+  /** Numeric steps (sparse for fixed-tone kits). */
+  numeric: Partial<Record<NumStep, string>>;
+  /** True when only authored tones + endpoints exist (no interpolation). */
+  sparse?: boolean;
+}
+/** Expand every palette hue into its numeric scale. */
+declare function expandPalette(raw: Record<string, unknown>): Record<string, ExpandedHue>;
+interface FunctionalRole {
+  role: string;
+  hue: string;
+  /** token → CSS value, per appearance. */
+  light: Record<string, string>;
+  dark: Record<string, string>;
+}
+/** Resolve the functional token set for one role over its hue. */
+declare function functionalRole(role: string, hueName: string, hue: ExpandedHue): FunctionalRole;
+//#endregion
 //#region src/generate.d.ts
 type Format = 'bricks' | 'css' | 'tailwind';
 interface GenerateOptions {
@@ -271,6 +292,34 @@ interface GenerateResult {
   outDir: string;
   written: string[];
 }
+interface ColorUtility {
+  /** Class name, without the leading dot. */
+  cls: string;
+  /** CSS property the class sets. */
+  prop: string;
+  /** `var(--…)` reference the class resolves to. */
+  value: string;
+  /** Which of the two axes below produced it. */
+  axis: 'plane' | 'stop';
+}
+/**
+ * Every role colour utility, each class name emitted EXACTLY once.
+ *
+ * Two axes share the `<family>-<role>-<modifier>` namespace: the functional
+ * background/text/border **planes** (`--<role>-bg-muted`) and the
+ * appearance-relative emphasis **stops** (`--color-<role>-muted`). Where both
+ * would produce the same class the plane wins.
+ *
+ * That precedence used to be implicit — the css path emitted the stop matrix,
+ * then the planes, and relied on the CSS minifier dropping the shadowed
+ * earlier rule. The tailwind path never ran the stop half at all, so the two
+ * formats shipped different vocabularies (87 role classes existed in css and
+ * not in tailwind) with nothing to catch it. Deciding it here, once, is what
+ * keeps all three formats in step; `format-parity.test.ts` holds them there.
+ *
+ * Order is stops-then-planes to match the css bundle's historical rule order.
+ */
+declare function roleColorUtilities(roles: readonly FunctionalRole[], utilities: readonly string[]): ColorUtility[];
 declare function generate(options: GenerateOptions): Promise<GenerateResult>;
 //#endregion
 //#region src/docs.d.ts
@@ -286,6 +335,46 @@ declare function generateDocs(ds: DesignSystem, assetsDir: string): Record<strin
  * (`docs.ts`). Lives in its own module because `generate.ts` imports `docs.ts` —
  * importing back the other way would be a cycle.
  */
+/**
+ * Selector the dark functional-token flip hangs off.
+ *
+ * `data-brx-theme` is Bricks' own attribute — Bricks sets it, so it's what the
+ * WordPress target needs. Nothing sets it anywhere else, which meant the dark
+ * flip was unreachable outside Bricks: the shipped `<color-scheme-toggle>` web
+ * component writes `documentElement.dataset.theme` (i.e. `data-theme`), so
+ * clicking "Dark" changed an attribute no rule matched. Matching both makes the
+ * component work on every target without changing what Bricks already does.
+ *
+ * Note this covers the explicit choice only — there is deliberately no
+ * `prefers-color-scheme` block, so the toggle's "System" position currently
+ * resolves to light. Adding one would flip every existing consumer site dark for
+ * dark-OS users, which is a product decision, not a bug fix.
+ *
+ * Shared so the docs quote the selector the generator actually emits.
+ */
+declare const DARK_SEL = ":root[data-brx-theme=\"dark\"], :root[data-theme=\"dark\"]";
+/**
+ * Roles the shipped CSS partials reference with NO fallback, so a config that
+ * omits one leaves those rules resolving to nothing — an invalid declaration,
+ * not a graceful degrade.
+ *
+ * `colors.roles` is an open record: any name works and generates a full token
+ * set, utilities and dark flip. But the framework's own component CSS is
+ * written against these six, so "roles are arbitrary" is only half true — they
+ * are *extensible*, over a required core. `validate()` warns when one is
+ * missing; `required-roles.test.ts` re-derives this list from the partials so
+ * it cannot drift as components are added.
+ *
+ * Kept as a constant rather than scanned at call time because `validate()` is
+ * a pure function — the CLI, the Vite plugin and `toJSONSchema` all import it,
+ * and none of them should touch the filesystem to answer "is this config ok?".
+ */
+declare const REQUIRED_ROLES: readonly string[];
+/**
+ * The functional-token and emphasis-stop suffixes a role resolves to. Shared so
+ * the required-roles drift test greps for exactly what the generator emits.
+ */
+declare const ROLE_TOKEN_SUFFIXES: readonly string[];
 /**
  * Pattern base geometry props → per-pattern override-hook shorthand. Each hook
  * wraps the authored value (`padding: var(--p-btn, 0.4em 0.8em)`) so a
@@ -540,11 +629,11 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
       }, z.z.core.$strip>]>>>;
       roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
       utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-        fill: "fill";
         bg: "bg";
         text: "text";
         border: "border";
         outline: "outline";
+        fill: "fill";
         stroke: "stroke";
       }>>>;
     }, z.z.core.$strip>>;
@@ -652,9 +741,9 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
         number: "number";
         date: "date";
         file: "file";
+        text: "text";
         email: "email";
         url: "url";
-        text: "text";
         tel: "tel";
         password: "password";
         textarea: "textarea";
@@ -1036,11 +1125,11 @@ declare const siteJsonSchema: {
         }, z.z.core.$strip>]>>>;
         roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
         utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-          fill: "fill";
           bg: "bg";
           text: "text";
           border: "border";
           outline: "outline";
+          fill: "fill";
           stroke: "stroke";
         }>>>;
       }, z.z.core.$strip>>;
@@ -1148,9 +1237,9 @@ declare const siteJsonSchema: {
           number: "number";
           date: "date";
           file: "file";
+          text: "text";
           email: "email";
           url: "url";
-          text: "text";
           tel: "tel";
           password: "password";
           textarea: "textarea";
@@ -1399,5 +1488,5 @@ declare function deepMerge(target: Record<string, unknown>, source: Record<strin
  */
 declare function defaultConfig(): DesignSystem;
 //#endregion
-export { BASE_HOOK, type DesignSystem, DesignSystemSchema, type Format, type GenerateOptions, type GenerateResult, SCHEMA_URL, SITE_SCHEMA_URL, type SiteConfig, SiteConfigSchema, type SiteValidationResult, TW_CLASH, type ValidationResult, deepMerge, defaultConfig, generate, generateDocs, jsonSchema, resolveSiteConfig, resolveTheme, siteJsonSchema, stripNulls, validate, validateSite };
+export { BASE_HOOK, type ColorUtility, DARK_SEL, type DesignSystem, DesignSystemSchema, type ExpandedHue, type Format, type FunctionalRole, type GenerateOptions, type GenerateResult, REQUIRED_ROLES, ROLE_TOKEN_SUFFIXES, SCHEMA_URL, SITE_SCHEMA_URL, type SiteConfig, SiteConfigSchema, type SiteValidationResult, TW_CLASH, type ValidationResult, deepMerge, defaultConfig, expandPalette, functionalRole, generate, generateDocs, jsonSchema, resolveSiteConfig, resolveTheme, roleColorUtilities, siteJsonSchema, stripNulls, validate, validateSite };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schema.ts","../src/generate.ts","../src/docs.ts","../src/shared.ts","../src/site.ts","../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schema.ts","../src/tokens.ts","../src/generate.ts","../src/docs.ts","../src/shared.ts","../src/site.ts","../src/index.ts"],"mappings":"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"}