@bettercms-ai/kit 0.1.1 → 1.0.0

package/engine/expand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.js","names":[],"sources":["../../src/kit/engine/expand.tsx"],"sourcesContent":["/**\n * Expanded editing (CPO D49), owned by the engine: rich text, code and tables open in the ONE shared\n * ExpandedEditorModal (ui/expanded-editor-modal.tsx). V2 did this per control (RichTextControl + RichTextExpandAction,\n * TableControl + TableFullScreenAction); the engine opens the modal around WHATEVER control the field has: the kit\n * control from CONTROLS, or the host's when a control hands a stored value off (LegacyFallback). The modal body is that same control on the same value and the same onChange, so the field underneath\n * and the expanded one stay in sync and every write keeps the exact stored shape the inline control writes.\n *\n * Ways in (V2): the ⤢ button in the field's label row (shown on hover, always on touch), and ⌘↵ / Ctrl+↵ while the\n * field's control has focus. Inside the modal ⌘↵ or Esc closes it (menus and popovers inside close first) and focus\n * returns to whatever opened it. A control lane may open or close it from its own toolbar with `openExpanded`.\n *\n * Offered only where expanding edits something: never read-only, never a type whose control behind it cannot edit\n * (code and tables expand only once a kit control is registered for them; the host draws those read-only today).\n */\nimport * as React from \"react\";\nimport type { ComponentType } from \"react\";\nimport { IconArrowsMaximize } from \"@tabler/icons-react\";\nimport { cn } from \"../lib/cn\";\nimport { resolveFrames } from \"../lib/frames\";\nimport { isObj, pathKey } from \"../lib/path\";\nimport type { FieldPath, FieldSchema, SchemaType } from \"../schema/types\";\nimport type { ControlProps } from \"../types\";\nimport { useForm, useKitEnv } from \"../context\";\nimport { Tooltip } from \"../ui/overlay\";\nimport { ExpandedEditorModal } from \"../ui/expanded-editor-modal\";\n\nexport interface ExpandSpec {\n  /** \"reading\" centres a ~720px writing column; \"wide\" uses the whole dialog (tables, code) */\n  layout: \"reading\" | \"wide\";\n  /** the header's quiet meta line for this value (\"312 words\", \"6 rows · 4 columns\") */\n  meta: (value: unknown) => string;\n  /** the label-row button's name and tooltip */\n  label: \"Expand editor\" | \"Edit in full screen\";\n  /** V2: the document variant already draws the full editor in its column, so writing types offer no ⤢ there */\n  panelOnly?: boolean;\n  /** expanding needs a kit control: the host's control for this type cannot edit it (read-only card) */\n  needsKitControl?: boolean;\n}\n\n/** Words in a value: a string (tags stripped), Portable Text blocks, or a rich-text envelope ({ html } / { value }). */\nexport function wordsIn(value: unknown): number {\n  const text = textOf(value).trim();\n  return text ? text.split(/\\s+/).length : 0;\n}\nfunction textOf(v: unknown): string {\n  if (typeof v === \"string\") return v.replace(/<[^>]*>/g, \" \").replace(/&nbsp;/g, \" \");\n  if (Array.isArray(v)) return v.map(textOf).join(\" \");\n  if (!isObj(v)) return \"\";\n  if (typeof v.text === \"string\") return v.text;\n  if (Array.isArray(v.children)) return textOf(v.children);\n  if (typeof v.html === \"string\") return textOf(v.html);\n  if (\"value\" in v) return textOf(v.value);\n  return \"\";\n}\nconst count = (n: number, one: string, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;\nconst words = (v: unknown) => count(wordsIn(v), \"word\");\nfunction codeLines(v: unknown) {\n  const src = typeof v === \"string\" ? v : isObj(v) && typeof v.code === \"string\" ? v.code : \"\";\n  return count(src ? src.split(\"\\n\").length : 0, \"line\");\n}\nfunction tableSize(v: unknown) {\n  const rows = isObj(v) && Array.isArray(v.rows) ? v.rows.length : 0;\n  const cols = isObj(v) && Array.isArray(v.columns) ? v.columns.length : 0;\n  return `${count(rows, \"row\")} · ${count(cols, \"column\")}`;\n}\n\n/** Type → how it expands. Additive like CONTROLS: one entry per type. Plain long text (`text`) has none: V2's\n *  TextControl is a bare textarea that grows to its value, so an extra ⤢ would only add a tab stop V2 lacks. */\nexport const EXPANDABLE: Partial<Record<SchemaType, ExpandSpec>> = {\n  richtext: { layout: \"reading\", meta: words, label: \"Expand editor\", panelOnly: true },\n  code: { layout: \"wide\", meta: codeLines, label: \"Expand editor\", needsKitControl: true },\n  table: { layout: \"wide\", meta: tableSize, label: \"Edit in full screen\", needsKitControl: true },\n};\n\n/** The spec when this field can expand here, else null. */\nexport function expandSpecFor(field: FieldSchema, opts: { readOnly: boolean; hasKitControl: boolean; variant: string }): ExpandSpec | null {\n  const spec = EXPANDABLE[field.type];\n  if (!spec || opts.readOnly) return null;\n  if (spec.needsKitControl && !opts.hasKitControl) return null;\n  if (spec.panelOnly && opts.variant === \"document\") return null;\n  return spec;\n}\n\n/* ── which field (docId:pathKey) has its expanded editor open: one at a time, shared with toolbar buttons ── */\nlet openKey: string | null = null;\nconst subs = new Set<() => void>();\nexport function openExpanded(key: string | null) {\n  if (openKey === key) return;\n  openKey = key;\n  subs.forEach((s) => s());\n}\nexport const expandKey = (docId: string, path: FieldPath) => `${docId}:${pathKey(path)}`;\nexport function useExpandedKey() {\n  return React.useSyncExternalStore(\n    (cb) => {\n      subs.add(cb);\n      return () => subs.delete(cb);\n    },\n    () => openKey,\n    () => openKey,\n  );\n}\n\n/** ⌘↵ / Ctrl+↵ (no Shift or Alt): the expand shortcut. */\nexport const isExpandShortcut = (e: React.KeyboardEvent | KeyboardEvent) => e.key === \"Enter\" && (e.metaKey || e.ctrlKey) && !e.shiftKey && !e.altKey;\n\n/** The label-row ⤢ (V2 RichTextExpandAction / TableFullScreenButton): hidden at rest until hover, always on touch. */\nexport function ExpandAction({ field, path, spec }: { field: FieldSchema; path: FieldPath; spec: ExpandSpec }) {\n  const env = useKitEnv();\n  const wide = spec.label === \"Edit in full screen\";\n  return (\n    <Tooltip content={spec.label} shortcut=\"⌘↵\">\n      <button\n        type=\"button\"\n        aria-label={wide ? `Edit ${field.title} in full screen` : `Expand ${field.title}`}\n        aria-haspopup=\"dialog\"\n        data-kit-expand=\"\"\n        onClick={() => openExpanded(expandKey(env.docId, path))}\n        className={cn(\n          \"-my-0.5 inline-flex size-6 shrink-0 items-center justify-center rounded-kit-md text-kit-fg-3 outline-none hover:bg-kit-hover hover:text-kit-fg\",\n          \"focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-kit-focus-ring focus-visible:[outline-style:solid]\",\n          // V2: quiet at rest (hover / touch shows it). Keyboard focus keeps it visible, so Tab never lands on nothing.\n          \"opacity-0 group-hover/field:opacity-100 focus-visible:opacity-100 [@media(pointer:coarse)]:opacity-100\",\n        )}\n      >\n        <IconArrowsMaximize aria-hidden className=\"size-3.5\" stroke={1.5} />\n      </button>\n    </Tooltip>\n  );\n}\n\n/** The modal's breadcrumb: the document, the frames down to this field's parent, then the field. */\nfunction useCrumbs(field: FieldSchema, path: FieldPath): string[] {\n  const form = useForm();\n  const env = useKitEnv();\n  if (!form) return [env.docTitle, field.title].filter(Boolean) as string[];\n  const { frames } = resolveFrames(form.schema, form.value, path.slice(0, -1), form.resolveSchema);\n  const titles = frames.filter((f) => f.kind !== \"history\").map((f, i) => (i === 0 ? env.docTitle || f.title : f.title));\n  return [...titles, field.title].filter(Boolean);\n}\n\n/**\n * The field's expanded editor: the same control, value and onChange in the modal. Mounted only while open, so the\n * inline control and this one never fight over the same DOM id (the modal one gets `${id}-expanded`).\n */\nexport function ExpandedField({\n  field,\n  path,\n  spec,\n  Control,\n  value,\n  onChange,\n  onBlur,\n  invalid,\n  id,\n  parent,\n}: {\n  field: FieldSchema;\n  path: FieldPath;\n  spec: ExpandSpec;\n  Control: ComponentType<ControlProps>;\n  value: unknown;\n  onChange: (v: unknown) => void;\n  onBlur?: () => void;\n  invalid?: boolean;\n  id: string;\n  parent?: Record<string, unknown>;\n}) {\n  const env = useKitEnv();\n  const key = expandKey(env.docId, path);\n  const open = useExpandedKey() === key;\n  const crumbs = useCrumbs(field, path);\n  // close when this field goes away (block deselected, drilled elsewhere, schema changed)\n  React.useEffect(\n    () => () => {\n      if (openKey === key) openExpanded(null);\n    },\n    [key],\n  );\n  return (\n    <ExpandedEditorModal\n      open={open}\n      onOpenChange={(o) => openExpanded(o ? key : null)}\n      crumbs={crumbs}\n      meta={spec.meta(value)}\n      layout={spec.layout}\n      returnFocus={() =>\n        document.querySelector<HTMLElement>(`[data-field-key=\"${CSS.escape(pathKey(path))}\"] [data-kit-expand]`) ??\n        document.getElementById(id)\n      }\n    >\n      {open ? (\n        <div\n          data-kit-expanded={field.type}\n          className={cn(\"min-w-0\", spec.layout === \"wide\" && \"flex min-h-0 flex-1 flex-col\")}\n          onBlur={onBlur}\n          onKeyDown={(e) => {\n            if (!isExpandShortcut(e)) return;\n            e.preventDefault();\n            openExpanded(null);\n          }}\n        >\n          <Control field={field} value={value} onChange={onChange} id={`${id}-expanded`} invalid={invalid} path={path} parent={parent} onBlur={onBlur} />\n        </div>\n      ) : null}\n    </ExpandedEditorModal>\n  );\n}\n"],"mappings":"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"}

package/engine/field-list.d.ts

@@ -0,0 +1,20 @@
+/**
+ * FieldList — lays out one frame's fields (CPO D45 grouping; V2 HEAD 9829bf1 kit/engine/field-list.tsx): group TABS
+ * (with error dots) at the top of the frame only, FIELDSETS as <FieldSection>, breakpoint objects as ONE
+ * <BreakpointGroup>, an auto "Advanced" section, and `hidden` conditions that appear / disappear with a height animation.
+ *
+ * The layout itself lives in grouping.tsx (`FieldList` there takes `renderField`, so grouping never imports KitField).
+ * This module is V2's FieldList as the rest of the engine uses it: the same props, each field drawn by KitField — which
+ * is where an object too big to inset becomes its drill row (NavRow), an array its rows, a slot its blocks.
+ * Frames (frame.tsx `FrameSlots.FieldList`), expanded array rows and popovers render this.
+ */
+import type { FieldGroup, FieldPath, FieldSchema, Fieldset } from "../schema/types";
+export interface FieldListProps {
+    fields: FieldSchema[];
+    fieldsets?: Fieldset[];
+    groups?: FieldGroup[];
+    basePath: FieldPath;
+    /** where to remember the selected tab / open fieldsets */
+    memoryKey: string;
+}
+export declare function FieldList(props: FieldListProps): import("react/jsx-runtime").JSX.Element;

package/engine/field-list.js

@@ -0,0 +1,19 @@
+import { FieldList as FieldList$1 } from "./grouping.js";
+import { KitField } from "./kit-field.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/kit/engine/field-list.tsx
+var renderKitField = (field, path, parent) => /* @__PURE__ */ jsx(KitField, {
+	field,
+	path,
+	parent
+});
+function FieldList(props) {
+	return /* @__PURE__ */ jsx(FieldList$1, {
+		...props,
+		renderField: renderKitField
+	});
+}
+//#endregion
+export { FieldList };
+
+//# sourceMappingURL=field-list.js.map

package/engine/field-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-list.js","names":[],"sources":["../../src/kit/engine/field-list.tsx"],"sourcesContent":["/**\n * FieldList — lays out one frame's fields (CPO D45 grouping; V2 HEAD 9829bf1 kit/engine/field-list.tsx): group TABS\n * (with error dots) at the top of the frame only, FIELDSETS as <FieldSection>, breakpoint objects as ONE\n * <BreakpointGroup>, an auto \"Advanced\" section, and `hidden` conditions that appear / disappear with a height animation.\n *\n * The layout itself lives in grouping.tsx (`FieldList` there takes `renderField`, so grouping never imports KitField).\n * This module is V2's FieldList as the rest of the engine uses it: the same props, each field drawn by KitField — which\n * is where an object too big to inset becomes its drill row (NavRow), an array its rows, a slot its blocks.\n * Frames (frame.tsx `FrameSlots.FieldList`), expanded array rows and popovers render this.\n */\nimport type { FieldGroup, FieldPath, FieldSchema, Fieldset } from \"../schema/types\";\nimport { FieldList as GroupedFieldList, type RenderField } from \"./grouping\";\nimport { KitField } from \"./kit-field\";\n\nexport interface FieldListProps {\n  fields: FieldSchema[];\n  fieldsets?: Fieldset[];\n  groups?: FieldGroup[];\n  basePath: FieldPath;\n  /** where to remember the selected tab / open fieldsets */\n  memoryKey: string;\n}\n\nconst renderKitField: RenderField = (field, path, parent) => <KitField field={field} path={path} parent={parent} />;\n\nexport function FieldList(props: FieldListProps) {\n  return <GroupedFieldList {...props} renderField={renderKitField} />;\n}\n"],"mappings":";;;;AAuBA,IAAM,kBAA+B,OAAO,MAAM,WAAW,oBAAC,UAAD;CAAiB;CAAa;CAAc;CAAU,CAAA;AAEnH,SAAgB,UAAU,OAAuB;AAC/C,QAAO,oBAAC,aAAD;EAAkB,GAAI;EAAO,aAAa;EAAkB,CAAA"}

package/engine/field-shell.d.ts

@@ -0,0 +1,49 @@
+/**
+ * FIELD SHELL — the one field chrome (V2 HEAD 9829bf1 kit/engine/field-shell.tsx; production FieldShell + CPO D8).
+ *
+ *   [Label *] [ⓘ] [override dot] [changed dot] [synced] [EN]  ……  [42 / 60] [action] [Reset] [undo] [comments] [presence] [⋯]
+ *   help text (CPO D39: 12/16 --fg-3, 4px under the label, 1–2 lines; hidden while an error shows)
+ *   ┌ control ───────────────────────────────┐   ← peer editing: the control's border in their colour
+ *   └────────────────────────────────────────┘
+ *   error / warning message ……………………… meta (42 / 60)
+ *
+ * Accessories (add-comment, ⋯) take NO space at rest; they appear on hover/focus (always on touch). A comment
+ * COUNT chip is always visible. AI lives in ⋯ ("Rewrite with AI"), never as a label sparkle (CPO-142).
+ *
+ * Services (toast, AI rewrite, in-place comments) come from KitServices; a missing service hides its surface.
+ */
+import * as React from "react";
+import { type FieldPath, type FieldSchema } from "../schema/types";
+import { type KitPeer } from "../context";
+import { type KitIssue } from "../lib/validate";
+/** Test seam: forget the shared field clipboard. */
+export declare const resetFieldClipboard: () => void;
+export declare const apiName: (schemaName: string, path: FieldPath) => string;
+/** A long label truncates on one line; past this many characters a native `title` carries the full label (DESIGN 4.4). */
+export declare const LABEL_HINT_AT = 28;
+export interface FieldShellProps {
+    field: FieldSchema;
+    path: FieldPath;
+    id: string;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    readOnly?: boolean;
+    issue?: KitIssue;
+    /** label-row action (e.g. slug "Generate") */
+    action?: React.ReactNode;
+    /** "card" = the boolean switch card · "row" = the control IS a labelled row (a drill-in object, CPO D45): no label row,
+     *  the chrome goes into the row through `RowChrome` */
+    layout?: "stack" | "card" | "row";
+    /** layout fields get no comment control */
+    noComments?: boolean;
+    /** right side of the message line (counters, "3 items · max 6") */
+    meta?: React.ReactNode;
+    className?: string;
+    children: React.ReactNode;
+}
+export declare function FieldShell({ field, path, id, value, onChange, readOnly, issue, action, layout, noComments, meta, className, children }: FieldShellProps): import("react/jsx-runtime").JSX.Element;
+/** Who is in this field: 16px faces in the label row's action slot (no overlap with the label or the input), name on hover. */
+export declare function PeerStack({ peers, size }: {
+    peers: KitPeer[];
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;