stimeo-ui 0.17.0 → 0.18.0

package/dist/inspector/cli.d.ts

@@ -99,10 +99,10 @@ interface ControllerManifest {
      */
     readonly a11y: readonly A11yRequirement[];
     /**
-     * Keyboard prerequisites (stage 3): targets whose documented contract makes
-     * the *author* responsible for focusability — the controller
-     * moves focus (or relies on the Tab order) but never writes `tabindex` for
-     * them. Each listed target must be natively focusable or carry `tabindex`.
+     * Keyboard prerequisites (stage 3): targets whose markup contract in the
+     * controller's class TSDoc makes the *author* responsible for focusability —
+     * the controller moves focus (or relies on the Tab order) but never writes
+     * `tabindex` for them. Each listed target must be natively focusable or carry `tabindex`.
      * Targets whose controller initializes a roving tabindex on connect (tabs,
      * toolbar, radio group, …) are deliberately excluded.
      */
@@ -566,6 +566,10 @@ interface CardinalityRule {
     readonly min?: number;
     /** Largest permitted count (inclusive); omit for no ceiling. */
     readonly max?: number;
+    /** Diagnostic severity; omitted constraints report errors. */
+    readonly severity?: DiagnosticSeverity;
+    /** Ignore targets and containers across template contents from the owning scope. */
+    readonly excludeTemplateContents?: boolean;
     /**
      * Restricts the constraint to one configuration of the controller's own
      * value; omit for unconditional constraints. Multiplicity is frequently a
@@ -680,11 +684,12 @@ interface TemplateRootRule {
  * present.
  *
  * `requiredTargets` is unconditional, which cannot express a feature that is
- * entirely opt-in but **incomplete without its whole set**. A breadcrumb without any `collapsible` is a valid plain
- * trail; add one and the disclosure (`ellipsis` + `trigger`) becomes mandatory,
- * because without it the collapsed items have no control that can reveal them. A
- * file-dropzone without an `itemTemplate` never renders a list; add one without a
- * `list` and the selected files render nowhere.
+ * entirely opt-in but **incomplete without its whole set**. A `stimeo--breadcrumb`
+ * without any `collapsible` is a valid plain trail; add one and the disclosure
+ * (`ellipsis` + `trigger`) becomes mandatory, because without it the collapsed
+ * items have no control that can reveal them. A `stimeo--file-dropzone` without an
+ * `itemTemplate` never renders a list; add one without a `list` and the selected
+ * files render nowhere.
  *
  * These fail the same way: the required targets are *present enough* to pass every
  * other check, the page loads, `stimeo check` is green — and the feature silently
@@ -746,8 +751,7 @@ interface ConditionalTargetRule {
     readonly suggestion: string;
 }
 /**
- * One element shape that can act as a host for {@link
- * ConditionalTargetRule.requireSameHost}.
+ * One element shape that can act as a host for {@link ConditionalTargetRule.requireSameHost}.
  *
  * A tag alone is too coarse where the element's `type` decides its role, so an
  * optional attribute filter narrows it. Omitting {@link attr} accepts the tag

package/dist/inspector/cli.js

@@ -16,17 +16,20 @@ var ANNOUNCING_CONTROLLERS = [
   "stimeo--flash",
   "stimeo--form-field",
   "stimeo--frame-loading",
+  "stimeo--live-counter",
   "stimeo--meter",
   "stimeo--multi-select",
   "stimeo--nested-form",
   "stimeo--network-status",
   "stimeo--password-strength",
+  "stimeo--presence",
   "stimeo--progress",
   "stimeo--skeleton",
   "stimeo--sortable",
   "stimeo--spinner",
   "stimeo--submit-once",
-  "stimeo--tags-input"
+  "stimeo--tags-input",
+  "stimeo--typing-indicator"
 ];
 function positionAt(source, index) {
   const before = source.slice(0, index);
@@ -2071,9 +2074,11 @@ function checkSource(source, manifest) {
       const what = describeCounted(rule.target, rule.attr, rule.values);
       const where = rule.within === "" ? "controller scope" : `"${rule.within}" target`;
       for (const container of containers) {
+        if (rule.excludeTemplateContents && crossesTemplateContent(container, node)) continue;
         const matched = [];
         for (const el of counted) {
           if (!isSelfOrDescendantOf(el, container)) continue;
+          if (rule.excludeTemplateContents && crossesTemplateContent(el, node)) continue;
           if (rule.attr === void 0) {
             matched.push({ el, at: el });
             continue;
@@ -2090,7 +2095,7 @@ function checkSource(source, manifest) {
             report(
               el,
               "cardinality-violation",
-              "error",
+              rule.severity ?? "error",
               `"${identifier}" allows at most ${rule.max} ${what} per ${where}, but found ${matched.length}.`,
               at,
               rule.suggestion
@@ -2102,7 +2107,7 @@ function checkSource(source, manifest) {
           report(
             container,
             "cardinality-violation",
-            complete ? "error" : "warning",
+            complete ? rule.severity ?? "error" : "warning",
             `"${identifier}" requires at least ${rule.min} ${what} per ${where}, but found ${matched.length}.`,
             container,
             complete ? rule.suggestion : UNRESOLVED_TARGET_HINT
@@ -2330,6 +2335,14 @@ var IDREF_ATTRS = /* @__PURE__ */ new Set([
   "aria-owns"
 ]);
 var IGNORE_ATTR = "data-stimeo-ignore";
+function crossesTemplateContent(node, scope) {
+  if (node === scope) return false;
+  for (let parent = node.parent; parent; parent = parent.parent) {
+    if (parent.tag === "template") return true;
+    if (parent === scope) return false;
+  }
+  return false;
+}
 function findOwner(node, identifier) {
   let current = node;
   while (current && current.tag !== "#root") {