@tai42/studio-sdk 0.5.3 → 0.7.0

package/dist/components/components.css

@@ -1764,6 +1764,19 @@
     padding: var(--tai-space-6) var(--tai-space-8);
   }
 
+  /* Fill mode: a page that opted in via `useFillViewport`. The wrapper stops being
+     content-sized and instead fills `.tai-shell-main--fill` (which carries the
+     viewport height), so a canvas page's `height: 100%`/`flex: 1` resolves down
+     the chain. `min-height: 0` lets the flex child shrink below its content and
+     scroll internally. A canvas wants the whole pane, so the reading-column cap
+     and page padding are dropped — no letterboxing. */
+  .tai-page--fill {
+    flex: 1;
+    min-height: 0;
+    max-width: none;
+    padding: 0;
+  }
+
   .tai-stack {
     display: flex;
     flex-direction: column;
@@ -1941,6 +1954,22 @@
     background: var(--tai-color-bg);
   }
 
+  /* Fill mode: `<main>` becomes a flex column pinned to the viewport height so a
+     fill page has a definite height to resolve against (a stretched grid item's
+     height is not a reliable percentage base). The `100vh`/`100dvh` pair matches
+     `.tai-shell-sidebar` — `dvh` is the live viewport, `vh` the pre-`dvh` fallback
+     a browser below the floor keeps. `--shell-fill-offset` is the chrome above
+     `<main>` in the grid column: 0 beside the full-height sidebar, the top-bar
+     height on the phone band where the sticky bar takes the first row. */
+  .tai-shell-main--fill {
+    --shell-fill-offset: 0px;
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+    height: calc(100vh - var(--shell-fill-offset));
+    height: calc(100dvh - var(--shell-fill-offset));
+  }
+
   .tai-brand {
     display: flex;
     align-items: center;
@@ -2002,6 +2031,36 @@
     min-width: 0;
   }
 
+  /* -- Explorer ---------------------------------------------------------------------
+     The shared current-directory explorer: controls row, breadcrumb, tag chips,
+     then the folder/item body. Vertical rhythm only — the body carries its own
+     table/grid. */
+  .tai-explorer {
+    display: flex;
+    flex-direction: column;
+    gap: var(--tai-space-4);
+  }
+
+  /* Search on the leading edge, the view toggle on the trailing edge; wraps under
+     its own width on a narrow surface. */
+  .tai-explorer-controls {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--tai-space-3);
+    flex-wrap: wrap;
+  }
+
+  /* A first-class folder entry (row cell or card): the folder affordance beside
+     its optional actions, the actions pushed to the trailing edge. */
+  .tai-explorer-folder {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--tai-space-2);
+    flex-wrap: wrap;
+  }
+
   /* -- Card grids ------------------------------------------------------------------- */
   .tai-grid-cards {
     display: grid;
@@ -2098,6 +2157,12 @@
       gap: var(--tai-space-5);
     }
 
+    /* The sticky top bar occupies the first grid row here, so a fill `<main>` gets
+       the viewport LESS that bar rather than the whole viewport. */
+    .tai-shell-main--fill {
+      --shell-fill-offset: var(--shell-topbar-height);
+    }
+
     .tai-grid-cards {
       grid-template-columns: minmax(0, 1fr);
     }

package/dist/components/explorer-view.d.ts

@@ -0,0 +1,104 @@
+/**
+ * `ExplorerView<T>` — the shared current-directory explorer every entity screen
+ * composes: a breadcrumb over a flat {@link Folder} tree, optional search + tag
+ * chips, a list/card toggle, and a body in which FOLDERS are first-class entries
+ * sorted above the items (folder rows inside the same table, folder cards inside
+ * the same grid). Fully controlled and data-agnostic — the caller owns the item
+ * shape via `getItemKey`/`getFolderId`/`renderRow`/`renderCard`, and keeps folder
+ * dir / tags / search in the URL or in local state; only the view mode persists
+ * internally (per `viewSurface`).
+ *
+ * The tag glue lives here as exported helpers ({@link buildTagVocabulary},
+ * {@link matchesSelectedTags}, {@link UNTAGGED_TOKEN}) so every consuming screen
+ * shares one vocabulary/untagged-sentinel/OR-match rule rather than copying it.
+ */
+import type { ReactNode } from 'react';
+import { type Folder } from './folder-nav';
+/** Reserved filter token for items carrying NO tag; namespaced so it never
+ *  collides with a real tag. */
+export declare const UNTAGGED_TOKEN = "__untagged__";
+export interface TagVocabularyEntry {
+    readonly token: string;
+    readonly label: string;
+    readonly count: number;
+}
+/** The tag vocabulary over `items`, name-sorted, plus an untagged pseudo-tag
+ *  (labelled `untaggedLabel`) when any item is untagged; a selected token whose
+ *  items vanished still appears (count 0) so it can be cleared. */
+export declare function buildTagVocabulary<T>(items: readonly T[], getTags: (item: T) => readonly string[], selectedTags: readonly string[], untaggedLabel: string): TagVocabularyEntry[];
+/** OR semantics: an empty selection matches everything; otherwise an item
+ *  matches when it carries any selected tag, or is untagged and UNTAGGED_TOKEN
+ *  is selected. */
+export declare function matchesSelectedTags(itemTags: readonly string[], selected: ReadonlySet<string>): boolean;
+/** One header cell of the table view. `renderRow` must emit exactly this many
+ *  `<TD>`s per item; folder rows span all of them. */
+export interface ExplorerColumn {
+    readonly key: string;
+    readonly header: ReactNode;
+    readonly numeric?: boolean;
+}
+/** Enables the tag vocabulary, filter chips, and OR filter. Fully controlled. */
+export interface ExplorerTags<T> {
+    readonly getTags: (item: T) => readonly string[];
+    readonly selected: readonly string[];
+    readonly onChange: (selected: readonly string[]) => void;
+    /** The untagged pseudo-tag's visible label (e.g. "Untagged"). */
+    readonly untaggedLabel: string;
+    /** The chip group's accessible name (e.g. "Filter tools by tag"). */
+    readonly filterLabel: string;
+    /** Collapse unselected chips beyond this count into a static "+N more"; unset
+     *  shows every chip. Selected chips always show. */
+    readonly maxVisibleTags?: number;
+}
+/** Controlled free-text search. `matches` owns the item shape and casing; it is
+ *  called only with a non-empty, already-trimmed query. */
+export interface ExplorerSearch<T> {
+    readonly value: string;
+    readonly onChange: (value: string) => void;
+    readonly matches: (item: T, query: string) => boolean;
+    /** The input's accessible name. */
+    readonly label: string;
+    readonly placeholder?: string;
+}
+export interface ExplorerEmptyState {
+    readonly title: string;
+    readonly description?: string;
+    readonly action?: ReactNode;
+}
+/** The folder-aware empty-state ladder — every label caller-supplied. */
+export interface ExplorerEmptyStates {
+    /** No items and no folders exist at all. */
+    readonly empty: ExplorerEmptyState;
+    /** The current folder holds nothing — no items, no subfolders — yet the
+     *  entity set is not globally empty. */
+    readonly emptyFolder: ExplorerEmptyState;
+    /** The current folder has items but the active tag/search filter excludes
+     *  every one, and it has no subfolders to show. */
+    readonly noMatch: ExplorerEmptyState;
+}
+export interface ExplorerViewProps<T> {
+    readonly items: readonly T[];
+    readonly getItemKey: (item: T) => string;
+    /** The folder an item is filed in (`null` = the root directory). */
+    readonly getFolderId: (item: T) => string | null;
+    readonly folders: readonly Folder[];
+    readonly currentFolderId: string | null;
+    readonly onNavigate: (folderId: string | null) => void;
+    readonly rootLabel: string;
+    /** Persist + drive the list/card toggle under this surface key. */
+    readonly viewSurface: string;
+    /** The card grid's accessible name; the toggle's is "<label> view". */
+    readonly label: string;
+    readonly columns: readonly ExplorerColumn[];
+    /** The item's table cells (`<TD>`s) — wrapped in a keyed `<TR>` by the explorer. */
+    readonly renderRow: (item: T) => ReactNode;
+    /** The item's `<Card>` — wrapped in a keyed `listitem` by the explorer. */
+    readonly renderCard: (item: T) => ReactNode;
+    readonly tags?: ExplorerTags<T>;
+    readonly search?: ExplorerSearch<T>;
+    /** Per-folder actions rendered on the folder's row/card (e.g. a kebab). */
+    readonly renderFolderActions?: (folder: Folder) => ReactNode;
+    readonly emptyStates: ExplorerEmptyStates;
+}
+export declare function ExplorerView<T>({ items, getItemKey, getFolderId, folders, currentFolderId, onNavigate, rootLabel, viewSurface, label, columns, renderRow, renderCard, tags, search, renderFolderActions, emptyStates, }: ExplorerViewProps<T>): ReactNode;
+//# sourceMappingURL=explorer-view.d.ts.map

package/dist/components/explorer-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer-view.d.ts","sourceRoot":"","sources":["../../src/components/explorer-view.tsx"],"names":[],"mappings":"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"}

package/dist/components/explorer-view.js

@@ -0,0 +1,141 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { EntityCardGrid } from './entity-card-grid';
+import { childFolders, FolderBreadcrumb, FolderRow } from './folder-nav';
+import { SearchIcon } from './icons';
+import { TextInput } from './inputs';
+import { Card, EmptyState } from './primitives';
+import { Table, TBody, TD, TH, THead, TR } from './table';
+import { useViewMode, ViewToggle } from './view-toggle';
+/** Reserved filter token for items carrying NO tag; namespaced so it never
+ *  collides with a real tag. */
+export const UNTAGGED_TOKEN = '__untagged__';
+/** The tag vocabulary over `items`, name-sorted, plus an untagged pseudo-tag
+ *  (labelled `untaggedLabel`) when any item is untagged; a selected token whose
+ *  items vanished still appears (count 0) so it can be cleared. */
+export function buildTagVocabulary(items, getTags, selectedTags, untaggedLabel) {
+    const counts = new Map();
+    let untagged = 0;
+    for (const item of items) {
+        const tags = getTags(item);
+        if (tags.length === 0) {
+            untagged += 1;
+            continue;
+        }
+        for (const tag of tags)
+            counts.set(tag, (counts.get(tag) ?? 0) + 1);
+    }
+    const vocabulary = [...counts.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([label, count]) => ({ token: label, label, count }));
+    if (untagged > 0) {
+        vocabulary.push({ token: UNTAGGED_TOKEN, label: untaggedLabel, count: untagged });
+    }
+    for (const token of selectedTags) {
+        if (!vocabulary.some((entry) => entry.token === token)) {
+            vocabulary.push({
+                token,
+                label: token === UNTAGGED_TOKEN ? untaggedLabel : token,
+                count: 0,
+            });
+        }
+    }
+    return vocabulary;
+}
+/** OR semantics: an empty selection matches everything; otherwise an item
+ *  matches when it carries any selected tag, or is untagged and UNTAGGED_TOKEN
+ *  is selected. */
+export function matchesSelectedTags(itemTags, selected) {
+    if (selected.size === 0)
+        return true;
+    if (itemTags.length === 0)
+        return selected.has(UNTAGGED_TOKEN);
+    return itemTags.some((tag) => selected.has(tag));
+}
+/** A togglable tag chip; `aria-pressed` reflects whether the tag filters the list. */
+function TagChip({ entry, active, onToggle, }) {
+    return (_jsxs("button", { type: "button", className: "tai-chip", "aria-pressed": active, "aria-label": `${entry.label} (${String(entry.count)})`, onClick: onToggle, children: [_jsx("span", { children: entry.label }), _jsx("span", { children: entry.count })] }));
+}
+/** The filter row: every selected chip plus as many unselected chips as fit under
+ *  the cap, with the remainder collapsed into a STATIC "+N more" count. An unset
+ *  cap shows every chip. */
+function TagFilterRow({ vocabulary, selectedSet, onToggle, filterLabel, maxVisibleTags, }) {
+    const visible = [];
+    let hidden = 0;
+    let unselectedShown = 0;
+    for (const entry of vocabulary) {
+        if (selectedSet.has(entry.token)) {
+            visible.push(entry);
+        }
+        else if (maxVisibleTags === undefined || unselectedShown < maxVisibleTags) {
+            visible.push(entry);
+            unselectedShown += 1;
+        }
+        else {
+            hidden += 1;
+        }
+    }
+    return (_jsxs("div", { role: "group", "aria-label": filterLabel, className: "tai-row", children: [visible.map((entry) => (_jsx(TagChip, { entry: entry, active: selectedSet.has(entry.token), onToggle: () => {
+                    onToggle(entry.token);
+                } }, entry.token))), hidden > 0 ? (_jsx("span", { className: "tai-chip tai-chip-static", children: `+${String(hidden)} more` })) : null] }));
+}
+/** A first-class folder entry — a `FolderRow` (icon + name, navigates inward)
+ *  beside its optional actions, in the layout shared by the row cell and the card. */
+function FolderEntry({ folder, onNavigate, renderFolderActions, }) {
+    return (_jsxs("div", { className: "tai-explorer-folder", children: [_jsx(FolderRow, { folder: folder, onOpen: onNavigate }), renderFolderActions ? renderFolderActions(folder) : null] }));
+}
+export function ExplorerView({ items, getItemKey, getFolderId, folders, currentFolderId, onNavigate, rootLabel, viewSurface, label, columns, renderRow, renderCard, tags, search, renderFolderActions, emptyStates, }) {
+    const [viewMode, setViewMode] = useViewMode(viewSurface);
+    if (viewSurface === '')
+        throw new Error('ExplorerView requires a non-empty viewSurface key.');
+    if (columns.length === 0)
+        throw new Error('ExplorerView requires at least one column.');
+    // Nothing anywhere: no items and no folders. A bare empty state, no controls.
+    if (items.length === 0 && folders.length === 0) {
+        return _jsx(EmptyState, { ...emptyStates.empty });
+    }
+    const subfolders = childFolders(folders, currentFolderId);
+    const inFolder = items.filter((item) => getFolderId(item) === currentFolderId);
+    const selectedSet = tags !== undefined ? new Set(tags.selected) : undefined;
+    const query = search ? search.value.trim() : '';
+    const filtered = inFolder.filter((item) => {
+        if (tags !== undefined && selectedSet !== undefined && selectedSet.size > 0) {
+            if (!matchesSelectedTags(tags.getTags(item), selectedSet))
+                return false;
+        }
+        if (search !== undefined && query !== '') {
+            if (!search.matches(item, query))
+                return false;
+        }
+        return true;
+    });
+    const vocabulary = tags !== undefined
+        ? buildTagVocabulary(inFolder, tags.getTags, tags.selected, tags.untaggedLabel)
+        : [];
+    const toggleTag = (token) => {
+        if (tags === undefined || selectedSet === undefined)
+            return;
+        const next = selectedSet.has(token)
+            ? tags.selected.filter((t) => t !== token)
+            : [...tags.selected, token];
+        tags.onChange(next);
+    };
+    const hasEntries = subfolders.length > 0 || filtered.length > 0;
+    let body;
+    if (!hasEntries) {
+        // The current folder renders nothing. A filter emptied it (`inFolder` non-empty)
+        // → "no match"; otherwise the folder is genuinely empty.
+        body = (_jsx(EmptyState, { ...(inFolder.length > 0 ? emptyStates.noMatch : emptyStates.emptyFolder) }));
+    }
+    else if (viewMode === 'cards') {
+        body = (_jsxs(EntityCardGrid, { "aria-label": label, children: [subfolders.map((folder) => (_jsx("div", { role: "listitem", children: _jsx(Card, { interactive: true, children: _jsx(FolderEntry, { folder: folder, onNavigate: onNavigate, renderFolderActions: renderFolderActions }) }) }, `folder:${folder.id}`))), filtered.map((item) => (_jsx("div", { role: "listitem", children: renderCard(item) }, `item:${getItemKey(item)}`)))] }));
+    }
+    else {
+        // Folder rows share the item table, spanning every column, sorted above items —
+        // so a folder-with-only-subfolders is folder ROWS, never a header-only table.
+        body = (_jsxs(Table, { children: [_jsx(THead, { children: _jsx(TR, { children: columns.map((column) => (_jsx(TH, { numeric: column.numeric, children: column.header }, column.key))) }) }), _jsxs(TBody, { children: [subfolders.map((folder) => (_jsx(TR, { children: _jsx(TD, { colSpan: columns.length, children: _jsx(FolderEntry, { folder: folder, onNavigate: onNavigate, renderFolderActions: renderFolderActions }) }) }, `folder:${folder.id}`))), filtered.map((item) => (_jsx(TR, { children: renderRow(item) }, `item:${getItemKey(item)}`)))] })] }));
+    }
+    return (_jsxs("div", { className: "tai-explorer", children: [_jsxs("div", { className: "tai-explorer-controls", children: [search !== undefined ? (_jsxs("span", { className: "tai-row", children: [_jsx(SearchIcon, {}), _jsx(TextInput, { value: search.value, "aria-label": search.label, placeholder: search.placeholder, onChange: (event) => {
+                                    search.onChange(event.target.value);
+                                } })] })) : (_jsx("span", {})), _jsx(ViewToggle, { value: viewMode, onValueChange: setViewMode, "aria-label": `${label} view` })] }), _jsx(FolderBreadcrumb, { folders: folders, currentFolderId: currentFolderId, onNavigate: onNavigate, rootLabel: rootLabel }), tags !== undefined && selectedSet !== undefined && vocabulary.length > 0 ? (_jsx(TagFilterRow, { vocabulary: vocabulary, selectedSet: selectedSet, onToggle: toggleTag, filterLabel: tags.filterLabel, maxVisibleTags: tags.maxVisibleTags })) : null, body] }));
+}
+//# sourceMappingURL=explorer-view.js.map

package/dist/components/explorer-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer-view.js","sourceRoot":"","sources":["../../src/components/explorer-view.tsx"],"names":[],"mappings":"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"}

package/dist/components/page-fill.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Full-height page mode: a page declares "I fill the viewport" and the shell
+ * gives its wrapper a viewport-height flex chain instead of the default
+ * content-sized, scrolling `.tai-page`.
+ *
+ * The signal travels page → shell through context, NOT a route handle: plugin
+ * pages all share ONE catch-all route, so a per-route handle cannot vary between
+ * them. A rendered page (feature route or plugin page alike) opts in with
+ * {@link useFillViewport}; the shell reads {@link usePageFillActive} to add the
+ * `.tai-page--fill` / `.tai-shell-main--fill` modifiers. Opt-in is ref-counted so
+ * the modifier survives a route transition (old page unmounts after the new one
+ * mounts) and clears exactly when the last fill page leaves.
+ */
+import { type ReactNode } from 'react';
+/**
+ * Wraps the shell's routed region: holds the count of pages asking for fill mode
+ * and publishes both the registrar (for {@link useFillViewport}) and the active
+ * flag (for {@link usePageFillActive}). Renders no DOM of its own.
+ */
+export declare function PageFillProvider({ children }: {
+    children: ReactNode;
+}): ReactNode;
+/**
+ * Opt the current page into full-height fill mode for as long as it is mounted.
+ * The shell fills `<main>` to the viewport and lets the page's own root flex or
+ * `height: 100%` down the chain. Must be called under a {@link PageFillProvider}
+ * (the shell mounts one); outside it there is no wrapper to modify, so it throws
+ * rather than silently do nothing.
+ */
+export declare function useFillViewport(): void;
+/** Whether any mounted page currently asks for fill mode — the shell's cue to add
+ * the fill modifiers to `<main>` and the page wrapper. */
+export declare function usePageFillActive(): boolean;
+//# sourceMappingURL=page-fill.d.ts.map

package/dist/components/page-fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-fill.d.ts","sourceRoot":"","sources":["../../src/components/page-fill.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAWhG;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAuBjF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAQtC;AAED;0DAC0D;AAC1D,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/components/page-fill.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Full-height page mode: a page declares "I fill the viewport" and the shell
+ * gives its wrapper a viewport-height flex chain instead of the default
+ * content-sized, scrolling `.tai-page`.
+ *
+ * The signal travels page → shell through context, NOT a route handle: plugin
+ * pages all share ONE catch-all route, so a per-route handle cannot vary between
+ * them. A rendered page (feature route or plugin page alike) opts in with
+ * {@link useFillViewport}; the shell reads {@link usePageFillActive} to add the
+ * `.tai-page--fill` / `.tai-shell-main--fill` modifiers. Opt-in is ref-counted so
+ * the modifier survives a route transition (old page unmounts after the new one
+ * mounts) and clears exactly when the last fill page leaves.
+ */
+import { createContext, useContext, useEffect, useMemo, useState } from 'react';
+const PageFillRegistryContext = createContext(null);
+const PageFillActiveContext = createContext(false);
+/**
+ * Wraps the shell's routed region: holds the count of pages asking for fill mode
+ * and publishes both the registrar (for {@link useFillViewport}) and the active
+ * flag (for {@link usePageFillActive}). Renders no DOM of its own.
+ */
+export function PageFillProvider({ children }) {
+    const [fillCount, setFillCount] = useState(0);
+    const registry = useMemo(() => ({
+        acquire() {
+            setFillCount((count) => count + 1);
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                setFillCount((count) => count - 1);
+            };
+        },
+    }), []);
+    return (_jsx(PageFillRegistryContext.Provider, { value: registry, children: _jsx(PageFillActiveContext.Provider, { value: fillCount > 0, children: children }) }));
+}
+/**
+ * Opt the current page into full-height fill mode for as long as it is mounted.
+ * The shell fills `<main>` to the viewport and lets the page's own root flex or
+ * `height: 100%` down the chain. Must be called under a {@link PageFillProvider}
+ * (the shell mounts one); outside it there is no wrapper to modify, so it throws
+ * rather than silently do nothing.
+ */
+export function useFillViewport() {
+    const registry = useContext(PageFillRegistryContext);
+    if (registry === null) {
+        throw new Error('useFillViewport must be used within a <PageFillProvider> (the shell provides it)');
+    }
+    useEffect(() => registry.acquire(), [registry]);
+}
+/** Whether any mounted page currently asks for fill mode — the shell's cue to add
+ * the fill modifiers to `<main>` and the page wrapper. */
+export function usePageFillActive() {
+    return useContext(PageFillActiveContext);
+}
+//# sourceMappingURL=page-fill.js.map

package/dist/components/page-fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-fill.js","sourceRoot":"","sources":["../../src/components/page-fill.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAQhG,MAAM,uBAAuB,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AAC7E,MAAM,qBAAqB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAA2B;IACpE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CAAC,CAAC;QACL,OAAO;YACL,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACrC,CAAC,CAAC;QACJ,CAAC;KACF,CAAC,EACF,EAAE,CACH,CAAC;IACF,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAC/C,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,SAAS,GAAG,CAAC,YACjD,QAAQ,GACsB,GACA,CACpC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;0DAC0D;AAC1D,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -45,6 +45,7 @@ export { Button, Card, Skeleton, EmptyState, ErrorState, Spinner } from './compo
 export type { ButtonProps, LinkButtonProps, ButtonVariant, CardProps, SkeletonProps, EmptyStateProps, ErrorStateProps, SpinnerProps, } from './components/primitives';
 export { PageHeader, Page, Stack } from './components/page-header';
 export type { PageHeaderProps, PageLayoutProps, StackProps } from './components/page-header';
+export { PageFillProvider, useFillViewport, usePageFillActive } from './components/page-fill';
 export { ErrorBoundary } from './components/error-boundary';
 export type { ErrorBoundaryProps } from './components/error-boundary';
 export { Field, useFieldControl } from './components/field';
@@ -85,6 +86,8 @@ export { ViewToggle, useViewMode } from './components/view-toggle';
 export type { ViewMode, ViewToggleProps } from './components/view-toggle';
 export { EntityCardGrid } from './components/entity-card-grid';
 export type { EntityCardGridProps } from './components/entity-card-grid';
+export { ExplorerView, buildTagVocabulary, matchesSelectedTags, UNTAGGED_TOKEN, } from './components/explorer-view';
+export type { ExplorerViewProps, ExplorerColumn, ExplorerTags, ExplorerSearch, ExplorerEmptyState, ExplorerEmptyStates, TagVocabularyEntry, } from './components/explorer-view';
 export { FolderBreadcrumb, FolderRow, FolderPicker, childFolders, folderPathTo, } from './components/folder-nav';
 export type { Folder, FolderBreadcrumbProps, FolderRowProps, FolderPickerProps, } from './components/folder-nav';
 export { CodeBlock } from './components/code-block';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -48,6 +48,7 @@ export { effectiveHidden, hiddenToolNames } from './tool-visibility';
 // -- Design system -----------------------------------------------------------
 export { Button, Card, Skeleton, EmptyState, ErrorState, Spinner } from './components/primitives';
 export { PageHeader, Page, Stack } from './components/page-header';
+export { PageFillProvider, useFillViewport, usePageFillActive } from './components/page-fill';
 export { ErrorBoundary } from './components/error-boundary';
 export { Field, useFieldControl } from './components/field';
 export { TextInput, Textarea, NumberInput } from './components/inputs';
@@ -68,6 +69,7 @@ export { TagChips, TagsInput } from './components/tags';
 export { OverlayDetailsFields, overlayDetailsPatch } from './components/overlay-details-fields';
 export { ViewToggle, useViewMode } from './components/view-toggle';
 export { EntityCardGrid } from './components/entity-card-grid';
+export { ExplorerView, buildTagVocabulary, matchesSelectedTags, UNTAGGED_TOKEN, } from './components/explorer-view';
 export { FolderBreadcrumb, FolderRow, FolderPicker, childFolders, folderPathTo, } from './components/folder-nav';
 export { CodeBlock } from './components/code-block';
 export { FleetReport } from './components/fleet-report';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -89,7 +89,7 @@
     "@radix-ui/react-select": "^2.3.2",
     "@radix-ui/react-tabs": "^1.1.16",
     "@radix-ui/react-tooltip": "^1.2.11",
-    "@tai42/api-client": "0.5.3"
+    "@tai42/api-client": "0.7.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",

package/src/components/components.css

@@ -1764,6 +1764,19 @@
     padding: var(--tai-space-6) var(--tai-space-8);
   }
 
+  /* Fill mode: a page that opted in via `useFillViewport`. The wrapper stops being
+     content-sized and instead fills `.tai-shell-main--fill` (which carries the
+     viewport height), so a canvas page's `height: 100%`/`flex: 1` resolves down
+     the chain. `min-height: 0` lets the flex child shrink below its content and
+     scroll internally. A canvas wants the whole pane, so the reading-column cap
+     and page padding are dropped — no letterboxing. */
+  .tai-page--fill {
+    flex: 1;
+    min-height: 0;
+    max-width: none;
+    padding: 0;
+  }
+
   .tai-stack {
     display: flex;
     flex-direction: column;
@@ -1941,6 +1954,22 @@
     background: var(--tai-color-bg);
   }
 
+  /* Fill mode: `<main>` becomes a flex column pinned to the viewport height so a
+     fill page has a definite height to resolve against (a stretched grid item's
+     height is not a reliable percentage base). The `100vh`/`100dvh` pair matches
+     `.tai-shell-sidebar` — `dvh` is the live viewport, `vh` the pre-`dvh` fallback
+     a browser below the floor keeps. `--shell-fill-offset` is the chrome above
+     `<main>` in the grid column: 0 beside the full-height sidebar, the top-bar
+     height on the phone band where the sticky bar takes the first row. */
+  .tai-shell-main--fill {
+    --shell-fill-offset: 0px;
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+    height: calc(100vh - var(--shell-fill-offset));
+    height: calc(100dvh - var(--shell-fill-offset));
+  }
+
   .tai-brand {
     display: flex;
     align-items: center;
@@ -2002,6 +2031,36 @@
     min-width: 0;
   }
 
+  /* -- Explorer ---------------------------------------------------------------------
+     The shared current-directory explorer: controls row, breadcrumb, tag chips,
+     then the folder/item body. Vertical rhythm only — the body carries its own
+     table/grid. */
+  .tai-explorer {
+    display: flex;
+    flex-direction: column;
+    gap: var(--tai-space-4);
+  }
+
+  /* Search on the leading edge, the view toggle on the trailing edge; wraps under
+     its own width on a narrow surface. */
+  .tai-explorer-controls {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--tai-space-3);
+    flex-wrap: wrap;
+  }
+
+  /* A first-class folder entry (row cell or card): the folder affordance beside
+     its optional actions, the actions pushed to the trailing edge. */
+  .tai-explorer-folder {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--tai-space-2);
+    flex-wrap: wrap;
+  }
+
   /* -- Card grids ------------------------------------------------------------------- */
   .tai-grid-cards {
     display: grid;
@@ -2098,6 +2157,12 @@
       gap: var(--tai-space-5);
     }
 
+    /* The sticky top bar occupies the first grid row here, so a fill `<main>` gets
+       the viewport LESS that bar rather than the whole viewport. */
+    .tai-shell-main--fill {
+      --shell-fill-offset: var(--shell-topbar-height);
+    }
+
     .tai-grid-cards {
       grid-template-columns: minmax(0, 1fr);
     }

package/src/components/explorer-view.tsx

@@ -0,0 +1,419 @@
+/**
+ * `ExplorerView<T>` — the shared current-directory explorer every entity screen
+ * composes: a breadcrumb over a flat {@link Folder} tree, optional search + tag
+ * chips, a list/card toggle, and a body in which FOLDERS are first-class entries
+ * sorted above the items (folder rows inside the same table, folder cards inside
+ * the same grid). Fully controlled and data-agnostic — the caller owns the item
+ * shape via `getItemKey`/`getFolderId`/`renderRow`/`renderCard`, and keeps folder
+ * dir / tags / search in the URL or in local state; only the view mode persists
+ * internally (per `viewSurface`).
+ *
+ * The tag glue lives here as exported helpers ({@link buildTagVocabulary},
+ * {@link matchesSelectedTags}, {@link UNTAGGED_TOKEN}) so every consuming screen
+ * shares one vocabulary/untagged-sentinel/OR-match rule rather than copying it.
+ */
+import type { ReactNode } from 'react';
+
+import { EntityCardGrid } from './entity-card-grid';
+import { childFolders, FolderBreadcrumb, FolderRow, type Folder } from './folder-nav';
+import { SearchIcon } from './icons';
+import { TextInput } from './inputs';
+import { Card, EmptyState } from './primitives';
+import { Table, TBody, TD, TH, THead, TR } from './table';
+import { useViewMode, ViewToggle } from './view-toggle';
+
+/** Reserved filter token for items carrying NO tag; namespaced so it never
+ *  collides with a real tag. */
+export const UNTAGGED_TOKEN = '__untagged__';
+
+export interface TagVocabularyEntry {
+  readonly token: string;
+  readonly label: string;
+  readonly count: number;
+}
+
+/** The tag vocabulary over `items`, name-sorted, plus an untagged pseudo-tag
+ *  (labelled `untaggedLabel`) when any item is untagged; a selected token whose
+ *  items vanished still appears (count 0) so it can be cleared. */
+export function buildTagVocabulary<T>(
+  items: readonly T[],
+  getTags: (item: T) => readonly string[],
+  selectedTags: readonly string[],
+  untaggedLabel: string,
+): TagVocabularyEntry[] {
+  const counts = new Map<string, number>();
+  let untagged = 0;
+  for (const item of items) {
+    const tags = getTags(item);
+    if (tags.length === 0) {
+      untagged += 1;
+      continue;
+    }
+    for (const tag of tags) counts.set(tag, (counts.get(tag) ?? 0) + 1);
+  }
+  const vocabulary: TagVocabularyEntry[] = [...counts.entries()]
+    .sort(([a], [b]) => a.localeCompare(b))
+    .map(([label, count]) => ({ token: label, label, count }));
+  if (untagged > 0) {
+    vocabulary.push({ token: UNTAGGED_TOKEN, label: untaggedLabel, count: untagged });
+  }
+  for (const token of selectedTags) {
+    if (!vocabulary.some((entry) => entry.token === token)) {
+      vocabulary.push({
+        token,
+        label: token === UNTAGGED_TOKEN ? untaggedLabel : token,
+        count: 0,
+      });
+    }
+  }
+  return vocabulary;
+}
+
+/** OR semantics: an empty selection matches everything; otherwise an item
+ *  matches when it carries any selected tag, or is untagged and UNTAGGED_TOKEN
+ *  is selected. */
+export function matchesSelectedTags(
+  itemTags: readonly string[],
+  selected: ReadonlySet<string>,
+): boolean {
+  if (selected.size === 0) return true;
+  if (itemTags.length === 0) return selected.has(UNTAGGED_TOKEN);
+  return itemTags.some((tag) => selected.has(tag));
+}
+
+/** One header cell of the table view. `renderRow` must emit exactly this many
+ *  `<TD>`s per item; folder rows span all of them. */
+export interface ExplorerColumn {
+  readonly key: string;
+  readonly header: ReactNode;
+  readonly numeric?: boolean;
+}
+
+/** Enables the tag vocabulary, filter chips, and OR filter. Fully controlled. */
+export interface ExplorerTags<T> {
+  readonly getTags: (item: T) => readonly string[];
+  readonly selected: readonly string[];
+  readonly onChange: (selected: readonly string[]) => void;
+  /** The untagged pseudo-tag's visible label (e.g. "Untagged"). */
+  readonly untaggedLabel: string;
+  /** The chip group's accessible name (e.g. "Filter tools by tag"). */
+  readonly filterLabel: string;
+  /** Collapse unselected chips beyond this count into a static "+N more"; unset
+   *  shows every chip. Selected chips always show. */
+  readonly maxVisibleTags?: number;
+}
+
+/** Controlled free-text search. `matches` owns the item shape and casing; it is
+ *  called only with a non-empty, already-trimmed query. */
+export interface ExplorerSearch<T> {
+  readonly value: string;
+  readonly onChange: (value: string) => void;
+  readonly matches: (item: T, query: string) => boolean;
+  /** The input's accessible name. */
+  readonly label: string;
+  readonly placeholder?: string;
+}
+
+export interface ExplorerEmptyState {
+  readonly title: string;
+  readonly description?: string;
+  readonly action?: ReactNode;
+}
+
+/** The folder-aware empty-state ladder — every label caller-supplied. */
+export interface ExplorerEmptyStates {
+  /** No items and no folders exist at all. */
+  readonly empty: ExplorerEmptyState;
+  /** The current folder holds nothing — no items, no subfolders — yet the
+   *  entity set is not globally empty. */
+  readonly emptyFolder: ExplorerEmptyState;
+  /** The current folder has items but the active tag/search filter excludes
+   *  every one, and it has no subfolders to show. */
+  readonly noMatch: ExplorerEmptyState;
+}
+
+export interface ExplorerViewProps<T> {
+  readonly items: readonly T[];
+  readonly getItemKey: (item: T) => string;
+  /** The folder an item is filed in (`null` = the root directory). */
+  readonly getFolderId: (item: T) => string | null;
+
+  readonly folders: readonly Folder[];
+  readonly currentFolderId: string | null;
+  readonly onNavigate: (folderId: string | null) => void;
+  readonly rootLabel: string;
+
+  /** Persist + drive the list/card toggle under this surface key. */
+  readonly viewSurface: string;
+  /** The card grid's accessible name; the toggle's is "<label> view". */
+  readonly label: string;
+
+  readonly columns: readonly ExplorerColumn[];
+  /** The item's table cells (`<TD>`s) — wrapped in a keyed `<TR>` by the explorer. */
+  readonly renderRow: (item: T) => ReactNode;
+  /** The item's `<Card>` — wrapped in a keyed `listitem` by the explorer. */
+  readonly renderCard: (item: T) => ReactNode;
+
+  readonly tags?: ExplorerTags<T>;
+  readonly search?: ExplorerSearch<T>;
+
+  /** Per-folder actions rendered on the folder's row/card (e.g. a kebab). */
+  readonly renderFolderActions?: (folder: Folder) => ReactNode;
+
+  readonly emptyStates: ExplorerEmptyStates;
+}
+
+/** A togglable tag chip; `aria-pressed` reflects whether the tag filters the list. */
+function TagChip({
+  entry,
+  active,
+  onToggle,
+}: {
+  readonly entry: TagVocabularyEntry;
+  readonly active: boolean;
+  readonly onToggle: () => void;
+}): ReactNode {
+  return (
+    <button
+      type="button"
+      className="tai-chip"
+      aria-pressed={active}
+      aria-label={`${entry.label} (${String(entry.count)})`}
+      onClick={onToggle}
+    >
+      <span>{entry.label}</span>
+      <span>{entry.count}</span>
+    </button>
+  );
+}
+
+/** The filter row: every selected chip plus as many unselected chips as fit under
+ *  the cap, with the remainder collapsed into a STATIC "+N more" count. An unset
+ *  cap shows every chip. */
+function TagFilterRow({
+  vocabulary,
+  selectedSet,
+  onToggle,
+  filterLabel,
+  maxVisibleTags,
+}: {
+  readonly vocabulary: readonly TagVocabularyEntry[];
+  readonly selectedSet: ReadonlySet<string>;
+  readonly onToggle: (token: string) => void;
+  readonly filterLabel: string;
+  readonly maxVisibleTags: number | undefined;
+}): ReactNode {
+  const visible: TagVocabularyEntry[] = [];
+  let hidden = 0;
+  let unselectedShown = 0;
+  for (const entry of vocabulary) {
+    if (selectedSet.has(entry.token)) {
+      visible.push(entry);
+    } else if (maxVisibleTags === undefined || unselectedShown < maxVisibleTags) {
+      visible.push(entry);
+      unselectedShown += 1;
+    } else {
+      hidden += 1;
+    }
+  }
+
+  return (
+    <div role="group" aria-label={filterLabel} className="tai-row">
+      {visible.map((entry) => (
+        <TagChip
+          key={entry.token}
+          entry={entry}
+          active={selectedSet.has(entry.token)}
+          onToggle={() => {
+            onToggle(entry.token);
+          }}
+        />
+      ))}
+      {hidden > 0 ? (
+        <span className="tai-chip tai-chip-static">{`+${String(hidden)} more`}</span>
+      ) : null}
+    </div>
+  );
+}
+
+/** A first-class folder entry — a `FolderRow` (icon + name, navigates inward)
+ *  beside its optional actions, in the layout shared by the row cell and the card. */
+function FolderEntry({
+  folder,
+  onNavigate,
+  renderFolderActions,
+}: {
+  readonly folder: Folder;
+  readonly onNavigate: (folderId: string | null) => void;
+  readonly renderFolderActions: ((folder: Folder) => ReactNode) | undefined;
+}): ReactNode {
+  return (
+    <div className="tai-explorer-folder">
+      <FolderRow folder={folder} onOpen={onNavigate} />
+      {renderFolderActions ? renderFolderActions(folder) : null}
+    </div>
+  );
+}
+
+export function ExplorerView<T>({
+  items,
+  getItemKey,
+  getFolderId,
+  folders,
+  currentFolderId,
+  onNavigate,
+  rootLabel,
+  viewSurface,
+  label,
+  columns,
+  renderRow,
+  renderCard,
+  tags,
+  search,
+  renderFolderActions,
+  emptyStates,
+}: ExplorerViewProps<T>): ReactNode {
+  const [viewMode, setViewMode] = useViewMode(viewSurface);
+
+  if (viewSurface === '') throw new Error('ExplorerView requires a non-empty viewSurface key.');
+  if (columns.length === 0) throw new Error('ExplorerView requires at least one column.');
+
+  // Nothing anywhere: no items and no folders. A bare empty state, no controls.
+  if (items.length === 0 && folders.length === 0) {
+    return <EmptyState {...emptyStates.empty} />;
+  }
+
+  const subfolders = childFolders(folders, currentFolderId);
+  const inFolder = items.filter((item) => getFolderId(item) === currentFolderId);
+
+  const selectedSet = tags !== undefined ? new Set(tags.selected) : undefined;
+  const query = search ? search.value.trim() : '';
+  const filtered = inFolder.filter((item) => {
+    if (tags !== undefined && selectedSet !== undefined && selectedSet.size > 0) {
+      if (!matchesSelectedTags(tags.getTags(item), selectedSet)) return false;
+    }
+    if (search !== undefined && query !== '') {
+      if (!search.matches(item, query)) return false;
+    }
+    return true;
+  });
+
+  const vocabulary =
+    tags !== undefined
+      ? buildTagVocabulary(inFolder, tags.getTags, tags.selected, tags.untaggedLabel)
+      : [];
+
+  const toggleTag = (token: string): void => {
+    if (tags === undefined || selectedSet === undefined) return;
+    const next = selectedSet.has(token)
+      ? tags.selected.filter((t) => t !== token)
+      : [...tags.selected, token];
+    tags.onChange(next);
+  };
+
+  const hasEntries = subfolders.length > 0 || filtered.length > 0;
+
+  let body: ReactNode;
+  if (!hasEntries) {
+    // The current folder renders nothing. A filter emptied it (`inFolder` non-empty)
+    // → "no match"; otherwise the folder is genuinely empty.
+    body = (
+      <EmptyState {...(inFolder.length > 0 ? emptyStates.noMatch : emptyStates.emptyFolder)} />
+    );
+  } else if (viewMode === 'cards') {
+    body = (
+      <EntityCardGrid aria-label={label}>
+        {subfolders.map((folder) => (
+          <div role="listitem" key={`folder:${folder.id}`}>
+            <Card interactive>
+              <FolderEntry
+                folder={folder}
+                onNavigate={onNavigate}
+                renderFolderActions={renderFolderActions}
+              />
+            </Card>
+          </div>
+        ))}
+        {filtered.map((item) => (
+          <div role="listitem" key={`item:${getItemKey(item)}`}>
+            {renderCard(item)}
+          </div>
+        ))}
+      </EntityCardGrid>
+    );
+  } else {
+    // Folder rows share the item table, spanning every column, sorted above items —
+    // so a folder-with-only-subfolders is folder ROWS, never a header-only table.
+    body = (
+      <Table>
+        <THead>
+          <TR>
+            {columns.map((column) => (
+              <TH key={column.key} numeric={column.numeric}>
+                {column.header}
+              </TH>
+            ))}
+          </TR>
+        </THead>
+        <TBody>
+          {subfolders.map((folder) => (
+            <TR key={`folder:${folder.id}`}>
+              <TD colSpan={columns.length}>
+                <FolderEntry
+                  folder={folder}
+                  onNavigate={onNavigate}
+                  renderFolderActions={renderFolderActions}
+                />
+              </TD>
+            </TR>
+          ))}
+          {filtered.map((item) => (
+            <TR key={`item:${getItemKey(item)}`}>{renderRow(item)}</TR>
+          ))}
+        </TBody>
+      </Table>
+    );
+  }
+
+  return (
+    <div className="tai-explorer">
+      <div className="tai-explorer-controls">
+        {search !== undefined ? (
+          <span className="tai-row">
+            <SearchIcon />
+            <TextInput
+              value={search.value}
+              aria-label={search.label}
+              placeholder={search.placeholder}
+              onChange={(event) => {
+                search.onChange(event.target.value);
+              }}
+            />
+          </span>
+        ) : (
+          <span />
+        )}
+        <ViewToggle value={viewMode} onValueChange={setViewMode} aria-label={`${label} view`} />
+      </div>
+
+      <FolderBreadcrumb
+        folders={folders}
+        currentFolderId={currentFolderId}
+        onNavigate={onNavigate}
+        rootLabel={rootLabel}
+      />
+
+      {tags !== undefined && selectedSet !== undefined && vocabulary.length > 0 ? (
+        <TagFilterRow
+          vocabulary={vocabulary}
+          selectedSet={selectedSet}
+          onToggle={toggleTag}
+          filterLabel={tags.filterLabel}
+          maxVisibleTags={tags.maxVisibleTags}
+        />
+      ) : null}
+
+      {body}
+    </div>
+  );
+}

package/src/components/page-fill.tsx

@@ -0,0 +1,76 @@
+/**
+ * Full-height page mode: a page declares "I fill the viewport" and the shell
+ * gives its wrapper a viewport-height flex chain instead of the default
+ * content-sized, scrolling `.tai-page`.
+ *
+ * The signal travels page → shell through context, NOT a route handle: plugin
+ * pages all share ONE catch-all route, so a per-route handle cannot vary between
+ * them. A rendered page (feature route or plugin page alike) opts in with
+ * {@link useFillViewport}; the shell reads {@link usePageFillActive} to add the
+ * `.tai-page--fill` / `.tai-shell-main--fill` modifiers. Opt-in is ref-counted so
+ * the modifier survives a route transition (old page unmounts after the new one
+ * mounts) and clears exactly when the last fill page leaves.
+ */
+import { createContext, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';
+
+/** The registrar a fill page acquires against; each acquire returns its own
+ * one-shot release, so double-release is inert. */
+interface PageFillRegistry {
+  readonly acquire: () => () => void;
+}
+
+const PageFillRegistryContext = createContext<PageFillRegistry | null>(null);
+const PageFillActiveContext = createContext(false);
+
+/**
+ * Wraps the shell's routed region: holds the count of pages asking for fill mode
+ * and publishes both the registrar (for {@link useFillViewport}) and the active
+ * flag (for {@link usePageFillActive}). Renders no DOM of its own.
+ */
+export function PageFillProvider({ children }: { children: ReactNode }): ReactNode {
+  const [fillCount, setFillCount] = useState(0);
+  const registry = useMemo<PageFillRegistry>(
+    () => ({
+      acquire() {
+        setFillCount((count) => count + 1);
+        let released = false;
+        return () => {
+          if (released) return;
+          released = true;
+          setFillCount((count) => count - 1);
+        };
+      },
+    }),
+    [],
+  );
+  return (
+    <PageFillRegistryContext.Provider value={registry}>
+      <PageFillActiveContext.Provider value={fillCount > 0}>
+        {children}
+      </PageFillActiveContext.Provider>
+    </PageFillRegistryContext.Provider>
+  );
+}
+
+/**
+ * Opt the current page into full-height fill mode for as long as it is mounted.
+ * The shell fills `<main>` to the viewport and lets the page's own root flex or
+ * `height: 100%` down the chain. Must be called under a {@link PageFillProvider}
+ * (the shell mounts one); outside it there is no wrapper to modify, so it throws
+ * rather than silently do nothing.
+ */
+export function useFillViewport(): void {
+  const registry = useContext(PageFillRegistryContext);
+  if (registry === null) {
+    throw new Error(
+      'useFillViewport must be used within a <PageFillProvider> (the shell provides it)',
+    );
+  }
+  useEffect(() => registry.acquire(), [registry]);
+}
+
+/** Whether any mounted page currently asks for fill mode — the shell's cue to add
+ * the fill modifiers to `<main>` and the page wrapper. */
+export function usePageFillActive(): boolean {
+  return useContext(PageFillActiveContext);
+}

package/src/index.ts

@@ -116,6 +116,7 @@ export type {
 } from './components/primitives';
 export { PageHeader, Page, Stack } from './components/page-header';
 export type { PageHeaderProps, PageLayoutProps, StackProps } from './components/page-header';
+export { PageFillProvider, useFillViewport, usePageFillActive } from './components/page-fill';
 export { ErrorBoundary } from './components/error-boundary';
 export type { ErrorBoundaryProps } from './components/error-boundary';
 export { Field, useFieldControl } from './components/field';
@@ -175,6 +176,21 @@ export { ViewToggle, useViewMode } from './components/view-toggle';
 export type { ViewMode, ViewToggleProps } from './components/view-toggle';
 export { EntityCardGrid } from './components/entity-card-grid';
 export type { EntityCardGridProps } from './components/entity-card-grid';
+export {
+  ExplorerView,
+  buildTagVocabulary,
+  matchesSelectedTags,
+  UNTAGGED_TOKEN,
+} from './components/explorer-view';
+export type {
+  ExplorerViewProps,
+  ExplorerColumn,
+  ExplorerTags,
+  ExplorerSearch,
+  ExplorerEmptyState,
+  ExplorerEmptyStates,
+  TagVocabularyEntry,
+} from './components/explorer-view';
 export {
   FolderBreadcrumb,
   FolderRow,