@soederpop/luca 0.0.6 → 0.0.8

package/src/node/features/ui.ts

@@ -48,75 +48,11 @@ type ColoredPrintFunction = PrintFunction & {
 
 /**
  * UI Feature - Interactive Terminal User Interface Builder
- * 
- * This feature provides comprehensive tools for creating beautiful, interactive terminal experiences.
- * It combines several popular libraries (chalk, figlet, inquirer) into a unified interface for
- * building professional CLI applications with colors, ASCII art, and interactive prompts.
- * 
- * **Core Capabilities:**
- * - Rich color management using chalk library
- * - ASCII art generation with multiple fonts
- * - Interactive prompts and wizards
- * - Automatic color assignment for consistent theming
- * - Text padding and formatting utilities
- * - Gradient text effects (horizontal and vertical)
- * - Banner creation with styled ASCII art
- * 
- * **Color System:**
- * - Full chalk API access for complex styling
- * - Automatic color assignment with palette cycling
- * - Consistent color mapping for named entities
- * - Support for hex colors and gradients
- * 
- * **ASCII Art Features:**
- * - Multiple font options via figlet
- * - Automatic font discovery and caching
- * - Banner creation with color gradients
- * - Text styling and effects
- * 
- * **Interactive Elements:**
- * - Wizard creation with inquirer integration
- * - External editor integration
- * - User input validation and processing
- * 
- * **Usage Examples:**
- * 
- * **Basic Colors:**
- * ```typescript
- * const ui = container.feature('ui');
- * 
- * // Direct color usage
- * ui.print.red('Error message');
- * ui.print.green('Success!');
- * 
- * // Complex styling
- * console.log(ui.colors.blue.bold.underline('Important text'));
- * ```
- * 
- * **ASCII Art Banners:**
- * ```typescript
- * const banner = ui.banner('MyApp', {
- *   font: 'Big',
- *   colors: ['red', 'white', 'blue']
- * });
- * console.log(banner);
- * ```
- * 
- * **Interactive Wizards:**
- * ```typescript
- * const answers = await ui.wizard([
- *   { type: 'input', name: 'name', message: 'Your name?' },
- *   { type: 'confirm', name: 'continue', message: 'Continue?' }
- * ]);
- * ```
- * 
- * **Automatic Color Assignment:**
- * ```typescript
- * const userColor = ui.assignColor('john');
- * const adminColor = ui.assignColor('admin');
- * console.log(userColor('John\'s message'));
- * console.log(adminColor('Admin notice'));
- * ```
+ *
+ * Unified interface for building professional CLI experiences using chalk (colors/styles),
+ * figlet (ASCII art), and inquirer (interactive prompts). Provides rich color management,
+ * automatic color assignment, text gradients, banner generation, padding utilities,
+ * markdown rendering, and interactive wizards.
  */
 export class UI<T extends UIState = UIState> extends Feature<T> {
   static { Feature.register(this, 'ui') }

package/src/node/features/vm.ts

@@ -155,6 +155,15 @@ export class VM<
   createContext(ctx: any = {}) {
     if (this.isContext(ctx)) return ctx
     return vm.createContext({
+      console,
+      setTimeout,
+      setInterval,
+      clearTimeout,
+      clearInterval,
+      process,
+      Buffer,
+      URL,
+      URLSearchParams,
       ...this.container.context,
       ...ctx
     })
@@ -340,6 +349,14 @@ export class VM<
       exports: {},
       module: { exports: {} },
       console,
+      setTimeout,
+      setInterval,
+      clearTimeout,
+      clearInterval,
+      process,
+      Buffer,
+      URL,
+      URLSearchParams,
       ...ctx,
     })
 

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

@@ -72,15 +72,20 @@ export const WindowManagerEventsSchema = FeatureEventsSchema.extend({
 
 // --- Types ---
 
+/** A dimension value — either absolute points or a percentage string like `"50%"`. */
+export type DimensionValue = number | `${number}%`
+
 /**
  * Options for spawning a new native browser window.
+ * Dimensions and positions accept absolute points or percentage strings (e.g. `"50%"`)
+ * resolved against the primary display.
  */
 export interface SpawnOptions {
   url?: string
-  width?: number
-  height?: number
-  x?: number
-  y?: number
+  width?: DimensionValue
+  height?: DimensionValue
+  x?: DimensionValue
+  y?: DimensionValue
   alwaysOnTop?: boolean
   window?: {
     decorations?: 'normal' | 'hiddenTitleBar' | 'none'
@@ -94,6 +99,8 @@ export interface SpawnOptions {
 
 /**
  * Options for spawning a native terminal window.
+ * Dimensions and positions accept absolute points or percentage strings (e.g. `"50%"`)
+ * resolved against the primary display.
  */
 export interface SpawnTTYOptions {
   /** Executable name or path (required). */
@@ -111,13 +118,13 @@ export interface SpawnTTYOptions {
   /** Window title. */
   title?: string
   /** Window width in points. */
-  width?: number
+  width?: DimensionValue
   /** Window height in points. */
-  height?: number
+  height?: DimensionValue
   /** Window x position. */
-  x?: number
+  x?: DimensionValue
   /** Window y position. */
-  y?: number
+  y?: DimensionValue
   /** Chrome options (decorations, alwaysOnTop, etc.) */
   window?: SpawnOptions['window']
 }
@@ -366,10 +373,7 @@ export class WindowManager extends Feature<WindowManagerState, WindowManagerOpti
   }
 
   private getBridgeListener(): any | undefined {
-    const listener = (this.container as any).launcherAppCommandListener
-    if (!listener || listener === this) return undefined
-    if (typeof listener.send !== 'function') return undefined
-    return listener
+    return undefined
   }
 
   /** Default state: not listening, no client connected, zero windows tracked. */
@@ -440,13 +444,15 @@ export class WindowManager extends Feature<WindowManagerState, WindowManagerOpti
       this.handleClientConnect(socket)
     })
 
+    // Set immediately to prevent parallel calls from creating duplicate servers
+    this._server = server
+
     server.on('error', (err) => {
       this.setState({ lastError: err.message })
     })
 
     const finalPath = socketPath
     server.listen(finalPath, () => {
-      this._server = server
       this.setState({ listening: true, socketPath: finalPath })
       this.emit('listening')
     })
@@ -502,7 +508,8 @@ export class WindowManager extends Feature<WindowManagerState, WindowManagerOpti
    * @returns A WindowHandle for the spawned window (with `.result` containing the ack data)
    */
   async spawn(opts: SpawnOptions = {}): Promise<WindowHandle> {
-    const { window: windowChrome, ...flat } = opts
+    const resolved = this.resolveDimensions(opts)
+    const { window: windowChrome, ...flat } = resolved
 
     let ackResult: WindowAckResult
     if (windowChrome) {
@@ -533,7 +540,8 @@ export class WindowManager extends Feature<WindowManagerState, WindowManagerOpti
    * @returns A WindowHandle for the spawned terminal (with `.result` containing the ack data)
    */
   async spawnTTY(opts: SpawnTTYOptions): Promise<WindowHandle> {
-    const { window: windowChrome, ...flat } = opts
+    const resolved = this.resolveDimensions(opts)
+    const { window: windowChrome, ...flat } = resolved
 
     let ackResult: WindowAckResult
     if (windowChrome) {
@@ -668,16 +676,17 @@ export class WindowManager extends Feature<WindowManagerState, WindowManagerOpti
    * ```
    */
   async spawnLayout(config: LayoutEntry[]): Promise<WindowHandle[]> {
-    const promises = config.map(entry => {
+    const handles: WindowHandle[] = []
+    for (const entry of config) {
       if (entry.type === 'tty' || ('command' in entry && !entry.type)) {
         const { type, ...opts } = entry as { type?: string } & SpawnTTYOptions
-        return this.spawnTTY(opts)
+        handles.push(await this.spawnTTY(opts))
       } else {
         const { type, ...opts } = entry as { type?: string } & SpawnOptions
-        return this.spawn(opts)
+        handles.push(await this.spawn(opts))
       }
-    })
-    return Promise.all(promises)
+    }
+    return handles
   }
 
   /**
@@ -718,6 +727,45 @@ export class WindowManager extends Feature<WindowManagerState, WindowManagerOpti
 
   // --- Private internals ---
 
+  private _displayCache: { width: number; height: number } | null = null
+
+  /**
+   * Get the primary display resolution, cached for the lifetime of the feature.
+   */
+  private getPrimaryDisplay(): { width: number; height: number } {
+    if (this._displayCache) return this._displayCache
+    const osFeature = this.container.feature('os')
+    const displays = osFeature.getDisplayInfo()
+    const primary = displays.find(d => d.main) ?? displays[0]
+    if (!primary) throw new Error('No displays found')
+    this._displayCache = { width: primary.resolution.width, height: primary.resolution.height }
+    return this._displayCache
+  }
+
+  /**
+   * Resolve percentage-based dimension values to absolute points using the primary display.
+   * Passes through absolute numbers unchanged. Only fetches display info if percentages are present.
+   */
+  private resolveDimensions<T extends Record<string, any>>(opts: T): T {
+    const keys = ['width', 'height', 'x', 'y'] as const
+    const hasPercentage = keys.some(k => typeof opts[k] === 'string' && (opts[k] as string).endsWith('%'))
+    if (!hasPercentage) return opts
+
+    const display = this.getPrimaryDisplay()
+    const resolved = { ...opts }
+
+    for (const key of keys) {
+      const val = opts[key]
+      if (typeof val === 'string' && val.endsWith('%')) {
+        const pct = parseFloat(val) / 100
+        const ref = (key === 'width' || key === 'x') ? display.width : display.height
+        ;(resolved as any)[key] = Math.round(pct * ref)
+      }
+    }
+
+    return resolved
+  }
+
   /**
    * Handle a new client connection from the native app.
    * Sets up NDJSON buffering and event forwarding.

package/src/node.ts

@@ -42,8 +42,12 @@ export { Registry } from './registry'
 
 // Helper subclasses & registries
 export { Client, ClientsRegistry } from './client'
+export { RestClient } from './clients/rest'
+export { GraphClient } from './clients/graph'
+export { WebSocketClient } from './clients/websocket'
 export { Command, CommandsRegistry, commands } from './command'
 export { Endpoint, EndpointsRegistry, endpoints } from './endpoint'
+export { Selector, SelectorsRegistry, selectors } from './selector'
 export { Server, ServersRegistry } from './server'
 export { FeaturesRegistry } from './feature'
 
@@ -56,6 +60,7 @@ export type { ContainerContext, ContainerArgv, Plugin, Extension } from './conta
 export type { AvailableClients } from './client'
 export type { AvailableCommands, CommandHandler } from './command'
 export type { AvailableEndpoints, EndpointContext } from './endpoint'
+export type { AvailableSelectors, SelectorsInterface, SelectorRunResult, SimpleSelector } from './selector'
 export type { AvailableFeatures, FeatureOptions, FeatureState } from './feature'
 export type { NodeContainer, NodeFeatures } from './node/container'
 export type { AvailableServers, StartOptions, ServersInterface } from './server'