@bettercms-ai/kit 1.0.0 → 2.0.0

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

@@ -11,8 +11,9 @@
  * value is edited by the host's own control instead, with the reason named.
  */
 import type { FieldPath, FieldSchema } from "../../schema/types";
+import type { UnknownValue } from "../unknown-value";
 /** What a field may hold, in the editor's vocabulary. The editor offers nothing outside it. */
-export type RichTextFeature = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "blockquote" | "ul" | "ol" | "pre" | "hr" | "bold" | "italic" | "underline" | "strike" | "code" | "link" | "image" | "table" | "pullquote" | "takeaways" | "callout" | "toggle" | "video" | "file";
+export type RichTextFeature = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "blockquote" | "ul" | "ol" | "pre" | "hr" | "bold" | "italic" | "underline" | "strike" | "sup" | "sub" | "code" | "link" | "image" | "table" | "pullquote" | "takeaways" | "callout" | "toggle" | "video" | "file";
 export declare const ALL_FEATURES: readonly RichTextFeature[];
 export interface RichTextRead {
     /** the HTML the editor opens on */
@@ -27,6 +28,11 @@ export interface RichTextRead {
     single: boolean;
     /** links may open in a new tab */
     newTab: boolean;
+    /**
+     * the styles, marks and lists the value holds that the field no longer declares: kept by every write, flagged above
+     * the editor with change-to and remove (H4; see `remap`). Absent or empty = none.
+     */
+    undeclared?: UnknownValue[];
 }
 export interface RichTextWrite {
     /** the value to store, in the surface's own shape */
@@ -44,6 +50,8 @@ export interface KitRichTextCodec {
     write(html: string, at: RichTextAt, prev: unknown): RichTextWrite;
     /** the same document, ignoring keys, span splits and storage wrapper */
     same(a: unknown, b: unknown): boolean;
+    /** the stored value with one `undeclared` value (its `key`) changed to `to`, or removed (`to` null); the words stay */
+    remap?(value: unknown, at: RichTextAt, key: string, to: string | null): unknown;
 }
 declare module "../../context" {
     interface KitServices {

package/{controls → dist/controls}/rich-text/codec.js

@@ -1,4 +1,4 @@
-//#region src/kit/controls/rich-text/codec.ts
+//#region src/controls/rich-text/codec.ts
 var ALL_FEATURES = [
 	"h1",
 	"h2",
@@ -15,6 +15,8 @@ var ALL_FEATURES = [
 	"italic",
 	"underline",
 	"strike",
+	"sup",
+	"sub",
 	"code",
 	"link",
 	"image",

package/dist/controls/rich-text/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","names":[],"sources":["../../../src/controls/rich-text/codec.ts"],"sourcesContent":["/**\n * RICH TEXT · the storage contract between the kit editor and its host.\n *\n * The V2 editor edits HTML (contentEditable). Production stores Portable Text, in the shape the classic editor of the\n * same surface writes (a block array for an entry field, the `{ content, html }` envelope for a component prop). The\n * conversion lives in the host, which owns the real converters, schema conformance and the field's Accept config; the\n * kit never imports them. A host with no codec gets its own control for rich text (LegacyFallback), never a guess.\n *\n * The control opens a value only when it survives the trip editor → codec unchanged (`same`), so nothing the HTML\n * editor cannot hold (a checklist's ticks, a link's rel, an image's layout) is dropped by a first keystroke: such a\n * value is edited by the host's own control instead, with the reason named.\n */\nimport type { FieldPath, FieldSchema } from \"../../schema/types\";\nimport type { UnknownValue } from \"../unknown-value\";\n\n/** What a field may hold, in the editor's vocabulary. The editor offers nothing outside it. */\nexport type RichTextFeature =\n  | \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\"\n  | \"blockquote\" | \"ul\" | \"ol\" | \"pre\" | \"hr\"\n  | \"bold\" | \"italic\" | \"underline\" | \"strike\" | \"sup\" | \"sub\" | \"code\"\n  | \"link\" | \"image\"\n  /* blocks, each stored as its own Portable Text block (see dom.ts) */\n  | \"table\" | \"pullquote\" | \"takeaways\" | \"callout\" | \"toggle\" | \"video\" | \"file\";\n\nexport const ALL_FEATURES: readonly RichTextFeature[] = [\n  \"h1\", \"h2\", \"h3\", \"h4\", \"h5\", \"h6\", \"blockquote\", \"ul\", \"ol\", \"pre\", \"hr\", \"bold\", \"italic\", \"underline\", \"strike\", \"sup\", \"sub\", \"code\", \"link\", \"image\",\n  \"table\", \"pullquote\", \"takeaways\", \"callout\", \"toggle\", \"video\", \"file\",\n];\n\nexport interface RichTextRead {\n  /** the HTML the editor opens on */\n  html: string;\n  /** the stored value as the classic editor would open it (compared against the editor's round trip) */\n  seed: unknown;\n  /** what this value already cannot carry from an earlier editor, in words (\"2 links\"); shown before the first edit */\n  losses: string[];\n  /** what the field accepts */\n  features: RichTextFeature[];\n  /** one paragraph, stored inline (allowMultipleParagraphs: false) */\n  single: boolean;\n  /** links may open in a new tab */\n  newTab: boolean;\n  /**\n   * the styles, marks and lists the value holds that the field no longer declares: kept by every write, flagged above\n   * the editor with change-to and remove (H4; see `remap`). Absent or empty = none.\n   */\n  undeclared?: UnknownValue[];\n}\n\nexport interface RichTextWrite {\n  /** the value to store, in the surface's own shape */\n  value: unknown;\n  /** what the stored shape would drop from this HTML, in words; non-empty = the write is refused */\n  losses: string[];\n}\n\nexport interface RichTextAt {\n  field: FieldSchema;\n  path: FieldPath;\n}\n\nexport interface KitRichTextCodec {\n  read(value: unknown, at: RichTextAt): RichTextRead;\n  /** `prev` is the stored value being replaced (its keys are reused so an edit does not re-key the document) */\n  write(html: string, at: RichTextAt, prev: unknown): RichTextWrite;\n  /** the same document, ignoring keys, span splits and storage wrapper */\n  same(a: unknown, b: unknown): boolean;\n  /** the stored value with one `undeclared` value (its `key`) changed to `to`, or removed (`to` null); the words stay */\n  remap?(value: unknown, at: RichTextAt, key: string, to: string | null): unknown;\n}\n\ndeclare module \"../../context\" {\n  interface KitServices {\n    /**\n     * Stored rich text ↔ the HTML the kit editor edits (see controls/rich-text/codec.ts). Absent → a rich text field\n     * draws the host's own control for it (LegacyControl).\n     */\n    richText?: KitRichTextCodec;\n  }\n}\n"],"mappings":";AAwBA,IAAa,eAA2C;CACtD;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAc;CAAM;CAAM;CAAO;CAAM;CAAQ;CAAU;CAAa;CAAU;CAAO;CAAO;CAAQ;CAAQ;CAClJ;CAAS;CAAa;CAAa;CAAW;CAAU;CAAS;AACnE"}

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

@@ -2,7 +2,7 @@ import { type KitServices } from "../../context";
 import type { ComponentModel, IslandEl } from "./dom";
 import type { IslandCtx } from "./blocks";
 type UseComponentInfo = NonNullable<KitServices["useComponentInfo"]>;
-type SetComponent = (patch: (m: ComponentModel) => ComponentModel, label: string, record?: boolean) => void;
+type SetComponent = (patch: Partial<ComponentModel> | ((m: ComponentModel) => ComponentModel), label: string, record?: boolean) => void;
 export declare function ComponentCard({ m, el, ctx, use, overrides, set, }: {
     m: ComponentModel;
     el: IslandEl;