@obelism/content 0.1.1 → 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
@@ -77,6 +100,17 @@ const { summary } = await bridge.prompt('Make the heading shorter')
 bridge.undo()
 ```
 
+On a site signed in to edit (`@obelism/content/site`), the box also has **New
+page**: a path (`/pricing`, or under an existing page) and what the page is
+for. The CMS writes the page like the one the editor is on and stores it as a
+draft, and the bridge opens it at `/` + its path. When your routes put CMS
+pages elsewhere, say where:
+
+```ts
+getContentBridge({ pagePath: (path) => `/en/${path}` })
+await bridge.createPage('/pricing', 'Our plans, for agencies') // or your own UI
+```
+
 The CMS runs prompts on Workers AI. To use your own model, set a prompt
 endpoint under Space settings → Prompt editing and answer it with
 `createPromptHandler` (it verifies the signed request; you call the model):
@@ -98,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

@@ -24,6 +24,12 @@ type BridgeState = {
 type PromptResult = {
     summary: string;
 };
+type CreatePageResult = {
+    summary: string;
+    entryId: string;
+    path: string;
+    url: string;
+};
 type ContentBridge = {
     readonly isEditing: boolean;
     readonly mode: 'editor' | 'site' | null;
@@ -34,6 +40,7 @@ type ContentBridge = {
     prompt(prompt: string, options?: {
         uid?: string | null;
     }): Promise<PromptResult>;
+    createPage(path: string, prompt: string): Promise<CreatePageResult>;
     undo(): void;
     save(): Promise<void>;
     publish(): Promise<void>;
@@ -64,19 +71,28 @@ type PromptLabels = {
     signOut: string;
     viewingDrafts: string;
     selectHint: string;
+    newPage: string;
+    newPageCancel: string;
+    newPagePlaceholder: string;
+    path: string;
+    pathPlaceholder: string;
+    creating: string;
+    created: string;
 };
 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;
     prompt?: boolean | PromptBoxOptions | undefined;
+    pagePath?: ((path: string) => string) | undefined;
 };
 declare const peekContentBridge: () => ContentBridge | null;
-declare const getContentBridge: ({ url, prompt, }?: BridgeOptions) => ContentBridge;
+declare const getContentBridge: ({ url, prompt, pagePath, }?: BridgeOptions) => ContentBridge;
 
-export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, peekContentBridge };
-export type { BridgeEvent, BridgeEvents, BridgeListener, BridgeOptions, BridgeState, ContentBridge, PromptBoxOptions, PromptLabels, PromptResult };
+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,aAAa;AAClB;AACA;AACA;AACA;AACA,iBAAiB,WAAW,sBAAsB,cAAc;AAChE,gBAAgB,WAAW;AAC3B;AACA;AACA,QAAQ,OAAO,CAAC,YAAY;AAC5B;AACA,YAAY,OAAO;AACnB,eAAe,OAAO;AACtB;AACA;AACA;AACA;AACA;AAEA,cAAc,aAAa,EAAE,WAAW;;AC9CxC,KAAK,YAAY;AACjB;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;;ACnBA,KAAK,aAAa;AAClB;AACA,uBAAuB,gBAAgB;AACvC;AACA,cAAc,iBAAiB,QAAQ,aAAa;AACpD,cAAc,gBAAgB,sBAAsB,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

@@ -24,6 +24,12 @@ type BridgeState = {
 type PromptResult = {
     summary: string;
 };
+type CreatePageResult = {
+    summary: string;
+    entryId: string;
+    path: string;
+    url: string;
+};
 type ContentBridge = {
     readonly isEditing: boolean;
     readonly mode: 'editor' | 'site' | null;
@@ -34,6 +40,7 @@ type ContentBridge = {
     prompt(prompt: string, options?: {
         uid?: string | null;
     }): Promise<PromptResult>;
+    createPage(path: string, prompt: string): Promise<CreatePageResult>;
     undo(): void;
     save(): Promise<void>;
     publish(): Promise<void>;
@@ -64,19 +71,28 @@ type PromptLabels = {
     signOut: string;
     viewingDrafts: string;
     selectHint: string;
+    newPage: string;
+    newPageCancel: string;
+    newPagePlaceholder: string;
+    path: string;
+    pathPlaceholder: string;
+    creating: string;
+    created: string;
 };
 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;
     prompt?: boolean | PromptBoxOptions | undefined;
+    pagePath?: ((path: string) => string) | undefined;
 };
 declare const peekContentBridge: () => ContentBridge | null;
-declare const getContentBridge: ({ url, prompt, }?: BridgeOptions) => ContentBridge;
+declare const getContentBridge: ({ url, prompt, pagePath, }?: BridgeOptions) => ContentBridge;
 
-export { DEFAULT_PROMPT_LABELS, INITIAL_STATE, getContentBridge, peekContentBridge };
-export type { BridgeEvent, BridgeEvents, BridgeListener, BridgeOptions, BridgeState, ContentBridge, PromptBoxOptions, PromptLabels, PromptResult };
+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,aAAa;AAClB;AACA;AACA;AACA;AACA,iBAAiB,WAAW,sBAAsB,cAAc;AAChE,gBAAgB,WAAW;AAC3B;AACA;AACA,QAAQ,OAAO,CAAC,YAAY;AAC5B;AACA,YAAY,OAAO;AACnB,eAAe,OAAO;AACtB;AACA;AACA;AACA;AACA;AAEA,cAAc,aAAa,EAAE,WAAW;;AC9CxC,KAAK,YAAY;AACjB;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;;ACnBA,KAAK,aAAa;AAClB;AACA,uBAAuB,gBAAgB;AACvC;AACA,cAAc,iBAAiB,QAAQ,aAAa;AACpD,cAAc,gBAAgB,sBAAsB,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":[]}