@rationalbloks/frontblok-crud 0.1.0

package/README.md

@@ -0,0 +1,268 @@
+# @rationalbloks/frontblok-crud
+
+**Universal CRUD API Layer for RationalBloks Frontends**
+
+The TypeScript equivalent of `builderblok` - a single, generic API layer that works with ANY entity schema.
+
+---
+
+## 🎯 Philosophy
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                      THE BUILDERBLOK PATTERN                            │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  BACKEND (builderblok)              FRONTEND (frontblok-crud)          │
+│  ═══════════════════                ════════════════════════           │
+│                                                                         │
+│  JSON Schema                        JSON Schema                         │
+│       │                                  │                              │
+│       ▼                                  ▼                              │
+│  entities.py ◄── ONLY GENERATED    entities.ts ◄── ONLY GENERATED     │
+│       │                                  │                              │
+│       ▼                                  ▼                              │
+│  models.py ─┐                       api.ts ──────┐                      │
+│  crud.py ───┼── 100% GENERIC        hooks.ts ────┼── 100% GENERIC      │
+│  routes.py ─┘                       utils.ts ────┘                      │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**Only ONE file is generated** (`entities.ts`). Everything else is generic and works with ANY schema.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @rationalbloks/frontblok-crud
+```
+
+Requires peer dependencies:
+```bash
+npm install react @rationalbloks/frontblok-auth
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Initialize API (once at app startup)
+
+```typescript
+// main.tsx or App.tsx
+import { initApi } from '@rationalbloks/frontblok-crud';
+
+initApi(import.meta.env.VITE_DATABASE_API_URL);
+```
+
+### 2. Use Hooks in Components
+
+```typescript
+// TaskList.tsx
+import { useEntityList, useMutation } from '@rationalbloks/frontblok-crud';
+import type { Task } from './entities'; // Generated file
+
+function TaskList() {
+  const { items, loading, error, refetch } = useEntityList<Task>('tasks');
+  const { mutate } = useMutation<Task>('tasks');
+
+  const handleDelete = async (id: string) => {
+    await mutate.remove(id);
+    refetch();
+  };
+
+  if (loading) return <CircularProgress />;
+  if (error) return <Alert severity="error">{error.message}</Alert>;
+
+  return (
+    <ul>
+      {items.map(task => (
+        <li key={task.id}>
+          {task.title}
+          <button onClick={() => handleDelete(task.id)}>Delete</button>
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
+### 3. Use Direct API Access
+
+```typescript
+import { getApi } from '@rationalbloks/frontblok-crud';
+import type { Task } from './entities';
+
+// Get all tasks
+const tasks = await getApi().getAll<Task>('tasks');
+
+// Get single task
+const task = await getApi().getOne<Task>('tasks', 'uuid-here');
+
+// Create task
+const newTask = await getApi().create<Task>('tasks', { title: 'New Task' });
+
+// Update task
+const updated = await getApi().update<Task>('tasks', 'uuid-here', { status: 'done' });
+
+// Delete task
+await getApi().remove('tasks', 'uuid-here');
+```
+
+---
+
+## 📚 API Reference
+
+### Initialization
+
+| Function | Description |
+|----------|-------------|
+| `initApi(baseUrl, getToken?)` | Initialize the global API instance |
+| `getApi()` | Get the global API instance (throws if not initialized) |
+| `isApiInitialized()` | Check if API has been initialized |
+| `resetApi()` | Reset the API instance (for testing) |
+
+### Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useEntityList<T>(entityName, options?)` | Fetch list of entities |
+| `useEntity<T>(entityName, id?)` | Fetch single entity by ID |
+| `useMutation<T>(entityName)` | Create, update, delete entities |
+| `useEntityForm<T>(entityName, id?)` | Combined entity + mutation for forms |
+
+### Generator (MCP use only)
+
+| Function | Description |
+|----------|-------------|
+| `generateEntitiesTs(schema)` | Generate complete entities.ts from schema |
+| `validateSchema(schema)` | Validate schema before generation |
+
+---
+
+## 📁 Generated entities.ts Example
+
+Given this schema:
+```json
+{
+  "tasks": {
+    "title": { "type": "string", "max_length": 200, "required": true },
+    "status": { "type": "string", "max_length": 50, "enum": ["pending", "done"] },
+    "due_date": { "type": "date" }
+  }
+}
+```
+
+The generator creates:
+```typescript
+// entities.ts - Generated by RationalBloks MCP
+// DO NOT EDIT MANUALLY
+
+import type { BaseEntity, CreateInput, UpdateInput, EntityRegistry } from '@rationalbloks/frontblok-crud';
+
+// ----------------------------------------------------------------------------
+// Task
+// ----------------------------------------------------------------------------
+
+export interface Task extends BaseEntity {
+  title: string;
+  status?: 'pending' | 'done';
+  due_date?: string;
+}
+
+export type CreateTaskInput = CreateInput<Task>;
+export type UpdateTaskInput = UpdateInput<Task>;
+
+// ============================================================================
+// ENTITY REGISTRY
+// ============================================================================
+
+export const entities = {
+  tasks: {
+    singular: 'task',
+    plural: 'tasks',
+    fields: {
+      title: { type: 'string', required: true, max_length: 200 },
+      status: { type: 'string', enum: ['pending', 'done'] },
+      due_date: { type: 'date' }
+    },
+  },
+} as const satisfies EntityRegistry;
+
+export type Entities = typeof entities;
+export type EntityName = keyof Entities;
+```
+
+---
+
+## 🏗️ Architecture
+
+### Files in this package:
+
+| File | Purpose | Generated? |
+|------|---------|------------|
+| `api.ts` | Universal CRUD API client | ❌ NO (generic) |
+| `hooks.ts` | React hooks for data fetching | ❌ NO (generic) |
+| `types.ts` | TypeScript type definitions | ❌ NO (generic) |
+| `utils.ts` | Helper functions | ❌ NO (generic) |
+| `generator.ts` | Generates entities.ts | ❌ NO (used by MCP) |
+
+### What gets generated in user's project:
+
+| File | Purpose | Generated? |
+|------|---------|------------|
+| `entities.ts` | TypeScript interfaces + entity registry | ✅ YES |
+
+**That's it. ONE file. ~50 lines.**
+
+---
+
+## 🔗 Integration with frontblok-auth
+
+This package builds on top of `@rationalbloks/frontblok-auth`:
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                           USER'S PROJECT                                │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  ┌───────────────────────────────────────────────────────────────────┐ │
+│  │                        UI LAYER (user's choice)                   │ │
+│  │  - React components                                               │ │
+│  │  - Routing (react-router)                                         │ │
+│  │  - Styling (MUI, Tailwind, etc.)                                  │ │
+│  └───────────────────────────────────────────────────────────────────┘ │
+│                               │                                         │
+│                               ▼                                         │
+│  ┌───────────────────────────────────────────────────────────────────┐ │
+│  │              @rationalbloks/frontblok-crud                        │ │
+│  │  - entities.ts (GENERATED - types + metadata)                     │ │
+│  │  - api.ts (GENERIC - universal CRUD)                              │ │
+│  │  - hooks.ts (GENERIC - React data hooks)                          │ │
+│  └───────────────────────────────────────────────────────────────────┘ │
+│                               │                                         │
+│                               ▼                                         │
+│  ┌───────────────────────────────────────────────────────────────────┐ │
+│  │              @rationalbloks/frontblok-auth                        │ │
+│  │  - BaseApi (HTTP client with auth)                                │ │
+│  │  - Auth hooks                                                     │ │
+│  │  - Token management                                               │ │
+│  └───────────────────────────────────────────────────────────────────┘ │
+│                               │                                         │
+└───────────────────────────────┼─────────────────────────────────────────┘
+                                │
+                                ▼
+                     ┌──────────────────────┐
+                     │   RationalBloks API   │
+                     │   (generated by       │
+                     │    builderblok)       │
+                     └──────────────────────┘
+```
+
+---
+
+## 📝 License
+
+MIT © RationalBloks Team

package/dist/api.d.ts

@@ -0,0 +1,115 @@
+import type { BaseEntity } from './types.js';
+/**
+ * Minimal interface for the auth API client.
+ * Matches frontblok-auth's BaseApi.request() signature.
+ */
+export interface AuthApiClient {
+    request<T>(endpoint: string, options?: RequestInit): Promise<T>;
+}
+export declare class UniversalApi {
+    private authApi;
+    constructor(authApi: AuthApiClient);
+    /**
+     * Get all entities of a type.
+     *
+     * @param entityName - The entity/table name (e.g., 'tasks', 'projects')
+     * @param options - Optional query parameters
+     * @returns Array of entities
+     *
+     * @example
+     * const tasks = await api.getAll<Task>('tasks');
+     * const activeTasks = await api.getAll<Task>('tasks', { status: 'active' });
+     */
+    getAll<T extends BaseEntity>(entityName: string, options?: {
+        skip?: number;
+        limit?: number;
+        [key: string]: unknown;
+    }): Promise<T[]>;
+    /**
+     * Get a single entity by ID.
+     *
+     * @param entityName - The entity/table name
+     * @param id - Entity UUID
+     * @returns The entity or throws if not found
+     *
+     * @example
+     * const task = await api.getOne<Task>('tasks', 'uuid-here');
+     */
+    getOne<T extends BaseEntity>(entityName: string, id: string): Promise<T>;
+    /**
+     * Create a new entity.
+     *
+     * @param entityName - The entity/table name
+     * @param data - Entity data (without id, created_at, updated_at)
+     * @returns The created entity with all fields
+     *
+     * @example
+     * const task = await api.create<Task>('tasks', { title: 'New Task', status: 'pending' });
+     */
+    create<T extends BaseEntity>(entityName: string, data: Partial<Omit<T, 'id' | 'created_at' | 'updated_at'>>): Promise<T>;
+    /**
+     * Update an existing entity.
+     *
+     * @param entityName - The entity/table name
+     * @param id - Entity UUID
+     * @param data - Partial entity data to update
+     * @returns The updated entity
+     *
+     * @example
+     * const task = await api.update<Task>('tasks', 'uuid-here', { status: 'done' });
+     */
+    update<T extends BaseEntity>(entityName: string, id: string, data: Partial<Omit<T, 'id' | 'created_at' | 'updated_at'>>): Promise<T>;
+    /**
+     * Delete an entity.
+     *
+     * @param entityName - The entity/table name
+     * @param id - Entity UUID
+     *
+     * @example
+     * await api.remove('tasks', 'uuid-here');
+     */
+    remove(entityName: string, id: string): Promise<void>;
+    /**
+     * Smart pluralization that matches builderblok's routes.py.
+     * Mirrors the Python `pluralize()` function exactly.
+     */
+    private pluralize;
+}
+/**
+ * Initialize the global CRUD API instance.
+ * Call this once at app startup (e.g., in main.tsx).
+ *
+ * @param authApi - The frontblok-auth BaseApi instance (from createAuthApi)
+ * @returns The initialized UniversalApi instance
+ *
+ * @example
+ * // In main.tsx or App.tsx
+ * import { createAuthApi } from '@rationalbloks/frontblok-auth';
+ * import { initApi } from '@rationalbloks/frontblok-crud';
+ *
+ * const authApi = createAuthApi(import.meta.env.VITE_DATABASE_API_URL);
+ * initApi(authApi);
+ */
+export declare function initApi(authApi: AuthApiClient): UniversalApi;
+/**
+ * Get the global CRUD API instance.
+ * Throws if initApi hasn't been called.
+ *
+ * @returns The UniversalApi instance
+ *
+ * @example
+ * import { getApi } from '@rationalbloks/frontblok-crud';
+ *
+ * const tasks = await getApi().getAll<Task>('tasks';
+ */
+export declare function getApi(): UniversalApi;
+/**
+ * Check if the API has been initialized.
+ * Useful for conditional rendering or lazy initialization.
+ */
+export declare function isApiInitialized(): boolean;
+/**
+ * Reset the API instance (useful for testing).
+ */
+export declare function resetApi(): void;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjE;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;gBAEnB,OAAO,EAAE,aAAa;IAUlC;;;;;;;;;;OAUG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAClE,OAAO,CAAC,CAAC,EAAE,CAAC;IAmBf;;;;;;;;;OASG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9E;;;;;;;;;OASG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC;IAOb;;;;;;;;;;OAUG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAC/B,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC;IAOb;;;;;;;;OAQG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;;OAGG;IACH,OAAO,CAAC,SAAS;CA2BlB;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAG5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,IAAI,YAAY,CAYrC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

package/dist/api.js

@@ -0,0 +1,227 @@
+// ============================================================================
+// FRONTBLOK-CRUD - UNIVERSAL CRUD API CLIENT
+// ============================================================================
+// Single class that handles ALL CRUD operations for ANY entity type.
+// Uses frontblok-auth's BaseApi for HTTP requests - NO DUPLICATE LOGIC!
+//
+// ARCHITECTURE (THE ONE WAY):
+// ┌─────────────────────────────────────────────────────────────────────────┐
+// │  frontblok-auth.BaseApi          →  Auth + HTTP (the ONLY HTTP layer)  │
+// │  frontblok-crud.UniversalApi     →  CRUD methods using BaseApi         │
+// └─────────────────────────────────────────────────────────────────────────┘
+//
+// CHAIN OF EVENTS MANTRA:
+// - Errors propagate up to the caller (hooks handle them)
+// - No try/catch here - let errors bubble for consistent handling
+// - Single path, single way, the right way
+// - ONE WAY to make HTTP calls: through frontblok-auth's BaseApi
+//
+// USAGE:
+// ```typescript
+// import { createAuthApi } from '@rationalbloks/frontblok-auth';
+// import { initApi, getApi } from '@rationalbloks/frontblok-crud';
+// 
+// // Initialize once at app startup
+// const authApi = createAuthApi(import.meta.env.VITE_DATABASE_API_URL);
+// initApi(authApi);
+// 
+// // Use anywhere
+// const tasks = await getApi().getAll<Task>('tasks');
+// const task = await getApi().create<Task>('tasks', { title: 'New Task' });
+// ```
+// ============================================================================
+// ============================================================================
+// UNIVERSAL CRUD API CLASS
+// ============================================================================
+// Single class that handles ALL CRUD operations for ANY entity type.
+// Delegates HTTP to frontblok-auth's BaseApi - NO DUPLICATE HTTP LOGIC!
+export class UniversalApi {
+    constructor(authApi) {
+        this.authApi = authApi;
+    }
+    // ==========================================================================
+    // UNIVERSAL CRUD OPERATIONS
+    // ==========================================================================
+    // These methods work with ANY entity - just pass the entity name.
+    // Mirrors builderblok's UniversalCRUD class methods.
+    /**
+     * Get all entities of a type.
+     *
+     * @param entityName - The entity/table name (e.g., 'tasks', 'projects')
+     * @param options - Optional query parameters
+     * @returns Array of entities
+     *
+     * @example
+     * const tasks = await api.getAll<Task>('tasks');
+     * const activeTasks = await api.getAll<Task>('tasks', { status: 'active' });
+     */
+    async getAll(entityName, options) {
+        // Build query string from options
+        let query = '';
+        if (options) {
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(options)) {
+                if (value !== undefined && value !== null) {
+                    params.append(key, String(value));
+                }
+            }
+            const queryString = params.toString();
+            if (queryString) {
+                query = `?${queryString}`;
+            }
+        }
+        return this.authApi.request(`/api/${this.pluralize(entityName)}/${query}`);
+    }
+    /**
+     * Get a single entity by ID.
+     *
+     * @param entityName - The entity/table name
+     * @param id - Entity UUID
+     * @returns The entity or throws if not found
+     *
+     * @example
+     * const task = await api.getOne<Task>('tasks', 'uuid-here');
+     */
+    async getOne(entityName, id) {
+        return this.authApi.request(`/api/${this.pluralize(entityName)}/${id}`);
+    }
+    /**
+     * Create a new entity.
+     *
+     * @param entityName - The entity/table name
+     * @param data - Entity data (without id, created_at, updated_at)
+     * @returns The created entity with all fields
+     *
+     * @example
+     * const task = await api.create<Task>('tasks', { title: 'New Task', status: 'pending' });
+     */
+    async create(entityName, data) {
+        return this.authApi.request(`/api/${this.pluralize(entityName)}/`, {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    /**
+     * Update an existing entity.
+     *
+     * @param entityName - The entity/table name
+     * @param id - Entity UUID
+     * @param data - Partial entity data to update
+     * @returns The updated entity
+     *
+     * @example
+     * const task = await api.update<Task>('tasks', 'uuid-here', { status: 'done' });
+     */
+    async update(entityName, id, data) {
+        return this.authApi.request(`/api/${this.pluralize(entityName)}/${id}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    /**
+     * Delete an entity.
+     *
+     * @param entityName - The entity/table name
+     * @param id - Entity UUID
+     *
+     * @example
+     * await api.remove('tasks', 'uuid-here');
+     */
+    async remove(entityName, id) {
+        await this.authApi.request(`/api/${this.pluralize(entityName)}/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // ==========================================================================
+    // UTILITY METHODS
+    // ==========================================================================
+    /**
+     * Smart pluralization that matches builderblok's routes.py.
+     * Mirrors the Python `pluralize()` function exactly.
+     */
+    pluralize(word) {
+        if (!word)
+            return word;
+        // Already ends with 's'? Don't add another one
+        if (word.toLowerCase().endsWith('s')) {
+            return word;
+        }
+        // Ends with 'y' preceded by consonant? Replace 'y' with 'ies'
+        if (word.length > 1 && word.slice(-1).toLowerCase() === 'y') {
+            const secondLast = word.slice(-2, -1).toLowerCase();
+            if (!'aeiou'.includes(secondLast)) {
+                return word.slice(0, -1) + 'ies';
+            }
+        }
+        // Ends with 'ch', 'sh', 'x', 'z', 'o'? Add 'es'
+        const esEndings = ['ch', 'sh', 'x', 'z', 'o'];
+        for (const ending of esEndings) {
+            if (word.toLowerCase().endsWith(ending)) {
+                return word + 'es';
+            }
+        }
+        // Default: just add 's'
+        return word + 's';
+    }
+}
+// ============================================================================
+// SINGLETON INSTANCE MANAGEMENT
+// ============================================================================
+// Global API instance - initialized once, used everywhere.
+// THE ONE WAY: initApi(authApi) with frontblok-auth's BaseApi instance.
+let apiInstance = null;
+/**
+ * Initialize the global CRUD API instance.
+ * Call this once at app startup (e.g., in main.tsx).
+ *
+ * @param authApi - The frontblok-auth BaseApi instance (from createAuthApi)
+ * @returns The initialized UniversalApi instance
+ *
+ * @example
+ * // In main.tsx or App.tsx
+ * import { createAuthApi } from '@rationalbloks/frontblok-auth';
+ * import { initApi } from '@rationalbloks/frontblok-crud';
+ *
+ * const authApi = createAuthApi(import.meta.env.VITE_DATABASE_API_URL);
+ * initApi(authApi);
+ */
+export function initApi(authApi) {
+    apiInstance = new UniversalApi(authApi);
+    return apiInstance;
+}
+/**
+ * Get the global CRUD API instance.
+ * Throws if initApi hasn't been called.
+ *
+ * @returns The UniversalApi instance
+ *
+ * @example
+ * import { getApi } from '@rationalbloks/frontblok-crud';
+ *
+ * const tasks = await getApi().getAll<Task>('tasks';
+ */
+export function getApi() {
+    if (!apiInstance) {
+        throw new Error('API not initialized. Call initApi(authApi) first, typically in main.tsx or App.tsx.\n' +
+            'Example:\n' +
+            '  import { createAuthApi } from "@rationalbloks/frontblok-auth";\n' +
+            '  import { initApi } from "@rationalbloks/frontblok-crud";\n' +
+            '  const authApi = createAuthApi(API_URL);\n' +
+            '  initApi(authApi);');
+    }
+    return apiInstance;
+}
+/**
+ * Check if the API has been initialized.
+ * Useful for conditional rendering or lazy initialization.
+ */
+export function isApiInitialized() {
+    return apiInstance !== null;
+}
+/**
+ * Reset the API instance (useful for testing).
+ */
+export function resetApi() {
+    apiInstance = null;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/generator.d.ts

@@ -0,0 +1,15 @@
+import type { Schema } from './types.js';
+/**
+ * Generate complete entities.ts content from a schema.
+ * This is THE ONLY generation function needed.
+ *
+ * @param schema - The database schema in FLAT format
+ * @returns Complete TypeScript file content
+ */
+export declare function generateEntitiesTs(schema: Schema): string;
+/**
+ * Validate a schema before generation.
+ * Returns array of error messages (empty if valid).
+ */
+export declare function validateSchema(schema: Schema): string[];
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,MAAM,EAAwC,MAAM,YAAY,CAAC;AAQ/E;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyBzD;AA4ID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAuDvD"}