praxis-kit 4.0.0 → 4.0.3

package/dist/vue/index.js

@@ -553,159 +553,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: [
@@ -718,8 +580,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: [
@@ -733,8 +595,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."
     };
@@ -742,8 +604,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: [
@@ -756,8 +618,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: [
@@ -770,8 +632,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: [
@@ -788,8 +650,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: [
@@ -802,8 +664,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: [
@@ -821,8 +683,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: [
@@ -835,8 +697,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: [
@@ -849,8 +711,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: [
@@ -863,8 +725,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."
     };
@@ -872,11 +734,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}.`
     };
@@ -884,69 +747,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, label, dim) {
     return {
-      code: "COMP1010" /* ContractUnknownVariantDim */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.ContractUnknownVariantDim,
+      category: DiagnosticCategory2.Contract,
       message: `${component}: ${label} references unknown variant "${dim}".`
     };
   },
   unknownVariantValue(component, label, dim, value, valid) {
     return {
-      code: "COMP1011" /* ContractUnknownVariantValue */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode2.ContractUnknownVariantValue,
+      category: DiagnosticCategory2.Contract,
       message: `${component}: ${label} 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.`
     };
@@ -954,73 +817,75 @@ 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}.`
     };
   }
 };
 
 // ../../lib/contract/src/diagnostics/slot.ts
+import { DiagnosticCategory as DiagnosticCategory4, DiagnosticCode as DiagnosticCode4 } from "../_shared/diagnostics.js";
 var SlotDiagnostics = {
   exclusive(name) {
     return {
-      code: "SLOT1001" /* SlotExclusive */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode4.SlotExclusive,
+      category: DiagnosticCategory4.Contract,
       component: name,
       message: `${name}: "as" and "asChild" are mutually exclusive`
     };
   },
   singleChildRequired(name, elementTerm) {
     return {
-      code: "SLOT1002" /* SlotSingleChild */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode4.SlotSingleChild,
+      category: DiagnosticCategory4.Contract,
       component: name,
       message: `${name}: asChild requires a ${elementTerm} child`
     };
   },
   singleChildExceeded(name, elementTerm, count) {
     return {
-      code: "SLOT1002" /* SlotSingleChild */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode4.SlotSingleChild,
+      category: DiagnosticCategory4.Contract,
       component: name,
       message: `${name}: asChild requires exactly one ${elementTerm} child, got ${count}`
     };
@@ -1028,16 +893,16 @@ var SlotDiagnostics = {
   discardedChildren(name, elementTerm, count) {
     const suffix = count === 1 ? "" : "ren";
     return {
-      code: "SLOT1003" /* SlotDiscardedChildren */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode4.SlotDiscardedChildren,
+      category: DiagnosticCategory4.Contract,
       component: name,
       message: `${name}: asChild discarded ${count} non-element child${suffix} \u2014 only ${elementTerm}s are valid asChild children.`
     };
   },
   renderFnRequired(name, received) {
     return {
-      code: "SLOT1004" /* SlotRenderFn */,
-      category: 0 /* Contract */,
+      code: DiagnosticCode4.SlotRenderFn,
+      category: DiagnosticCategory4.Contract,
       component: name,
       message: `${name}: asChild requires a render function as children, got ${received}`
     };
@@ -1972,6 +1837,9 @@ var readonlyProps = ({
   };
 };
 
+// ../core/src/html/evaluators.ts
+import { warnDiagnostics as warnDiagnostics2 } from "../_shared/diagnostics.js";
+
 // ../core/src/html/aria-rules.ts
 var LANDMARK_TAG_SET = /* @__PURE__ */ new Set(["article", "aside", "footer", "header", "main", "nav"]);
 var removeLandmarkRoleOverride = {
@@ -2014,6 +1882,7 @@ function landmarkNameAdvisory(ctx) {
 }
 
 // ../core/src/html/contracts.ts
+import { warnDiagnostics } from "../_shared/diagnostics.js";
 function isOpenContent(...blockedTags) {
   const set2 = new Set(blockedTags);
   return (child) => isObject(child) && "type" in child && (!isString(child.type) || !set2.has(child.type));
@@ -2158,7 +2027,7 @@ var htmlContracts = {
 };
 
 // ../core/src/html/evaluators.ts
-var htmlDiagnostics = warnDiagnostics;
+var htmlDiagnostics = warnDiagnostics2;
 function buildEvaluatorMap() {
   const map2 = /* @__PURE__ */ new Map();
   iterate.forEachEntry(htmlContracts, (tag, { children }) => {
@@ -2217,6 +2086,7 @@ function createVariantPass(activeProps, config) {
 }
 
 // ../core/src/resolver/resolver.ts
+import { silentDiagnostics } from "../_shared/diagnostics.js";
 function enforceAllowedAs(tag, allowedAs, diagnostics, displayName) {
   if (allowedAs.includes(tag)) return;
   if (!diagnostics) return;
@@ -2242,6 +2112,7 @@ function buildEngines(diagnostics, childRules, context) {
 }
 
 // ../../lib/adapter-utils/src/resolve-adapter-common-options.ts
+import { throwDiagnostics, silentDiagnostics as silentDiagnostics2 } from "../_shared/diagnostics.js";
 function resolveAdapterCommonOptions(options, defaultName = "PolymorphicComponent", defaultDiagnostics = throwDiagnostics) {
   return {
     name: options.name ?? defaultName,