@facet-coverage/core 0.1.0 → 0.3.0

package/README.md

@@ -1,26 +1,65 @@
+<div align="center">
+
 # Facet Coverage
 
-> **Test every facet of your features**
-> Natural specifications. Multiple perspectives. Rigorous coverage.
+**Test every facet of your features**
+
+*Natural specifications. Multiple perspectives. Rigorous coverage.*
+
+[![npm version](https://img.shields.io/npm/v/@facet-coverage/core.svg)](https://www.npmjs.com/package/@facet-coverage/core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CircleCI](https://dl.circleci.com/status-badge/img/gh/iraycd/facet-coverage/tree/main.svg?style=svg)](https://dl.circleci.com/pipelines/gh/iraycd/facet-coverage)
+[![Node.js Version](https://img.shields.io/node/v/@facet-coverage/core.svg)](https://nodejs.org)
+
+</div>
+
+---
+
+## Table of Contents
+
+- [What is Facet?](#what-is-facet)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Linking Tests to Facets](#linking-tests-to-facets)
+- [Project Structure](#project-structure)
+- [CLI Commands](#cli-commands)
+- [Playwright Integration](#playwright-integration)
+- [Configuration](#configuration)
+- [ID Patterns](#id-patterns)
+- [Programmatic API](#programmatic-api)
+- [Benefits](#benefits)
+- [How Facet Differs](#how-facet-differs)
+- [Key Principles](#key-principles)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
 
 ## What is Facet?
 
 Facet is a modern testing framework that lets you document features from multiple stakeholder perspectives while maintaining exact traceability to your tests.
 
 **One feature. Many facets.**
-- Business requirements
-- Compliance mandates
-- UX standards
-- Technical specs
+
+| Perspective | Description |
+|-------------|-------------|
+| **Business requirements** | Product owner specifications |
+| **Compliance mandates** | Regulatory requirements (PCI-DSS, GDPR, etc.) |
+| **UX standards** | Design system and accessibility rules |
+| **Technical specs** | Architecture and API contracts |
 
 All connected to the same tests. All tracked for coverage.
 
+---
+
 ## Installation
 
 ```bash
 bun add -d @facet-coverage/core
 ```
 
+---
+
 ## Quick Start
 
 ### 1. Create Your First Facets
@@ -56,13 +95,17 @@ We handle credit card data, so PCI-DSS compliance is mandatory:
 3. **Card masking** - Display only last 4 digits
 ```
 
-### 2. Generate Structure
+### 2. Generate Structure & Types
 
 ```bash
 bunx facet generate features/checkout/facets/
 ```
 
-This creates `features/checkout/.facet/structure.json`:
+This creates two files in `features/checkout/.facet/`:
+- `structure.json` - facet definitions
+- `facets.ts` - TypeScript types for type-safe linking
+
+**structure.json:**
 
 ```json
 {
@@ -90,26 +133,27 @@ This creates `features/checkout/.facet/structure.json`:
 
 ### 3. Link Tests
 
+Import the generated types and use `facet()` in your tests:
+
 ```typescript
 // features/checkout/tests/checkout.spec.ts
-import { test, expect } from '@playwright/test';
-import { facet } from '@facet-coverage/core/playwright';
-
-test('guest user completes purchase', {
-  annotation: facet(
-    'business:guest-purchase-flow',
-    'compliance:pci-dss-payment-requirements'
-  )
-}, async ({ page }) => {
-  await page.goto('/checkout');
-  // ... test code
-
-  // Verify compliance: card masking
-  const maskedCard = page.locator('.card-last-four');
-  await expect(maskedCard).toHaveText('•••• 4242');
+import { test, expect } from 'bun:test';  // or jest, vitest, mocha...
+import { Facets, facet } from '../.facet/facets';
+
+test('guest user completes purchase', () => {
+  // Declare which facets this test covers
+  facet(Facets.BUSINESS_GUEST_PURCHASE_FLOW);
+  facet(Facets.COMPLIANCE_PCI_DSS_PAYMENT_REQUIREMENTS);
+
+  // Your test code
+  const order = checkout(cart, 'user@example.com', '4242...');
+  expect(order.confirmed).toBe(true);
+  expect(order.maskedCard).toBe('•••• 4242');  // PCI-DSS compliance
 });
 ```
 
+The `facet()` function is type-safe - TypeScript will error if you use an invalid facet ID!
+
 ### 4. Run Coverage
 
 ```bash
@@ -118,20 +162,22 @@ bunx facet analyze
 
 **Output:**
 ```
-💎 Facet Coverage Report
+Facet Coverage Report
 
 Overall: 100%
 
 By Type:
-  ✅ business: 100% (1/1)
-  ✅ compliance: 100% (1/1)
+  business: 100% (1/1)
+  compliance: 100% (1/1)
 
 Reports generated:
-  📄 .facet-coverage/coverage.json
-  📄 .facet-coverage/coverage.html
-  📄 .facet-coverage/coverage.md
+  .facet-coverage/coverage.json
+  .facet-coverage/coverage.html
+  .facet-coverage/coverage.md
 ```
 
+---
+
 ## Project Structure
 
 ```
@@ -141,9 +187,10 @@ project/
 │   │   ├── facets/
 │   │   │   ├── business.md      # Product owner writes
 │   │   │   ├── compliance.md    # Compliance team writes
-│   │   │   └── ux.md           # UX designer writes
+│   │   │   └── ux.md            # UX designer writes
 │   │   ├── .facet/
-│   │   │   └── structure.json   # Generated or manual
+│   │   │   ├── structure.json   # Generated facet definitions
+│   │   │   └── facets.ts        # Generated TypeScript types
 │   │   └── tests/
 │   │       └── checkout.spec.ts
 │   │
@@ -160,17 +207,80 @@ project/
 └── facet.config.js               # Configuration
 ```
 
+---
+
+## Linking Tests to Facets
+
+Use the `facet()` function inside your tests - just like `expect()` but for coverage tracking!
+
+### Recommended: Type-Safe with `facet()` Function
+
+```typescript
+import { test, expect } from 'bun:test';  // or jest, vitest, mocha...
+import { Facets, facet } from '../.facet/facets';
+
+test('guest user can complete a purchase', () => {
+  // Declare which facets this test covers - type-safe with autocomplete!
+  facet(Facets.BUSINESS_GUEST_PURCHASE_FLOW);
+  facet(Facets.COMPLIANCE_PCI_DSS_PAYMENT_REQUIREMENTS);
+
+  // Your test code
+  const order = checkout(cart, email, card);
+  expect(order.confirmed).toBe(true);
+});
+
+test('payment meets compliance', () => {
+  // Multiple facets in one call
+  facet(Facets.COMPLIANCE_PCI_DSS, Facets.COMPLIANCE_GDPR);
+
+  expect(payment.encrypted).toBe(true);
+});
+```
+
+**Benefits:**
+- Full TypeScript autocomplete
+- Compile-time validation (invalid facet IDs cause errors)
+- Clean, readable syntax
+- Works with any testing framework
+
+**Generated `facets.ts` includes:**
+- `FacetId` - Union type of all valid facet IDs
+- `Facets` - Object with constants for each facet
+- `facet()` - Type-safe function to declare coverage
+
+### Alternative: Comment Annotations
+
+For quick setup without imports, use comment annotations:
+
+```typescript
+// @facet business:guest-purchase-flow, compliance:pci-dss
+test('guest user completes purchase', () => {
+  // Your test code
+});
+```
+
+### All Linking Methods
+
+| Method | Type-Safe | Syntax |
+|--------|-----------|--------|
+| `facet()` function | Yes | `facet(Facets.ID)` inside test body |
+| Comment annotation | No | `// @facet id` above test |
+| Playwright annotation | Yes | `{ annotation: facet(...) }` in test options |
+
+---
+
 ## CLI Commands
 
-### Generate Structure
+### Generate Structure & Types
 
 ```bash
-# Generate structure from facet documents
+# Generate structure.json and facets.ts from facet documents
 bunx facet generate <facets-dir>
 
 # Options
-bunx facet generate features/checkout/facets/ -o ./custom-output
-bunx facet generate features/checkout/facets/ -t business
+bunx facet generate features/checkout/facets/ -o ./custom-output  # Custom output dir
+bunx facet generate features/checkout/facets/ -t business         # Override type
+bunx facet generate features/checkout/facets/ --no-types          # Skip TypeScript generation
 ```
 
 ### Analyze Coverage
@@ -208,8 +318,18 @@ bunx facet watch
 bunx facet watch -v    # Validate before analysis
 ```
 
+---
+
 ## Playwright Integration
 
+> **Note:** Playwright works with [comment annotations](#method-1-comment-annotations-any-framework) and [generated types](#method-2-type-safe-with-generated-types-recommended) out of the box. This section covers the **optional** enhanced integration with a custom reporter and annotation helper.
+
+### Why Use the Playwright Integration?
+
+- **Automatic coverage on test run** - Coverage reports generated after `playwright test`
+- **Runtime annotation capture** - Works with dynamic test generation
+- **Native annotation syntax** - Uses Playwright's built-in annotation system
+
 ### Reporter Setup
 
 ```typescript
@@ -260,16 +380,28 @@ test('comprehensive test', {
 });
 ```
 
+---
+
 ## Configuration
 
-**facet.config.js:**
+Facet Coverage supports multiple configuration file formats. The CLI looks for config files in this order:
+
+1. `facet.config.js` (ESM or CommonJS)
+2. `facet.config.mjs` (ESM only)
+3. `facet.config.json` (JSON)
+
+### Configuration Formats
+
+**JavaScript (ESM):**
 
 ```javascript
+// facet.config.js
 export default {
-  // Where structure files live
-  structureFiles: [
-    'features/**/.facet/structure.json'
-  ],
+  // Glob pattern(s) for finding facet markdown files
+  facetPattern: ['features/**/*.facet.md', 'features/**/facets/*.md'],
+
+  // Where structure files are generated
+  structureFiles: ['features/**/.facet/structure.json'],
 
   // Where tests live
   testDir: './features/**/tests',
@@ -300,6 +432,50 @@ export default {
 };
 ```
 
+**JSON:**
+
+```json
+{
+  "facetPattern": ["features/**/*.facet.md", "features/**/facets/*.md"],
+  "structureFiles": ["features/**/.facet/structure.json"],
+  "testDir": "./features/**/tests",
+  "testPatterns": ["**/*.spec.ts", "**/*.test.ts"],
+  "validation": {
+    "requireSourceExists": true,
+    "requireSectionExists": true,
+    "requireAllTestsLinked": false
+  },
+  "output": {
+    "dir": ".facet-coverage",
+    "formats": ["json", "html", "markdown"]
+  },
+  "thresholds": {
+    "global": 75,
+    "byType": {
+      "compliance": 100
+    }
+  }
+}
+```
+
+### Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `facetPattern` | `string \| string[]` | `['features/**/*.facet.md', 'features/**/facets/*.md']` | Glob pattern(s) for finding facet files |
+| `structureFiles` | `string[]` | `['features/**/.facet/structure.json']` | Glob patterns for structure files |
+| `testDir` | `string` | `'./features/**/tests'` | Test directory pattern |
+| `testPatterns` | `string[]` | `['**/*.spec.ts', '**/*.test.ts']` | Test file patterns |
+| `validation.requireSourceExists` | `boolean` | `true` | Check if source files exist |
+| `validation.requireSectionExists` | `boolean` | `true` | Check if sections exist in files |
+| `validation.requireAllTestsLinked` | `boolean` | `false` | Require every test links to a facet |
+| `output.dir` | `string` | `'.facet-coverage'` | Output directory for reports |
+| `output.formats` | `string[]` | `['json', 'html', 'markdown']` | Report formats to generate |
+| `thresholds.global` | `number` | `75` | Overall coverage threshold % |
+| `thresholds.byType` | `object` | `{}` | Per-type coverage thresholds |
+
+---
+
 ## ID Patterns
 
 ### Auto-Generated (Recommended)
@@ -335,6 +511,8 @@ facet('business:guest-purchase-flow')             // Auto-generated
 facet('facets/business.md#guest-purchase-flow')   // Direct path
 ```
 
+---
+
 ## Programmatic API
 
 ```typescript
@@ -375,8 +553,14 @@ const mdReporter = new MarkdownReporter();
 mdReporter.write(report);
 ```
 
+---
+
 ## Benefits
 
+<table>
+<tr>
+<td width="50%">
+
 ### For Product Owners
 - Write in natural language
 - Focus on business value
@@ -395,6 +579,9 @@ mdReporter.write(report);
 - Track accessibility coverage
 - Mobile/desktop requirements clear
 
+</td>
+<td width="50%">
+
 ### For Developers
 - One test covers multiple facets
 - Clear requirements from all stakeholders
@@ -407,16 +594,77 @@ mdReporter.write(report);
 - Multi-perspective coverage
 - Progress tracking
 
+</td>
+</tr>
+</table>
+
+---
+
+## How Facet Differs
+
+| Approach | Focus | Facet's Difference |
+|----------|-------|-------------------|
+| **TDD** | Code correctness via unit tests | Facet tracks *what* is covered, not *how* to write code |
+| **BDD** | Behavior via Given-When-Then | Facet uses free-form natural language, not structured syntax |
+| **ATDD** | Acceptance criteria drive development | Facet maps multiple perspectives to tests, not just acceptance |
+| **Traditional Coverage** | Lines/branches executed | Facet measures *requirement* coverage, not code coverage |
+
+**Key insight:** TDD/BDD/ATDD are *development methodologies*. Facet is a *coverage framework*. Use them together.
+
+### Why Facet Works for AI-Driven Testing
+
+AI coding assistants excel at generating tests but struggle with *what to test*. Facet solves this:
+
+- **Natural language specs** → AI understands requirements without parsing Gherkin
+- **Multi-perspective facets** → AI generates tests covering business, compliance, UX in one pass
+- **Type-safe linking** → AI can programmatically verify coverage completeness
+- **Gap detection** → AI identifies untested facets and generates missing tests
+
+```
+Human: "Generate tests for checkout"
+AI: Reads facets → Understands business rules, PCI compliance, UX requirements → Generates comprehensive tests → Links to facets automatically
+```
+
+Facet bridges human intent and AI execution with traceable, verifiable coverage.
+
+---
+
 ## Key Principles
 
-1. **Multi-Perspective**: Every feature has multiple facets
-2. **Natural Language**: Write like humans, not machines
-3. **Evolutionary**: Documentation grows with understanding
-4. **Traceable**: Exact test-to-facet mapping
-5. **Feature-Modular**: Self-contained, team-owned
-6. **Lightweight**: Markdown + JSON, nothing heavy
-7. **Flexible**: Adopt incrementally, customize freely
+| Principle | Description |
+|-----------|-------------|
+| **Multi-Perspective** | Every feature has multiple facets |
+| **Natural Language** | Write like humans, not machines |
+| **Evolutionary** | Documentation grows with understanding |
+| **Traceable** | Exact test-to-facet mapping |
+| **Feature-Modular** | Self-contained, team-owned |
+| **Lightweight** | Markdown + JSON, nothing heavy |
+| **Flexible** | Adopt incrementally, customize freely |
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+---
 
 ## License
 
-MIT
+MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+<div align="center">
+
+**[Report Bug](https://github.com/iraycd/facet-coverage/issues) | [Request Feature](https://github.com/iraycd/facet-coverage/issues)**
+
+If you find this project useful, please consider giving it a star!
+
+</div>

package/dist/cli/commands/analyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AASA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEhF"}
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAOA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEhF"}

package/dist/cli/commands/analyze.js

@@ -1,20 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeCommand = analyzeCommand;
-const fs_1 = require("fs");
-const path_1 = require("path");
 const CoverageCalculator_js_1 = require("../../core/CoverageCalculator.js");
 const JsonReporter_js_1 = require("../../reporters/JsonReporter.js");
 const HtmlReporter_js_1 = require("../../reporters/HtmlReporter.js");
 const MarkdownReporter_js_1 = require("../../reporters/MarkdownReporter.js");
-const types_js_1 = require("../../types.js");
+const config_js_1 = require("../utils/config.js");
 /**
  * Analyze facet coverage
  */
 async function analyzeCommand(options = {}) {
     const cwd = process.cwd();
     // Load config
-    const config = await loadConfig(options.config, cwd);
+    const config = await (0, config_js_1.loadConfig)(options.config, cwd);
     // Override with CLI options
     if (options.threshold) {
         config.thresholds.global = parseInt(options.threshold, 10);
@@ -72,37 +70,6 @@ async function analyzeCommand(options = {}) {
         process.exit(1);
     }
 }
-/**
- * Load configuration from file or use defaults
- */
-async function loadConfig(configPath, cwd) {
-    const configFiles = [
-        configPath,
-        'facet.config.js',
-        'facet.config.mjs',
-        'facet.config.json',
-    ].filter(Boolean);
-    for (const file of configFiles) {
-        const fullPath = (0, path_1.resolve)(cwd, file);
-        if ((0, fs_1.existsSync)(fullPath)) {
-            if (file.endsWith('.json')) {
-                const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
-                return { ...types_js_1.defaultConfig, ...JSON.parse(content) };
-            }
-            else {
-                // Dynamic import for JS config
-                try {
-                    const imported = await import(fullPath);
-                    return { ...types_js_1.defaultConfig, ...(imported.default || imported) };
-                }
-                catch (error) {
-                    console.warn(`Warning: Could not load config from ${file}`);
-                }
-            }
-        }
-    }
-    return types_js_1.defaultConfig;
-}
 /**
  * Print coverage report to console
  */

package/dist/cli/commands/analyze.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":";;AAoBA,wCAwEC;AA5FD,2BAA8C;AAC9C,+BAAqC;AACrC,4EAAsE;AACtE,qEAA+D;AAC/D,qEAA+D;AAC/D,6EAAuE;AAEvE,6CAA+C;AAU/C;;GAEG;AACI,KAAK,UAAU,cAAc,CAAC,UAA0B,EAAE;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,cAAc;IACd,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAErD,4BAA4B;IAC5B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC;IAED,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAI,0CAAkB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEvD,iCAAiC;IACjC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,kCAAkC,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,mBAAmB;IACnB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM;QAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,MAAsC,CAAC;QAClD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;IAE1B,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,8BAAY,CAAC,MAAM,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,8BAAY,CAAC,MAAM,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,sCAAgB,CAAC,MAAM,CAAC,CAAC;QAC9C,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,iBAAiB;IACjB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,0BAA0B;QAC1B,MAAM,YAAY,GAAG,IAAI,8BAAY,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED,mBAAmB;IACnB,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAE3D,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAChD,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,UAA8B,EAAE,GAAW;IACnE,MAAM,WAAW,GAAG;QAClB,UAAU;QACV,iBAAiB;QACjB,kBAAkB;QAClB,mBAAmB;KACpB,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEpC,IAAI,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAChD,OAAO,EAAE,GAAG,wBAAa,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,+BAA+B;gBAC/B,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACxC,OAAO,EAAE,GAAG,wBAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,EAAE,CAAC;gBACjE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,wBAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAClB,MAAW,EACX,MAAmB,EACnB,WAAqB;IAErB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAExD,kBAAkB;IAClB,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,sBAAsB,OAAO,CAAC,UAAU,KAAK,CAAC,CAAC;IAEzE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACtG,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAE/D,UAAU;IACV,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YAChF,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IAED,WAAW;IACX,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACtF,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,UAAU,MAAM,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;QACxH,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,yBAAyB,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,CAAC,MAAM,GAAG,UAAU,OAAO,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,eAAe;IACf,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,UAAkB,EAAE,QAAgB,EAAE;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7B,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;AACvD,CAAC"}
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/generate.d.ts

@@ -1,10 +1,14 @@
 interface GenerateOptions {
     output?: string;
     type?: string;
+    noTypes?: boolean;
+    config?: string;
+    global?: boolean;
+    quiet?: boolean;
 }
 /**
- * Generate structure.json from facet markdown files
+ * Generate structure.json and TypeScript types from facet markdown files
  */
-export declare function generateCommand(dir: string, options?: GenerateOptions): Promise<void>;
+export declare function generateCommand(dir?: string, options?: GenerateOptions): Promise<void>;
 export {};
 //# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAKA,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE/F"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AASA,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAqfD;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAWf"}