@bettercms-ai/kit 0.1.0 → 1.0.0

package/controls/rich-text/codec.d.ts

@@ -0,0 +1,56 @@
+/**
+ * RICH TEXT · the storage contract between the kit editor and its host.
+ *
+ * The V2 editor edits HTML (contentEditable). Production stores Portable Text, in the shape the classic editor of the
+ * same surface writes (a block array for an entry field, the `{ content, html }` envelope for a component prop). The
+ * conversion lives in the host, which owns the real converters, schema conformance and the field's Accept config; the
+ * kit never imports them. A host with no codec gets its own control for rich text (LegacyFallback), never a guess.
+ *
+ * The control opens a value only when it survives the trip editor → codec unchanged (`same`), so nothing the HTML
+ * editor cannot hold (a checklist's ticks, a link's rel, an image's layout) is dropped by a first keystroke: such a
+ * value is edited by the host's own control instead, with the reason named.
+ */
+import type { FieldPath, FieldSchema } from "../../schema/types";
+/** 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 declare const ALL_FEATURES: readonly RichTextFeature[];
+export interface RichTextRead {
+    /** the HTML the editor opens on */
+    html: string;
+    /** the stored value as the classic editor would open it (compared against the editor's round trip) */
+    seed: unknown;
+    /** what this value already cannot carry from an earlier editor, in words ("2 links"); shown before the first edit */
+    losses: string[];
+    /** what the field accepts */
+    features: RichTextFeature[];
+    /** one paragraph, stored inline (allowMultipleParagraphs: false) */
+    single: boolean;
+    /** links may open in a new tab */
+    newTab: boolean;
+}
+export interface RichTextWrite {
+    /** the value to store, in the surface's own shape */
+    value: unknown;
+    /** what the stored shape would drop from this HTML, in words; non-empty = the write is refused */
+    losses: string[];
+}
+export interface RichTextAt {
+    field: FieldSchema;
+    path: FieldPath;
+}
+export interface KitRichTextCodec {
+    read(value: unknown, at: RichTextAt): RichTextRead;
+    /** `prev` is the stored value being replaced (its keys are reused so an edit does not re-key the document) */
+    write(html: string, at: RichTextAt, prev: unknown): RichTextWrite;
+    /** the same document, ignoring keys, span splits and storage wrapper */
+    same(a: unknown, b: unknown): boolean;
+}
+declare module "../../context" {
+    interface KitServices {
+        /**
+         * Stored rich text ↔ the HTML the kit editor edits (see controls/rich-text/codec.ts). Absent → a rich text field
+         * draws the host's own control for it (LegacyControl).
+         */
+        richText?: KitRichTextCodec;
+    }
+}

package/controls/rich-text/codec.js

@@ -0,0 +1,32 @@
+//#region src/kit/controls/rich-text/codec.ts
+var ALL_FEATURES = [
+	"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"
+];
+//#endregion
+export { ALL_FEATURES };
+
+//# sourceMappingURL=codec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","names":[],"sources":["../../../src/kit/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\";\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\" | \"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\", \"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\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}\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":";AAuBA,IAAa,eAA2C;CACtD;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAc;CAAM;CAAM;CAAO;CAAM;CAAQ;CAAU;CAAa;CAAU;CAAQ;CAAQ;CACpI;CAAS;CAAa;CAAa;CAAW;CAAU;CAAS;CAClE"}

package/controls/rich-text/component-card.d.ts

@@ -0,0 +1,14 @@
+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;
+export declare function ComponentCard({ m, el, ctx, use, overrides, set, }: {
+    m: ComponentModel;
+    el: IslandEl;
+    ctx: IslandCtx;
+    use: UseComponentInfo;
+    overrides: Record<string, unknown>;
+    set: SetComponent;
+}): import("react/jsx-runtime").JSX.Element;
+export {};