emdash-emit 0.0.0-stage → 0.1.2

package/dist/sync/taxonomies.d.ts

@@ -0,0 +1,49 @@
+export interface TaxonomyTerm {
+    id: string;
+    name?: string;
+    slug: string;
+    label?: string;
+    parentId?: string | null;
+    count?: number;
+    locale?: string;
+}
+export interface PullTaxonomiesOptions {
+    workspaceRoot: string;
+    origin: string;
+    token: string;
+    refreshToken?: string;
+    fetchFn?: typeof fetch;
+}
+export interface PullTaxonomiesResult {
+    categoriesCount: number;
+    tagsCount: number;
+    deletedCategoriesCount: number;
+    deletedTagsCount: number;
+}
+/**
+ * Pulls categories and tags from EmDash API and saves them to local YAML files:
+ * categories/<id>-<sanitizedLabel>.yaml
+ * tags/<id>-<sanitizedLabel>.yaml
+ */
+export declare function pullTaxonomies(options: PullTaxonomiesOptions): Promise<PullTaxonomiesResult>;
+/**
+ * Loads local taxonomy mapping between term ULID and slug from categories/ and tags/ directories.
+ */
+export declare function loadLocalTaxonomyMaps(workspaceRoot: string): {
+    slugToId: {
+        category: Record<string, string>;
+        tag: Record<string, string>;
+    };
+    idToSlug: {
+        category: Record<string, string>;
+        tag: Record<string, string>;
+    };
+};
+/**
+ * Loads local taxonomy candidate names (slugs or labels) from categories/ and tags/ directories.
+ */
+export declare function loadLocalTaxonomyCandidates(workspaceRoot: string): {
+    categories: string[];
+    tags: string[];
+};
+//# sourceMappingURL=taxonomies.d.ts.map

package/dist/sync/taxonomies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomies.d.ts","sourceRoot":"","sources":["../../src/sync/taxonomies.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA8H/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG;IAC5D,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC5E,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC7E,CA0CA;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG;IAClE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CA8BA"}

package/dist/sync/taxonomies.js

@@ -0,0 +1,220 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { sanitizeTitleForFilename } from '../utils/frontmatter.js';
+import { ApiError } from '../client/error.js';
+import { createAuthedFetch } from '../client/http.js';
+import { unwrapEnvelope } from '../client/api.js';
+/**
+ * Pulls categories and tags from EmDash API and saves them to local YAML files:
+ * categories/<id>-<sanitizedLabel>.yaml
+ * tags/<id>-<sanitizedLabel>.yaml
+ */
+export async function pullTaxonomies(options) {
+    const fetchFn = createAuthedFetch(options);
+    const fetchTerms = async (taxName) => {
+        const url = new URL(`/_emdash/api/taxonomies/${taxName}/terms`, options.origin).toString();
+        const res = await fetchFn(url, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${options.token}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!res.ok) {
+            throw new ApiError({
+                message: `Failed to fetch ${taxName} terms: ${res.statusText}`,
+                code: 'TAXONOMY_FETCH_FAILED',
+                status: res.status,
+                endpoint: url,
+                suggestion: 'Verify network connection and that the taxonomies API is enabled.',
+            });
+        }
+        const json = await res.json();
+        const data = unwrapEnvelope(json);
+        const rawTerms = (Array.isArray(data.terms) ? data.terms : Array.isArray(data) ? data : []);
+        return rawTerms;
+    };
+    const [categories, tags] = await Promise.all([
+        fetchTerms('category').catch(() => []),
+        fetchTerms('tag').catch(() => []),
+    ]);
+    const categoriesDir = path.join(options.workspaceRoot, 'categories');
+    const tagsDir = path.join(options.workspaceRoot, 'tags');
+    fs.mkdirSync(categoriesDir, { recursive: true });
+    fs.mkdirSync(tagsDir, { recursive: true });
+    // Save categories and prune deleted ones
+    const activeCategoryFileNames = new Set();
+    for (const cat of categories) {
+        const label = cat.label || cat.slug;
+        const sanitized = sanitizeTitleForFilename(label);
+        const fileName = `${cat.id}-${sanitized}.yaml`;
+        activeCategoryFileNames.add(fileName);
+        const filePath = path.join(categoriesDir, fileName);
+        const doc = {
+            id: cat.id,
+            name: label,
+            slug: cat.slug,
+            taxonomy: 'category',
+            parentId: cat.parentId || null,
+            count: cat.count ?? 0,
+        };
+        fs.writeFileSync(filePath, yaml.dump(doc, { indent: 2, quotingType: '"', forceQuotes: false }), 'utf8');
+    }
+    // Prune local category YAMLs not present on remote
+    let deletedCategoriesCount = 0;
+    if (fs.existsSync(categoriesDir)) {
+        for (const file of fs.readdirSync(categoriesDir)) {
+            if (file.endsWith('.yaml') && !activeCategoryFileNames.has(file)) {
+                try {
+                    fs.unlinkSync(path.join(categoriesDir, file));
+                    deletedCategoriesCount++;
+                }
+                catch {
+                    // Ignore unlink errors
+                }
+            }
+        }
+    }
+    // Save tags and prune deleted ones
+    const activeTagFileNames = new Set();
+    for (const tag of tags) {
+        const label = tag.label || tag.slug;
+        const sanitized = sanitizeTitleForFilename(label);
+        const fileName = `${tag.id}-${sanitized}.yaml`;
+        activeTagFileNames.add(fileName);
+        const filePath = path.join(tagsDir, fileName);
+        const doc = {
+            id: tag.id,
+            name: label,
+            slug: tag.slug,
+            taxonomy: 'tag',
+            parentId: tag.parentId || null,
+            count: tag.count ?? 0,
+        };
+        fs.writeFileSync(filePath, yaml.dump(doc, { indent: 2, quotingType: '"', forceQuotes: false }), 'utf8');
+    }
+    // Prune local tag YAMLs not present on remote
+    let deletedTagsCount = 0;
+    if (fs.existsSync(tagsDir)) {
+        for (const file of fs.readdirSync(tagsDir)) {
+            if (file.endsWith('.yaml') && !activeTagFileNames.has(file)) {
+                try {
+                    fs.unlinkSync(path.join(tagsDir, file));
+                    deletedTagsCount++;
+                }
+                catch {
+                    // Ignore unlink errors
+                }
+            }
+        }
+    }
+    return {
+        categoriesCount: categories.length,
+        tagsCount: tags.length,
+        deletedCategoriesCount,
+        deletedTagsCount,
+    };
+}
+/**
+ * Loads local taxonomy mapping between term ULID and slug from categories/ and tags/ directories.
+ */
+export function loadLocalTaxonomyMaps(workspaceRoot) {
+    const categoriesDir = path.join(workspaceRoot, 'categories');
+    const tagsDir = path.join(workspaceRoot, 'tags');
+    const readDirMap = (dir) => {
+        const slugToId = {};
+        const idToSlug = {};
+        if (!fs.existsSync(dir))
+            return { slugToId, idToSlug };
+        try {
+            const files = fs.readdirSync(dir).filter((f) => f.endsWith('.yaml'));
+            for (const file of files) {
+                try {
+                    const content = fs.readFileSync(path.join(dir, file), 'utf8');
+                    const data = yaml.load(content);
+                    if (data && typeof data.id === 'string' && typeof data.slug === 'string') {
+                        slugToId[data.slug] = data.id;
+                        idToSlug[data.id] = data.slug;
+                    }
+                }
+                catch {
+                    // Ignore malformed files
+                }
+            }
+        }
+        catch {
+            // Ignore directory read errors
+        }
+        return { slugToId, idToSlug };
+    };
+    const catMap = readDirMap(categoriesDir);
+    const tagMap = readDirMap(tagsDir);
+    return {
+        slugToId: {
+            category: catMap.slugToId,
+            tag: tagMap.slugToId,
+        },
+        idToSlug: {
+            category: catMap.idToSlug,
+            tag: tagMap.idToSlug,
+        },
+    };
+}
+/**
+ * Loads local taxonomy candidate names (slugs or labels) from categories/ and tags/ directories.
+ */
+export function loadLocalTaxonomyCandidates(workspaceRoot) {
+    const categoriesDir = path.join(workspaceRoot, 'categories');
+    const tagsDir = path.join(workspaceRoot, 'tags');
+    const readDirCandidates = (dir) => {
+        if (!fs.existsSync(dir))
+            return [];
+        try {
+            const files = fs.readdirSync(dir).filter((f) => f.endsWith('.yaml'));
+            const candidates = [];
+            for (const file of files) {
+                try {
+                    const content = fs.readFileSync(path.join(dir, file), 'utf8');
+                    const data = yaml.load(content);
+                    if (data && typeof data.slug === 'string') {
+                        candidates.push(data.slug);
+                    }
+                }
+                catch {
+                    // Ignore malformed files
+                }
+            }
+            return candidates;
+        }
+        catch {
+            return [];
+        }
+    };
+    return {
+        categories: readDirCandidates(categoriesDir),
+        tags: readDirCandidates(tagsDir),
+    };
+}
+//# sourceMappingURL=taxonomies.js.map

package/dist/sync/taxonomies.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,18 @@
+export interface EmitConfig {
+    origin: string;
+    defaultCollection: string;
+    defaultLocale: string;
+    syncLimit?: number;
+    postsSyncLimit?: number;
+    mediaSyncLimit?: number;
+    concurrency?: number;
+}
+/**
+ * Initializes a new .emit workspace directory with default config.
+ */
+export declare function initWorkspace(workspaceRoot: string, initialConfig?: Partial<EmitConfig>): void;
+/**
+ * Loads the EmitConfig from the active workspace.
+ */
+export declare function loadConfig(workspaceRoot?: string): EmitConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAkB9F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,CAyB7D"}

package/dist/utils/config.js

@@ -0,0 +1,79 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { getWorkspacePaths, requireWorkspaceRoot } from './workspace.js';
+const DEFAULT_CONFIG = {
+    origin: 'https://example.com',
+    defaultCollection: 'posts',
+    defaultLocale: 'ja',
+    postsSyncLimit: 100,
+    mediaSyncLimit: 300,
+    concurrency: 8,
+};
+/**
+ * Initializes a new .emit workspace directory with default config.
+ */
+export function initWorkspace(workspaceRoot, initialConfig) {
+    const paths = getWorkspacePaths(workspaceRoot);
+    if (!fs.existsSync(paths.emitDir)) {
+        fs.mkdirSync(paths.emitDir, { recursive: true });
+    }
+    const postsDraftDir = path.join(paths.postsDir, 'draft');
+    const postsPublishedDir = path.join(paths.postsDir, 'published');
+    fs.mkdirSync(postsDraftDir, { recursive: true });
+    fs.mkdirSync(postsPublishedDir, { recursive: true });
+    const config = {
+        ...DEFAULT_CONFIG,
+        ...initialConfig,
+    };
+    fs.writeFileSync(paths.configPath, JSON.stringify(config, null, 2), 'utf8');
+}
+/**
+ * Loads the EmitConfig from the active workspace.
+ */
+export function loadConfig(workspaceRoot) {
+    const root = workspaceRoot || requireWorkspaceRoot();
+    const paths = getWorkspacePaths(root);
+    if (!fs.existsSync(paths.configPath)) {
+        return {
+            ...DEFAULT_CONFIG,
+            origin: process.env.EMDASH_ORIGIN || DEFAULT_CONFIG.origin,
+        };
+    }
+    try {
+        const raw = fs.readFileSync(paths.configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            origin: process.env.EMDASH_ORIGIN || parsed.origin || DEFAULT_CONFIG.origin,
+            defaultCollection: parsed.defaultCollection || DEFAULT_CONFIG.defaultCollection,
+            defaultLocale: parsed.defaultLocale || DEFAULT_CONFIG.defaultLocale,
+            postsSyncLimit: parsed.postsSyncLimit || DEFAULT_CONFIG.postsSyncLimit,
+            mediaSyncLimit: parsed.mediaSyncLimit || DEFAULT_CONFIG.mediaSyncLimit,
+            concurrency: parsed.concurrency || DEFAULT_CONFIG.concurrency,
+        };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAYzE,MAAM,cAAc,GAAe;IACjC,MAAM,EAAE,qBAAqB;IAC7B,iBAAiB,EAAE,OAAO;IAC1B,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,GAAG;IACnB,cAAc,EAAE,GAAG;IACnB,WAAW,EAAE,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB,EAAE,aAAmC;IACtF,MAAM,KAAK,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAE/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjE,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAErD,MAAM,MAAM,GAAe;QACzB,GAAG,cAAc;QACjB,GAAG,aAAa;KACjB,CAAC;IAEF,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,aAAsB;IAC/C,MAAM,IAAI,GAAG,aAAa,IAAI,oBAAoB,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,GAAG,cAAc;YACjB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,cAAc,CAAC,MAAM;SAC3D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;QACtD,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM;YAC3E,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,cAAc,CAAC,iBAAiB;YAC/E,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,cAAc,CAAC,aAAa;YACnE,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,cAAc,CAAC,cAAc;YACtE,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,cAAc,CAAC,cAAc;YACtE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;SAC9D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+export declare const FrontmatterSeoSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    canonical: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    noIndex: z.ZodOptional<z.ZodBoolean>;
+    image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | null | undefined;
+    description?: string | null | undefined;
+    canonical?: string | null | undefined;
+    noIndex?: boolean | undefined;
+    image?: string | null | undefined;
+}, {
+    title?: string | null | undefined;
+    description?: string | null | undefined;
+    canonical?: string | null | undefined;
+    noIndex?: boolean | undefined;
+    image?: string | null | undefined;
+}>;
+export declare const FrontmatterSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    title: z.ZodString;
+    collection: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<["draft", "published"]>>;
+    publishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    locale: z.ZodDefault<z.ZodString>;
+    taxonomies: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>>;
+    seo: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        canonical: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        noIndex: z.ZodOptional<z.ZodBoolean>;
+        image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        title?: string | null | undefined;
+        description?: string | null | undefined;
+        canonical?: string | null | undefined;
+        noIndex?: boolean | undefined;
+        image?: string | null | undefined;
+    }, {
+        title?: string | null | undefined;
+        description?: string | null | undefined;
+        canonical?: string | null | undefined;
+        noIndex?: boolean | undefined;
+        image?: string | null | undefined;
+    }>>;
+    bylines: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    slug: string;
+    title: string;
+    collection: string;
+    status: "draft" | "published";
+    publishedAt?: string | null | undefined;
+    locale: string;
+    taxonomies: Record<string, string[]>;
+    seo?: {
+        title?: string | null | undefined;
+        description?: string | null | undefined;
+        canonical?: string | null | undefined;
+        noIndex?: boolean | undefined;
+        image?: string | null | undefined;
+    } | undefined;
+    bylines: string[];
+}, {
+    id: string;
+    slug: string;
+    title: string;
+    collection?: string | undefined;
+    status?: "draft" | "published" | undefined;
+    publishedAt?: string | null | undefined;
+    locale?: string | undefined;
+    taxonomies?: Record<string, string[]> | undefined;
+    seo?: {
+        title?: string | null | undefined;
+        description?: string | null | undefined;
+        canonical?: string | null | undefined;
+        noIndex?: boolean | undefined;
+        image?: string | null | undefined;
+    } | undefined;
+    bylines?: string[] | undefined;
+}>;
+export type Frontmatter = z.infer<typeof FrontmatterSchema>;
+export interface TaxonomyCandidates {
+    categories?: string[];
+    tags?: string[];
+    bylines?: string[];
+    [key: string]: string[] | undefined;
+}
+export interface ParsedMarkdown {
+    frontmatter: Frontmatter;
+    body: string;
+    rawYaml: string;
+}
+/**
+ * Parses markdown text into validated frontmatter and body.
+ */
+export declare function parseMarkdown(content: string): ParsedMarkdown;
+/**
+ * Formats a frontmatter object into clean YAML with helpful candidate comments.
+ */
+export declare function formatFrontmatterYaml(data: Frontmatter, candidates?: TaxonomyCandidates): string;
+/**
+ * Serializes frontmatter and markdown body into a full document.
+ */
+export declare function serializeMarkdown(frontmatter: Frontmatter, body: string, candidates?: TaxonomyCandidates): string;
+/**
+ * Sanitizes an article title for cross-platform safe filenames,
+ * preserving Japanese characters while replacing invalid filesystem chars and whitespace with hyphens.
+ */
+export declare function sanitizeTitleForFilename(title: string): string;
+export { formatDatePrefix, extractDatePrefixFromPath, computeArticleRelativePath, } from './naming.js';
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAS7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAsDhG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,kBAAkB,GAC9B,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2B9D;AAED,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/dist/utils/frontmatter.js

@@ -0,0 +1,147 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import matter from 'gray-matter';
+import { z } from 'zod';
+export const FrontmatterSeoSchema = z.object({
+    title: z.string().nullable().optional(),
+    description: z.string().nullable().optional(),
+    canonical: z.string().url().nullable().optional(),
+    noIndex: z.boolean().optional(),
+    image: z.string().nullable().optional(),
+});
+export const FrontmatterSchema = z.object({
+    id: z.string().length(26, 'ID must be a 26-character ULID'),
+    slug: z.string().min(1, 'Slug cannot be empty'),
+    title: z.string().min(1, 'Title cannot be empty'),
+    collection: z.string().default('posts'),
+    status: z.enum(['draft', 'published']).default('draft'),
+    publishedAt: z.string().nullable().optional(),
+    locale: z.string().default('ja'),
+    taxonomies: z.record(z.array(z.string())).optional().default({}),
+    seo: FrontmatterSeoSchema.optional(),
+    bylines: z.array(z.string()).optional().default([]),
+});
+/**
+ * Parses markdown text into validated frontmatter and body.
+ */
+export function parseMarkdown(content) {
+    const parsed = matter(content);
+    const validated = FrontmatterSchema.parse(parsed.data);
+    return {
+        frontmatter: validated,
+        body: parsed.content,
+        rawYaml: matter.stringify('', parsed.data).trim(),
+    };
+}
+/**
+ * Formats a frontmatter object into clean YAML with helpful candidate comments.
+ */
+export function formatFrontmatterYaml(data, candidates) {
+    const lines = ['---'];
+    lines.push(`id: ${data.id}`);
+    lines.push(`slug: ${data.slug}`);
+    lines.push(`title: ${JSON.stringify(data.title)}`);
+    lines.push(`collection: ${data.collection}`);
+    lines.push(`status: ${data.status}`);
+    lines.push(`publishedAt: ${data.publishedAt ? JSON.stringify(data.publishedAt) : 'null'}`);
+    lines.push(`locale: ${data.locale}`);
+    // Taxonomies
+    lines.push('taxonomies:');
+    const taxonomies = data.taxonomies || {};
+    const allTaxKeys = Array.from(new Set([...Object.keys(taxonomies), 'categories', 'tags']));
+    for (const taxKey of allTaxKeys) {
+        lines.push(`  ${taxKey}:`);
+        const terms = taxonomies[taxKey] || [];
+        if (terms.length === 0) {
+            lines.push('    []');
+        }
+        else {
+            for (const term of terms) {
+                lines.push(`    - ${term}`);
+            }
+        }
+    }
+    // SEO
+    if (data.seo) {
+        lines.push('seo:');
+        if (data.seo.title !== undefined)
+            lines.push(`  title: ${JSON.stringify(data.seo.title)}`);
+        if (data.seo.description !== undefined)
+            lines.push(`  description: ${JSON.stringify(data.seo.description)}`);
+        if (data.seo.canonical !== undefined)
+            lines.push(`  canonical: ${JSON.stringify(data.seo.canonical)}`);
+        if (data.seo.noIndex !== undefined)
+            lines.push(`  noIndex: ${data.seo.noIndex}`);
+        if (data.seo.image !== undefined)
+            lines.push(`  image: ${JSON.stringify(data.seo.image)}`);
+    }
+    // Bylines
+    lines.push('bylines:');
+    const bylines = data.bylines || [];
+    if (bylines.length === 0) {
+        lines.push('  []');
+    }
+    else {
+        for (const byline of bylines) {
+            lines.push(`  - ${byline}`);
+        }
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+/**
+ * Serializes frontmatter and markdown body into a full document.
+ */
+export function serializeMarkdown(frontmatter, body, candidates) {
+    const yaml = formatFrontmatterYaml(frontmatter, candidates);
+    const cleanBody = body.startsWith('\n') ? body : `\n${body}`;
+    return `${yaml}${cleanBody.endsWith('\n') ? cleanBody : cleanBody + '\n'}`;
+}
+/**
+ * Sanitizes an article title for cross-platform safe filenames,
+ * preserving Japanese characters while replacing invalid filesystem chars and whitespace with hyphens.
+ */
+export function sanitizeTitleForFilename(title) {
+    if (!title || !title.trim()) {
+        return 'untitled';
+    }
+    // Basic HTML entity decoding (e.g. & -> &, " -> ", – -> -)
+    let clean = title
+        .replace(/&/g, '&')
+        .replace(/"/g, '"')
+        .replace(/'/g, "'")
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&#8211;/g, '-')
+        .replace(/&#8212;/g, '-');
+    // Replace whitespace and filesystem invalid characters (\ / : * ? " < > |) with hyphens
+    clean = clean.replace(/[\s/\\:*?"<>|]+/g, '-');
+    // Collapse multiple hyphens and trim leading/trailing hyphens
+    clean = clean.replace(/-{2,}/g, '-').replace(/^-+|-+$/g, '');
+    const maxLen = 100;
+    if (clean.length > maxLen) {
+        clean = clean.slice(0, maxLen).replace(/-+$/, '');
+    }
+    return clean || 'untitled';
+}
+export { formatDatePrefix, extractDatePrefixFromPath, computeArticleRelativePath, } from './naming.js';
+//# sourceMappingURL=frontmatter.js.map