praxis-kit 4.0.1 → 4.1.0

package/dist/tailwind/index.d.ts

@@ -1,159 +1,45 @@
-import { Except, RequireAtLeastOne, Simplify } from 'type-fest';
+import { Diagnostics } from '../_shared/diagnostics.js';
+import { RequireAtLeastOne, Simplify } from 'type-fest';
 
 type StringMap<T = unknown> = Record<string, T>;
 type AnyRecord = StringMap<unknown>;
+type EmptyRecord = Record<never, never>;
 
 type IntrinsicTag = keyof HTMLElementTagNameMap;
 
 type Booleanish = boolean | 'true' | 'false';
 type ClassName = string | string[];
-type EmptyRecord = Record<never, never>;
 type NonEmptyArray<T> = [T, ...T[]];
 type Numberish = number | `${number}`;
 type Primitive = string | number | boolean;
 type TagMap = Partial<Record<IntrinsicTag | (string & {}), ClassName>>;
 
-declare enum DiagnosticCategory {
-    Contract = 0,
-    HTML = 1,
-    ARIA = 2,
-    Composition = 3,
-    Rendering = 4,
-    Accessibility = 5,
-    Performance = 6,
-    Internal = 7,
-    Deprecation = 8,
-    Lint = 9
-}
-
-declare enum DiagnosticCode {
-    MissingRequiredChild = "COMP1001",
-    InvalidParent = "COMP1002",
-    InvalidChild = "COMP1003",
-    UnexpectedChild = "COMP1004",
-    AmbiguousChild = "COMP1005",
-    CardinalityMin = "COMP1006",
-    CardinalityMax = "COMP1007",
-    PositionViolation = "COMP1008",
-    AllowedAsViolation = "COMP1009",
-    SlotExclusive = "SLOT1001",
-    SlotSingleChild = "SLOT1002",
-    SlotDiscardedChildren = "SLOT1003",
-    SlotRenderFn = "SLOT1004",
-    MissingAriaRelationship = "ARIA2001",
-    AriaViolation = "ARIA2002",
-    AriaAttributeInvalid = "ARIA2003",
-    AriaMissingLiveRegion = "ARIA2004",
-    AriaMissingAtomic = "ARIA2005",
-    AriaRelevantInvalidToken = "ARIA2006",
-    AriaRelevantSuperseded = "ARIA2007",
-    AriaInvalidRole = "ARIA2008",
-    AriaMissingAccessibleName = "ARIA2009",
-    AriaAttributeOnPresentational = "ARIA2010",
-    AriaHiddenOnFocusable = "ARIA2011",
-    AriaRequiredProperty = "ARIA2012",
-    AriaInvalidAttributeValue = "ARIA2013",
-    AriaRedundantLevelAttribute = "ARIA2014",
-    InvalidHeadingHierarchy = "HTML3001",
-    HtmlEmptyRole = "HTML3002",
-    HtmlImplicitRoleRedundant = "HTML3003",
-    HtmlImplicitRoleOverride = "HTML3004",
-    HtmlStandaloneRegionOverride = "HTML3005",
-    HtmlLandmarkRoleOverride = "HTML3006",
-    HtmlInvalidChild = "HTML3007",
-    InvalidRenderingTarget = "RENDER4001",
-    LintDeadCompoundKey = "LINT5001",
-    LintDeadCompoundValue = "LINT5002",
-    LintDeadCompoundNonLiteral = "LINT5003",
-    LintMissingStrict = "LINT5004",
-    LintInvalidDefaultKey = "LINT5005",
-    LintInvalidDefaultValue = "LINT5006",
-    LintInvalidDefaultNonLiteral = "LINT5007",
-    LintNegativeMin = "LINT5008",
-    LintNegativeMax = "LINT5009",
-    LintMaxLessThanMin = "LINT5010",
-    LintZeroMax = "LINT5011",
-    LintMultipleFirst = "LINT5012",
-    LintMultipleLast = "LINT5013",
-    LintMinSumExceedsCapacity = "LINT5014",
-    LintCardinalityViolation = "LINT5015",
-    LintAriaTagOverride = "LINT5016",
-    ContractUnknownVariantDim = "COMP1010",
-    ContractUnknownVariantValue = "COMP1011",
-    ContractUnknownRecipeKey = "COMP1012",
-    ContractInvalidVariantValue = "COMP1013",
-    TailwindMultipleDisplayProps = "CSS6001",
-    TailwindReservedLayoutLiteral = "CSS6002",
-    TailwindDeadVariantClass = "CSS6003",
-    PluginInvalidShape = "PLUGIN7001",
-    PluginPipelineReturnType = "PLUGIN7002",
-    InternalError = "INTERNAL9000"
-}
+type StringToBoolean<T> = T extends 'true' | 'false' ? boolean : T;
 
-interface SourcePosition {
-    line: number;
-    col: number;
-}
-interface SourceLocation {
-    file: string;
-    start: SourcePosition;
-    end?: SourcePosition;
-}
+type VariantValue = string | string[];
 
-declare enum Severity {
-    Debug = 0,
-    Info = 1,
-    Warning = 2,
-    Error = 3,
-    Fatal = 4
-}
+type VariantStates<K extends string = string> = Record<K, VariantValue>;
 
-interface DiagnosticSuggestion {
-    title: string;
-    description?: string;
-    fix?: string;
-}
+type VariantMap<V extends string = string, K extends string = string> = Record<V, VariantStates<K>>;
 
-type Context = AnyRecord;
-type Metadata = AnyRecord;
-interface Diagnostic {
-    code: DiagnosticCode;
-    severity: Severity;
-    category: DiagnosticCategory;
-    message: string;
-    rationale?: string;
-    component?: string;
-    contract?: string;
-    location?: SourceLocation;
-    suggestions?: DiagnosticSuggestion[];
-    context?: Context;
-    metadata?: Metadata;
-}
+type VariantKey<V extends VariantMap, K extends keyof V> = StringToBoolean<keyof V[K] & string>;
 
-declare enum Enforcement {
-    Ignore = 0,
-    Report = 1,
-    Throw = 2
-}
-interface DiagnosticPolicy {
-    resolve(diagnostic: Diagnostic): Enforcement;
-}
+/**
+ * A partial selection of variant states authored at factory definition time.
+ *
+ * Uses `keyof V[K]` directly (not `VariantKey`) so TypeScript can eagerly
+ * resolve the union at constraint-check time without deferred conditional types.
+ */
+type VariantSelection$1<V extends VariantMap> = {
+    [K in keyof V]?: keyof V[K];
+};
 
-interface DiagnosticReporter {
-    report(diagnostic: Diagnostic): void;
-}
+type NormalizedVariantValue<K extends string> = string extends K ? Primitive : K extends 'true' | 'false' ? Booleanish : K extends `${number}` ? Numberish : K;
+type DefaultVariants<V extends VariantMap> = {
+    [K in keyof V]?: NormalizedVariantValue<keyof V[K] & string>;
+};
 
-type DiagnosticInput = Except<Diagnostic, 'severity'>;
-declare class Diagnostics {
-    private readonly reporter;
-    private readonly policy;
-    readonly active: boolean;
-    constructor(reporter: DiagnosticReporter, policy?: DiagnosticPolicy);
-    report(diagnostic: Diagnostic): Diagnostic;
-    warn(input: DiagnosticInput): Diagnostic;
-    error(input: DiagnosticInput): Diagnostic;
-    info(input: DiagnosticInput): Diagnostic;
-}
+type RecipeTarget<TVariants extends VariantMap = VariantMap> = VariantSelection$1<TVariants>;
 
 type RequireAtLeastOneIfNotEmpty<T> = keyof T extends never ? EmptyRecord : RequireAtLeastOne<T>;
 type CompoundVariantConditionValue<V extends VariantMap, K extends keyof V> = VariantKey<V, K> | NonEmptyArray<VariantKey<V, K>>;
@@ -178,26 +64,6 @@ interface CVAVariants<V extends VariantMap> {
     variants?: V;
 }
 
-type StringToBoolean<T> = T extends 'true' | 'false' ? boolean : T;
-type VariantValue = string | string[];
-type VariantStates<K extends string = string> = Record<K, VariantValue>;
-type VariantMap<V extends string = string, K extends string = string> = Record<V, VariantStates<K>>;
-type VariantKey<V extends VariantMap, K extends keyof V> = StringToBoolean<keyof V[K] & string>;
-/**
- * A partial selection of variant states authored at factory definition time.
- *
- * Uses `keyof V[K]` directly (not `VariantKey`) so TypeScript can eagerly
- * resolve the union at constraint-check time without deferred conditional types.
- */
-type VariantSelection$1<V extends VariantMap> = {
-    [K in keyof V]?: keyof V[K];
-};
-type NormalizedVariantValue<K extends string> = string extends K ? Primitive : K extends 'true' | 'false' ? Booleanish : K extends `${number}` ? Numberish : K;
-type DefaultVariants<V extends VariantMap> = {
-    [K in keyof V]?: NormalizedVariantValue<keyof V[K] & string>;
-};
-type RecipeTarget<TVariants extends VariantMap = VariantMap> = VariantSelection$1<TVariants>;
-
 interface BaseClassOptions {
     baseClassName?: ClassName;
 }
@@ -287,7 +153,7 @@ type ClassifiedToken = Simplify<LayoutToken | ConditionalToken | GapToken | Util
 type VariantSelection = Record<string, string>;
 type CompoundVariant = {
     class?: unknown;
-} & Record<string, unknown>;
+} & AnyRecord;
 
 /**
  * Layout-aware class pipeline for Tailwind CSS utility class strings.

package/dist/tailwind/index.js

@@ -184,118 +184,6 @@ var iterate = Object.freeze({
   values
 });
 
-// ../../lib/diagnostics/src/category.ts
-var DiagnosticCategory = /* @__PURE__ */ ((DiagnosticCategory2) => {
-  DiagnosticCategory2[DiagnosticCategory2["Contract"] = 0] = "Contract";
-  DiagnosticCategory2[DiagnosticCategory2["HTML"] = 1] = "HTML";
-  DiagnosticCategory2[DiagnosticCategory2["ARIA"] = 2] = "ARIA";
-  DiagnosticCategory2[DiagnosticCategory2["Composition"] = 3] = "Composition";
-  DiagnosticCategory2[DiagnosticCategory2["Rendering"] = 4] = "Rendering";
-  DiagnosticCategory2[DiagnosticCategory2["Accessibility"] = 5] = "Accessibility";
-  DiagnosticCategory2[DiagnosticCategory2["Performance"] = 6] = "Performance";
-  DiagnosticCategory2[DiagnosticCategory2["Internal"] = 7] = "Internal";
-  DiagnosticCategory2[DiagnosticCategory2["Deprecation"] = 8] = "Deprecation";
-  DiagnosticCategory2[DiagnosticCategory2["Lint"] = 9] = "Lint";
-  return DiagnosticCategory2;
-})(DiagnosticCategory || {});
-
-// ../../lib/diagnostics/src/error.ts
-var PraxisError = class extends Error {
-  diagnostic;
-  constructor(diagnostic) {
-    super(diagnostic.message);
-    this.name = "PraxisError";
-    this.diagnostic = diagnostic;
-  }
-};
-
-// ../../lib/diagnostics/src/severity.ts
-var Severity = /* @__PURE__ */ ((Severity2) => {
-  Severity2[Severity2["Debug"] = 0] = "Debug";
-  Severity2[Severity2["Info"] = 1] = "Info";
-  Severity2[Severity2["Warning"] = 2] = "Warning";
-  Severity2[Severity2["Error"] = 3] = "Error";
-  Severity2[Severity2["Fatal"] = 4] = "Fatal";
-  return Severity2;
-})(Severity || {});
-
-// ../../lib/diagnostics/src/policy.ts
-var DefaultPolicy = class {
-  reportThreshold;
-  throwThreshold;
-  constructor({
-    reportThreshold = 1 /* Info */,
-    throwThreshold = 4 /* Fatal */
-  } = {}) {
-    this.reportThreshold = reportThreshold;
-    this.throwThreshold = throwThreshold;
-  }
-  resolve(diagnostic) {
-    if (diagnostic.severity >= this.throwThreshold) return 2 /* Throw */;
-    if (diagnostic.severity >= this.reportThreshold) return 1 /* Report */;
-    return 0 /* Ignore */;
-  }
-};
-
-// ../../lib/diagnostics/src/diagnostics.ts
-var Diagnostics = class {
-  reporter;
-  policy;
-  // Pre-computed at construction time: true if Warning-level diagnostics are not ignored.
-  active;
-  constructor(reporter, policy = new DefaultPolicy()) {
-    this.reporter = reporter;
-    this.policy = policy;
-    this.active = policy.resolve({ severity: 2 /* Warning */ }) !== 0 /* Ignore */;
-  }
-  report(diagnostic) {
-    const enforcement = this.policy.resolve(diagnostic);
-    if (enforcement === 0 /* Ignore */) return diagnostic;
-    if (enforcement === 2 /* Throw */) throw new PraxisError(diagnostic);
-    this.reporter.report(diagnostic);
-    return diagnostic;
-  }
-  warn(input) {
-    return this.report({ ...input, severity: 2 /* Warning */ });
-  }
-  error(input) {
-    return this.report({ ...input, severity: 3 /* Error */ });
-  }
-  info(input) {
-    return this.report({ ...input, severity: 1 /* Info */ });
-  }
-};
-
-// ../../lib/diagnostics/src/formatter.ts
-function formatDiagnostic(diagnostic) {
-  const level = Severity[diagnostic.severity];
-  const category = DiagnosticCategory[diagnostic.category];
-  const prefix = category !== void 0 ? `[${category}] ` : "";
-  return `${level} ${diagnostic.code}: ${prefix}${diagnostic.message}`;
-}
-
-// ../../lib/diagnostics/src/console-reporter.ts
-var ConsoleReporter = class {
-  report(diagnostic) {
-    const message = formatDiagnostic(diagnostic);
-    switch (diagnostic.severity) {
-      case 0 /* Debug */:
-        console.debug(message);
-        break;
-      case 1 /* Info */:
-        console.info(message);
-        break;
-      case 2 /* Warning */:
-        console.warn(message);
-        break;
-      case 3 /* Error */:
-      case 4 /* Fatal */:
-        console.error(message);
-        break;
-    }
-  }
-};
-
 // ../../node_modules/.pnpm/class-variance-authority@0.7.1/node_modules/class-variance-authority/dist/index.mjs
 import { clsx as clsx2 } from "clsx";
 var falsyToString = (value) => typeof value === "boolean" ? `${value}` : value === 0 ? "0" : value;
@@ -649,26 +537,30 @@ var LayoutState = class {
   }
 };
 
+// ../../lib/tailwind/src/create-tailwind-pipeline.ts
+import { ConsoleReporter, Diagnostics, DefaultPolicy, Severity } from "../_shared/diagnostics.js";
+
 // ../../lib/tailwind/src/diagnostics.ts
+import { DiagnosticCategory, DiagnosticCode } from "../_shared/diagnostics.js";
 var TailwindDiagnostics = {
   multipleDisplayProps(active) {
     return {
-      code: "CSS6001" /* TailwindMultipleDisplayProps */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode.TailwindMultipleDisplayProps,
+      category: DiagnosticCategory.Contract,
       message: `[createTailwindPipeline] Multiple display props set (${active.join(", ")}); "${active[0]}" takes precedence.`
     };
   },
   reservedLayoutLiteral(reserved) {
     return {
-      code: "CSS6002" /* TailwindReservedLayoutLiteral */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode.TailwindReservedLayoutLiteral,
+      category: DiagnosticCategory.Contract,
       message: `[createTailwindPipeline] Reserved display class(es) ${reserved.map((r) => `"${r}"`).join(", ")} found in resolved classes. The display mode is controlled by the display props (flex, inline-flex, grid, block, hidden, etc.), not by class strings.`
     };
   },
   deadVariantClass(dim, value, mode, classStr) {
     return {
-      code: "CSS6003" /* TailwindDeadVariantClass */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode.TailwindDeadVariantClass,
+      category: DiagnosticCategory.Contract,
       message: `[createTailwindPipeline] Variant "${dim}=${value}" contributes only classes stripped under layout mode "${mode}" ("${classStr}") \u2014 it produces nothing in this mode.`
     };
   }
@@ -678,7 +570,7 @@ var TailwindDiagnostics = {
 var DEV = process.env.NODE_ENV !== "production";
 var devDiagnostics = new Diagnostics(
   new ConsoleReporter(),
-  new DefaultPolicy({ reportThreshold: 2 /* Warning */, throwThreshold: 4 /* Fatal */ })
+  new DefaultPolicy({ reportThreshold: Severity.Warning, throwThreshold: Severity.Fatal })
 );
 var classifier = new ClassClassifier();
 var evaluator = new DependencyEvaluator(defaultDependencyRules);

package/dist/vite-plugin/index.d.ts

@@ -82,6 +82,16 @@ declare enum DiagnosticCode {
     InternalError = "INTERNAL9000"
 }
 
+declare enum Severity$1 {
+    Debug = 0,
+    Info = 1,
+    Warning = 2,
+    Error = 3,
+    Fatal = 4
+}
+
+type Context = AnyRecord;
+type Metadata = AnyRecord;
 interface SourcePosition {
     line: number;
     col: number;
@@ -91,23 +101,11 @@ interface SourceLocation {
     start: SourcePosition;
     end?: SourcePosition;
 }
-
-declare enum Severity$1 {
-    Debug = 0,
-    Info = 1,
-    Warning = 2,
-    Error = 3,
-    Fatal = 4
-}
-
 interface DiagnosticSuggestion {
     title: string;
     description?: string;
     fix?: string;
 }
-
-type Context = AnyRecord;
-type Metadata = AnyRecord;
 interface Diagnostic$1 {
     code: DiagnosticCode;
     severity: Severity$1;