luca 3.0.0 → 3.1.0

package/docs/apis/features/node/downloader.md

@@ -1,81 +0,0 @@
-# Downloader (features.downloader)
-
-A feature that provides file downloading capabilities from URLs. The Downloader feature allows you to fetch files from remote URLs and save them to the local filesystem. It handles the network request, buffering, and file writing operations automatically.
-
-## Usage
-
-```ts
-container.feature('downloader')
-```
-
-## Methods
-
-### download
-
-Downloads a file from a URL and saves it to the specified local path. This method fetches the file from the provided URL, converts it to a buffer, and writes it to the filesystem at the target path. The target path is resolved relative to the container's configured paths.
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `url` | `string` | ✓ | The URL to download the file from. Must be a valid HTTP/HTTPS URL. |
-| `targetPath` | `string` | ✓ | The local file path where the downloaded file should be saved. |
-
-**Returns:** `Promise<string>`
-
-```ts
-// Download an image file
-const imagePath = await downloader.download(
- 'https://example.com/photo.jpg',
- 'images/downloaded-photo.jpg'
-)
-
-// Download a document
-const docPath = await downloader.download(
- 'https://api.example.com/files/document.pdf',
- 'documents/report.pdf'
-)
-```
-
-
-
-## State (Zod v4 schema)
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `enabled` | `boolean` | Whether this feature is currently enabled |
-
-## Examples
-
-**features.downloader**
-
-```ts
-// Enable the downloader feature
-const downloader = container.feature('downloader')
-
-// Download a file
-const localPath = await downloader.download(
- 'https://example.com/image.jpg',
- 'downloads/image.jpg'
-)
-console.log(`File saved to: ${localPath}`)
-```
-
-
-
-**download**
-
-```ts
-// Download an image file
-const imagePath = await downloader.download(
- 'https://example.com/photo.jpg',
- 'images/downloaded-photo.jpg'
-)
-
-// Download a document
-const docPath = await downloader.download(
- 'https://api.example.com/files/document.pdf',
- 'documents/report.pdf'
-)
-```
-

package/docs/apis/features/node/esbuild.md

@@ -1,60 +0,0 @@
-# Esbuild (features.esbuild)
-
-Browser-side TypeScript/ESM compilation feature using esbuild-wasm. Loads esbuild's WebAssembly build via the AssetLoader, then provides `compile()` and `transform()` methods that work entirely in the browser. Useful for live playgrounds, in-browser REPLs, and client-side bundling.
-
-## Usage
-
-```ts
-container.feature('esbuild')
-```
-
-## Methods
-
-### compile
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `code` | `string` | ✓ | Parameter code |
-| `options` | `esbuild.TransformOptions` |  | Parameter options |
-
-**Returns:** `void`
-
-
-
-### clearCache
-
-**Returns:** `void`
-
-
-
-### start
-
-**Returns:** `void`
-
-
-
-## Getters
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `assetLoader` | `any` | Returns the assetLoader feature for loading external libraries from unpkg. |
-
-## State (Zod v4 schema)
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `enabled` | `boolean` | Whether this feature is currently enabled |
-
-## Examples
-
-**features.esbuild**
-
-```ts
-const esbuild = container.feature('esbuild')
-await esbuild.start()
-const result = await esbuild.compile('const x: number = 1')
-console.log(result.code)
-```
-

package/docs/apis/features/node/file-manager.md

@@ -1,191 +0,0 @@
-# FileManager (features.fileManager)
-
-The FileManager feature creates a database like index of all of the files in the project, and provides metadata about these files, and also provides a way to watch for changes to the files.
-
-## Usage
-
-```ts
-container.feature('fileManager', {
-  // Glob patterns to exclude from file scanning
-  exclude,
-})
-```
-
-## Options (Zod v4 schema)
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `exclude` | `any` | Glob patterns to exclude from file scanning |
-
-## Methods
-
-### match
-
-Matches the file IDs against the pattern(s) provided
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `patterns` | `string | string[]` | ✓ | The patterns to match against the file IDs |
-
-**Returns:** `string[]`
-
-
-
-### matchFiles
-
-Matches the file IDs against the pattern(s) provided and returns the file objects for each.
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `patterns` | `string | string[]` | ✓ | The patterns to match against the file IDs |
-
-**Returns:** `(File | undefined)[]`
-
-
-
-### start
-
-Starts the file manager and scans the files in the project.
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `options` | `{ exclude?: string | string[] }` |  | Options for the file manager |
-
-`{ exclude?: string | string[] }` properties:
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `exclude` | `any` | The patterns to exclude from the scan |
-
-**Returns:** `Promise<this>`
-
-
-
-### scanFiles
-
-Scans the files in the project and updates the file manager state.
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `options` | `{ exclude?: string | string[] }` |  | Options for the file manager |
-
-`{ exclude?: string | string[] }` properties:
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `exclude` | `any` | The patterns to exclude from the scan |
-
-**Returns:** `Promise<this>`
-
-
-
-### watch
-
-Watches directories for file changes. Can be called multiple times to add more directories to an existing watcher. Tracks all watched paths in state. When called without `paths`, watches the project's `directoryIds` (default behavior). When called with `paths`, watches only those specific directories/globs. Subsequent calls add to the existing watcher — they never replace what's already watched.
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `options` | `{ paths?: string | string[]; exclude?: string | string[] }` |  | Options for the file manager |
-
-`{ paths?: string | string[]; exclude?: string | string[] }` properties:
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `paths` | `any` | Specific directories or globs to watch. Defaults to project directoryIds. |
-| `exclude` | `any` | The patterns to exclude from the watch |
-
-**Returns:** `Promise<void>`
-
-
-
-### stopWatching
-
-**Returns:** `Promise<void>`
-
-
-
-### updateFile
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `path` | `string` | ✓ | Parameter path |
-
-**Returns:** `Promise<void>`
-
-
-
-### removeFile
-
-**Parameters:**
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `path` | `string` | ✓ | Parameter path |
-
-**Returns:** `Promise<void>`
-
-
-
-## Getters
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `fileIds` | `string[]` | Returns an array of all relative file paths indexed by the file manager. |
-| `fileObjects` | `File[]` | Returns an array of all file metadata objects indexed by the file manager. |
-| `directoryIds` | `string[]` | Returns the directory IDs for all of the files in the project. |
-| `uniqueExtensions` | `string[]` | Returns an array of unique file extensions found across all indexed files. |
-| `isStarted` | `boolean` | Whether the file manager has completed its initial scan. |
-| `isStarting` | `boolean` | Whether the file manager is currently performing its initial scan. |
-| `isWatching` | `boolean` | Whether the file watcher is actively monitoring for changes. |
-| `watchedPaths` | `string[]` | Returns the list of directories currently being watched. |
-| `watchedFiles` | `Record<string, string[]>` | Returns the directories and files currently being watched by chokidar. |
-
-## Events (Zod v4 schema)
-
-### file:change
-
-Emitted when a watched file is added, changed, or deleted
-
-**Event Arguments:**
-
-| Name | Type | Description |
-|------|------|-------------|
-| `type` | `'add' | 'change' | 'delete'` | The type of file change |
-| `path` | `string` | Absolute path to the changed file |
-
-
-
-## State (Zod v4 schema)
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `enabled` | `boolean` | Whether this feature is currently enabled |
-| `started` | `boolean` | Whether the file manager has completed its initial scan |
-| `starting` | `boolean` | Whether the file manager is currently scanning files |
-| `watching` | `boolean` | Whether the file watcher is actively monitoring for changes |
-| `failed` | `boolean` | Whether the initial file scan failed |
-
-## Examples
-
-**features.fileManager**
-
-```ts
-const fileManager = container.feature('fileManager')
-await fileManager.start()
-
-const fileIds = fileManager.fileIds
-const typescriptFiles = fileManager.matchFiles("**ts")
-```
-