@murumets-ee/content 0.1.1 → 0.1.2

package/dist/client.d.cts

@@ -1,215 +0,0 @@
-import { Logger } from '@murumets-ee/core';
-import { Entity, FieldToTS, FieldConfig } from '@murumets-ee/entity';
-import { FindManyOptions } from '@murumets-ee/entity/admin';
-import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
-import { F as FieldDiff } from './types-Cr0ifLn_.cjs';
-import { V as VersionEntry, D as DraftEntry, T as TranslationStatus, a as TranslationReport, L as LocalePublishStatus } from './types-BYeiE1ie.cjs';
-
-/**
- * ContentClient — wraps AdminClient with version history and translation status.
- *
- * Usage:
- *   import { createContentClient } from '@murumets-ee/content/client'
- *   const pages = createContentClient(Page)
- *   await pages.create({ title: 'Hello', layout: [...] })
- */
-
-/** Value type that any entity field can hold */
-type EntityFieldValue = FieldToTS<FieldConfig> | null | undefined;
-interface ContentClientConfig {
-    entity: Entity;
-    db: PostgresJsDatabase;
-    logger?: Logger;
-}
-declare class ContentClient {
-    private entity;
-    private db;
-    private logger?;
-    private admin;
-    private versionableOptions;
-    constructor(config: ContentClientConfig);
-    private getAdmin;
-    create(data: Record<string, EntityFieldValue>): Promise<{
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }>;
-    findById(id: string, options?: {
-        locale?: string;
-    }): Promise<({
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }) | null>;
-    findMany(options?: FindManyOptions): Promise<({
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    })[]>;
-    update(id: string, data: Record<string, EntityFieldValue>): Promise<{
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }>;
-    delete(id: string): Promise<void>;
-    saveTranslation(entityId: string, locale: string, translations: Record<string, unknown>): Promise<void>;
-    deleteTranslation(entityId: string, locale?: string): Promise<void>;
-    /**
-     * Copy layout from one locale to another (for localized: true blocks).
-     */
-    copyLayout(entityId: string, options: {
-        from: string;
-        to: string | string[];
-    }): Promise<void>;
-    /**
-     * List versions for an entity (newest first), filtered by locale.
-     * Uses '_' as the locale value for default-locale snapshots.
-     */
-    getVersions(entityId: string, options?: {
-        limit?: number;
-        offset?: number;
-        locale?: string;
-    }): Promise<VersionEntry[]>;
-    /**
-     * Get a specific version snapshot.
-     */
-    getVersion(entityId: string, version: number, locale?: string): Promise<VersionEntry | null>;
-    /**
-     * Compare two versions and return field-level diff.
-     *
-     * Returns structured diffs with word-level segments for text fields
-     * and structural block diffs for blocks fields.
-     */
-    compareVersions(entityId: string, v1: number, v2: number, locale?: string): Promise<{
-        diffs: FieldDiff[];
-        fromVersion: VersionEntry;
-        toVersion: VersionEntry;
-    } | null>;
-    /**
-     * Compare the current draft with the live entity (or a specific version).
-     * Returns field-level diffs between the current published data and the draft.
-     */
-    compareDraftWithCurrent(entityId: string, locale?: string): Promise<{
-        diffs: FieldDiff[];
-        current: Record<string, unknown>;
-        draft: DraftEntry;
-    } | null>;
-    /**
-     * Restore an entity to a previous version.
-     */
-    restoreVersion(entityId: string, version: number): Promise<{
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }>;
-    /**
-     * Enforce maxPerDoc retention by deleting oldest versions for a locale.
-     */
-    pruneVersions(entityId: string, locale?: string): Promise<void>;
-    /**
-     * Get translation status for an entity — per-locale completion report.
-     */
-    getTranslationStatus(entityId: string): Promise<TranslationStatus>;
-    /**
-     * Get translation status for multiple entities in a single query.
-     * Returns a map of entityId → TranslationStatus (O(1) DB roundtrips).
-     */
-    getTranslationStatusBatch(entityIds: string[]): Promise<Map<string, TranslationStatus>>;
-    /**
-     * Get translation report across all entities of this type.
-     */
-    getTranslationReport(options?: {
-        locale?: string;
-    }): Promise<TranslationReport>;
-    /**
-     * Get per-locale publish status for an entity.
-     * Returns status for all non-default locales that have explicit overrides.
-     * Missing locale = inherits base entity status.
-     */
-    getLocaleStatus(entityId: string): Promise<LocalePublishStatus[]>;
-    /**
-     * Set per-locale publish status. Upserts into locale_status table.
-     * When locale === defaultLocale, updates the base entity status instead.
-     */
-    setLocaleStatus(entityId: string, locale: string, status: 'draft' | 'published'): Promise<void>;
-    /**
-     * Get per-locale publish status for multiple entities in a single query.
-     * Returns a map of entityId → locale → LocalePublishStatus.
-     */
-    getLocaleStatusBatch(entityIds: string[]): Promise<Map<string, Record<string, LocalePublishStatus>>>;
-    /**
-     * Save (upsert) a draft for an entity+locale.
-     * One draft per entity+locale — overwrites any existing draft.
-     */
-    saveDraft(entityId: string, data: Record<string, unknown>, locale?: string, user?: {
-        id: string;
-        name?: string;
-    }): Promise<DraftEntry>;
-    /**
-     * Get the draft for an entity+locale, or null if none exists.
-     */
-    getDraft(entityId: string, locale?: string): Promise<DraftEntry | null>;
-    /**
-     * Delete (discard) a draft for an entity+locale.
-     */
-    deleteDraft(entityId: string, locale?: string): Promise<boolean>;
-    /**
-     * Publish a draft: apply draft data to the live entity, then delete the draft.
-     * Runs in a transaction to ensure atomicity.
-     */
-    publishDraft(entityId: string, locale?: string, user?: {
-        id: string;
-        name?: string;
-    }): Promise<Record<string, unknown>>;
-    /**
-     * Quick existence check for list badges — does a draft exist?
-     */
-    hasDraft(entityId: string, locale?: string): Promise<boolean>;
-    /**
-     * Check draft existence for multiple entities in one query.
-     * Returns a set of entity IDs that have drafts.
-     */
-    hasDraftBatch(entityIds: string[], locale?: string): Promise<Set<string>>;
-    /**
-     * Create a version snapshot for an entity after an external update.
-     * Use this when the update was performed by AdminClient directly
-     * (e.g., the admin API handler) rather than through ContentClient.update().
-     *
-     * @param locale - The locale being edited. Use undefined or '_' for the default locale.
-     * @param user - The user who made the change (id + name for display).
-     */
-    createVersionSnapshot(entityId: string, currentData: Record<string, unknown>, previousData?: Record<string, unknown> | null, locale?: string, user?: {
-        id: string;
-        name?: string;
-    }): Promise<void>;
-    private saveVersionSnapshot;
-    private toDraftEntry;
-    private calculateDelta;
-}
-/**
- * Factory — creates a ContentClient for an entity.
- * Must be called after createApp().
- */
-declare function createContentClient(entity: Entity): Promise<ContentClient>;
-
-export { ContentClient, type ContentClientConfig, createContentClient };

package/dist/client.d.ts

@@ -1,215 +0,0 @@
-import { Logger } from '@murumets-ee/core';
-import { Entity, FieldToTS, FieldConfig } from '@murumets-ee/entity';
-import { FindManyOptions } from '@murumets-ee/entity/admin';
-import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
-import { F as FieldDiff } from './types-Cr0ifLn_.js';
-import { V as VersionEntry, D as DraftEntry, T as TranslationStatus, a as TranslationReport, L as LocalePublishStatus } from './types-BYeiE1ie.js';
-
-/**
- * ContentClient — wraps AdminClient with version history and translation status.
- *
- * Usage:
- *   import { createContentClient } from '@murumets-ee/content/client'
- *   const pages = createContentClient(Page)
- *   await pages.create({ title: 'Hello', layout: [...] })
- */
-
-/** Value type that any entity field can hold */
-type EntityFieldValue = FieldToTS<FieldConfig> | null | undefined;
-interface ContentClientConfig {
-    entity: Entity;
-    db: PostgresJsDatabase;
-    logger?: Logger;
-}
-declare class ContentClient {
-    private entity;
-    private db;
-    private logger?;
-    private admin;
-    private versionableOptions;
-    constructor(config: ContentClientConfig);
-    private getAdmin;
-    create(data: Record<string, EntityFieldValue>): Promise<{
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }>;
-    findById(id: string, options?: {
-        locale?: string;
-    }): Promise<({
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }) | null>;
-    findMany(options?: FindManyOptions): Promise<({
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    })[]>;
-    update(id: string, data: Record<string, EntityFieldValue>): Promise<{
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }>;
-    delete(id: string): Promise<void>;
-    saveTranslation(entityId: string, locale: string, translations: Record<string, unknown>): Promise<void>;
-    deleteTranslation(entityId: string, locale?: string): Promise<void>;
-    /**
-     * Copy layout from one locale to another (for localized: true blocks).
-     */
-    copyLayout(entityId: string, options: {
-        from: string;
-        to: string | string[];
-    }): Promise<void>;
-    /**
-     * List versions for an entity (newest first), filtered by locale.
-     * Uses '_' as the locale value for default-locale snapshots.
-     */
-    getVersions(entityId: string, options?: {
-        limit?: number;
-        offset?: number;
-        locale?: string;
-    }): Promise<VersionEntry[]>;
-    /**
-     * Get a specific version snapshot.
-     */
-    getVersion(entityId: string, version: number, locale?: string): Promise<VersionEntry | null>;
-    /**
-     * Compare two versions and return field-level diff.
-     *
-     * Returns structured diffs with word-level segments for text fields
-     * and structural block diffs for blocks fields.
-     */
-    compareVersions(entityId: string, v1: number, v2: number, locale?: string): Promise<{
-        diffs: FieldDiff[];
-        fromVersion: VersionEntry;
-        toVersion: VersionEntry;
-    } | null>;
-    /**
-     * Compare the current draft with the live entity (or a specific version).
-     * Returns field-level diffs between the current published data and the draft.
-     */
-    compareDraftWithCurrent(entityId: string, locale?: string): Promise<{
-        diffs: FieldDiff[];
-        current: Record<string, unknown>;
-        draft: DraftEntry;
-    } | null>;
-    /**
-     * Restore an entity to a previous version.
-     */
-    restoreVersion(entityId: string, version: number): Promise<{
-        id: string;
-    } & {} & {
-        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
-            [key: string]: unknown;
-            _block: string;
-            _id: string;
-        }[] | null | undefined;
-    }>;
-    /**
-     * Enforce maxPerDoc retention by deleting oldest versions for a locale.
-     */
-    pruneVersions(entityId: string, locale?: string): Promise<void>;
-    /**
-     * Get translation status for an entity — per-locale completion report.
-     */
-    getTranslationStatus(entityId: string): Promise<TranslationStatus>;
-    /**
-     * Get translation status for multiple entities in a single query.
-     * Returns a map of entityId → TranslationStatus (O(1) DB roundtrips).
-     */
-    getTranslationStatusBatch(entityIds: string[]): Promise<Map<string, TranslationStatus>>;
-    /**
-     * Get translation report across all entities of this type.
-     */
-    getTranslationReport(options?: {
-        locale?: string;
-    }): Promise<TranslationReport>;
-    /**
-     * Get per-locale publish status for an entity.
-     * Returns status for all non-default locales that have explicit overrides.
-     * Missing locale = inherits base entity status.
-     */
-    getLocaleStatus(entityId: string): Promise<LocalePublishStatus[]>;
-    /**
-     * Set per-locale publish status. Upserts into locale_status table.
-     * When locale === defaultLocale, updates the base entity status instead.
-     */
-    setLocaleStatus(entityId: string, locale: string, status: 'draft' | 'published'): Promise<void>;
-    /**
-     * Get per-locale publish status for multiple entities in a single query.
-     * Returns a map of entityId → locale → LocalePublishStatus.
-     */
-    getLocaleStatusBatch(entityIds: string[]): Promise<Map<string, Record<string, LocalePublishStatus>>>;
-    /**
-     * Save (upsert) a draft for an entity+locale.
-     * One draft per entity+locale — overwrites any existing draft.
-     */
-    saveDraft(entityId: string, data: Record<string, unknown>, locale?: string, user?: {
-        id: string;
-        name?: string;
-    }): Promise<DraftEntry>;
-    /**
-     * Get the draft for an entity+locale, or null if none exists.
-     */
-    getDraft(entityId: string, locale?: string): Promise<DraftEntry | null>;
-    /**
-     * Delete (discard) a draft for an entity+locale.
-     */
-    deleteDraft(entityId: string, locale?: string): Promise<boolean>;
-    /**
-     * Publish a draft: apply draft data to the live entity, then delete the draft.
-     * Runs in a transaction to ensure atomicity.
-     */
-    publishDraft(entityId: string, locale?: string, user?: {
-        id: string;
-        name?: string;
-    }): Promise<Record<string, unknown>>;
-    /**
-     * Quick existence check for list badges — does a draft exist?
-     */
-    hasDraft(entityId: string, locale?: string): Promise<boolean>;
-    /**
-     * Check draft existence for multiple entities in one query.
-     * Returns a set of entity IDs that have drafts.
-     */
-    hasDraftBatch(entityIds: string[], locale?: string): Promise<Set<string>>;
-    /**
-     * Create a version snapshot for an entity after an external update.
-     * Use this when the update was performed by AdminClient directly
-     * (e.g., the admin API handler) rather than through ContentClient.update().
-     *
-     * @param locale - The locale being edited. Use undefined or '_' for the default locale.
-     * @param user - The user who made the change (id + name for display).
-     */
-    createVersionSnapshot(entityId: string, currentData: Record<string, unknown>, previousData?: Record<string, unknown> | null, locale?: string, user?: {
-        id: string;
-        name?: string;
-    }): Promise<void>;
-    private saveVersionSnapshot;
-    private toDraftEntry;
-    private calculateDelta;
-}
-/**
- * Factory — creates a ContentClient for an entity.
- * Must be called after createApp().
- */
-declare function createContentClient(entity: Entity): Promise<ContentClient>;
-
-export { ContentClient, type ContentClientConfig, createContentClient };

package/dist/index.cjs

@@ -1 +0,0 @@
-"use strict";var m=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var E=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var R=(e,n)=>{for(var t in n)m(e,t,{get:n[t],enumerable:!0})},W=(e,n,t,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of E(n))!I.call(e,o)&&o!==t&&m(e,o,{get:()=>n[o],enumerable:!(i=q(n,o))||i.enumerable});return e};var C=e=>W(m({},"__esModule",{value:!0}),e);var K={};R(K,{WORKFLOW_STATES:()=>x,defineBlock:()=>D,diffBlocks:()=>A,diffField:()=>_,diffFields:()=>T,diffStringValues:()=>g,diffText:()=>p,getVersionableOptions:()=>S,versionable:()=>F,workflowable:()=>v});module.exports=C(K);var h=require("@murumets-ee/entity"),L={maxPerDoc:50,autosave:!1};function F(e){let n={...L,...e};return{name:"versionable",fields:{_version:h.field.number({required:!0,default:1,integer:!0}),_versionedAt:h.field.date()},hooks:{beforeCreate:async i=>(i._version=1,i._versionedAt=new Date,i),beforeUpdate:async(i,o)=>(o._versionedAt=new Date,o)},_versionableOptions:n}}function S(e){return e?e.find(t=>t.name==="versionable")?._versionableOptions??null:null}var y=require("@murumets-ee/entity"),x=["draft","in_review","approved","rejected","published"];function v(){return{name:"workflowable",fields:{_workflowStatus:y.field.select({options:x,default:"draft",indexed:!0,required:!0}),_workflowAssignee:y.field.text({required:!1}),_workflowNote:y.field.text({required:!1}),_workflowUpdatedAt:y.field.date()},hooks:{beforeCreate:async e=>(e._workflowStatus="draft",e._workflowUpdatedAt=new Date,e)}}}function D(e){if(!e.slug||!e.slug.match(/^[a-z][a-z0-9-]*$/))throw new Error(`Block slug must be lowercase alphanumeric with hyphens, got: "${e.slug}"`);if(!e.label)throw new Error(`Block label is required for slug: "${e.slug}"`);if(!e.fields||Object.keys(e.fields).length===0)throw new Error(`Block "${e.slug}" must have at least one field`);return{slug:e.slug,label:e.label,fields:e.fields}}function B(e){return e.match(/\S+|\s+/g)??[]}function p(e,n){if(e===n)return e?[{type:"equal",value:e}]:[];if(!e)return[{type:"add",value:n}];if(!n)return[{type:"remove",value:e}];let t=B(e),i=B(n),o=t.length,s=i.length,l=Array.from({length:o+1},()=>new Array(s+1).fill(0));for(let u=1;u<=o;u++)for(let c=1;c<=s;c++)t[u-1]===i[c-1]?l[u][c]=l[u-1][c-1]+1:l[u][c]=Math.max(l[u-1][c],l[u][c-1]);let a=[],r=o,f=s,d=[];for(;r>0||f>0;)r>0&&f>0&&t[r-1]===i[f-1]?(d.push({type:"equal",value:t[r-1]}),r--,f--):f>0&&(r===0||l[r][f-1]>=l[r-1][f])?(d.push({type:"add",value:i[f-1]}),f--):(d.push({type:"remove",value:t[r-1]}),r--);d.reverse();for(let u of d){let c=a[a.length-1];c&&c.type===u.type?c.value+=u.value:a.push({...u})}return a}function O(e){return e.replace(/<[^>]*>/g," ").replace(/\s+/g," ").trim()}function k(e){return e==null?"":e instanceof Date?e.toISOString():typeof e=="object"?JSON.stringify(e):String(e)}function _(e,n,t,i){if(JSON.stringify(n)===JSON.stringify(t))return null;switch(i?.type??U(n,t)){case"text":case"slug":{let s=p(k(n),k(t));return{field:e,type:"text",from:n,to:t,segments:s}}case"richtext":{let s=p(O(k(n)),O(k(t)));return{field:e,type:"richtext",from:n,to:t,segments:s}}case"number":return{field:e,type:"number",from:n,to:t};case"boolean":return{field:e,type:"boolean",from:n,to:t};case"date":return{field:e,type:"date",from:n,to:t};case"select":return{field:e,type:"select",from:n,to:t};case"media":return{field:e,type:"media",from:n,to:t};case"json":return{field:e,type:"json",from:n,to:t};case"blocks":return{field:e,type:"blocks",from:n,to:t};default:return{field:e,type:"unknown",from:n,to:t}}}function T(e,n,t){let i=new Set([...Object.keys(e),...Object.keys(n)]),o=[];for(let s of i){if(s==="id"||s==="createdAt"||s==="updatedAt")continue;let l=_(s,e[s],n[s],t?.[s]);l&&o.push(l)}return o}function U(e,n){let t=e??n;return typeof t=="number"?"number":typeof t=="boolean"?"boolean":t instanceof Date?"date":typeof t=="string"?/^\d{4}-\d{2}-\d{2}/.test(t)?"date":"text":Array.isArray(t)?t.length>0&&typeof t[0]=="object"&&t[0]!==null&&"_block"in t[0]?"blocks":"json":typeof t=="object"?"json":"unknown"}function g(e,n){if(typeof e=="string"||typeof n=="string")return p(k(e),k(n))}function j(e){return typeof e=="object"&&e!==null&&"_block"in e&&"_id"in e&&typeof e._block=="string"&&typeof e._id=="string"}function J(e,n){let t=new Set([...Object.keys(e),...Object.keys(n)]),i=[];for(let o of t){if(o==="_block"||o==="_id")continue;let s=e[o],l=n[o];JSON.stringify(s)!==JSON.stringify(l)&&i.push({field:o,from:s,to:l,segments:g(s,l)})}return i}function A(e,n){let t=e.filter(j),i=n.filter(j),o=new Map,s=new Map;for(let r=0;r<t.length;r++)o.set(t[r]._id,{block:t[r],index:r});for(let r=0;r<i.length;r++)s.set(i[r]._id,{block:i[r],index:r});let l=[],a=new Set;for(let[r,{block:f,index:d}]of s){a.add(r);let u=o.get(r);if(!u){l.push({blockId:r,blockType:f._block,status:"added",toIndex:d});continue}let c=u.block,b=u.index,w=J(c,f),V=b!==d;w.length===0&&!V?l.push({blockId:r,blockType:f._block,status:"unchanged",fromIndex:b,toIndex:d}):w.length>0?l.push({blockId:r,blockType:f._block,status:"changed",fromIndex:b,toIndex:d,propDiffs:w}):l.push({blockId:r,blockType:f._block,status:"moved",fromIndex:b,toIndex:d})}for(let[r,{block:f,index:d}]of o)a.has(r)||l.push({blockId:r,blockType:f._block,status:"removed",fromIndex:d});return l}0&&(module.exports={WORKFLOW_STATES,defineBlock,diffBlocks,diffField,diffFields,diffStringValues,diffText,getVersionableOptions,versionable,workflowable});

package/dist/index.d.cts

@@ -1,142 +0,0 @@
-import { Behavior, NumberField, DateField, SelectField, TextField, FieldConfig } from '@murumets-ee/entity';
-import { b as VersionableOptions, B as BlockDefinition } from './types-BYeiE1ie.cjs';
-export { C as ContentConfig, D as DraftEntry, I as InferBlockData, c as InferBlocksUnion, d as LocaleConfig, e as LockInfo, f as TranslationFieldStatus, a as TranslationReport, T as TranslationStatus, V as VersionEntry } from './types-BYeiE1ie.cjs';
-import { B as BlockDiffEntry, F as FieldDiff, D as DiffSegment } from './types-Cr0ifLn_.cjs';
-export { a as BlockDiffStatus, P as PropDiff } from './types-Cr0ifLn_.cjs';
-
-/**
- * Versionable behavior — full version history with snapshots.
- *
- * Extends the concept of revisionable() (which only tracks a counter)
- * with actual version snapshots stored in {entity}_versions table.
- *
- * The behavior itself adds fields + hooks for version tracking.
- * Actual snapshot persistence happens in ContentClient (which has DB access).
- *
- * Options:
- * - maxPerDoc: Maximum versions kept per document (default: 50)
- * - autosave: Enable smart autosave (default: false)
- */
-
-type VersionableFields = {
-    _version: NumberField & {
-        required: true;
-    };
-    _versionedAt: DateField;
-};
-declare function versionable(options?: VersionableOptions): Behavior<VersionableFields>;
-/**
- * Extract versionable options from an entity's behaviors
- */
-declare function getVersionableOptions(behaviors?: Behavior[]): Required<VersionableOptions> | null;
-
-/**
- * Workflowable behavior — editorial workflow with approval gates.
- *
- * Adds workflow status tracking fields to an entity. Works alongside
- * `publishable()` — the workflow status tracks the editorial pipeline,
- * while publishable's `status` remains the public-facing state.
- *
- * Key invariant: `status` can only transition to 'published' when
- * `_workflowStatus === 'approved'` (unless the user has direct `publish`
- * permission, which bypasses the workflow).
- *
- * Workflow states:
- * - draft → in_review (submit for review, requires 'update')
- * - in_review → approved (approve, requires 'publish')
- * - in_review → rejected (reject with note, requires 'publish')
- * - approved → published (publish, requires 'publish')
- * - rejected → in_review (resubmit, requires 'update')
- * - published → draft (unpublish, requires 'publish')
- */
-
-declare const WORKFLOW_STATES: readonly ["draft", "in_review", "approved", "rejected", "published"];
-type WorkflowState = (typeof WORKFLOW_STATES)[number];
-type WorkflowableFields = {
-    _workflowStatus: SelectField & {
-        required: true;
-    };
-    _workflowAssignee: TextField;
-    _workflowNote: TextField;
-    _workflowUpdatedAt: DateField;
-};
-declare function workflowable(): Behavior<WorkflowableFields>;
-
-/**
- * Block definition API
- *
- * defineBlock() creates a reusable content block with typed fields.
- * Uses `const F` generic to preserve literal field types for inference.
- *
- * Blocks are NOT entities — they lack independent identity, CRUD, and access control.
- * They exist only as embedded data within a parent entity's blocks field.
- *
- * @example
- * const HeroBlock = defineBlock({
- *   slug: 'hero',
- *   label: 'Hero Section',
- *   fields: {
- *     heading: field.text({ required: true, translatable: true }),
- *     background: field.media({ accept: ['image/*'] }),
- *   },
- * })
- */
-
-declare function defineBlock<const F extends Record<string, FieldConfig>>(definition: {
-    slug: string;
-    label: string;
-    fields: F;
-}): BlockDefinition<F>;
-
-/**
- * Structural diff for Puck block arrays.
- *
- * Blocks are identified by `_id`. The algorithm detects:
- * - Added blocks (new _id in target)
- * - Removed blocks (missing _id in target)
- * - Moved blocks (same _id, different position)
- * - Changed blocks (same _id, different prop values)
- * - Unchanged blocks
- */
-
-/**
- * Compute structural diff between two block arrays.
- *
- * Each block is identified by its `_id` field. Position changes,
- * additions, removals, and prop-level changes are all detected.
- */
-declare function diffBlocks(fromBlocks: unknown[], toBlocks: unknown[]): BlockDiffEntry[];
-
-/**
- * Field-level diff — dispatches to the appropriate diff strategy per field type.
- */
-
-/**
- * Compute diff for a single field, using the field's type to determine
- * the best diff strategy.
- */
-declare function diffField(fieldName: string, from: unknown, to: unknown, fieldConfig?: FieldConfig): FieldDiff | null;
-/**
- * Diff all fields between two version snapshots.
- * Pass fieldConfigs to get type-aware diffs; without them, types are inferred.
- */
-declare function diffFields(from: Record<string, unknown>, to: Record<string, unknown>, fieldConfigs?: Record<string, FieldConfig>): FieldDiff[];
-/** Diff two string values and return segments (used by block-diff for string props). */
-declare function diffStringValues(from: unknown, to: unknown): DiffSegment[] | undefined;
-
-/**
- * Word-level text diff using a simplified Myers algorithm.
- *
- * Splits text into words (preserving whitespace), computes the longest common
- * subsequence, and returns an array of diff segments.
- */
-
-/**
- * Compute word-level diff between two strings.
- *
- * Uses a simple LCS (dynamic programming) approach which is fine for
- * the text sizes we deal with (entity field values, not source code).
- */
-declare function diffText(from: string, to: string): DiffSegment[];
-
-export { BlockDefinition, BlockDiffEntry, DiffSegment, FieldDiff, VersionableOptions, WORKFLOW_STATES, type WorkflowState, type WorkflowableFields, defineBlock, diffBlocks, diffField, diffFields, diffStringValues, diffText, getVersionableOptions, versionable, workflowable };