sizuku 0.0.1

package/dist/common/text/decapitalize.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Decapitalizes the first letter of a string
+ *
+ * @function decapitalize
+ * @param str - String to decapitalize
+ * @returns String with the first letter in lowercase
+ *
+ * @example
+ * decapitalize('Posts')    // Returns: 'posts'
+ * decapitalize('User')     // Returns: 'user'
+ * decapitalize('Api')      // Returns: 'api'
+ *
+ * @remarks
+ * - Leaves the rest of the string unchanged
+ * - Returns an empty string if the input is empty
+ */
+export declare function decapitalize(str: string): string

package/dist/common/text/decapitalize.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decapitalize = decapitalize;
+/**
+ * Decapitalizes the first letter of a string
+ *
+ * @function decapitalize
+ * @param str - String to decapitalize
+ * @returns String with the first letter in lowercase
+ *
+ * @example
+ * decapitalize('Posts')    // Returns: 'posts'
+ * decapitalize('User')     // Returns: 'user'
+ * decapitalize('Api')      // Returns: 'api'
+ *
+ * @remarks
+ * - Leaves the rest of the string unchanged
+ * - Returns an empty string if the input is empty
+ */
+function decapitalize(str) {
+    return `${str.charAt(0).toLowerCase()}${str.slice(1)}`;
+}

package/dist/common/type/index.d.ts

@@ -0,0 +1,9 @@
+export type SchemaField = {
+  name: string
+  definition: string
+  description?: string
+}
+export type Schema = {
+  name: string
+  fields: SchemaField[]
+}

package/dist/common/type/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generator/mermaid-er/config/index.d.ts

@@ -0,0 +1,10 @@
+export type Config = {
+  input?: string
+  output?: string
+}
+/**
+ * Loads the configuration from the `sizuku.json` file or returns the default configuration.
+ *
+ * @returns The configuration object.
+ */
+export declare function getConfig(): Config

package/dist/generator/mermaid-er/config/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+/**
+ * Loads the configuration from the `sizuku.json` file or returns the default configuration.
+ *
+ * @returns The configuration object.
+ */
+function getConfig() {
+    const config = node_fs_1.default.existsSync('sizuku-mermaid-er.json')
+        ? { ...JSON.parse(node_fs_1.default.readFileSync('sizuku-mermaid-er.json', 'utf-8')) }
+        : {};
+    return config;
+}

package/dist/generator/mermaid-er/core/extract-relations.d.ts

@@ -0,0 +1,8 @@
+import type { Relation } from '../type'
+/**
+ * Extracts relations from the given code.
+ *
+ * @param code - The code to extract relations from.
+ * @returns The extracted relations.
+ */
+export declare function extractRelations(code: string[]): Relation[]

package/dist/generator/mermaid-er/core/extract-relations.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractRelations = extractRelations;
+const parse_relation_line_1 = require("../validator/parse-relation-line");
+/**
+ * Extracts relations from the given code.
+ *
+ * @param code - The code to extract relations from.
+ * @returns The extracted relations.
+ */
+function extractRelations(code) {
+    const relations = [];
+    for (const line of code) {
+        const relation = (0, parse_relation_line_1.parseRelationLine)(line);
+        if (relation) {
+            relations.push(relation);
+        }
+    }
+    return relations;
+}

package/dist/generator/mermaid-er/generator/generate-er-content.d.ts

@@ -0,0 +1,9 @@
+import type { Relation, TableInfo } from '../type'
+/**
+ * Generate ER content
+ * @function generateERContent
+ * @param relations - The relations to generate the ER content from
+ * @param tables - The tables to generate the ER content from
+ * @returns The generated ER content
+ */
+export declare function generateERContent(relations: Relation[], tables: TableInfo[]): string

package/dist/generator/mermaid-er/generator/generate-er-content.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateERContent = generateERContent;
+const generate_relation_line_1 = require("./generate-relation-line");
+const ER_HEADER = ['```mermaid', 'erDiagram'];
+const ER_FOOTER = ['```'];
+/**
+ * Generate ER content
+ * @function generateERContent
+ * @param relations - The relations to generate the ER content from
+ * @param tables - The tables to generate the ER content from
+ * @returns The generated ER content
+ */
+function generateERContent(relations, tables) {
+    const erContent = [
+        ...ER_HEADER,
+        ...relations.map(generate_relation_line_1.generateRelationLine),
+        // Generate per-table definitions
+        ...tables.flatMap((table) => [
+            `    ${table.name} {`,
+            ...table.fields.map((field) => `        ${field.type} ${field.name} ${field.description ? `"${field.description}"` : ''}`),
+            '    }',
+        ]),
+        ...ER_FOOTER,
+    ];
+    return erContent.join('\n');
+}

package/dist/generator/mermaid-er/generator/generate-relation-line.d.ts

@@ -0,0 +1,7 @@
+import type { Relation } from '../type'
+/**
+ * Generate a relation line for a relation
+ * @param relation - The relation to generate a line for
+ * @returns The generated relation line
+ */
+export declare function generateRelationLine(relation: Relation): string

package/dist/generator/mermaid-er/generator/generate-relation-line.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateRelationLine = generateRelationLine;
+const __1 = require("..");
+/**
+ * Generate a relation line for a relation
+ * @param relation - The relation to generate a line for
+ * @returns The generated relation line
+ */
+function generateRelationLine(relation) {
+    const cardinality = __1.CARDINALITY_MAP[relation.type];
+    if (!cardinality) {
+        throw new Error(`Unknown relation type: ${relation.type}`);
+    }
+    return `    ${relation.fromModel} ${cardinality} ${relation.toModel} : "(${relation.fromField}) - (${relation.toField})"`;
+}

package/dist/generator/mermaid-er/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import type { Config } from './config'
+import type { RelationType } from './type'
+export declare const CARDINALITY_MAP: Record<RelationType, string>
+export declare const ER_HEADER: readonly ['```mermaid', 'erDiagram']
+export declare const ER_FOOTER: readonly ['```']
+export declare function main(dev?: boolean, config?: Config): Promise<boolean>

package/dist/generator/mermaid-er/index.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ER_FOOTER = exports.ER_HEADER = exports.CARDINALITY_MAP = void 0;
+exports.main = main;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const generate_er_content_1 = require("./generator/generate-er-content");
+const parse_table_info_1 = require("./validator/parse-table-info");
+const extract_relations_1 = require("./core/extract-relations");
+const config_1 = require("./config");
+const node_process_1 = require("node:process");
+exports.CARDINALITY_MAP = {
+    // both required
+    'one-to-one': '||--||', // 1--1
+    'one-to-many': '||--o{', // 1--*
+    'many-to-one': '}o--||', // *--1
+    'many-to-many': '}o--o{', // *--*
+    // one side optional
+    'one-to-zero-one': '||--o|', // 1--0..1
+    'zero-one-to-one': 'o|--||', // 0..1--1
+    'zero-to-many': 'o|--o{', // 0--*
+    'many-to-zero-one': '}o--o|', // *--0..1
+    'zero-one-to-many': 'o|--o{', // 0..1--*
+    // o o
+    'zero-to-one': 'o|--o|', // 0--0..1
+    'zero-to-zero-one': 'o|--o|', // 0--0..1
+    // ..
+    'one-to-many-optional': '||..o{', // 1..*
+    'one-to-one-optional': '||..||', // 1..1
+    'many-to-many-optional': '}o..o{', // *..*
+    'zero-one-to-zero-one': 'o|..o|', // 0..1--0..1
+    'many-to-zero-many': '}o..o{', // *--0..*
+    'zero-many-to-many': 'o{..}o', // 0..*--*
+    'zero-many-to-zero-many': 'o{..o{', // 0..*--0..*
+};
+// ER diagram header
+exports.ER_HEADER = ['```mermaid', 'erDiagram'];
+// ER diagram footer
+exports.ER_FOOTER = ['```'];
+async function main(dev = false, config = (0, config_1.getConfig)()) {
+    // 1. argv ['**/bin/node', '**/dist/src/generator/mermaid-er/index.js', 'db/schema.ts', '-o', 'mermaid-er/ER.md']
+    console.log(config.output);
+    if (config.output === undefined && !node_process_1.argv.includes('-o')) {
+        console.error('Error: -o is not found');
+        return false;
+    }
+    // 2. slice [ 'db/schema.ts', '-o', 'mermaid-er/ER.md']
+    const args = process.argv.slice(2);
+    // 3. input = args[0] = 'db/schema.ts'
+    const input = config.input ?? args[0];
+    config.input = input;
+    // 4. output = 'mermaid-er/ER.md'
+    const output = config.output ?? args[args.indexOf('-o') + 1];
+    config.output = output;
+    try {
+        // 5. read db/schema.ts
+        const content = (0, node_fs_1.readFileSync)(input, 'utf-8');
+        // 6. split lines
+        const lines = content.split('\n');
+        // 7. create output directory
+        const outputDir = node_path_1.default.dirname(output);
+        if (!(0, node_fs_1.existsSync)(outputDir)) {
+            (0, node_fs_1.mkdirSync)(outputDir, { recursive: true });
+        }
+        // 8. skip import section
+        const codeStart = lines.findIndex((line) => !line.trim().startsWith('import') && line.trim() !== '');
+        // 9. parse table info
+        const tables = (0, parse_table_info_1.parseTableInfo)(lines.slice(codeStart));
+        // 10. extract relations
+        const relations = (0, extract_relations_1.extractRelations)(lines.slice(codeStart));
+        // 11. generate ER content
+        const ERContent = (0, generate_er_content_1.generateERContent)(relations, tables);
+        // 12. write ER content to output file
+        (0, node_fs_1.writeFileSync)(output, ERContent);
+        console.log(`Generated ER at: ${output}`);
+        return true;
+    }
+    catch (e) {
+        if (e instanceof Error) {
+            console.error(e.message);
+            if (dev) {
+                throw e;
+            }
+            process.exit(1);
+        }
+        if (dev) {
+            throw new Error('Unknown error occurred');
+        }
+        return false;
+    }
+}
+if (require.main === module) {
+    main().then((success) => {
+        if (!success) {
+            process.exit(1);
+        }
+    });
+}

package/dist/generator/mermaid-er/type/index.d.ts

@@ -0,0 +1,40 @@
+export type RelationType =
+  | 'one-to-one'
+  | 'one-to-many'
+  | 'many-to-one'
+  | 'many-to-many'
+  | 'one-to-zero-one'
+  | 'zero-one-to-one'
+  | 'zero-to-many'
+  | 'many-to-zero-one'
+  | 'zero-one-to-many'
+  | 'zero-to-one'
+  | 'zero-to-zero-one'
+  | 'one-to-many-optional'
+  | 'one-to-one-optional'
+  | 'many-to-many-optional'
+  | 'zero-one-to-zero-one'
+  | 'many-to-zero-many'
+  | 'zero-many-to-many'
+  | 'zero-many-to-zero-many'
+export type Relation = {
+  fromModel: string
+  toModel: string
+  fromField: string
+  toField: string
+  type: RelationType
+}
+export type ERContent = readonly string[]
+export type TableInfo = {
+  name: string
+  fields: {
+    type: string
+    name: string
+    description: string | null
+  }[]
+}
+export type AccumulatorType = {
+  tables: TableInfo[]
+  currentTable: TableInfo | null
+  currentDescription: string
+}

package/dist/generator/mermaid-er/type/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generator/mermaid-er/validator/is-relation.d.ts

@@ -0,0 +1,7 @@
+import type { RelationType } from '../type'
+/**
+ * Validate if a value is a valid relation type
+ * @param value - The value to validate
+ * @returns True if the value is a valid relation type, false otherwise
+ */
+export declare function isRelation(value: unknown): value is RelationType

package/dist/generator/mermaid-er/validator/is-relation.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRelation = isRelation;
+const VALID_RELATIONS = new Set([
+    // Required Relationships
+    'one-to-one',
+    'one-to-many',
+    'many-to-one',
+    'many-to-many',
+    'one-to-zero-one',
+    'zero-one-to-one',
+    'zero-to-one',
+    'zero-to-zero-one',
+    'zero-to-many',
+    'zero-one-to-many',
+    'many-to-zero-one',
+    // Optional Relationships (using dotted lines)
+    'one-to-one-optional',
+    'one-to-many-optional',
+    'many-to-one-optional',
+    'many-to-many-optional',
+    'one-to-zero-one-optional',
+    'zero-one-to-one-optional',
+    'zero-to-one-optional',
+    'zero-to-many-optional',
+    'zero-one-to-many-optional',
+    'many-to-zero-one-optional',
+    // Nuanced Patterns (Aliases)
+    'many-to-zero-many',
+    'zero-many-to-many',
+    'zero-many-to-zero-many',
+]);
+/**
+ * Validate if a value is a valid relation type
+ * @param value - The value to validate
+ * @returns True if the value is a valid relation type, false otherwise
+ */
+function isRelation(value) {
+    return typeof value === 'string' && VALID_RELATIONS.has(value);
+}

package/dist/generator/mermaid-er/validator/parse-relation-line.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Parse a relation line
+ * @param line - The line to parse
+ * @returns The parsed relation
+ */
+export declare function parseRelationLine(line: string): {
+  fromModel: string
+  fromField: string
+  toModel: string
+  toField: string
+  type: import('../type').RelationType
+} | null

package/dist/generator/mermaid-er/validator/parse-relation-line.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRelationLine = parseRelationLine;
+const is_relation_1 = require("./is-relation");
+/**
+ * Parse a relation line
+ * @param line - The line to parse
+ * @returns The parsed relation
+ */
+function parseRelationLine(line) {
+    // @relation <fromModel>.<fromField> <toModel>.<toField> <relationType>
+    const relationMatch = line.match(/@relation\s+(\w+)\.(\w+)\s+(\w+)\.(\w+)\s+(\w+-to-\w+)/);
+    if (relationMatch) {
+        const [_, fromModel, fromField, toModel, toField, type] = relationMatch;
+        // Validate the relation type
+        if (!(0, is_relation_1.isRelation)(type)) {
+            throw new Error(`Unknown relation type: ${type}`);
+        }
+        return {
+            fromModel,
+            fromField,
+            toModel,
+            toField,
+            type,
+        };
+    }
+    return null;
+}

package/dist/generator/mermaid-er/validator/parse-table-info.d.ts

@@ -0,0 +1,8 @@
+import type { TableInfo } from '../type'
+/**
+ * Parse table info from code
+ * @function parseTableInfo
+ * @param code - The code to parse the table info from
+ * @returns The parsed table info
+ */
+export declare function parseTableInfo(code: string[]): TableInfo[]

package/dist/generator/mermaid-er/validator/parse-table-info.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTableInfo = parseTableInfo;
+/**
+ * Parse table info from code
+ * @function parseTableInfo
+ * @param code - The code to parse the table info from
+ * @returns The parsed table info
+ */
+function parseTableInfo(code) {
+    const initialAccumulator = {
+        tables: [],
+        currentTable: null,
+        currentDescription: '',
+        tempFields: [],
+        currentTableStartLine: 0,
+    };
+    const result = code.reduce((acc, line, index) => {
+        // extract description
+        const descriptionMatch = line.match(/\/\/\/\s*([^@].*)/);
+        if (descriptionMatch &&
+            !(line.includes('@z.') || line.includes('@v.')) &&
+            !line.includes('@relation')) {
+            acc.currentDescription = descriptionMatch[1]?.trim() ?? null;
+            return acc;
+        }
+        // extract table name
+        const tableMatch = line.match(/export const (\w+)\s*=\s*mysqlTable/);
+        if (tableMatch) {
+            if (acc.currentTable && acc.tempFields.length > 0) {
+                acc.currentTable.fields = acc.tempFields.map((field) => ({
+                    name: field.name,
+                    type: field.type,
+                    description: field.description,
+                }));
+                acc.tables.push(acc.currentTable);
+            }
+            acc.currentTable = {
+                name: tableMatch[1],
+                fields: [],
+            };
+            acc.tempFields = [];
+            acc.currentTableStartLine = index;
+            return acc;
+        }
+        // field info extraction
+        if (!acc.currentTable) {
+            return acc;
+        }
+        const fieldMatch = line.match(/^\s*([^:]+):\s*([^(]+)\(/);
+        if (fieldMatch) {
+            const [_, fieldName, fieldType] = fieldMatch;
+            const description = line.includes('.primaryKey()')
+                ? `(PK) ${acc.currentDescription || ''}`
+                : acc.currentDescription || '';
+            acc.tempFields.push({
+                name: fieldName.trim(),
+                type: fieldType.trim(),
+                description,
+                line: index,
+            });
+            acc.currentDescription = '';
+            return acc;
+        }
+        // detect foreign key constraint
+        if (line.includes('.references') || line.includes('relations')) {
+            const lastIndex = acc.tempFields.length - 1;
+            if (lastIndex >= 0) {
+                const lastField = acc.tempFields[lastIndex];
+                acc.tempFields[lastIndex] = {
+                    name: lastField.name,
+                    type: lastField.type,
+                    description: `(FK) ${lastField.description}`,
+                    line: lastField.line,
+                };
+            }
+            return acc;
+        }
+        return acc;
+    }, initialAccumulator);
+    // process fields of the last table
+    if (result.currentTable && result.tempFields.length > 0) {
+        result.currentTable.fields = result.tempFields.map((field) => ({
+            name: field.name,
+            type: field.type,
+            description: field.description,
+        }));
+        result.tables.push(result.currentTable);
+    }
+    return result.tables;
+}

package/dist/generator/mermaid-er/validator/remove-duplicate-relations.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Remove duplicate relations
+ * @function removeDuplicateRelations
+ * @param relations - The relations to remove duplicates from
+ * @returns The relations without duplicates
+ */
+export declare function removeDuplicateRelations(relations: readonly string[]): readonly string[]

package/dist/generator/mermaid-er/validator/remove-duplicate-relations.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeDuplicateRelations = removeDuplicateRelations;
+/**
+ * Remove duplicate relations
+ * @function removeDuplicateRelations
+ * @param relations - The relations to remove duplicates from
+ * @returns The relations without duplicates
+ */
+function removeDuplicateRelations(relations) {
+    return [...new Set(relations)];
+}

package/dist/generator/valibot/config/index.d.ts

@@ -0,0 +1,7 @@
+import type { Config } from '../../../common/config'
+/**
+ * Loads the configuration from the `sizuku.json` file or returns the default configuration.
+ *
+ * @returns The configuration object.
+ */
+export declare function getConfig(): Config

package/dist/generator/valibot/config/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const config_1 = require("../../../common/config");
+/**
+ * Loads the configuration from the `sizuku.json` file or returns the default configuration.
+ *
+ * @returns The configuration object.
+ */
+function getConfig() {
+    const config = node_fs_1.default.existsSync('sizuku-valibot.json')
+        ? { ...config_1.DEFAULT_CONFIG, ...JSON.parse(node_fs_1.default.readFileSync('sizuku-valibot.json', 'utf-8')) }
+        : config_1.DEFAULT_CONFIG;
+    return config;
+}

package/dist/generator/valibot/core/extract-schema.d.ts

@@ -0,0 +1,8 @@
+import type { Schema } from '../../../common/type'
+/**
+ * Extract schemas from lines of code
+ * @function extractSchemas
+ * @param lines - Lines of code
+ * @returns Schemas
+ */
+export declare function extractSchemas(lines: string[]): Schema[]