@fusion.dev/helix-docs 0.177.1 → 0.178.0

package/dist/catalog.d.ts

@@ -62,6 +62,12 @@ export interface Element {
     cssProperties: ApiMember[];
     cssStates: ApiMember[];
     description: string;
+    /**
+     * The entry that registers the element, under the tier's package: the
+     * family's own, such as `filter-input`, or one of its own where the family's
+     * leaves it out, such as `filter-input/menu`.
+     */
+    entry: string;
     events: EventDoc[];
     label: string;
     methods: ApiMember[];

package/dist/catalog.js

@@ -72,9 +72,28 @@ const examplesOf = (slug, declared, sources) => {
         };
     }));
 };
+const entriesOf = (manifest) => {
+    const entries = new Map();
+    for (const module of manifest.modules ?? []) {
+        const entry = /^src\/(.+)\/index\.ts$/.exec(module.path ?? '')?.[1];
+        if (!entry) {
+            continue;
+        }
+        for (const exported of module.exports ?? []) {
+            const from = exported.declaration?.module?.replace(/\.[jt]s$/, '');
+            const held = from === undefined ? undefined : entries.get(from);
+            if (from !== undefined && (held === undefined || entry.length < held.length)) {
+                entries.set(from, entry);
+            }
+        }
+    }
+    return entries;
+};
 export const catalog = (manifests, examples = []) => {
     const byFamily = new Map();
+    const entryOf = new Map();
     for (const manifest of manifests) {
+        const entries = entriesOf(manifest);
         for (const module of manifest.modules ?? []) {
             for (const declaration of module.declarations ?? []) {
                 if (!declaration.tagName) {
@@ -85,6 +104,7 @@ export const catalog = (manifests, examples = []) => {
                     continue;
                 }
                 byFamily.set(family, [...(byFamily.get(family) ?? []), declaration]);
+                entryOf.set(declaration, entries.get((module.path ?? '').replace(/\.[jt]s$/, '')) ?? family);
             }
         }
     }
@@ -105,6 +125,7 @@ export const catalog = (manifests, examples = []) => {
                 cssProperties: members(entry.cssProperties),
                 cssStates: members(entry.cssStates),
                 description: entry.description ?? '',
+                entry: entryOf.get(entry) ?? slug,
                 events: (entry.events ?? []).map((event) => ({
                     description: event.description ?? '',
                     name: event.name ?? '',