stimeo-ui 0.2.1 → 0.3.0

package/dist/inspector/cli_bin.js

@@ -269,12 +269,17 @@ var DIAGNOSTIC_CODES = [
   "unknown-action-method",
   "orphan-target",
   "missing-required-target",
+  "missing-conditional-target",
   "missing-aria",
   "invalid-aria-value",
   "keyboard-inaccessible",
   "unresolved-idref",
   "managed-aria",
   "composition-mismatch",
+  "missing-companion",
+  "undeclared-target",
+  "cardinality-violation",
+  "forbidden-aria",
   "unknown-ignore-code"
 ];
 
@@ -292,6 +297,14 @@ function checkSource(source, manifest) {
     if (valueStart === void 0 || valueEnd === void 0) return false;
     return erbRanges.some(([start, end]) => start < valueEnd && end > valueStart);
   };
+  const conditionHolds = (scope, identifier, when) => {
+    if (!when) return true;
+    const hostAttr = scope.attrs.find(
+      (a) => a.name === `data-${identifier}-${dasherize(when.value)}-value`
+    );
+    if (hostAttr && isDynamicValue(hostAttr)) return null;
+    return when.equals.includes(hostAttr ? hostAttr.value.trim() : when.default);
+  };
   const suppressed = (node, code) => {
     if (code === "unknown-ignore-code") return false;
     let current = node;
@@ -339,7 +352,40 @@ function checkSource(source, manifest) {
     if (found) found.push(el);
     else byName.set(target, [el]);
   };
+  const contentHolds = (scope, identifier, element, condition) => {
+    if (!condition) return true;
+    const nodes = targetNodes.get(scope)?.get(identifier)?.get(condition.target) ?? [];
+    let held = 0;
+    for (const node of nodes) if (isWithin(node, element)) held += 1;
+    if (condition.min !== void 0 && held < condition.min) return false;
+    if (condition.max !== void 0 && held > condition.max) return false;
+    return true;
+  };
+  const elementHolds = (element, condition) => !condition?.exceptTags.includes(element.tag);
+  const roleTally = /* @__PURE__ */ new Map();
+  const focusableRoleTally = /* @__PURE__ */ new Map();
+  const documentHolds = (condition) => {
+    if (condition === void 0) return false;
+    const tally = condition.focusable ? focusableRoleTally : roleTally;
+    return (tally.get(condition.role) ?? 0) >= condition.atLeast;
+  };
+  const declarationAttrs = /* @__PURE__ */ new Set();
+  for (const controller of Object.values(known)) {
+    for (const rule of controller.targetDeclarations) declarationAttrs.add(rule.attr);
+  }
+  const declarationCandidates = [];
   walk(tree, (node) => {
+    if (declarationAttrs.size > 0 && node.attrs.some((a) => declarationAttrs.has(a.name))) {
+      declarationCandidates.push(node);
+    }
+    const roleAttr = node.attrs.find((a) => a.name === "role");
+    if (roleAttr && !isDynamicValue(roleAttr)) {
+      const role = roleAttr.value.trim();
+      roleTally.set(role, (roleTally.get(role) ?? 0) + 1);
+      if (isFocusable(node, "tab")) {
+        focusableRoleTally.set(role, (focusableRoleTally.get(role) ?? 0) + 1);
+      }
+    }
     for (const attr of node.attrs) {
       if (attr.name === IGNORE_ATTR) {
         for (const token of attr.value.split(/\s+/).filter((t) => t.length > 0)) {
@@ -418,7 +464,7 @@ function checkSource(source, manifest) {
           );
           continue;
         }
-        const targetName = attr.value.trim();
+        const targetName = isDynamicValue(attr) ? "" : attr.value.trim();
         if (targetName.length > 0 && !controller.targets.includes(targetName)) {
           const best = nearestName(targetName, controller.targets);
           report(
@@ -522,13 +568,36 @@ function checkSource(source, manifest) {
       }
     }
   }
+  for (const { node, identifier } of scopes) {
+    const controller = known[identifier];
+    if (!controller) continue;
+    const present = presence.get(node)?.get(identifier) ?? /* @__PURE__ */ new Set();
+    for (const rule of controller.conditionalTargets) {
+      if (!present.has(rule.whenPresent)) continue;
+      const missing = rule.require.filter((target) => !present.has(target));
+      if (missing.length === 0) continue;
+      report(
+        node,
+        "missing-conditional-target",
+        "error",
+        `"${identifier}" has a "${rule.whenPresent}" target, which also requires ${list(missing)}.`,
+        node,
+        rule.suggestion
+      );
+    }
+  }
   for (const { node, identifier } of scopes) {
     const controller = known[identifier];
     if (!controller) continue;
     for (const req of controller.a11y) {
+      if (conditionHolds(node, identifier, req.when) !== true) continue;
       const elements = req.target === "" ? [node] : targetNodes.get(node)?.get(identifier)?.get(req.target) ?? [];
+      if (req.whenDocument && !documentHolds(req.whenDocument)) continue;
+      const severity = documentHolds(req.escalateWhen) ? "error" : req.severity ?? "error";
       for (const el of elements) {
-        checkA11y(report, el, identifier, req);
+        if (!contentHolds(node, identifier, el, req.whenContains)) continue;
+        if (!elementHolds(el, req.whenElement)) continue;
+        checkA11y(report, el, identifier, req, severity);
       }
     }
   }
@@ -575,6 +644,32 @@ function checkSource(source, manifest) {
       }
     }
   }
+  for (const { node, identifier } of scopes) {
+    const controller = known[identifier];
+    if (!controller) continue;
+    for (const rule of controller.forbiddenAria) {
+      const elements = rule.target === "" ? [node] : targetNodes.get(node)?.get(identifier)?.get(rule.target) ?? [];
+      const where = rule.target === "" ? "scope element" : `"${rule.target}" target`;
+      for (const el of elements) {
+        if (!contentHolds(node, identifier, el, rule.whenContains)) continue;
+        for (const name of rule.attrs) {
+          const attr = el.attrs.find((a) => a.name === name);
+          if (!attr) continue;
+          if (rule.values && (isDynamicValue(attr) || !rule.values.includes(attr.value.trim()))) {
+            continue;
+          }
+          report(
+            el,
+            "forbidden-aria",
+            "warning",
+            `${name} on the ${where} of "${identifier}" contradicts the markup around it.`,
+            attr,
+            rule.suggestion
+          );
+        }
+      }
+    }
+  }
   for (const { node, identifier } of scopes) {
     const controller = known[identifier];
     if (!controller) continue;
@@ -583,14 +678,7 @@ function checkSource(source, manifest) {
       const elements = rule.target === "" ? [node] : targeted ?? (rule.fallbackToScope ? [node] : []);
       const where = rule.target === "" || !targeted ? "scope element" : `"${rule.target}" target`;
       const when = rule.when;
-      if (when) {
-        const hostAttr = node.attrs.find(
-          (a) => a.name === `data-${identifier}-${dasherize(when.value)}-value`
-        );
-        if (hostAttr && isDynamicValue(hostAttr)) continue;
-        const hostEffective = hostAttr ? hostAttr.value.trim() : when.default;
-        if (!when.equals.includes(hostEffective)) continue;
-      }
+      if (conditionHolds(node, identifier, when) !== true) continue;
       const hostContext = when ? ` (${when.value} ${list(when.equals)})` : "";
       for (const el of elements) {
         const declared = el.attrs.find((a) => a.name === "data-controller");
@@ -626,6 +714,113 @@ function checkSource(source, manifest) {
       }
     }
   }
+  for (const { node, identifier } of scopes) {
+    const controller = known[identifier];
+    if (!controller) continue;
+    for (const rule of controller.companions) {
+      const elements = rule.target === "" ? [node] : targetNodes.get(node)?.get(identifier)?.get(rule.target) ?? [];
+      const where = rule.target === "" ? "scope element" : `"${rule.target}" target`;
+      for (const el of elements) {
+        const declared = el.attrs.find((a) => a.name === "data-controller");
+        if (declared && isDynamicValue(declared)) continue;
+        if (declared && controllerIdentifiers(declared.value).includes(rule.controller)) continue;
+        report(
+          el,
+          "missing-companion",
+          "error",
+          `The ${where} of "${identifier}" must also declare "${rule.controller}" in data-controller.`,
+          declared ?? el,
+          rule.suggestion,
+          // Appending to an existing list is unambiguous; creating the
+          // attribute from nothing is an insertion the anchor cannot express.
+          declared ? valueFix(
+            declared,
+            `${declared.value.trim()} ${rule.controller}`.trim(),
+            `Add "${rule.controller}" to data-controller`
+          ) : void 0
+        );
+      }
+    }
+  }
+  for (const { node, identifier } of scopes) {
+    const controller = known[identifier];
+    if (!controller) continue;
+    if (controller.targetDeclarations.length === 0) continue;
+    const targetAttrName = `data-${identifier}-target`;
+    for (const rule of controller.targetDeclarations) {
+      for (const el of declarationCandidates) {
+        const marker = el.attrs.find((a) => a.name === rule.attr);
+        if (!marker || isDynamicValue(marker)) continue;
+        const value = marker.value.trim();
+        if (value.length === 0) continue;
+        if (rule.values && !rule.values.includes(value)) continue;
+        if (findOwner(el, identifier) !== node) continue;
+        const declaredAs = el.attrs.find((a) => a.name === targetAttrName);
+        if (declaredAs && !isDynamicValue(declaredAs) && declaredAs.value.trim() === rule.target) {
+          continue;
+        }
+        if (declaredAs && isDynamicValue(declaredAs)) continue;
+        report(
+          el,
+          "undeclared-target",
+          "error",
+          `${rule.attr}="${value}" inside "${identifier}" is not declared as its "${rule.target}" target, so the controller never manages it.`,
+          marker,
+          rule.suggestion
+        );
+      }
+    }
+  }
+  for (const { node, identifier } of scopes) {
+    const controller = known[identifier];
+    if (!controller) continue;
+    for (const rule of controller.cardinality) {
+      if (conditionHolds(node, identifier, rule.when) !== true) continue;
+      const byName = targetNodes.get(node)?.get(identifier);
+      const counted = byName?.get(rule.target) ?? [];
+      const containers = rule.within === "" ? [node] : byName?.get(rule.within) ?? [];
+      const what = describeCounted(rule.target, rule.attr, rule.values);
+      const where = rule.within === "" ? "controller scope" : `"${rule.within}" target`;
+      for (const container of containers) {
+        const matched = [];
+        for (const el of counted) {
+          if (!isWithin(el, container)) continue;
+          if (rule.attr === void 0) {
+            matched.push({ el, at: el });
+            continue;
+          }
+          const attr = el.attrs.find((a) => a.name === rule.attr);
+          if (!attr) continue;
+          if (rule.values && (isDynamicValue(attr) || !rule.values.includes(attr.value.trim()))) {
+            continue;
+          }
+          matched.push({ el, at: attr });
+        }
+        if (rule.max !== void 0 && matched.length > rule.max) {
+          for (const { el, at } of matched.slice(rule.max)) {
+            report(
+              el,
+              "cardinality-violation",
+              "error",
+              `"${identifier}" allows at most ${rule.max} ${what} per ${where}, but found ${matched.length}.`,
+              at,
+              rule.suggestion
+            );
+          }
+        }
+        if (rule.min !== void 0 && matched.length < rule.min) {
+          report(
+            container,
+            "cardinality-violation",
+            "error",
+            `"${identifier}" requires at least ${rule.min} ${what} per ${where}, but found ${matched.length}.`,
+            container,
+            rule.suggestion
+          );
+        }
+      }
+    }
+  }
   const ids = /* @__PURE__ */ new Set();
   walk(tree, (node) => {
     const id = node.attrs.find((a) => a.name === "id");
@@ -663,7 +858,7 @@ function checkSource(source, manifest) {
   diagnostics.sort((a, b) => a.line - b.line || a.column - b.column);
   return diagnostics;
 }
-function checkA11y(report, el, identifier, req) {
+function checkA11y(report, el, identifier, req, severity) {
   const groups = [
     { attrs: req.attrs, values: req.values },
     ...req.or ?? []
@@ -692,11 +887,12 @@ function checkA11y(report, el, identifier, req) {
     }
   }
   if (!anyPresent) {
+    const verb = severity === "warning" ? "recommends" : "requires";
     report(
       el,
       "missing-aria",
-      "error",
-      `"${identifier}" requires ${describeAttrs([...allowedByAttr.keys()])} on its ${where}.`,
+      severity,
+      `"${identifier}" ${verb} ${describeAttrs([...allowedByAttr.keys()])} on its ${where}.`,
       el,
       req.suggestion
     );
@@ -715,6 +911,19 @@ function checkA11y(report, el, identifier, req) {
     );
   }
 }
+function isWithin(node, container) {
+  let current = node;
+  while (current) {
+    if (current === container) return true;
+    current = current.parent;
+  }
+  return false;
+}
+function describeCounted(target, attr, values) {
+  if (attr === void 0) return `"${target}" targets`;
+  const constrained = values && values.length > 0 ? ` set to ${list(values)}` : "";
+  return `"${target}" targets with ${attr}${constrained}`;
+}
 var NATIVE_FOCUSABLE_TAGS = /* @__PURE__ */ new Set(["button", "select", "textarea", "summary"]);
 function isNativelyFocusable(el) {
   if (NATIVE_FOCUSABLE_TAGS.has(el.tag)) return true;
@@ -868,10 +1077,15 @@ var CONTROLLER_ARRAY_FIELDS = [
   "actions",
   "events",
   "requiredTargets",
+  "conditionalTargets",
   "a11y",
   "keyboard",
   "managedAria",
-  "compositions"
+  "compositions",
+  "companions",
+  "targetDeclarations",
+  "cardinality",
+  "forbiddenAria"
 ];
 function isCompatibleManifest(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
@@ -1297,6 +1511,41 @@ var EXAMPLE_RESULT_SCHEMA = {
   },
   required: ["id", "file", "source", "guidance"]
 };
+var CONTENT_CONDITION_SCHEMA = {
+  type: "object",
+  description: "Condition on the element's own contents arming the rule; absent means it does not depend on them. Evaluated per element, unlike the scope-level `when`.",
+  properties: {
+    target: { type: "string", description: "Target counted inside the element." },
+    min: { type: "integer", description: "Arms the rule when the count is at least this." },
+    max: { type: "integer", description: "Arms the rule when the count is at most this." }
+  },
+  required: ["target"]
+};
+var ELEMENT_CONDITION_SCHEMA = {
+  type: "object",
+  description: "Tags the rule is disarmed on because they name the role natively (a <table>'s <caption>, a <fieldset>'s <legend>, an <input>'s <label for>); absent means the rule applies to every spelling.",
+  properties: {
+    exceptTags: {
+      type: "array",
+      items: { type: "string" },
+      description: "Lowercase tag names whose native naming path disarms the rule."
+    }
+  },
+  required: ["exceptTags"]
+};
+var DOCUMENT_CONDITION_SCHEMA = {
+  type: "object",
+  description: "Condition on the whole file: how many elements in it carry a role. Backs ARIA's conditional name levels (a toolbar's name becomes required on the second toolbar). Counts per file, which under-approximates a page built from partials.",
+  properties: {
+    role: { type: "string", description: "Role counted across the file." },
+    atLeast: { type: "integer", description: "Holds at this many or more." },
+    focusable: {
+      type: "boolean",
+      description: "Counts only Tab-reachable carriers of the role; absent counts all. ARIA qualifies a separator's condition by focusability (a decorative hr cannot be landed on) but a toolbar's not at all."
+    }
+  },
+  required: ["role", "atLeast"]
+};
 var CONTROLLER_CONTRACT_SCHEMA = {
   type: "object",
   properties: {
@@ -1309,6 +1558,19 @@ var CONTROLLER_CONTRACT_SCHEMA = {
       ...STRING_ARRAY,
       description: "Targets that must be present at least once inside the controller scope."
     },
+    conditionalTargets: {
+      type: "array",
+      description: "Targets that become required only once another optional target appears \u2014 an opt-in feature that is incomplete without its whole set. Omitting one half passes every other check and silently does nothing.",
+      items: {
+        type: "object",
+        properties: {
+          whenPresent: { type: "string", description: "The optional target that turns it on." },
+          require: { ...STRING_ARRAY, description: "Targets required once it appears." },
+          suggestion: { type: "string" }
+        },
+        required: ["whenPresent", "require", "suggestion"]
+      }
+    },
     a11y: {
       type: "array",
       description: "Author-supplied ARIA the controller relies on but never sets itself.",
@@ -1330,6 +1592,25 @@ var CONTROLLER_CONTRACT_SCHEMA = {
               required: ["attrs"]
             }
           },
+          when: {
+            type: "object",
+            description: "Own-value condition arming the requirement; absent means unconditional. Outside the named configuration the ARIA is not optional but wrong.",
+            properties: {
+              value: { type: "string" },
+              equals: STRING_ARRAY,
+              default: { type: "string" }
+            },
+            required: ["value", "equals", "default"]
+          },
+          whenContains: CONTENT_CONDITION_SCHEMA,
+          whenElement: ELEMENT_CONDITION_SCHEMA,
+          whenDocument: DOCUMENT_CONDITION_SCHEMA,
+          severity: {
+            type: "string",
+            enum: ["error", "warning"],
+            description: 'Level of an unmet requirement; absent means "error". ARIA recommends some names rather than requiring them, and those report as warnings.'
+          },
+          escalateWhen: DOCUMENT_CONDITION_SCHEMA,
           suggestion: { type: "string" }
         },
         required: ["target", "attrs", "suggestion"]
@@ -1404,6 +1685,84 @@ var CONTROLLER_CONTRACT_SCHEMA = {
         },
         required: ["target", "coController", "require", "suggestion"]
       }
+    },
+    companions: {
+      type: "array",
+      description: "Controllers the named target must ALSO declare. Unlike compositions (which only check an already co-located companion), these report the companion being missing.",
+      items: {
+        type: "object",
+        properties: {
+          target: {
+            type: "string",
+            description: 'Target that must declare it; "" means the data-controller element.'
+          },
+          controller: { type: "string", description: "Required companion identifier." },
+          suggestion: { type: "string" }
+        },
+        required: ["target", "controller", "suggestion"]
+      }
+    },
+    targetDeclarations: {
+      type: "array",
+      description: "Reverse direction: elements in scope carrying the attribute must be declared as the named target, or the controller never manages them.",
+      items: {
+        type: "object",
+        properties: {
+          attr: { type: "string", description: 'Marking attribute, e.g. "role".' },
+          values: { ...STRING_ARRAY, description: "Marking values; absent = any value." },
+          target: {
+            type: "string",
+            description: "Target the matched element must be declared as."
+          },
+          suggestion: { type: "string" }
+        },
+        required: ["attr", "target", "suggestion"]
+      }
+    },
+    cardinality: {
+      type: "array",
+      description: "Set-level count bounds: how many of the named target may or must exist per scope or per container target, optionally narrowed to elements carrying an attribute.",
+      items: {
+        type: "object",
+        properties: {
+          within: {
+            type: "string",
+            description: 'Container target bounding the count; "" means the whole scope.'
+          },
+          target: { type: "string", description: "Target name being counted." },
+          attr: { type: "string", description: "Count only elements carrying this attribute." },
+          values: { ...STRING_ARRAY, description: "Restrict the attribute to these values." },
+          min: { type: "integer", description: "Smallest permitted count (inclusive)." },
+          max: { type: "integer", description: "Largest permitted count (inclusive)." },
+          when: {
+            type: "object",
+            description: "Own-value condition arming the bound; absent means unconditional.",
+            properties: {
+              value: { type: "string" },
+              equals: STRING_ARRAY,
+              default: { type: "string" }
+            },
+            required: ["value", "equals", "default"]
+          },
+          suggestion: { type: "string" }
+        },
+        required: ["within", "target", "suggestion"]
+      }
+    },
+    forbiddenAria: {
+      type: "array",
+      description: "ARIA the author owns that the surrounding markup contradicts (e.g. a menu still declaring itself busy once its items are present). Reported as a warning \u2014 unlike managedAria, the attribute is the author's and is required in the other configuration.",
+      items: {
+        type: "object",
+        properties: {
+          target: { type: "string" },
+          attrs: STRING_ARRAY,
+          values: { ...STRING_ARRAY, description: "Forbidden values; absent = any value." },
+          whenContains: CONTENT_CONDITION_SCHEMA,
+          suggestion: { type: "string" }
+        },
+        required: ["target", "attrs", "suggestion"]
+      }
     }
   },
   required: [
@@ -1413,10 +1772,15 @@ var CONTROLLER_CONTRACT_SCHEMA = {
     "actions",
     "events",
     "requiredTargets",
+    "conditionalTargets",
     "a11y",
     "keyboard",
     "managedAria",
-    "compositions"
+    "compositions",
+    "companions",
+    "targetDeclarations",
+    "cardinality",
+    "forbiddenAria"
   ]
 };
 var InvalidToolArgsError = class extends Error {
@@ -1429,7 +1793,7 @@ var TOOL_DESCRIPTORS = [
   {
     name: "stimeo_check",
     title: "Check Stimeo UI markup",
-    description: "Statically check HTML or ERB source that uses Stimeo UI (stimeo--*) controllers. Returns a CheckReport with diagnostics \u2014 unknown controllers/targets/values/action methods, missing required targets, missing or invalid author-supplied ARIA, keyboard-focusability prerequisites, and misaligned cross-controller composition values \u2014 each with a fix suggestion when available. Call this on generated markup before finalizing it; ok=true means no errors.",
+    description: "Statically check HTML or ERB source that uses Stimeo UI (stimeo--*) controllers \u2014 the headless, accessible Stimulus UI component library for Rails. Returns a CheckReport with diagnostics \u2014 unknown controllers/targets/values/action methods, missing required targets, missing or invalid author-supplied ARIA, keyboard-focusability prerequisites, and misaligned cross-controller composition values \u2014 each with a fix suggestion when available. Call this to validate any Rails view, ERB template, or HTML you write or edit with these components, before finalizing it; ok=true means no errors.",
     annotations: READ_ONLY_ANNOTATIONS,
     inputSchema: {
       type: "object",
@@ -1451,7 +1815,7 @@ var TOOL_DESCRIPTORS = [
   {
     name: "stimeo_catalog",
     title: "List Stimeo UI controllers",
-    description: "List every Stimeo UI controller with its targets, values, actions, and events. Use this to discover which stimeo--* controllers exist and the data-* API each accepts before writing markup.",
+    description: "List every Stimeo UI controller with its targets, values, actions, and events. Stimeo UI is a headless, accessible (WAI-ARIA APG) Stimulus UI component library for Rails: dialog/modal, drawer, dropdown menu, tabs, accordion, combobox, listbox, tooltip, popover, toast, carousel, data grid, date picker, tree view, and many more. Start here to find which stimeo--* controller implements a requested component and the data-* API it accepts before writing markup.",
     annotations: READ_ONLY_ANNOTATIONS,
     inputSchema: {
       type: "object",
@@ -1463,7 +1827,7 @@ var TOOL_DESCRIPTORS = [
   {
     name: "stimeo_controller",
     title: "Get one controller's usage contract",
-    description: 'Fetch the full usage contract of one Stimeo UI controller by identifier (e.g. "stimeo--tabs"): targets, values, actions, events, required targets, and the accessibility contract \u2014 author-supplied ARIA requirements, keyboard-focusability prerequisites, the ARIA attributes the controller manages at runtime (which the author must NOT hardcode), and cross-controller composition value alignments.',
+    description: 'Fetch the full usage contract of one Stimeo UI controller by identifier (e.g. "stimeo--tabs"): targets, values, actions, events, required targets, and the accessibility contract \u2014 author-supplied ARIA requirements, keyboard-focusability prerequisites, the ARIA attributes the controller manages at runtime (which the author must NOT hardcode), and cross-controller composition value alignments. Use it after stimeo_catalog to write correct, accessible Rails ERB or HTML markup for that Stimulus component.',
     annotations: READ_ONLY_ANNOTATIONS,
     inputSchema: {
       type: "object",
@@ -1481,7 +1845,7 @@ var TOOL_DESCRIPTORS = [
   {
     name: "stimeo_example",
     title: "Get one controller's verified example markup",
-    description: 'Fetch verified example markup for one Stimeo UI controller by identifier (e.g. "stimeo--menu"). The example is the official catalog demo \u2014 it passes stimeo_check against the bundled manifest, so use it as the reference for correct structure, required targets, and author-supplied ARIA. class attributes in it are demo styling placeholders to replace; the stimeo--* data attributes and role/aria-* attributes are the contract to keep.',
+    description: 'Fetch verified example markup for one Stimeo UI controller by identifier (e.g. "stimeo--menu"). The example is the official catalog demo \u2014 it passes stimeo_check against the bundled manifest, so use it as the reference for correct structure, required targets, and author-supplied ARIA. class attributes in it are demo styling placeholders to replace; the stimeo--* data attributes and role/aria-* attributes are the contract to keep. Copy it as the starting point when adding that accessible Stimulus component to a Rails ERB view.',
     annotations: READ_ONLY_ANNOTATIONS,
     inputSchema: {
       type: "object",
@@ -1693,7 +2057,13 @@ var McpSession = class {
         title: "Stimeo UI Inspector",
         version: this.#context.manifest.packageVersion
       },
-      instructions: "Stimeo UI is a headless Stimulus UI framework for Rails. Use stimeo_catalog to discover controllers, stimeo_controller for one controller's usage and accessibility contract, stimeo_example for verified reference markup, and stimeo_check to validate generated HTML/ERB before presenting it. The full manifest and every example are also exposed as resources (stimeo:// URIs), and the stimeo_build_ui / stimeo_fix_markup prompts bake this workflow into user-invokable templates."
+      // The server's own account of itself. Per the MCP schema this is a hint
+      // a client MAY put in front of the model, which makes it the earliest
+      // point this server can be routed to — clients that defer tool
+      // definitions still tend to load it alongside the tool names. Hence the
+      // trigger condition first, in the words a request would use, and a
+      // length that survives truncation.
+      instructions: "Search for these tools whenever a task involves building, editing, or reviewing an accessible UI component in a Rails view \u2014 dialog/modal, drawer, dropdown menu, tabs, accordion, combobox, toast, and the rest of the catalog \u2014 or whenever HTML/ERB carrying stimeo--* attributes is in play. Stimeo UI is a headless Stimulus UI framework for Rails. Use stimeo_catalog to discover controllers, stimeo_controller for one controller's usage and accessibility contract, stimeo_example for verified reference markup, and stimeo_check to validate generated HTML/ERB before presenting it. The full manifest and every example are also exposed as resources (stimeo:// URIs), and the stimeo_build_ui / stimeo_fix_markup prompts bake this workflow into user-invokable templates."
     });
   }
   #getPrompt(id, params) {
@@ -1807,40 +2177,41 @@ async function runMcpServer(io) {
 
 // src/inspector/cli_bin.ts
 var argv = process2.argv.slice(2);
+process2.stdout.on("error", (error) => {
+  process2.exit(error.code === "EPIPE" ? 0 : 1);
+});
 if (argv[0] === "mcp") {
   if (argv.includes("--help") || argv.includes("-h")) {
-    process2.exit(runCli(["--help"]));
-  }
-  process2.stdout.on("error", (error) => {
-    process2.exit(error.code === "EPIPE" ? 0 : 1);
-  });
-  runMcpServer({
-    input: process2.stdin,
-    write: (line) => {
-      process2.stdout.write(`${line}
+    process2.exitCode = runCli(["--help"]);
+  } else {
+    runMcpServer({
+      input: process2.stdin,
+      write: (line) => {
+        process2.stdout.write(`${line}
 `);
-    },
-    load: () => ({ manifest: loadManifest(), examples: loadExamplesIndex() }),
-    logError: (message) => {
-      process2.stderr.write(`stimeo mcp: ${message}
+      },
+      load: () => ({ manifest: loadManifest(), examples: loadExamplesIndex() }),
+      logError: (message) => {
+        process2.stderr.write(`stimeo mcp: ${message}
 `);
-    }
-  }).then(
-    // Set the exit code instead of calling process.exit so any buffered
-    // stdout responses are flushed before the process ends.
-    () => {
-      process2.exitCode = 0;
-    },
-    (error) => {
-      process2.stderr.write(
-        `stimeo mcp: ${error instanceof Error ? error.message : String(error)}
+      }
+    }).then(
+      // Set the exit code instead of calling process.exit so any buffered
+      // stdout responses are flushed before the process ends.
+      () => {
+        process2.exitCode = 0;
+      },
+      (error) => {
+        process2.stderr.write(
+          `stimeo mcp: ${error instanceof Error ? error.message : String(error)}
 `
-      );
-      process2.exitCode = 1;
-    }
-  );
+        );
+        process2.exitCode = 1;
+      }
+    );
+  }
 } else {
-  process2.exit(runCli(argv));
+  process2.exitCode = runCli(argv);
 }
 //# sourceMappingURL=cli_bin.js.map
 //# sourceMappingURL=cli_bin.js.map