@obelism/content 0.2.0 → 0.3.0

package/README.md

@@ -55,12 +55,35 @@ bridge.on('update', ({ entry }) => render(entry)) // unsaved edits, as typed
 
 Mark blocks so editors can click them: `<section {...editable(block)}>`
 (adds `data-cms-uid`). Without an `update` listener the page reloads after
-each save. It replaces the `<script src=".../bridge.js">` tag; when a page has
-both, it wraps the script's bridge instead of starting a second one. React
-sites use `@obelism/content-react`.
+each save. React sites use `@obelism/content-react`.
+
+Without a bundler, the same bridge (prompt box included) is one script tag:
+
+```html
+<script src="https://content.obelism.studio/bridge.js"></script>
+<script>
+	ObelismBridge.on('update', ({ entry }) => render(entry))
+</script>
+```
+
+The CMS serves this package's `dist/bridge.global.js` there; npm CDNs serve
+it too (then add `data-url` if your CMS isn't content.obelism.studio).
+`data-prompt="false"` leaves the prompt box out. The tag puts the bridge on
+`window.ObelismBridge` and `getContentBridge` / `mountPromptBox` on
+`window.ObelismContent`; a bundled copy on the same page shares its bridge.
 
 ## Prompt editing
 
+The prompt box is plain DOM in a shadow root, no framework. Start the
+bridge with `prompt: false` to leave it out, and mount it yourself later:
+
+```ts
+import { getContentBridge, mountPromptBox } from '@obelism/content/bridge'
+
+const bridge = getContentBridge({ prompt: false })
+const unmount = mountPromptBox(document, bridge, { labels: { open: 'Ask' } })
+```
+
 Inside the visual editor, people who may edit get a prompt box at the bottom
 of the page: they type what to change and it shows on the page right away,
 unsaved, with undo. It acts on the selected block, or the whole entry. The
@@ -109,12 +132,50 @@ export const POST = createPromptHandler({
 - `richTextToHtml(doc, { renderEntry?, renderAsset? })`, `richTextToPlainText(doc)`
 - `imageUrl(asset, { w, h, fit, format, q })`, `imageSrcSet(asset, [480, 960])`
 
+## A/B tests and feature flags
+
+Any blocks field can hold the built-in improve block (`ImproveBlock`,
+`_type: '_improve'`): one list of blocks per option of an improve test or
+flag. Ask improve's SDK for the visitor's option and render that variant:
+
+```ts
+import { isImproveBlock, pickImproveVariant } from '@obelism/content'
+
+// `improve` is improve's SDK (@obelism/improve-sdk), set up for the visitor.
+const blocks = layout.flatMap((block) => {
+	if (!isImproveBlock(block)) return [block]
+	const option =
+		block.kind === 'flag'
+			? improve.getFlagValue(block.slug)
+			: improve.getTestValue(block.slug)
+	return pickImproveVariant(block, option)
+})
+```
+
+`pickImproveVariant(block, option, fallback?)` falls back to `fallback`'s
+variant, else the first one, when the option is `null` (the test isn't
+active or the visitor isn't in it) or has no variant.
+
 ## CLI
 
-Keeps a content model file in Git in step with an environment.
+Start a site's repository on a space, in its root:
+
+```bash
+export CONTENT_MANAGEMENT_TOKEN=cms_m_…   # a management token, Space settings
+npx @obelism/content init
+```
+
+It writes the model file (`content/content-model.json`), an example of what
+the delivery API answers for every content type (`content/examples/`, with
+the A/B test or flag block while your organization has improve on),
+installs `@obelism/content` with your package manager, and adds the token variables to
+`.env.example`. Options: `--dir` (default `content`), `--url`,
+`--skip-install`. Agents get the same steps from the CMS's
+`getProjectSetup` MCP tool.
+
+Then keep the model file in Git in step with an environment:
 
 ```bash
-export CONTENT_MANAGEMENT_TOKEN=cms_m_…
 npx @obelism/content model pull    # write content/content-model.json
 npx @obelism/content model plan    # what applying would change
 npx @obelism/content model apply   # apply it, all or nothing

package/dist/bin/content.js

@@ -1,9 +1,190 @@
 #!/usr/bin/env node
 var node_util = require('node:util');
 var config = require('../config-ci2hxmas.js');
+var node_child_process = require('node:child_process');
 var promises = require('node:fs/promises');
 var node_path = require('node:path');
 
+// Blocks inside blocks stop here, so a type that allows itself ends.
+const MAX_DEPTH = 3;
+const EXAMPLE_DATE = '2026-01-01';
+const EXAMPLE_DATE_TIME = '2026-01-01T09:00:00.000Z';
+// An image unless the field only takes other files; then its first exact
+// type, or a PDF.
+const exampleAsset = (mimeTypes)=>{
+    const image = !mimeTypes || mimeTypes.some((type)=>type.startsWith('image/'));
+    const exact = mimeTypes?.find((type)=>/^[a-z]+\/[^*]+$/.test(type));
+    const mimeType = image ? 'image/jpeg' : exact ?? 'application/pdf';
+    const filename = image ? 'example.jpg' : `example.${mimeType.split('/')[1]?.split('+')[0] ?? 'bin'}`;
+    return {
+        id: 'asset_example',
+        url: `https://content.obelism.studio/files/asset_example/${filename}`,
+        filename,
+        mimeType,
+        size: 120_000,
+        width: image ? 1600 : null,
+        height: image ? 900 : null,
+        title: null,
+        alt: image ? 'An example image' : null
+    };
+};
+const exampleRichText = (name)=>({
+        type: 'doc',
+        content: [
+            {
+                type: 'paragraph',
+                content: [
+                    {
+                        type: 'text',
+                        text: `Example ${name}, with `
+                    },
+                    {
+                        type: 'text',
+                        text: 'bold',
+                        marks: [
+                            {
+                                type: 'bold'
+                            }
+                        ]
+                    },
+                    {
+                        type: 'text',
+                        text: ' text.'
+                    }
+                ]
+            }
+        ]
+    });
+const truncate = (text, maxLength)=>maxLength === undefined ? text : text.slice(0, maxLength);
+const buildExamples = (model, improve)=>{
+    const types = model.contentTypes;
+    const blockTypes = types.filter(({ kind })=>kind === 'block');
+    const entryTypes = types.filter(({ kind })=>kind !== 'block');
+    // Uids are unique within one example, like within one entry.
+    let next = 0;
+    const uid = ()=>`example${++next}`;
+    const allowedBlocks = (allowed)=>allowed ? blockTypes.filter(({ apiId })=>allowed.includes(apiId)) : blockTypes;
+    const improveBlock = (allowed, depth)=>{
+        const source = improve.sources[0] ?? {
+            kind: 'test',
+            slug: 'example-test',
+            options: [
+                {
+                    slug: 'control',
+                    name: 'Control'
+                },
+                {
+                    slug: 'variation',
+                    name: 'Variation'
+                }
+            ]
+        };
+        const first = allowedBlocks(allowed)[0];
+        return {
+            _uid: uid(),
+            _type: '_improve',
+            kind: source.kind,
+            slug: source.slug,
+            variants: Object.fromEntries(source.options.map((option)=>[
+                    option.slug,
+                    first && depth < MAX_DEPTH ? [
+                        block(first, depth + 1)
+                    ] : []
+                ]))
+        };
+    };
+    const value = (field, depth)=>{
+        const name = field.name.toLowerCase();
+        switch(field.type){
+            case 'text':
+                return truncate(`Example ${name}`, field.maxLength);
+            case 'textarea':
+                return truncate(`Example ${name}. A sentence or two of plain text.`, field.maxLength);
+            case 'richtext':
+                return exampleRichText(name);
+            case 'number':
+                return field.min ?? (field.integer ? 1 : 1.5);
+            case 'boolean':
+                return true;
+            case 'datetime':
+                return field.withTime ? EXAMPLE_DATE_TIME : EXAMPLE_DATE;
+            case 'select':
+                {
+                    const first = field.options[0]?.value ?? null;
+                    return field.multiple ? first ? [
+                        first
+                    ] : [] : first;
+                }
+            case 'asset':
+                {
+                    const asset = exampleAsset(field.mimeTypes);
+                    return field.multiple ? [
+                        asset
+                    ] : asset;
+                }
+            case 'reference':
+                {
+                    const target = field.contentTypes?.[0] ?? entryTypes[0]?.apiId ?? 'page';
+                    const stub = {
+                        id: 'entry_example',
+                        contentType: target
+                    };
+                    return field.multiple ? [
+                        stub
+                    ] : stub;
+                }
+            case 'blocks':
+                {
+                    if (depth >= MAX_DEPTH) return [];
+                    const allowed = allowedBlocks(field.allowedBlocks);
+                    // At the top, one of every block the field allows (and the
+                    // improve block); deeper, only the first.
+                    const blocks = depth === 0 ? allowed.map((type)=>block(type, depth + 1)) : allowed.slice(0, 1).map((type)=>block(type, depth + 1));
+                    return depth === 0 && improve.enabled ? [
+                        ...blocks,
+                        improveBlock(field.allowedBlocks, depth + 1)
+                    ] : blocks;
+                }
+            case 'json':
+                return {};
+        }
+    };
+    const fields = (type, depth)=>Object.fromEntries(type.fields.map((field)=>[
+                field.apiId,
+                value(field, depth)
+            ]));
+    const block = (type, depth)=>({
+            _uid: uid(),
+            _type: type.apiId,
+            ...fields(type, depth)
+        });
+    const examples = {};
+    for (const type of types){
+        next = 0;
+        if (type.kind === 'block') {
+            examples[type.apiId] = block(type, 0);
+            continue;
+        }
+        const slug = type.kind === 'page' ? 'example' : null;
+        examples[type.apiId] = {
+            id: 'entry_example',
+            contentType: type.apiId,
+            name: `Example ${type.name.toLowerCase()}`,
+            slug,
+            path: slug,
+            publishedAt: EXAMPLE_DATE_TIME,
+            firstPublishedAt: EXAMPLE_DATE_TIME,
+            updatedAt: EXAMPLE_DATE_TIME,
+            fields: fields(type, 0)
+        };
+    }
+    if (improve.enabled) {
+        next = 0;
+        examples._improve = improveBlock(undefined, 0);
+    }
+    return examples;
+};
+
 // Turns a model plan from the management API into text for a terminal, or
 // Markdown for a GitHub step summary or pull request comment.
 const ACTION_SIGN = {
@@ -146,15 +327,205 @@ const runModelCommand = async ({ command, file, url, token, prune, log = console
     return !ok || (plan.issues?.length ?? 0) > 0 ? 1 : 0;
 };
 
-const USAGE = `Usage: content model <pull|plan|apply> [--file path] [--url origin] [--prune]
+const PACKAGE_MANAGERS = [
+    {
+        lockfile: 'pnpm-lock.yaml',
+        command: 'pnpm',
+        add: [
+            'add'
+        ]
+    },
+    {
+        lockfile: 'yarn.lock',
+        command: 'yarn',
+        add: [
+            'add'
+        ]
+    },
+    {
+        lockfile: 'bun.lock',
+        command: 'bun',
+        add: [
+            'add'
+        ]
+    },
+    {
+        lockfile: 'bun.lockb',
+        command: 'bun',
+        add: [
+            'add'
+        ]
+    },
+    {
+        lockfile: 'package-lock.json',
+        command: 'npm',
+        add: [
+            'install'
+        ]
+    }
+];
+const ENV_VARIABLES = [
+    [
+        'CONTENT_DELIVERY_TOKEN',
+        'reads published content (cms_d_…)'
+    ],
+    [
+        'CONTENT_PREVIEW_TOKEN',
+        'also reads drafts, server-side only (cms_p_…)'
+    ],
+    [
+        'CONTENT_MANAGEMENT_TOKEN',
+        'changes the content model: content model pull|plan|apply (cms_m_…)'
+    ]
+];
+const exists = (path)=>promises.access(path).then(()=>true, ()=>false);
+const runCommand = (command, args, cwd)=>new Promise((resolve)=>{
+        const child = node_child_process.spawn(command, args, {
+            cwd,
+            stdio: 'inherit',
+            shell: process.platform === 'win32'
+        });
+        child.on('error', ()=>resolve(127));
+        child.on('close', (code)=>resolve(code ?? 1));
+    });
+const writeJson = async (path, value)=>promises.writeFile(path, `${JSON.stringify(value, null, '\t')}\n`);
+// Whether the organization has improve on, and its tests and flags. A CMS
+// without the endpoint has no improve block.
+const readImprove = async (url, token, fetchImpl)=>{
+    const response = await fetchImpl(`${url}${config.MANAGEMENT_PATH}/improve`, {
+        headers: {
+            Authorization: `Bearer ${token}`
+        }
+    }).catch((error)=>{
+        throw new CliError(`Could not reach ${url}: ${error.message}`);
+    });
+    if (response.status === 404) return {
+        enabled: false,
+        sources: []
+    };
+    const json = await response.json().catch(()=>({}));
+    if (!response.ok) {
+        throw new CliError(String(json.error ?? `${response.status} from ${url}`));
+    }
+    return {
+        enabled: json.enabled === true,
+        sources: json.sources ?? []
+    };
+};
+const install = async (cwd, log, run)=>{
+    const manifestPath = node_path.join(cwd, 'package.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(await promises.readFile(manifestPath, 'utf8'));
+    } catch  {
+        log('No package.json here, so nothing was installed: add @obelism/content to your project yourself.');
+        return;
+    }
+    const dependencies = {
+        ...manifest.dependencies,
+        ...manifest.devDependencies
+    };
+    const wanted = [
+        '@obelism/content'
+    ].filter((name)=>!dependencies[name]);
+    if (wanted.length === 0) {
+        log('The SDK is already installed.');
+        return;
+    }
+    let manager = PACKAGE_MANAGERS.at(-1);
+    for (const candidate of PACKAGE_MANAGERS){
+        if (await exists(node_path.join(cwd, candidate.lockfile))) {
+            manager = candidate;
+            break;
+        }
+    }
+    const args = [
+        ...manager.add,
+        ...wanted
+    ];
+    log(`Installing: ${manager.command} ${args.join(' ')}`);
+    const code = await run(manager.command, args, cwd);
+    if (code !== 0) {
+        throw new CliError(`${manager.command} ${args.join(' ')} failed (exit ${code}). The files are written; install the SDK yourself.`);
+    }
+};
+// Appends the variables .env.example doesn't have yet. Never values.
+const writeEnvExample = async (cwd, url)=>{
+    const path = node_path.join(cwd, '.env.example');
+    const current = await promises.readFile(path, 'utf8').catch(()=>'');
+    const has = (name)=>new RegExp(`^\\s*${name}\\s*=`, 'm').test(current);
+    const lines = [
+        ...ENV_VARIABLES.filter(([name])=>!has(name)).flatMap(([name, about])=>[
+                `# ${about}`,
+                `${name}=`
+            ]),
+        ...url !== config.DEFAULT_URL && !has('CONTENT_URL') ? [
+            `CONTENT_URL=${url}`
+        ] : []
+    ];
+    if (lines.length === 0) return false;
+    const header = '# Obelism Content (written by `content init`)';
+    const separator = current === '' || current.endsWith('\n') ? '' : '\n';
+    await promises.writeFile(path, `${current}${separator}${current ? '\n' : ''}${header}\n${lines.join('\n')}\n`);
+    return true;
+};
+const runInitCommand = async ({ url, token, dir, install: shouldInstall, cwd = process.cwd(), log = console.log, fetch: fetchImpl = fetch, run = runCommand })=>{
+    const base = node_path.join(cwd, dir);
+    const modelFile = node_path.join(base, 'content-model.json');
+    await runModelCommand({
+        command: 'pull',
+        // Relative, so the log names it the way the user would.
+        file: node_path.relative(process.cwd(), modelFile) || modelFile,
+        url,
+        token,
+        prune: false,
+        log,
+        fetch: fetchImpl
+    });
+    const model = JSON.parse(await promises.readFile(modelFile, 'utf8'));
+    const improve = await readImprove(url, token, fetchImpl);
+    const examples = buildExamples(model, improve);
+    const examplesDir = node_path.join(base, 'examples');
+    await promises.mkdir(examplesDir, {
+        recursive: true
+    });
+    for (const [apiId, example] of Object.entries(examples)){
+        await writeJson(node_path.join(examplesDir, `${apiId}.json`), example);
+    }
+    const count = Object.keys(examples).length;
+    log(`Wrote ${count} ${count === 1 ? 'example' : 'examples'} to ${node_path.join(dir, 'examples')}${improve.enabled ? ', with the A/B test or flag block (_improve.json): improve is on' : ''}.`);
+    if (await writeEnvExample(cwd, url)) {
+        log('Added the token variables to .env.example.');
+    }
+    if (shouldInstall) await install(cwd, log, run);
+    log([
+        '',
+        'Next:',
+        '- Create a delivery token (and a preview token for drafts) in Space settings, and set CONTENT_DELIVERY_TOKEN and CONTENT_PREVIEW_TOKEN.',
+        '- Fetch content with ContentClient from @obelism/content; the examples show what each type looks like.',
+        ...improve.enabled ? [
+            "- Render _improve blocks: ask improve's SDK for the visitor's option (getTestValue / getFlagValue with the block's slug) and render pickImproveVariant(block, option)."
+        ] : [],
+        `- Keep the model in step with \`content model pull|plan|apply\` (${node_path.join(dir, 'content-model.json')}).`
+    ].join('\n'));
+    return 0;
+};
 
-  pull    write the environment's model to the file
-  plan    show what applying the file would change, and what stands in the way
-  apply   apply the file in one transaction, or change nothing
+const USAGE = `Usage: content init [--dir content] [--url origin] [--skip-install]
+       content model <pull|plan|apply> [--file path] [--url origin] [--prune]
 
-  --file   the model file (default content/content-model.json)
-  --url    the CMS (default $CONTENT_URL, else ${config.DEFAULT_URL})
-  --prune  plan and apply also delete content types the file leaves out
+  init          start a site's repository on the token's environment: the
+                model file, an example per content type, the SDK installed
+                and the token variables in .env.example
+  model pull    write the environment's model to the file
+  model plan    show what applying the file would change, and what stands in the way
+  model apply   apply the file in one transaction, or change nothing
+
+  --dir           where init writes content-model.json and examples/ (default content)
+  --skip-install  init leaves dependencies alone
+  --file          the model file (default content/content-model.json)
+  --url           the CMS (default $CONTENT_URL, else ${config.DEFAULT_URL})
+  --prune         plan and apply also delete content types the file leaves out
 
 Needs CONTENT_MANAGEMENT_TOKEN: a management token from Space settings.`;
 const main = async ()=>{
@@ -174,6 +545,14 @@ const main = async ()=>{
                     type: 'boolean',
                     default: false
                 },
+                dir: {
+                    type: 'string',
+                    default: 'content'
+                },
+                'skip-install': {
+                    type: 'boolean',
+                    default: false
+                },
                 help: {
                     type: 'boolean',
                     short: 'h',
@@ -190,17 +569,26 @@ const main = async ()=>{
         console.log(USAGE);
         return 0;
     }
-    if (group !== 'model' || command !== 'pull' && command !== 'plan' && command !== 'apply') {
-        throw new CliError(USAGE, 2);
-    }
+    const isInit = group === 'init' && command === undefined;
+    const modelCommand = group === 'model' && (command === 'pull' || command === 'plan' || command === 'apply') ? command : null;
+    if (!isInit && !modelCommand) throw new CliError(USAGE, 2);
     const token = process.env.CONTENT_MANAGEMENT_TOKEN;
     if (!token) {
         throw new CliError(`CONTENT_MANAGEMENT_TOKEN is not set.\n\n${USAGE}`, 2);
     }
+    const url = config.normalizeUrl(values.url ?? process.env.CONTENT_URL ?? config.DEFAULT_URL);
+    if (!modelCommand) {
+        return runInitCommand({
+            url,
+            token,
+            dir: values.dir,
+            install: !values['skip-install']
+        });
+    }
     return runModelCommand({
-        command,
+        command: modelCommand,
         file: values.file,
-        url: config.normalizeUrl(values.url ?? process.env.CONTENT_URL ?? config.DEFAULT_URL),
+        url,
         token,
         prune: values.prune,
         summaryFile: process.env.GITHUB_STEP_SUMMARY || undefined

package/dist/bridge.d.mts

@@ -83,6 +83,7 @@ declare const DEFAULT_PROMPT_LABELS: PromptLabels;
 type PromptBoxOptions = {
     labels?: Partial<PromptLabels> | undefined;
 };
+declare const mountPromptBox: (doc: Document, bridge: ContentBridge, options?: PromptBoxOptions) => () => void;
 
 type BridgeOptions = {
     url?: string | undefined;
@@ -92,6 +93,6 @@ type BridgeOptions = {
 declare const peekContentBridge: () => ContentBridge | null;
 declare const getContentBridge: ({ url, prompt, pagePath, }?: BridgeOptions) => ContentBridge;
 
-export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, peekContentBridge };
+export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, mountPromptBox, peekContentBridge };
 export type { BridgeEvent, BridgeEvents, BridgeListener, BridgeOptions, BridgeState, ContentBridge, CreatePageResult, PromptBoxOptions, PromptLabels, PromptResult };
 //# sourceMappingURL=bridge.d.mts.map

package/dist/bridge.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.mts","sources":["../src/bridge/createBridge.ts","../src/bridge/promptBox.ts","../src/bridge.ts"],"mappings":";;AAIA,KAAK,YAAY;AACjB;AACA,eAAe,KAAK;AACpB;AACA;AACA,WAAW,MAAM;AACjB,eAAe,MAAM;AACrB,YAAY,WAAW;AACvB;AACA,KAAK,WAAW,SAAS,YAAY;AACrC,KAAK,cAAc,WAAW,WAAW,cAAc,YAAY;AACnE,KAAK,WAAW;AAChB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,YAAY;AACjB;AACA;AACA,KAAK,gBAAgB;AACrB;AACA;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA,iBAAiB,WAAW,sBAAsB,cAAc;AAChE,gBAAgB,WAAW;AAC3B;AACA;AACA,QAAQ,OAAO,CAAC,YAAY;AAC5B,8CAA8C,OAAO,CAAC,gBAAgB;AACtE;AACA,YAAY,OAAO;AACnB,eAAe,OAAO;AACtB;AACA;AACA;AACA;AACA;AAEA,cAAc,aAAa,EAAE,WAAW;;ACrDxC,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,qBAAqB,EAAE,YAAY;AACjD,KAAK,gBAAgB;AACrB,aAAa,OAAO,CAAC,YAAY;AACjC;;AC1BA,KAAK,aAAa;AAClB;AACA,uBAAuB,gBAAgB;AACvC;AACA;AACA,cAAc,iBAAiB,QAAQ,aAAa;AACpD,cAAc,gBAAgB,gCAAgC,aAAa,KAAK,aAAa","names":[]}
+{"version":3,"file":"bridge.d.mts","sources":["../src/bridge/createBridge.ts","../src/bridge/promptBox.ts","../src/bridge.ts"],"mappings":";;AAIA,KAAK,YAAY;AACjB;AACA,eAAe,KAAK;AACpB;AACA;AACA,WAAW,MAAM;AACjB,eAAe,MAAM;AACrB,YAAY,WAAW;AACvB;AACA,KAAK,WAAW,SAAS,YAAY;AACrC,KAAK,cAAc,WAAW,WAAW,cAAc,YAAY;AACnE,KAAK,WAAW;AAChB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,YAAY;AACjB;AACA;AACA,KAAK,gBAAgB;AACrB;AACA;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA,iBAAiB,WAAW,sBAAsB,cAAc;AAChE,gBAAgB,WAAW;AAC3B;AACA;AACA,QAAQ,OAAO,CAAC,YAAY;AAC5B,8CAA8C,OAAO,CAAC,gBAAgB;AACtE;AACA,YAAY,OAAO;AACnB,eAAe,OAAO;AACtB;AACA;AACA;AACA;AACA;AAEA,cAAc,aAAa,EAAE,WAAW;;ACrDxC,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,qBAAqB,EAAE,YAAY;AACjD,KAAK,gBAAgB;AACrB,aAAa,OAAO,CAAC,YAAY;AACjC;AACA,cAAc,cAAc,QAAQ,QAAQ,UAAU,aAAa,YAAY,gBAAgB;;AC3B/F,KAAK,aAAa;AAClB;AACA,uBAAuB,gBAAgB;AACvC;AACA;AACA,cAAc,iBAAiB,QAAQ,aAAa;AACpD,cAAc,gBAAgB,gCAAgC,aAAa,KAAK,aAAa","names":[]}

package/dist/bridge.d.ts

@@ -83,6 +83,7 @@ declare const DEFAULT_PROMPT_LABELS: PromptLabels;
 type PromptBoxOptions = {
     labels?: Partial<PromptLabels> | undefined;
 };
+declare const mountPromptBox: (doc: Document, bridge: ContentBridge, options?: PromptBoxOptions) => () => void;
 
 type BridgeOptions = {
     url?: string | undefined;
@@ -92,6 +93,6 @@ type BridgeOptions = {
 declare const peekContentBridge: () => ContentBridge | null;
 declare const getContentBridge: ({ url, prompt, pagePath, }?: BridgeOptions) => ContentBridge;
 
-export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, peekContentBridge };
+export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, mountPromptBox, peekContentBridge };
 export type { BridgeEvent, BridgeEvents, BridgeListener, BridgeOptions, BridgeState, ContentBridge, CreatePageResult, PromptBoxOptions, PromptLabels, PromptResult };
 //# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sources":["../src/bridge/createBridge.ts","../src/bridge/promptBox.ts","../src/bridge.ts"],"mappings":";;AAIA,KAAK,YAAY;AACjB;AACA,eAAe,KAAK;AACpB;AACA;AACA,WAAW,MAAM;AACjB,eAAe,MAAM;AACrB,YAAY,WAAW;AACvB;AACA,KAAK,WAAW,SAAS,YAAY;AACrC,KAAK,cAAc,WAAW,WAAW,cAAc,YAAY;AACnE,KAAK,WAAW;AAChB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,YAAY;AACjB;AACA;AACA,KAAK,gBAAgB;AACrB;AACA;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA,iBAAiB,WAAW,sBAAsB,cAAc;AAChE,gBAAgB,WAAW;AAC3B;AACA;AACA,QAAQ,OAAO,CAAC,YAAY;AAC5B,8CAA8C,OAAO,CAAC,gBAAgB;AACtE;AACA,YAAY,OAAO;AACnB,eAAe,OAAO;AACtB;AACA;AACA;AACA;AACA;AAEA,cAAc,aAAa,EAAE,WAAW;;ACrDxC,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,qBAAqB,EAAE,YAAY;AACjD,KAAK,gBAAgB;AACrB,aAAa,OAAO,CAAC,YAAY;AACjC;;AC1BA,KAAK,aAAa;AAClB;AACA,uBAAuB,gBAAgB;AACvC;AACA;AACA,cAAc,iBAAiB,QAAQ,aAAa;AACpD,cAAc,gBAAgB,gCAAgC,aAAa,KAAK,aAAa","names":[]}
+{"version":3,"file":"bridge.d.ts","sources":["../src/bridge/createBridge.ts","../src/bridge/promptBox.ts","../src/bridge.ts"],"mappings":";;AAIA,KAAK,YAAY;AACjB;AACA,eAAe,KAAK;AACpB;AACA;AACA,WAAW,MAAM;AACjB,eAAe,MAAM;AACrB,YAAY,WAAW;AACvB;AACA,KAAK,WAAW,SAAS,YAAY;AACrC,KAAK,cAAc,WAAW,WAAW,cAAc,YAAY;AACnE,KAAK,WAAW;AAChB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,YAAY;AACjB;AACA;AACA,KAAK,gBAAgB;AACrB;AACA;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA,iBAAiB,WAAW,sBAAsB,cAAc;AAChE,gBAAgB,WAAW;AAC3B;AACA;AACA,QAAQ,OAAO,CAAC,YAAY;AAC5B,8CAA8C,OAAO,CAAC,gBAAgB;AACtE;AACA,YAAY,OAAO;AACnB,eAAe,OAAO;AACtB;AACA;AACA;AACA;AACA;AAEA,cAAc,aAAa,EAAE,WAAW;;ACrDxC,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,qBAAqB,EAAE,YAAY;AACjD,KAAK,gBAAgB;AACrB,aAAa,OAAO,CAAC,YAAY;AACjC;AACA,cAAc,cAAc,QAAQ,QAAQ,UAAU,aAAa,YAAY,gBAAgB;;AC3B/F,KAAK,aAAa;AAClB;AACA,uBAAuB,gBAAgB;AACvC;AACA;AACA,cAAc,iBAAiB,QAAQ,aAAa;AACpD,cAAc,gBAAgB,gCAAgC,aAAa,KAAK,aAAa","names":[]}

package/dist/bridge.global.js

@@ -0,0 +1,158 @@
+!/*! Obelism Content bridge (@obelism/content), MIT. https://content.obelism.studio/docs/visual-editor */function(){"use strict";var e;let t="data-cms-uid",r="data-cms-entry",n="cms_environment",o="#d58a1f",a=(e="")=>`${e}[${t}]{cursor:pointer;transition:outline-color .15s}${e}[${t}]:hover{outline:2px dashed ${o};outline-offset:2px}${e}[${t}][data-cms-selected]{outline:2px solid ${o};outline-offset:2px}`,i={features:[],selectedUid:null,prompting:!1,canUndo:!1,unsaved:!1,saving:!1,publishing:!1,selecting:!1},s=()=>{let e={update:new Set,saved:new Set,published:new Set,change:new Set};return{listeners:e,on:(t,r)=>(e[t].add(r),()=>{e[t].delete(r)}),emit(t,r){for(let n of e[t])try{n(r)}catch(e){console.error("[@obelism/content bridge]",e)}}}},l=()=>Promise.reject(Error("Save and publish in the visual editor itself")),d={prompt:()=>Promise.reject(Error("Prompts only work inside the visual editor")),createPage:()=>Promise.reject(Error("New pages are made on the site itself")),undo:()=>{},save:l,publish:l,signOut:()=>{},select:()=>{},setSelecting:()=>{}},c=e=>`[${t}="${e.replace(/["\\]/g,"\\$&")}"]`,p=(e,t)=>{let r=s();e.on("saved",()=>r.emit("saved",{})),e.on("published",()=>r.emit("published",{}));let o=!1;return{isEditing:e.isEditing,mode:e.isEditing?"editor":null,entryId:e.entryId,environment:t.get(n),on:(t,n)=>("update"!==t||o||(o=!0,e.on("update",e=>{let t=e?.entry;t&&r.emit("update",{entry:t,selectedUid:null})})),r.on(t,n)),getState:()=>i,...d,destroy:()=>{}}},g={open:"Edit with a prompt",placeholder:"Describe a change, e.g. “make the heading shorter”",send:"Apply",undo:"Undo",close:"Close",scopeEntry:"Whole page",scopeBlock:"Selected block",clearBlock:"Edit the whole page instead",working:"Working on it…",save:"Save",publish:"Publish",saving:"Saving…",publishing:"Publishing…",saved:"Saved as a draft",published:"Published",unsaved:"Unsaved changes",signOut:"Exit editing",viewingDrafts:"Viewing drafts",selectHint:"Click a block to change only that block",newPage:"New page",newPageCancel:"Edit this page instead",newPagePlaceholder:"Describe the new page, e.g. “a pricing page for agencies”",path:"Path",pathPlaceholder:"/pricing",creating:"Writing the page…",created:"Opening the new page…"},u={page:'<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>',newPage:'<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M9 15h6"/><path d="M12 18v-6"/>',block:'<rect width="18" height="18" x="3" y="3" rx="2"/><path d="M7 8h10"/><path d="M7 12h6"/>',undo:'<path d="M9 14 4 9l5-5"/><path d="M4 9h10.5a5.5 5.5 0 0 1 0 11H11"/>',close:'<path d="M18 6 6 18"/><path d="m6 6 12 12"/>',send:'<path d="M3.714 3.048a.498.498 0 0 0-.683.627l2.843 7.627a2 2 0 0 1 0 1.396l-2.842 7.627a.498.498 0 0 0 .682.627l18-8.5a.5.5 0 0 0 0-.904z"/><path d="M6 12h16"/>'},h=`
+:host { all: initial; }
+* { box-sizing: border-box; font: inherit; color: inherit; margin: 0; }
+.root {
+	--color-white-rgb: 248 248 248; --color-beige-rgb: 238 236 233; --color-beige-off-rgb: 228 225 217;
+	--color-grey-light-rgb: 132 132 132; --color-grey-rgb: 108 108 108; --color-grey-mid-rgb: 100 100 100; --color-grey-dark-rgb: 40 40 40;
+	--color-black-off-rgb: 20 20 20; --color-black-rgb: 12 12 12;
+	--color-orange-rgb: 212 130 30; --color-red-rgb: 240 93 93;
+	--theme-foreground-rgb: var(--color-black-rgb);
+	--theme-background-alt-rgb: var(--color-white-rgb);
+	--theme-background-actions-rgb: var(--color-beige-off-rgb);
+	--theme-border-rgb: var(--color-grey-light-rgb);
+	--theme-accent-rgb: var(--color-orange-rgb);
+	--theme-foreground-muted-rgb: var(--color-grey-mid-rgb);
+	--theme-error: #b3261e;
+	--border-radius-medium: 20px; --border-radius-pill: 5em;
+	--ease-roll: cubic-bezier(0.65, 0, 0.35, 1);
+	--shadow: 0 18px 40px -16px rgb(var(--color-black-rgb) / .3), 0 2px 6px rgb(var(--color-black-rgb) / .05);
+	--font-inter: 'InterVariable', 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI',
+		Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif;
+	position: fixed; left: 50%; bottom: 20px; transform: translateX(-50%);
+	z-index: 2147483647; width: min(640px, calc(100vw - 32px)); color-scheme: light dark;
+	font: 400 14px/1.4 var(--font-inter); color: rgb(var(--theme-foreground-rgb));
+	-webkit-font-smoothing: antialiased;
+}
+@media (prefers-color-scheme: dark) {
+	.root {
+		--theme-foreground-rgb: var(--color-white-rgb);
+		--theme-background-alt-rgb: var(--color-black-off-rgb);
+		--theme-background-actions-rgb: var(--color-grey-dark-rgb);
+		--theme-border-rgb: var(--color-grey-rgb);
+		--theme-foreground-muted-rgb: var(--color-grey-light-rgb);
+		--theme-error: rgb(var(--color-red-rgb));
+		--shadow: 0 18px 40px -14px rgb(0 0 0 / .7), 0 2px 6px rgb(0 0 0 / .3);
+	}
+}
+.icon { display: inline-flex; flex: none; }
+.icon svg {
+	width: 16px; height: 16px; fill: none; stroke: currentColor; stroke-width: 1.75;
+	stroke-linecap: round; stroke-linejoin: round;
+}
+.visually-hidden {
+	position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap;
+}
+button { cursor: pointer; background: none; border: 0; padding: 0; }
+button:disabled { cursor: not-allowed; }
+button:focus-visible { outline: 2px solid rgb(var(--theme-accent-rgb)); outline-offset: 2px; }
+
+/* Closed: one floating pill that reads like an empty field, with the mark. */
+.bar { display: flex; justify-content: center; }
+.pill {
+	display: flex; align-items: center; gap: 12px; width: min(560px, 100%); height: 56px;
+	padding: 0 22px 0 26px; border-radius: var(--border-radius-pill);
+	background: rgb(var(--theme-background-alt-rgb));
+	border: 1px solid rgb(var(--theme-border-rgb) / .25); box-shadow: var(--shadow);
+	color: rgb(var(--theme-foreground-muted-rgb)); font-size: 16px; text-align: left;
+	transition: transform .25s var(--ease-roll), color .25s var(--ease-roll);
+}
+button.pill:hover { color: rgb(var(--theme-foreground-rgb)); transform: translateY(-2px); }
+.pill > span:first-child { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.mark { color: rgb(var(--theme-accent-rgb)); font-size: 22px; line-height: 1; }
+.pill.compact { width: auto; height: 40px; padding: 0 18px; font-size: 14px; gap: 4px; }
+
+/* Open: a floating card, the text on top and a row of pill buttons below. */
+.panel {
+	display: grid; background: rgb(var(--theme-background-alt-rgb));
+	border: 1px solid rgb(var(--theme-border-rgb) / .25); border-radius: var(--border-radius-medium);
+	box-shadow: var(--shadow); overflow: hidden;
+	transition: border-color .25s var(--ease-roll), box-shadow .25s var(--ease-roll);
+	animation: rise .25s var(--ease-roll);
+}
+.panel:focus-within {
+	border-color: rgb(var(--theme-accent-rgb) / .6);
+	box-shadow: 0 0 0 3px rgb(var(--theme-accent-rgb) / .18), var(--shadow);
+}
+@keyframes rise { from { opacity: 0; transform: translateY(8px) scale(.98); } }
+@keyframes spin { to { transform: rotate(1turn); } }
+@media (prefers-reduced-motion: reduce) {
+	.panel { animation: none; }
+	.pill { transition: none; }
+}
+.status {
+	padding: 16px 22px 0; font-size: 14px; color: rgb(var(--theme-foreground-muted-rgb));
+	display: flex; align-items: center; gap: 8px;
+}
+.status.working::before {
+	content: ''; width: 12px; height: 12px; flex: none; border-radius: 50%;
+	border: 2px solid rgb(var(--theme-border-rgb) / .3); border-top-color: rgb(var(--theme-accent-rgb));
+	animation: spin .7s linear infinite;
+}
+.status.error { color: var(--theme-error); }
+textarea {
+	display: block; width: 100%; resize: none; min-height: 76px; max-height: 200px;
+	padding: 16px 22px 6px; border: 0; outline: 0; background: transparent;
+	font-size: 16px; line-height: 1.6; color: rgb(var(--theme-foreground-rgb));
+}
+textarea::placeholder { color: rgb(var(--theme-foreground-muted-rgb)); }
+/* New page: where it goes, above what it is for. */
+.path {
+	display: flex; align-items: center; gap: 10px; padding: 16px 22px 0;
+	color: rgb(var(--theme-foreground-muted-rgb));
+}
+.path input {
+	flex: 1; min-width: 0; height: 34px; padding: 0 14px; outline: 0;
+	border: 1px solid rgb(var(--theme-border-rgb) / .25); border-radius: var(--border-radius-pill);
+	background: rgb(var(--theme-background-actions-rgb) / .45); color: rgb(var(--theme-foreground-rgb));
+	transition: border-color .25s var(--ease-roll);
+}
+.path input:focus-visible { border-color: rgb(var(--theme-accent-rgb)); }
+.path input::placeholder { color: rgb(var(--theme-foreground-muted-rgb)); }
+.path input:disabled { opacity: .5; }
+textarea:disabled { opacity: .5; }
+.toolbar { display: flex; align-items: center; gap: 6px; padding: 8px 12px 12px; }
+.spacer { flex: 1; }
+.chip {
+	display: inline-flex; align-items: center; gap: 6px; height: 34px; padding: .4em 1.1em .4em .9em;
+	border: 1px solid rgb(var(--theme-border-rgb) / .2); border-radius: var(--border-radius-pill);
+	background: rgb(var(--theme-background-actions-rgb) / .6); white-space: nowrap;
+	transition: background-color .25s var(--ease-roll);
+}
+button.chip:hover:not(:disabled) { background: rgb(var(--theme-background-actions-rgb)); }
+button.chip:disabled { opacity: .5; }
+.scope { min-width: 0; background: transparent; }
+.scope > span:not(.icon) { overflow: hidden; text-overflow: ellipsis; }
+.scope button {
+	display: inline-flex; margin-right: -6px; padding: 3px; border-radius: 50%;
+	color: rgb(var(--theme-foreground-muted-rgb));
+}
+.scope button:hover { background: rgb(var(--theme-background-actions-rgb)); color: rgb(var(--theme-foreground-rgb)); }
+.scope button svg { width: 14px; height: 14px; }
+.icon-button {
+	display: inline-flex; align-items: center; justify-content: center;
+	width: 34px; height: 34px; border-radius: 50%; color: rgb(var(--theme-foreground-muted-rgb));
+	transition: background-color .25s var(--ease-roll), color .25s var(--ease-roll), opacity .25s var(--ease-roll);
+}
+.icon-button:hover:not(:disabled) { background: rgb(var(--theme-background-actions-rgb)); color: rgb(var(--theme-foreground-rgb)); }
+/* The one call to action: white on orange. */
+.icon-button.primary { background: rgb(var(--theme-accent-rgb)); color: #fff; }
+.icon-button.primary:hover:not(:disabled) { background: rgb(var(--theme-accent-rgb)); color: #fff; opacity: .88; }
+.icon-button.primary:disabled { opacity: .35; }
+.divider { width: 1px; height: 20px; background: rgb(var(--theme-border-rgb) / .3); margin: 0 4px; }
+
+/* On the site: storing the draft, and the way out. */
+.footer {
+	display: flex; align-items: center; gap: 8px; padding: 10px 12px 10px 22px;
+	border-top: 1px solid rgb(var(--theme-border-rgb) / .2);
+	background: rgb(var(--theme-background-actions-rgb) / .45);
+}
+.footer .chip { height: 30px; padding: .4em 1.2em; background: rgb(var(--theme-background-alt-rgb)); }
+.unsaved { color: rgb(var(--theme-foreground-muted-rgb)); display: inline-flex; align-items: center; }
+.link { color: rgb(var(--theme-foreground-muted-rgb)); text-decoration: underline; text-underline-offset: 3px; padding: 0 6px; }
+.link:hover { color: rgb(var(--theme-foreground-rgb)); }
+.dot {
+	display: inline-block; width: 7px; height: 7px; border-radius: 50%;
+	background: rgb(var(--theme-accent-rgb)); margin-right: 8px;
+}
+[hidden] { display: none !important; }
+`,b=(e,t,r={},...n)=>{let o=e.createElement(t);for(let t of(Object.assign(o,r),n))o.appendChild("string"==typeof t?e.createTextNode(t):t);return o},m=(e,t)=>{let r=b(e,"span",{className:"icon"});return r.setAttribute("aria-hidden","true"),r.innerHTML=`<svg viewBox="0 0 24 24">${u[t]}</svg>`,r},f=(e,t,r={})=>{let n={...g,...r.labels},o=b(e,"div");o.setAttribute("data-obelism-content-prompt","");let a=o.attachShadow({mode:"open"}),i="site"===t.mode,s=b(e,"span",{textContent:n.open}),l=b(e,"button",{className:"pill",type:"button"},s,b(e,"span",{className:"mark",textContent:"⁜"})),d=b(e,"span",{className:"pill compact"},`${n.viewingDrafts} \xb7 `),c=b(e,"button",{className:"link",type:"button",textContent:n.signOut});d.appendChild(c);let p=b(e,"p",{className:"status"});p.setAttribute("role","status");let u=b(e,"textarea",{placeholder:n.placeholder,rows:1});u.setAttribute("aria-label",n.open);let f=m(e,"page"),v=m(e,"block"),y=b(e,"span"),x=b(e,"button",{type:"button",title:n.clearBlock});x.setAttribute("aria-label",n.clearBlock),x.appendChild(m(e,"close"));let w=b(e,"span",{className:"chip scope"},f,v,y,x),k=b(e,"button",{className:"action chip",type:"button"},m(e,"undo"),n.undo),E=b(e,"button",{className:"action chip",type:"button"},m(e,"newPage"),n.newPage),S=b(e,"button",{type:"button",title:n.newPageCancel});S.setAttribute("aria-label",n.newPageCancel),S.appendChild(m(e,"close"));let C=b(e,"span",{className:"chip scope"},m(e,"newPage"),b(e,"span",{textContent:n.newPage}),S),N=b(e,"input",{type:"text",placeholder:n.pathPlaceholder,autocomplete:"off",spellcheck:!1}),U=b(e,"label",{className:"path"},b(e,"span",{textContent:n.path}),N),P=b(e,"button",{className:"close icon-button",type:"button",title:n.close},m(e,"close"));P.setAttribute("aria-label",n.close);let L=b(e,"button",{className:"action primary icon-button",type:"submit"},b(e,"span",{className:"visually-hidden",textContent:n.send}),m(e,"send"));L.title=n.send;let $=b(e,"span",{className:"unsaved"});$.appendChild(b(e,"span",{className:"dot"})),$.appendChild(e.createTextNode(n.unsaved));let A=b(e,"button",{className:"link",type:"button",textContent:n.signOut}),O=b(e,"button",{className:"action chip",type:"button",textContent:n.save}),I=b(e,"button",{className:"action chip",type:"button",textContent:n.publish}),M=b(e,"div",{className:"footer"},$,b(e,"span",{className:"spacer"}),A,O,I),j=b(e,"form",{className:"panel"},p,U,u,b(e,"div",{className:"toolbar"},w,C,k,E,b(e,"span",{className:"spacer"}),P,b(e,"span",{className:"divider"}),L),M),R=b(e,"div",{className:"root"},b(e,"div",{className:"bar"},l,d),j);a.append(b(e,"style",{textContent:h}),R);let z=!1,D=!1,T=null,B=e=>{let r=e.features.includes("prompt"),o=e.saving||e.publishing,a=e.prompting||o;R.hidden=!r&&!i,l.hidden=z||!r,d.hidden=r||!i,j.hidden=!z||!r;let c=i&&e.features.includes("create"),g=i&&null===t.entryId,h=g&&c;c||(D=!1),h&&(D=!0),s.textContent=h?n.newPage:n.open,S.hidden=h,w.hidden=D,C.hidden=!D,E.hidden=D||!c,E.disabled=a,U.hidden=!D,N.disabled=a,u.placeholder=D?n.newPagePlaceholder:n.placeholder,y.textContent=e.selectedUid?n.scopeBlock:n.scopeEntry,x.hidden=!e.selectedUid,f.hidden=!!e.selectedUid,v.hidden=!e.selectedUid,k.hidden=D||!e.canUndo,k.disabled=a,L.disabled=a||""===u.value.trim()||D&&""===N.value.trim(),u.disabled=a,O.hidden=!e.features.includes("save")||g,O.disabled=a||!e.unsaved,O.textContent=e.saving?n.saving:n.save,I.hidden=!e.features.includes("publish")||g,I.disabled=a,I.textContent=e.publishing?n.publishing:n.publish,A.hidden=!i,M.hidden=!i,$.hidden=!e.unsaved;let b=e.prompting?D?n.creating:n.working:T?.text??(!i||D||e.selectedUid?"":n.selectHint);p.textContent=b,p.hidden=!b,p.className=`status${e.prompting?" working":""}${!a&&T?.error?" error":""}`},q=()=>B(t.getState()),H=()=>{u.style.height="auto",u.style.height=`${u.scrollHeight}px`},Y=async()=>{let e=u.value.trim();if(e&&!t.getState().prompting){T=null;try{if(D){let r=N.value.trim();if(!r)return N.focus();await t.createPage(r,e),T={text:n.created,error:!1}}else{let{summary:r}=await t.prompt(e);T={text:r,error:!1}}u.value="",H()}catch(e){T={text:e instanceof Error?e.message:String(e),error:!0}}q(),u.focus()}},_=e=>{z=e,q(),i&&t.setSelecting(z&&!D)},V=e=>{D=e,T=null,t.setSelecting(z&&!D),D&&t.select(null),q(),(D?N:u).focus()},W=async e=>{T=null;try{await t[e](),T={text:"save"===e?n.saved:n.published,error:!1}}catch(e){T={text:e instanceof Error?e.message:String(e),error:!0}}q()};l.addEventListener("click",()=>{_(!0),(D?N:u).focus()}),P.addEventListener("click",()=>_(!1)),O.addEventListener("click",()=>void W("save")),I.addEventListener("click",()=>void W("publish")),A.addEventListener("click",()=>t.signOut()),c.addEventListener("click",()=>t.signOut()),x.addEventListener("click",()=>t.select(null)),E.addEventListener("click",()=>V(!0)),S.addEventListener("click",()=>V(!1)),N.addEventListener("input",q),N.addEventListener("keydown",e=>{"Enter"!==e.key||e.isComposing?"Escape"===e.key&&_(!1):(e.preventDefault(),u.focus())}),k.addEventListener("click",()=>{T=null,t.undo()}),j.addEventListener("submit",e=>{e.preventDefault(),Y()}),u.addEventListener("input",()=>{H(),q()}),u.addEventListener("keydown",e=>{"Enter"!==e.key||e.shiftKey||e.isComposing?"Escape"===e.key&&_(!1):(e.preventDefault(),Y())});let F=t.on("change",B);return q(),e.body.appendChild(o),()=>{F(),o.remove()}},v="https://content.obelism.studio",y=(e,t)=>JSON.stringify(e)===JSON.stringify(t),x=Symbol.for("@obelism/content/bridge"),w=p({isEditing:!1,entryId:null,on:()=>{}},new URLSearchParams),k=({url:e,prompt:o=!0,pagePath:l}={})=>{let g;if("u"<typeof window)return w;let u=window;if(u[x])return u[x];if(u.ObelismBridge)g=p(u.ObelismBridge,new URLSearchParams(u.location.search));else{let p=(g=((e,r)=>{let o=new URLSearchParams(e.location.search),l=e.parent!==e&&o.has("cms_preview"),p=s(),g=[],u={...i,selecting:!0},h=e=>{u={...u,...e},p.emit("change",u)},b={isEditing:l,mode:l?"editor":null,entryId:o.get("cms_entry"),environment:o.get(n),on:p.on,getState:()=>u,...d,destroy:()=>{g.splice(0).forEach(e=>e())}};if(!l)return b;let m=e.document,f=(t,n={})=>{e.parent.postMessage({source:"obelism-content-bridge",type:t,...n},r)},v=m.createElement("style");v.textContent=a(),m.head.appendChild(v),g.push(()=>v.remove());let y=(e,t)=>{if(m.querySelectorAll("[data-cms-selected]").forEach(e=>{e.removeAttribute("data-cms-selected")}),u.selectedUid!==(e??null)&&h({selectedUid:e??null}),!e)return;let r=m.querySelector(c(e));r&&(r.setAttribute("data-cms-selected",""),t&&r.scrollIntoView({behavior:"smooth",block:"center"}))},x=e=>{let r=e.target,n=r?.closest?.(`[${t}]`);if(!n)return;e.preventDefault(),e.stopPropagation();let o=n.getAttribute(t);y(o,!1),f("select",{uid:o})};m.addEventListener("click",x,!0),g.push(()=>m.removeEventListener("click",x,!0));let w=()=>f("ready",{url:e.location.href}),k=new Map,E=0,S=e=>{let t=k.get(e);return t?(clearTimeout(t.timer),k.delete(e),0===k.size&&h({prompting:!1}),t):null};b.prompt=(e,t={})=>{let r=e.trim();if(!r)return Promise.reject(Error("Say what to change"));if(!u.features.includes("prompt"))return Promise.reject(Error("The editor does not offer prompts here"));let n=`prompt_${++E}`,o=void 0===t.uid?u.selectedUid:t.uid;return new Promise((e,t)=>{let a=setTimeout(()=>{S(n)?.reject(Error("The editor did not answer in time"))},12e4);k.set(n,{resolve:e,reject:t,timer:a}),h({prompting:!0}),f("prompt",{id:n,prompt:r,uid:o})})},b.undo=()=>f("undo"),b.select=e=>{y(e,!1),f("select",{uid:e})},g.push(()=>{for(let e of k.keys())S(e)?.reject(Error("The bridge was destroyed"))});let C=t=>{if(t.origin!==r||t.source!==e.parent)return;let n=t.data;if(n&&"obelism-content-editor"===n.source){if("connect"===n.type)w();else if("update"===n.type&&n.entry)p.emit("update",{entry:n.entry,selectedUid:n.selectedUid??null}),e.requestAnimationFrame(()=>y(n.selectedUid,!1));else if("select"===n.type)y(n.uid,!0);else if("saved"===n.type||"published"===n.type)p.emit(n.type,{}),0===p.listeners.update.size&&e.location.reload();else if("features"===n.type&&Array.isArray(n.features))h({features:n.features.filter(e=>"string"==typeof e)});else if("promptState"===n.type)h({canUndo:!0===n.canUndo});else if("promptResult"===n.type&&"string"==typeof n.id){let e=S(n.id);if(!e)return;!0===n.ok?e.resolve({summary:"string"==typeof n.summary?n.summary:""}):e.reject(Error("string"==typeof n.error?n.error:"The prompt failed"))}}};return e.addEventListener("message",C),g.push(()=>e.removeEventListener("message",C)),"loading"===m.readyState?(m.addEventListener("DOMContentLoaded",w,{once:!0}),g.push(()=>m.removeEventListener("DOMContentLoaded",w))):w(),b})(u,new URL(e||v).origin)).isEditing||u.parent!==u?null:(e=>{for(let t of e.cookie.split(";")){let[e,...r]=t.trim().split("=");if("obelism_content_editing"===e)try{let e=decodeURIComponent(r.join("="));return e.startsWith("/")&&!e.startsWith("//")?e:null}catch{break}}return null})(u.document);if(p&&(g=((e,n,{pagePath:o=e=>`/${e}`}={})=>{let l=e.document,d=s(),p=[],g=new Map,u=[],h=new Set,b=null,m=i,f=e=>{m={...m,...e},d.emit("change",m)},v=()=>f({unsaved:[...g.values()].some(({content:e,saved:t})=>!y(e,t)),canUndo:u.length>0}),x=async(t,r)=>{let o=await e.fetch(`${n}/api/${t}`,void 0===r?{credentials:"same-origin"}:{method:"POST",credentials:"same-origin",headers:{"Content-Type":"application/json","x-obelism-content":"1"},body:JSON.stringify(r)}),a=await o.json().catch(()=>({}));if(401===o.status)throw f({features:[]}),Error("You were signed out. Sign in again to edit.");if(!o.ok)throw Error("string"==typeof a.error?a.error:`Obelism Content answered ${o.status}`);return a},w=()=>l.querySelector(`[${r}]`)?.getAttribute(r)??null,k=()=>{if(!b)return;let e=b.space.locales.map(({code:e})=>e),t=l.documentElement.lang;if(e.includes(t))return t;let r=t.split("-")[0]??"";return e.includes(r)?r:b.space.defaultLocale},E=async e=>{let t=g.get(e);if(t)return t;let r=await x(`entries/${encodeURIComponent(e)}`),n={content:r.content,saved:r.content,revision:r.draftRevision};return g.set(e,n),n},S=e=>{l.querySelectorAll("[data-cms-selected]").forEach(e=>{e.removeAttribute("data-cms-selected")}),m.selectedUid!==e&&f({selectedUid:e}),e&&l.querySelector(c(e))?.setAttribute("data-cms-selected","")},C=async t=>{if(0===d.listeners.update.size)return;let r=g.get(t)?.content,{entry:n}=await x(`entries/${encodeURIComponent(t)}/preview`,{content:r,locale:k()});d.emit("update",{entry:n,selectedUid:m.selectedUid}),e.requestAnimationFrame(()=>S(m.selectedUid))},N=t=>{d.emit(t,{}),0===d.listeners.update.size&&e.location.reload()},U=async()=>{for(let[e,t]of g){if(y(t.content,t.saved))continue;let{draftRevision:r}=await x(`entries/${encodeURIComponent(e)}/save`,{content:t.content,baseRevision:t.revision});t.saved=t.content,t.revision=r,h.add(e)}u.length=0,v()},P={isEditing:!0,mode:"site",get entryId(){return w()},environment:null,on:d.on,getState:()=>m,async prompt(e,t={}){let n,o=e.trim();if(!o)throw Error("Say what to change");if(!m.features.includes("prompt"))throw Error("You may not edit content here");let a=void 0===t.uid?m.selectedUid:t.uid,i=(n=a?l.querySelector(c(a)):null,n?.closest(`[${r}]`)?.getAttribute(r)??w());if(!i)throw Error("Nothing on this page is marked as an entry: add editable(entry)");f({prompting:!0});try{let e=await E(i),t=await x(`entries/${encodeURIComponent(i)}/prompt`,{prompt:o,content:e.content,locale:k(),uid:a});return u.push({entryId:i,content:e.content}),e.content=t.content,v(),await C(i),{summary:t.summary}}finally{f({prompting:!1})}},async createPage(t,r){let n=r.trim();if(!n)throw Error("Say what the page is for");if(!t.trim())throw Error("Say where the page goes, like /pricing");if(!m.features.includes("create"))throw Error("You may not add pages here");if(m.unsaved)throw Error("Save or undo your changes before adding a page");f({prompting:!0});try{let r=await x("entries",{path:t,prompt:n,locale:k(),from:w()}),a=o(r.path);return e.location.assign(a),{summary:r.summary,entryId:r.entryId,path:r.path,url:a}}finally{f({prompting:!1})}},undo(){let e=u.pop(),t=e&&g.get(e.entryId);e&&t&&(t.content=e.content,v(),C(e.entryId).catch(e=>console.error("[@obelism/content bridge]",e)))},async save(){if(!m.features.includes("save"))throw Error("You may not edit content here");f({saving:!0});try{await U()}finally{f({saving:!1})}N("saved")},async publish(){if(!m.features.includes("publish"))throw Error("You may not publish here");f({publishing:!0});try{await U();let e=w(),t=h.size>0?[...h]:e?[e]:[];if(0===t.length)throw Error("Nothing on this page is marked as an entry: add editable(entry)");for(let e of t)await x(`entries/${encodeURIComponent(e)}/publish`,{}),h.delete(e)}finally{f({publishing:!1})}N("published")},signOut(){if(m.unsaved&&!e.confirm("Sign out and lose the changes you have not saved?"))return;g.clear(),v();let t=e.location.pathname+e.location.search;e.location.href=`${n}/logout?return_to=${encodeURIComponent(t)}`},select(e){S(e)},setSelecting(e){e?l.documentElement.setAttribute("data-cms-selecting",""):l.documentElement.removeAttribute("data-cms-selecting"),f({selecting:e})},destroy(){p.splice(0).forEach(e=>e())}},L=l.createElement("style");L.textContent=a("html[data-cms-selecting] "),l.head.appendChild(L),p.push(()=>L.remove()),p.push(()=>l.documentElement.removeAttribute("data-cms-selecting"));let $=e=>{if(!m.selecting)return;let r=e.target,n=r?.closest?.(`[${t}]`);n&&(e.preventDefault(),e.stopPropagation(),S(n.getAttribute(t)))};l.addEventListener("click",$,!0),p.push(()=>l.removeEventListener("click",$,!0));let A=e=>{m.unsaved&&(e.preventDefault(),e.returnValue="")};return e.addEventListener("beforeunload",A),p.push(()=>e.removeEventListener("beforeunload",A)),x("session").then(e=>{b=e,f({features:e.features})}).catch(e=>console.error("[@obelism/content bridge]",e)),P})(u,p,{pagePath:l})),g.isEditing&&o){let e=f(u.document,g,!0===o?{}:o),t=g.destroy;g.destroy=()=>{e(),t()}}}return u[x]=g,g};(e=window).ObelismBridge=k((e=>{let t=e?.dataset.url,r=t||v;if(!t&&e?.src){let t=new URL(e.src);"/bridge.js"===t.pathname&&(r=t.origin)}return{url:r,prompt:e?.dataset.prompt!=="false"}})(document.currentScript)),e.ObelismContent={getContentBridge:k,mountPromptBox:f}}();

package/dist/bridge.js

@@ -1192,4 +1192,5 @@ const getContentBridge = ({ url, prompt = true, pagePath } = {})=>{
 exports.DEFAULT_PROMPT_LABELS = DEFAULT_PROMPT_LABELS;
 exports.INITIAL_STATE = INITIAL_STATE;
 exports.getContentBridge = getContentBridge;
+exports.mountPromptBox = mountPromptBox;
 exports.peekContentBridge = peekContentBridge;

package/dist/bridge.mjs

@@ -1187,4 +1187,4 @@ const getContentBridge = ({ url, prompt = true, pagePath } = {})=>{
     return bridge;
 };
 
-export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, peekContentBridge };
+export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, mountPromptBox, peekContentBridge };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { R as RichTextFormat, E as Entry, a as EntryList, M as ModelFile, A as Asset, b as EntryStub, c as RichTextNode } from './types-pa96z6po.js';
-export { B as Block, C as ContentTypeDefinition, d as ContentTypeKind, e as Environment, F as FieldDefinition, f as FieldType, g as RichTextDocument, h as RichTextMark } from './types-pa96z6po.js';
+import { R as RichTextFormat, E as Entry, a as EntryList, M as ModelFile, A as Asset, B as Block, I as ImproveBlock, b as EntryStub, c as RichTextNode } from './types-nyvor49r.js';
+export { C as ContentTypeDefinition, d as ContentTypeKind, e as Environment, F as FieldDefinition, f as FieldType, g as RichTextDocument, h as RichTextMark } from './types-nyvor49r.js';
 
 type ContentClientOptions = {
     token: string;
@@ -66,6 +66,10 @@ type ImageTransform = {
 declare const imageUrl: (asset: Pick<Asset, "url"> | string, transform?: ImageTransform) => string;
 declare const imageSrcSet: (asset: Pick<Asset, "url"> | string, widths: number[], transform?: Omit<ImageTransform, "w">) => string;
 
+declare const IMPROVE_BLOCK = "_improve";
+declare const isImproveBlock: (block: Block) => block is ImproveBlock;
+declare const pickImproveVariant: <TBlock extends Block>(block: ImproveBlock<TBlock>, option: string | null | undefined, fallback?: string) => TBlock[];
+
 declare const PREVIEW_PARAMS: {
     readonly preview: "cms_preview";
     readonly entry: "cms_entry";
@@ -88,6 +92,6 @@ declare const richTextToHtml: (doc: RichTextNode | null | undefined, { renderEnt
 declare const headingLevel: (node: RichTextNode) => 1 | 2 | 3 | 4 | 5 | 6;
 declare const richTextToPlainText: (doc: RichTextNode | null | undefined) => string;
 
-export { Asset, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, ModelFile, PREVIEW_PARAMS, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, readPreviewParams, richTextToHtml, richTextToPlainText };
+export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, ModelFile, PREVIEW_PARAMS, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, isImproveBlock, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText };
 export type { ContentClientOptions, EntriesQuery, ImageTransform, PreviewParams, RequestOptions, RichTextHtmlOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/preview.ts","../src/richText.ts"],"mappings":";;;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA;AACA,eAAe,cAAc;AAC7B;AACA,WAAW,WAAW;AACtB,mBAAmB,KAAK;AACxB;AACA,KAAK,cAAc;AACnB;AACA;AACA,eAAe,cAAc;AAC7B,WAAW,WAAW;AACtB;AACA,KAAK,YAAY,GAAG,cAAc;AAClC;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA;AACA,2FAA2F,oBAAoB;AAC/G,6BAA6B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO;AAC9F,8BAA8B,KAAK,GAAG,KAAK,wBAAwB,cAAc,KAAK,OAAO;AAC7F,gCAAgC,KAAK,GAAG,KAAK,yDAAyD,YAAY,KAAK,OAAO,CAAC,SAAS;AACxI,iCAAiC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,YAAY,cAAc;AACnG,gCAAgC,IAAI,CAAC,cAAc,cAAc,OAAO,CAAC,SAAS;AAClF;;AChCA,cAAc,WAAW;;ACAzB,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,KAAK,QAAQ;AACb;AACA;AACA;AACA,cAAc,QAAQ;AACtB;AACA;AACA;AACA;AACA,yBAAyB,QAAQ;;ACXjC,cAAc,eAAe,SAAS,KAAK;AAC3C;AACA;AACA;AACA;AACA;;ACJA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,QAAQ,UAAU,IAAI,CAAC,KAAK,+BAA+B,cAAc;AACvF,cAAc,WAAW,UAAU,IAAI,CAAC,KAAK,iDAAiD,IAAI,CAAC,cAAc;;ACTjH,cAAc,cAAc;AAC5B;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA,KAAK,iBAAiB,GAAG,GAAG,GAAG,eAAe,YAAY,MAAM;AAChE,cAAc,iBAAiB,UAAU,iBAAiB,KAAK,aAAa;;ACT5E,cAAc,SAAS,EAAE,MAAM;AAC/B,cAAc,UAAU;AACxB,KAAK,mBAAmB;AACxB,0BAA0B,KAAK,GAAG,SAAS,QAAQ,YAAY;AAC/D,0BAA0B,KAAK,QAAQ,YAAY;AACnD;AACA,cAAc,cAAc,QAAQ,YAAY,oDAAoD,mBAAmB;AACvH,cAAc,YAAY,SAAS,YAAY;AAC/C,cAAc,mBAAmB,QAAQ,YAAY;;","names":[]}
+{"version":3,"file":"index.d.mts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/preview.ts","../src/richText.ts"],"mappings":";;;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA;AACA,eAAe,cAAc;AAC7B;AACA,WAAW,WAAW;AACtB,mBAAmB,KAAK;AACxB;AACA,KAAK,cAAc;AACnB;AACA;AACA,eAAe,cAAc;AAC7B,WAAW,WAAW;AACtB;AACA,KAAK,YAAY,GAAG,cAAc;AAClC;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA;AACA,2FAA2F,oBAAoB;AAC/G,6BAA6B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO;AAC9F,8BAA8B,KAAK,GAAG,KAAK,wBAAwB,cAAc,KAAK,OAAO;AAC7F,gCAAgC,KAAK,GAAG,KAAK,yDAAyD,YAAY,KAAK,OAAO,CAAC,SAAS;AACxI,iCAAiC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,YAAY,cAAc;AACnG,gCAAgC,IAAI,CAAC,cAAc,cAAc,OAAO,CAAC,SAAS;AAClF;;AChCA,cAAc,WAAW;;ACAzB,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,KAAK,QAAQ;AACb;AACA;AACA;AACA,cAAc,QAAQ;AACtB;AACA;AACA;AACA;AACA,yBAAyB,QAAQ;;ACXjC,cAAc,eAAe,SAAS,KAAK;AAC3C;AACA;AACA;AACA;AACA;;ACJA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,QAAQ,UAAU,IAAI,CAAC,KAAK,+BAA+B,cAAc;AACvF,cAAc,WAAW,UAAU,IAAI,CAAC,KAAK,iDAAiD,IAAI,CAAC,cAAc;;ACRjH,cAAc,aAAa;AAC3B,cAAc,cAAc,UAAU,KAAK,cAAc,YAAY;AACrE,cAAc,kBAAkB,kBAAkB,KAAK,SAAS,YAAY;;ACH5E,cAAc,cAAc;AAC5B;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA,KAAK,iBAAiB,GAAG,GAAG,GAAG,eAAe,YAAY,MAAM;AAChE,cAAc,iBAAiB,UAAU,iBAAiB,KAAK,aAAa;;ACT5E,cAAc,SAAS,EAAE,MAAM;AAC/B,cAAc,UAAU;AACxB,KAAK,mBAAmB;AACxB,0BAA0B,KAAK,GAAG,SAAS,QAAQ,YAAY;AAC/D,0BAA0B,KAAK,QAAQ,YAAY;AACnD;AACA,cAAc,cAAc,QAAQ,YAAY,oDAAoD,mBAAmB;AACvH,cAAc,YAAY,SAAS,YAAY;AAC/C,cAAc,mBAAmB,QAAQ,YAAY;;","names":[]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as RichTextFormat, E as Entry, a as EntryList, M as ModelFile, A as Asset, b as EntryStub, c as RichTextNode } from './types-pa96z6po.js';
-export { B as Block, C as ContentTypeDefinition, d as ContentTypeKind, e as Environment, F as FieldDefinition, f as FieldType, g as RichTextDocument, h as RichTextMark } from './types-pa96z6po.js';
+import { R as RichTextFormat, E as Entry, a as EntryList, M as ModelFile, A as Asset, B as Block, I as ImproveBlock, b as EntryStub, c as RichTextNode } from './types-nyvor49r.js';
+export { C as ContentTypeDefinition, d as ContentTypeKind, e as Environment, F as FieldDefinition, f as FieldType, g as RichTextDocument, h as RichTextMark } from './types-nyvor49r.js';
 
 type ContentClientOptions = {
     token: string;
@@ -66,6 +66,10 @@ type ImageTransform = {
 declare const imageUrl: (asset: Pick<Asset, "url"> | string, transform?: ImageTransform) => string;
 declare const imageSrcSet: (asset: Pick<Asset, "url"> | string, widths: number[], transform?: Omit<ImageTransform, "w">) => string;
 
+declare const IMPROVE_BLOCK = "_improve";
+declare const isImproveBlock: (block: Block) => block is ImproveBlock;
+declare const pickImproveVariant: <TBlock extends Block>(block: ImproveBlock<TBlock>, option: string | null | undefined, fallback?: string) => TBlock[];
+
 declare const PREVIEW_PARAMS: {
     readonly preview: "cms_preview";
     readonly entry: "cms_entry";
@@ -88,6 +92,6 @@ declare const richTextToHtml: (doc: RichTextNode | null | undefined, { renderEnt
 declare const headingLevel: (node: RichTextNode) => 1 | 2 | 3 | 4 | 5 | 6;
 declare const richTextToPlainText: (doc: RichTextNode | null | undefined) => string;
 
-export { Asset, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, ModelFile, PREVIEW_PARAMS, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, readPreviewParams, richTextToHtml, richTextToPlainText };
+export { Asset, Block, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, IMPROVE_BLOCK, ImproveBlock, ModelFile, PREVIEW_PARAMS, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, isImproveBlock, pickImproveVariant, readPreviewParams, richTextToHtml, richTextToPlainText };
 export type { ContentClientOptions, EntriesQuery, ImageTransform, PreviewParams, RequestOptions, RichTextHtmlOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/preview.ts","../src/richText.ts"],"mappings":";;;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA;AACA,eAAe,cAAc;AAC7B;AACA,WAAW,WAAW;AACtB,mBAAmB,KAAK;AACxB;AACA,KAAK,cAAc;AACnB;AACA;AACA,eAAe,cAAc;AAC7B,WAAW,WAAW;AACtB;AACA,KAAK,YAAY,GAAG,cAAc;AAClC;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA;AACA,2FAA2F,oBAAoB;AAC/G,6BAA6B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO;AAC9F,8BAA8B,KAAK,GAAG,KAAK,wBAAwB,cAAc,KAAK,OAAO;AAC7F,gCAAgC,KAAK,GAAG,KAAK,yDAAyD,YAAY,KAAK,OAAO,CAAC,SAAS;AACxI,iCAAiC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,YAAY,cAAc;AACnG,gCAAgC,IAAI,CAAC,cAAc,cAAc,OAAO,CAAC,SAAS;AAClF;;AChCA,cAAc,WAAW;;ACAzB,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,KAAK,QAAQ;AACb;AACA;AACA;AACA,cAAc,QAAQ;AACtB;AACA;AACA;AACA;AACA,yBAAyB,QAAQ;;ACXjC,cAAc,eAAe,SAAS,KAAK;AAC3C;AACA;AACA;AACA;AACA;;ACJA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,QAAQ,UAAU,IAAI,CAAC,KAAK,+BAA+B,cAAc;AACvF,cAAc,WAAW,UAAU,IAAI,CAAC,KAAK,iDAAiD,IAAI,CAAC,cAAc;;ACTjH,cAAc,cAAc;AAC5B;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA,KAAK,iBAAiB,GAAG,GAAG,GAAG,eAAe,YAAY,MAAM;AAChE,cAAc,iBAAiB,UAAU,iBAAiB,KAAK,aAAa;;ACT5E,cAAc,SAAS,EAAE,MAAM;AAC/B,cAAc,UAAU;AACxB,KAAK,mBAAmB;AACxB,0BAA0B,KAAK,GAAG,SAAS,QAAQ,YAAY;AAC/D,0BAA0B,KAAK,QAAQ,YAAY;AACnD;AACA,cAAc,cAAc,QAAQ,YAAY,oDAAoD,mBAAmB;AACvH,cAAc,YAAY,SAAS,YAAY;AAC/C,cAAc,mBAAmB,QAAQ,YAAY;;","names":[]}
+{"version":3,"file":"index.d.ts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/improve.ts","../src/preview.ts","../src/richText.ts"],"mappings":";;;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA;AACA,eAAe,cAAc;AAC7B;AACA,WAAW,WAAW;AACtB,mBAAmB,KAAK;AACxB;AACA,KAAK,cAAc;AACnB;AACA;AACA,eAAe,cAAc;AAC7B,WAAW,WAAW;AACtB;AACA,KAAK,YAAY,GAAG,cAAc;AAClC;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA;AACA,2FAA2F,oBAAoB;AAC/G,6BAA6B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO;AAC9F,8BAA8B,KAAK,GAAG,KAAK,wBAAwB,cAAc,KAAK,OAAO;AAC7F,gCAAgC,KAAK,GAAG,KAAK,yDAAyD,YAAY,KAAK,OAAO,CAAC,SAAS;AACxI,iCAAiC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,YAAY,cAAc;AACnG,gCAAgC,IAAI,CAAC,cAAc,cAAc,OAAO,CAAC,SAAS;AAClF;;AChCA,cAAc,WAAW;;ACAzB,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,KAAK,QAAQ;AACb;AACA;AACA;AACA,cAAc,QAAQ;AACtB;AACA;AACA;AACA;AACA,yBAAyB,QAAQ;;ACXjC,cAAc,eAAe,SAAS,KAAK;AAC3C;AACA;AACA;AACA;AACA;;ACJA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,QAAQ,UAAU,IAAI,CAAC,KAAK,+BAA+B,cAAc;AACvF,cAAc,WAAW,UAAU,IAAI,CAAC,KAAK,iDAAiD,IAAI,CAAC,cAAc;;ACRjH,cAAc,aAAa;AAC3B,cAAc,cAAc,UAAU,KAAK,cAAc,YAAY;AACrE,cAAc,kBAAkB,kBAAkB,KAAK,SAAS,YAAY;;ACH5E,cAAc,cAAc;AAC5B;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA,KAAK,iBAAiB,GAAG,GAAG,GAAG,eAAe,YAAY,MAAM;AAChE,cAAc,iBAAiB,UAAU,iBAAiB,KAAK,aAAa;;ACT5E,cAAc,SAAS,EAAE,MAAM;AAC/B,cAAc,UAAU;AACxB,KAAK,mBAAmB;AACxB,0BAA0B,KAAK,GAAG,SAAS,QAAQ,YAAY;AAC/D,0BAA0B,KAAK,QAAQ,YAAY;AACnD;AACA,cAAc,cAAc,QAAQ,YAAY,oDAAoD,mBAAmB;AACvH,cAAc,YAAY,SAAS,YAAY;AAC/C,cAAc,mBAAmB,QAAQ,YAAY;;","names":[]}

package/dist/index.js

@@ -171,6 +171,20 @@ const imageSrcSet = (asset, widths, transform = {})=>widths.map((w)=>`${imageUrl
             w
         })} ${w}w`).join(', ');
 
+const IMPROVE_BLOCK = '_improve';
+const isImproveBlock = (block)=>block._type === IMPROVE_BLOCK;
+// The blocks to render for an improve block: the variant of `option`, what
+// improve's SDK returned for the visitor (getTestValue / getFlagValue). It
+// is null when the test or flag isn't active or the visitor isn't in it;
+// then, or for an option the block has no variant for, the `fallback`
+// option's variant, else the first one (usually the control).
+const pickImproveVariant = (block, option, fallback)=>{
+    const variants = block.variants ?? {};
+    if (option && variants[option]) return variants[option];
+    if (fallback && variants[fallback]) return variants[fallback];
+    return Object.values(variants)[0] ?? [];
+};
+
 // Links are only rendered for these; anything else (`javascript:` …) keeps its
 // text without the link. The same rule the CMS validates with.
 const SAFE_HREF = /^(https?:\/\/|mailto:|tel:|#|\/(?!\/))/i;
@@ -291,10 +305,13 @@ exports.editable = preview.editable;
 exports.readPreviewParams = preview.readPreviewParams;
 exports.ContentApiError = ContentApiError;
 exports.ContentClient = ContentClient;
+exports.IMPROVE_BLOCK = IMPROVE_BLOCK;
 exports.SAFE_HREF = SAFE_HREF;
 exports.escapeHtml = escapeHtml;
 exports.headingLevel = headingLevel;
 exports.imageSrcSet = imageSrcSet;
 exports.imageUrl = imageUrl;
+exports.isImproveBlock = isImproveBlock;
+exports.pickImproveVariant = pickImproveVariant;
 exports.richTextToHtml = richTextToHtml;
 exports.richTextToPlainText = richTextToPlainText;

package/dist/index.mjs

@@ -169,6 +169,20 @@ const imageSrcSet = (asset, widths, transform = {})=>widths.map((w)=>`${imageUrl
             w
         })} ${w}w`).join(', ');
 
+const IMPROVE_BLOCK = '_improve';
+const isImproveBlock = (block)=>block._type === IMPROVE_BLOCK;
+// The blocks to render for an improve block: the variant of `option`, what
+// improve's SDK returned for the visitor (getTestValue / getFlagValue). It
+// is null when the test or flag isn't active or the visitor isn't in it;
+// then, or for an option the block has no variant for, the `fallback`
+// option's variant, else the first one (usually the control).
+const pickImproveVariant = (block, option, fallback)=>{
+    const variants = block.variants ?? {};
+    if (option && variants[option]) return variants[option];
+    if (fallback && variants[fallback]) return variants[fallback];
+    return Object.values(variants)[0] ?? [];
+};
+
 // Links are only rendered for these; anything else (`javascript:` …) keeps its
 // text without the link. The same rule the CMS validates with.
 const SAFE_HREF = /^(https?:\/\/|mailto:|tel:|#|\/(?!\/))/i;
@@ -281,4 +295,4 @@ const richTextToPlainText = (doc)=>{
     return parts.join('').replace(/\n+/g, '\n').trim();
 };
 
-export { ContentApiError, ContentClient, DEFAULT_URL, SAFE_HREF, escapeHtml, headingLevel, imageSrcSet, imageUrl, richTextToHtml, richTextToPlainText };
+export { ContentApiError, ContentClient, DEFAULT_URL, IMPROVE_BLOCK, SAFE_HREF, escapeHtml, headingLevel, imageSrcSet, imageUrl, isImproveBlock, pickImproveVariant, richTextToHtml, richTextToPlainText };

package/dist/{types-pa96z6po.d.ts → types-nyvor49r.d.ts}

@@ -30,6 +30,11 @@ type Block<TFields extends Record<string, unknown> = Record<string, unknown>, TT
     _uid: string;
     _type: TType;
 } & TFields;
+type ImproveBlock<TBlock extends Block = Block> = Block<{
+    kind: 'test' | 'flag';
+    slug: string;
+    variants: Record<string, TBlock[]>;
+}, '_improve'>;
 type RichTextMark = {
     type: 'bold' | 'italic' | 'underline' | 'strike' | 'code' | 'link' | string;
     attrs?: Record<string, unknown>;
@@ -116,5 +121,5 @@ type ModelFile = {
     contentTypes: ContentTypeDefinition[];
 };
 
-export type { Asset as A, Block as B, ContentTypeDefinition as C, Entry as E, FieldDefinition as F, ModelFile as M, RichTextFormat as R, EntryList as a, EntryStub as b, RichTextNode as c, ContentTypeKind as d, Environment as e, FieldType as f, RichTextDocument as g, RichTextMark as h };
-//# sourceMappingURL=types-pa96z6po.d.ts.map
+export type { Asset as A, Block as B, ContentTypeDefinition as C, Entry as E, FieldDefinition as F, ImproveBlock as I, ModelFile as M, RichTextFormat as R, EntryList as a, EntryStub as b, RichTextNode as c, ContentTypeKind as d, Environment as e, FieldType as f, RichTextDocument as g, RichTextMark as h };
+//# sourceMappingURL=types-nyvor49r.d.ts.map

package/dist/types-nyvor49r.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-nyvor49r.d.ts","sources":["../src/types.ts"],"mappings":"AAAA,KAAK,WAAW;AAChB,KAAK,cAAc;AACnB,KAAK,KAAK;AACV;AACA;AACA;AACA;AACA;AACA;AACA;AACA,oBAAoB,MAAM;AAC1B,kBAAkB,MAAM;AACxB;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS;AACd;AACA;AACA;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA,KAAK,YAAY,gBAAgB,KAAK,GAAG,KAAK,IAAI,KAAK;AACvD;AACA;AACA,cAAc,MAAM;AACpB;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB,cAAc,YAAY;AAC1B;AACA,YAAY,YAAY;AACxB;AACA,KAAK,gBAAgB,GAAG,YAAY;AACpC;AACA;AACA,KAAK,SAAS,gBAAgB,KAAK,GAAG,KAAK;AAC3C;AACA;AACA;AACA;AACA;AACA,KAAK,eAAe;AACpB,KAAK,SAAS;AACd;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,eAAe,GAAG,SAAS;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS,GAAG,eAAe;AAChC,KAAK,qBAAqB;AAC1B;AACA;AACA,UAAU,eAAe;AACzB;AACA,YAAY,eAAe;AAC3B;AACA,KAAK,SAAS;AACd;AACA;AACA,kBAAkB,qBAAqB;AACvC;;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@obelism/content",
 	"description": "Obelism Content SDK: the delivery API client, the visual editor bridge with prompt editing, editing on your own site, and the content model CLI",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"keywords": [
 		"cms",
 		"headless-cms",
@@ -65,7 +65,7 @@
 		}
 	},
 	"scripts": {
-		"build": "bunchee",
+		"build": "bunchee && rollup --config rollup.bridge.config.mjs",
 		"dev": "bunchee --watch --no-clean",
 		"test": "vitest",
 		"test:coverage": "vitest run --coverage",
@@ -77,12 +77,15 @@
 	},
 	"devDependencies": {
 		"@obelism/content-typescript-config": "^0.0.0",
+		"@rollup/plugin-node-resolve": "^16.0.3",
 		"@types/node": "^24.0.0",
 		"@typescript/typescript6": "^6.0.2",
 		"bunchee": "^7.0.2",
 		"jsdom": "^30.1.2",
 		"npm-run-all2": "^9.0.2",
 		"oxlint": "^1.88.0",
+		"rollup": "^4.64.7",
+		"rollup-plugin-swc3": "^0.12.1",
 		"typescript": "^7.0.2",
 		"vitest": "^5.0.4"
 	},

package/dist/types-pa96z6po.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-pa96z6po.d.ts","sources":["../src/types.ts"],"mappings":"AAAA,KAAK,WAAW;AAChB,KAAK,cAAc;AACnB,KAAK,KAAK;AACV;AACA;AACA;AACA;AACA;AACA;AACA;AACA,oBAAoB,MAAM;AAC1B,kBAAkB,MAAM;AACxB;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS;AACd;AACA;AACA;AACA,KAAK,KAAK,iBAAiB,MAAM,oBAAoB,MAAM;AAC3D;AACA;AACA;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB;AACA,KAAK,YAAY;AACjB;AACA,YAAY,MAAM;AAClB,cAAc,YAAY;AAC1B;AACA,YAAY,YAAY;AACxB;AACA,KAAK,gBAAgB,GAAG,YAAY;AACpC;AACA;AACA,KAAK,SAAS,gBAAgB,KAAK,GAAG,KAAK;AAC3C;AACA;AACA;AACA;AACA;AACA,KAAK,eAAe;AACpB,KAAK,SAAS;AACd;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,eAAe,GAAG,SAAS;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,SAAS,GAAG,eAAe;AAChC,KAAK,qBAAqB;AAC1B;AACA;AACA,UAAU,eAAe;AACzB;AACA,YAAY,eAAe;AAC3B;AACA,KAAK,SAAS;AACd;AACA;AACA,kBAAkB,qBAAqB;AACvC;;","names":[]}