@hyperfixi/behaviors 2.0.0 → 2.1.0

package/dist/behaviors/clipboard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/behaviors/clipboard.ts","../../src/schemas/clipboard.schema.ts","../../src/schemas/types.ts"],"sourcesContent":["/**\n * Clipboard Behavior — Imperative Implementation\n *\n * Copies text to clipboard on click with visual feedback.\n * Uses navigator.clipboard.writeText() with execCommand fallback.\n */\n\nimport { clipboardSchema } from '../schemas/clipboard.schema';\nimport type { LokaScriptInstance } from '../schemas/types';\nimport { resolveRuntime } from '../schemas/types';\n\n// Re-export schema-derived values\nexport const clipboardSource = clipboardSchema.source;\nexport const clipboardMetadata = clipboardSchema;\n\n/**\n * Copy text to clipboard using the modern Clipboard API,\n * falling back to execCommand for older browsers.\n */\nasync function copyToClipboard(text: string): Promise<void> {\n  if (navigator.clipboard?.writeText) {\n    await navigator.clipboard.writeText(text);\n    return;\n  }\n\n  // Fallback: temporary textarea + execCommand\n  const textarea = document.createElement('textarea');\n  textarea.value = text;\n  textarea.style.position = 'fixed';\n  textarea.style.opacity = '0';\n  document.body.appendChild(textarea);\n  textarea.select();\n  try {\n    document.execCommand('copy');\n  } finally {\n    document.body.removeChild(textarea);\n  }\n}\n\n/**\n * Resolve a selector parameter to an HTMLElement.\n */\nfunction resolveElement(element: HTMLElement, param: unknown): HTMLElement | null {\n  if (!param || param === 'me') return element;\n  if (param instanceof HTMLElement) return param;\n  if (typeof param === 'string') {\n    return (\n      (element.querySelector(param) as HTMLElement) ||\n      (document.querySelector(param) as HTMLElement) ||\n      null\n    );\n  }\n  return null;\n}\n\n/**\n * Imperative installer for Clipboard behavior.\n */\nfunction installClipboard(element: HTMLElement, params: Record<string, any>): void {\n  const feedbackDuration =\n    typeof params.feedbackDuration === 'number' ? params.feedbackDuration : 2000;\n\n  element.addEventListener('click', async () => {\n    // Determine text to copy\n    let copyText: string;\n    if (params.text != null) {\n      copyText = String(params.text);\n    } else {\n      const sourceEl = resolveElement(element, params.source) || element;\n      copyText = (sourceEl as HTMLInputElement).value ?? sourceEl.textContent ?? '';\n    }\n\n    try {\n      await copyToClipboard(copyText);\n\n      // Show feedback\n      const feedbackEl = resolveElement(element, params.feedback) || element;\n      feedbackEl.classList.add('copied');\n      setTimeout(() => feedbackEl.classList.remove('copied'), feedbackDuration);\n\n      element.dispatchEvent(\n        new CustomEvent('clipboard:copied', {\n          bubbles: true,\n          detail: { text: copyText },\n        })\n      );\n    } catch (error) {\n      element.dispatchEvent(\n        new CustomEvent('clipboard:error', {\n          bubbles: true,\n          detail: { error },\n        })\n      );\n    }\n  });\n}\n\n/**\n * Register the Clipboard behavior with LokaScript.\n */\nexport async function registerClipboard(hyperfixi?: LokaScriptInstance): Promise<void> {\n  const hf = hyperfixi || resolveRuntime();\n\n  if (!hf) {\n    throw new Error(\n      'LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.'\n    );\n  }\n\n  const syntheticNode = {\n    type: 'behavior',\n    name: 'Clipboard',\n    parameters: ['text', 'source', 'feedback', 'feedbackDuration'],\n    eventHandlers: [],\n    imperativeInstaller: installClipboard,\n  };\n  const ctx = hf.createContext ? hf.createContext() : { locals: new Map(), globals: new Map() };\n  await hf.execute(syntheticNode, ctx);\n}\n\n// Auto-register when loaded as a script tag\nif (resolveRuntime()) {\n  registerClipboard().catch(console.error);\n}\n\nexport default {\n  source: clipboardSchema.source,\n  metadata: clipboardSchema,\n  register: registerClipboard,\n};\n","import type { BehaviorSchema } from './types';\n\n/**\n * Clipboard Behavior Schema\n *\n * Copies text to clipboard on click with visual feedback.\n * Uses the Clipboard API with execCommand fallback.\n */\nexport const clipboardSchema: BehaviorSchema = {\n  name: 'Clipboard',\n  category: 'ui',\n  tier: 'core',\n  version: '1.0.0',\n  description: 'Copies text to clipboard on click with visual feedback',\n  parameters: [\n    {\n      name: 'text',\n      type: 'string',\n      optional: true,\n      description: 'Literal text to copy (takes priority over source)',\n    },\n    {\n      name: 'source',\n      type: 'selector',\n      optional: true,\n      default: 'me',\n      description: 'Element whose textContent or value is copied',\n    },\n    {\n      name: 'feedback',\n      type: 'selector',\n      optional: true,\n      description: 'Element to show .copied feedback on (defaults to the installed element)',\n    },\n    {\n      name: 'feedbackDuration',\n      type: 'number',\n      optional: true,\n      default: 2000,\n      description: 'Duration in ms to show .copied class feedback',\n    },\n  ],\n  events: [\n    { name: 'clipboard:copied', description: 'Fired after text is copied successfully' },\n    { name: 'clipboard:error', description: 'Fired when clipboard write fails' },\n  ],\n  requirements: [\n    'navigator.clipboard.writeText() requires HTTPS or localhost',\n    'Falls back to document.execCommand(\"copy\") for older browsers',\n  ],\n  source: [\n    'behavior Clipboard(text, source, feedback, feedbackDuration)',\n    '  init',\n    '    if feedbackDuration is undefined set feedbackDuration to 2000',\n    '    if source is undefined set source to me',\n    '  end',\n    '  on click',\n    '    if text is not undefined',\n    '      set copyText to text',\n    '    else',\n    \"      set copyText to source's value or source's textContent\",\n    '    end',\n    '    js(copyText) navigator.clipboard.writeText(copyText) end',\n    '    set feedbackEl to feedback or me',\n    '    add .copied to feedbackEl',\n    '    wait feedbackDuration ms',\n    '    remove .copied from feedbackEl',\n    '    trigger clipboard:copied',\n    '  end',\n    'end',\n  ].join('\\n'),\n};\n","/**\n * Behavior Schema Types\n *\n * Defines the structure for behavior metadata used for:\n * - Code generation (TypeScript types, documentation)\n * - Runtime categorization and lazy loading\n * - Tooling and IDE integration\n */\n\n/**\n * Behavior categories for organization.\n * - ui: Visual interaction behaviors (drag, resize, sort)\n * - data: Data manipulation behaviors (remove, transform)\n * - animation: Animation and transition behaviors\n * - form: Form-related behaviors (validation, toggle states)\n * - layout: Layout behaviors (sticky, scrollspy)\n */\nexport type BehaviorCategory = 'ui' | 'data' | 'animation' | 'form' | 'layout';\n\n/**\n * Loading tiers for lazy loading optimization.\n * - core: Always loaded (essential behaviors)\n * - common: High usage (loaded for typical apps)\n * - optional: Low usage (loaded on demand)\n */\nexport type BehaviorTier = 'core' | 'common' | 'optional';\n\n/**\n * Schema for a behavior parameter.\n */\nexport interface ParameterSchema {\n  name: string;\n  type: 'string' | 'number' | 'boolean' | 'selector' | 'element';\n  optional?: boolean;\n  default?: string | number | boolean;\n  /** Allowed values for constrained parameters */\n  enum?: string[];\n  description: string;\n}\n\n/**\n * Schema for a behavior event.\n */\nexport interface EventSchema {\n  name: string;\n  description: string;\n}\n\n/**\n * Complete schema for a behavior.\n * This is the source of truth for all behavior metadata.\n */\nexport interface BehaviorSchema {\n  /** Behavior name (PascalCase) */\n  name: string;\n  /** Category for organization */\n  category: BehaviorCategory;\n  /** Loading tier for lazy loading */\n  tier: BehaviorTier;\n  /** Semantic version */\n  version: string;\n  /** Human-readable description */\n  description: string;\n  /** Parameter definitions */\n  parameters: ParameterSchema[];\n  /** Event definitions */\n  events: EventSchema[];\n  /** The hyperscript behavior source code */\n  source: string;\n  /** Optional requirements or notes */\n  requirements?: string[];\n}\n\n/**\n * Runtime behavior module interface.\n * This is what gets registered with the hyperfixi runtime.\n */\nexport interface BehaviorModule {\n  source: string;\n  metadata: BehaviorSchema;\n  register: (hyperfixi?: LokaScriptInstance) => Promise<void>;\n}\n\n/**\n * Minimal LokaScript instance interface for behavior registration.\n */\nexport interface LokaScriptInstance {\n  compileSync: (\n    code: string,\n    options?: { traditional?: boolean; language?: string }\n  ) => {\n    ok: boolean;\n    ast?: unknown;\n    errors?: Array<{ message: string; line?: number; column?: number }>;\n  };\n  execute: (ast: unknown, ctx: unknown) => Promise<unknown>;\n  createContext?: () => { locals: Map<string, unknown>; globals: Map<string, unknown> };\n}\n\n/**\n * Typed window interface for behavior auto-registration.\n * Avoids `(window as any)` casts throughout the codebase.\n * Checks both `window.lokascript` and `window.hyperfixi` for the runtime instance.\n */\nexport interface LokaScriptWindow {\n  lokascript?: LokaScriptInstance;\n  hyperfixi?: LokaScriptInstance;\n  __hyperfixi_behaviors_ready?: Promise<void> | undefined;\n}\n\n/**\n * Resolve the LokaScript runtime from window globals.\n * Checks both `window.lokascript` and `window.hyperfixi`.\n */\nexport function resolveRuntime(): LokaScriptInstance | null {\n  if (typeof window === 'undefined') return null;\n  const win = window as unknown as LokaScriptWindow;\n  return win.lokascript || win.hyperfixi || null;\n}\n"],"mappings":"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","names":[]}

package/dist/behaviors/clipboard.d.cts

@@ -0,0 +1,15 @@
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.cjs';
+
+declare const clipboardSource: string;
+declare const clipboardMetadata: BehaviorSchema;
+/**
+ * Register the Clipboard behavior with LokaScript.
+ */
+declare function registerClipboard(hyperfixi?: LokaScriptInstance): Promise<void>;
+declare const _default: {
+    source: string;
+    metadata: BehaviorSchema;
+    register: typeof registerClipboard;
+};
+
+export { clipboardMetadata, clipboardSource, _default as default, registerClipboard };

package/dist/behaviors/clipboard.d.ts

@@ -0,0 +1,15 @@
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.js';
+
+declare const clipboardSource: string;
+declare const clipboardMetadata: BehaviorSchema;
+/**
+ * Register the Clipboard behavior with LokaScript.
+ */
+declare function registerClipboard(hyperfixi?: LokaScriptInstance): Promise<void>;
+declare const _default: {
+    source: string;
+    metadata: BehaviorSchema;
+    register: typeof registerClipboard;
+};
+
+export { clipboardMetadata, clipboardSource, _default as default, registerClipboard };

package/dist/behaviors/clipboard.js

@@ -0,0 +1,15 @@
+import {
+  clipboardMetadata,
+  clipboardSource,
+  clipboard_default,
+  registerClipboard
+} from "../chunk-2NSKQMNM.js";
+import "../chunk-QKDYW4VM.js";
+import "../chunk-6TJXDCAQ.js";
+export {
+  clipboardMetadata,
+  clipboardSource,
+  clipboard_default as default,
+  registerClipboard
+};
+//# sourceMappingURL=clipboard.js.map

package/dist/behaviors/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/behaviors/draggable.cjs

@@ -75,24 +75,66 @@ end
 `.trim()
 };
 
+// src/schemas/types.ts
+function resolveRuntime() {
+  if (typeof window === "undefined") return null;
+  const win = window;
+  return win.lokascript || win.hyperfixi || null;
+}
+
 // src/behaviors/draggable.ts
 var draggableSource = draggableSchema.source;
 var draggableMetadata = draggableSchema;
+function installDraggable(element, params) {
+  let dragHandle = element;
+  if (params.dragHandle && params.dragHandle !== "me") {
+    if (typeof params.dragHandle === "string") {
+      const found = element.querySelector(params.dragHandle);
+      if (found instanceof HTMLElement) dragHandle = found;
+    } else if (params.dragHandle instanceof HTMLElement) {
+      dragHandle = params.dragHandle;
+    }
+  }
+  dragHandle.addEventListener("pointerdown", (e) => {
+    e.preventDefault();
+    e.stopPropagation();
+    element.dispatchEvent(new CustomEvent("draggable:start", { bubbles: true }));
+    const startX = element.offsetLeft;
+    const startY = element.offsetTop;
+    const xoff = e.clientX - startX;
+    const yoff = e.clientY - startY;
+    function onMove(ev) {
+      element.style.left = `${ev.clientX - xoff}px`;
+      element.style.top = `${ev.clientY - yoff}px`;
+      element.dispatchEvent(new CustomEvent("draggable:move", { bubbles: true }));
+    }
+    function onUp() {
+      document.removeEventListener("pointermove", onMove);
+      document.removeEventListener("pointerup", onUp);
+      element.dispatchEvent(new CustomEvent("draggable:end", { bubbles: true }));
+    }
+    document.addEventListener("pointermove", onMove);
+    document.addEventListener("pointerup", onUp);
+  });
+}
 async function registerDraggable(hyperfixi) {
-  const hf = hyperfixi || (typeof window !== "undefined" ? window.lokascript : null);
+  const hf = hyperfixi || resolveRuntime();
   if (!hf) {
     throw new Error(
       "LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors."
     );
   }
-  const result = hf.compileSync(draggableSchema.source, { traditional: true });
-  if (!result.ok) {
-    throw new Error(`Failed to compile Draggable behavior: ${JSON.stringify(result.errors)}`);
-  }
+  const syntheticNode = {
+    type: "behavior",
+    name: "Draggable",
+    parameters: ["dragHandle"],
+    eventHandlers: [],
+    imperativeInstaller: installDraggable
+  };
   const ctx = hf.createContext ? hf.createContext() : { locals: /* @__PURE__ */ new Map(), globals: /* @__PURE__ */ new Map() };
-  await hf.execute(result.ast, ctx);
+  await hf.execute(syntheticNode, ctx);
 }
-if (typeof window !== "undefined" && window.lokascript) {
+if (resolveRuntime()) {
   registerDraggable().catch(console.error);
 }
 var draggable_default = {

package/dist/behaviors/draggable.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/behaviors/draggable.ts","../../src/schemas/draggable.schema.ts"],"sourcesContent":["/**\n * Draggable Behavior\n *\n * A reusable behavior that makes elements draggable with pointer events.\n * Supports custom drag handles, lifecycle events, and smooth positioning.\n *\n * @example\n * ```html\n * <!-- Basic usage -->\n * <div _=\"install Draggable\">Drag me!</div>\n *\n * <!-- With custom drag handle -->\n * <div _=\"install Draggable(dragHandle: .titlebar)\">\n *   <div class=\"titlebar\">Drag here</div>\n *   <div class=\"content\">Content</div>\n * </div>\n * ```\n */\n\nimport { draggableSchema } from '../schemas/draggable.schema';\nimport type { LokaScriptInstance, LokaScriptWindow } from '../schemas/types';\n\n// Re-export schema-derived values for backwards compatibility\nexport const draggableSource = draggableSchema.source;\nexport const draggableMetadata = draggableSchema;\n\n/**\n * Register the Draggable behavior with LokaScript.\n */\nexport async function registerDraggable(hyperfixi?: LokaScriptInstance): Promise<void> {\n  const hf =\n    hyperfixi ||\n    (typeof window !== 'undefined' ? (window as unknown as LokaScriptWindow).lokascript : null);\n\n  if (!hf) {\n    throw new Error(\n      'LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.'\n    );\n  }\n\n  const result = hf.compileSync(draggableSchema.source, { traditional: true });\n\n  if (!result.ok) {\n    throw new Error(`Failed to compile Draggable behavior: ${JSON.stringify(result.errors)}`);\n  }\n\n  const ctx = hf.createContext ? hf.createContext() : { locals: new Map(), globals: new Map() };\n  await hf.execute(result.ast, ctx);\n}\n\n// Auto-register when loaded as a script tag\nif (typeof window !== 'undefined' && (window as unknown as LokaScriptWindow).lokascript) {\n  registerDraggable().catch(console.error);\n}\n\nexport default {\n  source: draggableSchema.source,\n  metadata: draggableSchema,\n  register: registerDraggable,\n};\n","import type { BehaviorSchema } from './types';\n\n/**\n * Draggable Behavior Schema\n *\n * Makes elements draggable with pointer events.\n * Supports custom drag handles and lifecycle events.\n */\nexport const draggableSchema: BehaviorSchema = {\n  name: 'Draggable',\n  category: 'ui',\n  tier: 'core',\n  version: '1.0.0',\n  description: 'Makes elements draggable with pointer events',\n  parameters: [\n    {\n      name: 'dragHandle',\n      type: 'selector',\n      optional: true,\n      default: 'me',\n      description: 'CSS selector for the drag handle element',\n    },\n  ],\n  events: [\n    { name: 'draggable:start', description: 'Fired when drag begins' },\n    { name: 'draggable:move', description: 'Fired during each movement' },\n    { name: 'draggable:end', description: 'Fired when drag completes' },\n  ],\n  requirements: ['position: absolute or position: fixed on the element'],\n  source: `\nbehavior Draggable(dragHandle)\n  init\n    if no dragHandle set dragHandle to me\n  end\n  on pointerdown(clientX, clientY) from dragHandle\n    halt the event\n    trigger draggable:start\n    measure x\n    set startX to it\n    measure y\n    set startY to it\n    set xoff to clientX - startX\n    set yoff to clientY - startY\n    repeat until event pointerup from document\n      wait for pointermove(clientX, clientY) or\n               pointerup(clientX, clientY) from document\n      add { left: \\${clientX - xoff}px; top: \\${clientY - yoff}px; }\n      trigger draggable:move\n    end\n    trigger draggable:end\n  end\nend\n`.trim(),\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACQO,IAAM,kBAAkC;AAAA,EAC7C,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,IACV;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,EAAE,MAAM,mBAAmB,aAAa,yBAAyB;AAAA,IACjE,EAAE,MAAM,kBAAkB,aAAa,6BAA6B;AAAA,IACpE,EAAE,MAAM,iBAAiB,aAAa,4BAA4B;AAAA,EACpE;AAAA,EACA,cAAc,CAAC,sDAAsD;AAAA,EACrE,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBR,KAAK;AACP;;;AD9BO,IAAM,kBAAkB,gBAAgB;AACxC,IAAM,oBAAoB;AAKjC,eAAsB,kBAAkB,WAA+C;AACrF,QAAM,KACJ,cACC,OAAO,WAAW,cAAe,OAAuC,aAAa;AAExF,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,GAAG,YAAY,gBAAgB,QAAQ,EAAE,aAAa,KAAK,CAAC;AAE3E,MAAI,CAAC,OAAO,IAAI;AACd,UAAM,IAAI,MAAM,yCAAyC,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE;AAAA,EAC1F;AAEA,QAAM,MAAM,GAAG,gBAAgB,GAAG,cAAc,IAAI,EAAE,QAAQ,oBAAI,IAAI,GAAG,SAAS,oBAAI,IAAI,EAAE;AAC5F,QAAM,GAAG,QAAQ,OAAO,KAAK,GAAG;AAClC;AAGA,IAAI,OAAO,WAAW,eAAgB,OAAuC,YAAY;AACvF,oBAAkB,EAAE,MAAM,QAAQ,KAAK;AACzC;AAEA,IAAO,oBAAQ;AAAA,EACb,QAAQ,gBAAgB;AAAA,EACxB,UAAU;AAAA,EACV,UAAU;AACZ;","names":[]}
+{"version":3,"sources":["../../src/behaviors/draggable.ts","../../src/schemas/draggable.schema.ts","../../src/schemas/types.ts"],"sourcesContent":["/**\n * Draggable Behavior — Imperative Implementation\n *\n * Makes elements draggable with pointer events.\n * Uses direct DOM APIs instead of compiling hyperscript source,\n * bypassing the complex repeat-until-event + wait-for async pattern.\n *\n * @example\n * ```html\n * <!-- Basic usage -->\n * <div _=\"install Draggable\">Drag me!</div>\n *\n * <!-- With custom drag handle -->\n * <div _=\"install Draggable(dragHandle: .titlebar)\">\n *   <div class=\"titlebar\">Drag here</div>\n *   <div class=\"content\">Content</div>\n * </div>\n * ```\n */\n\nimport { draggableSchema } from '../schemas/draggable.schema';\nimport type { LokaScriptInstance } from '../schemas/types';\nimport { resolveRuntime } from '../schemas/types';\n\n// Re-export schema-derived values for backwards compatibility\nexport const draggableSource = draggableSchema.source;\nexport const draggableMetadata = draggableSchema;\n\n/**\n * Imperative installer for Draggable behavior.\n * Called directly by the runtime when `install Draggable` is executed.\n */\nfunction installDraggable(element: HTMLElement, params: Record<string, any>): void {\n  // Resolve drag handle: parameter value, CSS selector, or the element itself\n  let dragHandle: HTMLElement = element;\n  if (params.dragHandle && params.dragHandle !== 'me') {\n    if (typeof params.dragHandle === 'string') {\n      const found = element.querySelector(params.dragHandle);\n      if (found instanceof HTMLElement) dragHandle = found;\n    } else if (params.dragHandle instanceof HTMLElement) {\n      dragHandle = params.dragHandle;\n    }\n  }\n\n  dragHandle.addEventListener('pointerdown', (e: PointerEvent) => {\n    e.preventDefault();\n    e.stopPropagation();\n    element.dispatchEvent(new CustomEvent('draggable:start', { bubbles: true }));\n\n    const startX = element.offsetLeft;\n    const startY = element.offsetTop;\n    const xoff = e.clientX - startX;\n    const yoff = e.clientY - startY;\n\n    function onMove(ev: PointerEvent) {\n      element.style.left = `${ev.clientX - xoff}px`;\n      element.style.top = `${ev.clientY - yoff}px`;\n      element.dispatchEvent(new CustomEvent('draggable:move', { bubbles: true }));\n    }\n\n    function onUp() {\n      document.removeEventListener('pointermove', onMove);\n      document.removeEventListener('pointerup', onUp);\n      element.dispatchEvent(new CustomEvent('draggable:end', { bubbles: true }));\n    }\n\n    document.addEventListener('pointermove', onMove);\n    document.addEventListener('pointerup', onUp);\n  });\n}\n\n/**\n * Register the Draggable behavior with LokaScript.\n * Uses imperative installer via synthetic behavior node.\n */\nexport async function registerDraggable(hyperfixi?: LokaScriptInstance): Promise<void> {\n  const hf = hyperfixi || resolveRuntime();\n\n  if (!hf) {\n    throw new Error(\n      'LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.'\n    );\n  }\n\n  // Register via execute() with a synthetic behavior node containing the imperative installer.\n  // The runtime detects imperativeInstaller and stores it directly in the behaviorRegistry.\n  const syntheticNode = {\n    type: 'behavior',\n    name: 'Draggable',\n    parameters: ['dragHandle'],\n    eventHandlers: [],\n    imperativeInstaller: installDraggable,\n  };\n  const ctx = hf.createContext ? hf.createContext() : { locals: new Map(), globals: new Map() };\n  await hf.execute(syntheticNode, ctx);\n}\n\n// Auto-register when loaded as a script tag\nif (resolveRuntime()) {\n  registerDraggable().catch(console.error);\n}\n\nexport default {\n  source: draggableSchema.source,\n  metadata: draggableSchema,\n  register: registerDraggable,\n};\n","import type { BehaviorSchema } from './types';\n\n/**\n * Draggable Behavior Schema\n *\n * Makes elements draggable with pointer events.\n * Supports custom drag handles and lifecycle events.\n */\nexport const draggableSchema: BehaviorSchema = {\n  name: 'Draggable',\n  category: 'ui',\n  tier: 'core',\n  version: '1.0.0',\n  description: 'Makes elements draggable with pointer events',\n  parameters: [\n    {\n      name: 'dragHandle',\n      type: 'selector',\n      optional: true,\n      default: 'me',\n      description: 'CSS selector for the drag handle element',\n    },\n  ],\n  events: [\n    { name: 'draggable:start', description: 'Fired when drag begins' },\n    { name: 'draggable:move', description: 'Fired during each movement' },\n    { name: 'draggable:end', description: 'Fired when drag completes' },\n  ],\n  requirements: ['position: absolute or position: fixed on the element'],\n  source: `\nbehavior Draggable(dragHandle)\n  init\n    if no dragHandle set dragHandle to me\n  end\n  on pointerdown(clientX, clientY) from dragHandle\n    halt the event\n    trigger draggable:start\n    measure x\n    set startX to it\n    measure y\n    set startY to it\n    set xoff to clientX - startX\n    set yoff to clientY - startY\n    repeat until event pointerup from document\n      wait for pointermove(clientX, clientY) or\n               pointerup(clientX, clientY) from document\n      add { left: \\${clientX - xoff}px; top: \\${clientY - yoff}px; }\n      trigger draggable:move\n    end\n    trigger draggable:end\n  end\nend\n`.trim(),\n};\n","/**\n * Behavior Schema Types\n *\n * Defines the structure for behavior metadata used for:\n * - Code generation (TypeScript types, documentation)\n * - Runtime categorization and lazy loading\n * - Tooling and IDE integration\n */\n\n/**\n * Behavior categories for organization.\n * - ui: Visual interaction behaviors (drag, resize, sort)\n * - data: Data manipulation behaviors (remove, transform)\n * - animation: Animation and transition behaviors\n * - form: Form-related behaviors (validation, toggle states)\n * - layout: Layout behaviors (sticky, scrollspy)\n */\nexport type BehaviorCategory = 'ui' | 'data' | 'animation' | 'form' | 'layout';\n\n/**\n * Loading tiers for lazy loading optimization.\n * - core: Always loaded (essential behaviors)\n * - common: High usage (loaded for typical apps)\n * - optional: Low usage (loaded on demand)\n */\nexport type BehaviorTier = 'core' | 'common' | 'optional';\n\n/**\n * Schema for a behavior parameter.\n */\nexport interface ParameterSchema {\n  name: string;\n  type: 'string' | 'number' | 'boolean' | 'selector' | 'element';\n  optional?: boolean;\n  default?: string | number | boolean;\n  /** Allowed values for constrained parameters */\n  enum?: string[];\n  description: string;\n}\n\n/**\n * Schema for a behavior event.\n */\nexport interface EventSchema {\n  name: string;\n  description: string;\n}\n\n/**\n * Complete schema for a behavior.\n * This is the source of truth for all behavior metadata.\n */\nexport interface BehaviorSchema {\n  /** Behavior name (PascalCase) */\n  name: string;\n  /** Category for organization */\n  category: BehaviorCategory;\n  /** Loading tier for lazy loading */\n  tier: BehaviorTier;\n  /** Semantic version */\n  version: string;\n  /** Human-readable description */\n  description: string;\n  /** Parameter definitions */\n  parameters: ParameterSchema[];\n  /** Event definitions */\n  events: EventSchema[];\n  /** The hyperscript behavior source code */\n  source: string;\n  /** Optional requirements or notes */\n  requirements?: string[];\n}\n\n/**\n * Runtime behavior module interface.\n * This is what gets registered with the hyperfixi runtime.\n */\nexport interface BehaviorModule {\n  source: string;\n  metadata: BehaviorSchema;\n  register: (hyperfixi?: LokaScriptInstance) => Promise<void>;\n}\n\n/**\n * Minimal LokaScript instance interface for behavior registration.\n */\nexport interface LokaScriptInstance {\n  compileSync: (\n    code: string,\n    options?: { traditional?: boolean; language?: string }\n  ) => {\n    ok: boolean;\n    ast?: unknown;\n    errors?: Array<{ message: string; line?: number; column?: number }>;\n  };\n  execute: (ast: unknown, ctx: unknown) => Promise<unknown>;\n  createContext?: () => { locals: Map<string, unknown>; globals: Map<string, unknown> };\n}\n\n/**\n * Typed window interface for behavior auto-registration.\n * Avoids `(window as any)` casts throughout the codebase.\n * Checks both `window.lokascript` and `window.hyperfixi` for the runtime instance.\n */\nexport interface LokaScriptWindow {\n  lokascript?: LokaScriptInstance;\n  hyperfixi?: LokaScriptInstance;\n  __hyperfixi_behaviors_ready?: Promise<void> | undefined;\n}\n\n/**\n * Resolve the LokaScript runtime from window globals.\n * Checks both `window.lokascript` and `window.hyperfixi`.\n */\nexport function resolveRuntime(): LokaScriptInstance | null {\n  if (typeof window === 'undefined') return null;\n  const win = window as unknown as LokaScriptWindow;\n  return win.lokascript || win.hyperfixi || null;\n}\n"],"mappings":"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","names":[]}

package/dist/behaviors/draggable.d.cts

@@ -1,9 +1,10 @@
-import { a as BehaviorSchema, L as LokaScriptInstance } from '../types-CCc_2wAb.cjs';
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.cjs';
 
 declare const draggableSource: string;
 declare const draggableMetadata: BehaviorSchema;
 /**
  * Register the Draggable behavior with LokaScript.
+ * Uses imperative installer via synthetic behavior node.
  */
 declare function registerDraggable(hyperfixi?: LokaScriptInstance): Promise<void>;
 declare const _default: {

package/dist/behaviors/draggable.d.ts

@@ -1,9 +1,10 @@
-import { a as BehaviorSchema, L as LokaScriptInstance } from '../types-CCc_2wAb.js';
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.js';
 
 declare const draggableSource: string;
 declare const draggableMetadata: BehaviorSchema;
 /**
  * Register the Draggable behavior with LokaScript.
+ * Uses imperative installer via synthetic behavior node.
  */
 declare function registerDraggable(hyperfixi?: LokaScriptInstance): Promise<void>;
 declare const _default: {

package/dist/behaviors/draggable.js

@@ -3,8 +3,9 @@ import {
   draggableSource,
   draggable_default,
   registerDraggable
-} from "../chunk-WU37DFAL.js";
+} from "../chunk-S4QDV2MH.js";
 import "../chunk-G6WR2AYR.js";
+import "../chunk-6TJXDCAQ.js";
 export {
   draggable_default as default,
   draggableMetadata,

package/dist/behaviors/focustrap.cjs

@@ -0,0 +1,191 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/behaviors/focustrap.ts
+var focustrap_exports = {};
+__export(focustrap_exports, {
+  default: () => focustrap_default,
+  focusTrapMetadata: () => focusTrapMetadata,
+  focusTrapSource: () => focusTrapSource,
+  registerFocusTrap: () => registerFocusTrap
+});
+module.exports = __toCommonJS(focustrap_exports);
+
+// src/schemas/focustrap.schema.ts
+var focusTrapSchema = {
+  name: "FocusTrap",
+  category: "ui",
+  tier: "core",
+  version: "1.0.0",
+  description: "Confines Tab navigation inside an element with ARIA support",
+  parameters: [
+    {
+      name: "active",
+      type: "boolean",
+      optional: true,
+      default: true,
+      description: "Whether the trap is active on install"
+    },
+    {
+      name: "initialFocus",
+      type: "selector",
+      optional: true,
+      description: "Element to focus when the trap activates"
+    },
+    {
+      name: "returnFocus",
+      type: "boolean",
+      optional: true,
+      default: true,
+      description: "Restore focus to the previously focused element on deactivation"
+    }
+  ],
+  events: [
+    { name: "focustrap:activated", description: "Fired when the trap is activated" },
+    { name: "focustrap:deactivated", description: "Fired when the trap is deactivated" }
+  ],
+  requirements: [
+    'Sets aria-modal="true" on the element when active',
+    "Listens for focustrap:activate and focustrap:deactivate custom events for programmatic control"
+  ],
+  source: `
+behavior FocusTrap(active, initialFocus, returnFocus)
+  init
+    if active is undefined set active to true
+    if returnFocus is undefined set returnFocus to true
+  end
+  -- Imperative installer handles Tab key trapping and focus management
+end`.trim()
+};
+
+// src/schemas/types.ts
+function resolveRuntime() {
+  if (typeof window === "undefined") return null;
+  const win = window;
+  return win.lokascript || win.hyperfixi || null;
+}
+
+// src/behaviors/focustrap.ts
+var focusTrapSource = focusTrapSchema.source;
+var focusTrapMetadata = focusTrapSchema;
+var FOCUSABLE_SELECTOR = [
+  "a[href]",
+  "button:not(:disabled)",
+  "input:not(:disabled)",
+  "select:not(:disabled)",
+  "textarea:not(:disabled)",
+  '[tabindex]:not([tabindex="-1"])'
+].join(", ");
+function resolveElement(container, param) {
+  if (!param) return null;
+  if (param instanceof HTMLElement) return param;
+  if (typeof param === "string") {
+    return container.querySelector(param) || document.querySelector(param) || null;
+  }
+  return null;
+}
+function installFocusTrap(element, params) {
+  const returnFocus = params.returnFocus !== false;
+  let isActive = false;
+  let previouslyFocused = null;
+  function getFocusableElements() {
+    return Array.from(element.querySelectorAll(FOCUSABLE_SELECTOR));
+  }
+  function onKeyDown(e) {
+    if (!isActive || e.key !== "Tab") return;
+    const focusable = getFocusableElements();
+    if (focusable.length === 0) {
+      e.preventDefault();
+      return;
+    }
+    e.preventDefault();
+    const currentIndex = focusable.indexOf(document.activeElement);
+    if (e.shiftKey) {
+      const prevIndex = currentIndex <= 0 ? focusable.length - 1 : currentIndex - 1;
+      focusable[prevIndex].focus();
+    } else {
+      const nextIndex = currentIndex >= focusable.length - 1 ? 0 : currentIndex + 1;
+      focusable[nextIndex].focus();
+    }
+  }
+  function activate() {
+    if (isActive) return;
+    isActive = true;
+    previouslyFocused = document.activeElement;
+    element.setAttribute("aria-modal", "true");
+    const initialEl = resolveElement(element, params.initialFocus);
+    if (initialEl) {
+      initialEl.focus();
+    } else {
+      const focusable = getFocusableElements();
+      if (focusable.length > 0) {
+        focusable[0].focus();
+      }
+    }
+    element.dispatchEvent(new CustomEvent("focustrap:activated", { bubbles: true }));
+  }
+  function deactivate() {
+    if (!isActive) return;
+    isActive = false;
+    element.removeAttribute("aria-modal");
+    if (returnFocus && previouslyFocused instanceof HTMLElement) {
+      previouslyFocused.focus();
+    }
+    previouslyFocused = null;
+    element.dispatchEvent(new CustomEvent("focustrap:deactivated", { bubbles: true }));
+  }
+  element.addEventListener("keydown", onKeyDown);
+  element.addEventListener("focustrap:activate", () => activate());
+  element.addEventListener("focustrap:deactivate", () => deactivate());
+  if (params.active !== false) {
+    activate();
+  }
+}
+async function registerFocusTrap(hyperfixi) {
+  const hf = hyperfixi || resolveRuntime();
+  if (!hf) {
+    throw new Error(
+      "LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors."
+    );
+  }
+  const syntheticNode = {
+    type: "behavior",
+    name: "FocusTrap",
+    parameters: ["active", "initialFocus", "returnFocus"],
+    eventHandlers: [],
+    imperativeInstaller: installFocusTrap
+  };
+  const ctx = hf.createContext ? hf.createContext() : { locals: /* @__PURE__ */ new Map(), globals: /* @__PURE__ */ new Map() };
+  await hf.execute(syntheticNode, ctx);
+}
+if (resolveRuntime()) {
+  registerFocusTrap().catch(console.error);
+}
+var focustrap_default = {
+  source: focusTrapSchema.source,
+  metadata: focusTrapSchema,
+  register: registerFocusTrap
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  focusTrapMetadata,
+  focusTrapSource,
+  registerFocusTrap
+});
+//# sourceMappingURL=focustrap.cjs.map

package/dist/behaviors/focustrap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/behaviors/focustrap.ts","../../src/schemas/focustrap.schema.ts","../../src/schemas/types.ts"],"sourcesContent":["/**\n * FocusTrap Behavior — Imperative Implementation\n *\n * Confines Tab navigation inside an element, manages aria-modal,\n * and restores focus on deactivation.\n */\n\nimport { focusTrapSchema } from '../schemas/focustrap.schema';\nimport type { LokaScriptInstance } from '../schemas/types';\nimport { resolveRuntime } from '../schemas/types';\n\n// Re-export schema-derived values\nexport const focusTrapSource = focusTrapSchema.source;\nexport const focusTrapMetadata = focusTrapSchema;\n\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not(:disabled)',\n  'input:not(:disabled)',\n  'select:not(:disabled)',\n  'textarea:not(:disabled)',\n  '[tabindex]:not([tabindex=\"-1\"])',\n].join(', ');\n\n/**\n * Resolve a selector parameter to an HTMLElement within the container.\n */\nfunction resolveElement(container: HTMLElement, param: unknown): HTMLElement | null {\n  if (!param) return null;\n  if (param instanceof HTMLElement) return param;\n  if (typeof param === 'string') {\n    return (\n      (container.querySelector(param) as HTMLElement) ||\n      (document.querySelector(param) as HTMLElement) ||\n      null\n    );\n  }\n  return null;\n}\n\n/**\n * Imperative installer for FocusTrap behavior.\n */\nfunction installFocusTrap(element: HTMLElement, params: Record<string, any>): void {\n  const returnFocus = params.returnFocus !== false;\n  let isActive = false;\n  let previouslyFocused: Element | null = null;\n\n  function getFocusableElements(): HTMLElement[] {\n    return Array.from(element.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR));\n  }\n\n  function onKeyDown(e: KeyboardEvent) {\n    if (!isActive || e.key !== 'Tab') return;\n\n    const focusable = getFocusableElements();\n    if (focusable.length === 0) {\n      e.preventDefault();\n      return;\n    }\n\n    // Always prevent default Tab and manually manage focus.\n    // This ensures focus never escapes to elements outside the trap,\n    // even when the modal is embedded in a page with other focusable elements.\n    e.preventDefault();\n\n    const currentIndex = focusable.indexOf(document.activeElement as HTMLElement);\n\n    if (e.shiftKey) {\n      const prevIndex = currentIndex <= 0 ? focusable.length - 1 : currentIndex - 1;\n      focusable[prevIndex].focus();\n    } else {\n      const nextIndex = currentIndex >= focusable.length - 1 ? 0 : currentIndex + 1;\n      focusable[nextIndex].focus();\n    }\n  }\n\n  function activate() {\n    if (isActive) return;\n    isActive = true;\n    previouslyFocused = document.activeElement;\n\n    element.setAttribute('aria-modal', 'true');\n\n    // Focus initialFocus element or first focusable\n    const initialEl = resolveElement(element, params.initialFocus);\n    if (initialEl) {\n      initialEl.focus();\n    } else {\n      const focusable = getFocusableElements();\n      if (focusable.length > 0) {\n        focusable[0].focus();\n      }\n    }\n\n    element.dispatchEvent(new CustomEvent('focustrap:activated', { bubbles: true }));\n  }\n\n  function deactivate() {\n    if (!isActive) return;\n    isActive = false;\n\n    element.removeAttribute('aria-modal');\n\n    if (returnFocus && previouslyFocused instanceof HTMLElement) {\n      previouslyFocused.focus();\n    }\n    previouslyFocused = null;\n\n    element.dispatchEvent(new CustomEvent('focustrap:deactivated', { bubbles: true }));\n  }\n\n  // Keydown handler for Tab trapping\n  element.addEventListener('keydown', onKeyDown);\n\n  // Programmatic activation/deactivation via custom events\n  element.addEventListener('focustrap:activate', () => activate());\n  element.addEventListener('focustrap:deactivate', () => deactivate());\n\n  // Activate immediately if requested\n  if (params.active !== false) {\n    activate();\n  }\n}\n\n/**\n * Register the FocusTrap behavior with LokaScript.\n */\nexport async function registerFocusTrap(hyperfixi?: LokaScriptInstance): Promise<void> {\n  const hf = hyperfixi || resolveRuntime();\n\n  if (!hf) {\n    throw new Error(\n      'LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.'\n    );\n  }\n\n  const syntheticNode = {\n    type: 'behavior',\n    name: 'FocusTrap',\n    parameters: ['active', 'initialFocus', 'returnFocus'],\n    eventHandlers: [],\n    imperativeInstaller: installFocusTrap,\n  };\n  const ctx = hf.createContext ? hf.createContext() : { locals: new Map(), globals: new Map() };\n  await hf.execute(syntheticNode, ctx);\n}\n\n// Auto-register when loaded as a script tag\nif (resolveRuntime()) {\n  registerFocusTrap().catch(console.error);\n}\n\nexport default {\n  source: focusTrapSchema.source,\n  metadata: focusTrapSchema,\n  register: registerFocusTrap,\n};\n","import type { BehaviorSchema } from './types';\n\n/**\n * FocusTrap Behavior Schema\n *\n * Confines Tab navigation inside an element and restores focus on release.\n * Manages aria-modal for accessibility compliance.\n */\nexport const focusTrapSchema: BehaviorSchema = {\n  name: 'FocusTrap',\n  category: 'ui',\n  tier: 'core',\n  version: '1.0.0',\n  description: 'Confines Tab navigation inside an element with ARIA support',\n  parameters: [\n    {\n      name: 'active',\n      type: 'boolean',\n      optional: true,\n      default: true,\n      description: 'Whether the trap is active on install',\n    },\n    {\n      name: 'initialFocus',\n      type: 'selector',\n      optional: true,\n      description: 'Element to focus when the trap activates',\n    },\n    {\n      name: 'returnFocus',\n      type: 'boolean',\n      optional: true,\n      default: true,\n      description: 'Restore focus to the previously focused element on deactivation',\n    },\n  ],\n  events: [\n    { name: 'focustrap:activated', description: 'Fired when the trap is activated' },\n    { name: 'focustrap:deactivated', description: 'Fired when the trap is deactivated' },\n  ],\n  requirements: [\n    'Sets aria-modal=\"true\" on the element when active',\n    'Listens for focustrap:activate and focustrap:deactivate custom events for programmatic control',\n  ],\n  source: `\nbehavior FocusTrap(active, initialFocus, returnFocus)\n  init\n    if active is undefined set active to true\n    if returnFocus is undefined set returnFocus to true\n  end\n  -- Imperative installer handles Tab key trapping and focus management\nend`.trim(),\n};\n","/**\n * Behavior Schema Types\n *\n * Defines the structure for behavior metadata used for:\n * - Code generation (TypeScript types, documentation)\n * - Runtime categorization and lazy loading\n * - Tooling and IDE integration\n */\n\n/**\n * Behavior categories for organization.\n * - ui: Visual interaction behaviors (drag, resize, sort)\n * - data: Data manipulation behaviors (remove, transform)\n * - animation: Animation and transition behaviors\n * - form: Form-related behaviors (validation, toggle states)\n * - layout: Layout behaviors (sticky, scrollspy)\n */\nexport type BehaviorCategory = 'ui' | 'data' | 'animation' | 'form' | 'layout';\n\n/**\n * Loading tiers for lazy loading optimization.\n * - core: Always loaded (essential behaviors)\n * - common: High usage (loaded for typical apps)\n * - optional: Low usage (loaded on demand)\n */\nexport type BehaviorTier = 'core' | 'common' | 'optional';\n\n/**\n * Schema for a behavior parameter.\n */\nexport interface ParameterSchema {\n  name: string;\n  type: 'string' | 'number' | 'boolean' | 'selector' | 'element';\n  optional?: boolean;\n  default?: string | number | boolean;\n  /** Allowed values for constrained parameters */\n  enum?: string[];\n  description: string;\n}\n\n/**\n * Schema for a behavior event.\n */\nexport interface EventSchema {\n  name: string;\n  description: string;\n}\n\n/**\n * Complete schema for a behavior.\n * This is the source of truth for all behavior metadata.\n */\nexport interface BehaviorSchema {\n  /** Behavior name (PascalCase) */\n  name: string;\n  /** Category for organization */\n  category: BehaviorCategory;\n  /** Loading tier for lazy loading */\n  tier: BehaviorTier;\n  /** Semantic version */\n  version: string;\n  /** Human-readable description */\n  description: string;\n  /** Parameter definitions */\n  parameters: ParameterSchema[];\n  /** Event definitions */\n  events: EventSchema[];\n  /** The hyperscript behavior source code */\n  source: string;\n  /** Optional requirements or notes */\n  requirements?: string[];\n}\n\n/**\n * Runtime behavior module interface.\n * This is what gets registered with the hyperfixi runtime.\n */\nexport interface BehaviorModule {\n  source: string;\n  metadata: BehaviorSchema;\n  register: (hyperfixi?: LokaScriptInstance) => Promise<void>;\n}\n\n/**\n * Minimal LokaScript instance interface for behavior registration.\n */\nexport interface LokaScriptInstance {\n  compileSync: (\n    code: string,\n    options?: { traditional?: boolean; language?: string }\n  ) => {\n    ok: boolean;\n    ast?: unknown;\n    errors?: Array<{ message: string; line?: number; column?: number }>;\n  };\n  execute: (ast: unknown, ctx: unknown) => Promise<unknown>;\n  createContext?: () => { locals: Map<string, unknown>; globals: Map<string, unknown> };\n}\n\n/**\n * Typed window interface for behavior auto-registration.\n * Avoids `(window as any)` casts throughout the codebase.\n * Checks both `window.lokascript` and `window.hyperfixi` for the runtime instance.\n */\nexport interface LokaScriptWindow {\n  lokascript?: LokaScriptInstance;\n  hyperfixi?: LokaScriptInstance;\n  __hyperfixi_behaviors_ready?: Promise<void> | undefined;\n}\n\n/**\n * Resolve the LokaScript runtime from window globals.\n * Checks both `window.lokascript` and `window.hyperfixi`.\n */\nexport function resolveRuntime(): LokaScriptInstance | null {\n  if (typeof window === 'undefined') return null;\n  const win = window as unknown as LokaScriptWindow;\n  return win.lokascript || win.hyperfixi || null;\n}\n"],"mappings":"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","names":[]}

package/dist/behaviors/focustrap.d.cts

@@ -0,0 +1,15 @@
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.cjs';
+
+declare const focusTrapSource: string;
+declare const focusTrapMetadata: BehaviorSchema;
+/**
+ * Register the FocusTrap behavior with LokaScript.
+ */
+declare function registerFocusTrap(hyperfixi?: LokaScriptInstance): Promise<void>;
+declare const _default: {
+    source: string;
+    metadata: BehaviorSchema;
+    register: typeof registerFocusTrap;
+};
+
+export { _default as default, focusTrapMetadata, focusTrapSource, registerFocusTrap };

package/dist/behaviors/focustrap.d.ts

@@ -0,0 +1,15 @@
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.js';
+
+declare const focusTrapSource: string;
+declare const focusTrapMetadata: BehaviorSchema;
+/**
+ * Register the FocusTrap behavior with LokaScript.
+ */
+declare function registerFocusTrap(hyperfixi?: LokaScriptInstance): Promise<void>;
+declare const _default: {
+    source: string;
+    metadata: BehaviorSchema;
+    register: typeof registerFocusTrap;
+};
+
+export { _default as default, focusTrapMetadata, focusTrapSource, registerFocusTrap };

package/dist/behaviors/focustrap.js

@@ -0,0 +1,15 @@
+import {
+  focusTrapMetadata,
+  focusTrapSource,
+  focustrap_default,
+  registerFocusTrap
+} from "../chunk-AFGA54SA.js";
+import "../chunk-RB7OB6OD.js";
+import "../chunk-6TJXDCAQ.js";
+export {
+  focustrap_default as default,
+  focusTrapMetadata,
+  focusTrapSource,
+  registerFocusTrap
+};
+//# sourceMappingURL=focustrap.js.map

package/dist/behaviors/focustrap.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/behaviors/removable.cjs

@@ -86,11 +86,18 @@ end
 `.trim()
 };
 
+// src/schemas/types.ts
+function resolveRuntime() {
+  if (typeof window === "undefined") return null;
+  const win = window;
+  return win.lokascript || win.hyperfixi || null;
+}
+
 // src/behaviors/removable.ts
 var removableSource = removableSchema.source;
 var removableMetadata = removableSchema;
 async function registerRemovable(hyperfixi) {
-  const hf = hyperfixi || (typeof window !== "undefined" ? window.lokascript : null);
+  const hf = hyperfixi || resolveRuntime();
   if (!hf) {
     throw new Error(
       "LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors."
@@ -103,7 +110,7 @@ async function registerRemovable(hyperfixi) {
   const ctx = hf.createContext ? hf.createContext() : { locals: /* @__PURE__ */ new Map(), globals: /* @__PURE__ */ new Map() };
   await hf.execute(result.ast, ctx);
 }
-if (typeof window !== "undefined" && window.lokascript) {
+if (resolveRuntime()) {
   registerRemovable().catch(console.error);
 }
 var removable_default = {

package/dist/behaviors/removable.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/behaviors/removable.ts","../../src/schemas/removable.schema.ts"],"sourcesContent":["/**\n * Removable Behavior\n *\n * A behavior that removes an element when a trigger is clicked.\n * Supports optional confirmation and transition effects.\n *\n * @example\n * ```html\n * <div _=\"install Removable\">Click to remove</div>\n *\n * <div _=\"install Removable(confirm: true)\">With confirmation</div>\n * ```\n */\n\nimport { removableSchema } from '../schemas/removable.schema';\nimport type { LokaScriptInstance, LokaScriptWindow } from '../schemas/types';\n\n// Re-export schema-derived values for backwards compatibility\nexport const removableSource = removableSchema.source;\nexport const removableMetadata = removableSchema;\n\n/**\n * Register the Removable behavior with LokaScript.\n */\nexport async function registerRemovable(hyperfixi?: LokaScriptInstance): Promise<void> {\n  const hf =\n    hyperfixi ||\n    (typeof window !== 'undefined' ? (window as unknown as LokaScriptWindow).lokascript : null);\n\n  if (!hf) {\n    throw new Error(\n      'LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.'\n    );\n  }\n\n  const result = hf.compileSync(removableSchema.source, { traditional: true });\n\n  if (!result.ok) {\n    throw new Error(`Failed to compile Removable behavior: ${JSON.stringify(result.errors)}`);\n  }\n\n  const ctx = hf.createContext ? hf.createContext() : { locals: new Map(), globals: new Map() };\n  await hf.execute(result.ast, ctx);\n}\n\n// Auto-register when loaded as a script tag\nif (typeof window !== 'undefined' && (window as unknown as LokaScriptWindow).lokascript) {\n  registerRemovable().catch(console.error);\n}\n\nexport default {\n  source: removableSchema.source,\n  metadata: removableSchema,\n  register: registerRemovable,\n};\n","import type { BehaviorSchema } from './types';\n\n/**\n * Removable Behavior Schema\n *\n * Removes an element when a trigger is clicked.\n * Supports optional confirmation and transition effects.\n *\n * @since 1.2.0 — `trigger` parameter renamed to `triggerEl` to avoid\n * shadowing the hyperscript `trigger` command keyword. Users migrating\n * from v1.x should update: `install Removable(triggerEl: .close-btn)`.\n */\nexport const removableSchema: BehaviorSchema = {\n  name: 'Removable',\n  category: 'data',\n  tier: 'common',\n  version: '1.2.0',\n  description: 'Makes elements removable on click',\n  parameters: [\n    {\n      name: 'triggerEl',\n      type: 'selector',\n      optional: true,\n      default: 'me',\n      description: 'Element that triggers removal (e.g., a close button)',\n    },\n    {\n      name: 'confirm',\n      type: 'boolean',\n      optional: true,\n      default: false,\n      description: 'Show confirmation dialog before removal',\n    },\n    {\n      name: 'effect',\n      type: 'string',\n      optional: true,\n      default: 'none',\n      enum: ['fade', 'none'],\n      description: 'Transition effect: \"fade\" or \"none\"',\n    },\n  ],\n  events: [\n    { name: 'removable:before', description: 'Fired before removal (cancelable)' },\n    { name: 'removable:removed', description: 'Fired after removal' },\n  ],\n  source: `\nbehavior Removable(triggerEl, confirm, effect)\n  init\n    if triggerEl is undefined\n      set triggerEl to me\n    end\n  end\n  on click from triggerEl\n    if confirm\n      if not window.confirm(\"Are you sure?\")\n        halt\n      end\n    end\n    trigger removable:before\n    if effect is \"fade\"\n      transition opacity to 0 over 300ms\n    end\n    trigger removable:removed\n    remove me\n  end\nend\n`.trim(),\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,IAAM,kBAAkC;AAAA,EAC7C,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,IACV;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,MAAM,CAAC,QAAQ,MAAM;AAAA,MACrB,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,EAAE,MAAM,oBAAoB,aAAa,oCAAoC;AAAA,IAC7E,EAAE,MAAM,qBAAqB,aAAa,sBAAsB;AAAA,EAClE;AAAA,EACA,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBR,KAAK;AACP;;;ADlDO,IAAM,kBAAkB,gBAAgB;AACxC,IAAM,oBAAoB;AAKjC,eAAsB,kBAAkB,WAA+C;AACrF,QAAM,KACJ,cACC,OAAO,WAAW,cAAe,OAAuC,aAAa;AAExF,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,GAAG,YAAY,gBAAgB,QAAQ,EAAE,aAAa,KAAK,CAAC;AAE3E,MAAI,CAAC,OAAO,IAAI;AACd,UAAM,IAAI,MAAM,yCAAyC,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE;AAAA,EAC1F;AAEA,QAAM,MAAM,GAAG,gBAAgB,GAAG,cAAc,IAAI,EAAE,QAAQ,oBAAI,IAAI,GAAG,SAAS,oBAAI,IAAI,EAAE;AAC5F,QAAM,GAAG,QAAQ,OAAO,KAAK,GAAG;AAClC;AAGA,IAAI,OAAO,WAAW,eAAgB,OAAuC,YAAY;AACvF,oBAAkB,EAAE,MAAM,QAAQ,KAAK;AACzC;AAEA,IAAO,oBAAQ;AAAA,EACb,QAAQ,gBAAgB;AAAA,EACxB,UAAU;AAAA,EACV,UAAU;AACZ;","names":[]}
+{"version":3,"sources":["../../src/behaviors/removable.ts","../../src/schemas/removable.schema.ts","../../src/schemas/types.ts"],"sourcesContent":["/**\n * Removable Behavior\n *\n * A behavior that removes an element when a trigger is clicked.\n * Supports optional confirmation and transition effects.\n *\n * @example\n * ```html\n * <div _=\"install Removable\">Click to remove</div>\n *\n * <div _=\"install Removable(confirm: true)\">With confirmation</div>\n * ```\n */\n\nimport { removableSchema } from '../schemas/removable.schema';\nimport type { LokaScriptInstance } from '../schemas/types';\nimport { resolveRuntime } from '../schemas/types';\n\n// Re-export schema-derived values for backwards compatibility\nexport const removableSource = removableSchema.source;\nexport const removableMetadata = removableSchema;\n\n/**\n * Register the Removable behavior with LokaScript.\n */\nexport async function registerRemovable(hyperfixi?: LokaScriptInstance): Promise<void> {\n  const hf = hyperfixi || resolveRuntime();\n\n  if (!hf) {\n    throw new Error(\n      'LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.'\n    );\n  }\n\n  const result = hf.compileSync(removableSchema.source, { traditional: true });\n\n  if (!result.ok) {\n    throw new Error(`Failed to compile Removable behavior: ${JSON.stringify(result.errors)}`);\n  }\n\n  const ctx = hf.createContext ? hf.createContext() : { locals: new Map(), globals: new Map() };\n  await hf.execute(result.ast, ctx);\n}\n\n// Auto-register when loaded as a script tag\nif (resolveRuntime()) {\n  registerRemovable().catch(console.error);\n}\n\nexport default {\n  source: removableSchema.source,\n  metadata: removableSchema,\n  register: registerRemovable,\n};\n","import type { BehaviorSchema } from './types';\n\n/**\n * Removable Behavior Schema\n *\n * Removes an element when a trigger is clicked.\n * Supports optional confirmation and transition effects.\n *\n * @since 1.2.0 — `trigger` parameter renamed to `triggerEl` to avoid\n * shadowing the hyperscript `trigger` command keyword. Users migrating\n * from v1.x should update: `install Removable(triggerEl: .close-btn)`.\n */\nexport const removableSchema: BehaviorSchema = {\n  name: 'Removable',\n  category: 'data',\n  tier: 'common',\n  version: '1.2.0',\n  description: 'Makes elements removable on click',\n  parameters: [\n    {\n      name: 'triggerEl',\n      type: 'selector',\n      optional: true,\n      default: 'me',\n      description: 'Element that triggers removal (e.g., a close button)',\n    },\n    {\n      name: 'confirm',\n      type: 'boolean',\n      optional: true,\n      default: false,\n      description: 'Show confirmation dialog before removal',\n    },\n    {\n      name: 'effect',\n      type: 'string',\n      optional: true,\n      default: 'none',\n      enum: ['fade', 'none'],\n      description: 'Transition effect: \"fade\" or \"none\"',\n    },\n  ],\n  events: [\n    { name: 'removable:before', description: 'Fired before removal (cancelable)' },\n    { name: 'removable:removed', description: 'Fired after removal' },\n  ],\n  source: `\nbehavior Removable(triggerEl, confirm, effect)\n  init\n    if triggerEl is undefined\n      set triggerEl to me\n    end\n  end\n  on click from triggerEl\n    if confirm\n      if not window.confirm(\"Are you sure?\")\n        halt\n      end\n    end\n    trigger removable:before\n    if effect is \"fade\"\n      transition opacity to 0 over 300ms\n    end\n    trigger removable:removed\n    remove me\n  end\nend\n`.trim(),\n};\n","/**\n * Behavior Schema Types\n *\n * Defines the structure for behavior metadata used for:\n * - Code generation (TypeScript types, documentation)\n * - Runtime categorization and lazy loading\n * - Tooling and IDE integration\n */\n\n/**\n * Behavior categories for organization.\n * - ui: Visual interaction behaviors (drag, resize, sort)\n * - data: Data manipulation behaviors (remove, transform)\n * - animation: Animation and transition behaviors\n * - form: Form-related behaviors (validation, toggle states)\n * - layout: Layout behaviors (sticky, scrollspy)\n */\nexport type BehaviorCategory = 'ui' | 'data' | 'animation' | 'form' | 'layout';\n\n/**\n * Loading tiers for lazy loading optimization.\n * - core: Always loaded (essential behaviors)\n * - common: High usage (loaded for typical apps)\n * - optional: Low usage (loaded on demand)\n */\nexport type BehaviorTier = 'core' | 'common' | 'optional';\n\n/**\n * Schema for a behavior parameter.\n */\nexport interface ParameterSchema {\n  name: string;\n  type: 'string' | 'number' | 'boolean' | 'selector' | 'element';\n  optional?: boolean;\n  default?: string | number | boolean;\n  /** Allowed values for constrained parameters */\n  enum?: string[];\n  description: string;\n}\n\n/**\n * Schema for a behavior event.\n */\nexport interface EventSchema {\n  name: string;\n  description: string;\n}\n\n/**\n * Complete schema for a behavior.\n * This is the source of truth for all behavior metadata.\n */\nexport interface BehaviorSchema {\n  /** Behavior name (PascalCase) */\n  name: string;\n  /** Category for organization */\n  category: BehaviorCategory;\n  /** Loading tier for lazy loading */\n  tier: BehaviorTier;\n  /** Semantic version */\n  version: string;\n  /** Human-readable description */\n  description: string;\n  /** Parameter definitions */\n  parameters: ParameterSchema[];\n  /** Event definitions */\n  events: EventSchema[];\n  /** The hyperscript behavior source code */\n  source: string;\n  /** Optional requirements or notes */\n  requirements?: string[];\n}\n\n/**\n * Runtime behavior module interface.\n * This is what gets registered with the hyperfixi runtime.\n */\nexport interface BehaviorModule {\n  source: string;\n  metadata: BehaviorSchema;\n  register: (hyperfixi?: LokaScriptInstance) => Promise<void>;\n}\n\n/**\n * Minimal LokaScript instance interface for behavior registration.\n */\nexport interface LokaScriptInstance {\n  compileSync: (\n    code: string,\n    options?: { traditional?: boolean; language?: string }\n  ) => {\n    ok: boolean;\n    ast?: unknown;\n    errors?: Array<{ message: string; line?: number; column?: number }>;\n  };\n  execute: (ast: unknown, ctx: unknown) => Promise<unknown>;\n  createContext?: () => { locals: Map<string, unknown>; globals: Map<string, unknown> };\n}\n\n/**\n * Typed window interface for behavior auto-registration.\n * Avoids `(window as any)` casts throughout the codebase.\n * Checks both `window.lokascript` and `window.hyperfixi` for the runtime instance.\n */\nexport interface LokaScriptWindow {\n  lokascript?: LokaScriptInstance;\n  hyperfixi?: LokaScriptInstance;\n  __hyperfixi_behaviors_ready?: Promise<void> | undefined;\n}\n\n/**\n * Resolve the LokaScript runtime from window globals.\n * Checks both `window.lokascript` and `window.hyperfixi`.\n */\nexport function resolveRuntime(): LokaScriptInstance | null {\n  if (typeof window === 'undefined') return null;\n  const win = window as unknown as LokaScriptWindow;\n  return win.lokascript || win.hyperfixi || null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,IAAM,kBAAkC;AAAA,EAC7C,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM;AAAA,EACN,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,IACV;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,MAAM,CAAC,QAAQ,MAAM;AAAA,MACrB,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,EAAE,MAAM,oBAAoB,aAAa,oCAAoC;AAAA,IAC7E,EAAE,MAAM,qBAAqB,aAAa,sBAAsB;AAAA,EAClE;AAAA,EACA,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBR,KAAK;AACP;;;AC8CO,SAAS,iBAA4C;AAC1D,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,QAAM,MAAM;AACZ,SAAO,IAAI,cAAc,IAAI,aAAa;AAC5C;;;AFnGO,IAAM,kBAAkB,gBAAgB;AACxC,IAAM,oBAAoB;AAKjC,eAAsB,kBAAkB,WAA+C;AACrF,QAAM,KAAK,aAAa,eAAe;AAEvC,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,GAAG,YAAY,gBAAgB,QAAQ,EAAE,aAAa,KAAK,CAAC;AAE3E,MAAI,CAAC,OAAO,IAAI;AACd,UAAM,IAAI,MAAM,yCAAyC,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE;AAAA,EAC1F;AAEA,QAAM,MAAM,GAAG,gBAAgB,GAAG,cAAc,IAAI,EAAE,QAAQ,oBAAI,IAAI,GAAG,SAAS,oBAAI,IAAI,EAAE;AAC5F,QAAM,GAAG,QAAQ,OAAO,KAAK,GAAG;AAClC;AAGA,IAAI,eAAe,GAAG;AACpB,oBAAkB,EAAE,MAAM,QAAQ,KAAK;AACzC;AAEA,IAAO,oBAAQ;AAAA,EACb,QAAQ,gBAAgB;AAAA,EACxB,UAAU;AAAA,EACV,UAAU;AACZ;","names":[]}

package/dist/behaviors/removable.d.cts

@@ -1,4 +1,4 @@
-import { a as BehaviorSchema, L as LokaScriptInstance } from '../types-CCc_2wAb.cjs';
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.cjs';
 
 declare const removableSource: string;
 declare const removableMetadata: BehaviorSchema;

package/dist/behaviors/removable.d.ts

@@ -1,4 +1,4 @@
-import { a as BehaviorSchema, L as LokaScriptInstance } from '../types-CCc_2wAb.js';
+import { B as BehaviorSchema, L as LokaScriptInstance } from '../types-DCCtVQS5.js';
 
 declare const removableSource: string;
 declare const removableMetadata: BehaviorSchema;

package/dist/behaviors/removable.js

@@ -3,8 +3,9 @@ import {
   removableMetadata,
   removableSource,
   removable_default
-} from "../chunk-2NQHIHD5.js";
+} from "../chunk-H5Y5ARYG.js";
 import "../chunk-272NKUJ3.js";
+import "../chunk-6TJXDCAQ.js";
 export {
   removable_default as default,
   registerRemovable,