praxis-kit 4.0.1 → 4.0.3

package/dist/lit/index.js

@@ -531,159 +531,21 @@ var InvariantBase = class {
   }
 };
 
-// ../../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;
-    }
-  }
-};
-
-// ../../lib/diagnostics/src/null-reporter.ts
-var nullReporter = {
-  report() {
-  }
-};
-
-// ../../lib/diagnostics/src/presets.ts
-var ignoreAllPolicy = {
-  resolve(_) {
-    return 0 /* Ignore */;
-  }
-};
-var warnOnlyReporter = {
-  report(diagnostic) {
-    console.warn(formatDiagnostic(diagnostic));
-  }
-};
-var silentDiagnostics = new Diagnostics(nullReporter, ignoreAllPolicy);
-var warnDiagnostics = new Diagnostics(
-  warnOnlyReporter,
-  new DefaultPolicy({ reportThreshold: 2 /* Warning */, throwThreshold: 4 /* Fatal */ })
-);
-var throwDiagnostics = new Diagnostics(
-  new ConsoleReporter(),
-  new DefaultPolicy({ reportThreshold: 2 /* Warning */, throwThreshold: 3 /* Error */ })
-);
-
 // ../../lib/contract/src/diagnostics/aria.ts
+import { DiagnosticCategory, DiagnosticCode } from "../_shared/diagnostics.js";
 var AriaDiagnostics = {
   /** Generic bridge for violations produced by external AriaRule functions. */
   fromViolation(v) {
     return {
-      code: "ARIA2002" /* AriaViolation */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaViolation,
+      category: DiagnosticCategory.ARIA,
       message: v.message
     };
   },
   attributeInvalid(key, role) {
     return {
-      code: "ARIA2003" /* AriaAttributeInvalid */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaAttributeInvalid,
+      category: DiagnosticCategory.ARIA,
       message: `"${key}" is not valid on role="${role}". It will be removed.`,
       rationale: "Invalid ARIA attributes are ignored by assistive technology and may trigger accessibility-tree warnings in browser devtools.",
       suggestions: [
@@ -696,8 +558,8 @@ var AriaDiagnostics = {
   },
   missingLiveRegion(role, impliedLive) {
     return {
-      code: "ARIA2004" /* AriaMissingLiveRegion */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaMissingLiveRegion,
+      category: DiagnosticCategory.ARIA,
       message: `role="${role}" implies aria-live="${impliedLive}" but it is missing. It has been injected.`,
       rationale: "Live-region roles announce dynamic content changes to screen readers. Without aria-live the politeness level is unspecified and announcements may be silent.",
       suggestions: [
@@ -711,8 +573,8 @@ var AriaDiagnostics = {
   },
   missingAtomic(role) {
     return {
-      code: "ARIA2005" /* AriaMissingAtomic */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaMissingAtomic,
+      category: DiagnosticCategory.ARIA,
       message: `role="${role}" is a live region. Consider setting aria-atomic="true" if the full region should be announced as a unit, or aria-atomic="false" if only changed nodes should be read.`,
       rationale: "aria-atomic controls whether assistive technology announces the entire live region or only the changed nodes. Omitting it leaves the behaviour browser-defined."
     };
@@ -720,8 +582,8 @@ var AriaDiagnostics = {
   relevantInvalidTokens(invalid) {
     const quoted = invalid.map((t) => `"${t}"`).join(", ");
     return {
-      code: "ARIA2006" /* AriaRelevantInvalidToken */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaRelevantInvalidToken,
+      category: DiagnosticCategory.ARIA,
       message: `aria-relevant contains invalid token(s): ${quoted}. Valid tokens are: additions, removals, text, all.`,
       rationale: "aria-relevant accepts a space-separated list of change types. Unrecognised tokens are silently ignored by assistive technology, making the attribute ineffective.",
       suggestions: [
@@ -734,8 +596,8 @@ var AriaDiagnostics = {
   },
   relevantSuperseded() {
     return {
-      code: "ARIA2007" /* AriaRelevantSuperseded */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaRelevantSuperseded,
+      category: DiagnosticCategory.ARIA,
       message: 'aria-relevant includes "all" alongside other tokens. "all" supersedes additions, removals, and text \u2014 use aria-relevant="all" alone.',
       rationale: '"all" is equivalent to "additions removals text". Combining it with other tokens is redundant and may confuse readers of the markup.',
       suggestions: [
@@ -748,8 +610,8 @@ var AriaDiagnostics = {
   },
   missingAccessibleName(tag) {
     return {
-      code: "ARIA2009" /* AriaMissingAccessibleName */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaMissingAccessibleName,
+      category: DiagnosticCategory.ARIA,
       message: `<${tag}> has no accessible name. Add aria-label or aria-labelledby.`,
       rationale: "Elements with a landmark or interactive role must have an accessible name so that assistive technology can identify them when presenting the page outline.",
       suggestions: [
@@ -766,8 +628,8 @@ var AriaDiagnostics = {
   },
   attributeOnPresentational(attr, tag) {
     return {
-      code: "ARIA2010" /* AriaAttributeOnPresentational */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaAttributeOnPresentational,
+      category: DiagnosticCategory.ARIA,
       message: `"${attr}" is not allowed on a presentational <${tag}>. Presentational elements are invisible to assistive technology.`,
       rationale: 'role="none" and role="presentation" (including <img alt="">) remove an element from the accessibility tree. ARIA attributes on such elements are ignored by assistive technology.',
       suggestions: [
@@ -780,8 +642,8 @@ var AriaDiagnostics = {
   },
   ariaHiddenOnFocusable(tag) {
     return {
-      code: "ARIA2011" /* AriaHiddenOnFocusable */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaHiddenOnFocusable,
+      category: DiagnosticCategory.ARIA,
       message: `aria-hidden="true" must not be used on focusable <${tag}> elements. Screen reader users who navigate by keyboard will encounter the element but receive no information about it.`,
       rationale: 'aria-hidden removes an element from the accessibility tree while leaving it keyboard-reachable. This creates a "ghost" \u2014 a focusable element assistive technology cannot describe.',
       suggestions: [
@@ -799,8 +661,8 @@ var AriaDiagnostics = {
   invalidAttributeValue(attr, value, expected) {
     const got = value === null ? "null" : value === void 0 ? "undefined" : typeof value === "string" ? `"${value}"` : String(value);
     return {
-      code: "ARIA2013" /* AriaInvalidAttributeValue */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaInvalidAttributeValue,
+      category: DiagnosticCategory.ARIA,
       message: `"${attr}" has an invalid value (${got}). Expected: ${expected}.`,
       rationale: "ARIA attributes with invalid values are silently ignored by assistive technology, making the markup semantically inert.",
       suggestions: [
@@ -813,8 +675,8 @@ var AriaDiagnostics = {
   },
   redundantAriaLevel(tag, level) {
     return {
-      code: "ARIA2014" /* AriaRedundantLevelAttribute */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaRedundantLevelAttribute,
+      category: DiagnosticCategory.ARIA,
       message: `aria-level="${level}" is redundant on <${tag}>: the element already has an implicit heading level of ${level}. Remove the attribute.`,
       rationale: 'Restating the implicit aria-level adds noise without semantic value. Use aria-level only to override the native heading level (e.g. aria-level="3" on <h2>).',
       suggestions: [
@@ -827,8 +689,8 @@ var AriaDiagnostics = {
   },
   requiredProperty(attr, role) {
     return {
-      code: "ARIA2012" /* AriaRequiredProperty */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaRequiredProperty,
+      category: DiagnosticCategory.ARIA,
       message: `"${attr}" is required for role="${role}" but is missing.`,
       rationale: `WAI-ARIA 1.2 specifies required states and properties for certain roles. Without "${attr}", assistive technology cannot correctly communicate the element's state to users.`,
       suggestions: [
@@ -841,8 +703,8 @@ var AriaDiagnostics = {
   },
   invalidRole(role, tag) {
     return {
-      code: "ARIA2008" /* AriaInvalidRole */,
-      category: 2 /* ARIA */,
+      code: DiagnosticCode.AriaInvalidRole,
+      category: DiagnosticCategory.ARIA,
       message: `Invalid role "${role ?? ""}" on <${tag}>.`,
       rationale: "An unrecognised or misapplied ARIA role is ignored by assistive technology and may degrade the accessibility of the element."
     };
@@ -850,11 +712,12 @@ var AriaDiagnostics = {
 };
 
 // ../../lib/contract/src/diagnostics/contract.ts
+import { DiagnosticCategory as DiagnosticCategory2, DiagnosticCode as DiagnosticCode2 } from "../_shared/diagnostics.js";
 var ContractDiagnostics = {
   unexpectedChild(typeName, index, context) {
     return {
-      code: "COMP1004" /* UnexpectedChild */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.UnexpectedChild,
+      category: DiagnosticCategory2.Contract,
       component: context,
       message: `${context}: unexpected child "${typeName}" at index ${index}.`
     };
@@ -862,69 +725,69 @@ var ContractDiagnostics = {
   ambiguousChild(typeName, index, ruleNames, context) {
     const quoted = ruleNames.map((n) => `"${n}"`).join(" and ");
     return {
-      code: "COMP1005" /* AmbiguousChild */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.AmbiguousChild,
+      category: DiagnosticCategory2.Contract,
       component: context,
       message: `${context}: child "${typeName}" at index ${index} matches multiple child rules: ${quoted}.`
     };
   },
   cardinalityMin(ruleName, min, context) {
     return {
-      code: "COMP1006" /* CardinalityMin */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.CardinalityMin,
+      category: DiagnosticCategory2.Contract,
       component: context,
       message: `${context}: "${ruleName}" requires at least ${min}.`
     };
   },
   cardinalityMax(ruleName, max, context) {
     return {
-      code: "COMP1007" /* CardinalityMax */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.CardinalityMax,
+      category: DiagnosticCategory2.Contract,
       component: context,
       message: `${context}: "${ruleName}" allows at most ${max}.`
     };
   },
   positionViolation(ruleName, position, index, context) {
     return {
-      code: "COMP1008" /* PositionViolation */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.PositionViolation,
+      category: DiagnosticCategory2.Contract,
       component: context,
       message: `${context}: "${ruleName}" must be ${position}, got index ${index}`
     };
   },
   unknownVariantDim(component, label2, dim) {
     return {
-      code: "COMP1010" /* ContractUnknownVariantDim */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.ContractUnknownVariantDim,
+      category: DiagnosticCategory2.Contract,
       message: `${component}: ${label2} references unknown variant "${dim}".`
     };
   },
   unknownVariantValue(component, label2, dim, value, valid) {
     return {
-      code: "COMP1011" /* ContractUnknownVariantValue */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.ContractUnknownVariantValue,
+      category: DiagnosticCategory2.Contract,
       message: `${component}: ${label2} sets "${dim}" to unknown value "${value}" (valid: ${valid.join(", ")}).`
     };
   },
   unknownRecipeKey(component, key) {
     return {
-      code: "COMP1012" /* ContractUnknownRecipeKey */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.ContractUnknownRecipeKey,
+      category: DiagnosticCategory2.Contract,
       message: `${component} Unknown recipeKey "${key}" \u2014 no preset with that name exists.`
     };
   },
   invalidVariantValue(component, key, value) {
     return {
-      code: "COMP1013" /* ContractInvalidVariantValue */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.ContractInvalidVariantValue,
+      category: DiagnosticCategory2.Contract,
       message: `${component} Variant "${key}=${value}" is not a defined value for the "${key}" dimension.`
     };
   },
   allowedAsViolation(tag, allowedAs, component) {
     const allowed = allowedAs.map((t) => `"${String(t)}"`).join(", ");
     return {
-      code: "COMP1009" /* AllowedAsViolation */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.AllowedAsViolation,
+      category: DiagnosticCategory2.Contract,
       component,
       message: `<${component}>: "as" prop received "${tag}" but only [${allowed}] are allowed.`
     };
@@ -932,46 +795,47 @@ var ContractDiagnostics = {
 };
 
 // ../../lib/contract/src/diagnostics/html.ts
+import { DiagnosticCategory as DiagnosticCategory3, DiagnosticCode as DiagnosticCode3 } from "../_shared/diagnostics.js";
 var HtmlDiagnostics = {
   emptyRole(tag) {
     return {
-      code: "HTML3002" /* HtmlEmptyRole */,
-      category: 1 /* HTML */,
+      code: DiagnosticCode3.HtmlEmptyRole,
+      category: DiagnosticCategory3.HTML,
       message: `<${tag}> has an explicit empty role="". Omit the attribute instead.`
     };
   },
   implicitRoleRedundant(tag, implicitRole) {
     return {
-      code: "HTML3003" /* HtmlImplicitRoleRedundant */,
-      category: 1 /* HTML */,
+      code: DiagnosticCode3.HtmlImplicitRoleRedundant,
+      category: DiagnosticCategory3.HTML,
       message: `<${tag}> already has implicit role="${implicitRole}". Avoid redundant role assignment.`
     };
   },
   implicitRoleOverride(tag, implicitRole, role) {
     return {
-      code: "HTML3004" /* HtmlImplicitRoleOverride */,
-      category: 1 /* HTML */,
+      code: DiagnosticCode3.HtmlImplicitRoleOverride,
+      category: DiagnosticCategory3.HTML,
       message: `<${tag}> should not override its implicit role="${implicitRole}" with role="${role}".`
     };
   },
   standaloneRegionOverride(tag, implicitRole) {
     return {
-      code: "HTML3005" /* HtmlStandaloneRegionOverride */,
-      category: 1 /* HTML */,
+      code: DiagnosticCode3.HtmlStandaloneRegionOverride,
+      category: DiagnosticCategory3.HTML,
       message: `<${tag}> is a self-contained element with implicit role="${implicitRole}". Assigning role="region" has been removed.`
     };
   },
   landmarkRoleOverride(tag, implicitRole, role) {
     return {
-      code: "HTML3006" /* HtmlLandmarkRoleOverride */,
-      category: 1 /* HTML */,
+      code: DiagnosticCode3.HtmlLandmarkRoleOverride,
+      category: DiagnosticCategory3.HTML,
       message: `<${tag}> has a fixed landmark role="${implicitRole}". role="${role}" overrides it and confuses assistive technology. The override has been removed.`
     };
   },
   invalidChild(child, parent, allowed) {
     return {
-      code: "HTML3007" /* HtmlInvalidChild */,
-      category: 1 /* HTML */,
+      code: DiagnosticCode3.HtmlInvalidChild,
+      category: DiagnosticCategory3.HTML,
       message: `<${child}> is not a valid direct child of <${parent}>. Allowed: ${allowed}.`
     };
   }
@@ -2135,6 +1999,7 @@ function createClassPipeline(resolved) {
 }
 
 // ../core/src/options/resolve-factory-options.ts
+import { silentDiagnostics } from "../_shared/diagnostics.js";
 var EMPTY_VARIANT_KEYS = /* @__PURE__ */ new Set();
 function composeNormalizers(normalizers, fn) {
   if (!normalizers?.length) return fn;
@@ -2226,21 +2091,25 @@ function validateRenderProps(diagnostics, options, props, recipeKey) {
   }
 }
 
+// ../core/src/factory/plugin-invariants.ts
+import { throwDiagnostics } from "../_shared/diagnostics.js";
+
 // ../core/src/factory/plugin-diagnostics.ts
+import { DiagnosticCategory as DiagnosticCategory4, DiagnosticCode as DiagnosticCode4 } from "../_shared/diagnostics.js";
 var PluginDiagnostics = {
   invalidShape(received) {
     const got = received === null ? "null" : typeof received;
     return {
-      code: "PLUGIN7001" /* PluginInvalidShape */,
-      category: 7 /* Internal */,
+      code: DiagnosticCode4.PluginInvalidShape,
+      category: DiagnosticCategory4.Internal,
       message: `[praxis-kit] Plugin factory must return an object with a 'pipeline' function. Got: ${got}.`
     };
   },
   pipelineReturnType(received) {
     const got = received === null ? "null" : Array.isArray(received) ? "array" : typeof received;
     return {
-      code: "PLUGIN7002" /* PluginPipelineReturnType */,
-      category: 7 /* Internal */,
+      code: DiagnosticCode4.PluginPipelineReturnType,
+      category: DiagnosticCategory4.Internal,
       message: `[praxis-kit] Plugin pipeline must return a string. Got: ${got}.`
     };
   }
@@ -2369,7 +2238,8 @@ function composeFilter(ownedKeys, filterProps) {
 }
 
 // ../../lib/adapter-utils/src/resolve-adapter-common-options.ts
-function resolveAdapterCommonOptions(options, defaultName = "PolymorphicComponent", defaultDiagnostics = throwDiagnostics) {
+import { throwDiagnostics as throwDiagnostics2, silentDiagnostics as silentDiagnostics2 } from "../_shared/diagnostics.js";
+function resolveAdapterCommonOptions(options, defaultName = "PolymorphicComponent", defaultDiagnostics = throwDiagnostics2) {
   return {
     name: options.name ?? defaultName,
     diagnostics: options.enforcement?.diagnostics ?? defaultDiagnostics
@@ -2377,10 +2247,11 @@ function resolveAdapterCommonOptions(options, defaultName = "PolymorphicComponen
 }
 
 // ../../adapters/lit/src/build-runtime.ts
+import { silentDiagnostics as silentDiagnostics3 } from "../_shared/diagnostics.js";
 function normalizeOptions(options) {
   return {
     ...options,
-    ...resolveAdapterCommonOptions(options, "PolymorphicElement", silentDiagnostics)
+    ...resolveAdapterCommonOptions(options, "PolymorphicElement", silentDiagnostics3)
   };
 }
 function buildRuntime(options) {