@mx-space/cli 0.15.0 → 0.15.1

package/dist/src/cli/help/index.js

@@ -0,0 +1,276 @@
+// ---------------------------------------------------------------------------
+// Root `--help` + group help renderers.
+//
+// Why a custom renderer? `@effect/cli` flattens every nested verb into the
+// root COMMANDS section and aligns columns to the longest line, producing a
+// huge wall of whitespace. It also can't see our pre-parsed global flags
+// (those are stripped from argv before `Command.run` is invoked — see
+// `domain/runtime-flags.ts`), so they never appear under OPTIONS.
+//
+// Scope:
+//   - Root `mxs --help` (and bare `mxs`)            → custom renderer here.
+//   - Top-level group help (`mxs <group> --help`,
+//     `mxs <group>`)                                → custom renderer here.
+//   - Verb help (`mxs post create --help`, ...)     → @effect/cli default.
+//
+// Per-command help content lives next to each command module via the
+// `registerCommandHelp` call (see `./registry.ts`). This file aggregates
+// nothing description-wise — it only owns:
+//   - the global-flag table (not per-command),
+//   - the canonical display order of top-level commands,
+//   - markdown → ANSI rendering + banner composition.
+//
+// The side-effect imports below ensure every command module has been loaded
+// (and has called `registerCommandHelp`) before the renderers run. Required
+// for direct importers of this module (e.g. unit tests) that don't go
+// through `bin/mxs.ts`.
+// ---------------------------------------------------------------------------
+import '../ai';
+import '../auth';
+import '../category';
+import '../comment';
+import '../config';
+import '../draft';
+import '../note';
+import '../page';
+import '../post';
+import '../preview';
+import '../profile';
+import '../project';
+import '../skill';
+import '../snippet';
+import '../topic';
+import '../update';
+import { ANSI, isColorEnabled, renderMarkdownToAnsi, wrap, } from '../render/markdown';
+import { getCommandHelp, } from './registry';
+export { renderMarkdownToAnsi } from '../render/markdown';
+export { isLeafCommand, registerCommandHelp, } from './registry';
+// ---------------------------------------------------------------------------
+// Canonical display order for the root `mxs --help` table and the set of
+// names the bin treats as known top-level commands. Decoupled from the
+// (alphabetised) import order at the top of this file.
+// ---------------------------------------------------------------------------
+export const GROUP_NAMES = [
+    'auth',
+    'profile',
+    'post',
+    'note',
+    'page',
+    'draft',
+    'project',
+    'category',
+    'topic',
+    'comment',
+    'snippet',
+    'ai',
+    'config',
+    'skill',
+    'preview',
+    'update',
+];
+export const isGroupName = (s) => GROUP_NAMES.includes(s);
+const orderedCommandHelp = () => GROUP_NAMES.map((name) => getCommandHelp(name)).filter((c) => c !== undefined);
+const ROOT_DESCRIPTION = 'mx-space CLI — manage your mx-core blog from the command line.';
+const GLOBAL_OPTIONS = [
+    {
+        flag: '--json',
+        description: 'emit JSON output (shorthand for `--output json`)',
+    },
+    {
+        flag: '--output <mode>',
+        description: 'one of: readable (default), pretty-json, json, llm, xml',
+    },
+    { flag: '--api-url <url>', description: 'override the configured API URL' },
+    { flag: '--token <t>', description: 'override the stored access token' },
+    {
+        flag: '--api-key <key>',
+        description: 'authenticate with an x-api-key API key',
+    },
+    {
+        flag: '--lang <code>',
+        description: 'request translated read data for a locale',
+    },
+    { flag: '--profile <name>', description: 'profile to use' },
+    { flag: '-q, --quiet', description: 'suppress non-error stderr' },
+    { flag: '--verbose', description: 'log HTTP method/url/status/duration' },
+    {
+        flag: '--dry-run',
+        description: 'show resolved payload without calling the server',
+    },
+    { flag: '-h, --help', description: 'show this help' },
+    { flag: '--version', description: 'print version and exit' },
+];
+export const buildRootHelpData = (version) => ({
+    programName: 'mxs',
+    version,
+    description: ROOT_DESCRIPTION,
+    globalOptions: GLOBAL_OPTIONS,
+    commands: orderedCommandHelp().map((c) => ({
+        name: c.name,
+        description: c.description,
+        verbs: c.verbs?.map((v) => v.name),
+    })),
+});
+const formatVerbs = (verbs) => {
+    if (!verbs || verbs.length === 0)
+        return '';
+    return ` (${verbs.join(', ')})`;
+};
+export const renderRootHelp = (data) => {
+    // The banner is rendered separately by `emitHelp`. We emit a short tagline
+    // line first (after the banner) so the full description is still searchable
+    // in piped output; the banner only shows the short form.
+    const lines = [
+        data.description,
+        '',
+        '## Bundled skill (for AI agents)',
+        '',
+        `Per-command \`--help\` covers most usage. For deeper context — content authoring, LiteXML envelopes, output modes, mutation safety, AI artifacts — \`${data.programName} skill\` lists bundled chapters; \`${data.programName} skill get <slug>\` prints one as raw markdown. Pass \`--output llm\` for ANSI-free output.`,
+        '',
+        '## Usage',
+        '',
+        `    ${data.programName} [global-options] <command> [command-options] [args]`,
+        '',
+        '## Global options',
+        '',
+        '| Flag | Description |',
+        '| ---- | ----------- |',
+    ];
+    for (const opt of data.globalOptions) {
+        lines.push(`| \`${opt.flag}\` | ${opt.description} |`);
+    }
+    lines.push('');
+    lines.push('## Commands');
+    lines.push('');
+    lines.push('| Command | Description |');
+    lines.push('| ------- | ----------- |');
+    for (const cmd of data.commands) {
+        const desc = `${cmd.description}${formatVerbs(cmd.verbs)}`;
+        lines.push(`| \`${cmd.name}\` | ${desc} |`);
+    }
+    lines.push('');
+    lines.push('## Per-command help');
+    lines.push('');
+    lines.push(`Run \`${data.programName} <command> --help\` for the full option list of a specific command.`);
+    lines.push('');
+    return lines.join('\n');
+};
+// ---------------------------------------------------------------------------
+// Banner + emitters.
+// ---------------------------------------------------------------------------
+/**
+ * Render the banner line `<title> — <subtitle>` followed by a dim rule.
+ * The rule width matches the visible width of the banner line, capped at
+ * the terminal width (or 80 as fallback).
+ */
+const renderBanner = (title, subtitle, opts) => {
+    const sep = ' — ';
+    const plainLine = `${title}${sep}${subtitle}`;
+    const termWidth = process.stdout.columns && process.stdout.columns > 0
+        ? process.stdout.columns
+        : 80;
+    const ruleWidth = Math.min(plainLine.length, termWidth);
+    const styledLine = wrap(`${ANSI.bold}${ANSI.magenta}`, title, opts.color) +
+        wrap(ANSI.dim, sep, opts.color) +
+        wrap(ANSI.bold, subtitle, opts.color);
+    const rule = wrap(ANSI.dim, '─'.repeat(ruleWidth), opts.color);
+    return `${styledLine}\n${rule}\n`;
+};
+/**
+ * Render the root help and write it to stdout, followed by a trailing
+ * newline. Honors `NO_COLOR` and non-TTY stdout (strips ANSI styling).
+ */
+export const emitHelp = (data) => {
+    const color = isColorEnabled(process.stdout);
+    // Banner subtitle is the short tagline only — split off the first segment
+    // of the description (before " — "), so the banner stays compact. The full
+    // description is rendered as a paragraph by `renderRootHelp`.
+    const tagline = data.description.split(' — ')[0] || data.description;
+    const banner = renderBanner(`${data.programName} ${data.version}`, tagline, {
+        color,
+    });
+    const md = renderRootHelp(data);
+    const ansi = renderMarkdownToAnsi(md, { color });
+    process.stdout.write(banner + ansi + '\n');
+};
+const renderVerbSignature = (verb) => {
+    const parts = [verb.name, ...(verb.args ?? [])];
+    return parts.join(' ');
+};
+export const groupHelpDataFor = (name, version) => {
+    const entry = getCommandHelp(name);
+    if (!entry) {
+        throw new Error(`unknown group: ${name}`);
+    }
+    return {
+        programName: 'mxs',
+        version,
+        groupName: name,
+        description: entry.description,
+        verbs: entry.verbs ?? [],
+        isLeaf: entry.isLeaf,
+        leafOptions: entry.leafOptions,
+        skillChapter: entry.skillChapter,
+    };
+};
+export const renderGroupHelp = (data) => {
+    // The banner is rendered separately by `emitGroupHelp`. Body starts here.
+    const lines = ['## Usage', ''];
+    if (data.isLeaf) {
+        lines.push(`    ${data.programName} [global-options] ${data.groupName} [options]`);
+    }
+    else {
+        lines.push(`    ${data.programName} [global-options] ${data.groupName} <verb> [verb-options] [args]`);
+    }
+    lines.push('');
+    if (data.isLeaf) {
+        const opts = data.leafOptions ?? [];
+        if (opts.length > 0) {
+            lines.push('## Options');
+            lines.push('');
+            lines.push('| Flag | Description |');
+            lines.push('| ---- | ----------- |');
+            for (const o of opts) {
+                lines.push(`| \`${o.flag}\` | ${o.description} |`);
+            }
+            lines.push('');
+        }
+    }
+    else {
+        lines.push('## Verbs');
+        lines.push('');
+        lines.push('| Verb | Description |');
+        lines.push('| ---- | ----------- |');
+        for (const v of data.verbs) {
+            lines.push(`| \`${renderVerbSignature(v)}\` | ${v.description} |`);
+        }
+        lines.push('');
+    }
+    lines.push('## Global options');
+    lines.push('');
+    lines.push(`See \`${data.programName} --help\` for the global flag list.`);
+    lines.push('');
+    if (!data.isLeaf) {
+        lines.push('## Help');
+        lines.push('');
+        lines.push(`Use \`${data.programName} ${data.groupName} <verb> --help\` for the full options of a verb.`);
+        lines.push('');
+    }
+    lines.push('## Bundled skill (for AI agents)');
+    lines.push('');
+    if (data.skillChapter) {
+        lines.push(`For deeper reference: \`${data.programName} skill get ${data.skillChapter}\` (or \`${data.programName} skill\` for the full list).`);
+    }
+    else {
+        lines.push(`For deeper reference run \`${data.programName} skill\` to see the bundled chapter list.`);
+    }
+    lines.push('');
+    return lines.join('\n');
+};
+export const emitGroupHelp = (data) => {
+    const color = isColorEnabled(process.stdout);
+    const banner = renderBanner(`${data.programName} ${data.groupName}`, data.description, { color });
+    const md = renderGroupHelp(data);
+    const ansi = renderMarkdownToAnsi(md, { color });
+    process.stdout.write(banner + ansi + '\n');
+};

package/dist/src/cli/help/registry.d.ts

@@ -0,0 +1,28 @@
+export interface VerbDescriptor {
+    readonly name: string;
+    readonly args?: readonly string[];
+    readonly description: string;
+}
+export interface LeafOptionHelp {
+    readonly flag: string;
+    readonly description: string;
+}
+export interface CommandHelp {
+    readonly name: string;
+    readonly description: string;
+    readonly verbs?: readonly VerbDescriptor[];
+    readonly isLeaf?: boolean;
+    readonly leafOptions?: readonly LeafOptionHelp[];
+    readonly skillChapter?: string;
+}
+/**
+ * Register help metadata for a top-level command. Returns the registered
+ * entry so callers can reuse `entry.description` for
+ * `Command.withDescription(...)` without restating the string.
+ */
+export declare const registerCommandHelp: (help: CommandHelp) => CommandHelp;
+export declare const getCommandHelp: (name: string) => CommandHelp | undefined;
+export declare const getAllCommandHelp: () => readonly CommandHelp[];
+export declare const getRegisteredNames: () => readonly string[];
+export declare const isRegisteredCommand: (name: string) => boolean;
+export declare const isLeafCommand: (name: string) => boolean;

package/dist/src/cli/help/registry.js

@@ -0,0 +1,29 @@
+// ---------------------------------------------------------------------------
+// Per-command help registry.
+//
+// Each top-level command module (auth, post, profile, ..., update) calls
+// `registerCommandHelp({...})` at import time to publish its own help
+// metadata. The root and group renderers in `./index.ts` consume the
+// registry instead of hard-coding the command list in one place.
+//
+// The registry is a module-level Map keyed by command name. Insertion order
+// is preserved, but the canonical display order is decided by
+// `COMMAND_ORDER` in `./index.ts` (decoupled from import order).
+// ---------------------------------------------------------------------------
+const REGISTRY = new Map();
+/**
+ * Register help metadata for a top-level command. Returns the registered
+ * entry so callers can reuse `entry.description` for
+ * `Command.withDescription(...)` without restating the string.
+ */
+export const registerCommandHelp = (help) => {
+    REGISTRY.set(help.name, help);
+    return help;
+};
+export const getCommandHelp = (name) => REGISTRY.get(name);
+export const getAllCommandHelp = () => [
+    ...REGISTRY.values(),
+];
+export const getRegisteredNames = () => [...REGISTRY.keys()];
+export const isRegisteredCommand = (name) => REGISTRY.has(name);
+export const isLeafCommand = (name) => REGISTRY.get(name)?.isLeaf === true;

package/dist/src/cli/note/_flags.d.ts

@@ -0,0 +1,66 @@
+import { Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import type { Generic, ValidationFailed } from '../../domain/errors';
+import type { ContentFormat, NoteFlagInputs } from '../../domain/payload';
+import { Resolver } from '../../services/Resolver';
+export declare const title: Options.Options<Option.Option<string>>;
+export declare const slug: Options.Options<Option.Option<string>>;
+export declare const topic: Options.Options<Option.Option<string>>;
+export declare const content: Options.Options<Option.Option<string>>;
+export declare const mood: Options.Options<Option.Option<string>>;
+export declare const weather: Options.Options<Option.Option<string>>;
+export declare const publicAt: Options.Options<Option.Option<string>>;
+export declare const password: Options.Options<Option.Option<string>>;
+export declare const coords: Options.Options<Option.Option<string>>;
+export declare const location: Options.Options<Option.Option<string>>;
+export declare const images: Options.Options<Option.Option<string>>;
+export declare const meta: Options.Options<Option.Option<string>>;
+export declare const file: Options.Options<Option.Option<string>>;
+export declare const bookmark: Options.Options<Option.Option<string>>;
+export declare const format: Options.Options<Option.Option<"markdown" | "lexical">>;
+export declare const state: Options.Options<Option.Option<"draft" | "publish">>;
+export declare const openFlag: Options.Options<boolean>;
+export declare const silentFlag: Options.Options<boolean>;
+export declare const noteWriteOptions: {
+    title: Options.Options<Option.Option<string>>;
+    slug: Options.Options<Option.Option<string>>;
+    topic: Options.Options<Option.Option<string>>;
+    content: Options.Options<Option.Option<string>>;
+    format: Options.Options<Option.Option<"markdown" | "lexical">>;
+    state: Options.Options<Option.Option<"draft" | "publish">>;
+    mood: Options.Options<Option.Option<string>>;
+    weather: Options.Options<Option.Option<string>>;
+    publicAt: Options.Options<Option.Option<string>>;
+    password: Options.Options<Option.Option<string>>;
+    bookmark: Options.Options<Option.Option<string>>;
+    coords: Options.Options<Option.Option<string>>;
+    location: Options.Options<Option.Option<string>>;
+    images: Options.Options<Option.Option<string>>;
+    meta: Options.Options<Option.Option<string>>;
+    file: Options.Options<Option.Option<string>>;
+    open: Options.Options<boolean>;
+    silent: Options.Options<boolean>;
+};
+export type NoteWriteOptionsParsed = {
+    readonly title: Option.Option<string>;
+    readonly slug: Option.Option<string>;
+    readonly topic: Option.Option<string>;
+    readonly content: Option.Option<string>;
+    readonly format: Option.Option<ContentFormat>;
+    readonly state: Option.Option<'publish' | 'draft'>;
+    readonly mood: Option.Option<string>;
+    readonly weather: Option.Option<string>;
+    readonly publicAt: Option.Option<string>;
+    readonly password: Option.Option<string>;
+    readonly bookmark: Option.Option<string>;
+    readonly coords: Option.Option<string>;
+    readonly location: Option.Option<string>;
+    readonly images: Option.Option<string>;
+    readonly meta: Option.Option<string>;
+    readonly file: Option.Option<string>;
+    readonly open: boolean;
+    readonly silent: boolean;
+};
+export declare const toNoteFlagInputs: (opts: NoteWriteOptionsParsed) => NoteFlagInputs;
+/** Resolve `__topicName` placeholder → `topicId`. */
+export declare const resolveTopicRefs: (payload: Record<string, unknown>) => Effect.Effect<Record<string, unknown>, ValidationFailed | Generic, Resolver>;

package/dist/src/cli/note/_flags.js

@@ -0,0 +1,73 @@
+import { Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { Resolver } from '../../services/Resolver';
+const optional = (self) => Options.optional(self);
+const unwrap = (value) => Option.getOrUndefined(value);
+export const title = optional(Options.text('title'));
+export const slug = optional(Options.text('slug'));
+export const topic = optional(Options.text('topic'));
+export const content = optional(Options.text('content'));
+export const mood = optional(Options.text('mood'));
+export const weather = optional(Options.text('weather'));
+export const publicAt = optional(Options.text('public-at'));
+export const password = optional(Options.text('password'));
+export const coords = optional(Options.text('coords'));
+export const location = optional(Options.text('location'));
+export const images = optional(Options.text('images'));
+export const meta = optional(Options.text('meta'));
+export const file = optional(Options.text('file'));
+export const bookmark = optional(Options.text('bookmark'));
+export const format = Options.choice('format', ['lexical', 'markdown']).pipe(Options.optional);
+export const state = Options.choice('state', ['publish', 'draft']).pipe(Options.optional);
+export const openFlag = Options.boolean('open').pipe(Options.withDescription('After success, open the admin edit page in the default browser.'));
+export const silentFlag = Options.boolean('silent').pipe(Options.withDescription('On success, emit a minimal `ok` instead of the full server response (saves output tokens). Errors still print normally.'));
+export const noteWriteOptions = {
+    title,
+    slug,
+    topic,
+    content,
+    format,
+    state,
+    mood,
+    weather,
+    publicAt,
+    password,
+    bookmark,
+    coords,
+    location,
+    images,
+    meta,
+    file,
+    open: openFlag,
+    silent: silentFlag,
+};
+const parseBoolean = (v) => v === undefined ? undefined : v === 'true';
+export const toNoteFlagInputs = (opts) => ({
+    title: unwrap(opts.title),
+    slug: unwrap(opts.slug),
+    topic: unwrap(opts.topic),
+    content: unwrap(opts.content),
+    format: unwrap(opts.format),
+    state: unwrap(opts.state),
+    mood: unwrap(opts.mood),
+    weather: unwrap(opts.weather),
+    publicAt: unwrap(opts.publicAt),
+    password: unwrap(opts.password),
+    bookmark: parseBoolean(unwrap(opts.bookmark)),
+    coords: unwrap(opts.coords),
+    location: unwrap(opts.location),
+    images: unwrap(opts.images),
+    meta: unwrap(opts.meta),
+    file: unwrap(opts.file),
+});
+/** Resolve `__topicName` placeholder → `topicId`. */
+export const resolveTopicRefs = (payload) => Effect.gen(function* () {
+    const next = { ...payload };
+    const nameRef = next.__topicName;
+    delete next.__topicName;
+    if (typeof nameRef === 'string' && nameRef.length > 0 && !next.topicId) {
+        const resolver = yield* Resolver;
+        next.topicId = yield* resolver.resolveTopic(nameRef);
+    }
+    return next;
+});

package/dist/src/cli/note/create.d.ts

@@ -0,0 +1,23 @@
+import { Command } from '@effect/cli';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+export declare const create: Command.Command<"create", import("@effect/platform/Path").Path | import("@effect/platform/FileSystem").FileSystem | Api | Renderer | import("../../services/Resolver").Resolver | import("../../services/Lexical").Lexical, import("../../domain/errors").ValidationXml | import("../../services/Api").ApiError, {
+    readonly title: import("effect/Option").Option<string>;
+    readonly slug: import("effect/Option").Option<string>;
+    readonly topic: import("effect/Option").Option<string>;
+    readonly content: import("effect/Option").Option<string>;
+    readonly format: import("effect/Option").Option<"markdown" | "lexical">;
+    readonly state: import("effect/Option").Option<"draft" | "publish">;
+    readonly mood: import("effect/Option").Option<string>;
+    readonly weather: import("effect/Option").Option<string>;
+    readonly publicAt: import("effect/Option").Option<string>;
+    readonly password: import("effect/Option").Option<string>;
+    readonly bookmark: import("effect/Option").Option<string>;
+    readonly coords: import("effect/Option").Option<string>;
+    readonly location: import("effect/Option").Option<string>;
+    readonly images: import("effect/Option").Option<string>;
+    readonly meta: import("effect/Option").Option<string>;
+    readonly file: import("effect/Option").Option<string>;
+    readonly open: boolean;
+    readonly silent: boolean;
+}>;

package/dist/src/cli/note/create.js

@@ -0,0 +1,25 @@
+import { Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { openAdminEdit } from '../../domain/admin-link';
+import { buildNotePayload } from '../../domain/payload';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+import { extractId } from '../post/_flags';
+import { noteWriteOptions, resolveTopicRefs, toNoteFlagInputs } from './_flags';
+export const create = Command.make('create', noteWriteOptions, (opts) => Effect.gen(function* () {
+    const flags = toNoteFlagInputs(opts);
+    const built = yield* buildNotePayload(flags);
+    const payload = yield* resolveTopicRefs(built.payload);
+    const api = yield* Api;
+    const renderer = yield* Renderer;
+    const res = yield* api.request('/notes', {
+        method: 'POST',
+        body: payload,
+    });
+    yield* renderer.emitSuccess(opts.silent ? { ok: true } : res);
+    if (opts.open) {
+        const id = extractId(res);
+        if (id)
+            yield* openAdminEdit('notes', id);
+    }
+})).pipe(Command.withDescription('create a note'));

package/dist/src/cli/note/delete.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@effect/cli';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+import { Resolver } from '../../services/Resolver';
+export declare const del: Command.Command<"delete", Api | Renderer | Resolver, import("../../services/Api").ApiError, {
+    readonly slugOrId: string;
+    readonly force: boolean;
+}>;

package/dist/src/cli/note/delete.js

@@ -0,0 +1,21 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { ValidationFailed } from '../../domain/errors';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+import { Resolver } from '../../services/Resolver';
+const slugOrId = Args.text({ name: 'slugOrId' });
+const force = Options.boolean('force').pipe(Options.withDescription('skip confirmation'));
+export const del = Command.make('delete', { slugOrId, force }, ({ slugOrId, force }) => Effect.gen(function* () {
+    if (!force && !process.stdin.isTTY) {
+        return yield* Effect.fail(new ValidationFailed({
+            message: 'refusing to delete without --force in non-TTY context',
+        }));
+    }
+    const resolver = yield* Resolver;
+    const api = yield* Api;
+    const renderer = yield* Renderer;
+    const id = yield* resolver.resolveNoteId(slugOrId);
+    yield* api.request(`/notes/${id}`, { method: 'DELETE' });
+    yield* renderer.emitSuccess({ deleted: id });
+})).pipe(Command.withDescription('delete a note'));

package/dist/src/cli/note/edit.d.ts

@@ -0,0 +1,28 @@
+import { Command } from '@effect/cli';
+import { ValidationXml } from '../../domain/errors';
+import { Api } from '../../services/Api';
+import { Editor } from '../../services/Editor';
+import { Lexical } from '../../services/Lexical';
+import { Renderer } from '../../services/Renderer';
+import { Resolver } from '../../services/Resolver';
+export declare const edit: Command.Command<"edit", import("@effect/platform/Path").Path | import("@effect/platform/FileSystem").FileSystem | Api | Renderer | Resolver | Editor | Lexical, ValidationXml | import("../../services/Api").ApiError, {
+    readonly title: import("effect/Option").Option<string>;
+    readonly slug: import("effect/Option").Option<string>;
+    readonly topic: import("effect/Option").Option<string>;
+    readonly content: import("effect/Option").Option<string>;
+    readonly format: import("effect/Option").Option<"markdown" | "lexical">;
+    readonly state: import("effect/Option").Option<"draft" | "publish">;
+    readonly mood: import("effect/Option").Option<string>;
+    readonly weather: import("effect/Option").Option<string>;
+    readonly publicAt: import("effect/Option").Option<string>;
+    readonly password: import("effect/Option").Option<string>;
+    readonly bookmark: import("effect/Option").Option<string>;
+    readonly coords: import("effect/Option").Option<string>;
+    readonly location: import("effect/Option").Option<string>;
+    readonly images: import("effect/Option").Option<string>;
+    readonly meta: import("effect/Option").Option<string>;
+    readonly file: import("effect/Option").Option<string>;
+    readonly open: boolean;
+    readonly silent: boolean;
+    readonly slugOrId: string;
+}>;