snice 7.3.0 → 7.4.0

package/.agents/skills/snice/SKILL.md

@@ -12,22 +12,11 @@ reconstruct Snice APIs from Lit or generic web-component conventions.
 
 Make this decision before creating files or choosing decorators:
 
-- **Visual behavior belongs in the element.** Rendering, internal DOM, focus,
-  keyboard behavior, visual state, and translation of internal-part events into
-  the element's semantic events stay in the `@element` class.
-- **Application behavior specific to a set of elements belongs in a
-  controller.** API/storage access, business rules, and app-specific reactions
-  that exist for those elements stay in an `@controller` class.
-- **Element orchestration belongs in the page.** A `@page` composes elements,
-  passes properties, handles their events, binds their controllers, and
-  coordinates the screen. Routing is one page concern; it is not the definition
-  of the page's role.
-
-Do not attach a controller to the page host or move orchestration into a “page
-controller.” Do not move visual behavior into a controller merely to make an
-element smaller. A host-free reusable function may stay a plain module wherever
-the project convention puts it. State plus lifecycle belongs in an explicitly
-constructed `@daemon`, not a singleton.
+- **Element:** visual behavior, rendering, internal DOM, focus, keyboard behavior, visual state, and semantic events.
+- **Controller:** application behavior specific to a set of elements, including API/storage access and business rules.
+- **Page:** element orchestration: composition, properties, events, controller binding, and screen coordination. Routing is only one page concern.
+
+Do not attach a controller to a page host, create a “page controller,” or move visual behavior into a controller to shrink an element. Host-free reusable functions may stay plain modules. State plus lifecycle belongs in an explicitly constructed `@daemon`, never a singleton.
 
 Examples: focus/internal buttons → element; element-specific API behavior → controller;
 coordinating search, results, and dialog elements → page; state plus lifecycle → daemon.
@@ -76,6 +65,11 @@ type-checks with `npx tsc -p references/tsconfig.kitchen-sink.json` after
 - Import React wrappers from `snice/react`; also register each underlying
   custom element through its documented deep side-effect import.
 - Pass objects and arrays through property bindings, not string attributes.
+- In Router-backed controllers, receive `Context` with `@context()` and use
+  `ctx.fetch` for middleware-aware transport. Managed decorators activate
+  after `attach()`, so context-dependent startup belongs in the `@context()`
+  handler. Do not call bare `fetch`, import the Router into the controller, or
+  invent another context-injection channel.
 - Preserve native form, keyboard, focus, and accessibility behavior.
 - Use the project compiler configuration for TC39 decorators.
 - Do not edit generated distribution, adapter, metadata, or website output.
@@ -85,6 +79,8 @@ configuration, import, hallucination, and component-recommendation checks.
 Use `npx snice doctor` or `npx snice validate` only when isolating the
 configuration or source half of a failed check.
 
+Diagnostics expose stable codes. After reading the referenced AI docs and verifying intentional acceptance, the agent may record the narrowest suppression in project-root `.sniceignore`: `code path:line:column` (one diagnostic), `code path` (one file), or `code` (global). Use global only when the project rejects the rule. Never suppress merely to pass a gate; comment non-obvious reasons.
+
 ## Verify
 
 Run the consuming project's available checks in this order:

package/README.md

@@ -433,7 +433,11 @@ setValue(val: string) {
 
 ### Global State
 
-**`@context(options?)`** - Receive router context updates (global state)
+**`@context(options?)`** - Receive Router context updates on pages, descendant
+elements, and attached controllers. Controllers can use the same
+middleware-aware `ctx.fetch` as pages; context-dependent controller startup
+belongs in the `@context()` handler because managed decorators activate after
+`attach()`.
 ```typescript
 // Method decorator that receives context updates
 @context()

package/adapters/react/SniceProvider.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.2.0
+ * snice v7.3.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/adapters/react/SniceRouter.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.2.0
+ * snice v7.3.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/adapters/react/matchRoute.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.2.0
+ * snice v7.3.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/adapters/react/useRequestHandler.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.2.0
+ * snice v7.3.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/bin/analyzer-contracts.js

@@ -21,7 +21,7 @@ export const ANALYZER_CONTRACTS = {
     "componentModules": 188,
     "componentUtilityModules": 31,
     "reactWrappers": 193,
-    "rootExports": 116
+    "rootExports": 118
   },
   "rootExports": [
     "AdoptedOptions",
@@ -30,6 +30,7 @@ export const ANALYZER_CONTRACTS = {
     "Context",
     "ContextAwareFetcher",
     "ContextOptions",
+    "ContextProviderOptions",
     "ControllerClass",
     "CreateRequestHandlerOptions",
     "DaemonMap",
@@ -99,6 +100,7 @@ export const ANALYZER_CONTRACTS = {
     "escapeHtml",
     "getBodyScrollLockCount",
     "getContext",
+    "getContextFetch",
     "getController",
     "getSymbol",
     "html",

package/bin/project-analyzer.js

@@ -47,6 +47,11 @@ const LEGACY_LIT_LIFECYCLE = new Set([
   'performUpdate'
 ]);
 
+const NATIVE_ELEMENT_IDL_MEMBERS = new Set([
+  'autofocus', 'dir', 'hidden', 'id', 'inert', 'lang', 'role', 'slot',
+  'title', 'translate'
+]);
+
 const SNICE_REACT_EVENT_PROPS = new Set([
   'onInputChange', 'onSelectChange', 'onTextareaChange', 'onCheckboxChange',
   'onRadioChange', 'onSliderChange', 'onDateChange', 'onTimeChange',
@@ -525,6 +530,44 @@ const RULE_DEFINITIONS = [
       }
     }
   },
+  {
+    id: 'snice/imperative-controller-attach',
+    severity: 'suggestion',
+    category: 'architecture',
+    description: 'Prefer declarative controller bindings in application templates.',
+    check(context) {
+      if (isFrameworkImplementation(context.filename) || isTestFilename(context.filename)) return;
+      for (const localName of localsFor(context.provenance.rootBindings, 'attachController')) {
+        const pattern = new RegExp(`\\b${escapeRegExp(localName)}\\s*\\(`, 'g');
+        for (const match of context.source.matchAll(pattern)) {
+          context.report(match.index, {
+            message: `${localName}() imperatively attaches a controller in application code even though controller bindings own this lifecycle declaratively.`,
+            fix: 'Bind the decorated class in the owning template with controller=${ControllerClass}. Keep imperative attachment for focused framework tests only. Review docs/ai/controllers.md.'
+          });
+        }
+      }
+    }
+  },
+  {
+    id: 'snice/element-member-shadows-native-idl',
+    severity: 'warning',
+    category: 'properties',
+    description: 'Warn when a Snice element redeclares an inherited HTMLElement IDL member.',
+    check(context) {
+      if (isFrameworkImplementation(context.filename)) return;
+      for (const declaration of findSniceElementClasses(context.source)) {
+        const members = inspectElementMembers(declaration.body);
+        for (const name of new Set([...members.fields, ...members.accessors, ...members.reactive])) {
+          if (!NATIVE_ELEMENT_IDL_MEMBERS.has(name)) continue;
+          const relativeIndex = members.memberIndices.get(name) ?? 0;
+          context.report(declaration.bodyStart + relativeIndex, {
+            message: `${declaration.name}.${name} shadows HTMLElement.${name}, so native reflection/accessibility behavior and Snice property binding can conflict.`,
+            fix: `Rename the application-owned member. If native ${name} semantics are intended, use the inherited HTMLElement property/attribute without redeclaring it.`
+          });
+        }
+      }
+    }
+  },
   {
     id: 'snice/self-ready-await',
     severity: 'error',
@@ -806,6 +849,51 @@ const RULE_DEFINITIONS = [
       }
     }
   },
+  {
+    id: 'snice/live-control-value-binding',
+    severity: 'suggestion',
+    category: 'rendering',
+    description: 'Recommend live property bindings for controlled values on verified self-mutating Snice controls.',
+    check(context) {
+      const components = {
+        'snice-input': 'input',
+        'snice-textarea': 'textarea',
+        'snice-segmented-control': 'segmented-control'
+      };
+      for (const opening of findOpeningTags(context.source, Object.keys(components))) {
+        const binding = /(?:^|\s)value\s*=\s*(?:['"])?\$\{/.exec(opening.text);
+        if (!binding) continue;
+        const valueIndex = opening.index + binding.index + binding[0].indexOf('value');
+        context.report(valueIndex, {
+          message: `${opening.name} receives a dynamic value attribute, but its live value can diverge after user interaction.`,
+          fix: `For a controlled value, import live from 'snice' and use .value=\${live(value)} so an owner render compares with the control's current property. Keep value= only for an authored/reset default. Review docs/ai/components/${components[opening.name]}.md and docs/ai/bindings.md.`
+        });
+      }
+    }
+  },
+  {
+    id: 'snice/prefer-dispatch-decorator',
+    severity: 'suggestion',
+    category: 'events',
+    description: 'Prefer @dispatch for static CustomEvents emitted from a Snice host.',
+    check(context) {
+      if (isFrameworkImplementation(context.filename)) return;
+
+      const declarations = [
+        ...findSniceElementClasses(context.source).map(declaration => ({ declaration, role: 'element' })),
+        ...findDecoratedClasses(context.source, 'controller').map(declaration => ({ declaration, role: 'controller' }))
+      ];
+
+      for (const { declaration, role } of declarations) {
+        for (const dispatch of findManualCustomEventDispatches(declaration.body, role)) {
+          context.report(declaration.bodyStart + dispatch.index, {
+            message: `Manual host dispatch of "${dispatch.eventName}" duplicates the standard @dispatch CustomEvent path.`,
+            fix: `Prefer an emitter method decorated with @dispatch('${dispatch.eventName}') and return the detail payload directly. Keep dispatchEvent() when code needs the Event object, a dynamic event name, or the cancellation boolean. Review docs/ai/events.md.`
+          });
+        }
+      }
+    }
+  },
   {
     id: 'snice/custom-event-contract',
     severity: 'error',
@@ -1424,6 +1512,14 @@ const RULE_DEFINITIONS = [
     projectOnly: true,
     check() {}
   },
+  {
+    id: 'snice/shadowed-query-route',
+    severity: 'warning',
+    category: 'router',
+    description: 'Warn when same-page string route order makes a query-parameter variant unreachable.',
+    projectOnly: true,
+    check() {}
+  },
   {
     id: 'snice/template-reads-nonreactive-field',
     severity: 'warning',
@@ -1465,7 +1561,7 @@ const RULE_DEFINITIONS = [
  */
 export const PROJECT_ANALYZER_RULES = Object.freeze(
   RULE_DEFINITIONS.map(({ id, severity, category, description }) =>
-    Object.freeze({ id, severity, category, description })
+    Object.freeze({ id, code: id, severity, category, description })
   )
 );
 
@@ -1476,6 +1572,7 @@ export const PROJECT_ANALYZER_RULES = Object.freeze(
  * @param {string} [filename=''] Optional filename included in every diagnostic.
  * @returns {Array<{
  *   severity: 'error'|'warning'|'suggestion',
+ *   code: string,
  *   ruleId: string,
  *   message: string,
  *   fix: string,
@@ -1499,6 +1596,7 @@ export function analyzeSource(source, filename = '') {
     const location = sourceLocation(source, Math.max(0, nonSource.index));
     return [{
       severity: 'error',
+      code: 'snice/non-source-content',
       ruleId: 'snice/non-source-content',
       message: nonSource.message,
       fix: nonSource.fix,
@@ -1526,6 +1624,7 @@ export function analyzeSource(source, filename = '') {
         seen.add(key);
         const diagnostic = {
           severity: rule.severity,
+          code: rule.id,
           ruleId: rule.id,
           message: detail.message,
           fix: detail.fix,
@@ -1868,6 +1967,27 @@ export function analyzeProject(files) {
         column: location.column
       });
     }
+
+    const precedingBareRoutes = new Set();
+    for (const route of findPageStringRoutes(page.file.source, page.index)) {
+      const queryIndex = route.spec.indexOf('?');
+      const pathname = queryIndex >= 0 ? route.spec.slice(0, queryIndex) : route.spec;
+      if (queryIndex < 0) {
+        precedingBareRoutes.add(pathname);
+        continue;
+      }
+      if (!precedingBareRoutes.has(pathname)) continue;
+      const location = sourceLocation(page.file.source, route.index);
+      diagnostics.push({
+        severity: 'warning',
+        ruleId: 'snice/shadowed-query-route',
+        message: `${page.name}'s query route "${route.spec}" is shadowed by an earlier "${pathname}" entry with the same specificity, so its query properties never bind.`,
+        fix: `Move "${route.spec}" before "${pathname}" in the routes array, or use route objects with explicit order values when a more complex tie-break is intentional. Review docs/ai/routing.md.`,
+        file: page.file.filename,
+        line: location.line,
+        column: location.column
+      });
+    }
   }
   for (const [key, declarations] of declarationsByClass) {
     const page = declarations.find(declaration => declaration.decorator === 'page');
@@ -2040,7 +2160,9 @@ export function analyzeProject(files) {
     }
   }
 
-  return diagnostics.sort(compareProjectDiagnostics);
+  return diagnostics
+    .map(diagnostic => diagnostic.code ? diagnostic : { ...diagnostic, code: diagnostic.ruleId })
+    .sort(compareProjectDiagnostics);
 }
 
 /**
@@ -2290,10 +2412,91 @@ function findSniceElementClasses(source) {
   return declarations;
 }
 
+/**
+ * Find standalone, static CustomEvent dispatches that @dispatch can express
+ * without changing control flow. Calls whose return value is consumed, whose
+ * event name is dynamic, or whose target is not the Snice host are deliberately
+ * left alone as valid low-level event code.
+ */
+function findManualCustomEventDispatches(body, role) {
+  const dispatches = [];
+  const pattern = role === 'controller'
+    ? /\bthis\s*\.\s*element\s*(?:\?\.\s*|\.\s*)dispatchEvent\s*\(/g
+    : /\bthis\s*\.\s*dispatchEvent\s*\(/g;
+
+  for (const match of body.matchAll(pattern)) {
+    const lineStart = body.lastIndexOf('\n', match.index) + 1;
+    if (body.slice(lineStart, match.index).trim()) continue;
+
+    const dispatchOpen = body.indexOf('(', match.index);
+    const dispatchClose = findMatchingDelimiter(body, dispatchOpen, '(', ')');
+    if (dispatchOpen < 0 || dispatchClose < 0) continue;
+
+    let afterDispatch = dispatchClose + 1;
+    while (body[afterDispatch] === ' ' || body[afterDispatch] === '\t') afterDispatch++;
+    if (body[afterDispatch] !== ';') continue;
+    const lineEnd = body.indexOf('\n', afterDispatch);
+    const remainder = body.slice(afterDispatch + 1, lineEnd < 0 ? body.length : lineEnd);
+    if (remainder.trim()) continue;
+
+    let cursor = dispatchOpen + 1;
+    while (/\s/.test(body[cursor] ?? '')) cursor++;
+    if (!body.startsWith('new', cursor) || /[\w$]/.test(body[cursor + 3] ?? '')) continue;
+    cursor += 3;
+    while (/\s/.test(body[cursor] ?? '')) cursor++;
+    if (!body.startsWith('CustomEvent', cursor) || /[\w$]/.test(body[cursor + 11] ?? '')) continue;
+    cursor += 11;
+    while (/\s/.test(body[cursor] ?? '')) cursor++;
+
+    if (body[cursor] === '<') {
+      const genericClose = findMatchingDelimiter(body, cursor, '<', '>');
+      if (genericClose < 0) continue;
+      cursor = genericClose + 1;
+      while (/\s/.test(body[cursor] ?? '')) cursor++;
+    }
+
+    if (body[cursor] !== '(') continue;
+    cursor++;
+    while (/\s/.test(body[cursor] ?? '')) cursor++;
+    const eventName = /^(['"])([^'"]+)\1/.exec(body.slice(cursor));
+    if (!eventName) continue;
+
+    dispatches.push({ index: match.index, eventName: eventName[2] });
+  }
+
+  return dispatches;
+}
+
 function findElementDecoratorTag(source, index) {
   return /^@element\s*\(\s*['"]([^'"]+)['"]/.exec(source.slice(index, index + 500))?.[1] ?? null;
 }
 
+function findPageStringRoutes(source, decoratorIndex) {
+  const open = source.indexOf('(', decoratorIndex);
+  if (open < 0) return [];
+  const close = findMatchingDelimiter(source, open, '(', ')');
+  if (close < 0) return [];
+  const argumentsSource = source.slice(open + 1, close);
+  const routesProperty = /\broutes\s*:\s*\[/.exec(argumentsSource);
+  if (!routesProperty) return [];
+  const arrayOpen = open + 1 + routesProperty.index + routesProperty[0].lastIndexOf('[');
+  const arrayClose = findMatchingDelimiter(source, arrayOpen, '[', ']');
+  if (arrayClose < 0 || arrayClose > close) return [];
+
+  const body = source.slice(arrayOpen + 1, arrayClose);
+  const routes = [];
+  let searchFrom = 0;
+  for (const item of splitTopLevelArguments(body)) {
+    const relative = body.indexOf(item, searchFrom);
+    if (relative < 0) continue;
+    searchFrom = relative + item.length;
+    const literal = /^(['"])([^'"]+)\1$/.exec(item);
+    if (!literal) continue;
+    routes.push({ spec: literal[2], index: arrayOpen + 1 + relative });
+  }
+  return routes;
+}
+
 function inspectElementMembers(body) {
   const code = blankStringContents(maskComments(body));
   const depths = new Uint16Array(code.length + 1);
@@ -2309,11 +2512,13 @@ function inspectElementMembers(body) {
   const readonly = new Set();
   const functionFields = new Set();
   const reactive = new Set();
-  const fieldPattern = /(?:^|\n)\s*((?:(?:public|private|protected|static|readonly|override|declare|abstract)\s+)*)([A-Za-z_$][\w$]*)\s*[!?]?\s*(?::[^=\n;{]+)?\s*(?==|;)/g;
+  const memberIndices = new Map();
+  const fieldPattern = /(?:^|\n)\s*((?:(?:public|private|protected|static|readonly|override|declare|abstract)\s+)*)([A-Za-z_$][\w$]*)\s*[!?]?\s*(?::[^=\n;]+)?\s*(?==|;)/g;
   for (const match of code.matchAll(fieldPattern)) {
     const nameIndex = match.index + match[0].lastIndexOf(match[2]);
     if (depths[nameIndex] !== 0) continue;
     fields.add(match[2]);
+    if (!memberIndices.has(match[2])) memberIndices.set(match[2], nameIndex);
     if (/\breadonly\b/.test(match[1])) readonly.add(match[2]);
   }
   const functionFieldPattern = /(?:^|\n)\s*(?:(?:public|private|protected|static|readonly|override|declare|abstract)\s+)*([A-Za-z_$][\w$]*)\s*[!?]?\s*(?::[^=\n;{]+)?\s*=\s*(?:async\s*)?(?:\([^\n)]*\)|[A-Za-z_$][\w$]*)\s*=>/g;
@@ -2324,7 +2529,10 @@ function inspectElementMembers(body) {
   const accessorPattern = /(?:^|\n)\s*(?:(?:public|private|protected|static|readonly|override|declare|abstract)\s+)*(?:get|set|accessor)\s+([A-Za-z_$][\w$]*)\b/g;
   for (const match of code.matchAll(accessorPattern)) {
     const nameIndex = match.index + match[0].lastIndexOf(match[1]);
-    if (depths[nameIndex] === 0) accessors.add(match[1]);
+    if (depths[nameIndex] === 0) {
+      accessors.add(match[1]);
+      if (!memberIndices.has(match[1])) memberIndices.set(match[1], nameIndex);
+    }
   }
   const decoratedPattern = /@(property|state)\b/g;
   for (const match of code.matchAll(decoratedPattern)) {
@@ -2337,7 +2545,12 @@ function inspectElementMembers(body) {
       cursor = close + 1;
     }
     const declaration = /^\s*(?:(?:public|private|protected|static|readonly|override|declare|abstract)\s+)*(?:accessor\s+)?([A-Za-z_$][\w$]*)/.exec(code.slice(cursor));
-    if (declaration) reactive.add(declaration[1]);
+    if (declaration) {
+      reactive.add(declaration[1]);
+      if (!memberIndices.has(declaration[1])) {
+        memberIndices.set(declaration[1], cursor + declaration.index + declaration[0].lastIndexOf(declaration[1]));
+      }
+    }
   }
 
   // An undecorated native-style accessor can still be reactive when its
@@ -2366,7 +2579,7 @@ function inspectElementMembers(body) {
     if (close >= 0 && invalidates(body.slice(open + 1, close))) invalidatingAccessors.add(match[1]);
   }
 
-  return { fields, accessors, readonly, functionFields, reactive, invalidatingAccessors };
+  return { fields, accessors, readonly, functionFields, reactive, invalidatingAccessors, memberIndices };
 }
 
 function findDecoratedClassMethods(body, decoratorName, bodyStart = 0) {

package/bin/snice.js

@@ -14,7 +14,7 @@ import {
 import { execFile } from 'node:child_process';
 import { createRequire } from 'node:module';
 import { tmpdir } from 'node:os';
-import { basename, dirname, join, resolve } from 'node:path';
+import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { promisify } from 'node:util';
 import { analyzeProject, findImports, isTypeOnlyImport, maskComments } from './project-analyzer.js';
@@ -26,6 +26,7 @@ const packageRoot = join(__dirname, '..');
 const packageJson = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'));
 const argv = process.argv.slice(2);
 const command = argv[0];
+const DIAGNOSTIC_IGNORE_FILENAME = '.sniceignore';
 
 function help() {
   console.log(`Snice CLI ${packageJson.version}
@@ -52,6 +53,9 @@ Commands:
 AI setup:
   npx snice init-ai   Install version-matched guidance before an agent writes Snice code.
 
+Diagnostics:
+  .sniceignore        Suppress diagnostic codes globally or at an exact source location.
+
 Build options:
   --output=<dir>       Output directory (default: ./dist/cdn)
   --format=iife,es     Output formats (default: iife; table: iife,es)
@@ -207,21 +211,79 @@ function walkSource(root) {
 }
 
 function validateProject(targetDir, json = false) {
-  const issues = collectValidationIssues(targetDir);
+  const ignored = readDiagnosticIgnores(targetDir);
+  const issues = collectValidationIssues(targetDir, ignored);
   renderValidation(issues, json);
   return issues;
 }
 
-function collectValidationIssues(targetDir) {
+function collectValidationIssues(targetDir, ignored = readDiagnosticIgnores(targetDir)) {
   const sourceRoot = existsSync(join(targetDir, 'src')) ? join(targetDir, 'src') : targetDir;
   const projectFiles = ['package.json', 'tsconfig.json', 'index.html']
     .map(filename => join(targetDir, filename))
     .filter(existsSync);
   const files = [...new Set([...projectFiles, ...walkSource(sourceRoot)])].sort();
-  return analyzeProject(files.map(file => ({
+  const issues = analyzeProject(files.map(file => ({
     filename: file,
     source: readFileSync(file, 'utf8')
   })));
+  return filterIgnoredDiagnostics(issues, ignored, targetDir);
+}
+
+function readDiagnosticIgnores(targetDir) {
+  const path = join(targetDir, DIAGNOSTIC_IGNORE_FILENAME);
+  if (!existsSync(path)) return [];
+
+  const entries = [];
+  for (const authoredLine of readFileSync(path, 'utf8').replace(/^\uFEFF/, '').split(/\r?\n/)) {
+    const line = authoredLine.replace(/\s+#.*$/, '').trim();
+    if (!line || line.startsWith('#')) continue;
+    const separator = line.search(/\s/);
+    const code = separator < 0 ? line : line.slice(0, separator);
+    const locator = separator < 0 ? '' : line.slice(separator).trim();
+    if (!locator) {
+      entries.push({ code });
+      continue;
+    }
+
+    let file = locator;
+    let lineNumber;
+    let column;
+    const exact = /^(.*):(\d+):(\d+)$/.exec(locator);
+    const lineOnly = exact ? null : /^(.*):(\d+)$/.exec(locator);
+    if (exact) {
+      file = exact[1];
+      lineNumber = Number(exact[2]);
+      column = Number(exact[3]);
+    } else if (lineOnly) {
+      file = lineOnly[1];
+      lineNumber = Number(lineOnly[2]);
+    }
+    if (!file) continue;
+    entries.push({ code, file: normalizeDiagnosticPath(file), line: lineNumber, column });
+  }
+  return entries;
+}
+
+function filterIgnoredDiagnostics(diagnostics, ignored, targetDir) {
+  if (!ignored.length) return diagnostics;
+  return diagnostics.filter(diagnostic => !ignored.some(entry => {
+    const code = diagnostic.code ?? diagnostic.ruleId;
+    if (entry.code !== code) return false;
+    if (!entry.file) return true;
+    if (!diagnostic.file) return false;
+    const absolute = isAbsolute(diagnostic.file)
+      ? diagnostic.file
+      : resolve(targetDir, diagnostic.file);
+    if (normalizeDiagnosticPath(relative(targetDir, absolute)) !== entry.file) return false;
+    if (entry.line !== undefined && diagnostic.line !== entry.line) return false;
+    if (entry.column !== undefined && diagnostic.column !== entry.column) return false;
+    return true;
+  }));
+}
+
+function normalizeDiagnosticPath(path) {
+  return path.replaceAll('\\', '/').replace(/^\.\//, '');
 }
 
 function renderValidation(issues, json = false) {
@@ -230,7 +292,7 @@ function renderValidation(issues, json = false) {
   else {
     for (const issue of issues) {
       console.log(
-        `[${issue.severity.toUpperCase()}] ${issue.file ?? ''}:${issue.line}:${issue.column} ${issue.ruleId}\n` +
+        `[${issue.severity.toUpperCase()}] ${issue.file ?? ''}:${issue.line}:${issue.column} ${issue.code}\n` +
         `  ${issue.message}\n  ${issue.fix}`
       );
     }
@@ -280,7 +342,8 @@ function resolveTsconfigChain(dir, entry = 'tsconfig.json', seen = new Set()) {
 }
 
 async function doctor(targetDir, json = false) {
-  const findings = await collectDoctorFindings(targetDir);
+  const ignored = readDiagnosticIgnores(targetDir);
+  const findings = await collectDoctorFindings(targetDir, ignored);
   renderDoctor(findings, json);
   return findings;
 }
@@ -381,7 +444,7 @@ async function probeDecoratorTransform(targetDir, add, projectPackage) {
   }
 }
 
-async function collectDoctorFindings(targetDir) {
+async function collectDoctorFindings(targetDir, ignored = readDiagnosticIgnores(targetDir)) {
   const findings = [];
   const add = (severity, code, message) => findings.push({ severity, code, message });
   const projectPackage = readJson(join(targetDir, 'package.json'));
@@ -443,7 +506,7 @@ async function collectDoctorFindings(targetDir) {
 
   await probeDecoratorTransform(targetDir, add, projectPackage);
 
-  return findings;
+  return filterIgnoredDiagnostics(findings, ignored, targetDir);
 }
 
 function renderDoctor(findings, json = false) {
@@ -451,15 +514,16 @@ function renderDoctor(findings, json = false) {
   const warnings = findings.filter(item => item.severity === 'warning').length;
   if (json) console.log(JSON.stringify({ ok: errors === 0, findings }, null, 2));
   else {
-    for (const finding of findings) console.log(`[${finding.severity.toUpperCase()}] ${finding.message}`);
+    for (const finding of findings) console.log(`[${finding.severity.toUpperCase()}] ${finding.code} ${finding.message}`);
     console.log(`Doctor finished with ${errors} error(s) and ${warnings} warning(s).`);
   }
   if (errors) process.exitCode = 1;
 }
 
 async function checkProject(targetDir, json = false) {
-  const findings = await collectDoctorFindings(targetDir);
-  const issues = collectValidationIssues(targetDir);
+  const ignored = readDiagnosticIgnores(targetDir);
+  const findings = await collectDoctorFindings(targetDir, ignored);
+  const issues = collectValidationIssues(targetDir, ignored);
   const ok = !findings.some(item => item.severity === 'error') &&
     !issues.some(item => item.severity === 'error');
 
@@ -467,12 +531,12 @@ async function checkProject(targetDir, json = false) {
     console.log(JSON.stringify({ ok, findings, issues }, null, 2));
   } else {
     console.log('Project configuration:');
-    for (const finding of findings) console.log(`[${finding.severity.toUpperCase()}] ${finding.message}`);
+    for (const finding of findings) console.log(`[${finding.severity.toUpperCase()}] ${finding.code} ${finding.message}`);
     console.log('\nSnice source:');
     if (!issues.length) console.log('No Snice authoring issues found.');
     for (const issue of issues) {
       console.log(
-        `[${issue.severity.toUpperCase()}] ${issue.file ?? ''}:${issue.line}:${issue.column} ${issue.ruleId}\n` +
+        `[${issue.severity.toUpperCase()}] ${issue.file ?? ''}:${issue.line}:${issue.column} ${issue.code}\n` +
         `  ${issue.message}\n  ${issue.fix}`
       );
     }

package/dist/app-context.d.ts

@@ -1,11 +1,11 @@
-import { getContext } from './context-provider';
+import { getContext, getContextFetch } from './context-provider';
 import type { AppContext } from './types/app-context';
-/**
- * Makes one explicit application context visible beneath a root.
- *
- * Daemon instances must already exist in context.daemons. The returned cleanup
- * removes the provider and deactivates framework communication for daemons no
- * longer provided by any context.
- */
-export declare function provideContext(root: EventTarget, context: AppContext): () => void;
-export { getContext };
+import type { Context } from './types/context';
+export interface ContextProviderOptions {
+    /** Fetch function exposed to descendants through getContextFetch(). */
+    fetch?: typeof globalThis.fetch;
+}
+export declare function provideContext(root: EventTarget, context: AppContext, options?: ContextProviderOptions): () => void;
+/** @internal Router-owned provider including live navigation state. */
+export declare function provideRouterContext(root: EventTarget, navigation: Context): () => void;
+export { getContext, getContextFetch };

package/dist/cdn/accordion/snice-accordion.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.3.0
+ * snice v7.4.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.