@soederpop/luca 0.0.3 → 0.0.4

package/src/introspection/generated.web.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-07T16:53:43.396Z
+// Generated at: 2026-03-12T02:48:58.250Z
 
 setBuildTimeData('features.containerLink', {
   "id": "features.containerLink",
@@ -98,7 +98,7 @@ setBuildTimeData('features.containerLink', {
 
 setBuildTimeData('features.esbuild', {
   "id": "features.esbuild",
-  "description": "Esbuild helper",
+  "description": "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.",
   "shortcut": "features.esbuild",
   "className": "Esbuild",
   "methods": {
@@ -141,12 +141,18 @@ setBuildTimeData('features.esbuild', {
   "events": {},
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const esbuild = container.feature('esbuild')\nawait esbuild.start()\nconst result = await esbuild.compile('const x: number = 1')\nconsole.log(result.code)"
+    }
+  ]
 });
 
 setBuildTimeData('features.voice', {
   "id": "features.voice",
-  "description": "VoiceRecognition helper",
+  "description": "Speech-to-text recognition using the Web Speech API (SpeechRecognition). Wraps the browser's built-in speech recognition, supporting continuous listening, interim results, and language selection. Recognized text is accumulated in state and emitted as events for real-time transcription UIs.",
   "shortcut": "features.voice",
   "className": "VoiceRecognition",
   "methods": {
@@ -210,12 +216,18 @@ setBuildTimeData('features.voice', {
   },
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const voice = container.feature('voice', { continuous: true, autoListen: true })\n\nvoice.on('transcript', ({ text }) => {\n console.log('Heard:', text)\n})\n\n// Or start manually\nvoice.start()"
+    }
+  ]
 });
 
 setBuildTimeData('features.vm', {
   "id": "features.vm",
-  "description": "The VM features providers a virtual machine for executing JavaScript code in a sandboxed environment. The Vm feature automatically injects the container.context object into the global scope, so these things can be referenced in the code and the code can use anything provided by the container.",
+  "description": "Sandboxed JavaScript execution environment for the browser. Automatically injects the container's context object into the global scope, so evaluated code can use anything provided by the container. Useful for live code playgrounds, plugin systems, and dynamic script evaluation.",
   "shortcut": "features.vm",
   "className": "VM",
   "methods": {
@@ -269,12 +281,18 @@ setBuildTimeData('features.vm', {
   "events": {},
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const vm = container.feature('vm')\nconst result = vm.run('1 + 2 + 3') // 6\nconst greeting = vm.run('container.uuid') // accesses container globals"
+    }
+  ]
 });
 
 setBuildTimeData('features.assetLoader', {
   "id": "features.assetLoader",
-  "description": "The AssetLoader provides an API for injecting scripts and stylesheets into the page. It also provides a convenient way of loading any library from unpkg.com",
+  "description": "Injects scripts and stylesheets into the page at runtime. Provides helpers for loading external libraries from unpkg.com, injecting arbitrary script/link tags, and managing load state. Used by other web features (e.g. Esbuild) to pull in dependencies on demand.",
   "shortcut": "features.assetLoader",
   "className": "AssetLoader",
   "methods": {
@@ -327,12 +345,18 @@ setBuildTimeData('features.assetLoader', {
   "events": {},
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const loader = container.feature('assetLoader')\nawait loader.loadScript('https://unpkg.com/lodash')\nawait AssetLoader.loadStylesheet('https://unpkg.com/normalize.css')"
+    }
+  ]
 });
 
 setBuildTimeData('features.vault', {
   "id": "features.vault",
-  "description": "WebVault helper",
+  "description": "AES-256-GCM encryption and decryption for the browser using the Web Crypto API. Generates or accepts a secret key and provides `encrypt()` / `decrypt()` methods that work entirely client-side. Keys are stored as base64-encoded state so they can persist across sessions when needed.",
   "shortcut": "features.vault",
   "className": "WebVault",
   "methods": {
@@ -378,12 +402,18 @@ setBuildTimeData('features.vault', {
   "events": {},
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const vault = container.feature('vault')\nconst encrypted = await vault.encrypt('secret data')\nconst decrypted = await vault.decrypt(encrypted)\nconsole.log(decrypted) // 'secret data'"
+    }
+  ]
 });
 
 setBuildTimeData('features.network', {
   "id": "features.network",
-  "description": "Network helper",
+  "description": "Tracks browser online/offline connectivity state. Listens for the browser's `online` and `offline` events and keeps the feature state in sync. Other features can observe the `offline` state value or listen for change events to react to connectivity changes.",
   "shortcut": "features.network",
   "className": "Network",
   "methods": {
@@ -413,12 +443,18 @@ setBuildTimeData('features.network', {
   "events": {},
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const network = container.feature('network')\nconsole.log(network.state.get('offline')) // false when online\n\nnetwork.on('stateChanged', ({ offline }) => {\n console.log(offline ? 'Went offline' : 'Back online')\n})"
+    }
+  ]
 });
 
 setBuildTimeData('features.speech', {
   "id": "features.speech",
-  "description": "Speech helper",
+  "description": "Text-to-speech synthesis using the Web Speech API (SpeechSynthesis). Wraps the browser's built-in speech synthesis, providing voice selection, queue management, and state tracking. Voices are discovered on init and exposed via state for UI binding.",
   "shortcut": "features.speech",
   "className": "Speech",
   "methods": {
@@ -478,7 +514,13 @@ setBuildTimeData('features.speech', {
   "events": {},
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const speech = container.feature('speech')\nspeech.say('Hello from the browser!')\n\n// Choose a specific voice\nconst speech = container.feature('speech', { voice: 'Google UK English Female' })\nspeech.say('Cheerio!')"
+    }
+  ]
 });
 
 setBuildTimeData('features.helpers', {
@@ -1109,7 +1151,7 @@ export const introspectionData = [
   },
   {
     "id": "features.esbuild",
-    "description": "Esbuild helper",
+    "description": "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.",
     "shortcut": "features.esbuild",
     "className": "Esbuild",
     "methods": {
@@ -1152,11 +1194,17 @@ export const introspectionData = [
     "events": {},
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const esbuild = container.feature('esbuild')\nawait esbuild.start()\nconst result = await esbuild.compile('const x: number = 1')\nconsole.log(result.code)"
+      }
+    ]
   },
   {
     "id": "features.voice",
-    "description": "VoiceRecognition helper",
+    "description": "Speech-to-text recognition using the Web Speech API (SpeechRecognition). Wraps the browser's built-in speech recognition, supporting continuous listening, interim results, and language selection. Recognized text is accumulated in state and emitted as events for real-time transcription UIs.",
     "shortcut": "features.voice",
     "className": "VoiceRecognition",
     "methods": {
@@ -1220,11 +1268,17 @@ export const introspectionData = [
     },
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const voice = container.feature('voice', { continuous: true, autoListen: true })\n\nvoice.on('transcript', ({ text }) => {\n console.log('Heard:', text)\n})\n\n// Or start manually\nvoice.start()"
+      }
+    ]
   },
   {
     "id": "features.vm",
-    "description": "The VM features providers a virtual machine for executing JavaScript code in a sandboxed environment. The Vm feature automatically injects the container.context object into the global scope, so these things can be referenced in the code and the code can use anything provided by the container.",
+    "description": "Sandboxed JavaScript execution environment for the browser. Automatically injects the container's context object into the global scope, so evaluated code can use anything provided by the container. Useful for live code playgrounds, plugin systems, and dynamic script evaluation.",
     "shortcut": "features.vm",
     "className": "VM",
     "methods": {
@@ -1278,11 +1332,17 @@ export const introspectionData = [
     "events": {},
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const vm = container.feature('vm')\nconst result = vm.run('1 + 2 + 3') // 6\nconst greeting = vm.run('container.uuid') // accesses container globals"
+      }
+    ]
   },
   {
     "id": "features.assetLoader",
-    "description": "The AssetLoader provides an API for injecting scripts and stylesheets into the page. It also provides a convenient way of loading any library from unpkg.com",
+    "description": "Injects scripts and stylesheets into the page at runtime. Provides helpers for loading external libraries from unpkg.com, injecting arbitrary script/link tags, and managing load state. Used by other web features (e.g. Esbuild) to pull in dependencies on demand.",
     "shortcut": "features.assetLoader",
     "className": "AssetLoader",
     "methods": {
@@ -1335,11 +1395,17 @@ export const introspectionData = [
     "events": {},
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const loader = container.feature('assetLoader')\nawait loader.loadScript('https://unpkg.com/lodash')\nawait AssetLoader.loadStylesheet('https://unpkg.com/normalize.css')"
+      }
+    ]
   },
   {
     "id": "features.vault",
-    "description": "WebVault helper",
+    "description": "AES-256-GCM encryption and decryption for the browser using the Web Crypto API. Generates or accepts a secret key and provides `encrypt()` / `decrypt()` methods that work entirely client-side. Keys are stored as base64-encoded state so they can persist across sessions when needed.",
     "shortcut": "features.vault",
     "className": "WebVault",
     "methods": {
@@ -1385,11 +1451,17 @@ export const introspectionData = [
     "events": {},
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const vault = container.feature('vault')\nconst encrypted = await vault.encrypt('secret data')\nconst decrypted = await vault.decrypt(encrypted)\nconsole.log(decrypted) // 'secret data'"
+      }
+    ]
   },
   {
     "id": "features.network",
-    "description": "Network helper",
+    "description": "Tracks browser online/offline connectivity state. Listens for the browser's `online` and `offline` events and keeps the feature state in sync. Other features can observe the `offline` state value or listen for change events to react to connectivity changes.",
     "shortcut": "features.network",
     "className": "Network",
     "methods": {
@@ -1419,11 +1491,17 @@ export const introspectionData = [
     "events": {},
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const network = container.feature('network')\nconsole.log(network.state.get('offline')) // false when online\n\nnetwork.on('stateChanged', ({ offline }) => {\n console.log(offline ? 'Went offline' : 'Back online')\n})"
+      }
+    ]
   },
   {
     "id": "features.speech",
-    "description": "Speech helper",
+    "description": "Text-to-speech synthesis using the Web Speech API (SpeechSynthesis). Wraps the browser's built-in speech synthesis, providing voice selection, queue management, and state tracking. Voices are discovered on init and exposed via state for UI binding.",
     "shortcut": "features.speech",
     "className": "Speech",
     "methods": {
@@ -1483,7 +1561,13 @@ export const introspectionData = [
     "events": {},
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const speech = container.feature('speech')\nspeech.say('Hello from the browser!')\n\n// Choose a specific voice\nconst speech = container.feature('speech', { voice: 'Google UK English Female' })\nspeech.say('Cheerio!')"
+      }
+    ]
   },
   {
     "id": "features.helpers",

package/src/introspection/index.ts

@@ -213,7 +213,7 @@ export function interceptRegistration(registry: any, helperConstructor: any) {
 
 	const introspection: HelperIntrospection = {
 		id: key,
-		description: helperConstructor.description || existing?.description || '',
+		description: (helperConstructor.hasOwnProperty('description') ? helperConstructor.description : null) || existing?.description || helperConstructor.description || '',
 		shortcut: helperConstructor.shortcut,
 		className: helperConstructor.name || existing?.className,
 		// preserve build-time AST data if generated file already loaded

package/src/introspection/scan.ts

@@ -18,6 +18,7 @@ export const IntrospectionScannerOptionsSchema = FeatureOptionsSchema.extend({
   src: z.array(z.string()).optional(),
   outputPath: z.string().optional(),
   includePrivate: z.boolean().optional(),
+  importSource: z.string().optional(),
 })
 
 export type IntrospectionScannerState = z.infer<typeof IntrospectionScannerStateSchema>
@@ -874,11 +875,12 @@ export class IntrospectionScannerFeature extends Feature<IntrospectionScannerSta
   private createRegistryScript(results: HelperIntrospection[], containerResults: Partial<ContainerIntrospection>[] = []): string {
     const hasContainers = containerResults.length > 0;
 
+    const importSource = this.options.importSource || './index.js';
     let imports = `import { setBuildTimeData`;
     if (hasContainers) {
       imports += `, setContainerBuildTimeData`;
     }
-    imports += ` } from './index.js';\n\n`;
+    imports += ` } from '${importSource}';\n\n`;
 
     const registrations = results.map(result => {
       const data = JSON.stringify(result, null, 2);

package/src/node/features/container-link.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod'
 import { randomBytes } from 'crypto'
 import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '../../schemas/base.js'
-import { Feature, features } from '../feature.js'
+import { Feature } from '../feature.js'
 import { WebSocketServer } from 'ws'
 
 // --- Message Types ---
@@ -146,6 +146,7 @@ export class ContainerLink extends Feature<ContainerLinkState, ContainerLinkOpti
   static override stateSchema = ContainerLinkStateSchema
   static override optionsSchema = ContainerLinkOptionsSchema
   static override eventsSchema = ContainerLinkEventsSchema
+  static { Feature.register(this, 'containerLink') }
 
   private _wss?: WebSocketServer
   private _connections = new Map<string, ConnectedContainer>()
@@ -555,4 +556,4 @@ export class ContainerLink extends Feature<ContainerLinkState, ContainerLinkOpti
   }
 }
 
-export default features.register('containerLink', ContainerLink)
+export default ContainerLink

package/src/node/features/content-db.ts

@@ -1,4 +1,4 @@
-import { Feature, features } from '../feature.js'
+import { Feature } from '../feature.js'
 import { parse, Collection, extractSections, type ModelDefinition } from 'contentbase'
 import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
@@ -37,6 +37,7 @@ export class ContentDb extends Feature<ContentDbState, ContentDbOptions> {
   static override shortcut = 'features.contentDb' as const
   static override stateSchema = ContentDbStateSchema
   static override optionsSchema = ContentDbOptionsSchema
+  static { Feature.register(this, 'contentDb') }
 
   override get initialState(): ContentDbState {
     return {
@@ -127,6 +128,13 @@ export class ContentDb extends Feature<ContentDbState, ContentDbOptions> {
     return this
   }
 
+  /** Force-reload the collection from disk, picking up new/changed/deleted documents. */
+  async reload(): Promise<ContentDb> {
+    await this.collection.load({ refresh: true })
+    this.emit('reloaded')
+    return this
+  }
+
   /**
    * Read a single document by its path ID, optionally filtering to specific sections.
    *
@@ -472,4 +480,4 @@ export class ContentDb extends Feature<ContentDbState, ContentDbOptions> {
   }
 }
 
-export default features.register('contentDb', ContentDb)
+export default ContentDb

package/src/node/features/disk-cache.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
 import cacache from "cacache";
-import { Feature, type FeatureState, features } from "../feature.js";
+import { Feature, type FeatureState } from "../feature.js";
 import { NodeContainer } from "../container.js";
 import { partial } from "lodash-es";
 import type { ContainerContext } from "../../container.js";
@@ -34,8 +34,7 @@ export class DiskCache extends Feature<FeatureState,DiskCacheOptions> {
   static override shortcut = "features.diskCache" as const
   static override stateSchema = FeatureStateSchema
   static override optionsSchema = DiskCacheOptionsSchema
-
-  static attach(c: NodeContainer) {}
+  static { Feature.register(this, 'diskCache') }
 
   constructor(options: DiskCacheOptions, context: ContainerContext) {
     super(options, context)
@@ -379,4 +378,4 @@ export class DiskCache extends Feature<FeatureState,DiskCacheOptions> {
   }
 }
 
-export default features.register("diskCache", DiskCache);
+export default DiskCache;

package/src/node/features/dns.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod'
-import { Feature, features } from '../feature.js'
+import { Feature } from '../feature.js'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
 
 /** Supported DNS record types. */
@@ -121,6 +121,7 @@ export class Dns extends Feature<DnsState, DnsOptions> {
   static override description = 'DNS lookup utilities wrapping the dig CLI'
   static override stateSchema = DnsStateSchema
   static override optionsSchema = DnsOptionsSchema
+  static { Feature.register(this, 'dns') }
 
   override get initialState(): DnsState {
     return {
@@ -652,4 +653,4 @@ export class Dns extends Feature<DnsState, DnsOptions> {
   }
 }
 
-export default features.register('dns', Dns)
+export default Dns

package/src/node/features/docker.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
-import { Feature, features } from '../feature.js'
+import { Feature } from '../feature.js'
 
 export const DockerContainerSchema = z.object({
   /** Container ID */
@@ -87,6 +87,7 @@ export class Docker extends Feature<DockerState, DockerOptions> {
   static override shortcut = 'features.docker' as const
   static override stateSchema = DockerStateSchema
   static override optionsSchema = DockerOptionsSchema
+  static { Feature.register(this, 'docker') }
 
   override get initialState(): DockerState {
     return {
@@ -909,4 +910,4 @@ export class Docker extends Feature<DockerState, DockerOptions> {
   }
 }
 
-export default features.register('docker', Docker)
+export default Docker

package/src/node/features/downloader.ts

@@ -1,6 +1,5 @@
-import { Feature, features } from '../feature.js'
+import { Feature } from '../feature.js'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
-import fetch from 'cross-fetch'
 
 /**
  * A feature that provides file downloading capabilities from URLs.
@@ -25,16 +24,10 @@ import fetch from 'cross-fetch'
  * @extends Feature
  */
 export class Downloader extends Feature {
-  /**
-   * The shortcut path for accessing this feature through the container.
-   *
-   * @static
-   * @readonly
-   * @type {string}
-   */
   static override shortcut = 'features.downloader' as const
   static override stateSchema = FeatureStateSchema
   static override optionsSchema = FeatureOptionsSchema
+  static { Feature.register(this, 'downloader') }
   
   /**
    * Downloads a file from a URL and saves it to the specified local path.
@@ -83,10 +76,4 @@ export class Downloader extends Feature {
   
 }
 
-/**
- * Registers the Downloader feature with the features registry.
- * This makes the feature available for use in containers via `container.use('downloader')`.
- * 
- * @type {typeof Downloader}
- */
-export default features.register('downloader', Downloader)
+export default Downloader

package/src/node/features/esbuild.ts

@@ -1,7 +1,6 @@
 import * as esbuild from 'esbuild-wasm'
-import { Feature, features } from '../feature.js'
+import { Feature } from '../feature.js'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
-import { NodeContainer } from '../container.js'
 
 /**
  * A Feature for compiling typescript / esm modules, etc to JavaScript
@@ -19,17 +18,9 @@ export class ESBuild extends Feature {
   static override shortcut = 'features.esbuild' as const
   static override stateSchema = FeatureStateSchema
   static override optionsSchema = FeatureOptionsSchema
+  static { Feature.register(this, 'esbuild') }
 
   /**
-   * Attaches the ESBuild feature to a NodeContainer instance.
-   *
-   * @param c - The NodeContainer to attach to
-   * @returns The container for method chaining
-   */
-  static attach(c: NodeContainer) {
-    return c
-  }
-
   /**
    * Transform code synchronously
    * @param code - The code to transform
@@ -65,4 +56,4 @@ export class ESBuild extends Feature {
   }
 }
 
-export default features.register('esbuild', ESBuild)
+export default ESBuild

package/src/node/features/file-manager.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
 import { State } from "../../state.js";
-import { Feature, features } from "../feature.js";
+import { Feature } from "../feature.js";
 import { parse, relative } from "path";
 import { statSync } from "fs";
 import micromatch from "micromatch";
@@ -61,6 +61,7 @@ export class FileManager<
   static override shortcut = 'features.fileManager' as const
   static override stateSchema = FileManagerStateSchema
   static override optionsSchema = FileManagerOptionsSchema
+  static { Feature.register(this, 'fileManager') }
   
   files: State<Record<string, File>> = new State<Record<string, File>>({
     initialState: {},
@@ -354,4 +355,4 @@ export class FileManager<
   }
 }
 
-export default features.register("fileManager", FileManager);
+export default FileManager

package/src/node/features/fs.ts

@@ -1,4 +1,4 @@
-import { features, Feature } from "../feature.js";
+import { Feature } from "../feature.js";
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
 import {
   mkdirSync,
@@ -37,6 +37,7 @@ export class FS extends Feature {
   static override shortcut = "features.fs" as const
   static override stateSchema = FeatureStateSchema
   static override optionsSchema = FeatureOptionsSchema
+  static { Feature.register(this, 'fs') }
 
   /**
    * Asynchronously reads a file and returns its contents as a Buffer.
@@ -285,7 +286,11 @@ export class FS extends Feature {
    */
   ensureFolder(path: string) {
     mkdirSync(this.container.paths.resolve(path), { recursive: true });
-    return path;
+    return this.container.paths.resolve(path);
+  }
+
+  mkdirp(folder: string) {
+	  return this.ensureFolder(folder)
   }
 
   /**
@@ -400,6 +405,10 @@ export class FS extends Feature {
     }
   }
 
+  existsSync(path: string): boolean {
+	  return this.exists(path)
+  }
+
   /**
    * Asynchronously removes a file.
    *
@@ -531,4 +540,4 @@ export class FS extends Feature {
   }
 }
 
-export default features.register("fs", FS);
+export default FS

package/src/node/features/git.ts

@@ -2,7 +2,7 @@ import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema } from '../../schemas/base.js'
 import { dirname, resolve, isAbsolute } from 'path';
 import { State } from '../../state.js';
-import { features, Feature } from '../feature.js'
+import { Feature } from '../feature.js'
 
 type LsFilesOptions = {
     cached?: boolean;
@@ -48,6 +48,7 @@ export class Git extends Feature {
     static override shortcut = 'features.git' as const
     static override stateSchema = GitStateSchema
     static override optionsSchema = FeatureOptionsSchema
+    static { Feature.register(this, 'git') }
     override state: State<GitState> = new State()
 
     /**
@@ -489,4 +490,4 @@ export class Git extends Feature {
     }
 }
 
-export default features.register('git', Git)
+export default Git

package/src/node/features/google-auth.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '../../schemas/base.js'
-import { Feature, features } from '../feature.js'
+import { Feature } from '../feature.js'
 import { google } from 'googleapis'
 import type { OAuth2Client } from 'google-auth-library'
 
@@ -90,6 +90,7 @@ export class GoogleAuth extends Feature<GoogleAuthState, GoogleAuthOptions> {
   static override stateSchema = GoogleAuthStateSchema
   static override optionsSchema = GoogleAuthOptionsSchema
   static override eventsSchema = GoogleAuthEventsSchema
+  static { Feature.register(this, 'googleAuth') }
 
   private _oauth2Client?: OAuth2Client
   private _redirectUri?: string
@@ -499,4 +500,4 @@ declare module '../../feature' {
   }
 }
 
-export default features.register('googleAuth', GoogleAuth)
+export default GoogleAuth