@elaraai/e3-ui 1.0.83 → 1.0.85

package/dist/src/studio/library.d.ts.map

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

package/dist/src/studio/library.js

@@ -0,0 +1,245 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Studio.Library>` (#997) — a project's templates and pages, and where
+ * new pages start.
+ *
+ * The page library is a component of its own, apart from the builder: an
+ * interface — the pages record bound with its patch, the listed components,
+ * the project it shows first, the builder it opens pages in, and who to tell —
+ * which the `StudioLibrary` renderer draws, headerless with one toolbar: the
+ * search over both rows, Sort · Name, the pages' Grid · List and the primary
+ * "+ New page in <project>"; beside it the projects the record holds and the
+ * project's pages; under it the Templates — Blank grid, then the project's
+ * templates — and the Pages, each card a wireframe of its layout.
+ *
+ * A new page — from the toolbar's button, the dashed last card or a template's
+ * card — takes a name and a template, and is one commit on the record.
+ * "Open in builder →" opens a page in the builder: it writes the builder's
+ * open page ({@link builderKeys}) and tells the host.
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, BooleanType, DictType, East, FunctionType, IntegerType, NullType, OptionType, SetType, StringType, StructType, none, some, } from "@elaraai/east";
+import { EastUI, optionsTag, } from "@elaraai/east-ui/internal";
+import { RecordOutcomeType } from "../bind/record.js";
+import { StudioComponentType } from "./component.js";
+import { StudioCellType, StudioKeyType, StudioPagesHandleType, StudioPagesType, pageStatus } from "./pages.js";
+// ============================================================================
+// Types
+// ============================================================================
+/**
+ * A page of the project, as the page library's Pages row draws it.
+ *
+ * @property page - The page's name in the project
+ * @property title - Its title
+ * @property live - Whether it is live: published, its draft its live layout
+ * @property cells - Its draft's placements — its card's wireframe
+ */
+export const StudioLibraryPageType = StructType({
+    page: StringType,
+    title: StringType,
+    live: BooleanType,
+    cells: ArrayType(StudioCellType),
+});
+/**
+ * A template, as the page library's Templates row draws it.
+ *
+ * @property name - The template's name in the project; `""` for Blank grid
+ * @property title - Its title
+ * @property summary - What it places — "KPI rail ×4 · Revenue trend"
+ * @property cells - Its placements — its card's wireframe
+ */
+export const StudioLibraryTemplateType = StructType({
+    name: StringType,
+    title: StringType,
+    summary: StringType,
+    cells: ArrayType(StudioCellType),
+});
+/**
+ * The `StudioLibrary` renderer's payload — the page library's interface.
+ *
+ * @property pages - The pages record, bound with its patch — what it reads, and a new page commits through
+ * @property components - The components the surface lists — what a layout's summary names
+ * @property project - The project it shows first
+ * @property id - Names the builder whose open page it writes; `none` for the one builder
+ * @property onOpen - Told when a page opens in the builder, with its key — the host shows the builder
+ */
+export const StudioLibraryPayloadType = StructType({
+    pages: StudioPagesHandleType,
+    components: ArrayType(StudioComponentType),
+    project: StringType,
+    id: OptionType(StringType),
+    onOpen: OptionType(FunctionType([StudioKeyType], NullType)),
+});
+// ============================================================================
+// What the page library shows
+// ============================================================================
+/** The projects the record holds, and the surface's own, in name order. */
+export const libraryProjects = East.function([StudioPagesType, StringType], ArrayType(StringType), ($, pages, home) => {
+    const projects = $.let(new Set(), SetType(StringType));
+    $(projects.insert(home));
+    $.for(pages, ($2, _entry, key) => {
+        $2(projects.tryInsert(key.project));
+    });
+    const listed = $.let([], ArrayType(StringType));
+    $.for(projects, ($2, project) => {
+        $2(listed.pushLast(project));
+    });
+    return listed;
+});
+/**
+ * What a layout places, as its card's meta line says: each component's name,
+ * counted when it is placed more than once — "KPI rail ×4 · Revenue trend" —
+ * in the order they first appear. A component the surface does not list is
+ * named by its key.
+ */
+export const layoutSummary = East.function([ArrayType(StudioComponentType), ArrayType(StudioCellType)], StringType, ($, components, cells) => {
+    const order = $.let([], ArrayType(StringType));
+    const counts = $.let(new Map(), DictType(StringType, IntegerType));
+    $.for(cells, ($2, cell) => {
+        $2.if(counts.has(cell.component).not(), ($3) => {
+            $3(order.pushLast(cell.component));
+        });
+        $2(counts.insertOrUpdate(cell.component, 1n, (_$3, n) => n.add(1n)));
+    });
+    const parts = $.let([], ArrayType(StringType));
+    $.for(order, ($2, key) => {
+        const name = $2.let(components.firstMap((_$3, c) => c.key.equal(key).ifElse(() => East.value(some(c.name), OptionType(StringType)), () => East.value(none, OptionType(StringType)))).match({
+            some: (_$3, found) => found,
+            none: (_$3) => key,
+        }));
+        const count = $2.let(counts.get(key));
+        $2(parts.pushLast(count.greater(1n).ifElse(() => East.str `${name} ×${East.print(count)}`, () => name)));
+    });
+    return parts.stringJoin(" · ");
+});
+/** A project's pages, in name order: each one's name, title, whether it is live, and its draft's placements. */
+export const libraryPages = East.function([StudioPagesType, StringType], ArrayType(StudioLibraryPageType), ($, pages, project) => {
+    const listed = $.let([], ArrayType(StudioLibraryPageType));
+    $.for(pages, ($2, entry, key) => {
+        $2.if(key.project.equal(project), ($3) => {
+            $3.match(entry, {
+                page: ($4, page) => {
+                    $4(listed.pushLast({
+                        page: key.page,
+                        title: page.draft.title,
+                        live: pageStatus(page).hasTag("live"),
+                        cells: page.draft.cells,
+                    }));
+                },
+            });
+        });
+    });
+    return listed;
+});
+/** A project's templates, in name order, each with what it places. */
+export const libraryTemplates = East.function([StudioPagesType, StringType, ArrayType(StudioComponentType)], ArrayType(StudioLibraryTemplateType), ($, pages, project, components) => {
+    const listed = $.let([], ArrayType(StudioLibraryTemplateType));
+    $.for(pages, ($2, entry, key) => {
+        $2.if(key.project.equal(project), ($3) => {
+            $3.match(entry, {
+                template: ($4, layout) => {
+                    $4(listed.pushLast({
+                        name: key.page,
+                        title: layout.title,
+                        summary: layoutSummary(components, layout.cells),
+                        cells: layout.cells,
+                    }));
+                },
+            });
+        });
+    });
+    return listed;
+});
+/**
+ * What refused a write that makes an entry under a new name — a new page, a
+ * template — or `none` when it committed. A name another write took first is
+ * a conflict; a write that got no answer may have committed, and says so.
+ */
+export const nameWriteRefusal = East.function([RecordOutcomeType, StringType], OptionType(StringType), ($, outcome, name) => {
+    const refused = $.let(none, OptionType(StringType));
+    $.match(outcome, {
+        conflict: ($2) => { $2.assign(refused, some(East.str `Another write took the name ${name} first — choose another`)); },
+        invalid: ($2, refusal) => { $2.assign(refused, some(refusal.message)); },
+        failed: ($2, refusal) => { $2.assign(refused, some(East.str `The write failed: ${refusal.stderr}`)); },
+        timed_out: ($2) => { $2.assign(refused, some("The write ran out of time and wrote nothing")); },
+        transport: ($2, lost) => { $2.assign(refused, some(East.str `The write got no answer, so it may have been made — ${lost.message}`)); },
+    });
+    return refused;
+});
+// ============================================================================
+// The renderer's carrier
+// ============================================================================
+/**
+ * Internal {@link EastUI.component} carrier. The React renderer registers
+ * against this in `@elaraai/e3-ui-components` via `implementUIComponent`.
+ */
+export const StudioLibraryComponent = EastUI.component("StudioLibrary", StudioLibraryPayloadType, { optional: true });
+/**
+ * A project's templates and pages, and where new pages start.
+ *
+ * @remarks
+ * - **The toolbar**, one row: the search "Search N pages and M templates…",
+ *   which narrows both rows by title; Sort · Name, A to Z (the record's key
+ *   order) or Z to A; the Pages row's Grid · List; and "+ New page in
+ *   <project>".
+ * - **The pane**: the projects the record holds, the one shown in the brand;
+ *   then the project's pages, each with its status dot — ● live, ○ draft —
+ *   the one open in the builder in the strong ink, a click opening one in the
+ *   builder; and the legend.
+ * - **Templates**, "clone to start a page": Blank grid, then the project's
+ *   templates, four across, each with its wireframe, its title and what it
+ *   places; a click starts a new page from it.
+ * - **Pages**, "N in <project>": two across, each with its wireframe at its
+ *   start, its title and status, how many components it places, and "Open in
+ *   builder →"; a dashed card last starts a new page.
+ * - **A new page** takes a name the project does not hold and a template, or
+ *   Blank grid, in a popover under the New page button — which a template's
+ *   card and the dashed card open too, their template picked — and is one
+ *   commit on the record; a name another write took first is refused in the
+ *   popover.
+ *
+ * The project shown, the search, the order and the Pages row's layout are the
+ * page library's own; the page it opens is the builder's, shared by `id` with
+ * a `<Studio.Builder>`. The page library draws no border around itself.
+ *
+ * @param options - The bound record, the listed components and the project ({@link StudioLibraryOptions})
+ * @returns An East expression of type `UIComponentType`
+ *
+ * @example
+ * ```tsx
+ * import { East } from "@elaraai/east";
+ * import { Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Record, Studio, ui } from "@elaraai/e3-ui";
+ *
+ * // The page library: the project's pages and templates, and where new pages start.
+ * export const library = ui("library", [], East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const components = $.let([kpiRail, revenueTrend, breakdownBars]);
+ *         const pages      = $.let(Record.bind(d.pages, [d.pagesPatch]));
+ *         return <Studio.Library pages={pages} components={components} project="Ops console" />;
+ *     }}</Reactive>
+ * )));
+ * ```
+ */
+function createLibrary(options) {
+    return StudioLibraryComponent.Root({
+        pages: { read: options.pages.read, history: options.pages.history, commit: { patch: options.pages.commit.patch } },
+        components: options.components,
+        project: options.project,
+        id: options.id === undefined ? none : some(options.id),
+        onOpen: options.onOpen === undefined ? none : some(options.onOpen),
+    });
+}
+// ============================================================================
+// Tag
+// ============================================================================
+/**
+ * `<Studio.Library>` — a project's templates and pages, and where new
+ * pages start. See {@link createLibrary}.
+ */
+export const StudioLibrary = optionsTag(createLibrary);
+//# sourceMappingURL=library.js.map

package/dist/src/studio/library.js.map

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

package/dist/src/studio/page.d.ts

@@ -0,0 +1,305 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Studio.Page>` (#993) — a page as operators see it. It reads the pages
+ * record's value and never writes it.
+ *
+ * The page is an interface — the record's value, the listed components, the
+ * page's key and which of its layouts to draw — and the `StudioPage` renderer
+ * draws it: the layout's placements on the snap grid, each its component's own
+ * UI, so a surface's `ui()` task holds every listed component's reads. A
+ * solution places it where it wants, in a layout of its own.
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, NullType, StructType, VariantType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+import { type JsxTag, type OptionsProps, type UIComponentType } from "@elaraai/east-ui/internal";
+import { StudioComponentType } from "./component.js";
+import { StudioKeyType, StudioPagesType } from "./pages.js";
+/**
+ * Which layout of a page to draw.
+ *
+ * @property live - The published version — what a published page shows
+ * @property draft - The layout as last saved — what the builder edits
+ */
+export declare const StudioVersionType: VariantType<{
+    readonly live: NullType;
+    readonly draft: NullType;
+}>;
+/** Type representing which layout of a page to draw. */
+export type StudioVersionType = typeof StudioVersionType;
+/** Literal shorthand for {@link StudioVersionType}. */
+export type StudioVersionLiteral = "live" | "draft";
+/**
+ * The `StudioPage` renderer's payload — one page, to draw.
+ *
+ * @property pages - The pages record's value
+ * @property components - The components the surface lists
+ * @property page - The page's key
+ * @property version - Which of its layouts to draw
+ */
+export declare const StudioPagePayloadType: StructType<{
+    readonly pages: import("@elaraai/east").DictType<StructType<{
+        readonly project: import("@elaraai/east").StringType;
+        readonly page: import("@elaraai/east").StringType;
+    }>, VariantType<{
+        readonly page: StructType<{
+            readonly draft: StructType<{
+                readonly title: import("@elaraai/east").StringType;
+                readonly cells: ArrayType<StructType<{
+                    readonly key: import("@elaraai/east").StringType;
+                    readonly row: import("@elaraai/east").StringType;
+                    readonly span: import("@elaraai/east").IntegerType;
+                    readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                    readonly align: VariantType<{
+                        readonly top: NullType;
+                        readonly center: NullType;
+                        readonly stretch: NullType;
+                    }>;
+                    readonly title: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly component: import("@elaraai/east").StringType;
+                    readonly fingerprint: import("@elaraai/east").StringType;
+                }>>;
+            }>;
+            readonly live: import("@elaraai/east").OptionType<StructType<{
+                readonly version: import("@elaraai/east").IntegerType;
+                readonly page: StructType<{
+                    readonly title: import("@elaraai/east").StringType;
+                    readonly cells: ArrayType<StructType<{
+                        readonly key: import("@elaraai/east").StringType;
+                        readonly row: import("@elaraai/east").StringType;
+                        readonly span: import("@elaraai/east").IntegerType;
+                        readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                        readonly align: VariantType<{
+                            readonly top: NullType;
+                            readonly center: NullType;
+                            readonly stretch: NullType;
+                        }>;
+                        readonly title: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly component: import("@elaraai/east").StringType;
+                        readonly fingerprint: import("@elaraai/east").StringType;
+                    }>>;
+                }>;
+            }>>;
+        }>;
+        readonly template: StructType<{
+            readonly title: import("@elaraai/east").StringType;
+            readonly cells: ArrayType<StructType<{
+                readonly key: import("@elaraai/east").StringType;
+                readonly row: import("@elaraai/east").StringType;
+                readonly span: import("@elaraai/east").IntegerType;
+                readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                readonly align: VariantType<{
+                    readonly top: NullType;
+                    readonly center: NullType;
+                    readonly stretch: NullType;
+                }>;
+                readonly title: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                readonly component: import("@elaraai/east").StringType;
+                readonly fingerprint: import("@elaraai/east").StringType;
+            }>>;
+        }>;
+    }>>;
+    readonly components: ArrayType<StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+        readonly category: import("@elaraai/east").StringType;
+        readonly icon: import("@elaraai/east").StringType;
+        readonly span: import("@elaraai/east").IntegerType;
+        readonly description: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+        readonly frame: VariantType<{
+            readonly card: NullType;
+            readonly none: NullType;
+        }>;
+        readonly tags: ArrayType<import("@elaraai/east").StringType>;
+        readonly collections: ArrayType<import("@elaraai/east").StringType>;
+        readonly deprecated: import("@elaraai/east").BooleanType;
+        readonly reads: StructType<{
+            readonly paths: ArrayType<ArrayType<VariantType<{
+                readonly field: import("@elaraai/east").StringType;
+            }>>>;
+            readonly functions: ArrayType<import("@elaraai/east").StringType>;
+            readonly records: ArrayType<import("@elaraai/east").StringType>;
+            readonly pages: ArrayType<ArrayType<VariantType<{
+                readonly field: import("@elaraai/east").StringType;
+            }>>>;
+        }>;
+        readonly fingerprint: import("@elaraai/east").StringType;
+        readonly render: import("@elaraai/east").FunctionType<[], import("@elaraai/east").RecursiveType<import("@elaraai/east-ui").UIComponentNode>>;
+    }>>;
+    readonly page: StructType<{
+        readonly project: import("@elaraai/east").StringType;
+        readonly page: import("@elaraai/east").StringType;
+    }>;
+    readonly version: VariantType<{
+        readonly live: NullType;
+        readonly draft: NullType;
+    }>;
+}>;
+/** Type representing the `StudioPage` renderer's payload. */
+export type StudioPagePayloadType = typeof StudioPagePayloadType;
+/**
+ * Internal {@link EastUI.component} carrier. The React renderer registers
+ * against this in `@elaraai/e3-ui-components` via `implementUIComponent`.
+ */
+export declare const StudioPageComponent: import("@elaraai/east-ui/internal").UIComponentDef<StructType<{
+    readonly pages: import("@elaraai/east").DictType<StructType<{
+        readonly project: import("@elaraai/east").StringType;
+        readonly page: import("@elaraai/east").StringType;
+    }>, VariantType<{
+        readonly page: StructType<{
+            readonly draft: StructType<{
+                readonly title: import("@elaraai/east").StringType;
+                readonly cells: ArrayType<StructType<{
+                    readonly key: import("@elaraai/east").StringType;
+                    readonly row: import("@elaraai/east").StringType;
+                    readonly span: import("@elaraai/east").IntegerType;
+                    readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                    readonly align: VariantType<{
+                        readonly top: NullType;
+                        readonly center: NullType;
+                        readonly stretch: NullType;
+                    }>;
+                    readonly title: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly component: import("@elaraai/east").StringType;
+                    readonly fingerprint: import("@elaraai/east").StringType;
+                }>>;
+            }>;
+            readonly live: import("@elaraai/east").OptionType<StructType<{
+                readonly version: import("@elaraai/east").IntegerType;
+                readonly page: StructType<{
+                    readonly title: import("@elaraai/east").StringType;
+                    readonly cells: ArrayType<StructType<{
+                        readonly key: import("@elaraai/east").StringType;
+                        readonly row: import("@elaraai/east").StringType;
+                        readonly span: import("@elaraai/east").IntegerType;
+                        readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                        readonly align: VariantType<{
+                            readonly top: NullType;
+                            readonly center: NullType;
+                            readonly stretch: NullType;
+                        }>;
+                        readonly title: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly component: import("@elaraai/east").StringType;
+                        readonly fingerprint: import("@elaraai/east").StringType;
+                    }>>;
+                }>;
+            }>>;
+        }>;
+        readonly template: StructType<{
+            readonly title: import("@elaraai/east").StringType;
+            readonly cells: ArrayType<StructType<{
+                readonly key: import("@elaraai/east").StringType;
+                readonly row: import("@elaraai/east").StringType;
+                readonly span: import("@elaraai/east").IntegerType;
+                readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                readonly align: VariantType<{
+                    readonly top: NullType;
+                    readonly center: NullType;
+                    readonly stretch: NullType;
+                }>;
+                readonly title: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                readonly component: import("@elaraai/east").StringType;
+                readonly fingerprint: import("@elaraai/east").StringType;
+            }>>;
+        }>;
+    }>>;
+    readonly components: ArrayType<StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+        readonly category: import("@elaraai/east").StringType;
+        readonly icon: import("@elaraai/east").StringType;
+        readonly span: import("@elaraai/east").IntegerType;
+        readonly description: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+        readonly frame: VariantType<{
+            readonly card: NullType;
+            readonly none: NullType;
+        }>;
+        readonly tags: ArrayType<import("@elaraai/east").StringType>;
+        readonly collections: ArrayType<import("@elaraai/east").StringType>;
+        readonly deprecated: import("@elaraai/east").BooleanType;
+        readonly reads: StructType<{
+            readonly paths: ArrayType<ArrayType<VariantType<{
+                readonly field: import("@elaraai/east").StringType;
+            }>>>;
+            readonly functions: ArrayType<import("@elaraai/east").StringType>;
+            readonly records: ArrayType<import("@elaraai/east").StringType>;
+            readonly pages: ArrayType<ArrayType<VariantType<{
+                readonly field: import("@elaraai/east").StringType;
+            }>>>;
+        }>;
+        readonly fingerprint: import("@elaraai/east").StringType;
+        readonly render: import("@elaraai/east").FunctionType<[], import("@elaraai/east").RecursiveType<import("@elaraai/east-ui").UIComponentNode>>;
+    }>>;
+    readonly page: StructType<{
+        readonly project: import("@elaraai/east").StringType;
+        readonly page: import("@elaraai/east").StringType;
+    }>;
+    readonly version: VariantType<{
+        readonly live: NullType;
+        readonly draft: NullType;
+    }>;
+}>>;
+/**
+ * `<Studio.Page>` options.
+ *
+ * @property pages - The pages record's value — `Data.bind(pages).read()`
+ * @property components - The components the surface lists
+ * @property page - The page's key
+ * @property version - `"live"` (the default) or `"draft"`
+ */
+export interface StudioPageOptions {
+    /** The pages record's value — `Data.bind(pages).read()`, or a bound record's `read()`. */
+    pages: SubtypeExprOrValue<StudioPagesType>;
+    /** The components the surface lists, in palette order. */
+    components: SubtypeExprOrValue<ArrayType<StudioComponentType>>;
+    /** The page's key. */
+    page: SubtypeExprOrValue<StudioKeyType>;
+    /** Which layout: the published one (`"live"`, the default), or the draft. */
+    version?: StudioVersionLiteral | SubtypeExprOrValue<StudioVersionType>;
+}
+/**
+ * Draws one page with no chrome: its live or draft layout on the snap grid,
+ * each placement its component's own UI.
+ *
+ * @remarks
+ * A component renders the same way here and in the builder: a frameless one
+ * (`frame: "none"`) is bare, and a tile's label is its title or its
+ * component's name. Two placements of one component share its State and Slice
+ * keys. A placement whose component the surface does not list is a
+ * placeholder naming its key. A page the record does not hold, or a live
+ * version not yet published, is a placeholder that says so. Under a narrow
+ * container the tiles stack in row order. The page draws no border around
+ * itself.
+ *
+ * @param options - The record's value, the listed components, the page and
+ *   its version ({@link StudioPageOptions})
+ * @returns An East expression of type `UIComponentType`
+ *
+ * @example
+ * ```tsx
+ * import { East } from "@elaraai/east";
+ * import { Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Data, Studio, ui } from "@elaraai/e3-ui";
+ *
+ * // The published Overview page, for everyone else: it only reads the pages.
+ * export const opsConsole = ui("ops_console", [], East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const components = $.let([kpiRail, revenueTrend, breakdownBars]);
+ *         const all        = $.let(Data.bind(pages));
+ *         return <Studio.Page pages={all.read()} components={components}
+ *             page={{ project: "Ops console", page: "Overview" }} />;
+ *     }}</Reactive>
+ * )));
+ * ```
+ */
+declare function createPage(options: StudioPageOptions): ExprType<UIComponentType>;
+/**
+ * `<Studio.Page>` — one page with no chrome, its live or draft layout on the
+ * snap grid. See {@link createPage}.
+ */
+export declare const StudioPage: JsxTag<OptionsProps<typeof createPage>>;
+export {};
+//# sourceMappingURL=page.d.ts.map

package/dist/src/studio/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/studio/page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EACH,SAAS,EACT,QAAQ,EACR,UAAU,EACV,WAAW,EAEX,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAGH,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,eAAe,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM5D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AAEH,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AAEzD,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAA4E,CAAC;AAM7G;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAC9B,0FAA0F;IAC1F,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAC3C,0DAA0D;IAC1D,UAAU,EAAE,kBAAkB,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC/D,sBAAsB;IACtB,IAAI,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACxC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,iBAAS,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,QAAQ,CAAC,eAAe,CAAC,CAQzE;AAMD;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,UAAU,CAAC,CAA0B,CAAC"}