@estiva-app/ui 0.38.0 → 0.40.0

package/dist/AppShell.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
 /**
- * The frame of an app, in the two manners that pair with the TopBar's
+ * The frame of an app, in the manners that pair with the TopBar's
  * (Katerina, 2026-09-02: the two shells go together — the solid bar with
  * the sidebar, the floating bar with the rail):
  *
@@ -11,6 +11,9 @@ import type { ReactNode } from 'react';
  *   edge, the rail stands on the app background, and the content lives
  *   in the rounded card beside it (2026-09-02, the floating app's frame
  *   geometry; its collapse animation and launcher stay in the app).
+ * - `inset` — the structured frame, the other way round: the TopBar and
+ *   the Sidebar stand on the ground, and the content is a lighter card
+ *   beside them (Katerina, 28 September: Linear's layout, in any theme).
  *
  * The banner belongs to the content area (her ruling, 2026-09-02): it
  * renders at the top of the main column — inside the card, in the
@@ -20,7 +23,7 @@ import type { ReactNode } from 'react';
  * has no data and no routes.
  */
 export interface AppShellProps {
-    variant?: 'solid' | 'floating';
+    variant?: 'solid' | 'floating' | 'inset';
     /** The top bar's menu button, in an app whose navigation collapses. */
     menu?: ReactNode;
     /** The top bar's left: the app's logo mark, or its name as text. */

package/dist/AppShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../src/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC9B,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,qFAAqF;IACrF,GAAG,EAAE,SAAS,CAAA;IACd,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,QAAQ,CAAC,EAAE,OAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,aAAa,+BAgEjH"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../src/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAOtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;IACxC,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,qFAAqF;IACrF,GAAG,EAAE,SAAS,CAAA;IACd,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,QAAQ,CAAC,EAAE,OAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,aAAa,+BA8EjH"}

package/dist/RichText.d.ts

@@ -0,0 +1,78 @@
+import type { ReactNode } from 'react';
+/**
+ * Formatted text, drawn: headings, paragraphs, lists, a quote, code, a divider,
+ * a table and links.
+ *
+ * Both apps drew the same thing twice, from the same source — the text tree the
+ * protocol package builds (`toRenderTree` → `RenderBlock`, `RenderInline`) —
+ * and the two had drifted: headings, list markers, quotes and code differed,
+ * one app had tables and the other dropped them, one had links and the other
+ * printed the brackets (UIG-30). The look here is Katerina's picks of
+ * 28 September, one per difference, most of them Peek's.
+ *
+ * **It takes the tree, not the text.** The caller parses (the format comes from
+ * the item's tag, never from the body) and hands the blocks in. So this package
+ * does not depend on the protocol, and a caller can leave out a block it draws
+ * elsewhere before passing the rest. The types below are the tree's shape; the
+ * protocol's own types fit them.
+ *
+ * **Safe by construction.** The tree has nothing left to parse, and every
+ * string here reaches the page as a React child, so it is text. Nothing is set
+ * as HTML.
+ *
+ * **What a word points at stays the app's.** A person, an item from another
+ * app, a name the app recognises in plain text: `renderReference`,
+ * `renderText` and `renderBlock` are where each app draws its own.
+ */
+/** A run of text and the marks on it — the protocol's `RenderInline`. */
+export interface RichTextRun {
+    text: string;
+    marks: readonly string[];
+    /** A `nostr:` address this run stands for. `text` is the address itself. */
+    reference?: string;
+}
+/** A block of the tree — the protocol's `RenderBlock`. */
+export interface RichTextBlock {
+    type: string;
+    /** What the document called a block the tree does not know. */
+    typeName?: string;
+    /** The block's address, when it has one. Drawn as `data-block-id`. */
+    id?: string;
+    level?: 1 | 2 | 3;
+    language?: string;
+    /** A numbered list's first number. */
+    start?: number;
+    attrs?: Record<string, unknown>;
+    inline?: readonly RichTextRun[];
+    children?: readonly RichTextBlock[];
+}
+export type RichTextSize = 'default' | 'small';
+export interface RichTextProps {
+    /** The tree, already parsed. */
+    blocks: readonly RichTextBlock[];
+    /**
+     * Default `default`, the size of text you read. `small` is the same text one
+     * step down, with every heading, list, quote and table kept: an item shown
+     * inside a card.
+     */
+    size?: RichTextSize;
+    /**
+     * Draws plain text: what is left of a run once its links are drawn. Where an
+     * app turns words it recognises into chips. By default the text as it is.
+     */
+    renderText?: (text: string) => ReactNode;
+    /** Draws a run that stands for an address. By default its text. */
+    renderReference?: (reference: string, run: RichTextRun) => ReactNode;
+    /**
+     * Draws a block this part has no design for (an attachment, a widget). Return
+     * `undefined` to leave it to the part, which draws its words.
+     */
+    renderBlock?: (block: RichTextBlock) => ReactNode | undefined;
+}
+/**
+ * RichText's look, for a box you draw yourself: an editor's, so that what is
+ * being written looks the same as what is read. Put it on the editor's root.
+ */
+export declare function richTextClassName(size?: RichTextSize, className?: string): string;
+export declare function RichText({ blocks, size, renderText, renderReference, renderBlock, }: RichTextProps): import("react").JSX.Element | null;
+//# sourceMappingURL=RichText.d.ts.map

package/dist/RichText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichText.d.ts","sourceRoot":"","sources":["../src/RichText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,OAAO,CAAA;AAIlD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CACpC;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAA;IACxC,mEAAmE;IACnE,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,SAAS,CAAA;IACpE;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,GAAG,SAAS,CAAA;CAC9D;AA0BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,YAAwB,EAAE,SAAS,CAAC,EAAE,MAAM,UAGnF;AAyKD,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,IAAgB,EAChB,UAA2B,EAC3B,eAA+C,EAC/C,WAAW,GACZ,EAAE,aAAa,sCAQf"}

package/dist/Sidebar.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 /**
  * The navigation column: 240px, a hairline on its right, the surface
  * behind it, scrolling independently of the content beside it (the shell
@@ -7,6 +7,10 @@ import type { ReactNode } from 'react';
  * What goes inside is the caller's: NavItem rows, a SectionLabel heading
  * in a 32px row over a group. Desktop only — there is no narrow-screen
  * drawer.
+ *
+ * In AppShell's `inset` frame it stands on the ground instead: no hairline,
+ * no surface, the content's card beside it (Katerina, 28 September). The
+ * frame tells it so; the caller passes nothing.
  */
 export interface SidebarProps {
     /** Names the navigation region for assistive tech. */
@@ -14,5 +18,7 @@ export interface SidebarProps {
     children: ReactNode;
     className?: string;
 }
+/** Set by AppShell's `inset` frame: the sidebar stands on the ground, with no line or surface of its own. */
+export declare const SidebarOnGround: import("react").Context<boolean>;
 export declare function Sidebar({ 'aria-label': ariaLabel, children, className }: SidebarProps): import("react").JSX.Element;
 //# sourceMappingURL=Sidebar.d.ts.map

package/dist/Sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../src/Sidebar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EAAE,YAAY,EAAE,SAAuB,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,YAAY,+BAcnG"}
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../src/Sidebar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIjE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,6GAA6G;AAC7G,eAAO,MAAM,eAAe,kCAAuB,CAAA;AAEnD,wBAAgB,OAAO,CAAC,EAAE,YAAY,EAAE,SAAuB,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,YAAY,+BAenG"}

package/dist/TopBar.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
 /**
- * The 52px top bar, in two manners:
+ * The 52px top bar, in three manners:
  *
  * - `solid` — in flow: a hairline under it, the surface behind it, the
  *   frame's first row (2026-09-02, verbatim from the structured app; its
@@ -9,6 +9,9 @@ import type { ReactNode } from 'react';
  *   background, and the bar itself ignores the pointer — only its clusters
  *   catch clicks, so the content underneath stays reachable (2026-09-02,
  *   verbatim from the floating app).
+ * - `inset` — in flow like `solid`, but standing on the ground: no hairline
+ *   and no surface, above a sidebar on the ground and the content's card
+ *   (Katerina, 28 September).
  *
  * Geometry both apps agreed on before extraction: 52px tall, `pl-5
  * pr-[26px]`, right cluster `gap-[6px]`. The left region is two slots
@@ -18,7 +21,7 @@ import type { ReactNode } from 'react';
  * searched; it only knows where those go.
  */
 export interface TopBarProps {
-    variant?: 'solid' | 'floating';
+    variant?: 'solid' | 'floating' | 'inset';
     /** Far left: the menu button, in an app whose navigation collapses. Stays the caller's — the bar only places it. */
     menu?: ReactNode;
     /** Beside the menu button: the app's logo mark, or its name as text. */

package/dist/TopBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TopBar.d.ts","sourceRoot":"","sources":["../src/TopBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC9B,oHAAoH;IACpH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,wEAAwE;IACxE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,mGAAmG;IACnG,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,MAAM,CAAC,EAAE,OAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,+BAsB9F"}
+{"version":3,"file":"TopBar.d.ts","sourceRoot":"","sources":["../src/TopBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;IACxC,oHAAoH;IACpH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,wEAAwE;IACxE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,mGAAmG;IACnG,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,MAAM,CAAC,EAAE,OAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,+BAsB9F"}

package/dist/eslint/index.js

@@ -242,6 +242,7 @@ var PART_LOOK_PROPS = {
   RailItem: ["active"],
   Reaction: ["pressed"],
   ReactionPicker: ["surface"],
+  RichText: ["size"],
   SectionHeader: ["hover"],
   SectionLabel: ["tone", "truncate"],
   Select: ["size"],