@hyperfixi/behaviors 2.5.0 → 2.6.0

package/dist/draggable.browser.global.js

@@ -1,4 +1,4 @@
-"use strict";var HyperFixiBehaviors=(()=>{var i=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var h=(e,t)=>{for(var r in t)i(e,r,{get:t[r],enumerable:!0})},x=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of v(t))!b.call(e,o)&&o!==r&&i(e,o,{get:()=>t[o],enumerable:!(n=f(t,o))||n.enumerable});return e};var y=e=>x(i({},"__esModule",{value:!0}),e);var L={};h(L,{default:()=>E,draggableMetadata:()=>S,draggableSource:()=>w,registerDraggable:()=>c});var a={name:"Draggable",category:"ui",tier:"core",version:"1.0.0",description:"Makes elements draggable with pointer events",parameters:[{name:"dragHandle",type:"selector",optional:!0,default:"me",description:"CSS selector for the drag handle element"}],events:[{name:"draggable:start",description:"Fired when drag begins"},{name:"draggable:move",description:"Fired during each movement"},{name:"draggable:end",description:"Fired when drag completes"}],requirements:["position: absolute or position: fixed on the element"],source:`
+"use strict";var HyperFixiBehaviors=(()=>{var i=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var d=(t,e)=>{for(var r in e)i(t,r,{get:e[r],enumerable:!0})},m=(t,e,r,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of p(e))!g.call(t,o)&&o!==r&&i(t,o,{get:()=>e[o],enumerable:!(a=l(e,o))||a.enumerable});return t};var u=t=>m(i({},"__esModule",{value:!0}),t);var x={};d(x,{default:()=>b,draggableMetadata:()=>h,draggableSource:()=>f,registerDraggable:()=>c});var n={name:"Draggable",category:"ui",tier:"core",version:"1.0.0",description:"Makes elements draggable with pointer events (EXPERIMENTAL \u2014 stateful async component, beyond the inline-scripting boundary; not part of the curated set)",parameters:[{name:"dragHandle",type:"selector",optional:!0,default:"me",description:"CSS selector for the drag handle element"}],events:[{name:"draggable:start",description:"Fired when drag begins"},{name:"draggable:move",description:"Fired during each movement"},{name:"draggable:end",description:"Fired when drag completes"}],requirements:["position: absolute or position: fixed on the element"],source:`
 behavior Draggable(dragHandle)
   init
     if no dragHandle set dragHandle to me
@@ -21,5 +21,5 @@ behavior Draggable(dragHandle)
     trigger draggable:end
   end
 end
-`.trim()};function s(){if(typeof window>"u")return null;let e=window;return e.lokascript||e.hyperfixi||null}var w=a.source,S=a;function k(e,t){let r=e;if(t.dragHandle&&t.dragHandle!=="me")if(typeof t.dragHandle=="string"){let n=e.querySelector(t.dragHandle);n instanceof HTMLElement&&(r=n)}else t.dragHandle instanceof HTMLElement&&(r=t.dragHandle);r.addEventListener("pointerdown",n=>{n.preventDefault(),n.stopPropagation(),e.dispatchEvent(new CustomEvent("draggable:start",{bubbles:!0}));let o=e.offsetLeft,p=e.offsetTop,m=n.clientX-o,u=n.clientY-p;function d(g){e.style.left=`${g.clientX-m}px`,e.style.top=`${g.clientY-u}px`,e.dispatchEvent(new CustomEvent("draggable:move",{bubbles:!0}))}function l(){document.removeEventListener("pointermove",d),document.removeEventListener("pointerup",l),e.dispatchEvent(new CustomEvent("draggable:end",{bubbles:!0}))}document.addEventListener("pointermove",d),document.addEventListener("pointerup",l)})}async function c(e){let t=e||s();if(!t)throw new Error("LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.");let r={type:"behavior",name:"Draggable",parameters:["dragHandle"],eventHandlers:[],imperativeInstaller:k},n=t.createContext?t.createContext():{locals:new Map,globals:new Map};await t.execute(r,n)}s()&&c().catch(console.error);var E={source:a.source,metadata:a,register:c};return y(L);})();
+`.trim()};function s(){if(typeof window>"u")return null;let t=window;return t.lokascript||t.hyperfixi||null}var f=n.source,h=n;async function c(t){let e=t||s();if(!e)throw new Error("LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.");let r=e.compileSync(n.source,{traditional:!0});if(!r.ok)throw new Error(`Failed to compile Draggable behavior: ${JSON.stringify(r.errors)}`);let a=e.createContext?e.createContext():{locals:new Map,globals:new Map};await e.execute(r.ast,a)}s()&&c().catch(console.error);var b={source:n.source,metadata:n,register:c};return u(x);})();
 //# sourceMappingURL=draggable.browser.global.js.map

package/dist/draggable.browser.global.js.map

@@ -1 +1 @@
-{"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":"scAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,sBAAAC,EAAA,oBAAAC,EAAA,sBAAAC,ICQO,IAAMC,EAAkC,CAC7C,KAAM,YACN,SAAU,KACV,KAAM,OACN,QAAS,QACT,YAAa,+CACb,WAAY,CACV,CACE,KAAM,aACN,KAAM,WACN,SAAU,GACV,QAAS,KACT,YAAa,0CACf,CACF,EACA,OAAQ,CACN,CAAE,KAAM,kBAAmB,YAAa,wBAAyB,EACjE,CAAE,KAAM,iBAAkB,YAAa,4BAA6B,EACpE,CAAE,KAAM,gBAAiB,YAAa,2BAA4B,CACpE,EACA,aAAc,CAAC,sDAAsD,EACrE,OAAQ;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,CACP,EC6DO,SAASC,GAA4C,CAC1D,GAAI,OAAO,OAAW,IAAa,OAAO,KAC1C,IAAMC,EAAM,OACZ,OAAOA,EAAI,YAAcA,EAAI,WAAa,IAC5C,CF7FO,IAAMC,EAAkBC,EAAgB,OAClCC,EAAoBD,EAMjC,SAASE,EAAiBC,EAAsBC,EAAmC,CAEjF,IAAIC,EAA0BF,EAC9B,GAAIC,EAAO,YAAcA,EAAO,aAAe,KAC7C,GAAI,OAAOA,EAAO,YAAe,SAAU,CACzC,IAAME,EAAQH,EAAQ,cAAcC,EAAO,UAAU,EACjDE,aAAiB,cAAaD,EAAaC,EACjD,MAAWF,EAAO,sBAAsB,cACtCC,EAAaD,EAAO,YAIxBC,EAAW,iBAAiB,cAAgBE,GAAoB,CAC9DA,EAAE,eAAe,EACjBA,EAAE,gBAAgB,EAClBJ,EAAQ,cAAc,IAAI,YAAY,kBAAmB,CAAE,QAAS,EAAK,CAAC,CAAC,EAE3E,IAAMK,EAASL,EAAQ,WACjBM,EAASN,EAAQ,UACjBO,EAAOH,EAAE,QAAUC,EACnBG,EAAOJ,EAAE,QAAUE,EAEzB,SAASG,EAAOC,EAAkB,CAChCV,EAAQ,MAAM,KAAO,GAAGU,EAAG,QAAUH,CAAI,KACzCP,EAAQ,MAAM,IAAM,GAAGU,EAAG,QAAUF,CAAI,KACxCR,EAAQ,cAAc,IAAI,YAAY,iBAAkB,CAAE,QAAS,EAAK,CAAC,CAAC,CAC5E,CAEA,SAASW,GAAO,CACd,SAAS,oBAAoB,cAAeF,CAAM,EAClD,SAAS,oBAAoB,YAAaE,CAAI,EAC9CX,EAAQ,cAAc,IAAI,YAAY,gBAAiB,CAAE,QAAS,EAAK,CAAC,CAAC,CAC3E,CAEA,SAAS,iBAAiB,cAAeS,CAAM,EAC/C,SAAS,iBAAiB,YAAaE,CAAI,CAC7C,CAAC,CACH,CAMA,eAAsBC,EAAkBC,EAA+C,CACrF,IAAMC,EAAKD,GAAaE,EAAe,EAEvC,GAAI,CAACD,EACH,MAAM,IAAI,MACR,yFACF,EAKF,IAAME,EAAgB,CACpB,KAAM,WACN,KAAM,YACN,WAAY,CAAC,YAAY,EACzB,cAAe,CAAC,EAChB,oBAAqBjB,CACvB,EACMkB,EAAMH,EAAG,cAAgBA,EAAG,cAAc,EAAI,CAAE,OAAQ,IAAI,IAAO,QAAS,IAAI,GAAM,EAC5F,MAAMA,EAAG,QAAQE,EAAeC,CAAG,CACrC,CAGIF,EAAe,GACjBH,EAAkB,EAAE,MAAM,QAAQ,KAAK,EAGzC,IAAOM,EAAQ,CACb,OAAQrB,EAAgB,OACxB,SAAUA,EACV,SAAUe,CACZ","names":["draggable_exports","__export","draggable_default","draggableMetadata","draggableSource","registerDraggable","draggableSchema","resolveRuntime","win","draggableSource","draggableSchema","draggableMetadata","installDraggable","element","params","dragHandle","found","e","startX","startY","xoff","yoff","onMove","ev","onUp","registerDraggable","hyperfixi","hf","resolveRuntime","syntheticNode","ctx","draggable_default"]}
+{"version":3,"sources":["../src/behaviors/draggable.ts","../src/schemas/draggable.schema.ts","../src/schemas/types.ts"],"sourcesContent":["/**\n * Draggable Behavior\n *\n * Makes elements draggable with pointer events. Compiled from its hyperscript\n * `source` (the single source of truth shared with the CDN resolver bundle and\n * patterns-reference) — no imperative installer. The source uses\n * `repeat until event pointerup` + `wait for pointermove or pointerup` to run the\n * drag loop, `measure` for the start offset, and `add { left: ${…}px }` to move.\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 * Register the Draggable behavior with LokaScript by compiling its hyperscript\n * source and executing the resulting behavior definition.\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  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 (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:\n    'Makes elements draggable with pointer events (EXPERIMENTAL — stateful async component, beyond the inline-scripting boundary; not part of the curated set)',\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":"scAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,sBAAAC,EAAA,oBAAAC,EAAA,sBAAAC,ICQO,IAAMC,EAAkC,CAC7C,KAAM,YACN,SAAU,KACV,KAAM,OACN,QAAS,QACT,YACE,iKACF,WAAY,CACV,CACE,KAAM,aACN,KAAM,WACN,SAAU,GACV,QAAS,KACT,YAAa,0CACf,CACF,EACA,OAAQ,CACN,CAAE,KAAM,kBAAmB,YAAa,wBAAyB,EACjE,CAAE,KAAM,iBAAkB,YAAa,4BAA6B,EACpE,CAAE,KAAM,gBAAiB,YAAa,2BAA4B,CACpE,EACA,aAAc,CAAC,sDAAsD,EACrE,OAAQ;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,CACP,EC4DO,SAASC,GAA4C,CAC1D,GAAI,OAAO,OAAW,IAAa,OAAO,KAC1C,IAAMC,EAAM,OACZ,OAAOA,EAAI,YAAcA,EAAI,WAAa,IAC5C,CF3FO,IAAMC,EAAkBC,EAAgB,OAClCC,EAAoBD,EAMjC,eAAsBE,EAAkBC,EAA+C,CACrF,IAAMC,EAAKD,GAAaE,EAAe,EAEvC,GAAI,CAACD,EACH,MAAM,IAAI,MACR,yFACF,EAGF,IAAME,EAASF,EAAG,YAAYJ,EAAgB,OAAQ,CAAE,YAAa,EAAK,CAAC,EAE3E,GAAI,CAACM,EAAO,GACV,MAAM,IAAI,MAAM,yCAAyC,KAAK,UAAUA,EAAO,MAAM,CAAC,EAAE,EAG1F,IAAMC,EAAMH,EAAG,cAAgBA,EAAG,cAAc,EAAI,CAAE,OAAQ,IAAI,IAAO,QAAS,IAAI,GAAM,EAC5F,MAAMA,EAAG,QAAQE,EAAO,IAAKC,CAAG,CAClC,CAGIF,EAAe,GACjBH,EAAkB,EAAE,MAAM,QAAQ,KAAK,EAGzC,IAAOM,EAAQ,CACb,OAAQR,EAAgB,OACxB,SAAUA,EACV,SAAUE,CACZ","names":["draggable_exports","__export","draggable_default","draggableMetadata","draggableSource","registerDraggable","draggableSchema","resolveRuntime","win","draggableSource","draggableSchema","draggableMetadata","registerDraggable","hyperfixi","hf","resolveRuntime","result","ctx","draggable_default"]}

package/dist/focustrap.browser.global.js

@@ -1,4 +1,4 @@
-"use strict";var HyperFixiBehaviors=(()=>{var l=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var E=(t,e)=>{for(var r in e)l(t,r,{get:e[r],enumerable:!0})},x=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of y(e))!g.call(t,i)&&i!==r&&l(t,i,{get:()=>e[i],enumerable:!(n=h(e,i))||n.enumerable});return t};var F=t=>x(l({},"__esModule",{value:!0}),t);var M={};E(M,{default:()=>A,focusTrapMetadata:()=>L,focusTrapSource:()=>w,registerFocusTrap:()=>f});var s={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:!0,default:!0,description:"Whether the trap is active on install"},{name:"initialFocus",type:"selector",optional:!0,description:"Element to focus when the trap activates"},{name:"returnFocus",type:"boolean",optional:!0,default:!0,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:`
+"use strict";var HyperFixiBehaviors=(()=>{var a=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var d=(t,e)=>{for(var i in e)a(t,i,{get:e[i],enumerable:!0})},f=(t,e,i,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of l(e))!p.call(t,o)&&o!==i&&a(t,o,{get:()=>e[o],enumerable:!(n=u(e,o))||n.enumerable});return t};var m=t=>f(a({},"__esModule",{value:!0}),t);var g={};d(g,{default:()=>b,focusTrapMetadata:()=>h,focusTrapSource:()=>v,registerFocusTrap:()=>c});var r={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:!0,default:!0,description:"Whether the trap is active on install"},{name:"initialFocus",type:"selector",optional:!0,description:"Element to focus when the trap activates"},{name:"returnFocus",type:"boolean",optional:!0,default:!0,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
@@ -46,5 +46,5 @@ behavior FocusTrap(active, initialFocus, returnFocus)
       if (active) activate();
     end
   end
-end`.trim()};function d(){if(typeof window>"u")return null;let t=window;return t.lokascript||t.hyperfixi||null}var w=s.source,L=s,S=["a[href]","button:not(:disabled)","input:not(:disabled)","select:not(:disabled)","textarea:not(:disabled)",'[tabindex]:not([tabindex="-1"])'].join(", ");function k(t,e){return e?e instanceof HTMLElement?e:typeof e=="string"&&(t.querySelector(e)||document.querySelector(e))||null:null}function T(t,e){let r=e.returnFocus!==!1,n=!1,i=null;function p(){return Array.from(t.querySelectorAll(S))}function m(a){if(!n||a.key!=="Tab")return;let o=p();if(o.length===0){a.preventDefault();return}a.preventDefault();let c=o.indexOf(document.activeElement);if(a.shiftKey){let u=c<=0?o.length-1:c-1;o[u].focus()}else{let u=c>=o.length-1?0:c+1;o[u].focus()}}function v(){if(n)return;n=!0,i=document.activeElement,t.setAttribute("aria-modal","true");let a=k(t,e.initialFocus);if(a)a.focus();else{let o=p();o.length>0&&o[0].focus()}t.dispatchEvent(new CustomEvent("focustrap:activated",{bubbles:!0}))}function b(){n&&(n=!1,t.removeAttribute("aria-modal"),r&&i instanceof HTMLElement&&i.focus(),i=null,t.dispatchEvent(new CustomEvent("focustrap:deactivated",{bubbles:!0})))}t.addEventListener("keydown",m),t.addEventListener("focustrap:activate",()=>v()),t.addEventListener("focustrap:deactivate",()=>b()),e.active!==!1&&v()}async function f(t){let e=t||d();if(!e)throw new Error("LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.");let r={type:"behavior",name:"FocusTrap",parameters:["active","initialFocus","returnFocus"],eventHandlers:[],imperativeInstaller:T},n=e.createContext?e.createContext():{locals:new Map,globals:new Map};await e.execute(r,n)}d()&&f().catch(console.error);var A={source:s.source,metadata:s,register:f};return F(M);})();
+end`.trim()};function s(){if(typeof window>"u")return null;let t=window;return t.lokascript||t.hyperfixi||null}var v=r.source,h=r;async function c(t){let e=t||s();if(!e)throw new Error("LokaScript not found. Make sure @hyperfixi/core is loaded before registering behaviors.");let i=e.compileSync(r.source,{traditional:!0});if(!i.ok)throw new Error(`Failed to compile FocusTrap behavior: ${JSON.stringify(i.errors)}`);let n=e.createContext?e.createContext():{locals:new Map,globals:new Map};await e.execute(i.ast,n)}s()&&c().catch(console.error);var b={source:r.source,metadata:r,register:c};return m(g);})();
 //# sourceMappingURL=focustrap.browser.global.js.map

package/dist/focustrap.browser.global.js.map

@@ -1 +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\n      set active to true\n    end\n    if returnFocus is undefined\n      set returnFocus to true\n    end\n    js(me, active, initialFocus, returnFocus)\n      var FOCUSABLE = 'a[href],button:not(:disabled),input:not(:disabled),select:not(:disabled),textarea:not(:disabled),[tabindex]:not([tabindex=\"-1\"])';\n      var isActive = false;\n      var previouslyFocused = null;\n      function getFocusable() { return Array.from(me.querySelectorAll(FOCUSABLE)); }\n      function activate() {\n        if (isActive) return;\n        isActive = true;\n        previouslyFocused = document.activeElement;\n        me.setAttribute('aria-modal', 'true');\n        var initEl = initialFocus ? (typeof initialFocus === 'string' ? me.querySelector(initialFocus) : initialFocus) : null;\n        if (initEl) { initEl.focus(); } else { var f = getFocusable(); if (f.length) f[0].focus(); }\n        me.dispatchEvent(new CustomEvent('focustrap:activated', { bubbles: true }));\n      }\n      function deactivate() {\n        if (!isActive) return;\n        isActive = false;\n        me.removeAttribute('aria-modal');\n        if (returnFocus && previouslyFocused instanceof HTMLElement) previouslyFocused.focus();\n        previouslyFocused = null;\n        me.dispatchEvent(new CustomEvent('focustrap:deactivated', { bubbles: true }));\n      }\n      me.addEventListener('keydown', function(e) {\n        if (!isActive || e.key !== 'Tab') return;\n        var focusable = getFocusable();\n        if (focusable.length === 0) { e.preventDefault(); return; }\n        e.preventDefault();\n        var idx = focusable.indexOf(document.activeElement);\n        if (e.shiftKey) {\n          focusable[idx <= 0 ? focusable.length - 1 : idx - 1].focus();\n        } else {\n          focusable[idx >= focusable.length - 1 ? 0 : idx + 1].focus();\n        }\n      });\n      me.addEventListener('focustrap:activate', function() { activate(); });\n      me.addEventListener('focustrap:deactivate', function() { deactivate(); });\n      if (active) activate();\n    end\n  end\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":["focustrap_exports","__export","focustrap_default","focusTrapMetadata","focusTrapSource","registerFocusTrap","focusTrapSchema","resolveRuntime","win","focusTrapSource","focusTrapSchema","focusTrapMetadata","FOCUSABLE_SELECTOR","resolveElement","container","param","installFocusTrap","element","params","returnFocus","isActive","previouslyFocused","getFocusableElements","onKeyDown","e","focusable","currentIndex","prevIndex","nextIndex","activate","initialEl","deactivate","registerFocusTrap","hyperfixi","hf","resolveRuntime","syntheticNode","ctx","focustrap_default"]}
+{"version":3,"sources":["../src/behaviors/focustrap.ts","../src/schemas/focustrap.schema.ts","../src/schemas/types.ts"],"sourcesContent":["/**\n * FocusTrap Behavior\n *\n * Confines Tab navigation inside an element, manages aria-modal,\n * and restores focus on deactivation. The Tab-trapping / focus-model logic\n * lives in the schema's hyperscript `source` (an `init`-block `js()` body).\n *\n * Compiled from its hyperscript `source` — the single source of truth shared with\n * the CDN resolver bundle and patterns-reference. This collapses FocusTrap onto\n * the one runtime path (no more imperative-installer fork between CDN and npm);\n * see docs-internal/BEHAVIORS_CONSOLIDATION_PLAN.md §3d.\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\n/**\n * Register the FocusTrap behavior with LokaScript by compiling its\n * hyperscript source and executing the resulting behavior definition.\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 result = hf.compileSync(focusTrapSchema.source, { traditional: true });\n\n  if (!result.ok) {\n    throw new Error(`Failed to compile FocusTrap 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  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\n      set active to true\n    end\n    if returnFocus is undefined\n      set returnFocus to true\n    end\n    js(me, active, initialFocus, returnFocus)\n      var FOCUSABLE = 'a[href],button:not(:disabled),input:not(:disabled),select:not(:disabled),textarea:not(:disabled),[tabindex]:not([tabindex=\"-1\"])';\n      var isActive = false;\n      var previouslyFocused = null;\n      function getFocusable() { return Array.from(me.querySelectorAll(FOCUSABLE)); }\n      function activate() {\n        if (isActive) return;\n        isActive = true;\n        previouslyFocused = document.activeElement;\n        me.setAttribute('aria-modal', 'true');\n        var initEl = initialFocus ? (typeof initialFocus === 'string' ? me.querySelector(initialFocus) : initialFocus) : null;\n        if (initEl) { initEl.focus(); } else { var f = getFocusable(); if (f.length) f[0].focus(); }\n        me.dispatchEvent(new CustomEvent('focustrap:activated', { bubbles: true }));\n      }\n      function deactivate() {\n        if (!isActive) return;\n        isActive = false;\n        me.removeAttribute('aria-modal');\n        if (returnFocus && previouslyFocused instanceof HTMLElement) previouslyFocused.focus();\n        previouslyFocused = null;\n        me.dispatchEvent(new CustomEvent('focustrap:deactivated', { bubbles: true }));\n      }\n      me.addEventListener('keydown', function(e) {\n        if (!isActive || e.key !== 'Tab') return;\n        var focusable = getFocusable();\n        if (focusable.length === 0) { e.preventDefault(); return; }\n        e.preventDefault();\n        var idx = focusable.indexOf(document.activeElement);\n        if (e.shiftKey) {\n          focusable[idx <= 0 ? focusable.length - 1 : idx - 1].focus();\n        } else {\n          focusable[idx >= focusable.length - 1 ? 0 : idx + 1].focus();\n        }\n      });\n      me.addEventListener('focustrap:activate', function() { activate(); });\n      me.addEventListener('focustrap:deactivate', function() { deactivate(); });\n      if (active) activate();\n    end\n  end\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":"scAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,sBAAAC,EAAA,oBAAAC,EAAA,sBAAAC,ICQO,IAAMC,EAAkC,CAC7C,KAAM,YACN,SAAU,KACV,KAAM,OACN,QAAS,QACT,YAAa,8DACb,WAAY,CACV,CACE,KAAM,SACN,KAAM,UACN,SAAU,GACV,QAAS,GACT,YAAa,uCACf,EACA,CACE,KAAM,eACN,KAAM,WACN,SAAU,GACV,YAAa,0CACf,EACA,CACE,KAAM,cACN,KAAM,UACN,SAAU,GACV,QAAS,GACT,YAAa,iEACf,CACF,EACA,OAAQ,CACN,CAAE,KAAM,sBAAuB,YAAa,kCAAmC,EAC/E,CAAE,KAAM,wBAAyB,YAAa,oCAAqC,CACrF,EACA,aAAc,CACZ,oDACA,gGACF,EACA,OAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAgDL,KAAK,CACV,ECqBO,SAASC,GAA4C,CAC1D,GAAI,OAAO,OAAW,IAAa,OAAO,KAC1C,IAAMC,EAAM,OACZ,OAAOA,EAAI,YAAcA,EAAI,WAAa,IAC5C,CFpGO,IAAMC,EAAkBC,EAAgB,OAClCC,EAAoBD,EAMjC,eAAsBE,EAAkBC,EAA+C,CACrF,IAAMC,EAAKD,GAAaE,EAAe,EAEvC,GAAI,CAACD,EACH,MAAM,IAAI,MACR,yFACF,EAGF,IAAME,EAASF,EAAG,YAAYJ,EAAgB,OAAQ,CAAE,YAAa,EAAK,CAAC,EAE3E,GAAI,CAACM,EAAO,GACV,MAAM,IAAI,MAAM,yCAAyC,KAAK,UAAUA,EAAO,MAAM,CAAC,EAAE,EAG1F,IAAMC,EAAMH,EAAG,cAAgBA,EAAG,cAAc,EAAI,CAAE,OAAQ,IAAI,IAAO,QAAS,IAAI,GAAM,EAC5F,MAAMA,EAAG,QAAQE,EAAO,IAAKC,CAAG,CAClC,CAGIF,EAAe,GACjBH,EAAkB,EAAE,MAAM,QAAQ,KAAK,EAGzC,IAAOM,EAAQ,CACb,OAAQR,EAAgB,OACxB,SAAUA,EACV,SAAUE,CACZ","names":["focustrap_exports","__export","focustrap_default","focusTrapMetadata","focusTrapSource","registerFocusTrap","focusTrapSchema","resolveRuntime","win","focusTrapSource","focusTrapSchema","focusTrapMetadata","registerFocusTrap","hyperfixi","hf","resolveRuntime","result","ctx","focustrap_default"]}