@fusion.dev/helix-diagnostics 0.167.0 → 0.168.0

package/README.md

@@ -266,6 +266,7 @@ works on it:
 | `dead-part` | error | A `::part()` names a part the element does not publish |
 | `dead-hook` | error | A hook is set where nothing answers it, or a name close to a hook is set that nothing reads |
 | `unknown-attribute` | error | A Helix element carries an attribute it does not take |
+| `unknown-slot` | error | A child names a slot its Helix element does not have, so it is not drawn. Found by `helix scan`, from the templates |
 | `invalid-value` | error | An attribute with a closed set of values carries one outside it, so the element falls back to its default |
 | `unforwarded-part` | warn | The headless tier publishes the part and the styled tier does not forward it, which is a gap in Helix |
 | `unknown-tag` | error | A rule names a tag no manifest lists |

package/dist/identity.js

@@ -6,6 +6,7 @@ const CATEGORY = {
     'manifest-skew': 'integrity',
     'unforwarded-part': 'styling',
     'unknown-attribute': 'markup',
+    'unknown-slot': 'markup',
     'unknown-tag': 'integrity',
 };
 const OWNER = {
@@ -16,6 +17,7 @@ const OWNER = {
     'manifest-skew': 'consumer',
     'unforwarded-part': 'helix',
     'unknown-attribute': 'consumer',
+    'unknown-slot': 'consumer',
     'unknown-tag': 'consumer',
 };
 export const normalize = (subject) => subject

package/dist/manifest.d.ts

@@ -47,14 +47,17 @@ export interface ManifestSource {
             cssProperties?: Array<{
                 name: string;
             }>;
+            slots?: Array<{
+                name: string;
+            }>;
             tagName?: string;
         }>;
     }>;
 }
 /**
  * What diagnostics reads of one package's manifest, and nothing else: per
- * tag, the parts, the hooks, the attributes with the values each allows, the
- * attributes the element writes on itself, and the family.
+ * tag, the parts, the hooks, the slots, the attributes with the values each
+ * allows, the attributes the element writes on itself, and the family.
  *
  * **About a seventieth of the manifest.** Measured 4 Oct 2026: 124 KB for the
  * styled tier and 103 KB for the headless one, 18 KB and 14 KB compressed,
@@ -77,6 +80,11 @@ export interface LintTag {
     family?: string | undefined;
     hooks: string[];
     parts: string[];
+    /**
+     * The slots the element has, by name, the default one as `""`. Absent from
+     * lint data written before 0.165, which a reader takes as unknown.
+     */
+    slots?: string[];
     /** The attributes the element writes on itself: one named for a read-only member. */
     written: string[];
 }

package/dist/manifest.js

@@ -12,6 +12,7 @@ export const lintOf = (manifest, name) => {
                 family,
                 hooks: [],
                 parts: [],
+                slots: [],
                 written: [],
             };
             tags[tag] = entry;
@@ -26,12 +27,14 @@ export const lintOf = (manifest, name) => {
             }
             entry.parts.push(...(declaration.cssParts ?? []).map((part) => part.name));
             entry.hooks.push(...(declaration.cssProperties ?? []).map((hook) => hook.name));
+            entry.slots?.push(...(declaration.slots ?? []).map((slot) => slot.name));
         }
     }
     for (const entry of Object.values(tags)) {
         entry.written = [...new Set(entry.written)];
         entry.parts = [...new Set(entry.parts)];
         entry.hooks = [...new Set(entry.hooks)];
+        entry.slots = [...new Set(entry.slots)];
     }
     return {
         package: manifest.helix?.package ?? name,

package/dist/report.d.ts

@@ -97,7 +97,7 @@ export interface Finding {
     tag: string;
 }
 /** Every fault class, stable across versions. */
-export declare const KINDS: readonly ['dead-hook', 'dead-part', 'duplicate-registration', 'invalid-value', 'manifest-skew', 'unforwarded-part', 'unknown-attribute', 'unknown-tag'];
+export declare const KINDS: readonly ['dead-hook', 'dead-part', 'duplicate-registration', 'invalid-value', 'manifest-skew', 'unforwarded-part', 'unknown-attribute', 'unknown-slot', 'unknown-tag'];
 /** A fault class. */
 export type Kind = (typeof KINDS)[number];
 /** How serious a finding is. */

package/dist/report.js

@@ -6,6 +6,7 @@ export const KINDS = [
     'manifest-skew',
     'unforwarded-part',
     'unknown-attribute',
+    'unknown-slot',
     'unknown-tag',
 ];
 export const CATEGORIES = [

package/dist/rules.js

@@ -8,6 +8,7 @@ export const SHIPPED_RULES = {
     'manifest-skew': 'error',
     'unforwarded-part': 'warn',
     'unknown-attribute': 'error',
+    'unknown-slot': 'error',
     'unknown-tag': 'error',
 };
 const SEVERITIES = new Set(['error', 'info', 'off', 'warn']);

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  * release, so the two never disagree; a spec beside this holds them to it.
  * Nothing else in the running code knows which release it is.
  */
-export declare const VERSION = "0.167.0";
+export declare const VERSION = "0.168.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.167.0';
+export const VERSION = '0.168.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-diagnostics",
   "description": "Finds the Helix mistakes that are valid CSS: dead parts, misnamed hooks, two copies of the library.",
-  "version": "0.167.0",
+  "version": "0.168.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -33,7 +33,7 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "devDependencies": {
-    "@fusion.dev/helix-testing": "0.167.0",
+    "@fusion.dev/helix-testing": "0.168.0",
     "@types/bun": "^1.4.2"
   },
   "homepage": "https://fusion.dev",