@interactive-inc/docs-client 0.0.5 → 0.0.7

package/build/values/doc-front-matter-md-value-accessor.test.js

@@ -1,226 +0,0 @@
-import { expect, test } from "bun:test";
-import { DocFrontMatterMdValue } from "./doc-front-matter-md-value";
-test("text メソッドは文字列型の値のみを返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        title: "正しいタイトル",
-        count: 123,
-        flag: true,
-        list: ["item1", "item2"],
-        obj: { key: "value" },
-        nullable: null,
-    });
-    // 文字列型は正しく取得
-    expect(frontMatter.text("title")).toBe("正しいタイトル");
-    // 他の型はnullを返す
-    expect(frontMatter.text("count")).toBeNull();
-    expect(frontMatter.text("flag")).toBeNull();
-    expect(frontMatter.text("list")).toBeNull();
-    expect(frontMatter.text("obj")).toBeNull();
-    expect(frontMatter.text("nullable")).toBeNull();
-    expect(frontMatter.text("missing")).toBeNull();
-});
-test("number メソッドは数値型の値のみを返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        count: 42,
-        price: 99.99,
-        title: "文字列",
-        flag: false,
-        list: [1, 2, 3],
-    });
-    // 数値型は正しく取得
-    expect(frontMatter.number("count")).toBe(42);
-    expect(frontMatter.number("price")).toBe(99.99);
-    // 他の型はnullを返す
-    expect(frontMatter.number("title")).toBeNull();
-    expect(frontMatter.number("flag")).toBeNull();
-    expect(frontMatter.number("list")).toBeNull();
-});
-test("boolean メソッドは真偽値型の値のみを返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        published: true,
-        draft: false,
-        title: "文字列",
-        count: 0,
-        zero: 0,
-        empty: "",
-    });
-    // 真偽値型は正しく取得
-    expect(frontMatter.boolean("published")).toBe(true);
-    expect(frontMatter.boolean("draft")).toBe(false);
-    // 他の型はnullを返す（0や空文字列も）
-    expect(frontMatter.boolean("title")).toBeNull();
-    expect(frontMatter.boolean("count")).toBeNull();
-    expect(frontMatter.boolean("zero")).toBeNull();
-    expect(frontMatter.boolean("empty")).toBeNull();
-});
-test("relation メソッドは文字列型の値を返す（単一リレーション）", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        author: "user-123",
-        category: "tech-blog",
-        tags: ["tag1", "tag2"],
-        count: 123,
-    });
-    // 文字列型のリレーションは正しく取得
-    expect(frontMatter.relation("author")).toBe("user-123");
-    expect(frontMatter.relation("category")).toBe("tech-blog");
-    // 配列や他の型はnullを返す
-    expect(frontMatter.relation("tags")).toBeNull();
-    expect(frontMatter.relation("count")).toBeNull();
-});
-test("multiRelation メソッドは文字列配列のみを返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        features: ["login", "logout", "signup"],
-        tags: ["tech", "tutorial", "beginner"],
-        emptyArray: [],
-        singleString: "not-array",
-        numberArray: [1, 2, 3],
-    });
-    // 文字列配列は正しく取得
-    expect(frontMatter.multiRelation("features")).toEqual([
-        "login",
-        "logout",
-        "signup",
-    ]);
-    expect(frontMatter.multiRelation("tags")).toEqual([
-        "tech",
-        "tutorial",
-        "beginner",
-    ]);
-    expect(frontMatter.multiRelation("emptyArray")).toEqual([]);
-    // 単一値や数値配列は空配列を返す
-    expect(frontMatter.multiRelation("singleString")).toEqual([]);
-    expect(frontMatter.multiRelation("numberArray")).toEqual([]);
-    expect(frontMatter.multiRelation("missing")).toEqual([]);
-});
-test("multiText メソッドは文字列配列を返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        keywords: ["typescript", "javascript", "nodejs"],
-        authors: ["alice", "bob", "charlie"],
-        empty: [],
-        notArray: "single-value",
-    });
-    // 文字列配列は正しく取得
-    expect(frontMatter.multiText("keywords")).toEqual([
-        "typescript",
-        "javascript",
-        "nodejs",
-    ]);
-    expect(frontMatter.multiText("authors")).toEqual(["alice", "bob", "charlie"]);
-    expect(frontMatter.multiText("empty")).toEqual([]);
-    // 非配列は空配列を返す
-    expect(frontMatter.multiText("notArray")).toEqual([]);
-    expect(frontMatter.multiText("missing")).toEqual([]);
-});
-test("multiNumber メソッドは数値配列のみを返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        scores: [85, 90, 78],
-        prices: [19.99, 29.99, 39.99],
-        empty: [],
-        stringArray: ["1", "2", "3"],
-        singleNumber: 42,
-    });
-    // 数値配列は正しく取得
-    expect(frontMatter.multiNumber("scores")).toEqual([85, 90, 78]);
-    expect(frontMatter.multiNumber("prices")).toEqual([19.99, 29.99, 39.99]);
-    expect(frontMatter.multiNumber("empty")).toEqual([]);
-    // 文字列配列や単一値は空配列を返す
-    expect(frontMatter.multiNumber("stringArray")).toEqual([]);
-    expect(frontMatter.multiNumber("singleNumber")).toEqual([]);
-    expect(frontMatter.multiNumber("missing")).toEqual([]);
-});
-test("multiBoolean メソッドは真偽値配列のみを返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        flags: [true, false, true, true],
-        permissions: [false, false],
-        empty: [],
-        stringArray: ["true", "false"],
-        singleBool: true,
-    });
-    // 真偽値配列は正しく取得
-    expect(frontMatter.multiBoolean("flags")).toEqual([true, false, true, true]);
-    expect(frontMatter.multiBoolean("permissions")).toEqual([false, false]);
-    expect(frontMatter.multiBoolean("empty")).toEqual([]);
-    // 文字列配列や単一値は空配列を返す
-    expect(frontMatter.multiBoolean("stringArray")).toEqual([]);
-    expect(frontMatter.multiBoolean("singleBool")).toEqual([]);
-    expect(frontMatter.multiBoolean("missing")).toEqual([]);
-});
-test("has メソッドはプロパティの存在を正しく判定", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        title: "タイトル",
-        count: 0,
-        flag: false,
-        empty: "",
-        nullable: null,
-        list: [],
-    });
-    // 値が存在すればtrueを返す（falsy値でも）
-    expect(frontMatter.has("title")).toBe(true);
-    expect(frontMatter.has("count")).toBe(true);
-    expect(frontMatter.has("flag")).toBe(true);
-    expect(frontMatter.has("empty")).toBe(true);
-    expect(frontMatter.has("nullable")).toBe(true);
-    expect(frontMatter.has("list")).toBe(true);
-    // 存在しないキーはfalse
-    expect(frontMatter.has("missing")).toBe(false);
-    expect(frontMatter.has("notDefined")).toBe(false);
-});
-test("keys ゲッターはすべてのキーを返す", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        title: "テスト",
-        version: 1.0,
-        published: true,
-        tags: ["tag1", "tag2"],
-    });
-    const keys = frontMatter.keys;
-    expect(keys).toHaveLength(4);
-    expect(keys).toContain("title");
-    expect(keys).toContain("version");
-    expect(keys).toContain("published");
-    expect(keys).toContain("tags");
-    // 順序は保証されないので、セットで比較
-    expect(new Set(keys)).toEqual(new Set(["title", "version", "published", "tags"]));
-});
-test("特殊なケース：存在しないキーへのアクセス", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        title: "テスト",
-    });
-    expect(frontMatter.has("title")).toBe(true);
-    expect(frontMatter.has("undefinedValue")).toBe(false);
-    expect(frontMatter.text("undefinedValue")).toBeNull();
-});
-test("型の厳密な検証：文字列の数値は数値として扱われない", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        stringNumber: "123",
-        stringBool: "true",
-        actualNumber: 123,
-        actualBool: true,
-    });
-    // 文字列の"123"は数値として取得できない
-    expect(frontMatter.number("stringNumber")).toBeNull();
-    expect(frontMatter.text("stringNumber")).toBe("123");
-    // 文字列の"true"は真偽値として取得できない
-    expect(frontMatter.boolean("stringBool")).toBeNull();
-    expect(frontMatter.text("stringBool")).toBe("true");
-    // 実際の数値と真偽値は正しく取得
-    expect(frontMatter.number("actualNumber")).toBe(123);
-    expect(frontMatter.boolean("actualBool")).toBe(true);
-});
-test("ネストしたオブジェクトは適切に扱われる", () => {
-    const frontMatter = new DocFrontMatterMdValue({
-        meta: {
-            author: "John",
-            version: 1.0,
-        },
-        config: {
-            enabled: true,
-            settings: ["a", "b"],
-        },
-    });
-    // ネストしたオブジェクトは文字列や他の型として取得できない
-    expect(frontMatter.text("meta")).toBeNull();
-    expect(frontMatter.text("config")).toBeNull();
-    // ただし、存在はする
-    expect(frontMatter.has("meta")).toBe(true);
-    expect(frontMatter.has("config")).toBe(true);
-});

package/build/values/doc-front-matter-md-value.d.ts

@@ -1,80 +0,0 @@
-import type { DocFileMdFrontMatter } from "../types";
-import type { DocSchemaValue } from "./doc-schema-value";
-/**
- * FrontMatter
- */
-export declare class DocFrontMatterMdValue {
-    readonly value: DocFileMdFrontMatter;
-    constructor(value: DocFileMdFrontMatter);
-    toJson(): DocFileMdFrontMatter;
-    toYaml(): string;
-    /**
-     * Markdownテキストから生成
-     */
-    static from(markdownText: string): DocFrontMatterMdValue;
-    /**
-     * 空のFrontMatterを生成
-     */
-    static empty(): DocFrontMatterMdValue;
-    /**
-     * データから直接生成
-     */
-    static fromData(data: unknown): DocFrontMatterMdValue;
-    /**
-     * スキーマフィールドに基づいてデフォルト値を生成する
-     */
-    static generateDefaultValueFromSchemaField(fieldDef: {
-        type: string;
-        default?: unknown;
-    }): unknown;
-    /**
-     * 単一のプロパティを更新した新しいインスタンスを返す
-     * スキーマに基づいて型を検証し、スキーマのフィールドのみを含む新しいインスタンスを生成
-     */
-    withProperty(key: string, value: unknown, schema: DocSchemaValue): DocFrontMatterMdValue;
-    /**
-     * フィールド値の検証
-     */
-    private validateFieldValue;
-    /**
-     * テキスト型のプロパティを取得
-     */
-    text(key: string): string | null;
-    /**
-     * 数値型のプロパティを取得
-     */
-    number(key: string): number | null;
-    /**
-     * 真偽値型のプロパティを取得
-     */
-    boolean(key: string): boolean | null;
-    /**
-     * 単一リレーション型のプロパティを取得
-     */
-    relation(key: string): string | null;
-    /**
-     * 複数リレーション型のプロパティを取得
-     */
-    multiRelation(key: string): string[];
-    /**
-     * 複数テキスト型のプロパティを取得
-     */
-    multiText(key: string): string[];
-    /**
-     * 複数数値型のプロパティを取得
-     */
-    multiNumber(key: string): number[];
-    /**
-     * 複数真偽値型のプロパティを取得
-     */
-    multiBoolean(key: string): boolean[];
-    /**
-     * プロパティが存在するかチェック
-     */
-    has(key: string): boolean;
-    /**
-     * すべてのキーを取得
-     */
-    get keys(): string[];
-}
-//# sourceMappingURL=doc-front-matter-md-value.d.ts.map

package/build/values/doc-front-matter-md-value.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc-front-matter-md-value.d.ts","sourceRoot":"","sources":["../../lib/values/doc-front-matter-md-value.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,oBAAoB,EAIrB,MAAM,UAAU,CAAA;AAUjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD;;GAEG;AACH,qBAAa,qBAAqB;IACpB,QAAQ,CAAC,KAAK,EAAE,oBAAoB;IAAhD,YAAqB,KAAK,EAAE,oBAAoB,EAG/C;IAED,MAAM,IAAI,oBAAoB,CAE7B;IAED,MAAM,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAQvD;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,qBAAqB,CAEpC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,CAGpD;IAED;;OAEG;IACH,MAAM,CAAC,mCAAmC,CAAC,QAAQ,EAAE;QACnD,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,GAAG,OAAO,CAsBV;IAED;;;OAGG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,cAAc,GACrB,qBAAqB,CA4CvB;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU/B;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUjC;IAED;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAYnC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnC;IAED;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYnC;IAED;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAY/B;IAED;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYjC;IAED;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAYnC;IAED;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,EAAE,CAEnB;CACF"}

package/build/values/doc-front-matter-md-value.js

@@ -1,257 +0,0 @@
-import { stringify } from "yaml";
-import { zDocFileMdFrontMatter } from "../models";
-import { DocContentMdValue } from "./doc-content-md-value";
-import { DocSchemaFieldBooleanMultipleValue } from "./doc-schema-field-boolean-multiple-value";
-import { DocSchemaFieldBooleanSingleValue } from "./doc-schema-field-boolean-single-value";
-import { DocSchemaFieldFactory } from "./doc-schema-field-factory";
-import { DocSchemaFieldNumberMultipleValue } from "./doc-schema-field-number-multiple-value";
-import { DocSchemaFieldNumberSingleValue } from "./doc-schema-field-number-single-value";
-import { DocSchemaFieldTextMultipleValue } from "./doc-schema-field-text-multiple-value";
-import { DocSchemaFieldTextSingleValue } from "./doc-schema-field-text-single-value";
-/**
- * FrontMatter
- */
-export class DocFrontMatterMdValue {
-    value;
-    constructor(value) {
-        this.value = value;
-        zDocFileMdFrontMatter.parse(value);
-        Object.freeze(this);
-    }
-    toJson() {
-        return this.value;
-    }
-    toYaml() {
-        return stringify(this.value).trim();
-    }
-    /**
-     * Markdownテキストから生成
-     */
-    static from(markdownText) {
-        const openMarkdown = new DocContentMdValue(markdownText);
-        const rawData = openMarkdown.frontMatter.data || {};
-        const data = zDocFileMdFrontMatter.parse(rawData);
-        return new DocFrontMatterMdValue(data);
-    }
-    /**
-     * 空のFrontMatterを生成
-     */
-    static empty() {
-        return new DocFrontMatterMdValue({});
-    }
-    /**
-     * データから直接生成
-     */
-    static fromData(data) {
-        const validatedData = zDocFileMdFrontMatter.parse(data);
-        return new DocFrontMatterMdValue(validatedData);
-    }
-    /**
-     * スキーマフィールドに基づいてデフォルト値を生成する
-     */
-    static generateDefaultValueFromSchemaField(fieldDef) {
-        if (fieldDef.type === "text") {
-            return fieldDef.default ?? "";
-        }
-        if (fieldDef.type === "boolean") {
-            return fieldDef.default ?? false;
-        }
-        if (fieldDef.type === "number") {
-            return fieldDef.default ?? 0;
-        }
-        if (fieldDef.type === "multi-text" ||
-            fieldDef.type === "multi-number" ||
-            fieldDef.type === "multi-boolean" ||
-            fieldDef.type === "multi-relation") {
-            return fieldDef.default ?? [];
-        }
-        if (fieldDef.type === "relation") {
-            return fieldDef.default ?? null;
-        }
-        return null;
-    }
-    /**
-     * 単一のプロパティを更新した新しいインスタンスを返す
-     * スキーマに基づいて型を検証し、スキーマのフィールドのみを含む新しいインスタンスを生成
-     */
-    withProperty(key, value, schema) {
-        const currentData = this.toJson();
-        const fieldValue = schema.field(key);
-        if (fieldValue === null) {
-            return this;
-        }
-        if (!this.validateFieldValue(key, value, fieldValue)) {
-            return this;
-        }
-        // スキーマを元にFrontMatterを再構築
-        const draft = {};
-        for (const field of schema.fields) {
-            const fieldKey = field.key;
-            if (fieldKey === key) {
-                // 更新対象のフィールドは新しい値を使用
-                // valueは事前にvalidateFieldValueで検証済み
-                draft[fieldKey] = value;
-            }
-            else if (fieldKey in currentData) {
-                // 既存の値があればそれを使用
-                const value = currentData[fieldKey];
-                if (value !== undefined) {
-                    draft[fieldKey] = value;
-                }
-            }
-            else {
-                // 値がない場合はデフォルト値を使用
-                draft[fieldKey] = field.toJson().default;
-            }
-        }
-        return new DocFrontMatterMdValue(draft);
-    }
-    /**
-     * フィールド値の検証
-     */
-    validateFieldValue(key, value, fieldDef) {
-        try {
-            const factory = new DocSchemaFieldFactory();
-            const schemaField = factory.fromSchemaEntry(key, fieldDef);
-            return schemaField.validate(value);
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * テキスト型のプロパティを取得
-     */
-    text(key) {
-        const value = this.value[key];
-        const validator = new DocSchemaFieldTextSingleValue(key, {
-            type: "text",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && typeof value === "string" ? value : null;
-    }
-    /**
-     * 数値型のプロパティを取得
-     */
-    number(key) {
-        const value = this.value[key];
-        const validator = new DocSchemaFieldNumberSingleValue(key, {
-            type: "number",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && typeof value === "number" ? value : null;
-    }
-    /**
-     * 真偽値型のプロパティを取得
-     */
-    boolean(key) {
-        const value = this.value[key];
-        const validator = new DocSchemaFieldBooleanSingleValue(key, {
-            type: "boolean",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && typeof value === "boolean"
-            ? value
-            : null;
-    }
-    /**
-     * 単一リレーション型のプロパティを取得
-     */
-    relation(key) {
-        const value = this.value[key];
-        // リレーションもテキスト型と同じバリデーション
-        const validator = new DocSchemaFieldTextSingleValue(key, {
-            type: "text",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && typeof value === "string" ? value : null;
-    }
-    /**
-     * 複数リレーション型のプロパティを取得
-     */
-    multiRelation(key) {
-        const value = this.value[key];
-        const validator = new DocSchemaFieldTextMultipleValue(key, {
-            type: "multi-text",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && Array.isArray(value)
-            ? value
-            : [];
-    }
-    /**
-     * 複数テキスト型のプロパティを取得
-     */
-    multiText(key) {
-        const value = this.value[key];
-        const validator = new DocSchemaFieldTextMultipleValue(key, {
-            type: "multi-text",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && Array.isArray(value)
-            ? value
-            : [];
-    }
-    /**
-     * 複数数値型のプロパティを取得
-     */
-    multiNumber(key) {
-        const value = this.value[key];
-        const validator = new DocSchemaFieldNumberMultipleValue(key, {
-            type: "multi-number",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && Array.isArray(value)
-            ? value
-            : [];
-    }
-    /**
-     * 複数真偽値型のプロパティを取得
-     */
-    multiBoolean(key) {
-        const value = this.value[key];
-        const validator = new DocSchemaFieldBooleanMultipleValue(key, {
-            type: "multi-boolean",
-            required: false,
-            title: null,
-            description: null,
-            default: null,
-        });
-        return validator.validate(value) && Array.isArray(value)
-            ? value
-            : [];
-    }
-    /**
-     * プロパティが存在するかチェック
-     */
-    has(key) {
-        return key in this.value && this.value[key] !== undefined;
-    }
-    /**
-     * すべてのキーを取得
-     */
-    get keys() {
-        return Object.keys(this.value);
-    }
-}

package/build/values/doc-front-matter-md-value.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=doc-front-matter-md-value.test.d.ts.map

package/build/values/doc-front-matter-md-value.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc-front-matter-md-value.test.d.ts","sourceRoot":"","sources":["../../lib/values/doc-front-matter-md-value.test.ts"],"names":[],"mappings":""}