@bluelibs/runner-dev 5.3.0 → 6.0.0

package/AI.md

@@ -13,8 +13,25 @@ Runner-Dev is a powerful development toolkit for applications built with the **@
 - **MCP Integration**: AI-native development environment
 - **Tags (first-class)**: Discover Tag objects and reverse usage via GraphQL (`tags`, `tag(id)`).
 - **Documentation UI Overviews**: Sortable and searchable overview tables with a `Used By` counter column for faster cross-element inspection.
-- **Visibility Awareness**: Every element exposes `isPrivate` (based on Runner `exports()` boundaries), and resources expose `exports`.
+- **Visibility Awareness**: Every element exposes `isPrivate` (based on Runner `isolate()` boundaries), and resources expose `isolation`.
+- **Subtree Governance Awareness**: Resources expose normalized `subtree` policy summaries (middleware and validator counts per branch).
+- **Lifecycle Awareness**: Resources expose `cooldown` support and run options expose `lifecycleMode`, `disposeBudgetMs`, `disposeDrainBudgetMs`.
+- **Lane Awareness**: Events expose optional `eventLane` summaries (`globals.tags.eventLane`) and both tasks and events expose optional `rpcLane` summaries (`globals.tags.rpcLane`).
+- **Isolation Wildcard Explorer**: Wildcard isolation rules can be clicked to inspect all matching resources in a searchable modal list.
+- **Tag Handlers**: Tag views separate direct tag usages from handler elements that depend on the tag id.
 - **Task Interceptor Introspection**: Tasks expose `interceptorCount` and `hasInterceptors` for runtime `task.intercept(...)` registrations.
+- **Schema Export Compatibility**: Schema fields prefer `toJSONSchema()` exporters (including matcher-normalized schemas), with `zod` conversion as compatibility fallback.
+
+## Runner 6.0 Migration Notes
+
+| Before                | After (hard switch)                                       |
+| --------------------- | --------------------------------------------------------- |
+| `Resource.exports`    | `Resource.isolation { deny, only, exports, exportsMode }` |
+| `Middleware.global`   | `Middleware.autoApply { enabled, scope, hasPredicate }`   |
+| `Tag.middlewares`     | `Tag.taskMiddlewares` + `Tag.resourceMiddlewares`         |
+| N/A                   | `Tag.errors`, `Tag.targets`                               |
+| `RunOptions.initMode` | `RunOptions.lifecycleMode` (+ disposal budgets)           |
+| `Resource.tunnelInfo` | Removed (hard switch to Event Lane + RPC Lane surfaces)   |
 
 ## Available GraphQL Queries
 
@@ -44,7 +61,7 @@ query SystemOverview {
     shutdownHooks
     dryRun
     lazy
-    initMode
+    lifecycleMode
     runtimeEventCycleDetection
     hasOnUnhandledError
     rootId
@@ -71,7 +88,12 @@ query Architecture {
   resources {
     id
     isPrivate
-    exports
+    isolation {
+      deny
+      only
+      exports
+      exportsMode
+    }
     meta {
       title
       description

package/README.md

@@ -11,7 +11,7 @@ Runner Dev Tools provide introspection, live telemetry, and a GraphQL API to exp
 
 The way it works, is that this is a resource that opens a graphql server which opens your application to introspection.
 
-If you use `zod` for schemas of your runner primitives, you will get them beautifully transformed to JSON Schemas. This can be made to work with any schema that supports conversion to JSON Schemas.
+If your runner primitives expose `toJSONSchema()` (for example matcher-based normalized schemas), runner-dev uses that as first-class schema export. `zod` schemas are also supported and converted to JSON Schema.
 
 ## Install
 
@@ -40,23 +40,42 @@ const app = resource({
 
 - Fully-featured UI with AI assistance to explore your app, call tasks, emit events, diagnostics, logs and more.
 - Overview tables across UI sections now include sortable and searchable columns (`ID`, `Title`, `Description`, `Used By`) with per-element usage counters.
-- Overview tables now include `Visibility` (`Public`/`Private`) derived from Runner resource `exports()` boundaries.
+- Overview tables now include `Visibility` (`Public`/`Private`) derived from Runner resource `isolate()` boundaries.
 - Introspector: programmatic API to inspect tasks, hooks, resources, events, middleware, and diagnostics (including file paths, contents)
 - Task introspection includes runtime `interceptorCount` / `hasInterceptors` (registered via `taskDependency.intercept(...)` in resource init).
-- Resource introspection includes `exports` (resolved list of ids exposed by `.exports([...])`).
+- Resource introspection includes `isolation` (`deny`, `only`, `exports`, `exportsMode`) from `.isolate(...)`.
+- Resource introspection includes `subtree` governance summaries (middleware attachment counts and validator counts per branch).
+- Resource introspection indicates whether a resource exposes a `cooldown()` hook for shutdown lifecycle.
+- Isolation wildcard rules are clickable in the docs UI and open a modal showing matched resources with inline filtering when lists are large.
+- Event introspection includes `transactional`, `parallel`, optional `eventLane { laneId, orderingKey, metadata }`, and optional `rpcLane { laneId }`.
+- Task introspection includes optional `rpcLane { laneId }`.
+- Tag pages distinguish between directly tagged elements and tag handlers (elements that depend on the tag id).
 - Live: in-memory logs and event emissions
 - Live File Previews and Saving.
 - GraphQL server: deep graph navigation over your app’s topology and live data
 - CLI with scaffolding, query-ing capabilities on a live endpoint or via dry-run mode.
 - MCP server: allow your AI to do introspection for you.
 
+## Runner 6.0 Migration Notes
+
+| Before                | After (hard switch)                                                                          |
+| --------------------- | -------------------------------------------------------------------------------------------- |
+| `Resource.exports`    | `Resource.isolation { deny, only, exports, exportsMode }`                                    |
+| `Middleware.global`   | `Middleware.autoApply { enabled, scope, hasPredicate }`                                      |
+| `Tag.middlewares`     | `Tag.taskMiddlewares` + `Tag.resourceMiddlewares`                                            |
+| N/A                   | `Tag.errors`, `Tag.targets`                                                                  |
+| `RunOptions.initMode` | `RunOptions.lifecycleMode` + `dispose.{ totalBudgetMs, drainingBudgetMs, cooldownWindowMs }` |
+| N/A                   | `Resource.subtree`, `Resource.cooldown`                                                      |
+| N/A                   | `Event.transactional`, `Event.parallel`, `Event.eventLane`, `Event.rpcLane`, `Task.rpcLane`  |
+| `Resource.tunnelInfo` | Removed (hard switch to lane surfaces)                                                       |
+
 ## Table of Contents
 
 - [Quickstart Guide](#quickstart)
 - [Model Context Protocol (MCP) Server](#cli-usage-mcp-server)
 - [CLI Tooling & Scaffolding](#cli-usage-direct)
 - [Live Telemetry & Correlation](#live-telemetry)
-- [Hot-Swapping Debugging System](#-hot-swapping-debugging-system)
+- [Hot-Swapping Debugging System](#hot-swapping-debugging-system)
 - [GraphQL API Examples](#example-queries)
 - [API Reference](API_REFERENCE.md)
 - [Contributing & Local Dev](CONTRIBUTING.md)
@@ -86,7 +105,7 @@ export const app = resource({
 
 Once your application is running with the `dev` resource, you can access the visual DevTools UI:
 
-🚀 **Open [http://localhost:1337](http://localhost:1337) in your browser.**
+Open [http://localhost:1337](http://localhost:1337) in your browser.
 
 Inside the UI, you can:
 
@@ -687,7 +706,7 @@ export const logSomething = task({
 
 For full details on development, testing, and codegen, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
-## 🔥 Hot-Swapping Debugging System
+## Hot-Swapping Debugging System
 
 **Revolutionary live debugging feature that allows AI assistants and developers to dynamically replace task run functions in live applications.**
 
@@ -809,7 +828,7 @@ mutation {
         await deps.emitLog({
           timestamp: new Date(),
           level: "info",
-          message: "🔍 DEBUG: Creating user started",
+          message: "DEBUG: Creating user started",
           data: { input }
         });
       }
@@ -834,7 +853,7 @@ mutation {
         await deps.emitLog({
           timestamp: new Date(),
           level: "info",
-          message: "🔍 DEBUG: User created successfully",
+          message: "DEBUG: User created successfully",
           data: { result }
         });
       }
@@ -915,7 +934,7 @@ Swapped functions can emit logs that are captured by the live telemetry system:
 # After swapping with debug logging, query the logs
 query RecentDebugLogs {
   live {
-    logs(last: 50, filter: { messageIncludes: "🔍 DEBUG" }) {
+    logs(last: 50, filter: { messageIncludes: "DEBUG" }) {
       timestampMs
       level
       message
@@ -1139,7 +1158,7 @@ The system automatically handles complex JavaScript types:
 
 For advanced debugging, the system provides an `eval` mutation to execute arbitrary JavaScript/TypeScript code on the server.
 
-**⚠️ Security Warning**: This feature is powerful and executes code with the same privileges as the application. It is intended for development environments only and is disabled by default in production. To enable it, set the environment variable `RUNNER_DEV_EVAL=1`.
+**Security Warning**: This feature is powerful and executes code with the same privileges as the application. It is intended for development environments only and is disabled by default in production. To enable it, set the environment variable `RUNNER_DEV_EVAL=1`.
 
 #### `eval` Mutation
 
@@ -1182,13 +1201,129 @@ mutation {
 
 ### Architecture
 
-The hot-swapping system consists of:
+The hot-swapping system is organized into five high-level capabilities:
+
+- **Execution Control**: swaps task `run` implementations at runtime and supports rollback.
+- **Validation Pipeline**: parses and compiles submitted code before activation.
+- **API Surface**: exposes swap and restore operations through GraphQL mutations.
+- **Observability**: integrates with live telemetry so swapped behavior can be inspected immediately.
+- **Safety Controls**: isolates failures to the attempted swap and preserves previous task behavior when validation fails.
+
+The implementation remains fully type-safe and is covered by both unit and GraphQL integration tests.
+
+---
+
+## System Architecture
+
+### Overview
+
+Runner-Dev is built as a modular system of resources that integrate with the @bluelibs/runner framework to provide comprehensive development tools. The architecture follows a resource-based composition pattern where each component is a self-contained resource that can be registered and configured independently.
+
+### Core Components
+
+```mermaid
+graph TB
+    subgraph "Core Framework (@bluelibs/runner)"
+        App[Application Root]
+        Resource[Resources]
+        Task[Tasks]
+        Event[Events]
+        Middleware[Middleware]
+        Hook[Hooks]
+        Tag[Tags]
+    end
+
+    subgraph "DevTools Layer (@bluelibs/runner-dev)"
+        Dev[dev Resource]
+        Introspector[Introspector]
+        Live[Live Telemetry]
+        Swap[Swap Manager]
+        GraphQL[GraphQL Server]
+        MCP[MCP Server]
+    end
+
+    subgraph "Interfaces"
+        UI[React UI]
+        CLI[CLI Tools]
+        AI[AI Assistants]
+    end
+
+    App --> Dev
+    Dev --> Introspector
+    Dev --> Live
+    Dev --> Swap
+    Dev --> GraphQL
+    GraphQL --> MCP
+
+    Introspector --> Resource
+    Introspector --> Task
+    Introspector --> Event
+    Introspector --> Middleware
+    Introspector --> Hook
+    Introspector --> Tag
+
+    GraphQL --> UI
+    GraphQL --> CLI
+    MCP --> AI
+```
+
+### Component Responsibilities (High-Level)
+
+| Layer                       | Responsibility                                                                   |
+| --------------------------- | -------------------------------------------------------------------------------- |
+| **Composition Layer**       | Registers and wires DevTools capabilities into the Runner application lifecycle. |
+| **Introspection Layer**     | Builds a runtime model of tasks, resources, events, middleware, hooks, and tags. |
+| **Observability Layer**     | Captures logs, emissions, errors, runs, and health metrics for analysis.         |
+| **Execution Control Layer** | Supports remote task invocation and controlled hot-swapping workflows.           |
+| **Access Layer**            | Exposes a GraphQL API and transports for UI, CLI, and MCP clients.               |
+
+### Data Flow
+
+```mermaid
+sequenceDiagram
+    participant App as Runner App
+    participant Dev as dev Resource
+    participant Intro as Introspector
+    participant GQL as GraphQL Server
+    participant UI as React UI
+
+    App->>Dev: register dev.with({port: 1337})
+    Dev->>Intro: walk application graph
+    Intro-->>Dev: serialized topology
+    Dev->>GQL: start server on port 1337
+
+    UI->>GQL: query { tasks { id dependsOn } }
+    GQL-->>UI: introspected data
+
+    UI->>GQL: mutation invokeTask(...)
+    GQL->>App: execute task
+    App-->>GQL: result
+    GQL-->>UI: response
+```
+
+### Key Architectural Patterns
+
+1. **Resource-Based Composition**: Everything in Runner is a resource that can be registered and composed. The dev tools themselves are resources.
+
+2. **Introspection System**: The Introspector walks the application graph at runtime, extracting metadata about:
+
+   - Tasks (dependencies, emissions, interceptors)
+   - Resources (isolation rules, subtree governance, cooldown hooks)
+   - Events (listeners, transactional/parallel modes, lanes)
+   - Middleware (auto-apply scopes, tags)
+   - Tags (cross-cutting concerns with handlers)
+
+3. **Live Telemetry**: In-memory store for recent activity with SSE streaming via `/live/stream`
+
+4. **Hot-Swapping**: Modify task implementations without restart via `swapTask` mutation
+
+5. **GraphQL API**: Full schema at `src/schema/` with queries for architecture and mutations for invocation/swapping
+
+6. **MCP Integration**: AI assistants can connect via Model Context Protocol to introspect and interact with running apps
 
-- **SwapManager Resource** (`src/resources/swap.resource.ts`): Core swapping logic
-- **GraphQL Types** (`src/schema/types/SwapType.ts`): Type definitions for GraphQL API
-- **GraphQL Mutations** (`src/schema/mutation.ts`): Remote swap operations
-- **TypeScript Compiler**: Automatic code compilation and validation
-- **State Management**: Tracking of swapped functions and original code
-- **Error Handling**: Comprehensive validation and recovery mechanisms
+### Entry Points
 
-The implementation maintains 100% type safety and provides extensive test coverage with both unit tests and GraphQL integration tests.
+- **Main export**: `src/index.ts` - exports `dev` resource and types
+- **CLI entry**: `src/cli.ts` - command-line interface
+- **MCP entry**: `src/mcp.ts` - Model Context Protocol server
+- **UI entry**: `src/ui/index.html` - React documentation UI

package/dist/cli/generators/scaffold/templates/package.json.d.ts

@@ -12,10 +12,10 @@ export declare function packageJson(projectName: string): {
         readonly "schema:sdl": "runner-dev schema sdl";
     };
     readonly dependencies: {
-        readonly "@bluelibs/runner": "^5.2.0";
+        readonly "@bluelibs/runner": "^6.0.0";
     };
     readonly devDependencies: {
-        readonly "@bluelibs/runner-dev": "^5.0.0";
+        readonly "@bluelibs/runner-dev": "^6.0.0";
         readonly typescript: "^5.6.3";
         readonly tsx: "^4.19.2";
         readonly jest: "^29.7.0";

package/dist/cli/generators/scaffold/templates/package.json.js

@@ -16,10 +16,10 @@ function packageJson(projectName) {
             "schema:sdl": "runner-dev schema sdl",
         },
         dependencies: {
-            "@bluelibs/runner": "^5.2.0",
+            "@bluelibs/runner": "^6.0.0",
         },
         devDependencies: {
-            "@bluelibs/runner-dev": "^5.0.0",
+            "@bluelibs/runner-dev": "^6.0.0",
             typescript: "^5.6.3",
             tsx: "^4.19.2",
             jest: "^29.7.0",

package/dist/cli/generators/scaffold.js

@@ -32,141 +32,7 @@ const initUtils_1 = require("./initUtils");
 const templates = __importStar(require("./scaffold/templates"));
 async function scaffold(opts) {
     const { targetDir, projectName } = opts;
-    // Legacy inline templates kept for reference; actual generation uses templates.*
-    const _pkg = {
-        name: projectName,
-        version: "0.1.0",
-        private: true,
-        type: "module",
-        scripts: {
-            dev: "tsx watch src/main.ts",
-            start: "node --enable-source-maps dist/main.js",
-            build: "tsc -p tsconfig.json",
-            test: "jest",
-            "test:watch": "jest --watch",
-            "schema:sdl": "runner-dev schema sdl",
-        },
-        dependencies: {
-            "@bluelibs/runner": "^5.2.0",
-        },
-        devDependencies: {
-            "@bluelibs/runner-dev": "^5.0.0",
-            typescript: "^5.6.3",
-            tsx: "^4.19.2",
-            jest: "^29.7.0",
-            "ts-jest": "^29.1.1",
-            "@types/jest": "^29.5.12",
-        },
-    };
-    const _tsconfig = {
-        compilerOptions: {
-            target: "ESNext",
-            module: "Node16",
-            moduleResolution: "node16",
-            strict: true,
-            esModuleInterop: true,
-            forceConsistentCasingInFileNames: true,
-            declaration: true,
-            outDir: "dist",
-            rootDir: "src",
-            skipLibCheck: true,
-            resolveJsonModule: true,
-            lib: ["ESNext"],
-        },
-        include: ["src"],
-    };
-    const _jestConfig = `/** @type {import('jest').Config} */
-module.exports = {
-  preset: 'ts-jest/presets/default-esm',
-  testEnvironment: 'node',
-  roots: ['<rootDir>/src'],
-  moduleFileExtensions: ['ts', 'tsx', 'js'],
-  extensionsToTreatAsEsm: ['.ts', '.tsx'],
-  transform: {
-    '^.+\\.(ts|tsx)$': [
-      'ts-jest',
-      {
-        useESM: true,
-        tsconfig: 'tsconfig.jest.json',
-      },
-    ],
-  },
-};
-`;
-    const _tsconfigJest = {
-        extends: "./tsconfig.json",
-        compilerOptions: {
-            module: "CommonJS",
-            moduleResolution: "node",
-            target: "ES2019",
-            esModuleInterop: true,
-            isolatedModules: false,
-        },
-        include: ["src/**/*.ts", "src/**/*.tsx"],
-    };
-    const _mainTs = `
-import { run, resource } from '@bluelibs/runner';
-import { dev } from '@bluelibs/runner-dev';
-
-// Minimal Runner app using runner-dev's dev resource
-const app = resource({
-  id: 'app.${projectName}',
-  register: [
-    dev.with({ port: 1337 }),
-  ],
-});
-
-run(app)
-  .then(() => {
-    // eslint-disable-next-line no-console
-    console.log('Runner app started on http://localhost:1337');
-  })
-  .catch((err) => {
-    // eslint-disable-next-line no-console
-    console.error(err);
-    process.exit(1);
-  });
-`;
-    const _exampleTest = `describe('smoke', () => {
-  it('works', () => {
-    expect(1 + 1).toBe(2);
-  });
-});
-`;
-    const _readme = `# ${projectName}
-
-Generated by \`runner-dev new\`.
-
-## Quick start
-
-1. Install dependencies:
-   - npm install
-2. Start the dev server:
-   - npm run dev
-
-The server starts on http://localhost:1337
-
-- GraphQL endpoint: http://localhost:1337/graphql (how to query your guts and live telemetry)
-- Voyager UI: http://localhost:1337/voyager (how the guts of your app look like)
-- Project docs: http://localhost:1337/docs (beautiful docs with live telemetry and easy task and event dispatching)
-
-## Scripts
-
-- dev: Run with tsx watch (TypeScript ESM)
-- build: Type-check and emit to dist
-- start: Run built app
-- test: Run Jest
-
-## Useful CLI commands
-
-These commands are available from \`@bluelibs/runner-dev\`:
-
-- Query your API:
-  - ENDPOINT=http://localhost:1337/graphql npx runner-dev query 'query { tasks { id } }' --format pretty
-- Print the GraphQL schema SDL:
-  - npx runner-dev schema sdl --endpoint http://localhost:1337/graphql
-
-`;
+    // Generation is fully delegated to templates.*
     // Use template renderers
     await (0, initUtils_1.writeJson)(path_1.default.join(targetDir, "package.json"), templates.packageJson(projectName));
     await (0, initUtils_1.writeJson)(path_1.default.join(targetDir, "tsconfig.json"), templates.tsconfig());

package/dist/cli/generators/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/generators/scaffold.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/generators/scaffold.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,4BAkCC;AA3CD,gDAAwB;AACxB,2CAA8E;AAC9E,gEAAkD;AAO3C,KAAK,UAAU,QAAQ,CAAC,IAAqB;IAClD,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAExC,+CAA+C;IAE/C,yBAAyB;IACzB,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CACnC,CAAC;IACF,MAAM,IAAA,qBAAS,EAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EACvC,SAAS,CAAC,UAAU,EAAE,CACvB,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAC1C,SAAS,CAAC,YAAY,EAAE,CACzB,CAAC;IAEF,MAAM,IAAA,qBAAS,EAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EACtC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,cAAc,CAAC,EAC3C,SAAS,CAAC,QAAQ,EAAE,CACrB,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,IAAA,0BAAc,EAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/cli/generators/templates.js

@@ -150,7 +150,8 @@ export const ${camel} = taskMiddleware<${pascal}Config, ${pascal}Input, ${pascal
     title: '${pascal} Task Middleware',
     description: 'TODO: Add description for ${pascal} task middleware',
   },
-  // everywhere: true,
+  // Auto-apply globally via resource.subtree({ tasks: { middleware: [${camel}] } })
+  // or intercept executions with globals.resources.taskRunner.intercept(...).
   run: async ({ task, next }, deps, config) => {
     // pre-process task.input
     const result = await next(task.input as ${pascal}Input);

package/dist/cli/generators/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/cli/generators/templates.ts"],"names":[],"mappings":";;AAOA,4CAgCC;AAED,oCAgCC;AAED,sCAsBC;AAED,oCA0BC;AAED,kCA6BC;AAED,wDAoCC;AAED,gEA0BC;AAvND,SAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK;SACX,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;yBAI3B,MAAM,0BAA0B,MAAM;;mBAE5C,MAAM;;;;CAIxB,CAAC;AACF,CAAC;AAED,SAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK;SACX,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;wBAI5B,MAAM,yBAAyB,MAAM;mBAC1C,MAAM;;;;;CAKxB,CAAC;AACF,CAAC;AAED,SAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;eAIV,KAAK,YAAY,MAAM;SAC7B,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;CAInD,CAAC;AACF,CAAC;AAED,SAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;eAIV,KAAK;SACX,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;;;;;CAQnD,CAAC;AACF,CAAC;AAED,SAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK,UAAU,MAAM,WAAW,MAAM,kBAAkB,MAAM;SACpE,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;CAGnD,CAAC;AACF,CAAC;AAED,SAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK,qBAAqB,MAAM,WAAW,MAAM,UAAU,MAAM;SACvE,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;;8CAKN,MAAM;;uBAE7B,MAAM;;;CAG5B,CAAC;AACF,CAAC;AAED,SAAgB,0BAA0B,CAAC,EACzC,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;eAIV,KAAK,yBAAyB,MAAM;SAC1C,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;;;;;CAQnD,CAAC;AACF,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/cli/generators/templates.ts"],"names":[],"mappings":";;AAOA,4CAgCC;AAED,oCAgCC;AAED,sCAsBC;AAED,oCA0BC;AAED,kCA6BC;AAED,wDAqCC;AAED,gEA0BC;AAxND,SAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK;SACX,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;yBAI3B,MAAM,0BAA0B,MAAM;;mBAE5C,MAAM;;;;CAIxB,CAAC;AACF,CAAC;AAED,SAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK;SACX,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;wBAI5B,MAAM,yBAAyB,MAAM;mBAC1C,MAAM;;;;;CAKxB,CAAC;AACF,CAAC;AAED,SAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;eAIV,KAAK,YAAY,MAAM;SAC7B,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;CAInD,CAAC;AACF,CAAC;AAED,SAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;eAIV,KAAK;SACX,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;;;;;CAQnD,CAAC;AACF,CAAC;AAED,SAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK,UAAU,MAAM,WAAW,MAAM,kBAAkB,MAAM;SACpE,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;CAGnD,CAAC;AACF,CAAC;AAED,SAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;mBAIN,MAAM;;;;mBAIN,MAAM;;;;eAIV,KAAK,qBAAqB,MAAM,WAAW,MAAM,UAAU,MAAM;SACvE,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;wEAEoB,KAAK;;;;8CAI/B,MAAM;;uBAE7B,MAAM;;;CAG5B,CAAC;AACF,CAAC;AAED,SAAgB,0BAA0B,CAAC,EACzC,MAAM,EACN,EAAE,EACF,KAAK,EACL,MAAM,GACS;IACf,OAAO,GAAG,MAAM;;;mBAGC,MAAM;;;;eAIV,KAAK,yBAAyB,MAAM;SAC1C,EAAE;;cAEG,MAAM;8CAC0B,MAAM;;;;;;;;CAQnD,CAAC;AACF,CAAC"}