forgebook 0.1.8 → 0.3.0

package/dist/src/storyTree.js

@@ -1,6 +1,10 @@
+import { pageProblems, treePages } from "./pageTree.js";
 import { sourceFiles } from "./sourceFiles.js";
+import { csfStoryId, exportWords, idPart } from "./storyIds.js";
+import { groupAt, metaList, placeAliases, relatedTitles } from "./treePlaces.js";
 /**
- * A text in lower-case kebab case, as CSF writes ids: every run of other characters becomes one `-`.
+ * A text in lower-case kebab case, split at its case changes: the rule ids had before they followed Storybook's, kept
+ * to find a story by an id written then (`formerStoryId`).
  *
  * @param text - any text.
  */
@@ -10,34 +14,48 @@ export const kebab = (text) => text
     .replace(/[^a-z0-9]+/g, "-")
     .replace(/^-|-$/g, "");
 /**
- * A story's id.
+ * A story's id: the source's id, then Storybook's id of the story.
  *
  * @param sourceId - the source's id (`acme-ui`).
- * @param title - the file's title.
+ * @param component - the meta's `id` when it writes one, else the title.
  * @param exportName - the story's export.
  */
-export const storyId = (sourceId, title, exportName) => `${sourceId}:${kebab(title)}--${kebab(exportName)}`;
+export const storyId = (sourceId, component, exportName) => `${sourceId}:${csfStoryId(component, exportName)}`;
 /**
- * A component's id: its source and title, the part of its stories' ids before `--`.
+ * A component's id: its source and Storybook's id of the component, the part of its stories' ids before `--`.
  *
  * @param sourceId - the source's id (`acme-ui`).
- * @param title - the file's title.
+ * @param component - the meta's `id` when it writes one, else the title.
  */
-export const componentId = (sourceId, title) => `${sourceId}:${kebab(title)}`;
+export const componentId = (sourceId, component) => `${sourceId}:${idPart(component)}`;
 /**
- * A story's name from its export, in sentence case: `KeyboardOpen` → "Keyboard open", `Size2X` → "Size 2 x".
+ * The id a component had under the former rule (`kebab`), which an address written then still names.
+ *
+ * @param sourceId - the source's id.
+ * @param title - the component's title.
+ */
+export const formerComponentId = (sourceId, title) => `${sourceId}:${kebab(title)}`;
+/**
+ * The id a story had under the former rule (`kebab`), which an address written then still names.
+ *
+ * @param sourceId - the source's id.
+ * @param title - the component's title.
+ * @param exportName - the story's export.
+ */
+export const formerStoryId = (sourceId, title, exportName) => `${formerComponentId(sourceId, title)}--${kebab(exportName)}`;
+/**
+ * A story's name from its export: its words as Storybook splits them (`exportWords`), in sentence case, a word written
+ * in capitals kept so: `KeyboardOpen` → "Keyboard open", `CustomSVGIcon` → "Custom SVG icon", `Size2X` → "Size 2 X".
  *
  * @param exportName - the named export.
  */
-export const storyName = (exportName) => {
-    const words = exportName
-        .replace(/([a-z])([A-Z0-9])/g, "$1 $2")
-        .replace(/([0-9])([A-Za-z])/g, "$1 $2")
-        .replace(/_/g, " ")
-        .trim()
-        .toLowerCase();
-    return words.charAt(0).toUpperCase() + words.slice(1);
-};
+export const storyName = (exportName) => exportWords(exportName)
+    .map((word, index) => {
+    if (index === 0)
+        return word.charAt(0).toUpperCase() + word.slice(1);
+    return word === word.toUpperCase() ? word : word.toLowerCase();
+})
+    .join(" ");
 /**
  * Where a title places its component, or why it cannot be placed.
  *
@@ -79,128 +97,159 @@ const byGroup = (order) => (left, right) => {
         return 1;
     return rankIn(order, left) - rankIn(order, right) || left.localeCompare(right);
 };
-/** The files of one source placed by their titles; a title that cannot be placed, or is taken, is a problem. */
-const placedFiles = (source, problems) => {
-    const placed = [];
-    const seenTitles = new Map();
-    for (const [file, entry] of Object.entries(sourceFiles(source).index)) {
+/**
+ * The component a file's title starts, or why it cannot: its title has no place, or makes no id, or an id another
+ * title already has (Storybook would merge their stories under one id; the catalogue could open only one).
+ *
+ * @param source - the source.
+ * @param file - the file.
+ * @param entry - its index.
+ * @param titlesById - the titles of the source's components so far, by id.
+ */
+const startedComponent = (source, file, entry, titlesById) => {
+    const place = titlePlace(entry.title);
+    if (typeof place === "string")
+        return place;
+    const component = entry.id ?? entry.title;
+    if (idPart(component) === "")
+        return `"${component}" makes no id: it needs a letter or a digit`;
+    const id = componentId(source.id, component);
+    const other = titlesById.get(id);
+    if (other !== undefined)
+        return `"${entry.title}" has the id "${id}" of "${other}"`;
+    return { title: entry.title, id, files: [{ file, entry }], ...place };
+};
+/**
+ * The components of one source, its files placed by their titles and merged when they share one; a title that cannot
+ * be placed, or that makes no id or a taken one, is a problem.
+ */
+const placedComponents = (source, problems) => {
+    const byTitle = new Map();
+    const titlesById = new Map();
+    const index = sourceFiles(source).index;
+    // sorted, so a component's files, and so its stories, its docs and a clash's winner, never depend on the groups' order
+    for (const file of Object.keys(index).sort()) {
+        const entry = index[file];
+        if (entry === undefined)
+            continue;
         for (const note of entry.notes ?? [])
             problems.push(`${source.name}: ${file}: ${note}`);
-        const place = titlePlace(entry.title);
-        if (typeof place === "string") {
-            problems.push(`${source.name}: ${file}: ${place}`);
+        const placed = byTitle.get(entry.title);
+        if (placed !== undefined) {
+            placed.files = [...placed.files, { file, entry }];
             continue;
         }
-        const other = seenTitles.get(entry.title);
-        if (other !== undefined) {
-            problems.push(`${source.name}: ${file} and ${other} have the same title "${entry.title}"`);
+        const started = startedComponent(source, file, entry, titlesById);
+        if (typeof started === "string") {
+            problems.push(`${source.name}: ${file}: ${started}`);
             continue;
         }
-        seenTitles.set(entry.title, file);
-        placed.push({ file, entry, ...place });
+        byTitle.set(entry.title, started);
+        titlesById.set(started.id, entry.title);
     }
-    return placed;
+    return [...byTitle.values()];
 };
+/** Whether a story is kept out of the catalogue's lists: tagged `!dev`, as Storybook's sidebar leaves it out. */
+const isUnlisted = (story) => story.tags.includes("!dev");
 /**
- * Each component's related titles, both ways, by its title: a link written in one meta reaches both pages. A title
- * that names no component of the source, or the component itself, is a problem.
+ * A story of the tree: its index entry under its file's meta.
+ *
+ * @param id - its id.
+ * @param file - its file.
+ * @param entry - its file's index.
+ * @param story - its entry in the index.
+ * @param design - its design: its own, else its file's meta's.
  */
-const relatedTitles = (source, placed, problems) => {
-    const names = new Map(placed.map((file) => [file.entry.title, file.name]));
-    const links = new Map();
-    const link = (from, to) => {
-        links.set(from, (links.get(from) ?? new Set()).add(to));
-    };
-    for (const { file, entry } of placed) {
-        for (const title of entry.related ?? []) {
-            if (title === entry.title)
-                problems.push(`${source.name}: ${file} names itself as related`);
-            else if (!names.has(title))
-                problems.push(`${source.name}: ${file} names "${title}" as related: no such title`);
-            else {
-                link(entry.title, title);
-                link(title, entry.title);
-            }
-        }
-    }
-    return new Map([...links.entries()].map(([title, others]) => [
-        title,
-        [...others].sort((left, right) => (names.get(left) ?? left).localeCompare(names.get(right) ?? right))
-    ]));
-};
-/** The family and group a place of `alsoIn` names (`Data/Tables`, `Data`), or why it cannot be one. */
-const aliasPlace = (place) => {
-    const segments = place.split("/").map((segment) => segment.trim());
-    if (segments.some((segment) => segment === ""))
-        return `"${place}" has an empty segment`;
-    const [family = "", group, ...rest] = segments;
-    if (rest.length > 0)
-        return `"${place}" is not Family or Family/Group`;
-    return { family, group };
-};
-/** A family's group as it is being built, created when it is not there yet. */
-const groupAt = (families, family, group) => {
-    const groups = families.get(family) ?? new Map();
-    families.set(family, groups);
-    const found = groups.get(group) ?? { components: [], aliases: [] };
-    groups.set(group, found);
-    return found;
+const treeStory = (id, file, entry, story, design) => ({
+    id,
+    file,
+    name: story.name ?? storyName(story.exportName),
+    exportName: story.exportName,
+    controls: story.controls ?? entry.controls ?? "all",
+    group: story.group,
+    description: story.description,
+    isMain: story.isMain === true,
+    isTouch: story.isTouch ?? entry.isTouch ?? false,
+    isLogic: story.isLogic ?? entry.isLogic ?? false,
+    height: story.height ?? entry.height,
+    device: entry.device === undefined && story.device === undefined
+        ? undefined
+        : { ...entry.device, ...story.device },
+    design,
+    requiredFirst: story.requiredFirst ?? entry.requiredFirst,
+    tags: story.tags ?? [],
+    hasPlay: story.hasPlay === true
+});
+/**
+ * A story's id: the one it writes, else the one its meta and its export make; or why it has none.
+ *
+ * @param sourceId - the source's id.
+ * @param entry - its file's index.
+ * @param story - its entry in the index.
+ */
+const treeStoryId = (sourceId, entry, story) => {
+    if (story.id === "")
+        return new Error(`story ${story.exportName} writes an empty id (\`parameters.__id\`)`);
+    if (story.id !== undefined)
+        return `${sourceId}:${story.id}`;
+    if (idPart(exportWords(story.exportName).join(" ")) === "")
+        return new Error(`story ${story.exportName} makes no id: its name needs a letter or a digit`);
+    return storyId(sourceId, entry.id ?? entry.title, story.exportName);
 };
 /**
- * Lists each component in the other places its meta names, beside the components that live there. A place that is
- * the component's own, or that already holds a component of the same name, is a problem.
+ * The stories of a component's files, each meta's settings under its own stories. A story whose id is empty or taken
+ * (by any story of the source: Storybook refuses both) is a problem, and left out.
+ *
+ * @param source - the source.
+ * @param component - the component.
+ * @param seenIds - the ids of the source's stories so far, with their files; the new ones are added.
+ * @param problems - where a problem goes.
  */
-const placeAliases = (source, placed, families, problems) => {
-    for (const { file, entry, family, group, name } of placed) {
-        for (const place of entry.alsoIn ?? []) {
-            const at = aliasPlace(place);
-            if (typeof at === "string") {
-                problems.push(`${source.name}: ${file}: also in ${at}`);
-                continue;
-            }
-            if (at.family === family && at.group === group) {
-                problems.push(`${source.name}: ${file} is also in "${place}", its own place`);
-                continue;
-            }
-            const target = groupAt(families, at.family, at.group);
-            if ([...target.components, ...target.aliases].some((other) => other.name === name)) {
-                problems.push(`${source.name}: ${file} is also in "${place}", which already lists a ${name}`);
-                continue;
-            }
-            target.aliases.push({ name, title: entry.title });
-        }
+const componentStories = (source, component, seenIds, problems) => component.files.flatMap(({ file, entry }) => entry.stories.flatMap((story) => {
+    const id = treeStoryId(source.id, entry, story);
+    const other = typeof id === "string" ? seenIds.get(id) : undefined;
+    if (id instanceof Error || other !== undefined) {
+        const problem = id instanceof Error
+            ? id.message
+            : `story ${story.exportName} has the id "${id}" of a story in ${other}`;
+        problems.push(`${source.name}: ${file}: ${problem}`);
+        return [];
     }
-};
-/** Whether a story is kept out of the catalogue's lists: tagged `!dev`, as Storybook's sidebar leaves it out. */
-const isUnlisted = (story) => story.tags.includes("!dev");
+    seenIds.set(id, file);
+    // its own link, else its file's meta's; `null` is its own link the index refused, which stays refused
+    const design = story.design === undefined ? entry.design : (story.design ?? undefined);
+    return [treeStory(id, file, entry, story, design)];
+}));
+/**
+ * A component's design: its first file's meta's, as its docs are.
+ *
+ * @param component - the component.
+ */
+const componentDesign = (component) => component.files[0]?.entry.design;
 /** The families of one source, from its files. */
 const sourceFamilies = (source, problems) => {
-    const placed = placedFiles(source, problems);
+    const placed = placedComponents(source, problems);
     const related = relatedTitles(source, placed, problems);
     const families = new Map();
-    for (const { file, entry, family, group, name } of placed) {
-        const stories = entry.stories.map((story) => ({
-            id: storyId(source.id, entry.title, story.exportName),
-            name: story.name ?? storyName(story.exportName),
-            exportName: story.exportName,
-            controls: story.controls ?? entry.controls ?? "all",
-            group: story.group,
-            description: story.description,
-            isMain: story.isMain === true,
-            isTouch: story.isTouch ?? entry.isTouch ?? false,
-            isLogic: story.isLogic ?? entry.isLogic ?? false,
-            height: story.height ?? entry.height,
-            tags: story.tags ?? []
-        }));
+    const seenIds = new Map();
+    for (const component of placed) {
+        const { title, family, group, name, files } = component;
+        const stories = componentStories(source, component, seenIds, problems);
         groupAt(families, family, group).components.push({
+            id: component.id,
             name,
-            title: entry.title,
-            file,
+            title,
+            file: files[0]?.file ?? "",
+            files: files.map((each) => each.file),
             stories: stories.filter((story) => !isUnlisted(story)),
             unlisted: stories.filter(isUnlisted),
-            alsoIn: entry.alsoIn ?? [],
-            related: related.get(entry.title) ?? [],
-            keywords: entry.keywords ?? []
+            alsoIn: metaList(component, "alsoIn"),
+            related: related.get(title) ?? [],
+            keywords: metaList(component, "keywords"),
+            design: componentDesign(component),
+            // its first file's, as its docs are
+            propGroups: component.files[0]?.entry.propGroups ?? [],
+            requiredFirst: component.files[0]?.entry.requiredFirst
         });
     }
     placeAliases(source, placed, families, problems);
@@ -222,6 +271,16 @@ const sourceFamilies = (source, problems) => {
         };
     });
 };
+/**
+ * The ids a docs page may name the sources' components by: their own, and the ones the former rule gave them
+ * (`formerComponentId`), which a page written then still uses.
+ */
+const componentIds = (sources) => sources.flatMap((source) => source.families.flatMap((family) => family.groups.flatMap((group) => group.components.flatMap((component) => [component.id, formerComponentId(source.id, component.title)]))));
+/** The ids a docs page may name the sources' stories by: their own, and their former ones (`formerStoryId`). */
+const storyIds = (sources) => storyLocations({ sources, problems: [] }).flatMap(({ source, component, story }) => [
+    story.id,
+    formerStoryId(source.id, component.title, story.exportName)
+]);
 /**
  * The catalogue's tree from the sources.
  *
@@ -234,9 +293,14 @@ export const storyTree = (sources) => {
         name: source.name,
         logo: source.logo,
         background: source.background,
-        families: sourceFamilies(source, problems)
+        families: sourceFamilies(source, problems),
+        pages: treePages(source, problems)
     }));
-    return { sources: tree.filter((source) => source.families.length > 0), problems };
+    const shown = tree.filter((source) => source.families.length > 0 || source.pages.length > 0);
+    return {
+        sources: shown,
+        problems: [...problems, ...pageProblems(shown, new Set(storyIds(shown)), new Set(componentIds(shown)))]
+    };
 };
 /**
  * Whether a component is about logic: it lists a story, and every story of its file is (`parameters.logic`), the
@@ -267,23 +331,46 @@ export const storyLocations = (tree) => tree.sources.flatMap((source) => source.
  */
 export const testedStoryLocations = (tree) => storyLocations(tree).filter((location) => !location.story.tags.includes("!test"));
 /**
- * Where a story sits.
+ * Where a story sits: the story with this id, else the one an earlier rule gave this id (`formerStoryId`), so an
+ * address written then still opens it.
  *
  * @param tree - the tree.
  * @param id - the story's id.
  * @returns its place, or `undefined` when no story has this id.
  */
-export const findStory = (tree, id) => storyLocations(tree).find((location) => location.story.id === id);
+export const findStory = (tree, id) => {
+    const locations = storyLocations(tree);
+    return (locations.find((location) => location.story.id === id) ??
+        locations.find(({ source, component, story }) => formerStoryId(source.id, component.title, story.exportName) === id));
+};
+/**
+ * Every component of the tree with its place.
+ *
+ * @param tree - the tree.
+ */
+const componentLocations = (tree) => tree.sources.flatMap((source) => source.families.flatMap((family) => family.groups.flatMap((group) => group.components.map((component) => ({ source, family, group, component })))));
 /**
- * Where a component sits.
+ * Where a component sits: the component with this id, else the one an earlier rule gave this id (its title in
+ * `kebab`), so an address written then still opens it.
  *
  * @param tree - the tree.
- * @param id - the component's id (`componentId`).
+ * @param id - the component's id (`TreeComponent.id`).
  * @returns its place, or `undefined` when no component has this id.
  */
-export const findComponent = (tree, id) => tree.sources
-    .flatMap((source) => source.families.flatMap((family) => family.groups.flatMap((group) => group.components.map((component) => ({ source, family, group, component })))))
-    .find((location) => componentId(location.source.id, location.component.title) === id);
+export const findComponent = (tree, id) => {
+    const locations = componentLocations(tree);
+    return (locations.find((location) => location.component.id === id) ??
+        locations.find(({ source, component }) => formerComponentId(source.id, component.title) === id));
+};
+/**
+ * Where the component with a title sits, in one source: what a meta's `related` or `alsoIn`, or "Used in", names.
+ *
+ * @param tree - the tree.
+ * @param sourceId - the source's id.
+ * @param title - the component's title.
+ * @returns its place, or `undefined` when the source has no component with this title.
+ */
+export const findComponentByTitle = (tree, sourceId, title) => componentLocations(tree).find((location) => location.source.id === sourceId && location.component.title === title);
 /**
  * A component's stories by group: the ungrouped ones first, then the groups the catalogue names in its order, then
  * the groups it does not name, by id; empty groups are left out.
@@ -315,4 +402,3 @@ export const sidebarStoryIds = (tree, order) => tree.sources.flatMap((source) =>
 export const mainStory = (component) => component.stories.find((story) => story.isMain) ??
     component.stories.find((story) => story.exportName === "Overview") ??
     component.stories[0];
-//# sourceMappingURL=storyTree.js.map

package/dist/src/switches.d.ts

@@ -191,4 +191,3 @@ export type GlobalTypesOptions = {
  * @param options - the preview's `initialGlobals`, and what a switch takes besides its `globalType`.
  */
 export declare const switchesFromGlobalTypes: (globalTypes: Readonly<Record<string, unknown>>, options?: GlobalTypesOptions) => ViewSwitch[];
-//# sourceMappingURL=switches.d.ts.map

package/dist/src/switches.js

@@ -12,8 +12,10 @@
  *
  * @module
  */
+import { DEVICE_PARAMETER, ORIENTATION_PARAMETER } from "./deviceView.js";
 /** The address's own parameters: a switch may not take their names. */
 const RESERVED_IDS = [
+    "embed",
     "story",
     "component",
     "backdrop",
@@ -26,9 +28,12 @@ const RESERVED_IDS = [
     "tab",
     "zoom",
     "tools",
+    DEVICE_PARAMETER,
+    ORIENTATION_PARAMETER,
     "args",
     "matrix",
-    "clock"
+    "clock",
+    "audience"
 ];
 /**
  * Why a list of switches cannot be used, or none: ids unique and not the address's own, a default among the values,
@@ -253,4 +258,3 @@ export const switchesFromGlobalTypes = (globalTypes, options = {}) => Object.ent
         }
     ];
 });
-//# sourceMappingURL=switches.js.map

package/dist/src/toolbarLayout.d.ts

@@ -116,4 +116,3 @@ export declare const readArrangement: (stored: string | null) => ToolbarArrangem
  */
 export declare const arrangementText: (arrangement: ToolbarArrangement | undefined) => string;
 export {};
-//# sourceMappingURL=toolbarLayout.d.ts.map

package/dist/src/toolbarLayout.js

@@ -152,4 +152,3 @@ export const readArrangement = (stored) => {
  * @param arrangement - the arrangement, or none.
  */
 export const arrangementText = (arrangement) => arrangement === undefined ? "" : JSON.stringify(arrangement);
-//# sourceMappingURL=toolbarLayout.js.map

package/dist/src/treePlaces.d.ts

@@ -0,0 +1,60 @@
+/**
+ * A source's components placed by their titles, before they become the tree's: their files, the lists their metas
+ * write merged over the files, the related components named both ways, and the aliases listed in other places.
+ *
+ * @remarks
+ * Kept apart from `storyTree.ts`, which builds the tree from them. Pure.
+ *
+ * @module
+ */
+import type { StoryFileIndex, StorySource } from "@forgebook/story-format/source";
+import type { TreeAlias, TreeComponent } from "./storyTree.ts";
+/** A story file with its index. */
+export type IndexedFile = {
+    /** The file, a key of the source's `index`. */
+    readonly file: string;
+    /** Its index. */
+    readonly entry: StoryFileIndex;
+};
+/** A component placed by its title, with its files, before its related components are known. */
+export type PlacedComponent = {
+    /** The title its files share. */
+    readonly title: string;
+    /** Its id (`componentId`), from its first file's meta. */
+    readonly id: string;
+    /** Its files, in the order of their paths. */
+    readonly files: readonly IndexedFile[];
+    /** The title's family, its first segment. */
+    readonly family: string;
+    /** The title's group in its family, when it has one. */
+    readonly group: string | undefined;
+    /** The title's last segment. */
+    readonly name: string;
+};
+/**
+ * A meta's list, merged over a component's files: what each file's meta writes, each once.
+ *
+ * @param component - the component.
+ * @param list - which list.
+ */
+export declare const metaList: (component: PlacedComponent, list: "alsoIn" | "related" | "keywords") => readonly string[];
+/**
+ * Each component's related titles, both ways, by its title: a link written in one meta reaches both pages. A title
+ * that names no component of the source, or the component itself, is a problem.
+ */
+export declare const relatedTitles: (source: StorySource, placed: readonly PlacedComponent[], problems: string[]) => ReadonlyMap<string, readonly string[]>;
+/** The groups of the families as they are being built: by family, then by group. */
+export type GroupsByFamily = Map<string, Map<string | undefined, {
+    components: TreeComponent[];
+    aliases: TreeAlias[];
+}>>;
+/** A family's group as it is being built, created when it is not there yet. */
+export declare const groupAt: (families: GroupsByFamily, family: string, group: string | undefined) => {
+    components: TreeComponent[];
+    aliases: TreeAlias[];
+};
+/**
+ * Lists each component in the other places its meta names, beside the components that live there. A place that is
+ * the component's own, or that already holds a component of the same name, is a problem.
+ */
+export declare const placeAliases: (source: StorySource, placed: readonly PlacedComponent[], families: GroupsByFamily, problems: string[]) => void;

package/dist/src/treePlaces.js

@@ -0,0 +1,89 @@
+/**
+ * The strings of several lists, each once, in the order first seen.
+ *
+ * @param lists - the lists.
+ */
+const unionOf = (lists) => [
+    ...new Set(lists.flatMap((list) => list ?? []))
+];
+/**
+ * A meta's list, merged over a component's files: what each file's meta writes, each once.
+ *
+ * @param component - the component.
+ * @param list - which list.
+ */
+export const metaList = (component, list) => unionOf(component.files.map(({ entry }) => entry[list]));
+/**
+ * Each component's related titles, both ways, by its title: a link written in one meta reaches both pages. A title
+ * that names no component of the source, or the component itself, is a problem.
+ */
+export const relatedTitles = (source, placed, problems) => {
+    const names = new Map(placed.map((component) => [component.title, component.name]));
+    const links = new Map();
+    const link = (from, to) => {
+        links.set(from, (links.get(from) ?? new Set()).add(to));
+    };
+    for (const component of placed) {
+        const { title, files } = component;
+        const where = files[0]?.file ?? title;
+        for (const related of metaList(component, "related")) {
+            if (related === title)
+                problems.push(`${source.name}: ${where} names itself as related`);
+            else if (!names.has(related))
+                problems.push(`${source.name}: ${where} names "${related}" as related: no such title`);
+            else {
+                link(title, related);
+                link(related, title);
+            }
+        }
+    }
+    return new Map([...links.entries()].map(([title, others]) => [
+        title,
+        [...others].sort((left, right) => (names.get(left) ?? left).localeCompare(names.get(right) ?? right))
+    ]));
+};
+/** The family and group a place of `alsoIn` names (`Data/Tables`, `Data`), or why it cannot be one. */
+const aliasPlace = (place) => {
+    const segments = place.split("/").map((segment) => segment.trim());
+    if (segments.some((segment) => segment === ""))
+        return `"${place}" has an empty segment`;
+    const [family = "", group, ...rest] = segments;
+    if (rest.length > 0)
+        return `"${place}" is not Family or Family/Group`;
+    return { family, group };
+};
+/** A family's group as it is being built, created when it is not there yet. */
+export const groupAt = (families, family, group) => {
+    const groups = families.get(family) ?? new Map();
+    families.set(family, groups);
+    const found = groups.get(group) ?? { components: [], aliases: [] };
+    groups.set(group, found);
+    return found;
+};
+/**
+ * Lists each component in the other places its meta names, beside the components that live there. A place that is
+ * the component's own, or that already holds a component of the same name, is a problem.
+ */
+export const placeAliases = (source, placed, families, problems) => {
+    for (const component of placed) {
+        const { title, family, group, name } = component;
+        const where = component.files[0]?.file ?? title;
+        for (const place of metaList(component, "alsoIn")) {
+            const at = aliasPlace(place);
+            if (typeof at === "string") {
+                problems.push(`${source.name}: ${where}: also in ${at}`);
+                continue;
+            }
+            if (at.family === family && at.group === group) {
+                problems.push(`${source.name}: ${where} is also in "${place}", its own place`);
+                continue;
+            }
+            const target = groupAt(families, at.family, at.group);
+            if ([...target.components, ...target.aliases].some((other) => other.name === name)) {
+                problems.push(`${source.name}: ${where} is also in "${place}", which already lists a ${name}`);
+                continue;
+            }
+            target.aliases.push({ name, title });
+        }
+    }
+};