@vertebr/react 0.2.0 → 0.3.0

package/dist/components/config/form/helpers.js

@@ -0,0 +1,186 @@
+import { z } from "zod";
+import { isDescriptionField } from "../../../lib/description";
+import { isImageField, looksLikeUrl } from "../../../lib/images";
+const RECORD_GROUP_ORDER = [
+    "Details",
+    "Content",
+    "Pricing",
+    "Inventory",
+    "Media",
+    "Status",
+];
+export function buildZodSchema(schema) {
+    const shape = {};
+    for (const [key, field] of Object.entries(schema)) {
+        let zodField;
+        switch (field.type) {
+            case "number":
+                zodField = z.number();
+                if (field.min != null)
+                    zodField = zodField.min(field.min);
+                if (field.max != null)
+                    zodField = zodField.max(field.max);
+                break;
+            case "boolean":
+                zodField = z.boolean();
+                break;
+            case "file[]":
+                zodField = z.array(z.string());
+                break;
+            default:
+                zodField = z.string();
+        }
+        if (!field.required) {
+            zodField = zodField.optional();
+        }
+        shape[key] = zodField;
+    }
+    return z.object(shape);
+}
+export function humanizeKey(key) {
+    return key
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/[_-]+/g, " ")
+        .trim();
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function isStockField(key, field) {
+    const hay = `${key} ${field?.label ?? ""}`;
+    return /(stock|inventory|qty|quantity)/i.test(hay);
+}
+export function spanFor(key, field, variant) {
+    if (field.type === "boolean")
+        return "full";
+    if (field.type === "richtext" || isDescriptionField(key, field))
+        return "full";
+    if (variant === "record" && isImageField(key, field))
+        return "full";
+    return undefined;
+}
+function inferConfigGroup(key, field) {
+    if (field.group?.trim())
+        return field.group.trim();
+    const source = field.label?.trim() || humanizeKey(key);
+    const words = source.split(/\s+/).filter(Boolean);
+    if (words.length >= 2)
+        return words[0];
+    return "General";
+}
+function inferRecordGroup(key, field) {
+    if (field.group?.trim())
+        return field.group.trim();
+    const k = key.toLowerCase();
+    const label = (field.label ?? "").toLowerCase();
+    const hay = `${k} ${label}`;
+    if (/(image|img|photo|avatar|thumbnail|thumb|cover|media_url)/i.test(hay)) {
+        return "Media";
+    }
+    if (/(price|cost|cents|amount|msrp)/i.test(hay)) {
+        return "Pricing";
+    }
+    if (/(stock|inventory|qty|quantity)/i.test(hay)) {
+        return "Inventory";
+    }
+    if (field.type === "boolean" ||
+        /(^|_)(active|enabled|published|status|visible)(_|$)/i.test(k) ||
+        /^(active|enabled|published|status|visible)$/i.test(label)) {
+        return "Status";
+    }
+    if (field.type === "richtext" ||
+        /(description|body|content|summary|bio)/i.test(hay)) {
+        return "Content";
+    }
+    return "Details";
+}
+export function displayLabel(key, field, group) {
+    const label = field.label?.trim() || humanizeKey(key);
+    const stripped = label.replace(new RegExp(`^${escapeRegExp(group)}\\s+`, "i"), "");
+    if (/^inventory$/i.test(group)) {
+        const stock = label.replace(/^stock\s+/i, "").trim();
+        if (stock && stock !== label)
+            return stock;
+    }
+    if (/^pricing$/i.test(group) && /cents/i.test(label)) {
+        return label.replace(/\s*\(cents\)/i, "").trim() || label;
+    }
+    return stripped || label;
+}
+function sortGroups(groups, variant) {
+    if (variant !== "record")
+        return groups;
+    const rank = (id) => {
+        const index = RECORD_GROUP_ORDER.indexOf(id);
+        return index === -1 ? RECORD_GROUP_ORDER.length + 1 : index;
+    };
+    return [...groups].sort((a, b) => rank(a.id) - rank(b.id));
+}
+export function groupFields(schema, variant) {
+    const order = [];
+    const map = new Map();
+    const explicit = new Set();
+    for (const entry of Object.entries(schema)) {
+        const [key, field] = entry;
+        const group = variant === "record"
+            ? inferRecordGroup(key, field)
+            : inferConfigGroup(key, field);
+        if (field.group?.trim())
+            explicit.add(group);
+        if (!map.has(group)) {
+            map.set(group, []);
+            order.push(group);
+        }
+        map.get(group).push(entry);
+    }
+    if (variant === "config") {
+        for (const [group, fields] of [...map.entries()]) {
+            if (fields.length > 1 || explicit.has(group) || group === "General") {
+                continue;
+            }
+            if (!map.has("General")) {
+                map.set("General", []);
+                order.unshift("General");
+            }
+            map.get("General").push(...fields);
+            map.delete(group);
+            const idx = order.indexOf(group);
+            if (idx >= 0)
+                order.splice(idx, 1);
+        }
+    }
+    const groups = order
+        .filter((id) => map.has(id))
+        .map((id) => ({
+        id,
+        label: id,
+        fields: map.get(id),
+    }));
+    return sortGroups(groups, variant);
+}
+export function firstImageUrl(value) {
+    const items = Array.isArray(value) ? value : [value];
+    for (const item of items) {
+        if (typeof item === "string" && looksLikeUrl(item))
+            return item;
+        if (item && typeof item === "object" && "url" in item) {
+            const url = item.url;
+            if (typeof url === "string" && looksLikeUrl(url))
+                return url;
+        }
+    }
+    return null;
+}
+export function findPrimaryImageKey(schema, values) {
+    for (const [key, field] of Object.entries(schema)) {
+        if (!isImageField(key, field))
+            continue;
+        if (firstImageUrl(values?.[key]))
+            return key;
+    }
+    for (const [key, field] of Object.entries(schema)) {
+        if (isImageField(key, field))
+            return key;
+    }
+    return null;
+}

package/dist/components/config/form/types.d.ts

@@ -0,0 +1,27 @@
+import type { FieldSchema, GalleryItem, ResourceUploadMeta } from "@vertebr/client";
+export type ConfigFormVariant = "config" | "record";
+export type ConfigFormProps = {
+    schema: Record<string, FieldSchema>;
+    value: Record<string, unknown>;
+    onSave: (value: Record<string, unknown>) => Promise<void>;
+    /** `record` uses a dense product-style editor. */
+    variant?: ConfigFormVariant;
+    /** Field-keyed upload capabilities from the host resource. */
+    uploads?: Record<string, ResourceUploadMeta>;
+    /** Upload files for a field; return public URL(s). */
+    onUpload?: (field: string, files: File[]) => Promise<Array<{
+        url: string;
+        name?: string;
+    }>>;
+    galleryUpload?: Pick<ResourceUploadMeta, "accept" | "maxBytes">;
+    onListGallery?: () => Promise<GalleryItem[]>;
+    onUploadGallery?: (files: File[]) => Promise<GalleryItem[]>;
+};
+export type FieldEntry = [string, FieldSchema];
+export type FieldGroup = {
+    id: string;
+    label: string;
+    fields: FieldEntry[];
+};
+export type GalleryHandlers = Pick<ConfigFormProps, "galleryUpload" | "onListGallery" | "onUploadGallery">;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/config/form/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/config/form/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,kDAAkD;IAClD,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,IAAI,EAAE,KACV,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpD,aAAa,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;IAChE,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,eAAe,EACf,eAAe,GAAG,eAAe,GAAG,iBAAiB,CACtD,CAAC"}

package/dist/components/config/form/types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/resources/ResourceCell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceCell.d.ts","sourceRoot":"","sources":["../../../src/components/resources/ResourceCell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAuDnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC9B,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAiB,GAClB,EAAE,iBAAiB,+BAsInB"}
+{"version":3,"file":"ResourceCell.d.ts","sourceRoot":"","sources":["../../../src/components/resources/ResourceCell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA6CnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC9B,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,KAAK,EACL,KAAK,EACL,OAAiB,GAClB,EAAE,iBAAiB,+BA0InB"}

package/dist/components/resources/ResourceCell.js

@@ -1,8 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatPrice, isCentsField, isPriceField, } from "../../lib/price";
 const IMAGE_KEY = /(image|img|photo|avatar|thumbnail|thumb|cover)/i;
 const URL_KEY = /(url|href|link|src)/i;
-const CENTS_KEY = /(cents|priceCents|amountCents)/i;
-const PRICE_KEY = /(price|amount|cost|total)/i;
 const IMAGE_EXT = /\.(png|jpe?g|gif|webp|svg|avif)(\?|#|$)/i;
 function looksLikeUrl(value) {
     return /^https?:\/\//i.test(value) || value.startsWith("//");
@@ -37,19 +36,6 @@ function formatDate(value) {
     }
     return null;
 }
-function formatMoney(value, asCents) {
-    const amount = asCents ? value / 100 : value;
-    try {
-        return new Intl.NumberFormat(undefined, {
-            style: "currency",
-            currency: "USD",
-            maximumFractionDigits: asCents || !Number.isInteger(amount) ? 2 : 0,
-        }).format(amount);
-    }
-    catch {
-        return asCents ? `$${(value / 100).toFixed(2)}` : String(value);
-    }
-}
 export function ResourceCell({ fieldKey, field, value, variant = "table", }) {
     const detail = variant === "detail";
     if (value == null || value === "") {
@@ -68,11 +54,11 @@ export function ResourceCell({ fieldKey, field, value, variant = "table", }) {
     }
     if (type === "number" || typeof value === "number") {
         if (typeof value === "number" && Number.isFinite(value)) {
-            if (CENTS_KEY.test(fieldKey) || /cents/i.test(field?.label ?? "")) {
-                return (_jsx("span", { className: "vertebr-cell-money", children: formatMoney(value, true) }));
+            if (isCentsField(fieldKey, field)) {
+                return (_jsx("span", { className: "vertebr-cell-money", children: formatPrice(value, { asCents: true }) }));
             }
-            if (PRICE_KEY.test(fieldKey)) {
-                return (_jsx("span", { className: "vertebr-cell-money", children: formatMoney(value, false) }));
+            if (isPriceField(fieldKey, field)) {
+                return (_jsx("span", { className: "vertebr-cell-money", children: formatPrice(value, { asCents: false }) }));
             }
             return (_jsx("span", { className: "vertebr-cell-number", children: new Intl.NumberFormat().format(value) }));
         }

package/dist/components/resources/ResourceTable.d.ts

@@ -1,4 +1,4 @@
-import type { FieldSchema, ResourceActionMeta, ResourceUploadMeta } from "@vertebr/client";
+import type { FieldSchema, GalleryItem, ResourceActionMeta, ResourceUploadMeta } from "@vertebr/client";
 type ResourcePanelProps = {
     schema: Record<string, FieldSchema>;
     items: Record<string, unknown>[];
@@ -20,8 +20,11 @@ type ResourcePanelProps = {
         url: string;
         name?: string;
     }>>;
+    galleryUpload?: Pick<ResourceUploadMeta, "accept" | "maxBytes">;
+    onListGallery?: () => Promise<GalleryItem[]>;
+    onUploadGallery?: (files: File[]) => Promise<GalleryItem[]>;
 };
-export declare function ResourcePanel({ schema, items, permissions, actions, uploads, rowIdKeys, storageKey, onUpdate, onCreate, onDelete, onAction, onUpload, }: ResourcePanelProps): import("react").JSX.Element;
+export declare function ResourcePanel({ schema, items, permissions, actions, uploads, rowIdKeys, storageKey, onUpdate, onCreate, onDelete, onAction, onUpload, galleryUpload, onListGallery, onUploadGallery, }: ResourcePanelProps): import("react").JSX.Element;
 /** @deprecated Prefer ResourcePanel */
 export declare function ResourceTable(props: {
     schema: Record<string, FieldSchema>;

package/dist/components/resources/ResourceTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceTable.d.ts","sourceRoot":"","sources":["../../../src/components/resources/ResourceTable.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAMzB,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,IAAI,EAAE,KACV,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACrD,CAAC;AA+DF,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,WAAW,EACX,OAAY,EACZ,OAAO,EACP,SAA0C,EAC1C,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,kBAAkB,+BAoVpB;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAClC,+BAEA"}
+{"version":3,"file":"ResourceTable.d.ts","sourceRoot":"","sources":["../../../src/components/resources/ResourceTable.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAMzB,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,IAAI,EAAE,KACV,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpD,aAAa,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;IAChE,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC7D,CAAC;AA+DF,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,WAAW,EACX,OAAY,EACZ,OAAO,EACP,SAA0C,EAC1C,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,aAAa,EACb,eAAe,GAChB,EAAE,kBAAkB,+BA+ZpB;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAClC,+BAEA"}

package/dist/components/resources/ResourceTable.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { flexRender, getCoreRowModel, useReactTable, } from "@tanstack/react-table";
 import { ConfigForm } from "../config/ConfigForm";
 import { BulkImageUploadModal } from "./BulkImageUploadModal";
@@ -64,11 +64,17 @@ function titleFromFilename(name) {
         .replace(/\s+/g, " ")
         .trim();
 }
-export function ResourcePanel({ schema, items, permissions, actions = {}, uploads, rowIdKeys = ["id", "slug", "uid", "email"], storageKey, onUpdate, onCreate, onDelete, onAction, onUpload, }) {
+export function ResourcePanel({ schema, items, permissions, actions = {}, uploads, rowIdKeys = ["id", "slug", "uid", "email"], storageKey, onUpdate, onCreate, onDelete, onAction, onUpload, galleryUpload, onListGallery, onUploadGallery, }) {
     const [editing, setEditing] = useState(null);
     const [viewing, setViewing] = useState(null);
     const [bulkOpen, setBulkOpen] = useState(false);
     const [busyAction, setBusyAction] = useState(null);
+    const tableWrapRef = useRef(null);
+    const [tableOverflow, setTableOverflow] = useState({
+        overflow: false,
+        canLeft: false,
+        canRight: false,
+    });
     const [columnVisibility, setColumnVisibility] = useState(() => readVisibility(storageKey));
     const canUpdate = Boolean(permissions?.update && onUpdate);
     const canCreate = Boolean(permissions?.create && onCreate);
@@ -82,6 +88,43 @@ export function ResourcePanel({ schema, items, permissions, actions = {}, upload
     useEffect(() => {
         writeVisibility(storageKey, columnVisibility);
     }, [storageKey, columnVisibility]);
+    const updateTableOverflow = useCallback(() => {
+        const el = tableWrapRef.current;
+        if (!el) {
+            setTableOverflow({ overflow: false, canLeft: false, canRight: false });
+            return;
+        }
+        const overflow = el.scrollWidth > el.clientWidth + 2;
+        setTableOverflow({
+            overflow,
+            canLeft: overflow && el.scrollLeft > 2,
+            canRight: overflow && el.scrollLeft + el.clientWidth < el.scrollWidth - 2,
+        });
+    }, []);
+    useEffect(() => {
+        const el = tableWrapRef.current;
+        if (!el)
+            return;
+        updateTableOverflow();
+        const onScroll = () => updateTableOverflow();
+        el.addEventListener("scroll", onScroll, { passive: true });
+        const observer = new ResizeObserver(updateTableOverflow);
+        observer.observe(el);
+        return () => {
+            el.removeEventListener("scroll", onScroll);
+            observer.disconnect();
+        };
+    }, [updateTableOverflow, items.length, columnVisibility]);
+    const scrollTable = (direction) => {
+        const el = tableWrapRef.current;
+        if (!el)
+            return;
+        const amount = Math.max(220, Math.round(el.clientWidth * 0.55));
+        el.scrollBy({
+            left: direction === "left" ? -amount : amount,
+            behavior: "smooth",
+        });
+    };
     const columnOptions = useMemo(() => fieldKeys.map((key) => ({
         id: key,
         label: schema[key]?.label ?? humanizeKey(key),
@@ -151,12 +194,12 @@ export function ResourcePanel({ schema, items, permissions, actions = {}, upload
     if (editing && editingId && onUpdate) {
         const editableSchema = Object.fromEntries(Object.entries(schema).filter(([, field]) => !field.readOnly));
         const title = rowTitle(editing, rowIdKeys);
-        return (_jsxs("div", { className: "vertebr-resource-edit", children: [_jsxs("div", { className: "vertebr-resource-edit-head", children: [_jsxs("div", { className: "vertebr-resource-edit-heading", children: [_jsx("p", { className: "vertebr-resource-edit-eyebrow", children: "Editing record" }), _jsx("h2", { children: title }), _jsx("p", { className: "vertebr-resource-edit-id", children: editingId })] }), _jsx("button", { type: "button", className: "vertebr-btn", onClick: () => setEditing(null), children: "Back" })] }), _jsx(ConfigForm, { variant: "record", schema: editableSchema, value: editing, uploads: uploads, onUpload: onUpload, onSave: async (next) => {
+        return (_jsxs("div", { className: "vertebr-resource-edit", children: [_jsxs("div", { className: "vertebr-resource-edit-head", children: [_jsxs("div", { className: "vertebr-resource-edit-heading", children: [_jsx("p", { className: "vertebr-resource-edit-eyebrow", children: "Editing record" }), _jsx("h2", { children: title }), _jsx("p", { className: "vertebr-resource-edit-id", children: editingId })] }), _jsx("button", { type: "button", className: "vertebr-btn", onClick: () => setEditing(null), children: "Back" })] }), _jsx(ConfigForm, { variant: "record", schema: editableSchema, value: editing, uploads: uploads, onUpload: onUpload, galleryUpload: galleryUpload, onListGallery: onListGallery, onUploadGallery: onUploadGallery, onSave: async (next) => {
                         await onUpdate(editingId, next);
                         setEditing(null);
                     } })] }));
     }
-    const toolbar = (_jsx("div", { className: "vertebr-table-toolbar", children: _jsxs("div", { className: "vertebr-table-toolbar-start", children: [columnOptions.length > 0 ? (_jsx(ColumnVisibilityMenu, { columns: columnOptions, visibility: columnVisibility, onChange: setColumnVisibility })) : null, canUpload ? (_jsxs("button", { type: "button", className: "vertebr-btn vertebr-btn-quiet vertebr-btn-icon", onClick: () => setBulkOpen(true), children: [_jsx(ImageUploadIcon, {}), "Bulk upload"] })) : null] }) }));
+    const toolbar = (_jsxs("div", { className: "vertebr-table-toolbar", children: [_jsxs("div", { className: "vertebr-table-toolbar-start", children: [columnOptions.length > 0 ? (_jsx(ColumnVisibilityMenu, { columns: columnOptions, visibility: columnVisibility, onChange: setColumnVisibility })) : null, canUpload ? (_jsxs("button", { type: "button", className: "vertebr-btn vertebr-btn-quiet vertebr-btn-icon", onClick: () => setBulkOpen(true), children: [_jsx(ImageUploadIcon, {}), "Bulk upload"] })) : null] }), tableOverflow.overflow ? (_jsxs("div", { className: "vertebr-table-scroll-controls", role: "group", "aria-label": "Scroll columns", children: [_jsx("button", { type: "button", className: "vertebr-btn vertebr-btn-quiet vertebr-btn-icon vertebr-table-scroll-btn", disabled: !tableOverflow.canLeft, onClick: () => scrollTable("left"), "aria-label": "Scroll columns left", children: _jsx(ChevronLeftIcon, {}) }), _jsx("button", { type: "button", className: "vertebr-btn vertebr-btn-quiet vertebr-btn-icon vertebr-table-scroll-btn", disabled: !tableOverflow.canRight, onClick: () => scrollTable("right"), "aria-label": "Scroll columns right", children: _jsx(ChevronRightIcon, {}) })] })) : null] }));
     const bulkModal = bulkOpen && uploads && onUpload ? (_jsx(BulkImageUploadModal, { uploads: uploads, canCreate: canCreate, fieldLabels: Object.fromEntries(Object.keys(uploads).map((key) => [
             key,
             schema[key]?.label ?? humanizeKey(key),
@@ -175,7 +218,7 @@ export function ResourcePanel({ schema, items, permissions, actions = {}, upload
     if (items.length === 0) {
         return (_jsxs("div", { className: "vertebr-resource-body", children: [_jsxs("div", { className: "vertebr-panel-head", children: [_jsx("h2", { children: "Records" }), _jsx("span", { className: "vertebr-count", children: "0" })] }), canUpload || columnOptions.length > 0 ? toolbar : null, _jsx("div", { className: "vertebr-empty", children: "No rows yet." }), bulkModal] }));
     }
-    return (_jsxs("div", { className: "vertebr-resource-body", children: [_jsxs("div", { className: "vertebr-panel-head", children: [_jsx("h2", { children: "Records" }), _jsx("span", { className: "vertebr-count", children: items.length })] }), canUpload || columnOptions.length > 0 ? toolbar : null, _jsx("div", { className: "vertebr-table-wrap", children: _jsxs("table", { className: "vertebr-table", children: [_jsx("thead", { children: table.getHeaderGroups().map((headerGroup) => (_jsx("tr", { children: headerGroup.headers.map((header) => (_jsx("th", { className: header.column.id === "_actions"
+    return (_jsxs("div", { className: "vertebr-resource-body", children: [_jsxs("div", { className: "vertebr-panel-head", children: [_jsx("h2", { children: "Records" }), _jsx("span", { className: "vertebr-count", children: items.length })] }), toolbar, _jsx("div", { className: "vertebr-table-wrap", ref: tableWrapRef, "data-overflow": tableOverflow.overflow ? "true" : undefined, "data-overflow-left": tableOverflow.canLeft ? "true" : undefined, "data-overflow-right": tableOverflow.canRight ? "true" : undefined, children: _jsxs("table", { className: "vertebr-table", children: [_jsx("thead", { children: table.getHeaderGroups().map((headerGroup) => (_jsx("tr", { children: headerGroup.headers.map((header) => (_jsx("th", { className: header.column.id === "_actions"
                                         ? "vertebr-col-actions"
                                         : undefined, children: header.isPlaceholder
                                         ? null
@@ -195,6 +238,12 @@ export function ResourcePanel({ schema, items, permissions, actions = {}, upload
 export function ResourceTable(props) {
     return _jsx(ResourcePanel, { ...props });
 }
+function ChevronLeftIcon() {
+    return (_jsx("svg", { className: "vertebr-btn-glyph", width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m15 18-6-6 6-6" }) }));
+}
+function ChevronRightIcon() {
+    return (_jsx("svg", { className: "vertebr-btn-glyph", width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m9 18 6-6-6-6" }) }));
+}
 function ImageUploadIcon() {
     return (_jsxs("svg", { className: "vertebr-btn-glyph", width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M16 5h6" }), _jsx("path", { d: "M19 2v6" }), _jsx("rect", { x: "3", y: "7", width: "14", height: "14", rx: "2" }), _jsx("circle", { cx: "8.5", cy: "12.5", r: "1.5" }), _jsx("path", { d: "m17 21-4.5-4.5L7 21" })] }));
 }

package/dist/hooks/useVertebrControls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVertebrControls.d.ts","sourceRoot":"","sources":["../../src/hooks/useVertebrControls.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAIF,MAAM,MAAM,4BAA4B,GAAG;IACzC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,OAAsB,EACtB,WAAW,EACX,QAAQ,GACT,EAAE,4BAA4B,+BAuC9B;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,GACV;IACD,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAMA;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD"}
+{"version":3,"file":"useVertebrControls.d.ts","sourceRoot":"","sources":["../../src/hooks/useVertebrControls.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAIF,MAAM,MAAM,4BAA4B,GAAG;IACzC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,OAAsB,EACtB,WAAW,EACX,QAAQ,GACT,EAAE,4BAA4B,+BAyC9B;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,GACV;IACD,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAMA;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD"}

package/dist/hooks/useVertebrControls.js

@@ -13,11 +13,11 @@ export function VertebrControlsProvider({ apiBase = "/admin/api", environment, c
         apiBase,
         getEnvironment: () => environment,
     }), [apiBase, environment]);
-    const refresh = useCallback(async () => {
+    const load = useCallback(async (opts) => {
         setLoading(true);
         setError(null);
         try {
-            const next = await client.getPublicControls();
+            const next = await client.getPublicControls(opts);
             setControls(next);
         }
         catch (err) {
@@ -27,9 +27,10 @@ export function VertebrControlsProvider({ apiBase = "/admin/api", environment, c
             setLoading(false);
         }
     }, [client]);
+    const refresh = useCallback(() => load({ fresh: true }), [load]);
     useEffect(() => {
-        void refresh();
-    }, [refresh]);
+        void load();
+    }, [load]);
     const value = useMemo(() => ({ environment, controls, loading, error, refresh }), [environment, controls, loading, error, refresh]);
     return (_jsx(ControlsContext.Provider, { value: value, children: children }));
 }

package/dist/index.d.ts

@@ -6,11 +6,16 @@ export { ResourcePanel, ResourceTable } from "./components/resources/ResourceTab
 export { ThemeToggle } from "./components/theme/ThemeToggle";
 export type { ThemeToggleProps } from "./components/theme/ThemeToggle";
 export { ConfigForm } from "./components/config/ConfigForm";
+export { formatPrice, formatPriceInput, parsePriceInput, isCentsField, isPriceField, } from "./lib/price";
+export { isDescriptionField, descriptionStats, applyMarkdown, } from "./lib/description";
+export type { MarkdownCommand, MarkdownEdit } from "./lib/description";
 export { EnvSelect } from "./components/env/EnvSelect";
 export { useVertebrTheme } from "./hooks/useVertebrTheme";
 export type { VbTheme } from "./hooks/useVertebrTheme";
 export { VertebrControlsProvider, useVertebrConfig, useVertebrControls, } from "./hooks/useVertebrControls";
 export type { VertebrControlsProviderProps } from "./hooks/useVertebrControls";
-export { createVertebrClient, VERTEBR_ENV_HEADER, } from "@vertebr/client";
-export type { VertebrClient, VertebrClientOptions, AdminEnvironment, BootstrapResponse, CatalogResponse, CatalogResource, CatalogConfig, CatalogConfigSection, EnvironmentAuthPublic, FieldSchema, FieldType, GalleryItem, GalleryMeta, GalleryResponse, MetricCard, MetricsResponse, ResourceListResponse, ResourceActionMeta, ResourceUploadMeta, ResourceUploadResponse, ResourceBulkUploadResponse, ConfigResponse, VertebrControlsMap, } from "@vertebr/client";
+export { createVertebrClient, VERTEBR_ENV_HEADER, renderMarkdown, } from "@vertebr/client";
+export { VertebrMarkdown } from "@vertebr/client/react";
+export type { VertebrMarkdownProps } from "@vertebr/client/react";
+export type { VertebrClient, VertebrClientOptions, VertebrReadOptions, AdminEnvironment, BootstrapResponse, CatalogResponse, CatalogResource, CatalogConfig, CatalogConfigSection, EnvironmentAuthPublic, FieldSchema, FieldType, GalleryItem, GalleryMeta, GalleryResponse, MetricCard, MetricsResponse, ResourceListResponse, ResourceActionMeta, ResourceUploadMeta, ResourceUploadResponse, ResourceBulkUploadResponse, ConfigResponse, VertebrControlsMap, } from "@vertebr/client";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,EACX,eAAe,EACf,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,EACX,eAAe,EACf,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -4,8 +4,11 @@ export { GalleryBoard } from "./components/gallery/GalleryBoard";
 export { ResourcePanel, ResourceTable } from "./components/resources/ResourceTable";
 export { ThemeToggle } from "./components/theme/ThemeToggle";
 export { ConfigForm } from "./components/config/ConfigForm";
+export { formatPrice, formatPriceInput, parsePriceInput, isCentsField, isPriceField, } from "./lib/price";
+export { isDescriptionField, descriptionStats, applyMarkdown, } from "./lib/description";
 export { EnvSelect } from "./components/env/EnvSelect";
 export { useVertebrTheme } from "./hooks/useVertebrTheme";
 export { VertebrControlsProvider, useVertebrConfig, useVertebrControls, } from "./hooks/useVertebrControls";
 // Re-export the framework-agnostic client for convenience.
-export { createVertebrClient, VERTEBR_ENV_HEADER, } from "@vertebr/client";
+export { createVertebrClient, VERTEBR_ENV_HEADER, renderMarkdown, } from "@vertebr/client";
+export { VertebrMarkdown } from "@vertebr/client/react";

package/dist/lib/description.d.ts

@@ -0,0 +1,18 @@
+import type { FieldSchema } from "@vertebr/client";
+export declare function isDescriptionField(key: string, field?: Pick<FieldSchema, "label" | "type">): boolean;
+export declare function descriptionStats(value: unknown): {
+    characters: number;
+    words: number;
+};
+export type MarkdownCommand = "bold" | "italic" | "heading" | "ul" | "ol" | "link";
+export type MarkdownEdit = {
+    next: string;
+    inserted: string;
+    replaceStart: number;
+    replaceEnd: number;
+    selectionStart: number;
+    selectionEnd: number;
+};
+/** Apply a markdown format command around the current selection. */
+export declare function applyMarkdown(text: string, start: number, end: number, command: MarkdownCommand): MarkdownEdit;
+//# sourceMappingURL=description.d.ts.map

package/dist/lib/description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description.d.ts","sourceRoot":"","sources":["../../src/lib/description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,GAC1C,OAAO,CAIT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAOA;AAED,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,IAAI,GACJ,IAAI,GACJ,MAAM,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AA8CF,oEAAoE;AACpE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,eAAe,GACvB,YAAY,CAsCd"}

package/dist/lib/description.js

@@ -0,0 +1,85 @@
+const DESCRIPTION_KEY = /(description|body|content|summary|bio|copy|caption|details)/i;
+export function isDescriptionField(key, field) {
+    if (field?.type === "richtext")
+        return true;
+    const hay = `${key} ${field?.label ?? ""}`;
+    return DESCRIPTION_KEY.test(hay);
+}
+export function descriptionStats(value) {
+    const text = typeof value === "string" ? value.trim() : "";
+    if (!text)
+        return { characters: 0, words: 0 };
+    return {
+        characters: text.length,
+        words: text.split(/\s+/).filter(Boolean).length,
+    };
+}
+function wrap(text, start, end, before, after, placeholder) {
+    const selected = text.slice(start, end) || placeholder;
+    const inserted = before + selected + after;
+    return {
+        next: text.slice(0, start) + inserted + text.slice(end),
+        inserted,
+        replaceStart: start,
+        replaceEnd: end,
+        selectionStart: start + before.length,
+        selectionEnd: start + before.length + selected.length,
+    };
+}
+function prefixLines(text, start, end, prefixFor) {
+    const lineStart = text.lastIndexOf("\n", Math.max(0, start - 1)) + 1;
+    const lineEndIndex = text.indexOf("\n", end);
+    const lineEnd = lineEndIndex === -1 ? text.length : lineEndIndex;
+    const block = text.slice(lineStart, lineEnd) || "";
+    const lines = block.split("\n");
+    const inserted = lines
+        .map((line, index) => prefixFor(index, line))
+        .join("\n");
+    return {
+        next: text.slice(0, lineStart) + inserted + text.slice(lineEnd),
+        inserted,
+        replaceStart: lineStart,
+        replaceEnd: lineEnd,
+        selectionStart: lineStart,
+        selectionEnd: lineStart + inserted.length,
+    };
+}
+/** Apply a markdown format command around the current selection. */
+export function applyMarkdown(text, start, end, command) {
+    const from = Math.max(0, Math.min(start, end, text.length));
+    const to = Math.max(0, Math.min(Math.max(start, end), text.length));
+    switch (command) {
+        case "bold":
+            return wrap(text, from, to, "**", "**", "bold text");
+        case "italic":
+            return wrap(text, from, to, "*", "*", "italic text");
+        case "link": {
+            const selected = text.slice(from, to) || "link text";
+            const inserted = `[${selected}](https://)`;
+            const urlStart = from + selected.length + 3;
+            return {
+                next: text.slice(0, from) + inserted + text.slice(to),
+                inserted,
+                replaceStart: from,
+                replaceEnd: to,
+                selectionStart: urlStart,
+                selectionEnd: urlStart + "https://".length,
+            };
+        }
+        case "heading":
+            return prefixLines(text, from, to, (_index, line) => {
+                const stripped = line.replace(/^#{1,6}\s+/, "");
+                return `## ${stripped || "Heading"}`;
+            });
+        case "ul":
+            return prefixLines(text, from, to, (_index, line) => {
+                const stripped = line.replace(/^[-*]\s+/, "").replace(/^\d+\.\s+/, "");
+                return `- ${stripped || "List item"}`;
+            });
+        case "ol":
+            return prefixLines(text, from, to, (index, line) => {
+                const stripped = line.replace(/^[-*]\s+/, "").replace(/^\d+\.\s+/, "");
+                return `${index + 1}. ${stripped || "List item"}`;
+            });
+    }
+}

package/dist/lib/images.d.ts

@@ -0,0 +1,14 @@
+import type { FieldSchema } from "@vertebr/client";
+export type RecordImage = {
+    id: string;
+    url: string;
+    name: string;
+    field: string;
+};
+declare function looksLikeUrl(value: string): boolean;
+export declare function isImageField(key: string, field?: Pick<FieldSchema, "label" | "type">): boolean;
+/** Flatten record image fields (single URL or URL lists) for the editor picker. */
+export declare function collectRecordImages(schema: Record<string, FieldSchema>, values: Record<string, unknown> | undefined): RecordImage[];
+export declare function urlsFromValue(value: unknown): string[];
+export { looksLikeUrl };
+//# sourceMappingURL=images.d.ts.map

package/dist/lib/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/lib/images.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,iBAAS,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,GAC1C,OAAO,CAIT;AAqBD,mFAAmF;AACnF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,WAAW,EAAE,CAmBf;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAYtD;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}