@ctrliq/quantic-components 1.86.0 → 1.87.0

package/dist/layout/layout.component.js

@@ -287,7 +287,7 @@ Layout.meta = {
     description: 'Top-level application shell that composes a collapsible sidebar, a top navbar, and a main content area. ' +
         'On small viewports the sidebar slides in as a drawer with a focus trap; on desktop it collapses to an icon rail.',
     category: 'layout',
-    subComponents: ['quantic-sidebar', 'quantic-navbar', 'quantic-page'],
+    relatedTo: ['quantic-navbar', 'quantic-page'],
     slots: {
         logo: {
             description: 'Brand logo shown in the header (no-sidebar) or inside the aside.',

package/dist/layout/sidebar-menu-item-group.component.js

@@ -29,6 +29,7 @@ SidebarMenuItemGroup.meta = {
     description: 'Grouped section of sidebar nav items with an uppercase section label. ' +
         'The label is hidden automatically when the sidebar is collapsed.',
     category: 'navigation',
+    subComponentOf: 'quantic-sidebar',
     slots: { '': { description: 'quantic-sidebar-menu-item elements belonging to this group.' } },
     relatedTo: ['quantic-sidebar', 'quantic-sidebar-menu-item'],
 };

package/dist/layout/sidebar-menu-item.component.js

@@ -62,7 +62,9 @@ SidebarMenuItem.meta = {
     description: 'Individual nav item within quantic-sidebar. Renders as a link when href is set, otherwise as a button. ' +
         'When the sidebar is collapsed on desktop, shows only the icon with a tooltip.',
     category: 'navigation',
+    subComponentOf: 'quantic-sidebar',
     slots: {
+        '': { description: 'Label content, used when the label prop is not set.' },
         icon: { description: 'Icon displayed to the left of the label.' },
         after: { description: 'Optional trailing content (e.g. badge or count).' },
     },

package/dist/layout/sidebar.component.js

@@ -103,10 +103,7 @@ Sidebar.meta = {
     description: 'Collapsible side navigation panel placed in the sidebar slot of quantic-layout. ' +
         'On desktop it can collapse to an icon rail; on mobile it is controlled by the layout as a drawer.',
     category: 'navigation',
-    subComponents: [
-        'quantic-sidebar-menu-item',
-        'quantic-sidebar-menu-item-group',
-    ],
+    subComponentOf: 'quantic-layout',
     slots: {
         header: {
             description: 'Optional sticky header rendered above the scrollable content.',

package/dist/meta/all-meta.test.js

@@ -5,6 +5,8 @@ import { describe, expect, it } from 'vitest';
 const SRC_DIR = join(dirname(fileURLToPath(import.meta.url)), '..');
 const DOCUMENTED_COMPONENT = /@quanticElement\(\s*['"`]([^'"`]+)['"`]\s*\)\s*export class (\w+)[^{]*\{\s*static meta/g;
 const ALL_META_ENTRY = /^ {2}(\w+)\.meta,$/gm;
+const SUB_COMPONENT_OF = /subComponentOf: '([^']+)'/g;
+const REGISTERED_TAG = /@quanticElement\(\s*['"`]([^'"`]+)['"`]\s*\)/g;
 function componentSources() {
     return globSync('**/*.ts', { cwd: SRC_DIR })
         .filter((file) => !/\.(stories|test|d)\.ts$/.test(file))
@@ -34,3 +36,19 @@ describe('allMeta', () => {
         expect(unparsed).toEqual([]);
     });
 });
+describe('subComponentOf', () => {
+    const sources = componentSources();
+    const registered = new Set(sources.flatMap(({ source }) => [...source.matchAll(REGISTERED_TAG)].map(([, tag]) => tag)));
+    const declared = sources.flatMap(({ file, source }) => [...source.matchAll(SUB_COMPONENT_OF)].map(([, parent]) => ({ parent, file })));
+    // A parent tag that does not exist makes the whole declaration inert: nothing
+    // derives, and any rule reading it silently never fires.
+    it('names a registered custom element', () => {
+        const unknown = declared
+            .filter(({ parent }) => !registered.has(parent))
+            .map(({ parent, file }) => `${parent} (${file})`);
+        expect(unknown).toEqual([]);
+    });
+    it('is set on something', () => {
+        expect(declared.length).toBeGreaterThan(0);
+    });
+});