@mathonsunday/ascii-art-toolkit 0.1.0

package/README.md

@@ -0,0 +1,281 @@
+# ASCII Art Toolkit
+
+A curated library for organizing and accessing high-quality ASCII art across projects.
+
+## Philosophy
+
+ASCII art is fundamentally **copy-pastable content**. This library's job is organization, not generation.
+
+- Commission art from v0 or other design tools
+- Add it to the library with clean TypeScript exports
+- Apps query the library by theme, category, or random selection
+- Over time, the library grows organically as you work on projects
+
+## Installation
+
+```bash
+npm install @veronica/ascii-art-toolkit
+```
+
+## Quick Start
+
+```typescript
+import { library } from '@veronica/ascii-art-toolkit';
+
+// Get a random creature from deep-sea theme
+const creature = library.random('deep-sea');
+console.log(creature.art);
+
+// Get all creatures in a category
+const allFish = library.getByCategory('deep-sea', 'creature');
+
+// Query with filters
+const glowing = library.query({
+  theme: 'deep-sea',
+  category: 'creature',
+  tags: { bioluminescence: true },
+});
+
+// Get a specific piece by ID
+const anglerfish = library.getById('deep-sea:anglerfish');
+console.log(anglerfish?.zoom?.close); // Get the close-up version
+```
+
+## API
+
+### Library Methods
+
+#### `random(theme: string): AsciiArt | undefined`
+
+Get a random piece from a theme.
+
+```typescript
+const creature = library.random('deep-sea');
+```
+
+#### `randomFromQuery(options: QueryOptions): AsciiArt | undefined`
+
+Get a random piece that matches query options.
+
+```typescript
+const menacing = library.randomFromQuery({
+  theme: 'deep-sea',
+  tags: { mood: ['menacing'] },
+});
+```
+
+#### `getById(id: string): AsciiArt | undefined`
+
+Get a piece by its ID.
+
+```typescript
+const piece = library.getById('deep-sea:anglerfish');
+```
+
+#### `getByTheme(theme: string): AsciiArt[]`
+
+Get all pieces from a theme.
+
+```typescript
+const allDeepSea = library.getByTheme('deep-sea');
+```
+
+#### `getByCategory(theme: string, category: string): AsciiArt[]`
+
+Get all pieces in a specific category.
+
+```typescript
+const creatures = library.getByCategory('deep-sea', 'creature');
+const environments = library.getByCategory('deep-sea', 'environment');
+```
+
+#### `query(options: QueryOptions): AsciiArt[]`
+
+Advanced query with multiple filters.
+
+```typescript
+const results = library.query({
+  theme: 'deep-sea',
+  category: 'creature',
+  tags: {
+    bioluminescence: true,
+    mood: ['ethereal'],
+  },
+  limit: 5,
+});
+```
+
+#### `getThemes(): string[]`
+
+List all registered themes.
+
+```typescript
+const themes = library.getThemes(); // ['deep-sea']
+```
+
+#### `getCategories(theme: string): string[]`
+
+List all categories in a theme.
+
+```typescript
+const cats = library.getCategories('deep-sea');
+// ['creature', 'environment', 'structure']
+```
+
+#### `getTagMetadata(theme: string): TagMetadata`
+
+Get information about available tags in a theme.
+
+```typescript
+const tags = library.getTagMetadata('deep-sea');
+// {
+//   mood: { type: 'string[]', values: ['predatory', 'ethereal', ...] },
+//   bioluminescence: { type: 'boolean', values: [true, false] },
+//   ...
+// }
+```
+
+#### `getStats(): { totalPieces: number; themes: ... }`
+
+Get summary statistics about the library.
+
+```typescript
+const stats = library.getStats();
+console.log(stats.totalPieces); // 15 (for deep-sea theme)
+```
+
+### Data Types
+
+#### `AsciiArt`
+
+```typescript
+interface AsciiArt {
+  id: string;                    // e.g., "deep-sea:anglerfish"
+  name: string;                  // Human-readable name
+  category: string;              // 'creature' | 'structure' | 'environment' | 'scene'
+  theme: string;                 // Theme identifier
+  art: string;                   // The ASCII art string
+
+  description: string;           // What it depicts
+  whyEffective: string;          // Why this art works aesthetically
+  keyCharacters: string[];       // Important characters used
+  buildingBlocks: string[];      // Reusable patterns
+  techniques: string[];          // Techniques used
+
+  tags: {
+    mood?: string[];            // e.g., ['predatory', 'ethereal']
+    movement?: 'static' | 'dynamic';
+    density?: 'sparse' | 'medium' | 'dense';
+    size?: 'small' | 'medium' | 'large';
+    bioluminescence?: boolean;
+    [key: string]: any;
+  };
+
+  zoom?: {
+    far?: string;               // Simplified version
+    medium?: string;            // Standard detail level
+    close?: string;             // Detailed version
+  };
+}
+```
+
+## Adding New Themes
+
+1. Create a new folder in `themes/` with your theme name
+2. Structure it like the `deep-sea/` theme:
+   ```
+   themes/my-theme/
+   ├── creatures.ts
+   ├── structures.ts
+   ├── environment.ts
+   ├── index.ts
+   └── README.md
+   ```
+
+3. Define your pieces with the `AsciiArt` interface
+
+4. Register in `index.ts`:
+   ```typescript
+   import { myTheme } from './themes/my-theme/index';
+   library.registerTheme(myTheme);
+   ```
+
+## Workflow for Adding Pieces
+
+1. Commission ASCII art from v0
+2. Export as clean TypeScript (like `deep-sea-ascii-library.ts`)
+3. Copy into appropriate theme file (creatures/structures/environment)
+4. Add additional tags based on aesthetic judgment
+5. Validate with `validateLibrary()`
+
+## Validation
+
+```typescript
+import { validateLibrary, validateThemePieces } from '@veronica/ascii-art-toolkit';
+
+// Validate entire library
+const result = validateLibrary();
+if (!result.valid) {
+  console.error('Library errors:', result.errors);
+  console.warn('Warnings:', result.warnings);
+}
+
+// Validate specific theme
+const themeResult = validateThemePieces('deep-sea');
+```
+
+## Integration with Projects
+
+### agentic-ui-lab
+
+Replace static ASCII imports with library queries:
+
+```typescript
+import { library } from '@veronica/ascii-art-toolkit';
+
+// Instead of: import { anglerfish } from './rovAsciiVariants'
+const creature = library.random('deep-sea');
+
+// Display with zoom support
+const displayArt = creature.zoom?.medium || creature.art;
+```
+
+## Themes
+
+### deep-sea
+
+Bioluminescent creatures and structures of the deep ocean.
+
+15 pieces across 3 categories:
+- **Creatures** (8): Anglerfish, Giant Squid, Jellyfish, Octopus, Sea Turtle, Shark, Hermit Crab, Viperfish
+- **Structures** (3): Treasure Chest, Deep Sea Diver, Submarine
+- **Environment** (3): Coral Reef, School of Fish, Deep Sea Scene
+
+See [Deep Sea Theme Guide](./themes/deep-sea/README.md) for details.
+
+## Design Philosophy
+
+### Why Copy-Paste Over Generation?
+
+ASCII art requires aesthetic taste at every level. Unlike code generation, which can be algorithmically sound but visually boring, ASCII art succeeds entirely on visual appeal.
+
+Trying to algorithmically generate good ASCII art fails because:
+1. **Aesthetic judgment is hard** - What makes something look good involves style, proportion, character choice
+2. **Context matters** - The same creature looks different in different themes
+3. **Composition is crucial** - How elements are arranged and spaced determines impact
+
+Instead, we:
+1. Commission beautiful art from skilled designers (v0, Vizio, etc.)
+2. Curate and organize pieces in themes
+3. Let code handle organization, querying, and composition
+4. Let humans handle aesthetic judgment
+
+### Building Blocks
+
+"Building blocks" in this library are **complete, proven pieces** - not fragments.
+
+A building block is a full creature like the Anglerfish, not "head" or "tentacle". You can safely compose scenes using complete pieces, but composing from sub-pieces risks breaking the aesthetic quality.
+
+## License
+
+Personal use library - use as you see fit in your projects.

package/dist/core/library.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ASCII Art Toolkit - Library
+ *
+ * Main library class for organizing, querying, and accessing ASCII art.
+ * The library maintains a collection of themes, each containing curated pieces.
+ */
+import { AsciiArt, Theme, QueryOptions, ValidationResult, TagMetadata } from './types';
+export declare class AsciiLibrary {
+    private themes;
+    private allPiecesById;
+    /**
+     * Register a theme in the library.
+     */
+    registerTheme(theme: Theme): void;
+    /**
+     * Add a single piece to an existing theme.
+     */
+    addPiece(theme: string, piece: AsciiArt): void;
+    /**
+     * Get a piece by its ID.
+     */
+    getById(id: string): AsciiArt | undefined;
+    /**
+     * Get all pieces from a theme.
+     */
+    getByTheme(theme: string): AsciiArt[];
+    /**
+     * Get pieces from a theme by category.
+     */
+    getByCategory(theme: string, category: string): AsciiArt[];
+    /**
+     * Query the library with flexible options.
+     * Can filter by theme, category, and tags.
+     */
+    query(options: QueryOptions): AsciiArt[];
+    /**
+     * Get a random piece from a theme.
+     */
+    random(theme: string): AsciiArt | undefined;
+    /**
+     * Get a random piece matching query options.
+     */
+    randomFromQuery(options: QueryOptions): AsciiArt | undefined;
+    /**
+     * Get all available theme names.
+     */
+    getThemes(): string[];
+    /**
+     * Get all categories in a theme.
+     */
+    getCategories(theme: string): string[];
+    /**
+     * Get metadata about all tags in a theme.
+     * Useful for understanding what query options are available.
+     */
+    getTagMetadata(theme: string): TagMetadata;
+    /**
+     * Validate the library for data integrity issues.
+     */
+    validate(): ValidationResult;
+    /**
+     * Get summary statistics about the library.
+     */
+    getStats(): {
+        totalPieces: number;
+        themes: Record<string, {
+            pieces: number;
+            categories: string[];
+        }>;
+    };
+}
+/**
+ * Singleton instance of the library.
+ * All themes should be registered on this instance.
+ */
+export declare const library: AsciiLibrary;
+//# sourceMappingURL=library.d.ts.map

package/dist/core/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../core/library.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvF,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,aAAa,CAAoC;IAEzD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IASjC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAqB9C;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIzC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE;IAKrC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAK1D;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,EAAE;IA+CxC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAM3C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS;IAM5D;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAMtC;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IA2C1C;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAyC5B;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;KAClE;CAgBF;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,cAAqB,CAAC"}

package/dist/core/library.js

@@ -0,0 +1,247 @@
+/**
+ * ASCII Art Toolkit - Library
+ *
+ * Main library class for organizing, querying, and accessing ASCII art.
+ * The library maintains a collection of themes, each containing curated pieces.
+ */
+export class AsciiLibrary {
+    constructor() {
+        this.themes = new Map();
+        this.allPiecesById = new Map();
+    }
+    /**
+     * Register a theme in the library.
+     */
+    registerTheme(theme) {
+        this.themes.set(theme.name, theme);
+        // Index all pieces by ID for quick lookup
+        theme.pieces.forEach((piece) => {
+            this.allPiecesById.set(piece.id, piece);
+        });
+    }
+    /**
+     * Add a single piece to an existing theme.
+     */
+    addPiece(theme, piece) {
+        const t = this.themes.get(theme);
+        if (!t) {
+            throw new Error(`Theme "${theme}" not registered`);
+        }
+        // Verify ID matches theme
+        if (!piece.id.startsWith(`${theme}:`)) {
+            throw new Error(`Piece ID "${piece.id}" should start with "${theme}:" for theme "${theme}"`);
+        }
+        if (this.allPiecesById.has(piece.id)) {
+            throw new Error(`Piece with ID "${piece.id}" already exists`);
+        }
+        t.pieces.push(piece);
+        this.allPiecesById.set(piece.id, piece);
+    }
+    /**
+     * Get a piece by its ID.
+     */
+    getById(id) {
+        return this.allPiecesById.get(id);
+    }
+    /**
+     * Get all pieces from a theme.
+     */
+    getByTheme(theme) {
+        const t = this.themes.get(theme);
+        return t ? [...t.pieces] : [];
+    }
+    /**
+     * Get pieces from a theme by category.
+     */
+    getByCategory(theme, category) {
+        const pieces = this.getByTheme(theme);
+        return pieces.filter((p) => p.category === category);
+    }
+    /**
+     * Query the library with flexible options.
+     * Can filter by theme, category, and tags.
+     */
+    query(options) {
+        let results = [];
+        // Filter by theme
+        if (options.theme) {
+            results = this.getByTheme(options.theme);
+        }
+        else {
+            // If no theme specified, search across all themes
+            results = Array.from(this.allPiecesById.values());
+        }
+        // Filter by category
+        if (options.category) {
+            results = results.filter((p) => p.category === options.category);
+        }
+        // Filter by tags
+        if (options.tags) {
+            results = results.filter((piece) => {
+                return Object.entries(options.tags).every(([key, value]) => {
+                    const pieceTag = piece.tags[key];
+                    if (Array.isArray(value)) {
+                        // If query value is array, check if piece tag includes any of those values
+                        if (Array.isArray(pieceTag)) {
+                            return value.some((v) => pieceTag.includes(v));
+                        }
+                        return value.includes(pieceTag);
+                    }
+                    else {
+                        // Direct comparison
+                        if (Array.isArray(pieceTag)) {
+                            return pieceTag.includes(value);
+                        }
+                        return pieceTag === value;
+                    }
+                });
+            });
+        }
+        // Apply limit if specified
+        if (options.limit && options.limit > 0) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    /**
+     * Get a random piece from a theme.
+     */
+    random(theme) {
+        const pieces = this.getByTheme(theme);
+        if (pieces.length === 0)
+            return undefined;
+        return pieces[Math.floor(Math.random() * pieces.length)];
+    }
+    /**
+     * Get a random piece matching query options.
+     */
+    randomFromQuery(options) {
+        const results = this.query(options);
+        if (results.length === 0)
+            return undefined;
+        return results[Math.floor(Math.random() * results.length)];
+    }
+    /**
+     * Get all available theme names.
+     */
+    getThemes() {
+        return Array.from(this.themes.keys());
+    }
+    /**
+     * Get all categories in a theme.
+     */
+    getCategories(theme) {
+        const pieces = this.getByTheme(theme);
+        const categories = new Set(pieces.map((p) => p.category));
+        return Array.from(categories).sort();
+    }
+    /**
+     * Get metadata about all tags in a theme.
+     * Useful for understanding what query options are available.
+     */
+    getTagMetadata(theme) {
+        const pieces = this.getByTheme(theme);
+        const metadata = {};
+        pieces.forEach((piece) => {
+            Object.entries(piece.tags).forEach(([key, value]) => {
+                if (!metadata[key]) {
+                    let type = 'string';
+                    if (Array.isArray(value)) {
+                        type = 'string[]';
+                    }
+                    else if (typeof value === 'boolean') {
+                        type = 'boolean';
+                    }
+                    metadata[key] = {
+                        type,
+                        values: [],
+                    };
+                }
+                // Collect unique values
+                if (Array.isArray(value)) {
+                    value.forEach((v) => {
+                        if (!metadata[key].values.includes(v) &&
+                            !metadata[key].values.some((existing) => existing === v)) {
+                            metadata[key].values.push(v);
+                        }
+                    });
+                }
+                else if (value !== undefined && value !== null) {
+                    if (!metadata[key].values.includes(value) &&
+                        !metadata[key].values.some((existing) => existing === value)) {
+                        metadata[key].values.push(value);
+                    }
+                }
+            });
+        });
+        return metadata;
+    }
+    /**
+     * Validate the library for data integrity issues.
+     */
+    validate() {
+        const errors = [];
+        const warnings = [];
+        // Check for duplicate IDs
+        const seenIds = new Set();
+        Array.from(this.allPiecesById.keys()).forEach((id) => {
+            if (seenIds.has(id)) {
+                errors.push(`Duplicate piece ID: "${id}"`);
+            }
+            seenIds.add(id);
+        });
+        // Check each piece for required fields
+        this.allPiecesById.forEach((piece) => {
+            if (!piece.id)
+                errors.push(`Piece missing id`);
+            if (!piece.name)
+                errors.push(`Piece ${piece.id} missing name`);
+            if (!piece.category)
+                errors.push(`Piece ${piece.id} missing category`);
+            if (!piece.theme)
+                errors.push(`Piece ${piece.id} missing theme`);
+            if (!piece.art)
+                errors.push(`Piece ${piece.id} missing art`);
+            if (!piece.description)
+                warnings.push(`Piece ${piece.id} missing description`);
+            if (!piece.whyEffective)
+                warnings.push(`Piece ${piece.id} missing whyEffective`);
+            // Verify ID matches theme
+            if (!piece.id.startsWith(`${piece.theme}:`)) {
+                errors.push(`Piece ${piece.id} ID doesn't match theme "${piece.theme}"`);
+            }
+            // Check if theme exists
+            if (!this.themes.has(piece.theme)) {
+                errors.push(`Piece ${piece.id} references unregistered theme "${piece.theme}"`);
+            }
+        });
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Get summary statistics about the library.
+     */
+    getStats() {
+        const stats = {};
+        this.themes.forEach((theme) => {
+            const categories = new Set(theme.pieces.map((p) => p.category));
+            stats[theme.name] = {
+                pieces: theme.pieces.length,
+                categories: Array.from(categories).sort(),
+            };
+        });
+        return {
+            totalPieces: this.allPiecesById.size,
+            themes: stats,
+        };
+    }
+}
+/**
+ * Singleton instance of the library.
+ * All themes should be registered on this instance.
+ */
+export const library = new AsciiLibrary();
+//# sourceMappingURL=library.js.map

package/dist/core/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../core/library.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,YAAY;IAAzB;QACU,WAAM,GAAuB,IAAI,GAAG,EAAE,CAAC;QACvC,kBAAa,GAA0B,IAAI,GAAG,EAAE,CAAC;IAmQ3D,CAAC;IAjQC;;OAEG;IACH,aAAa,CAAC,KAAY;QACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEnC,0CAA0C;QAC1C,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,KAAe;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,kBAAkB,CAAC,CAAC;QACrD,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,aAAa,KAAK,CAAC,EAAE,wBAAwB,KAAK,iBAAiB,KAAK,GAAG,CAC5E,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAChE,CAAC;QAED,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAa;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAa,EAAE,QAAgB;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAqB;QACzB,IAAI,OAAO,GAAe,EAAE,CAAC;QAE7B,kBAAkB;QAClB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,kDAAkD;YAClD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBACjC,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;oBAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACzB,2EAA2E;wBAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;4BAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;wBACjD,CAAC;wBACD,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAClC,CAAC;yBAAM,CAAC;wBACN,oBAAoB;wBACpB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;4BAC5B,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;wBAClC,CAAC;wBACD,OAAO,QAAQ,KAAK,KAAK,CAAC;oBAC5B,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,2BAA2B;QAC3B,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAqB;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAa;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,KAAa;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAgB,EAAE,CAAC;QAEjC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,IAAI,IAAI,GAA+C,QAAQ,CAAC;oBAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACzB,IAAI,GAAG,UAAU,CAAC;oBACpB,CAAC;yBAAM,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;wBACtC,IAAI,GAAG,SAAS,CAAC;oBACnB,CAAC;oBACD,QAAQ,CAAC,GAAG,CAAC,GAAG;wBACd,IAAI;wBACJ,MAAM,EAAE,EAAE;qBACX,CAAC;gBACJ,CAAC;gBAED,wBAAwB;gBACxB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;wBAClB,IACE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;4BAClC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,CAAC,EACzD,CAAC;4BACD,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;wBAChC,CAAC;oBACH,CAAC,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACjD,IACE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;wBACtC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,KAAK,CAAC,EAC7D,CAAC;wBACD,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,0BAA0B;QAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACnD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,uCAAuC;QACvC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,IAAI,CAAC,KAAK,CAAC,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;YAC/D,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,mBAAmB,CAAC,CAAC;YACvE,IAAI,CAAC,KAAK,CAAC,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,WAAW;gBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,sBAAsB,CAAC,CAAC;YAC/E,IAAI,CAAC,KAAK,CAAC,YAAY;gBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,uBAAuB,CAAC,CAAC;YAEjF,0BAA0B;YAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,4BAA4B,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YAC3E,CAAC;YAED,wBAAwB;YACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,mCAAmC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YAClF,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QAIN,MAAM,KAAK,GAA6D,EAAE,CAAC;QAE3E,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;gBAClB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;gBAC3B,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE;aAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;YACpC,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * ASCII Art Toolkit - Core Types
+ *
+ * Type definitions for the ASCII art library system.
+ * Designed around curated, high-quality ASCII art pieces that are
+ * organized by theme and queryable by flexible tags.
+ */
+/**
+ * A single piece of ASCII art with metadata.
+ *
+ * The id should follow the pattern: "theme:name" (e.g., "deep-sea:anglerfish")
+ * to ensure global uniqueness across all themes.
+ */
+export interface AsciiArt {
+    id: string;
+    name: string;
+    category: 'creature' | 'structure' | 'environment' | 'scene';
+    theme: string;
+    art: string;
+    description: string;
+    whyEffective: string;
+    keyCharacters: string[];
+    buildingBlocks: string[];
+    techniques: string[];
+    tags: {
+        mood?: string[];
+        movement?: 'static' | 'dynamic';
+        density?: 'sparse' | 'medium' | 'dense';
+        size?: 'small' | 'medium' | 'large';
+        bioluminescence?: boolean;
+        [key: string]: any;
+    };
+    zoom?: {
+        far?: string;
+        medium?: string;
+        close?: string;
+    };
+}
+/**
+ * A collection of ASCII art pieces organized by theme.
+ */
+export interface Theme {
+    name: string;
+    description: string;
+    pieces: AsciiArt[];
+}
+/**
+ * Options for querying the library.
+ */
+export interface QueryOptions {
+    theme?: string;
+    category?: 'creature' | 'structure' | 'environment' | 'scene';
+    tags?: Record<string, any>;
+    limit?: number;
+}
+/**
+ * Result of library validation.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+/**
+ * Metadata about available tags in a theme.
+ */
+export interface TagMetadata {
+    [key: string]: {
+        type: 'string' | 'boolean' | 'string[]' | 'enum';
+        values?: any[];
+        description?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map