@elaraai/e3-ui 1.0.86 → 1.0.88

package/dist/src/plan/library.d.ts

@@ -0,0 +1,772 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Plan.library` — the Plan's library pane, the author's (#1195,
+ * `Plan Builder Spec.md` §4.3, §8, §9.6, PB26–PB30, PB61, PB62). `library`
+ * lists the pane's tabs, in order, each built here:
+ *
+ * - `Plan.library.events()`: every event kind's templates, by kind;
+ * - `Plan.library.backlog()`: every event kind's unscheduled events, by when
+ *   they are due;
+ * - `Plan.library.series()`: what the canvas shows that a viewer can hide,
+ *   each with an eye — the resource kinds and their measures, the event
+ *   kinds, `data`'s series when they are picked (`pick`), and the Plan's
+ *   `rows`;
+ * - `Plan.library.tab(rows, { … })`: cards of the author's own.
+ *
+ * Left out, or empty, the Plan has no library pane.
+ *
+ * An author's tab reads its rows as `Schedule.resources` does: a `Dict<K, R>`,
+ * usually a record's `read()`, its accessors `(row, key) => …` reified once
+ * into a describe function the map then calls, each card keyed by its row's
+ * key as text. Its cards drag onto the rows of `data` whose series makes an
+ * item of a dropped card (`edit.create`, #1259), as a Library's card beside
+ * the Plan does — the Plan takes its own panel's cards with no `id` or
+ * `sources`. Its `drop` returns what a card dropped on an event sets:
+ * `Schedule.patch` over one event kind's row type, whose type names that kind.
+ * The patch crosses the closed payload as that kind's field writes — each
+ * field it sets, its path and its value as bytes — which a drop writes through
+ * the kind's own `write` (#1196).
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, DictType, NullType, StringType, StructType, VariantType, type EastType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+import type { ScheduleEventKind } from "../schedule/events.js";
+import { type ScheduleLibraryTabConfig as PlanLibraryTabConfig } from "../schedule/library.js";
+export { ScheduleLibraryCardType as PlanLibraryCardType, type ScheduleLibraryTabConfig as PlanLibraryTabConfig } from "../schedule/library.js";
+import type { ScheduleResourceKind } from "../schedule/resources.js";
+/**
+ * One card of an author's tab on the wire.
+ *
+ * @property key - Its row's key, as text
+ * @property label - Its name
+ * @property meta - The line under its name
+ * @property group - The tab's group the card sits under
+ * @property sets - What a drop writes into the event it lands on: each field the tab's `drop` patch sets; empty without a `drop`
+ */
+/**
+ * The id the Series tab lists a thing by, and a viewer's hidden set holds it by
+ * (PB29): one namespace per source, so no two collide — a resource kind and an
+ * event kind by slot, a measure, a hand-built row and a `Plan.over` series by
+ * key. `data`'s picked series are the pick's own, by their bare keys.
+ *
+ * @internal
+ */
+export declare const planHideId: {
+    /** A resource kind, by slot: hiding it hides its rows. */
+    readonly resources: (slot: string) => string;
+    /** An event kind, by slot: hiding it hides its elements everywhere. */
+    readonly events: (slot: string) => string;
+    /** A measure, by key: hiding it hides its row under each resource. */
+    readonly measures: (key: string) => string;
+    /** A hand-built row, by key: hiding it hides it and the rows under it. */
+    readonly rows: (key: string) => string;
+    /** A `Plan.over` series, by key: hiding it hides its rows and its nested series'. */
+    readonly series: (key: string) => string;
+};
+/**
+ * What hiding one of a Plan's `rows` hides on the canvas: a `Plan.over`
+ * series' rows, by the keys they carry — its own and every series' nested in
+ * it — or a hand-built row and the rows under it, by its key, the first step
+ * of their ids' paths.
+ */
+export declare const PlanLibraryHidesType: VariantType<{
+    readonly series: ArrayType<StringType>;
+    readonly rows: StringType;
+}>;
+/** Type representing {@link PlanLibraryHidesType}. */
+export type PlanLibraryHidesType = typeof PlanLibraryHidesType;
+/**
+ * One of a Plan's `rows` as the Series tab lists it.
+ *
+ * @property item - Its line in the tab, an eye beside it
+ * @property hides - What hiding it hides
+ */
+export declare const PlanLibraryRowsItemType: StructType<{
+    readonly item: StructType<{
+        readonly id: StringType;
+        readonly title: StringType;
+        readonly subtitle: import("@elaraai/east").OptionType<StringType>;
+        readonly icon: import("@elaraai/east").OptionType<StructType<{
+            readonly name: StringType;
+            readonly prefix: StringType;
+            readonly label: import("@elaraai/east").OptionType<StringType>;
+            readonly style: import("@elaraai/east").OptionType<StructType<{
+                readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly xs: NullType;
+                    readonly sm: NullType;
+                    readonly md: NullType;
+                    readonly lg: NullType;
+                    readonly xl: NullType;
+                    readonly "2xl": NullType;
+                }>>;
+                readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly solid: NullType;
+                }>>;
+                readonly color: import("@elaraai/east").OptionType<StringType>;
+                readonly background: import("@elaraai/east").OptionType<StringType>;
+                readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly brand: NullType;
+                    readonly gray: NullType;
+                    readonly red: NullType;
+                    readonly orange: NullType;
+                    readonly yellow: NullType;
+                    readonly green: NullType;
+                    readonly teal: NullType;
+                    readonly blue: NullType;
+                    readonly cyan: NullType;
+                    readonly purple: NullType;
+                    readonly pink: NullType;
+                    readonly success: NullType;
+                    readonly warning: NullType;
+                    readonly danger: NullType;
+                    readonly info: NullType;
+                    readonly neutral: NullType;
+                }>>;
+                readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                readonly borderRadius: import("@elaraai/east").OptionType<StringType>;
+                readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly visible: NullType;
+                    readonly hidden: NullType;
+                    readonly scroll: NullType;
+                    readonly auto: NullType;
+                }>>;
+                readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly visible: NullType;
+                    readonly hidden: NullType;
+                    readonly scroll: NullType;
+                    readonly auto: NullType;
+                }>>;
+                readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly visible: NullType;
+                    readonly hidden: NullType;
+                    readonly scroll: NullType;
+                    readonly auto: NullType;
+                }>>;
+                readonly width: import("@elaraai/east").OptionType<StringType>;
+                readonly height: import("@elaraai/east").OptionType<StringType>;
+                readonly minWidth: import("@elaraai/east").OptionType<StringType>;
+                readonly minHeight: import("@elaraai/east").OptionType<StringType>;
+                readonly maxWidth: import("@elaraai/east").OptionType<StringType>;
+                readonly maxHeight: import("@elaraai/east").OptionType<StringType>;
+                readonly padding: import("@elaraai/east").OptionType<StructType<{
+                    readonly top: import("@elaraai/east").OptionType<StringType>;
+                    readonly right: import("@elaraai/east").OptionType<StringType>;
+                    readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                    readonly left: import("@elaraai/east").OptionType<StringType>;
+                }>>;
+                readonly margin: import("@elaraai/east").OptionType<StructType<{
+                    readonly top: import("@elaraai/east").OptionType<StringType>;
+                    readonly right: import("@elaraai/east").OptionType<StringType>;
+                    readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                    readonly left: import("@elaraai/east").OptionType<StringType>;
+                }>>;
+            }>>;
+        }>>;
+        readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+        readonly narrowed: import("@elaraai/east").BooleanType;
+    }>;
+    readonly hides: VariantType<{
+        readonly series: ArrayType<StringType>;
+        readonly rows: StringType;
+    }>;
+}>;
+/** Type representing {@link PlanLibraryRowsItemType}. */
+export type PlanLibraryRowsItemType = typeof PlanLibraryRowsItemType;
+/**
+ * What the Series tab lists (PB29), each a pick item with its eye, in the
+ * order the canvas draws them. `data`'s series, when they are picked, sit
+ * between the two lists: they are the pick's own (the root's `pick`).
+ *
+ * @property kinds - The resource kinds, each followed by its measures, then the event kinds
+ * @property rows - The Plan's `rows`: a hand-built row by its key, each series of a `Plan.over` by its own
+ */
+export declare const PlanLibrarySeriesType: StructType<{
+    readonly kinds: ArrayType<StructType<{
+        readonly id: StringType;
+        readonly title: StringType;
+        readonly subtitle: import("@elaraai/east").OptionType<StringType>;
+        readonly icon: import("@elaraai/east").OptionType<StructType<{
+            readonly name: StringType;
+            readonly prefix: StringType;
+            readonly label: import("@elaraai/east").OptionType<StringType>;
+            readonly style: import("@elaraai/east").OptionType<StructType<{
+                readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly xs: NullType;
+                    readonly sm: NullType;
+                    readonly md: NullType;
+                    readonly lg: NullType;
+                    readonly xl: NullType;
+                    readonly "2xl": NullType;
+                }>>;
+                readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly solid: NullType;
+                }>>;
+                readonly color: import("@elaraai/east").OptionType<StringType>;
+                readonly background: import("@elaraai/east").OptionType<StringType>;
+                readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly brand: NullType;
+                    readonly gray: NullType;
+                    readonly red: NullType;
+                    readonly orange: NullType;
+                    readonly yellow: NullType;
+                    readonly green: NullType;
+                    readonly teal: NullType;
+                    readonly blue: NullType;
+                    readonly cyan: NullType;
+                    readonly purple: NullType;
+                    readonly pink: NullType;
+                    readonly success: NullType;
+                    readonly warning: NullType;
+                    readonly danger: NullType;
+                    readonly info: NullType;
+                    readonly neutral: NullType;
+                }>>;
+                readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                readonly borderRadius: import("@elaraai/east").OptionType<StringType>;
+                readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly visible: NullType;
+                    readonly hidden: NullType;
+                    readonly scroll: NullType;
+                    readonly auto: NullType;
+                }>>;
+                readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly visible: NullType;
+                    readonly hidden: NullType;
+                    readonly scroll: NullType;
+                    readonly auto: NullType;
+                }>>;
+                readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                    readonly visible: NullType;
+                    readonly hidden: NullType;
+                    readonly scroll: NullType;
+                    readonly auto: NullType;
+                }>>;
+                readonly width: import("@elaraai/east").OptionType<StringType>;
+                readonly height: import("@elaraai/east").OptionType<StringType>;
+                readonly minWidth: import("@elaraai/east").OptionType<StringType>;
+                readonly minHeight: import("@elaraai/east").OptionType<StringType>;
+                readonly maxWidth: import("@elaraai/east").OptionType<StringType>;
+                readonly maxHeight: import("@elaraai/east").OptionType<StringType>;
+                readonly padding: import("@elaraai/east").OptionType<StructType<{
+                    readonly top: import("@elaraai/east").OptionType<StringType>;
+                    readonly right: import("@elaraai/east").OptionType<StringType>;
+                    readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                    readonly left: import("@elaraai/east").OptionType<StringType>;
+                }>>;
+                readonly margin: import("@elaraai/east").OptionType<StructType<{
+                    readonly top: import("@elaraai/east").OptionType<StringType>;
+                    readonly right: import("@elaraai/east").OptionType<StringType>;
+                    readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                    readonly left: import("@elaraai/east").OptionType<StringType>;
+                }>>;
+            }>>;
+        }>>;
+        readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+        readonly narrowed: import("@elaraai/east").BooleanType;
+    }>>;
+    readonly rows: ArrayType<StructType<{
+        readonly item: StructType<{
+            readonly id: StringType;
+            readonly title: StringType;
+            readonly subtitle: import("@elaraai/east").OptionType<StringType>;
+            readonly icon: import("@elaraai/east").OptionType<StructType<{
+                readonly name: StringType;
+                readonly prefix: StringType;
+                readonly label: import("@elaraai/east").OptionType<StringType>;
+                readonly style: import("@elaraai/east").OptionType<StructType<{
+                    readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly xs: NullType;
+                        readonly sm: NullType;
+                        readonly md: NullType;
+                        readonly lg: NullType;
+                        readonly xl: NullType;
+                        readonly "2xl": NullType;
+                    }>>;
+                    readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly solid: NullType;
+                    }>>;
+                    readonly color: import("@elaraai/east").OptionType<StringType>;
+                    readonly background: import("@elaraai/east").OptionType<StringType>;
+                    readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly brand: NullType;
+                        readonly gray: NullType;
+                        readonly red: NullType;
+                        readonly orange: NullType;
+                        readonly yellow: NullType;
+                        readonly green: NullType;
+                        readonly teal: NullType;
+                        readonly blue: NullType;
+                        readonly cyan: NullType;
+                        readonly purple: NullType;
+                        readonly pink: NullType;
+                        readonly success: NullType;
+                        readonly warning: NullType;
+                        readonly danger: NullType;
+                        readonly info: NullType;
+                        readonly neutral: NullType;
+                    }>>;
+                    readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                    readonly borderRadius: import("@elaraai/east").OptionType<StringType>;
+                    readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly width: import("@elaraai/east").OptionType<StringType>;
+                    readonly height: import("@elaraai/east").OptionType<StringType>;
+                    readonly minWidth: import("@elaraai/east").OptionType<StringType>;
+                    readonly minHeight: import("@elaraai/east").OptionType<StringType>;
+                    readonly maxWidth: import("@elaraai/east").OptionType<StringType>;
+                    readonly maxHeight: import("@elaraai/east").OptionType<StringType>;
+                    readonly padding: import("@elaraai/east").OptionType<StructType<{
+                        readonly top: import("@elaraai/east").OptionType<StringType>;
+                        readonly right: import("@elaraai/east").OptionType<StringType>;
+                        readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                        readonly left: import("@elaraai/east").OptionType<StringType>;
+                    }>>;
+                    readonly margin: import("@elaraai/east").OptionType<StructType<{
+                        readonly top: import("@elaraai/east").OptionType<StringType>;
+                        readonly right: import("@elaraai/east").OptionType<StringType>;
+                        readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                        readonly left: import("@elaraai/east").OptionType<StringType>;
+                    }>>;
+                }>>;
+            }>>;
+            readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+            readonly narrowed: import("@elaraai/east").BooleanType;
+        }>;
+        readonly hides: VariantType<{
+            readonly series: ArrayType<StringType>;
+            readonly rows: StringType;
+        }>;
+    }>>;
+}>;
+/** Type representing {@link PlanLibrarySeriesType}. */
+export type PlanLibrarySeriesType = typeof PlanLibrarySeriesType;
+/**
+ * One tab of the library pane on the wire, in the order `library` lists them.
+ *
+ * - `events` — every event kind's templates, read off the kinds;
+ * - `backlog` — every event kind's unscheduled events, read off the kinds;
+ * - `series` — what the canvas shows that a viewer can hide;
+ * - `tab` — the author's own: its name, its icon, the event kind its cards
+ *   land on, and its cards.
+ */
+export declare const PlanLibraryTabType: VariantType<{
+    readonly events: NullType;
+    readonly backlog: NullType;
+    readonly series: StructType<{
+        readonly kinds: ArrayType<StructType<{
+            readonly id: StringType;
+            readonly title: StringType;
+            readonly subtitle: import("@elaraai/east").OptionType<StringType>;
+            readonly icon: import("@elaraai/east").OptionType<StructType<{
+                readonly name: StringType;
+                readonly prefix: StringType;
+                readonly label: import("@elaraai/east").OptionType<StringType>;
+                readonly style: import("@elaraai/east").OptionType<StructType<{
+                    readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly xs: NullType;
+                        readonly sm: NullType;
+                        readonly md: NullType;
+                        readonly lg: NullType;
+                        readonly xl: NullType;
+                        readonly "2xl": NullType;
+                    }>>;
+                    readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly solid: NullType;
+                    }>>;
+                    readonly color: import("@elaraai/east").OptionType<StringType>;
+                    readonly background: import("@elaraai/east").OptionType<StringType>;
+                    readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly brand: NullType;
+                        readonly gray: NullType;
+                        readonly red: NullType;
+                        readonly orange: NullType;
+                        readonly yellow: NullType;
+                        readonly green: NullType;
+                        readonly teal: NullType;
+                        readonly blue: NullType;
+                        readonly cyan: NullType;
+                        readonly purple: NullType;
+                        readonly pink: NullType;
+                        readonly success: NullType;
+                        readonly warning: NullType;
+                        readonly danger: NullType;
+                        readonly info: NullType;
+                        readonly neutral: NullType;
+                    }>>;
+                    readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                    readonly borderRadius: import("@elaraai/east").OptionType<StringType>;
+                    readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly width: import("@elaraai/east").OptionType<StringType>;
+                    readonly height: import("@elaraai/east").OptionType<StringType>;
+                    readonly minWidth: import("@elaraai/east").OptionType<StringType>;
+                    readonly minHeight: import("@elaraai/east").OptionType<StringType>;
+                    readonly maxWidth: import("@elaraai/east").OptionType<StringType>;
+                    readonly maxHeight: import("@elaraai/east").OptionType<StringType>;
+                    readonly padding: import("@elaraai/east").OptionType<StructType<{
+                        readonly top: import("@elaraai/east").OptionType<StringType>;
+                        readonly right: import("@elaraai/east").OptionType<StringType>;
+                        readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                        readonly left: import("@elaraai/east").OptionType<StringType>;
+                    }>>;
+                    readonly margin: import("@elaraai/east").OptionType<StructType<{
+                        readonly top: import("@elaraai/east").OptionType<StringType>;
+                        readonly right: import("@elaraai/east").OptionType<StringType>;
+                        readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                        readonly left: import("@elaraai/east").OptionType<StringType>;
+                    }>>;
+                }>>;
+            }>>;
+            readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+            readonly narrowed: import("@elaraai/east").BooleanType;
+        }>>;
+        readonly rows: ArrayType<StructType<{
+            readonly item: StructType<{
+                readonly id: StringType;
+                readonly title: StringType;
+                readonly subtitle: import("@elaraai/east").OptionType<StringType>;
+                readonly icon: import("@elaraai/east").OptionType<StructType<{
+                    readonly name: StringType;
+                    readonly prefix: StringType;
+                    readonly label: import("@elaraai/east").OptionType<StringType>;
+                    readonly style: import("@elaraai/east").OptionType<StructType<{
+                        readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly xs: NullType;
+                            readonly sm: NullType;
+                            readonly md: NullType;
+                            readonly lg: NullType;
+                            readonly xl: NullType;
+                            readonly "2xl": NullType;
+                        }>>;
+                        readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly solid: NullType;
+                        }>>;
+                        readonly color: import("@elaraai/east").OptionType<StringType>;
+                        readonly background: import("@elaraai/east").OptionType<StringType>;
+                        readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly brand: NullType;
+                            readonly gray: NullType;
+                            readonly red: NullType;
+                            readonly orange: NullType;
+                            readonly yellow: NullType;
+                            readonly green: NullType;
+                            readonly teal: NullType;
+                            readonly blue: NullType;
+                            readonly cyan: NullType;
+                            readonly purple: NullType;
+                            readonly pink: NullType;
+                            readonly success: NullType;
+                            readonly warning: NullType;
+                            readonly danger: NullType;
+                            readonly info: NullType;
+                            readonly neutral: NullType;
+                        }>>;
+                        readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                        readonly borderRadius: import("@elaraai/east").OptionType<StringType>;
+                        readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly visible: NullType;
+                            readonly hidden: NullType;
+                            readonly scroll: NullType;
+                            readonly auto: NullType;
+                        }>>;
+                        readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly visible: NullType;
+                            readonly hidden: NullType;
+                            readonly scroll: NullType;
+                            readonly auto: NullType;
+                        }>>;
+                        readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly visible: NullType;
+                            readonly hidden: NullType;
+                            readonly scroll: NullType;
+                            readonly auto: NullType;
+                        }>>;
+                        readonly width: import("@elaraai/east").OptionType<StringType>;
+                        readonly height: import("@elaraai/east").OptionType<StringType>;
+                        readonly minWidth: import("@elaraai/east").OptionType<StringType>;
+                        readonly minHeight: import("@elaraai/east").OptionType<StringType>;
+                        readonly maxWidth: import("@elaraai/east").OptionType<StringType>;
+                        readonly maxHeight: import("@elaraai/east").OptionType<StringType>;
+                        readonly padding: import("@elaraai/east").OptionType<StructType<{
+                            readonly top: import("@elaraai/east").OptionType<StringType>;
+                            readonly right: import("@elaraai/east").OptionType<StringType>;
+                            readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                            readonly left: import("@elaraai/east").OptionType<StringType>;
+                        }>>;
+                        readonly margin: import("@elaraai/east").OptionType<StructType<{
+                            readonly top: import("@elaraai/east").OptionType<StringType>;
+                            readonly right: import("@elaraai/east").OptionType<StringType>;
+                            readonly bottom: import("@elaraai/east").OptionType<StringType>;
+                            readonly left: import("@elaraai/east").OptionType<StringType>;
+                        }>>;
+                    }>>;
+                }>>;
+                readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                readonly narrowed: import("@elaraai/east").BooleanType;
+            }>;
+            readonly hides: VariantType<{
+                readonly series: ArrayType<StringType>;
+                readonly rows: StringType;
+            }>;
+        }>>;
+    }>;
+    readonly tab: StructType<{
+        readonly name: StringType;
+        readonly icon: import("@elaraai/east").OptionType<StringType>;
+        readonly drop: import("@elaraai/east").OptionType<StringType>;
+        readonly cards: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly meta: import("@elaraai/east").OptionType<StringType>;
+            readonly group: import("@elaraai/east").OptionType<StringType>;
+            readonly sets: ArrayType<StructType<{
+                readonly path: ArrayType<StringType>;
+                readonly value: import("@elaraai/east").BlobType;
+            }>>;
+        }>>;
+    }>;
+}>;
+/** Type representing {@link PlanLibraryTabType}. */
+export type PlanLibraryTabType = typeof PlanLibraryTabType;
+/**
+ * An author's tab: its name and icon, and the accessors over one of its rows —
+ * its value and its key — as `Schedule.resources` takes them.
+ *
+ * @typeParam K - The rows' key type
+ * @typeParam R - Their row type
+ * @typeParam P - The patch `drop` returns: `Schedule.Types.Patch` of one event kind's row type
+ */
+/** One tab of the library pane — what each `Plan.library.*` call returns, and `library` lists. */
+export type PlanLibraryTab = {
+    readonly kind: "events";
+} | {
+    readonly kind: "backlog";
+} | {
+    readonly kind: "series";
+} | {
+    readonly kind: "tab";
+    readonly rows: unknown;
+    readonly config: PlanLibraryTabConfig<EastType, EastType>;
+};
+/**
+ * The library's Events tab — `Plan.library.events()`: every event kind's
+ * templates, under the kind's name and icon, then by a template's `group`
+ * (PB27). A card dropped on a resource's row creates an event of its kind
+ * (#1196).
+ *
+ * @returns The tab
+ */
+export declare function libraryEvents(): PlanLibraryTab;
+/**
+ * The library's Backlog tab — `Plan.library.backlog()`: every event kind's
+ * unscheduled events (a kind whose times are Options), by when they are due:
+ * this week, next week, later, or no date (PB28). A card dropped on a
+ * resource's row schedules it (#1196).
+ *
+ * @returns The tab
+ */
+export declare function libraryBacklog(): PlanLibraryTab;
+/**
+ * The library's Series tab — `Plan.library.series()`: what the canvas shows
+ * that a viewer can hide, each with an eye (PB29). Hiding an event kind hides
+ * its elements everywhere, a resource kind its rows, a measure or one of the
+ * Plan's `rows` that row; `data`'s series show and hide through their `pick`.
+ * What a viewer hides is kept for them.
+ *
+ * @returns The tab
+ */
+export declare function librarySeries(): PlanLibraryTab;
+/**
+ * A tab of the author's own cards — `Plan.library.tab(rows, { … })` (PB62):
+ * one card per row, its label and meta, grouped by its `group`, searched by
+ * its key, label and meta. Each card drags onto the rows of `data` whose
+ * series makes an item of it (`edit.create`, #1259) — the drop's `from.key`
+ * its row's key as text, so `canDrop` and `create` read it as a Library card's
+ * — and, given a `drop`, onto an event (#1196), setting the fields the patch
+ * sets.
+ *
+ * @typeParam K - The rows' key type
+ * @typeParam R - Their row type
+ * @typeParam P - The patch `drop` returns
+ * @param rows - The rows — a `Dict<K, R>` value or expression, usually a record's `read()`
+ * @param config - The tab's name and icon, and the accessors ({@link PlanLibraryTabConfig})
+ * @returns The tab
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/e3-ui` pragma
+ * import { DateTimeType, DictType, East, FloatType, NullType, OptionType, StringType, StructType, VariantType, none, some, variant } from "@elaraai/east";
+ * import { EventStateType, Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Plan, Record, Schedule } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * export const PrintPress = StructType({ name: StringType, hall: StringType, sheets_per_hour: FloatType });
+ * export const PrintJob = StructType({
+ *     title: StringType,
+ *     start: OptionType(DateTimeType),
+ *     end: OptionType(DateTimeType),
+ *     press: OptionType(StringType),
+ *     state: EventStateType,
+ *     sheets: FloatType,
+ *     customer: StringType,
+ *     stock: VariantType({ coated: NullType, uncoated: NullType, board: NullType }),
+ *     due: OptionType(DateTimeType),
+ * });
+ * export const PrintCustomer = StructType({ name: StringType, district: StringType, trade: StringType });
+ * export const planPrintPresses = e3.record("plan_print_presses", DictType(StringType, PrintPress), new Map([
+ *     ["a1", { name: "Press A1", hall: "Hall A", sheets_per_hour: 12000.0 }],
+ *     ["a2", { name: "Press A2", hall: "Hall A", sheets_per_hour: 10000.0 }],
+ *     ["a3", { name: "Press A3", hall: "Hall A", sheets_per_hour: 8000.0 }],
+ *     ["b1", { name: "Press B1", hall: "Hall B", sheets_per_hour: 15000.0 }],
+ *     ["b2", { name: "Press B2", hall: "Hall B", sheets_per_hour: 12000.0 }],
+ *     ["b3", { name: "Press B3", hall: "Hall B", sheets_per_hour: 6000.0 }],
+ * ]));
+ * export const planPrintCustomers = e3.record("plan_print_customers", DictType(StringType, PrintCustomer), new Map([
+ *     ["alder-finch", { name: "Alder & Finch", district: "Old Town", trade: "Retail" }],
+ *     ["bluewater-tours", { name: "Bluewater Tours", district: "North Quay", trade: "Travel" }],
+ *     ["copperleaf-cafe", { name: "Copperleaf Cafe", district: "Old Town", trade: "Hospitality" }],
+ *     ["driftwood-museum", { name: "Driftwood Museum", district: "North Quay", trade: "Arts" }],
+ *     ["elmway-college", { name: "Elmway College", district: "Riverside", trade: "Education" }],
+ *     ["foxglove-gardens", { name: "Foxglove Gardens", district: "Riverside", trade: "Retail" }],
+ *     ["granite-hall", { name: "Granite Hall", district: "Old Town", trade: "Events" }],
+ *     ["harbour-arts", { name: "Harbour Arts Society", district: "North Quay", trade: "Arts" }],
+ *     ["heathfield", { name: "Heathfield Theatre", district: "Old Town", trade: "Arts" }],
+ *     ["ivy-lane", { name: "Ivy Lane Studio", district: "Riverside", trade: "Design" }],
+ *     ["juniper-toys", { name: "Juniper Toys", district: "Riverside", trade: "Retail" }],
+ *     ["kestrel-cycling", { name: "Kestrel Cycling Club", district: "Riverside", trade: "Sport" }],
+ *     ["larkspur-home", { name: "Larkspur Home", district: "Old Town", trade: "Retail" }],
+ *     ["meridian-monthly", { name: "Meridian Monthly", district: "North Quay", trade: "Publishing" }],
+ *     ["northwind", { name: "Northwind Outfitters", district: "North Quay", trade: "Retail" }],
+ *     ["orchard-market", { name: "Orchard Street Market", district: "Old Town", trade: "Markets" }],
+ * ]));
+ * export const planEventJobs = e3.record("plan_event_jobs", DictType(StringType, PrintJob), new Map([
+ *     ["J-3001", { title: "Spring catalogue", start: some(new Date("2026-10-06T06:00:00Z")), end: some(new Date("2026-10-06T14:00:00Z")), press: some("a1"), state: variant("actual", null), sheets: 96000.0, customer: "Alder & Finch", stock: variant("coated", null), due: some(new Date("2026-10-08T00:00:00Z")) }],
+ *     ["J-3002", { title: "Course handbook", start: some(new Date("2026-10-19T06:00:00Z")), end: some(new Date("2026-10-19T18:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 144000.0, customer: "Elmway College", stock: variant("uncoated", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-3003", { title: "Annual report", start: some(new Date("2026-10-14T06:00:00Z")), end: some(new Date("2026-10-14T12:00:00Z")), press: some("a2"), state: variant("in-progress", null), sheets: 60000.0, customer: "Harbour Arts Society", stock: variant("coated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-3004", { title: "Club newsletter", start: some(new Date("2026-10-08T06:00:00Z")), end: some(new Date("2026-10-08T08:00:00Z")), press: some("a3"), state: variant("actual", null), sheets: 16000.0, customer: "Kestrel Cycling Club", stock: variant("uncoated", null), due: some(new Date("2026-10-09T00:00:00Z")) }],
+ *     ["J-3005", { title: "Store flyers", start: some(new Date("2026-10-15T06:00:00Z")), end: some(new Date("2026-10-15T16:00:00Z")), press: some("b1"), state: variant("confirmed", null), sheets: 150000.0, customer: "Northwind Outfitters", stock: variant("uncoated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-3006", { title: "Market posters", start: some(new Date("2026-10-20T06:00:00Z")), end: some(new Date("2026-10-20T12:00:00Z")), press: some("b2"), state: variant("confirmed", null), sheets: 72000.0, customer: "Orchard Street Market", stock: variant("coated", null), due: some(new Date("2026-10-22T00:00:00Z")) }],
+ *     ["J-3007", { title: "Loyalty cards", start: some(new Date("2026-10-20T10:00:00Z")), end: some(new Date("2026-10-20T13:00:00Z")), press: some("b2"), state: variant("proposed", variant("added", null)), sheets: 36000.0, customer: "Copperleaf Cafe", stock: variant("board", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-3008", { title: "Gift boxes", start: some(new Date("2026-10-27T06:00:00Z")), end: some(new Date("2026-10-27T12:00:00Z")), press: some("b3"), state: variant("proposed", variant("recommended", null)), sheets: 48000.0, customer: "Juniper Toys", stock: variant("board", null), due: some(new Date("2026-10-30T00:00:00Z")) }],
+ *     ["J-3009", { title: "Ticket books", start: some(new Date("2026-10-22T06:00:00Z")), end: some(new Date("2026-10-22T09:00:00Z")), press: none, state: variant("proposed", variant("added", null)), sheets: 24000.0, customer: "Heathfield Theatre", stock: variant("uncoated", null), due: some(new Date("2026-10-26T00:00:00Z")) }],
+ *     ["J-3010", { title: "Guide reprint", start: none, end: none, press: none, state: variant("estimated", null), sheets: 24000.0, customer: "Driftwood Museum", stock: variant("coated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-3011", { title: "Wall calendars", start: none, end: none, press: none, state: variant("estimated", null), sheets: 50000.0, customer: "Foxglove Gardens", stock: variant("coated", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-3012", { title: "Spare covers", start: none, end: none, press: none, state: variant("estimated", null), sheets: 8000.0, customer: "Meridian Monthly", stock: variant("board", null), due: none }],
+ * ]));
+ * export const planEventJobsPatch = e3.mutation.patch(planEventJobs);
+ *
+ * const planEvents = East.function([], UIComponentType, (_$) => (
+ *     <Reactive>{$ => {
+ *         const presses = $.let(Record.bind(planPrintPresses, []));
+ *         const jobs = $.let(Record.bind(planEventJobs, [planEventJobsPatch]));
+ *         const customers = $.let(Record.bind(planPrintCustomers, []));
+ *         const axis = $.let(Plan.axis({
+ *             window: { min: new Date("2026-10-05T00:00:00Z"), max: new Date("2026-11-02T00:00:00Z") },
+ *             resolution: "day", now: new Date("2026-10-14T09:00:00Z"),
+ *         }));
+ *         return (
+ *             <Plan
+ *                 id="jobs"
+ *                 axis={axis}
+ *                 resources={{
+ *                     presses: Schedule.resources(presses.read(), { name: "Presses", icon: "print", label: p => p.name }),
+ *                 }}
+ *                 events={{
+ *                     job: Schedule.events(jobs, {
+ *                         name: "Print job", icon: "file-lines",
+ *                         title: "title", start: "start", end: "end",
+ *                         resource: { field: "press", of: "presses" },
+ *                         state: "state",
+ *                         // A job with no start waits in the backlog: placed, it runs as long as its sheets take at
+ *                         // 8,000 an hour.
+ *                         backlog: { duration: j => variant("hours", j.sheets.divide(8000.0)), due: j => j.due },
+ *                         fields: {
+ *                             customer: Schedule.field.text({ label: "Customer" }),
+ *                             stock: Schedule.field.select({ labels: { coated: "Coated", uncoated: "Uncoated", board: "Board" } }),
+ *                         },
+ *                     }),
+ *                 }}
+ *                 library={[
+ *                     Plan.library.backlog(),
+ *                     // The customers, by district: a card dropped on a job sets its customer.
+ *                     Plan.library.tab(customers.read(), {
+ *                         name: "Customers", icon: "building",
+ *                         label: c => c.name, meta: c => some(c.trade), group: c => c.district,
+ *                         drop: c => Schedule.patch(PrintJob, { customer: c.name }),
+ *                     }),
+ *                 ]}
+ *                 inspector
+ *             />
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ */
+export declare function libraryTab<K extends EastType, R extends EastType, P extends EastType = EastType>(rows: SubtypeExprOrValue<DictType<K, R>>, config: PlanLibraryTabConfig<K, R, P>): PlanLibraryTab;
+/** A resource kind, its types erased. */
+type AnyResourceKind = ScheduleResourceKind<EastType, EastType>;
+/** An event kind, its types erased. */
+type AnyEventKind = ScheduleEventKind<EastType, EastType>;
+/**
+ * What a Plan's library is built against.
+ *
+ * @internal
+ */
+export interface PlanLibraryContext {
+    /** The resource kinds, by slot, in order. */
+    readonly resources: readonly (readonly [string, AnyResourceKind])[];
+    /** The event kinds, by slot, in order. */
+    readonly events: readonly (readonly [string, AnyEventKind])[];
+    /** The Plan's `rows`, when given. */
+    readonly rows: readonly unknown[] | undefined;
+    /** Whether `data`'s series are picked (`pick`), so the Series tab lists them too. */
+    readonly picked: boolean;
+}
+/**
+ * Builds the library pane on the wire (PB26, PB61, PB62): its tabs in the
+ * order `library` lists them; none when it is left out.
+ *
+ * @param tabs - The tabs, each a `Plan.library.*` call
+ * @param ctx - What the library is built against
+ * @returns The tabs on the wire
+ * @throws {Error} Naming the tab: a tab listed twice (an author's tab by its name); the Events or Backlog tab on a Plan
+ *   with no event kinds; the Series tab on a Plan with nothing a viewer can hide; and each of an author's tab's refusals
+ * @internal
+ */
+export declare function buildLibrary(tabs: readonly PlanLibraryTab[] | undefined, ctx: PlanLibraryContext): ExprType<ArrayType<PlanLibraryTabType>>;
+//# sourceMappingURL=library.d.ts.map