@bettercms-ai/kit 1.0.0 → 2.0.0-next.1

package/{controls → dist/controls}/rich-text/dom.d.ts

@@ -28,6 +28,9 @@
  *               <div data-body><p>…` (the message is plain text: paragraphs and line breaks)
  *   toggle      `bcmsBlock` builtin:toggle {title, body}: `<details data-rt="toggle"><summary>…<div data-body><p>…`
  *   video       the `video` block {src, title}: `<div data-rt="video" data-url data-title>`
+ *   embed       V2's article Embed {url, title, aspect}: `<figure data-rt="embed" data-url data-title data-aspect><a href>…`
+ *               (embed.tsx). Stored today as `bcmsBlock` builtin:video {url, title}, which keeps no aspect; the PT
+ *               `embed` block (plan RT3) does.
  *   file        the `file` block {src, name, size}: `<div data-rt="file" data-url data-name data-size>`
  *   component   `bcmsBlock` "component" {componentId, overrides, variant} (CPO D28): `<div data-rt="component" data-ref
  *               data-id data-name data-overrides data-variant>` — a linked instance of a project component, shown as a card.
@@ -35,10 +38,10 @@
  *               `data-detached="true" data-props data-blocks data-source-published-at`, and carries no overrides.
  * A key the stored block holds is an attribute or element that is present; a key it lacks is absent, so an untouched
  * block reads back exactly as stored.
- * V2's gallery, embed, columns, footnotes, contents, related posts and author bio have no stored form in
- * production and are not offered.
+ * V2's gallery, columns, footnotes, contents, related posts and author bio have no stored form in production and are
+ * not offered.
  */
-import { type TableValue } from "../../schema/table";
+import { type TableColumn, type TableColumnType, type TableValue } from "../../schema/table";
 export declare const esc: (s: string) => string;
 export declare const escAttr: (s: string) => string;
 export declare const rid: (p?: string) => string;
@@ -92,6 +95,22 @@ export interface VideoModel {
     title?: string;
     extra?: string;
 }
+/** V2 EmbedModel (article.ts); `aspect` absent draws 16:9 (embed.tsx). */
+export interface EmbedModel {
+    url?: string;
+    title?: string;
+    aspect?: "16:9" | "4:3" | "1:1" | "9:16";
+    extra?: string;
+}
+export type EmbedProvider = "youtube" | "vimeo" | "x" | "codepen" | "figma" | "maps" | "spotify" | "podcast" | "audio" | "link";
+export interface EmbedInfo {
+    provider: EmbedProvider;
+    label: string;
+    /** frame = a sized player · post = a social post card · audio = a slim player · link = a link card */
+    shape: "frame" | "post" | "audio" | "link";
+    host: string;
+}
+export declare function detectEmbed(url: string): EmbedInfo;
 export interface FileModel {
     url?: string;
     name?: string;
@@ -128,6 +147,7 @@ export interface IslandModels {
     callout: CalloutModel;
     toggle: ToggleModel;
     video: VideoModel;
+    embed: EmbedModel;
     file: FileModel;
     component: ComponentModel;
 }
@@ -147,6 +167,32 @@ export declare const textToParas: (s: string) => string;
 /** The inverse of textToParas: each paragraph's text, its line breaks kept. */
 export declare function parasToText(el: Element): string;
 export declare function renderStatic(kind: IslandKind, model: unknown): string;
+/** The column types a rich-text table stores: V2's island offers these (table-editor.tsx:80-86 TYPE_UI, the non-dev ones). */
+export declare const STORED_COLUMN_TYPES: readonly TableColumnType[];
+/** A column's type and settings as stored (V2 TableColumn's keys). */
+export type ColumnSettings = Partial<Pick<TableColumn, "type" | "description" | "unit" | "currency" | "decimals" | "align" | "trueLabel" | "falseLabel" | "max">>;
+/** The settings a kit column stores: none for a plain text or link column, else its type and every setting it has. */
+export declare function columnSettings(c: TableColumn): ColumnSettings | undefined;
+/** A `<col>`'s attributes, V2 renderTableHtml's order (schema/table.ts:511-526): the column's settings, data-sortable among them. */
+export declare function colAttrs(c: ColumnSettings | undefined, sortable: boolean): string;
+/** A `<col data-type …>` read back, as V2 parseTableElement reads it; undefined without a data-type. */
+export declare function colSettingsOf(col: Element): ColumnSettings | undefined;
+export declare const isValueType: (t: TableColumnType) => boolean;
+/** V2 cellText for a typed cell: the words it says (what a stored typed cell's blocks hold). */
+export declare const typedWords: (c: ColumnSettings | undefined, type: TableColumnType, value: unknown) => string;
+/**
+ * What one cell of a typed table draws, as production's renderer writes it (the package's typedCellView, V2 cellHtml
+ * schema/table.ts:369-437 and the column header at :564): `lead` attributes before data-label / data-highlight, `tail` after,
+ * and the markup when the cell is empty or of a value type (undefined: the cell draws its own text or link).
+ */
+export declare function typedCellView(column: ColumnSettings | undefined, rowType: TableColumnType | undefined, cellType: TableColumnType | undefined, value: unknown, header: boolean, inHead: boolean): {
+    lead: string;
+    tail: string;
+    inner?: string;
+};
+/** A typed cell read back (V2 readCell): data-empty is no value; data-value a number or true / false for a value type. */
+export declare function typedValueOf(cell: Element, type: TableColumnType): number | boolean | "" | undefined;
+export declare const typeAttrOf: (el: Element) => TableColumnType | undefined;
 /**
  * Production's table markup → the table value, cell for cell (renderStoredTable's inverse): the plain `<table>`, or
  * the `<figure data-rt="table">` around one with its note. The V2 reader (parseTableElement) is not used here: it reads
@@ -158,7 +204,10 @@ export declare function parseStoredTable(src: Element): TableModel;
  * row in <thead>, header cells of the first column as <th>, every cell its text (a link cell its link). A caption, a
  * note or a group adds what that renderer writes for it, in the order the rows are held (an unedited stored table
  * comes back as it was; the editor's row list writes V2's order, loose rows first). An empty group has no row to label
- * and is not written, as production's renderer writes none.
+ * and is not written, as production's renderer writes none. The totals rows are a <tfoot> after every <tbody>; a
+ * highlighted row is `<tr data-highlight="true">` and a highlighted column `data-highlight="true"` on each of its cells
+ * (production 0.10, the V2 table's markup). A sortable column is its `<col data-sortable="true">` (one `<col>` per column,
+ * inside each column group's `<colgroup>`), and "Visitors can search rows" the figure's `data-filter="true"`.
  */
 export declare function renderStoredTable(input: TableModel): string;
 export declare function detectKind(el: Element): IslandKind | null;
@@ -182,9 +231,4 @@ export declare function editingHost(n: Node | null): HTMLElement | null;
 /** A range's box. Browsers measure a collapsed caret as an empty rect, and some engines cannot measure ranges at all: then
  *  the box of the element the range sits in. */
 export declare function rangeRect(r: Range, fallback: Element | null): DOMRect;
-export declare function countWords(html: string): number;
-/** Linked component instances in the body. */
-export declare const countComponents: (html: string) => number;
-/** "1,840 words · 3 components" */
-export declare const bodyCountLabel: (html: string) => string;
 export declare const isEmptyHtml: (html: string) => boolean;