@v7-cms/core 0.0.0-alpha.9

package/dist/fields-builtin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The built-in field types.
+ *
+ * These are value-level only: how to read the stored form, how to write it back, and what counts
+ * as empty. The visual controls live in `@v7-cms/cms`, which is what keeps this package usable
+ * from a Node script.
+ */
+import type { FieldSpec, FieldType, ValidationIssue } from './fields.js';
+/** Registered by name so configs can refer to a type the CMS knows about. */
+export declare const builtInFields: FieldType<never>[];
+/** Add a field type. Consumers call this to extend the CMS with their own. */
+export declare function registerFieldType(field: FieldType<never>): void;
+export declare function getFieldType(name: string): FieldType<never> | undefined;
+export declare function fieldTypeNames(): string[];
+/**
+ * Validate one value against one field's spec. Used by the field types above for nested values,
+ * and by the editor for top-level ones, so a `required` inside a list item behaves exactly like
+ * one at the top level.
+ */
+export declare function runFieldValidation(field: FieldSpec, value: unknown, path: string, siblings: Readonly<Record<string, unknown>>): ValidationIssue[];
+//# sourceMappingURL=fields-builtin.d.ts.map

package/dist/fields-builtin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-builtin.d.ts","sourceRoot":"","sources":["../src/fields-builtin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAa,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAyNpF,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,EAW3C,CAAC;AAIF,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAE/D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,SAAS,CAEvE;AAED,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,eAAe,EAAE,CAInB"}

package/dist/fields-builtin.js

@@ -0,0 +1,240 @@
+const isBlank = (value) => value === undefined || value === null || (typeof value === 'string' && value.trim() === '');
+/** Shared validation for the `required` flag, so every type reports it the same way. */
+function requiredIssue(value, options, path) {
+    if (options.required !== true)
+        return [];
+    if (Array.isArray(value) ? value.length === 0 : isBlank(value)) {
+        return [
+            { level: 'error', message: `${options.label ?? options.name} is required.`, path: path.path },
+        ];
+    }
+    return [];
+}
+function checkPattern(value, options, path) {
+    if (typeof value !== 'string' || !options.pattern)
+        return [];
+    const [source, message] = options.pattern;
+    if (new RegExp(source).test(value))
+        return [];
+    return [{ level: 'error', message: message || `Does not match ${source}.`, path: path.path }];
+}
+const string = {
+    name: 'string',
+    isEmpty: isBlank,
+    validate: (value, options, path) => [
+        ...requiredIssue(value, options, path),
+        ...checkPattern(value, options, path),
+    ],
+    summary: (value) => value,
+    defaultValue: () => '',
+};
+const text = {
+    ...string,
+    name: 'text',
+};
+/** Numbers may arrive as strings from YAML, so they are coerced on read and written as numbers. */
+const number = {
+    name: 'number',
+    isEmpty: (value) => value === undefined || value === null || Number.isNaN(value),
+    toValue: (stored) => {
+        if (typeof stored !== 'string')
+            return stored;
+        const parsed = Number(stored.trim());
+        return stored.trim() === '' || Number.isNaN(parsed) ? 0 : parsed;
+    },
+    toStored: (value) => value,
+    validate: (value, options, path) => {
+        const issues = requiredIssue(value, options, path);
+        if (value !== undefined && value !== null && typeof value === 'number' && Number.isNaN(value)) {
+            issues.push({
+                level: 'error',
+                message: `${options.label ?? options.name} must be a number.`,
+                path: path.path,
+            });
+        }
+        return issues;
+    },
+    summary: (value) => String(value),
+    defaultValue: () => 0,
+};
+const boolean = {
+    name: 'boolean',
+    // `false` is a real value, not an absence — writing it is meaningful for a flag like `draft`.
+    isEmpty: (value) => value === undefined || value === null,
+    validate: () => [],
+    summary: (value) => (value ? 'true' : 'false'),
+    defaultValue: () => false,
+};
+const select = {
+    name: 'select',
+    isEmpty: isBlank,
+    validate: (value, options, path) => {
+        const issues = requiredIssue(value, options, path);
+        if (isBlank(value))
+            return issues;
+        const allowed = (options.options ?? []).map((option) => typeof option === 'string' ? option : option.value);
+        if (allowed.length && !allowed.includes(value)) {
+            issues.push({
+                level: 'error',
+                message: `${options.label ?? options.name} must be one of: ${allowed.join(', ')}.`,
+                path: path.path,
+            });
+        }
+        return issues;
+    },
+    summary: (value) => value,
+    defaultValue: () => '',
+};
+/**
+ * Dates keep the value the file used. The blog's frontmatter writes `'2026-09-12'` as a quoted
+ * string and full timestamps elsewhere, and both must survive, so this type does not normalise
+ * to a `Date`.
+ */
+const datetime = {
+    name: 'datetime',
+    isEmpty: isBlank,
+    validate: (value, options, path) => {
+        const issues = requiredIssue(value, options, path);
+        if (isBlank(value))
+            return issues;
+        if (Number.isNaN(new Date(String(value)).getTime())) {
+            issues.push({
+                level: 'error',
+                message: `${options.label ?? options.name} must be a valid date.`,
+                path: path.path,
+            });
+        }
+        return issues;
+    },
+    summary: (value) => value,
+    defaultValue: () => '',
+};
+/**
+ * A list. Two shapes, matching how the configs are written: `field` for a list of scalars
+ * (`tags: ['a', 'b']`), and `fields` for a list of objects (`images: [{ src, alt, … }]`).
+ * Both validate their items and report the offending item's path.
+ */
+const list = {
+    name: 'list',
+    isEmpty: (value) => !Array.isArray(value) || value.length === 0,
+    validate: (value, options, path) => {
+        const issues = requiredIssue(value, options, path);
+        if (!Array.isArray(value))
+            return issues;
+        const itemFields = options.fields ?? (options.field ? [options.field] : []);
+        if (itemFields.length === 0)
+            return issues;
+        value.forEach((item, index) => {
+            const itemPath = `${path.path}.${index}`;
+            // A list of objects validates each declared field against the item's own keys.
+            const targets = options.fields
+                ? itemFields.map((field) => ({
+                    field,
+                    value: item?.[field.name],
+                    at: `${itemPath}.${field.name}`,
+                }))
+                : [{ field: itemFields[0], value: item, at: itemPath }];
+            for (const target of targets) {
+                issues.push(...runFieldValidation(target.field, target.value, target.at, path.siblings));
+            }
+        });
+        return issues;
+    },
+    summary: (value) => `${value.length} item${value.length === 1 ? '' : 's'}`,
+    defaultValue: () => [],
+};
+/**
+ * A nested object. `collapseEmpty` is what keeps an all-blank sub-object out of the file —
+ * the browser CMS wrote `cover:` with nothing under it, which the site's schema rejects.
+ */
+const object = {
+    name: 'object',
+    isEmpty: (value, options) => {
+        if (!value || typeof value !== 'object')
+            return true;
+        const entries = Object.entries(value);
+        if (entries.length === 0)
+            return true;
+        if (options?.collapseEmpty !== true)
+            return false;
+        return entries.every(([, item]) => isBlank(item) || (Array.isArray(item) && item.length === 0));
+    },
+    validate: (value, options, path) => {
+        const issues = [];
+        if (!value || typeof value !== 'object')
+            return issues;
+        for (const field of options.fields ?? []) {
+            issues.push(...runFieldValidation(field, value[field.name], `${path.path}.${field.name}`, path.siblings));
+        }
+        return issues;
+    },
+    summary: (value) => Object.keys(value).join(', '),
+    defaultValue: () => ({}),
+};
+/** A stored reference, validated only for presence; the consumer decides what values are legal. */
+const relation = {
+    name: 'relation',
+    isEmpty: isBlank,
+    validate: (value, options, path) => requiredIssue(value, options, path),
+    summary: (value) => value,
+    defaultValue: () => '',
+};
+/** An object of `{ locale: string }` pairs, e.g. `{ "zh-CN": "…", en: "…" }`. */
+const i18nString = {
+    name: 'i18n-string',
+    isEmpty: (value) => !value || typeof value !== 'object' || Object.values(value).every((item) => isBlank(item)),
+    validate: (value, options, path) => {
+        const issues = [];
+        if (options.required !== true)
+            return issues;
+        const locales = options.locales ?? ['zh-CN', 'en'];
+        for (const locale of locales) {
+            if (isBlank(value?.[locale])) {
+                issues.push({
+                    level: 'error',
+                    message: `${options.label ?? options.name} needs a value for ${locale}.`,
+                    path: `${path.path}.${locale}`,
+                });
+            }
+        }
+        return issues;
+    },
+    summary: (value) => Object.values(value ?? {}).find((item) => !isBlank(item)) ?? '',
+    defaultValue: () => ({}),
+};
+/** Registered by name so configs can refer to a type the CMS knows about. */
+export const builtInFields = [
+    string,
+    text,
+    number,
+    boolean,
+    select,
+    datetime,
+    list,
+    object,
+    relation,
+    i18nString,
+];
+const registry = new Map(builtInFields.map((field) => [field.name, field]));
+/** Add a field type. Consumers call this to extend the CMS with their own. */
+export function registerFieldType(field) {
+    registry.set(field.name, field);
+}
+export function getFieldType(name) {
+    return registry.get(name);
+}
+export function fieldTypeNames() {
+    return [...registry.keys()].sort();
+}
+/**
+ * Validate one value against one field's spec. Used by the field types above for nested values,
+ * and by the editor for top-level ones, so a `required` inside a list item behaves exactly like
+ * one at the top level.
+ */
+export function runFieldValidation(field, value, path, siblings) {
+    const type = getFieldType(field.widget ?? 'string');
+    if (!type?.validate)
+        return [];
+    return type.validate(value, field, { path, siblings });
+}
+//# sourceMappingURL=fields-builtin.js.map

package/dist/fields-builtin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-builtin.js","sourceRoot":"","sources":["../src/fields-builtin.ts"],"names":[],"mappings":"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"}

package/dist/fields.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The field type contract.
+ *
+ * A field type is the smallest unit of extension: it knows how to read a stored value, how to
+ * write it back, and how to validate it. It deliberately says nothing about rendering — that is
+ * the widget layer's job (see `packages/cms`), so `core` stays free of DOM and React and can be
+ * reused from Node scripts.
+ */
+/** Where a value lives, for error messages and for fields that need sibling values. */
+export interface FieldPath {
+    /** Dotted path inside the entry, e.g. `images.0.photo.camera`. */
+    readonly path: string;
+    /** The entry's raw frontmatter, so a field can consult its siblings. */
+    readonly siblings: Readonly<Record<string, unknown>>;
+}
+export interface ValidationIssue {
+    level: 'error' | 'warning';
+    message: string;
+    /** Dotted path of the offending value; defaults to the field's own path. */
+    path?: string;
+}
+/** Options every field shares. Field types extend this with their own. */
+export interface CommonFieldOptions {
+    name: string;
+    label?: string;
+    required?: boolean;
+    hint?: string;
+    /** Shown in list summaries. Falls back to the field's own `summary()`. */
+    widget?: string;
+}
+/**
+ * What a field type is handed when asked to validate or summarise. It is the full field spec, not
+ * just the common options, so a `list` can see its `fields`, a `select` its `options`, and so on.
+ * Declared loosely here because `core` cannot import the config module without a cycle.
+ */
+export interface FieldSpec extends CommonFieldOptions {
+    fields?: FieldSpec[];
+    field?: FieldSpec;
+    options?: Array<string | {
+        label: string;
+        value: string;
+    }>;
+    pattern?: [string, string];
+    collapseEmpty?: boolean;
+    locales?: string[];
+    [key: string]: unknown;
+}
+/**
+ * The shape a field type must implement.
+ *
+ * `TStored` is the value as it appears in the file; `TValue` is the value the editor works with.
+ * For most types they are the same and `toValue`/`toStored` can be omitted.
+ */
+export interface FieldType<TValue = unknown, TStored = TValue> {
+    /** Registry name, e.g. `string`, `date`, `image`. */
+    readonly name: string;
+    /**
+     * Whether this value should be omitted from the file entirely. Returning true means "the user
+     * has not set this", which is what keeps optional keys out of the output rather than writing
+     * them as empty strings — the blog's build treats `''` and a missing key differently.
+     */
+    isEmpty?(value: TValue): boolean;
+    /** File value -> editor value. Omit when the two are identical. */
+    toValue?(stored: TStored): TValue;
+    /** Editor value -> file value. Omit when the two are identical. */
+    toStored?(value: TValue, context: {
+        originalStyle?: ScalarStyle;
+    }): TStored;
+    /** Validation runs on the editor value. */
+    validate?(value: TValue, options: FieldSpec, path: FieldPath): ValidationIssue[];
+    /** One-line label for the entry list and for collapsed list items. */
+    summary?(value: TValue, options: FieldSpec): string;
+    /** A value to use when the user adds a new item. */
+    defaultValue?(): TValue;
+}
+/**
+ * How a scalar was written in the source file, so that editing a value does not silently change
+ * its style. `'2026-09-12'` and `2026-09-12` mean different things to some consumers, and the
+ * blog's content mixes both.
+ */
+export interface ScalarStyle {
+    quote: 'single' | 'double' | false;
+}
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM;IAC3D,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,mEAAmE;IACnE,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAElC,mEAAmE;IACnE,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,aAAa,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;IAE5E,2CAA2C;IAC3C,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAAC;IAEjF,sEAAsE;IACtE,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,MAAM,CAAC;IAEpD,oDAAoD;IACpD,YAAY,CAAC,IAAI,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;CACpC"}

package/dist/fields.js

@@ -0,0 +1,10 @@
+/**
+ * The field type contract.
+ *
+ * A field type is the smallest unit of extension: it knows how to read a stored value, how to
+ * write it back, and how to validate it. It deliberately says nothing about rendering — that is
+ * the widget layer's job (see `packages/cms`), so `core` stays free of DOM and React and can be
+ * reused from Node scripts.
+ */
+export {};
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './fields.js';
+export * from './config.js';
+export * from './config-load.js';
+export * from './fields-builtin.js';
+export * from './body-mode.js';
+export * from './serialize/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './fields.js';
+export * from './config.js';
+export * from './config-load.js';
+export * from './fields-builtin.js';
+export * from './body-mode.js';
+export * from './serialize/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/serialize/entry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Reading and writing entry files without disturbing what was not edited.
+ *
+ * The rule that makes this work: the file's text is the source of truth. Parsing keeps the
+ * original strings, and saving only touches the nodes whose values actually changed. Nothing is
+ * ever re-serialised from a plain object, because that would normalise quoting, flow style,
+ * key order and comments away — and the blog's build treats `'2026-09-12'` and a bare date, or a
+ * missing key and an empty one, as different things.
+ */
+import { type Document } from 'yaml';
+export interface ParsedEntry {
+    /** The file exactly as it was read. */
+    raw: string;
+    /** Frontmatter including the `---` fences, or '' when the file has none. */
+    frontmatterRaw: string;
+    /** Everything after the frontmatter, byte for byte. */
+    bodyRaw: string;
+    /** The frontmatter as a mutable YAML document. */
+    document: Document.Parsed;
+    /** Whether the original file had frontmatter at all. */
+    hasFrontmatter: boolean;
+    /** Flow collections written as `{ a: 1 }`, which the writer would otherwise emit as `{a: 1}`. */
+    paddedFlows: FlowPadding[];
+}
+/**
+ * A flow collection whose original text had a space just inside its brackets. Real files mix the
+ * two styles — `[a, b]` in one line and `{ a: b }` in the next — and the YAML writer has a single
+ * global setting, so these are recorded on parse and repaired after writing.
+ */
+interface FlowPadding {
+    /** Dotted path of the collection, as used by `getIn`/`setIn`. */
+    path: string[];
+    /** Whether the source text had a space after the opening bracket. */
+    leading: boolean;
+}
+export declare function parseEntry(raw: string): ParsedEntry;
+/** The frontmatter as plain data. For reading and comparing only — never for writing. */
+export declare function readData(entry: ParsedEntry): Record<string, unknown>;
+/**
+ * Set a value at a dotted path, touching only that node, so every other node keeps its original
+ * style: quoting, flow vs block sequences, key order and comments all survive.
+ */
+export declare function setValue(entry: ParsedEntry, path: string, value: unknown): void;
+/** Remove a key entirely, which is how optional fields stay absent rather than blank. */
+export declare function deleteValue(entry: ParsedEntry, path: string): void;
+/** Read a value at a dotted path, as plain data. */
+export declare function getValue(entry: ParsedEntry, path: string): unknown;
+/** Whether the node at `path` exists at all. */
+export declare function hasValue(entry: ParsedEntry, path: string): boolean;
+/**
+ * The quoting of the node currently at `path`, so a rewrite can match its neighbourhood rather
+ * than falling back to the YAML default. Dates in the blog are single-quoted strings; dropping
+ * the quotes would turn them into date objects downstream.
+ */
+export declare function scalarStyleAt(entry: ParsedEntry, path: string): {
+    quote: 'single' | 'double' | false;
+} | undefined;
+/**
+ * The file text for the current document state. `bodyRaw` goes back out untouched unless the
+ * caller passes a new body, which is what makes "parse then save" a no-op for untouched content.
+ */
+export declare function serializeEntry(entry: ParsedEntry, body?: string): string;
+export {};
+//# sourceMappingURL=entry.d.ts.map

package/dist/serialize/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/serialize/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAoD,KAAK,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEvF,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC;IAC1B,wDAAwD;IACxD,cAAc,EAAE,OAAO,CAAC;IACxB,iGAAiG;IACjG,WAAW,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,UAAU,WAAW;IACnB,iEAAiE;IACjE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAwBnD;AAwBD,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/E;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE;AAED,oDAAoD;AACpD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKlE;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;CAAE,GAAG,SAAS,CAOpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQxE"}

package/dist/serialize/entry.js

@@ -0,0 +1,151 @@
+/**
+ * Reading and writing entry files without disturbing what was not edited.
+ *
+ * The rule that makes this work: the file's text is the source of truth. Parsing keeps the
+ * original strings, and saving only touches the nodes whose values actually changed. Nothing is
+ * ever re-serialised from a plain object, because that would normalise quoting, flow style,
+ * key order and comments away — and the blog's build treats `'2026-09-12'` and a bare date, or a
+ * missing key and an empty one, as different things.
+ */
+import { parseDocument, stringify, isScalar, isSeq, isMap } from 'yaml';
+// The frontmatter block may be empty, which is what a brand new entry starts as, so the inner
+// group is optional rather than `[\s\S]*?` between two newlines.
+const FRONTMATTER = /^---[ \t]*\r?\n(?:([\s\S]*?)\r?\n)?---[ \t]*(\r?\n|$)/;
+export function parseEntry(raw) {
+    const match = FRONTMATTER.exec(raw);
+    if (!match) {
+        return {
+            raw,
+            frontmatterRaw: '',
+            bodyRaw: raw,
+            document: parseDocument(''),
+            hasFrontmatter: false,
+            paddedFlows: [],
+        };
+    }
+    const frontmatterRaw = match[0];
+    const yamlText = match[1] ?? '';
+    const document = parseDocument(yamlText);
+    return {
+        raw,
+        frontmatterRaw,
+        bodyRaw: raw.slice(frontmatterRaw.length),
+        document,
+        hasFrontmatter: true,
+        // Node ranges are offsets into the YAML text that was parsed, not into the whole file.
+        paddedFlows: collectPadding(document, yamlText),
+    };
+}
+function collectPadding(document, yamlText) {
+    const found = [];
+    const visit = (node, path) => {
+        if (!isMap(node) && !isSeq(node))
+            return;
+        const range = node.range;
+        if (node.flow && range) {
+            const text = yamlText.slice(range[0], range[0] + 2);
+            found.push({ path: [...path], leading: /^[[{] /.test(text) });
+        }
+        if (isMap(node)) {
+            for (const item of node.items) {
+                const key = isScalar(item.key) ? String(item.key.value) : undefined;
+                if (key !== undefined)
+                    visit(item.value, [...path, key]);
+            }
+        }
+        else if (isSeq(node)) {
+            node.items.forEach((item, index) => visit(item, [...path, String(index)]));
+        }
+    };
+    visit(document.contents, []);
+    return found;
+}
+/** The frontmatter as plain data. For reading and comparing only — never for writing. */
+export function readData(entry) {
+    const value = entry.document.toJS({});
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+/**
+ * Set a value at a dotted path, touching only that node, so every other node keeps its original
+ * style: quoting, flow vs block sequences, key order and comments all survive.
+ */
+export function setValue(entry, path, value) {
+    entry.document.setIn(path.split('.'), value);
+}
+/** Remove a key entirely, which is how optional fields stay absent rather than blank. */
+export function deleteValue(entry, path) {
+    entry.document.deleteIn(path.split('.'));
+}
+/** Read a value at a dotted path, as plain data. */
+export function getValue(entry, path) {
+    const node = entry.document.getIn(path.split('.'), true);
+    if (node === undefined)
+        return undefined;
+    if (isScalar(node))
+        return node.value;
+    return node.toJS?.({}) ?? undefined;
+}
+/** Whether the node at `path` exists at all. */
+export function hasValue(entry, path) {
+    return entry.document.hasIn(path.split('.'));
+}
+/**
+ * The quoting of the node currently at `path`, so a rewrite can match its neighbourhood rather
+ * than falling back to the YAML default. Dates in the blog are single-quoted strings; dropping
+ * the quotes would turn them into date objects downstream.
+ */
+export function scalarStyleAt(entry, path) {
+    const node = entry.document.getIn(path.split('.'), true);
+    if (!isScalar(node))
+        return undefined;
+    const type = node.type;
+    return {
+        quote: type === 'QUOTE_SINGLE' ? 'single' : type === 'QUOTE_DOUBLE' ? 'double' : false,
+    };
+}
+/**
+ * The file text for the current document state. `bodyRaw` goes back out untouched unless the
+ * caller passes a new body, which is what makes "parse then save" a no-op for untouched content.
+ */
+export function serializeEntry(entry, body) {
+    if (!entry.hasFrontmatter)
+        return body ?? entry.bodyRaw;
+    // `lineWidth: 0` stops the writer folding long lines, which would reflow existing text.
+    let yamlText = entry.document
+        .toString({ lineWidth: 0, flowCollectionPadding: false })
+        .replace(/\n+$/, '\n');
+    yamlText = restoreFlowPadding(entry, yamlText);
+    return `---\n${yamlText}---\n${body ?? entry.bodyRaw}`;
+}
+/**
+ * Put back the inner spaces that `flowCollectionPadding: false` removed, but only for the
+ * collections that had them. Real files mix `[a, b]` and `{ a: b }`, sometimes on adjacent lines,
+ * and the writer has one global setting — so the source style is recorded on parse and repaired
+ * here, matching on each collection's own inline text rather than on its position.
+ */
+function restoreFlowPadding(entry, yamlText) {
+    const wanted = entry.paddedFlows.filter((flow) => flow.leading);
+    if (wanted.length === 0)
+        return yamlText;
+    let result = yamlText;
+    for (const flow of wanted) {
+        const node = entry.document.getIn(flow.path, true);
+        if (!node || !(isMap(node) || isSeq(node)) || !node.flow)
+            continue;
+        const compact = stringify(node, {
+            lineWidth: 0,
+            flowCollectionPadding: false,
+        });
+        const padded = stringify(node, {
+            lineWidth: 0,
+            flowCollectionPadding: true,
+        });
+        if (typeof compact !== 'string' || typeof padded !== 'string')
+            continue;
+        result = result.replace(compact.trim(), padded.trim());
+    }
+    return result;
+}
+//# sourceMappingURL=entry.js.map

package/dist/serialize/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/serialize/entry.ts"],"names":[],"mappings":"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"}

package/dist/serialize/index.d.ts

@@ -0,0 +1,2 @@
+export { parseEntry, readData, setValue, deleteValue, getValue, hasValue, scalarStyleAt, serializeEntry, type ParsedEntry, } from './entry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/serialize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serialize/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}