@plitzi/plitzi-builder 0.38.3 → 0.38.5

package/dist/modules/App/components/AppDirectory/Directory.d.ts

@@ -9,6 +9,8 @@ export type DirectoryProps = {
     isRootFolder?: boolean;
     currentPageId?: string;
     nestedLevel?: number;
+    isCollapsed?: (folderId: string) => boolean;
+    onCollapse?: (folderId: string, collapsed: boolean) => void;
 };
-declare const Directory: ({ id, name, slug, parentId, isRootFolder, currentPageId, nestedLevel, pageFolders, elements }: DirectoryProps) => import('react').JSX.Element;
+declare const Directory: ({ id, name, slug, parentId, isRootFolder, currentPageId, nestedLevel, pageFolders, elements, isCollapsed, onCollapse }: DirectoryProps) => import('react').JSX.Element;
 export default Directory;

package/dist/modules/App/helpers/utils.d.ts

@@ -6,10 +6,8 @@ import { PopupInstance } from '@plitzi/plitzi-ui/components';
 export declare const FULL_VIEW_IDS: readonly ["server", "settings"];
 export type FullViewId = (typeof FULL_VIEW_IDS)[number];
 export declare const isFullViewId: (id: string | undefined) => id is FullViewId;
-export declare const getPopups: ({ activeIds, platformFlags }: {
+export declare const getPopups: ({ activeIds }: {
     activeIds?: string[];
-    /** The editor's own feature flags, as the platform resolved them for whoever opened it. */
-    platformFlags?: Record<string, boolean>;
 }) => {
     left: PopupInstance[];
     right: PopupInstance[];

package/dist/modules/Builder/components/BuilderArea/canvasMotionCss.d.ts

@@ -0,0 +1,11 @@
+/**
+ * In preview, what the SDK's root does on a published page (`overflow-x: clip` on `.plitzi-sdk`): an arrival from the
+ * side starts beside where it lands, and until it has played that offset must not scroll the canvas sideways. The
+ * canvas's box already scrolls the other way, which makes `clip` compute to `hidden` — the same cut.
+ */
+export declare const PREVIEW_CANVAS_CSS = ".builder-iframe { overflow-x: hidden; }";
+/**
+ * How the canvas plays the declared motion. Editing, it is held at its end — or played from the start with Play; in
+ * preview it is not touched: the page plays it as a published page does.
+ */
+export declare const canvasMotionCss: (previewMode: boolean, playing: boolean) => string;

package/dist/modules/Builder/components/BuilderArea/canvasMotionCss.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/Builder/components/BuilderArea/liveCanvas.d.ts

@@ -0,0 +1,13 @@
+export type LiveCanvasOptions = {
+    /**
+     * Whether an arrival that waits to be seen plays as it comes into view. Off while Play runs on the canvas being
+     * edited: there every arrival plays at once (`MOTION_PLAY_CSS`), in view or not.
+     */
+    reveal: boolean;
+};
+/**
+ * Makes the canvas under `root` live as the SDK's root makes a published page (`ThemedRoot`): `data-hydrated` lets the
+ * loops run — the declared ones and the space's own CSS keyed off it — and, with `reveal`, an arrival that waits to be
+ * seen plays as it comes into view. Answers the function that puts it back as it was.
+ */
+export declare const liveCanvas: (root: Element, { reveal }: LiveCanvasOptions) => (() => void);

package/dist/modules/Builder/components/BuilderArea/liveCanvas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/Builder/components/BuilderSearch/helpers.d.ts

@@ -1,2 +1 @@
-/** ⌘P / Ctrl+P — not ⌘K, which the AI panel already takes for its conversation list. */
 export declare const isSearchShortcut: (e: KeyboardEvent) => boolean;

package/dist/modules/Builder/components/BuilderTree/utils.d.ts

@@ -2,6 +2,7 @@ import { ComponentDefinition, Element } from '@plitzi/sdk-shared';
 type Node = {
     id: string;
     label: string;
+    hint?: string;
     icon: string;
     parentId?: string;
     items?: Node[];

package/dist/modules/Builder/hooks/useRevealElement.d.ts

@@ -1,13 +1,17 @@
 import { ElementMatch } from '../helpers/searchElements';
 export type RevealTarget = Pick<ElementMatch, 'id' | 'rootId' | 'ancestors'>;
 /**
- * Takes the author to an element anywhere in the space: its page or layout on screen, the tree opened down to it,
- * and the element selected.
+ * Takes the author to an element anywhere in the space: its page, layout or component on screen, the tree opened down
+ * to it, and the element selected.
  *
  * The branches go into the same `openedCache` the tree reads, so revealing a match and expanding a node by hand are
  * the same act — an element eight levels down is selected AND visible in the Layers panel, not selected somewhere
  * the panel is not showing.
  *
+ * An element a component holds is reached by opening that component, whatever the caller worked out as its root: the
+ * pages' `flat` does not hold it unless the component is already open. One on a page closes the component open, if
+ * any, since the canvas shows the component in its place while it is.
+ *
  * The switch always goes out, even to the root already on screen: the builder may be showing a layout on top of
  * the current page, and asking for the page is what brings it back. Asking for the root already open is a no-op.
  */

package/dist/modules/Components/Components.d.ts

@@ -3,7 +3,7 @@ export type ComponentsProps = {
     filter: string;
 };
 /**
- * The space's components, at the foot of the element catalog: placed the way an element is, by dragging it onto a
+ * The space's components, a category of the element catalog: placed the way an element is, by dragging it onto a
  * page — with what each is called and how many places render it. Edited by opening it in the canvas, where its tree is
  * edited like a page's.
  */

package/dist/modules/Components/components/ComponentForm/helpers.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { PropEntry } from '../PropsEditor';
+import { ProviderModalProps } from '@plitzi/plitzi-ui/Modal';
+import { SpaceComponentDeclaration } from '@plitzi/sdk-shared';
+export declare const componentFormSchema: z.ZodObject<{
+    label: z.ZodString;
+    folder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * How the modal that holds the component's form opens: wide enough for a prop's name, kind and switches on one line.
+ * Its height is the form's to manage — the fields scroll and the buttons stay in view.
+ */
+export declare const COMPONENT_MODAL: ProviderModalProps;
+/** The props a declaration has, as the editor's rows. */
+export declare const entriesOf: (declaration?: SpaceComponentDeclaration) => PropEntry[];

package/dist/modules/Components/components/ComponentForm/index.d.ts

@@ -1 +1,2 @@
 export { default } from './ComponentForm';
+export { COMPONENT_MODAL } from './helpers';

package/dist/modules/Components/components/FormSection/FormSection.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+export type FormSectionProps = {
+    title: string;
+    /** What the section is for, in a line under its title. */
+    hint?: ReactNode;
+    children: ReactNode;
+};
+/** One part of the component's form: its title, what it is for, and its fields. */
+declare const FormSection: ({ title, hint, children }: FormSectionProps) => import('react').JSX.Element;
+export default FormSection;

package/dist/modules/Components/components/FormSection/index.d.ts

@@ -0,0 +1,3 @@
+import { default as FormSection } from './FormSection';
+export * from './FormSection';
+export default FormSection;

package/dist/modules/Components/components/PropsEditor/helpers.d.ts

@@ -0,0 +1,7 @@
+import { ComponentProp } from '@plitzi/sdk-shared';
+/** The kinds a prop can be, as the kind picker lists them. */
+export declare const TYPES: {
+    value: ComponentProp['type'];
+    label: string;
+}[];
+export declare const isPropType: (value: string) => value is ComponentProp["type"];

package/dist/modules/Data/Data.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The space's own data: JSON files its pages read on the server, edited here and saved as the draft — whole, against
+ * the copy this panel read, so one saved since from elsewhere (an agent, a project's `plitzi push`) is never
+ * overwritten unseen. The live site reads what the space was last published with.
+ */
+declare const Data: () => import('react').JSX.Element;
+export default Data;

package/dist/modules/Data/components/DataEditor/DataEditor.d.ts

@@ -0,0 +1,12 @@
+export type DataEditorProps = {
+    file: string;
+    value: string;
+    modified: boolean;
+    /** What is wrong with the text as JSON, as it is typed — none when it reads. */
+    problem?: string;
+    theme: 'light' | 'dark';
+    onChange: (text: string) => void;
+};
+/** The file being edited, with the query a provider reads it by and whether it is JSON as it stands. */
+declare const DataEditor: ({ file, value, modified, problem, theme, onChange }: DataEditorProps) => import('react').JSX.Element;
+export default DataEditor;

package/dist/modules/Data/components/DataEditor/index.d.ts

@@ -0,0 +1,3 @@
+import { default as DataEditor } from './DataEditor';
+export * from './DataEditor';
+export default DataEditor;

package/dist/modules/Data/components/DataHeader/DataHeader.d.ts

@@ -0,0 +1,14 @@
+import { SaveState } from '../../../FileTree';
+export type DataHeaderProps = {
+    /** Where the files stand — none for data never saved. */
+    state?: SaveState;
+    canSave: boolean;
+    isSaving: boolean;
+    /** Whether there are changes to discard. */
+    canDiscard: boolean;
+    onSave: () => void;
+    onDiscard: () => void;
+};
+/** The panel's name and what it is for, where the files stand, and saving them. */
+declare const DataHeader: ({ state, canSave, isSaving, canDiscard, onSave, onDiscard }: DataHeaderProps) => import('react').JSX.Element;
+export default DataHeader;

package/dist/modules/Data/components/DataHeader/index.d.ts

@@ -0,0 +1,3 @@
+import { default as DataHeader } from './DataHeader';
+export * from './DataHeader';
+export default DataHeader;

package/dist/modules/Data/components/DataProblems/DataProblems.d.ts

@@ -0,0 +1,9 @@
+import { DataProblem } from '@plitzi/sdk-shared';
+export type DataProblemsProps = {
+    problems: DataProblem[];
+    /** The file a problem is about, to open. */
+    onSelect: (file: string) => void;
+};
+/** What the last save found wrong, by file: nothing was kept. */
+declare const DataProblems: ({ problems, onSelect }: DataProblemsProps) => import('react').JSX.Element;
+export default DataProblems;

package/dist/modules/Data/components/DataProblems/index.d.ts

@@ -0,0 +1,3 @@
+import { default as DataProblems } from './DataProblems';
+export * from './DataProblems';
+export default DataProblems;

package/dist/modules/Data/components/DataSidebar/DataSidebar.d.ts

@@ -0,0 +1,13 @@
+export type DataSidebarProps = {
+    files: string[];
+    selectedFile: string;
+    modified: string[];
+    /** The files whose text is not JSON yet: marked, as a save would refuse them. */
+    broken: string[];
+    onSelectFile: (file: string) => void;
+    onAddFile: (file: string) => void;
+    onRemoveFile: (file: string) => void;
+};
+/** The data's files as a tree, the one that is open, and adding or removing one. */
+declare const DataSidebar: ({ files, selectedFile, modified, broken, onSelectFile, onAddFile, onRemoveFile }: DataSidebarProps) => import('react').JSX.Element;
+export default DataSidebar;

package/dist/modules/Data/components/DataSidebar/index.d.ts

@@ -0,0 +1,3 @@
+import { default as DataSidebar } from './DataSidebar';
+export * from './DataSidebar';
+export default DataSidebar;

package/dist/modules/Data/components/DataWelcome/DataWelcome.d.ts

@@ -0,0 +1,6 @@
+export type DataWelcomeProps = {
+    onStart: () => void;
+};
+/** A space with no data yet: what it is for, and a file written already to change rather than a blank one. */
+declare const DataWelcome: ({ onStart }: DataWelcomeProps) => import('react').JSX.Element;
+export default DataWelcome;

package/dist/modules/Data/components/DataWelcome/index.d.ts

@@ -0,0 +1,3 @@
+import { default as DataWelcome } from './DataWelcome';
+export * from './DataWelcome';
+export default DataWelcome;

package/dist/modules/Data/helpers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The space's own data, as its panel edits it: JSON files a provider of the space reads on the server — `query:
+ * '/data/<file>'` with `runtime: 'server'` — never served.
+ */
+/** What a space with no data starts from: one file, a list, to change rather than a blank page. */
+export declare const STARTER_FILES: Record<string, string>;
+/** A new file's name as typed, made a data file's: trimmed, and a `.json` one when it says nothing else. */
+export declare const dataFileName: (typed: string) => string;
+/** What is wrong with a file's text as JSON, as the parser says it — or nothing, when it reads. */
+export declare const jsonProblemOf: (text: string) => string | undefined;
+/** The query a provider reads a file by. */
+export declare const queryOf: (file: string) => string;

package/dist/modules/Data/index.d.ts

@@ -0,0 +1,2 @@
+import { default as Data } from './Data';
+export default Data;

package/dist/modules/Data/useData.d.ts

@@ -0,0 +1,12 @@
+import { DataDraft, DataSaveResult } from '@plitzi/sdk-shared';
+/**
+ * The space's data draft, and saving it — through the same operation an agent's MCP and a project's `plitzi push` end
+ * in (`SpaceSaveData`): whole, against the version it was read at.
+ */
+declare const useData: () => {
+    draft: DataDraft | undefined;
+    error: string;
+    isLoading: boolean;
+    save: (files: DataDraft["files"]) => Promise<DataSaveResult | undefined>;
+};
+export default useData;

package/dist/modules/Elements/CategoryChip.d.ts

@@ -0,0 +1,11 @@
+export type CategoryChipProps = {
+    id: string;
+    label: string;
+    icon: string;
+    count: number;
+    active: boolean;
+    onSelect: (id: string) => void;
+};
+/** One category to show, chosen in a row of them: its name, how many it holds, and whether it is the one shown. */
+declare const CategoryChip: ({ id, label, icon, count, active, onSelect }: CategoryChipProps) => import('react').JSX.Element;
+export default CategoryChip;

package/dist/modules/Elements/Element.d.ts

@@ -2,5 +2,6 @@ import { ComponentDefinition } from '@plitzi/sdk-shared';
 export type ElementProps = {
     component: ComponentDefinition;
 };
-declare const Element: ({ component: { market: { icon }, definition: { label, type } } }: ElementProps) => import('react').JSX.Element;
+/** One element of the catalog, dragged onto the canvas or into Layers: its icon, its whole name, what it is on hover. */
+declare const Element: ({ component }: ElementProps) => import('react').JSX.Element;
 export default Element;

package/dist/modules/Elements/ElementCategory.d.ts

@@ -1,7 +1,10 @@
 import { ComponentDefinition } from '@plitzi/sdk-shared';
 export type ElementCategoryProps = {
-    components?: ComponentDefinition[];
-    category?: string;
+    components: ComponentDefinition[];
+    category: string;
+    /** Said above the grid — when a search lists several categories at once. */
+    titled?: boolean;
 };
-declare const ElementCategory: ({ components, category }: ElementCategoryProps) => import('react').JSX.Element | undefined;
+/** The elements of one category, as a compact grid to drag from. */
+declare const ElementCategory: ({ components, category, titled }: ElementCategoryProps) => import('react').JSX.Element;
 export default ElementCategory;

package/dist/modules/Elements/ElementHelper.d.ts

@@ -11,5 +11,15 @@ export declare const getInitialItems: (parentId: string, items: string[] | undef
     directItems: Record<string, Element>;
     items: Record<string, Element>;
 };
-/** The catalog as the elements panel lists it: every definition whose label matches `filter`, grouped by category. */
-export declare const definitionsByCategory: (definitions: Record<string, ComponentDefinition>, filter: string) => Record<string, ComponentDefinition[]>;
+/** How a category is shown: its name and icon — a plugin's own category by the name it gave. */
+export declare const categoryDisplay: (category: string) => {
+    label: string;
+    icon: string;
+};
+/** A definition's description, cut to its first sentence: what the panel says of it on hover. */
+export declare const summaryOf: (definition: ComponentDefinition) => string;
+/**
+ * The catalog as the elements panel lists it: every definition an author can drag in whose label or type matches
+ * `filter`, grouped by category — the categories in the panel's order, the elements in each by their label.
+ */
+export declare const definitionsByCategory: (definitions: Record<string, ComponentDefinition>, filter: string) => [string, ComponentDefinition[]][];

package/dist/modules/Elements/Elements.d.ts

@@ -1,2 +1,6 @@
+/**
+ * What can be dropped on a page: one category at a time, chosen in a row of chips — so the panel stays the same height
+ * however many elements plugins add — and the space's components as one more. A search looks through all of them.
+ */
 declare const Elements: () => import('react').JSX.Element;
 export default Elements;

package/dist/modules/{Functions/components/FunctionsSidebar → FileTree}/components/FileItem/FileItem.d.ts

@@ -4,7 +4,7 @@ export type FileItemProps = {
     depth: number;
     selected: boolean;
     modified: boolean;
-    /** `index.ts` is what everything starts from: it is never removed. */
+    /** Whether it may be removed — not the file everything starts from (the functions' `index.ts`). */
     removable: boolean;
     onSelect: (file: string) => void;
     onRemove: (file: string) => void;

package/dist/modules/FileTree/components/NewFile/NewFile.d.ts

@@ -0,0 +1,11 @@
+export type NewFileProps = {
+    /** An example of a name, shown while there is none: `lib/feed.ts`. */
+    placeholder: string;
+    /** The file a typed name is — trimmed, with the extension the list's files have when it says none. */
+    nameOf: (typed: string) => string;
+    onAdd: (file: string) => void;
+    onCancel: () => void;
+};
+/** A new file's name, typed where the list starts: Enter adds it — `lib/feed.ts` makes the folder too — Escape lets it go. */
+declare const NewFile: ({ placeholder, nameOf, onAdd, onCancel }: NewFileProps) => import('react').JSX.Element;
+export default NewFile;

package/dist/modules/FileTree/components/SaveStateBadge/SaveStateBadge.d.ts

@@ -0,0 +1,7 @@
+import { SaveState } from '../../helpers';
+export type SaveStateBadgeProps = {
+    state: SaveState;
+};
+/** Where the files stand, as a header shows it: a dot and a few words, in the tone of what it says. */
+declare const SaveStateBadge: ({ state }: SaveStateBadgeProps) => import('react').JSX.Element;
+export default SaveStateBadge;

package/dist/modules/FileTree/components/SaveStateBadge/index.d.ts

@@ -0,0 +1,2 @@
+import { default as SaveStateBadge } from './SaveStateBadge';
+export default SaveStateBadge;

package/dist/modules/FileTree/helpers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A list of files edited in a panel — the functions' source, the data's JSON: how it reads as a tree, how a save is
+ * asked for, and where the files stand.
+ */
+/** The editor filling the space it is given, so CodeMirror scrolls its own lines and keeps its gutter in place. */
+export declare const EDITOR_CLASS_NAME: {
+    root: string;
+    inputContainer: string;
+};
+/** How far a file or a folder is indented for each folder it is in, in pixels. */
+export declare const FILE_INDENT_PX = 12;
+/** One row of the file list: a folder, or a file under the folders before it. */
+export type FileRow = {
+    kind: 'folder';
+    path: string;
+    depth: number;
+} | {
+    kind: 'file';
+    path: string;
+    name: string;
+    depth: number;
+};
+/**
+ * The files as a tree reads, top to bottom: each folder once, before what is in it, and every name indented by how
+ * deep it is — `first` before them all, when it is the file everything starts from (the functions' `index.ts`).
+ */
+export declare const fileRows: (files: readonly string[], first?: string) => FileRow[];
+/** Whether a key press is "save": ⌘S on a Mac, Ctrl+S elsewhere. */
+export declare const isSaveKey: (event: KeyboardEvent) => boolean;
+/** Where the files stand, in a few words and a tone: what the header shows. */
+export type SaveState = {
+    label: string;
+    tone: 'unsaved' | 'problems' | 'saved';
+};
+/**
+ * Where the files stand: what the last save found wrong, changes not saved yet — in how many files — or saved, which is
+ * what the builder runs. Nothing for files never saved.
+ */
+export declare const saveState: (modified: number, problems: number, saved: boolean) => SaveState | undefined;

package/dist/modules/FileTree/index.d.ts

@@ -0,0 +1,7 @@
+export { default as FileItem } from './components/FileItem';
+export { default as FolderItem } from './components/FolderItem';
+export { default as NewFile } from './components/NewFile';
+export { default as SaveStateBadge } from './components/SaveStateBadge';
+export { default as SidebarSection } from './components/SidebarSection';
+export { EDITOR_CLASS_NAME, FILE_INDENT_PX, fileRows, isSaveKey, saveState } from './helpers';
+export type { FileRow, SaveState } from './helpers';

package/dist/modules/Functions/components/FunctionsHeader/FunctionsHeader.d.ts

@@ -1,4 +1,4 @@
-import { SaveState } from '../../helpers';
+import { SaveState } from '../../../FileTree';
 export type FunctionsHeaderProps = {
     /** Where the files stand — none for a space with no functions yet. */
     state?: SaveState;

package/dist/modules/Functions/helpers.d.ts

@@ -20,40 +20,10 @@ export declare const routeParts: (route: string, prefix: string) => {
     method: string;
     path: string;
 };
-/** How far a file or a folder is indented for each folder it is in, in pixels. */
-export declare const FILE_INDENT_PX = 12;
 /** A new file's name as typed, made a file's: trimmed, and a TypeScript one when it says nothing else. */
 export declare const newFileName: (typed: string) => string;
-/** One row of the file list: a folder, or a file under the folders before it. */
-export type FileRow = {
-    kind: 'folder';
-    path: string;
-    depth: number;
-} | {
-    kind: 'file';
-    path: string;
-    name: string;
-    depth: number;
-};
-/**
- * The files as a tree reads, top to bottom: each folder once, before what is in it, and every name indented by how
- * deep it is — `index.ts` first, as the file everything starts from.
- */
-export declare const fileRows: (files: readonly string[]) => FileRow[];
 /** A param's value as a field shows it: text as it is, a number as its digits, anything else as nothing. */
 export declare const fieldText: (value: unknown) => string;
-/** Whether a key press is "save": ⌘S on a Mac, Ctrl+S elsewhere. */
-export declare const isSaveKey: (event: KeyboardEvent) => boolean;
-/** Where the files stand, in a few words and a tone: what the header shows. */
-export type SaveState = {
-    label: string;
-    tone: 'unsaved' | 'problems' | 'saved';
-};
-/**
- * Where the files stand: what the last save found wrong, changes not saved yet — in how many files — or saved, which is
- * what the builder runs. Nothing for a space with no functions.
- */
-export declare const saveState: (modified: number, problems: number, saved: boolean) => SaveState | undefined;
 /**
  * The CPU a task may ask for from the panel, in milliseconds: from the default an invocation gets to a second, in steps
  * a person can tell apart. More than that is asked for in the code, up to what the server allows.
@@ -122,8 +92,3 @@ export declare const withCpu: (limits: FunctionTimeLimits | undefined, cpuMs: nu
 export declare const limitsBlockedBy: (ready: boolean, task: ListedTask) => string;
 /** The task written around an offset of a file — the one the cursor is in — or none. */
 export declare const taskAt: (tasks: readonly ListedTask[], file: string, offset: number) => ListedTask | undefined;
-/** The editor filling the space it is given, so CodeMirror scrolls its own lines and keeps its gutter in place. */
-export declare const EDITOR_CLASS_NAME: {
-    root: string;
-    inputContainer: string;
-};

package/dist/modules/Interactions/components/Workflow/helpers/whileRunning.d.ts

@@ -1,6 +1,6 @@
 import { Option, OptionGroup } from '@plitzi/plitzi-ui/Select2';
 import { WhileRunning } from '@plitzi/sdk-shared';
-/** The three answers to "fired again while this flow runs", as the trigger's panel offers them. */
+/** The answers to "fired again while this flow runs", as the trigger's panel offers them. */
 export declare const WHILE_RUNNING_OPTIONS: (Exclude<Option, OptionGroup> & {
     value: WhileRunning;
 })[];

package/dist/modules/Usages/Usages.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Where the space uses what it declares — components, classes, style tokens and space variables, data sources — and
+ * what nothing uses. Every use is a link to the element, on whichever page, layout or component it is.
+ *
+ * A panel beside the canvas rather than a dialog over it: following uses one after another is the job, and the list
+ * has to stay where it is while each one is looked at. The kinds are picked from a list rather than tabs, so each can
+ * say how many there are, and how many nobody uses, at the panel's narrowest.
+ */
+declare const Usages: () => import('react').JSX.Element;
+export default Usages;

package/dist/modules/Usages/components/UsageList/UsageList.d.ts

@@ -0,0 +1,13 @@
+import { UsageCategory, UsageItem } from '../../helpers/usageIndex';
+export type UsageListProps = {
+    category: UsageCategory;
+    items: UsageItem[];
+};
+/**
+ * What the space declares of one kind, each with where it is used — and, filtered, what nothing uses.
+ *
+ * The search, the filter and the row open are kept among the builder's preferences: opening a component from here
+ * draws every panel again inside it, and the list has to be where it was when that is done.
+ */
+declare const UsageList: ({ category, items }: UsageListProps) => import('react').JSX.Element;
+export default UsageList;

package/dist/modules/Usages/components/UsageList/index.d.ts

@@ -0,0 +1,3 @@
+import { default as UsageList } from './UsageList';
+export * from './UsageList';
+export default UsageList;

package/dist/modules/Usages/components/UsageRow/UsageRow.d.ts

@@ -0,0 +1,11 @@
+import { UsageCategory, UsageItem } from '../../helpers/usageIndex';
+export type UsageRowProps = {
+    item: UsageItem;
+    category: UsageCategory;
+    open: boolean;
+    /** Said under the name when nothing uses it. */
+    unusedText: string;
+    onToggle: (key: string) => void;
+};
+declare const _default: import('react').MemoExoticComponent<({ item, category, open, unusedText, onToggle }: UsageRowProps) => import('react').JSX.Element>;
+export default _default;

package/dist/modules/Usages/components/UsageRow/components/UsageElement/UsageElement.d.ts

@@ -0,0 +1,8 @@
+import { ElementUsage } from '../../../../helpers/usageIndex';
+export type UsageElementProps = {
+    usage: ElementUsage;
+    onReveal: (usage: ElementUsage) => void;
+};
+/** An element that uses the item, and how: a link that takes the author to it. */
+declare const UsageElement: ({ usage, onReveal }: UsageElementProps) => import('react').JSX.Element;
+export default UsageElement;

package/dist/modules/Usages/components/UsageRow/components/UsageElement/index.d.ts

@@ -0,0 +1,3 @@
+import { default as UsageElement } from './UsageElement';
+export * from './UsageElement';
+export default UsageElement;

package/dist/modules/Usages/components/UsageRow/components/UsageOwner/UsageOwner.d.ts

@@ -0,0 +1,9 @@
+import { ElementUsage } from '../../../../helpers/usageIndex';
+export type UsageOwnerProps = {
+    owner: ElementUsage;
+    /** A component's root, which the link opens; otherwise the element that provides the item. */
+    opensComponent: boolean;
+};
+/** Where the item is declared — a component's own tree, a data source's provider — and the way to it. */
+declare const UsageOwner: ({ owner, opensComponent }: UsageOwnerProps) => import('react').JSX.Element;
+export default UsageOwner;

package/dist/modules/Usages/components/UsageRow/components/UsageOwner/index.d.ts

@@ -0,0 +1,3 @@
+import { default as UsageOwner } from './UsageOwner';
+export * from './UsageOwner';
+export default UsageOwner;

package/dist/modules/Usages/components/UsageRow/components/UsageReferences/UsageReferences.d.ts

@@ -0,0 +1,7 @@
+import { SpaceReference } from '../../../../helpers/usageIndex';
+export type UsageReferencesProps = {
+    references: SpaceReference[];
+};
+/** What uses the item and is not an element: the selectors and tokens that read it, the custom CSS, computed values. */
+declare const UsageReferences: ({ references }: UsageReferencesProps) => import('react').JSX.Element;
+export default UsageReferences;

package/dist/modules/Usages/components/UsageRow/components/UsageReferences/index.d.ts

@@ -0,0 +1,3 @@
+import { default as UsageReferences } from './UsageReferences';
+export * from './UsageReferences';
+export default UsageReferences;

package/dist/modules/Usages/components/UsageRow/components/UsageTreeGroup/UsageTreeGroup.d.ts

@@ -0,0 +1,7 @@
+import { TreeGroup } from '../../../../helpers/grouping';
+export type UsageTreeGroupProps = {
+    group: TreeGroup;
+};
+/** The uses in one page, layout or component, under its name. */
+declare const UsageTreeGroup: ({ group }: UsageTreeGroupProps) => import('react').JSX.Element;
+export default UsageTreeGroup;

package/dist/modules/Usages/components/UsageRow/components/UsageTreeGroup/index.d.ts

@@ -0,0 +1,3 @@
+import { default as UsageTreeGroup } from './UsageTreeGroup';
+export * from './UsageTreeGroup';
+export default UsageTreeGroup;

package/dist/modules/Usages/components/UsageRow/index.d.ts

@@ -0,0 +1,3 @@
+import { default as UsageRow } from './UsageRow';
+export * from './UsageRow';
+export default UsageRow;