@statedelta-actions/actions 0.1.0

package/README.md

@@ -0,0 +1,541 @@
+# @statedelta-actions/actions
+
+Motor de execução de diretivas com validação em register-time e compilação JIT.
+
+Defina ações como objetos JS declarativos. Registre. O engine valida estrutura, normaliza diretivas pra forma canônica, compila executores otimizados. Em runtime, invoke é O(1) lookup + execução — zero validação, zero análise.
+
+## Filosofia
+
+**Engine = V8. Runtime puro.**
+
+O engine é um executor. Não analisa dependências, não computa grafos, não valida contratos. Registro valida estrutura e compila. Invocação executa. Análise estática (grafo, capabilities, ciclos, composition control) é responsabilidade do `@statedelta-actions/analyzer` — uma camada externa opcional.
+
+Ações são **declarativas**. Uma action é um ID mais uma lista ordenada de diretivas — objetos JS declarativos despachados por um campo de tipo (`type` por padrão). O engine não sabe o que "state", "emit" ou "action" significam. Handlers dão significado às diretivas. O engine orquestra a execução.
+
+**Handlers têm fases.** Um handler não é só um executor. Ele pode validar estrutura da diretiva em register-time, contribuir código JIT, e executar em runtime. Cada fase é opcional — uma função simples funciona como handler (compat V1). Uma definição completa desbloqueia todo o pipeline. A fase `analyze` existe na interface mas é consumida pelo `ActionAnalyzer`, não pelo engine.
+
+## Instalação
+
+```bash
+pnpm add @statedelta-actions/actions
+```
+
+## Início Rápido
+
+```typescript
+import { createActionEngine } from "@statedelta-actions/actions";
+
+// 1. Defina handlers — dão significado aos tipos de diretiva
+const handlers = {
+  state: {
+    execute: (directive, frame) => {
+      const { target, value } = directive;
+      frame.ctx.state[target] = value;
+      return { ok: true, data: value };
+    },
+  },
+  emit: {
+    execute: (directive, frame) => {
+      frame.ctx.events.push(directive.event);
+      return { ok: true };
+    },
+  },
+  action: {
+    execute: (directive, frame, engine) => {
+      const result = engine.invoke(directive.id, directive.params, frame);
+      return { ok: result.success, data: result.data };
+    },
+  },
+};
+
+// 2. Crie o engine
+const engine = createActionEngine({ handlers });
+
+// 3. Registre ações
+const result = engine.register([
+  {
+    id: "heal",
+    directives: [
+      { type: "state", target: "hp", value: 100 },
+      { type: "emit", event: "healed" },
+    ],
+  },
+  {
+    id: "combat",
+    directives: [
+      { type: "action", id: "heal" },
+      { type: "emit", event: "combat:done" },
+    ],
+  },
+]);
+
+// result.registered → ["heal", "combat"]
+// result.errors     → []
+// result.warnings   → []
+
+// 4. Defina contexto e invoque
+engine.setContext({ state: {}, events: [] });
+
+const r = engine.invoke("heal");
+// r.success      → true
+// r.appliedCount → 2
+```
+
+## Handlers
+
+Um handler processa diretivas de um tipo específico. Dois formatos:
+
+### V1 — Função simples
+
+```typescript
+const handlers = {
+  log: (directive, frame, engine) => {
+    console.log(directive.message);
+    return { ok: true };
+  },
+};
+```
+
+Compatível com versões anteriores. Sem análise em register-time. Emite warning `NO_ANALYZE`.
+
+### V2 — Definição completa
+
+```typescript
+const handlers = {
+  state: {
+    // Register-time: valida estrutura da diretiva
+    validate(directive) {
+      if (!directive.target) return { valid: false, error: "missing target" };
+    },
+
+    // Runtime: executa a diretiva
+    execute(directive, frame, engine) {
+      frame.ctx.state[directive.target] = directive.value;
+      return { ok: true, data: directive.value };
+    },
+
+    // Usado pelo ActionAnalyzer (não pelo engine):
+    // analyze(directive) {
+    //   return { capabilities: ["write"], dependencies: [] };
+    // },
+  },
+};
+```
+
+| Fase | Quando | Propósito |
+|------|--------|-----------|
+| `validate` | Register | Validação estrutural (rejeita diretivas malformadas) |
+| `execute` | Runtime | Processa a diretiva e retorna resultado |
+| `analyze` | — | Consumido pelo `ActionAnalyzer` externo, não pelo engine |
+
+## Ações
+
+Uma ação é um ID mais diretivas:
+
+```typescript
+engine.register([{
+  id: "checkout",
+  directives: [
+    { type: "validate", schema: "cart" },
+    { type: "state", target: "status", value: "processing" },
+    { type: "action", id: "checkout/charge" },
+    { type: "emit", event: "checkout:complete" },
+  ],
+}]);
+```
+
+### Categorias de Diretiva
+
+Três categorias. Todas têm campo `type` na forma canônica. O consumer pode usar a forma sugar (shorthand) — o engine normaliza em register-time.
+
+**Binding** — escrita no scope de execução:
+
+```typescript
+// Sugar (authoring)
+{ const: "tax", value: 0.1 }
+{ let: "total", value: "$", resolve: (ctx, scope) => ({ value: scope.subtotal * 1.1 }) }
+
+// Forma canônica (após normalização no register)
+{ type: "const", name: "tax", value: 0.1 }
+{ type: "let", name: "total", value: "$", resolve: (ctx, scope) => ({ value: scope.subtotal * 1.1 }) }
+```
+
+**Control** — saída antecipada:
+
+```typescript
+// Sugar (authoring)
+{ return: "done" }
+{ throw: "saldo insuficiente" }
+
+// Forma canônica (após normalização no register)
+{ type: "return", value: "done" }                   // success: true, data: "done"
+{ type: "throw", message: "saldo insuficiente" }      // success: false
+```
+
+**Handler** — dispatch pro handler registrado:
+
+```typescript
+{ type: "state", target: "hp", value: 100, as: "prev" }
+{ type: "action", id: "heal", catch: [{ type: "emit", event: "heal:failed" }] }
+```
+
+Após normalização, **toda diretiva tem `type`**. O interpreter e JIT operam sobre formato uniforme — um único dispatch via `type` field, sem branching de categorias.
+
+Os nomes `const`, `let`, `return`, `throw` são **tipos reservados** — o engine rejeita handlers com esses nomes.
+
+Diretivas suportam:
+- **`as`** — captura `result.data` no scope: `scope["prev"] = result.data`
+- **`catch`** — em caso de falha, executa sub-diretivas com `scope.$exception`
+- **`halt`** — handler retorna `{ ok: true, halt: true }` para saída antecipada
+- **`resolve`** — campos dinâmicos mesclados antes da chamada: `resolve(ctx, scope) → campos mesclados`
+
+## Registro
+
+```typescript
+const result = engine.register(actions);
+```
+
+O pipeline de registro:
+
+1. **Validate** — valida estrutura via `handler.validate()` (rejeita diretivas malformadas)
+2. **Normalize** — converte sugar forms (`{ const: ... }`, `{ return: ... }`) pra forma canônica (`{ type: "const", ... }`)
+3. **Store** — armazena no registry com diretivas normalizadas
+4. **Compile** — compila executor (interpret/JIT) sobre formato canônico
+5. **Emit** — emite evento `register` via lifecycle events
+
+Retorna `RegisterResult`:
+
+```typescript
+{
+  registered: string[];        // IDs registrados com sucesso
+  errors: RegisterError[];     // Falhas de validação
+  warnings: RegisterWarning[]; // NO_ANALYZE, ANALYZE_ERROR
+}
+```
+
+### Desregistrar
+
+```typescript
+engine.unregister("checkout");
+// Também remove filhas: "checkout/charge", "checkout/validate", etc.
+```
+
+## Modo Batch
+
+Batch agrupa múltiplos registros e adia emissão de eventos pro `endBatch()`:
+
+```typescript
+engine.beginBatch();
+engine.register([actionA]);
+engine.register([actionB]);
+const result = engine.endBatch();  // Único evento "register" emitido
+```
+
+Suporta aninhamento — `endBatch()` interno é no-op. Processamento acontece na profundidade 0.
+
+## Invocação
+
+```typescript
+// Defina contexto primeiro
+engine.setContext(ctx);
+const result = engine.invoke("heal");
+const result = engine.invoke("heal", { amount: 50 });
+
+// Ou contexto com escopo
+engine.context(ctx, () => {
+  engine.invoke("heal");
+  engine.invoke("combat");
+});
+
+// Async (obrigatório se algum hook for async)
+const result = await engine.invokeAsync("heal");
+```
+
+Retorna `DirectiveResult`:
+
+```typescript
+{
+  success: boolean;
+  aborted: boolean;
+  abortedBy?: string;        // "halt" | "throw" | "maxDepth"
+  appliedCount: number;
+  skippedCount: number;
+  errors: DirectiveError[];
+  data?: unknown;             // De return directive ou halt
+  counters: FrameCounters;
+}
+```
+
+**Nunca lança exceções.** Erros são coletados em `result.errors`. Exceções de handlers são capturadas e reportadas.
+
+### Sub-Actions (Visibilidade)
+
+Ações com `/` no ID são privadas:
+
+```typescript
+engine.register([
+  { id: "checkout/validate", directives: [...] },  // privada
+  { id: "checkout", directives: [
+    { type: "action", id: "checkout/validate" },    // ok — escopo do pai
+  ]},
+]);
+
+engine.invoke("checkout/validate"); // erro — não acessível da raiz
+```
+
+## Lifecycle Events
+
+O engine emite eventos de ciclo de vida via `on()`. Retorna função de unsubscribe idempotente:
+
+```typescript
+const unsub = engine.on("register", (event) => {
+  console.log("Registrados:", event.registered);
+  console.log("Resultado:", event.result);
+});
+
+engine.on("unregister", (event) => {
+  console.log("Removido:", event.id);
+  console.log("Cascata:", event.cascaded);
+});
+
+// Cancelar subscription
+unsub();
+```
+
+| Evento | Payload | Quando |
+|--------|---------|--------|
+| `register` | `{ actions, result, registered }` | Após `register()` ou `endBatch()` |
+| `unregister` | `{ id, cascaded }` | Após `unregister()` |
+
+Em batch mode, o evento `register` é emitido uma única vez no `endBatch()` com todas as actions do batch.
+
+## Read-Only Accessors
+
+Acessores de leitura para introspection por camadas externas (e.g. analyzer):
+
+```typescript
+// Map de handler definitions V2 registradas
+engine.handlerDefinitions;  // ReadonlyMap<string, HandlerDefinition>
+
+// Set de IDs de todas as actions no registry
+engine.registeredIds;  // ReadonlySet<string>
+
+// Lê uma action definition pelo ID
+engine.getActionDefinition("heal");  // ActionDefinition | undefined
+
+// Campo de tipo pra dispatch de diretivas
+engine.typeField;  // string (default: "type")
+
+// Mapa de permissões de diretivas (computado no boot, imutável)
+engine.directivePermissions;  // ReadonlyMap<string, DirectivePermission>
+
+// Slots de hooks preenchidos (nomes dos hooks registrados)
+engine.directiveHookSlots;  // ReadonlySet<string>
+
+// Slots async (nomes dos hooks que são async)
+engine.asyncSlots;  // ReadonlySet<string>
+```
+
+## Modos de Compilação
+
+```typescript
+createActionEngine({ handlers, mode: "interpret" }); // Interpretador loop-based (dev)
+createActionEngine({ handlers, mode: "jit" });        // Compila tudo no register (prod)
+createActionEngine({ handlers, mode: "auto" });       // Interpreta primeiro, promove após N invocações (padrão)
+```
+
+| Modo | Register | Runtime | Ideal para |
+|------|----------|---------|------------|
+| `interpret` | Rápido | Loop interpretado | Desenvolvimento, debug |
+| `jit` | Mais lento (compila) | `new Function` compilado | Produção, ações estáveis |
+| `auto` | Rápido | Promove per-action após threshold | Uso geral (padrão) |
+
+Threshold de auto-promote (padrão: 8):
+
+```typescript
+createActionEngine({ handlers, mode: "auto", autoJitThreshold: 4 });
+```
+
+Forçar compilação de todas as ações registradas:
+
+```typescript
+engine.compile();
+```
+
+Informações de compilação:
+
+```typescript
+engine.isAsync;          // true se hooks async detectados
+engine.compilationMode;  // "interpret" | "jit" (modo atual, não o requestado)
+```
+
+## Hooks
+
+Três pontos de hook em nível de diretiva:
+
+```typescript
+createActionEngine({
+  handlers,
+  directiveHooks: {
+    beforeDirective(directive, frame) {
+      // Retorne "skip" pra pular, "abort" pra abortar
+      // Retorne { directive } pra substituir, { ctx } pra sobrescrever contexto
+    },
+    afterDirective(directive, result, frame) {
+      // Retorne "abort" pra parar execução
+    },
+    onDirectivesComplete(result) {
+      // Fire-and-forget — observa resultado final
+    },
+  },
+});
+```
+
+Hooks podem ser sync ou async. Hooks async tornam o engine async (`engine.isAsync === true`), exigindo `invokeAsync()`.
+
+**Custo zero quando ausente.** A compilação JIT não emite código de hook para hooks não registrados.
+
+## Handler Permissions
+
+Controle declarativo de quais diretivas uma instância do engine pode usar. Útil pra governança (sandbox parent→child) e arquitetura (query actions não devem mutar estado).
+
+```typescript
+// Whitelist: só estes tipos permitidos
+createActionEngine({
+  handlers,
+  allowedDirectives: ["state:query", "emit", "action"],
+});
+
+// Blacklist: estes tipos bloqueados
+createActionEngine({
+  handlers,
+  blockedDirectives: ["state:dispatch", "emit"],
+});
+
+// Blacklist com motivações
+createActionEngine({
+  handlers,
+  blockedDirectives: [
+    { pattern: "state:dispatch", reason: "sandbox read-only", source: "parent:root" },
+    { pattern: "emit", reason: "events disabled", source: "config" },
+  ],
+});
+```
+
+**Regras:**
+- `allowedDirectives` e `blockedDirectives` são **mutuamente exclusivos**. Se ambos fornecidos: erro no constructor.
+- Se nenhum fornecido: tudo permitido (default, zero overhead).
+- Diretivas estáticas (`const`, `let`, `return`, `throw`) são **sempre permitidas** — não podem ser bloqueadas.
+- Patterns com wildcard `*` são suportados: `"state:*"`, `"*:dispatch"`, `"*"`.
+
+**O engine não bloqueia execução.** Permissions são config, não enforcement. Actions com handler denied **registram e executam normalmente**. Quem valida violations é o `ActionAnalyzer`. Quem decide a política (rejeitar boot, warning, ignorar) é o consumer.
+
+```typescript
+// Consultar permissões
+const perms = engine.directivePermissions;
+
+perms.get("emit");
+// → { status: "available" }
+
+perms.get("state:dispatch");
+// → { status: "denied", reason: "sandbox read-only", source: "parent:root" }
+
+// Handler inexistente: não está no mapa (unavailable é derivado)
+perms.has("notify");
+// → false
+```
+
+## Referência de Configuração
+
+```typescript
+interface IActionEngineConfig<TCtx> {
+  handlers: HandlerInputMap<TCtx>;              // Obrigatório — handlers de diretivas
+  typeField?: string;                           // Campo de dispatch (padrão: "type")
+  directiveHooks?: DirectiveHooks<TCtx>;        // Hooks de diretiva
+  limits?: Partial<FrameLimits>;                // maxDepth (10), maxRules, maxDirectives
+  mode?: "interpret" | "jit" | "auto";          // Modo de compilação (padrão: "auto")
+  autoJitThreshold?: number;                    // Auto-promote após N invocações (padrão: 8)
+  allowedDirectives?: DirectivePermissionEntry[];  // Whitelist com pattern matching
+  blockedDirectives?: DirectivePermissionEntry[];  // Blacklist com pattern matching
+}
+```
+
+## Exports
+
+```typescript
+// Factory
+import { createActionEngine } from "@statedelta-actions/actions";
+
+// Tipos (V1)
+import type {
+  DirectiveHandler,
+  DirectiveHandlerMap,
+  DirectiveHooks,
+  DirectiveExecutorFn,
+  DirectiveRunnerFn,
+} from "@statedelta-actions/actions";
+
+// Tipos (V2)
+import type {
+  HandlerDefinition,
+  HandlerAnalysis,
+  ValidationResult,
+  HandlerInput,
+  HandlerInputMap,
+  ActionDefinition,
+  RegisterResult,
+  RegisterError,
+  RegisterWarning,
+  IActionEngineConfig,
+  IActionEngine,
+} from "@statedelta-actions/actions";
+
+// Lifecycle Events
+import type {
+  RegisterEvent,
+  UnregisterEvent,
+  EngineEventMap,
+  EngineEventName,
+} from "@statedelta-actions/actions";
+
+// Directive Permissions
+import type {
+  DirectivePermissionStatus,
+  DirectivePermission,
+  DirectivePermissionConfig,
+  DirectivePermissionEntry,
+} from "@statedelta-actions/actions";
+
+// Register Pipeline
+import { normalizeDirectives, RESERVED_TYPES } from "@statedelta-actions/actions";
+
+// Emitter
+import { SimpleEmitter } from "@statedelta-actions/actions";
+import type { Listener } from "@statedelta-actions/actions";
+
+// Interpreter
+import { createDirectiveInterpreter } from "@statedelta-actions/actions";
+
+// JIT (generic)
+import { buildDirectiveExecutor } from "@statedelta-actions/actions";
+import type { GeneratedDirectiveExecutor } from "@statedelta-actions/actions";
+
+// JIT (per-action)
+import { buildActionExecutor } from "@statedelta-actions/actions";
+import type { GeneratedActionExecutor } from "@statedelta-actions/actions";
+```
+
+## Analyzer
+
+Funcionalidades de análise estática foram extraídas para o pacote `@statedelta-actions/analyzer`:
+
+- **Grafo de dependências** — capabilities, leaf, maxDepth, ciclos
+- **Declarations** — trust boundaries, conflitos de contrato
+- **Propagators** — propriedades computadas e propagadas pelo grafo
+- **Composition Control** — manifest declarativo, tags, matchers, transitividade
+
+O analyzer consome os read-only accessors e lifecycle events do engine. Consulte a documentação do `@statedelta-actions/analyzer` para detalhes.
+
+## Licença
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,9 @@
+'use strict';var core=require('@statedelta-actions/core');var F=class{_listeners=new Map;on(e,i){let n=this._listeners.get(e);n||(n=new Set,this._listeners.set(e,n)),n.add(i);let s=false;return ()=>{s||(s=true,n.delete(i),n.size===0&&this._listeners.delete(e));}}once(e,i){let n=this.on(e,s=>{n(),i(s);});return n}emit(e,i){let n=this._listeners.get(e);if(!n||n.size===0)return;let s=[...n];for(let r=0;r<s.length;r++)try{s[r](i);}catch(c){console.error(`[SimpleEmitter] Listener error on "${e}":`,c);}}listenerCount(e){return this._listeners.get(e)?.size??0}hasListeners(e){let i=this._listeners.get(e);return i!==void 0&&i.size>0}off(e){this._listeners.delete(e);}removeAllListeners(){this._listeners.clear();}};var S=new Set(["const","let","return","throw"]);function W(t,e,i,n){let s=[];for(let r=0;r<t.directives.length;r++){let c=t.directives[r];if("const"in c||"let"in c||"return"in c||"throw"in c)continue;let h=c[n];if(!h){s.push(`directive[${r}]: missing type field "${n}"`);continue}if(!e[h]){s.push(`directive[${r}]: no handler for type "${h}"`);continue}let x=i.get(h);if(x?.validate)try{let D=x.validate(c);D&&!D.valid&&s.push(`directive[${r}]: ${D.error??"validation failed"}`);}catch(D){s.push(`directive[${r}]: validate threw: ${D}`);}let m=c.catch;if(m&&Array.isArray(m))for(let D=0;D<m.length;D++){let R=m[D];if("const"in R||"let"in R||"return"in R||"throw"in R)continue;let v=R[n];v&&!e[v]&&s.push(`directive[${r}].catch[${D}]: no handler for type "${v}"`);}}return s}function H(t,e){let i=t.length,n=new Array(i);for(let s=0;s<i;s++){let r=t[s];if("const"in r)n[s]=q(r,"const");else if("let"in r)n[s]=q(r,"let");else if("return"in r)n[s]=te(r);else if("throw"in r)n[s]=re(r);else {let c=r.catch;Array.isArray(c)&&c.length>0?n[s]={...r,catch:H(c)}:n[s]=r;}}return n}function q(t,e){let{[e]:i,...n}=t;return {...n,type:e,name:i}}function te(t){let{return:e,...i}=t;return {...i,type:"return",value:e}}function re(t){let{throw:e,...i}=t;return {...i,type:"throw",message:e}}function M(t,e,i,n,s,r,c){return {success:false,aborted:true,abortedBy:t,appliedCount:e,skippedCount:i,errors:n,processedCount:s,totalCount:r,counters:c}}function ie(t){let e=t.filledNames.has("beforeDirective"),i=t.filledNames.has("afterDirective"),n=t.filledNames.has("onDirectivesComplete");return function(r,c,h,x,m,D,R){let v=Math.min(r.length,R),l=[],f=0,_=0,{counters:u,scope:C}=c,A=c.ctx;for(let a=0;a<v;a++){let p=r[a],$=p[m];if($==="const"||$==="let"){let o=p.name;if(typeof p.resolve=="function")try{C[o]=p.resolve(A,C).value;}catch(d){l.push({directiveIndex:a,error:`Binding resolve: ${d}`}),u.errors++;}else C[o]=p.value;continue}if($==="return"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="value"in d?d.value:"return"in d?d.return:p.value;return {success:!0,aborted:!1,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.value};continue}if($==="throw"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="message"in d?d.message:"throw"in d?d.throw:p.message;return {success:!1,aborted:!0,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:false,aborted:true,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.message};continue}let y=p,E=c;if(e)try{let o=core.processIntercept(x.beforeDirective(y,c),"beforeDirective");if(o.action===core.Intercept.SKIP){_++,u.directivesSkipped++;continue}if(o.action===core.Intercept.ABORT)return M(o.abortReason,f,_,l,a,v,u);o.ctx!==void 0&&(E=c.withCtx(o.ctx)),o.directive!==void 0&&(y=o.directive);}catch(o){l.push({directiveIndex:a,error:`Hook beforeDirective: ${o}`}),u.errors++;}if(typeof y.resolve=="function")try{let o=y.resolve(E.ctx,E.scope);y={...y,...o};}catch(o){l.push({directiveIndex:a,error:`Directive resolve: ${o}`}),u.errors++;continue}let w=y[m],I=w?h[w]:void 0;if(!I){l.push({directiveIndex:a,error:`No handler for directive type: ${w??"undefined"}`}),u.errors++;continue}let g;try{g=I(y,E,D);}catch(o){g={ok:false,error:String(o)};}let T=a+1;if(g.ok){if(f++,u.directivesApplied++,typeof y.as=="string"&&(C[y.as]=g.data),g.halt)return {success:true,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data}}else {if(g.halt)return {success:false,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data};let o=y.catch;if(Array.isArray(o)&&o.length>0){C.$exception=g.error??"handler failed";let d=D.runDirectives(o,E);f+=d.appliedCount;for(let b=0;b<d.errors.length;b++)l.push(d.errors[b]);if(d.aborted)return {success:d.success,aborted:true,abortedBy:d.abortedBy,appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:d.data}}else l.push({directiveIndex:a,error:g.error??"handler failed"}),u.errors++;}if(i)try{if(x.afterDirective(y,g,E)==="abort")return M("afterDirective",f,_,l,T,v,u)}catch(o){l.push({directiveIndex:a,error:`Hook afterDirective: ${o}`}),u.errors++;}}let k={success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:v,totalCount:v,counters:u};if(n)try{x.onDirectivesComplete(k);}catch{}return k}}function ne(t){let e=t.filledNames.has("beforeDirective"),i=t.filledNames.has("afterDirective"),n=t.filledNames.has("onDirectivesComplete");return async function(r,c,h,x,m,D,R){let v=Math.min(r.length,R),l=[],f=0,_=0,{counters:u,scope:C}=c,A=c.ctx;for(let a=0;a<v;a++){let p=r[a],$=p[m];if($==="const"||$==="let"){let o=p.name;if(typeof p.resolve=="function")try{C[o]=p.resolve(A,C).value;}catch(d){l.push({directiveIndex:a,error:`Binding resolve: ${d}`}),u.errors++;}else C[o]=p.value;continue}if($==="return"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="value"in d?d.value:"return"in d?d.return:p.value;return {success:!0,aborted:!1,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.value};continue}if($==="throw"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="message"in d?d.message:"throw"in d?d.throw:p.message;return {success:!1,aborted:!0,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:false,aborted:true,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.message};continue}let y=p,E=c;if(e)try{let o=core.processIntercept(await x.beforeDirective(y,c),"beforeDirective");if(o.action===core.Intercept.SKIP){_++,u.directivesSkipped++;continue}if(o.action===core.Intercept.ABORT)return M(o.abortReason,f,_,l,a,v,u);o.ctx!==void 0&&(E=c.withCtx(o.ctx)),o.directive!==void 0&&(y=o.directive);}catch(o){l.push({directiveIndex:a,error:`Hook beforeDirective: ${o}`}),u.errors++;}if(typeof y.resolve=="function")try{let o=y.resolve(E.ctx,E.scope);y={...y,...o};}catch(o){l.push({directiveIndex:a,error:`Directive resolve: ${o}`}),u.errors++;continue}let w=y[m],I=w?h[w]:void 0;if(!I){l.push({directiveIndex:a,error:`No handler for directive type: ${w??"undefined"}`}),u.errors++;continue}let g;try{g=I(y,E,D);}catch(o){g={ok:false,error:String(o)};}let T=a+1;if(g.ok){if(f++,u.directivesApplied++,typeof y.as=="string"&&(C[y.as]=g.data),g.halt)return {success:true,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data}}else {if(g.halt)return {success:false,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data};let o=y.catch;if(Array.isArray(o)&&o.length>0){C.$exception=g.error??"handler failed";let d=await D.runDirectivesAsync(o,E);f+=d.appliedCount;for(let b=0;b<d.errors.length;b++)l.push(d.errors[b]);if(d.aborted)return {success:d.success,aborted:true,abortedBy:d.abortedBy,appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:d.data}}else l.push({directiveIndex:a,error:g.error??"handler failed"}),u.errors++;}if(i)try{if(await x.afterDirective(y,g,E)==="abort")return M("afterDirective",f,_,l,T,v,u)}catch(o){l.push({directiveIndex:a,error:`Hook afterDirective: ${o}`}),u.errors++;}}let k={success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:v,totalCount:v,counters:u};if(n)try{await x.onDirectivesComplete(k);}catch{}return k}}function B(t,e){return e?ne(t):ie(t)}function j(t){let{filledNames:e,hasAnyAsync:i}=t,n=m=>e.has(m),s=m=>t.asyncNames.has(m)?"await ":"",r=[];for(let m of e)r.push(`const ${m} = directiveHooks.${m};`);r.push("const len = Math.min(directives.length, maxDirectives);"),r.push("const errors = []; let appliedCount = 0; let skippedCount = 0;"),r.push("const counters = frame.counters;"),r.push("for (let i = 0; i < len; i++) {"),r.push("  let directive = directives[i];"),n("beforeDirective")?(r.push("  let _df = frame;"),r.push("  try {"),r.push(`    const _bd = ${s("beforeDirective")}beforeDirective(directive, frame);`),r.push('    if (_bd === "skip") { skippedCount++; counters.directivesSkipped++; continue; }'),r.push('    if (_bd === "abort") return { success: false, aborted: true, abortedBy: "beforeDirective", appliedCount, skippedCount, errors, processedCount: i, totalCount: len, counters };'),r.push('    if (typeof _bd === "object" && _bd !== null) {'),r.push('      if ("abort" in _bd) return { success: false, aborted: true, abortedBy: _bd.abort, appliedCount, skippedCount, errors, processedCount: i, totalCount: len, counters };'),r.push('      if ("ctx" in _bd) _df = frame.withCtx(_bd.ctx);'),r.push('      if ("directive" in _bd) directive = _bd.directive;'),r.push("    }"),r.push('  } catch (_e) { errors.push({ directiveIndex: i, error: "Hook beforeDirective: " + _e }); counters.errors++; }')):r.push("  const _df = frame;"),r.push('  if (typeof directive.resolve === "function") {'),r.push("    try { const _r = directive.resolve(_df.ctx); directive = Object.assign({}, directive, _r); }"),r.push('    catch (_e) { errors.push({ directiveIndex: i, error: "Directive resolve: " + _e }); counters.errors++; continue; }'),r.push("  }"),r.push("  const _type = directive[typeField];"),r.push("  const _handler = _type ? handlers[_type] : undefined;"),r.push('  if (!_handler) { errors.push({ directiveIndex: i, error: "No handler for directive type: " + (_type || "undefined") }); counters.errors++; continue; }'),r.push("  let _result;"),r.push("  try { _result = _handler(directive, _df, engine); } catch (_e) { errors.push({ directiveIndex: i, error: String(_e) }); counters.errors++; continue; }"),r.push("  if (_result.ok) { appliedCount++; counters.directivesApplied++; }"),r.push('  else { errors.push({ directiveIndex: i, error: _result.error || "handler failed" }); counters.errors++; }'),n("afterDirective")&&(r.push("  try {"),r.push(`    const _ad = ${s("afterDirective")}afterDirective(directive, _result, _df);`),r.push('    if (_ad === "abort") return { success: false, aborted: true, abortedBy: "afterDirective", appliedCount, skippedCount, errors, processedCount: i + 1, totalCount: len, counters };'),r.push('  } catch (_e) { errors.push({ directiveIndex: i, error: "Hook afterDirective: " + _e }); counters.errors++; }')),r.push("}"),r.push("const _finalResult = { success: true, aborted: false, appliedCount, skippedCount, errors, processedCount: len, totalCount: len, counters };"),n("onDirectivesComplete")&&r.push(`try { ${s("onDirectivesComplete")}onDirectivesComplete(_finalResult); } catch (_e) {}`),r.push("return _finalResult;");let c=r.join(`
+`),h=i?"async ":"";return {fn:new Function("directives","frame","handlers","directiveHooks","typeField","engine","maxDirectives",`"use strict";
+return (${h}() => {
+${c}
+})();`),isAsync:i}}function N(t,e,i){return `return{success:false,aborted:true,abortedBy:${t},appliedCount,skippedCount,errors,processedCount:${e},totalCount:${i},counters};`}function se(t,e){return `return{success:true,aborted:true,abortedBy:"halt",appliedCount,skippedCount,errors,processedCount:${t},totalCount:${e},counters,data:_result.data};`}function oe(t,e){return `return{success:false,aborted:true,abortedBy:"halt",appliedCount,skippedCount,errors,processedCount:${t},totalCount:${e},counters,data:_result.data};`}function ce(t,e,i){let n=JSON.stringify(e.name);typeof e.resolve=="function"?(t.push("try{"),t.push(`scope[${n}]=$.d[${i}].resolve(ctx,scope).value;`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Binding resolve: "+_e});counters.errors++;}`)):t.push(`scope[${n}]=$.d[${i}].value;`);}function ae(t,e,i,n){let s=typeof e.resolve=="function",r=i+1;s?(t.push("try{"),t.push(`const _rv=$.d[${i}].resolve(ctx,scope);`),t.push(`return{success:true,aborted:false,appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:"value" in _rv?_rv.value:"return" in _rv?_rv.return:$.d[${i}].value};`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Control resolve: "+_e});counters.errors++;}`)):t.push(`return{success:true,aborted:false,appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:$.d[${i}].value};`);}function ue(t,e,i,n){let s=typeof e.resolve=="function",r=i+1;s?(t.push("try{"),t.push(`const _rv=$.d[${i}].resolve(ctx,scope);`),t.push(`return{success:false,aborted:true,abortedBy:"throw",appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:"message" in _rv?_rv.message:"throw" in _rv?_rv.throw:$.d[${i}].message};`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Control resolve: "+_e});counters.errors++;}`)):t.push(`return{success:false,aborted:true,abortedBy:"throw",appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:$.d[${i}].message};`);}function de(t,e,i,n,s,r,c,h,x,m){let D=e[s],R=r.get(D),v=typeof e.resolve=="function",l=typeof e.as=="string",f=Array.isArray(e.catch)&&e.catch.length>0,_=l?JSON.stringify(e.as):"",u=i+1;t.push(`_b${i}:{`);let C=c||v,A=c;C&&t.push(`let _dir=$.d[${i}];`),A&&t.push("let _df=frame;"),c&&(t.push("try{"),t.push(`const _bd=${x}_hookBefore($.d[${i}],frame);`),t.push(`if(_bd==="skip"){skippedCount++;counters.directivesSkipped++;break _b${i};}`),t.push(`if(_bd==="abort")${N('"beforeDirective"',i,n)}`),t.push('if(typeof _bd==="object"&&_bd!==null){'),t.push(`if("abort" in _bd)${N("_bd.abort",i,n)}`),t.push('if("ctx" in _bd)_df=frame.withCtx(_bd.ctx);'),t.push('if("directive" in _bd)_dir=_bd.directive;'),t.push("}"),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Hook beforeDirective: "+_e});counters.errors++;}`)),c?(t.push('if(typeof _dir.resolve==="function"){'),t.push("try{const _r=_dir.resolve(_df.ctx,scope);_dir=Object.assign({},_dir,_r);}"),t.push(`catch(_e){errors.push({directiveIndex:${i},error:"Directive resolve: "+_e});counters.errors++;break _b${i};}}`)):v&&(t.push(`try{const _r=$.d[${i}].resolve(ctx,scope);_dir=Object.assign({},$.d[${i}],_r);}`),t.push(`catch(_e){errors.push({directiveIndex:${i},error:"Directive resolve: "+_e});counters.errors++;break _b${i};}`));let k=C?"_dir":`$.d[${i}]`,a=A?"_df":"frame";t.push("let _result;"),t.push(`try{_result=${R}(${k},${a},$.engine);}`),t.push("catch(_e){_result={ok:false,error:String(_e)};}"),t.push("if(_result.ok){"),t.push("appliedCount++;counters.directivesApplied++;"),l&&t.push(`scope[${_}]=_result.data;`),t.push(`if(_result.halt)${se(u,n)}`),t.push("}else{"),t.push(`if(_result.halt)${oe(u,n)}`),f?(t.push('scope.$exception=_result.error||"handler failed";'),t.push(`const _cr=$.runner($.d[${i}].catch,${a});`),t.push("appliedCount+=_cr.appliedCount;"),t.push("for(let _j=0;_j<_cr.errors.length;_j++)errors.push(_cr.errors[_j]);"),t.push(`if(_cr.aborted)return{success:_cr.success,aborted:true,abortedBy:_cr.abortedBy,appliedCount,skippedCount,errors,processedCount:${u},totalCount:${n},counters,data:_cr.data};`)):t.push(`errors.push({directiveIndex:${i},error:_result.error||"handler failed"});counters.errors++;`),t.push("}"),h&&(t.push("try{"),t.push(`const _ad=${m}_hookAfter(${k},_result,${a});`),t.push(`if(_ad==="abort")${N('"afterDirective"',u,n)}`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Hook afterDirective: "+_e});counters.errors++;}`)),t.push("}");}function O(t,e,i){let n=[],s=t.length,{filledNames:r,hasAnyAsync:c,asyncNames:h}=e,x=r.has("beforeDirective"),m=r.has("afterDirective"),D=r.has("onDirectivesComplete"),R=h.has("beforeDirective")?"await ":"",v=h.has("afterDirective")?"await ":"",l=h.has("onDirectivesComplete")?"await ":"",f=new Set;for(let a of t){let p=a[i];p&&!S.has(p)&&f.add(p);}let _=new Map,u=0;for(let a of f)_.set(a,`_h${u++}`);n.push("const counters=frame.counters;"),n.push("const ctx=frame.ctx;"),n.push("const errors=[];"),n.push("let appliedCount=0;"),n.push("let skippedCount=0;");for(let[a,p]of _)n.push(`const ${p}=$.h[${JSON.stringify(a)}];`);x&&n.push("const _hookBefore=$.hooks.beforeDirective;"),m&&n.push("const _hookAfter=$.hooks.afterDirective;");for(let a=0;a<t.length;a++){let p=t[a];switch(p[i]){case "const":case "let":ce(n,p,a);break;case "return":ae(n,p,a,s);break;case "throw":ue(n,p,a,s);break;default:de(n,p,a,s,i,_,x,m,R,v);break}}n.push(`const _finalResult={success:true,aborted:false,appliedCount,skippedCount,errors,processedCount:${s},totalCount:${s},counters};`),D&&n.push(`try{${l}$.hooks.onDirectivesComplete(_finalResult);}catch(_e){}`),n.push("return _finalResult;");let C=n.join(`
+`),A=c?"async ":"";return {fn:new Function("frame","scope","$",`"use strict";
+return(${A}()=>{
+${C}
+})();`),isAsync:c}}function K(t,e,i){return {success:false,aborted:false,appliedCount:0,skippedCount:0,processedCount:0,totalCount:0,errors:[{directiveIndex:-1,error:e}],counters:t,...i}}function U(t,e){return K(e,`Action not found: "${t}"`)}function G(t,e,i){return K(i,`Max depth ${e} exceeded invoking "${t}"`,{aborted:true,abortedBy:"maxDepth"})}function Y(t,e){return K(e,`Action "${t}" is private (sub-action). Can only be invoked from within its parent scope.`)}function le(t){return typeof t=="object"&&t!==null&&"execute"in t}function Q(t){let e=Object.create(null),i=new Map;for(let n of Object.keys(t)){let s=t[n];le(s)?(e[n]=s.execute,i.set(n,s)):(e[n]=s,i.set(n,{execute:s}));}return {handlers:e,definitions:i}}function X(t,e){if(t==="*")return  true;if(!t.includes("*"))return t===e;let i=t.replace(/[.+^${}()|[\]\\]/g,"\\$&");return new RegExp("^"+i.replace(/\*/g,".*")+"$").test(e)}function Z(t){return typeof t=="string"?{pattern:t}:t}function L(t,e,i){let n=new Map;if(!e&&!i){for(let s of t)n.set(s,{status:"available"});return n}if(e){let s=e.map(Z);for(let r of t){let c=s.some(h=>X(h.pattern,r));n.set(r,{status:c?"available":"denied"});}}else {let s=i.map(Z);for(let r of t){let c=s.find(h=>X(h.pattern,r));c?n.set(r,{status:"denied",reason:c.reason,source:c.source}):n.set(r,{status:"available"});}}return n}var ve=8,fe="type",z={maxDepth:10,maxRules:1e4,maxDirectives:1e5},V=class{_directiveExecutor;_mode;_ctx;_requestedMode;_threshold;_limits;_typeField;_handlers;_definitions;_directiveHooks;_directiveAnalysis;_isAsync;_directivePermissions;_registry=new Map;_emitter=new F;_batchDepth=0;_batchErrors=[];_batchWarnings=[];_batchActions=[];_batchRegistered=[];_registeredIds=new Set;_directiveRunner;_engineRef;constructor(e){this._requestedMode=e.mode??"auto",this._threshold=e.autoJitThreshold??ve,this._typeField=e.typeField??fe,this._limits={maxDepth:e.limits?.maxDepth??z.maxDepth,maxRules:e.limits?.maxRules??z.maxRules,maxDirectives:e.limits?.maxDirectives??z.maxDirectives};let{handlers:i,definitions:n}=Q(e.handlers);for(let s of Object.keys(e.handlers))if(S.has(s))throw new Error(`Handler type "${s}" is reserved for engine-internal directives`);if(e.allowedDirectives&&e.blockedDirectives)throw new Error("allowedDirectives and blockedDirectives are mutually exclusive. Provide one or neither.");this._handlers=i,this._definitions=n,this._directivePermissions=L(Object.keys(i),e.allowedDirectives,e.blockedDirectives),this._directiveHooks=e.directiveHooks??{},this._directiveAnalysis=core.analyzeSlots(this._directiveHooks,core.DIRECTIVE_SLOT_NAMES),this._isAsync=this._directiveAnalysis.hasAnyAsync,this._engineRef={runDirectives:(s,r)=>this._executeDirectives(s,r),runDirectivesAsync:(s,r)=>this._executeDirectivesAsync(s,r),invoke:(s,r,c)=>this._invokeInternal(s,r,c),invokeAsync:(s,r,c)=>this._invokeInternalAsync(s,r,c),evaluateRules:()=>{throw new Error("evaluateRules() not available in ActionEngine context. Use createRuleEngine().")},evaluateRulesAsync:()=>{throw new Error("evaluateRulesAsync() not available in ActionEngine context. Use createRuleEngine().")}},this._directiveRunner=(s,r)=>this._directiveExecutor(s,r,this._handlers,this._directiveHooks,this._typeField,this._engineRef,this._limits.maxDirectives),this._requestedMode==="jit"?(this._directiveExecutor=this._buildJitDirectiveExecutor(),this._mode="jit"):(this._directiveExecutor=B(this._directiveAnalysis,this._isAsync),this._mode="interpret");}register(e){let i=[],n=[],s=[],r=[];for(let h of e){if(!h.id){n.push({actionId:"",error:"Action must have an id"});continue}let x=W(h,this._handlers,this._definitions,this._typeField);if(x.length>0){for(let m of x)n.push({actionId:h.id,error:m});continue}r.push(h);}for(let h of r){let x=H(h.directives,this._typeField),m={definition:h,directives:x,compiled:null,invokeCount:0};this._requestedMode==="jit"&&(m.compiled=this._compileAction(x)),this._registry.set(h.id,m),this._registeredIds.add(h.id),i.push(h.id);}if(this._batchDepth>0){this._batchErrors.push(...n),this._batchWarnings.push(...s);for(let h of r)this._batchActions.push(h);return this._batchRegistered.push(...i),{registered:i,errors:n,warnings:s}}let c={registered:i,errors:n,warnings:s};return i.length>0&&this._emitter.emit("register",{actions:r,result:c,registered:i}),c}unregister(e){let i=this._registry.delete(e);i&&this._registeredIds.delete(e);let n=e+"/",s=[];for(let r of this._registry.keys())r.startsWith(n)&&(this._registry.delete(r),this._registeredIds.delete(r),s.push(r));return i&&this._emitter.emit("unregister",{id:e,cascaded:s}),i}invoke(e,i){if(this._isAsync)throw new Error("Cannot call invoke() with async hooks. Use invokeAsync() instead.");let n=this._requireCtx(),s=core.createRootFrame(n,this._limits);return this._invokeInternal(e,i,s)}async invokeAsync(e,i){let n=this._requireCtx(),s=core.createRootFrame(n,this._limits);return this._invokeInternalAsync(e,i,s)}setContext(e){this._ctx=e;}context(e,i){let n=this._ctx;this._ctx=e;try{return i()}finally{this._ctx=n;}}beginBatch(){this._batchDepth++,this._batchDepth===1&&(this._batchErrors=[],this._batchWarnings=[],this._batchActions=[],this._batchRegistered=[]);}endBatch(){if(this._batchDepth<=0)throw new Error("endBatch() called without matching beginBatch()");if(this._batchDepth--,this._batchDepth>0)return {registered:[],errors:[],warnings:[]};let e={registered:this._batchRegistered,errors:this._batchErrors,warnings:this._batchWarnings};return this._batchRegistered.length>0&&this._emitter.emit("register",{actions:this._batchActions,result:e,registered:this._batchRegistered}),e}on(e,i){return this._emitter.on(e,i)}get handlerDefinitions(){return this._definitions}get registeredIds(){return this._registeredIds}getActionDefinition(e){return this._registry.get(e)?.definition}get typeField(){return this._typeField}get directivePermissions(){return this._directivePermissions}get isAsync(){return this._isAsync}get compilationMode(){return this._mode}get directiveHookSlots(){return this._directiveAnalysis.filledNames}get asyncSlots(){return this._directiveAnalysis.asyncNames}compile(){if(this._requestedMode!=="interpret"){this._mode!=="jit"&&this._promote();for(let e of this._registry.values())e.compiled||(e.compiled=this._compileAction(e.directives));}}_invokeInternal(e,i,n){let s=this._prepareInvoke(e,i,n);if("success"in s)return s;let{stored:r,childFrame:c,childScope:h}=s;if(r.compiled)return r.compiled.fn(c,h,r.compiled.$);let x=this._directiveRunner(r.directives,c);return this._maybeAutoPromote(r),x}async _invokeInternalAsync(e,i,n){let s=this._prepareInvoke(e,i,n);if("success"in s)return s;let{stored:r,childFrame:c,childScope:h}=s;if(r.compiled)return r.compiled.fn(c,h,r.compiled.$);let x=this._directiveRunner(r.directives,c);return this._maybeAutoPromote(r),x}_prepareInvoke(e,i,n){let s=this._registry.get(e);if(!s)return U(e,n.counters);if(e.includes("/")&&!this._isAccessible(e,n))return Y(e,n.counters);if(n.depth>=n.limits.maxDepth)return G(e,n.limits.maxDepth,n.counters);let r=Object.create(n.scope);i&&Object.assign(r,i);let c=n.child("action:"+e,0,e).withScope(r);return {stored:s,childFrame:c,childScope:r}}_maybeAutoPromote(e){this._requestedMode==="auto"&&++e.invokeCount>=this._threshold&&(e.compiled=this._compileAction(e.directives),this._mode!=="jit"&&this._promote());}_executeDirectives(e,i){return this._directiveExecutor(e,i,this._handlers,this._directiveHooks,this._typeField,this._engineRef,this._limits.maxDirectives)}async _executeDirectivesAsync(e,i){return this._directiveExecutor(e,i,this._handlers,this._directiveHooks,this._typeField,this._engineRef,this._limits.maxDirectives)}_compileAction(e){let{fn:i}=O(e,this._directiveAnalysis,this._typeField),n={d:e,h:this._handlers,hooks:this._directiveHooks,engine:this._engineRef,runner:this._directiveRunner};return {fn:i,$:n}}_isAccessible(e,i){let s="action:"+e.slice(0,e.lastIndexOf("/"));return i.path.includes(s)}_requireCtx(){if(this._ctx===void 0)throw new Error("No context set. Call setContext(ctx) or use context(ctx, fn) before invoke.");return this._ctx}_promote(){this._directiveExecutor=this._buildJitDirectiveExecutor(),this._mode="jit";}_buildJitDirectiveExecutor(){let{fn:e}=j(this._directiveAnalysis);return e}};function _e(t){return new V(t)}exports.RESERVED_TYPES=S;exports.SimpleEmitter=F;exports.buildActionExecutor=O;exports.buildDirectiveExecutor=j;exports.createActionEngine=_e;exports.createDirectiveInterpreter=B;exports.normalizeDirectives=H;

package/dist/index.d.cts

@@ -0,0 +1,277 @@
+import { Directive, ExecutionFrame, RuleEngineRef, ApplyResult, HookFn, InterceptResult, AbortDecision, DirectiveResult, ActionEngineRef, FrameLimits, SlotAnalysis } from '@statedelta-actions/core';
+
+type DirectiveHandler<TCtx> = (directive: Directive, frame: ExecutionFrame<TCtx>, engine: RuleEngineRef<TCtx>) => ApplyResult;
+type DirectiveHandlerMap<TCtx> = Record<string, DirectiveHandler<TCtx>>;
+interface DirectiveHooks<TCtx> {
+    beforeDirective?: HookFn<[
+        directive: Directive,
+        frame: ExecutionFrame<TCtx>
+    ], InterceptResult<TCtx>>;
+    afterDirective?: HookFn<[
+        directive: Directive,
+        result: ApplyResult,
+        frame: ExecutionFrame<TCtx>
+    ], AbortDecision>;
+    onDirectivesComplete?: HookFn<[result: DirectiveResult], void>;
+}
+type DirectiveExecutorFn<TCtx> = (directives: readonly Directive[], frame: ExecutionFrame<TCtx>, handlers: DirectiveHandlerMap<TCtx>, directiveHooks: DirectiveHooks<TCtx>, typeField: string, engine: RuleEngineRef<TCtx>, maxDirectives: number) => DirectiveResult | Promise<DirectiveResult>;
+type DirectiveRunnerFn<TCtx> = (directives: readonly Directive[], frame: ExecutionFrame<TCtx>) => DirectiveResult | Promise<DirectiveResult>;
+interface HandlerAnalysis {
+    capabilities: string[];
+    dependencies: string[];
+}
+interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    warnings?: string[];
+}
+interface HandlerDefinition<TCtx> {
+    /** Register-time: extrai capabilities e dependências. */
+    analyze?: (directive: Directive) => HandlerAnalysis;
+    /** Register-time: valida estrutura da directive. */
+    validate?: (directive: Directive) => ValidationResult | void;
+    /** JIT-time: contribui código inline per-action (Fase 2c). */
+    compile?: (directive: Directive, compiler: unknown) => string | void;
+    /** Runtime: executa a directive (obrigatório). */
+    execute: (directive: Directive, frame: ExecutionFrame<TCtx>, engine: ActionEngineRef<TCtx>) => ApplyResult;
+}
+/**
+ * Aceita handler V1 (função) ou V2 (objeto com fases).
+ * Backwards compat: função simples é tratada como { execute: fn }.
+ */
+type HandlerInput<TCtx> = DirectiveHandler<TCtx> | HandlerDefinition<TCtx>;
+type HandlerInputMap<TCtx> = Record<string, HandlerInput<TCtx>>;
+interface ActionDefinition<TCtx = unknown> {
+    /** ID único da Action. */
+    id: string;
+    /** Directives estáticas. */
+    directives: readonly Directive<TCtx>[];
+    /**
+     * Tags categóricas explícitas (identidade).
+     * O que a action É: "controller", "service", "admin", "ui".
+     * Não propagam via grafo. Usadas pelo composition control.
+     */
+    tags?: readonly string[];
+    /** Schema de params aceitos (opcional, Fase 2d). */
+    params?: Record<string, unknown>;
+    /** Metadata opaca pro consumer (opcional). */
+    metadata?: Record<string, unknown>;
+    /**
+     * Tier — nível mínimo necessário pra invocar esta action.
+     * Propagado transitivamente via Math.max pelo analyzer.
+     *
+     * Se declarado, o analyzer valida: tier declarado >= tier inferido (max da sub-árvore).
+     * Se não declarado, apenas infere (sem restrição).
+     *
+     * O engine ignora este campo — é puramente declarativo pro analyzer.
+     * Requer tierPropagator habilitado no grafo.
+     */
+    tier?: number;
+    /**
+     * Declarações — contratos públicos (trust boundaries).
+     * Cada key = nome de um propagator registrado no grafo.
+     *
+     * O engine infere capabilities/propriedades via handler.analyze() + grafo.
+     * Declarations são o contrato que o autor assina.
+     * Se inferência contradiz declaração → DECLARATION_CONFLICT reportado.
+     * Dependentes veem o valor DECLARADO (barreira de propagação).
+     *
+     * Ex: { readonly: true, leaf: true }
+     */
+    declarations?: Record<string, unknown>;
+}
+/** Emitido após register() ou endBatch(). */
+interface RegisterEvent<TCtx = unknown> {
+    readonly actions: readonly ActionDefinition<TCtx>[];
+    readonly result: RegisterResult;
+    readonly registered: readonly string[];
+}
+/** Emitido após unregister(). */
+interface UnregisterEvent {
+    readonly id: string;
+    readonly cascaded: readonly string[];
+}
+/** Mapa de eventos tipados do engine. */
+interface EngineEventMap<TCtx = unknown> {
+    register: RegisterEvent<TCtx>;
+    unregister: UnregisterEvent;
+}
+/** Union dos nomes de lifecycle events. */
+type EngineEventName = keyof EngineEventMap;
+interface RegisterError {
+    actionId: string;
+    error: string;
+    code?: string;
+}
+interface RegisterWarning {
+    actionId: string;
+    code: string;
+    message: string;
+}
+interface RegisterResult {
+    registered: readonly string[];
+    errors: readonly RegisterError[];
+    warnings: readonly RegisterWarning[];
+}
+/** Status de uma diretiva no contexto da instância. */
+type DirectivePermissionStatus = "available" | "denied";
+/**
+ * Informação completa de permissão de uma diretiva.
+ * O mapa só contém handlers que existem (available ou denied).
+ * `unavailable` é derivado: key referenciada mas sem handler registrado.
+ */
+interface DirectivePermission {
+    readonly status: DirectivePermissionStatus;
+    /** Motivação do bloqueio (humana). Presente apenas em denied. */
+    readonly reason?: string;
+    /** Quem bloqueou (auditoria). Presente apenas em denied. */
+    readonly source?: string;
+}
+/** Forma estruturada de entrada de permissão na config. */
+interface DirectivePermissionConfig {
+    readonly pattern: string;
+    readonly reason?: string;
+    readonly source?: string;
+}
+/**
+ * Entrada de permissão: string (shorthand) ou objeto com pattern + motivação.
+ * String pura é equivalente a `{ pattern: string }`.
+ */
+type DirectivePermissionEntry = string | DirectivePermissionConfig;
+interface IActionEngineConfig<TCtx> {
+    /** Handlers com fases (V2) ou funções simples (V1 compat). */
+    handlers: HandlerInputMap<TCtx>;
+    /** Campo de tipo pra dispatch (default: "type"). */
+    typeField?: string;
+    /** Hooks de directive. */
+    directiveHooks?: DirectiveHooks<TCtx>;
+    /** Limites de execução. */
+    limits?: Partial<FrameLimits>;
+    /** Modo de compilação. */
+    mode?: "interpret" | "jit" | "auto";
+    /** Threshold pra auto-promote (default: 8). */
+    autoJitThreshold?: number;
+    /**
+     * Whitelist de diretivas permitidas (pattern matching com wildcard `*`).
+     * Mutuamente exclusivo com `blockedDirectives`.
+     * Se nenhum fornecido: tudo permitido (default).
+     * Diretivas estáticas (const/let/return/throw) são sempre permitidas.
+     */
+    allowedDirectives?: readonly DirectivePermissionEntry[];
+    /**
+     * Blacklist de diretivas bloqueadas (pattern matching com wildcard `*`).
+     * Mutuamente exclusivo com `allowedDirectives`.
+     * Se nenhum fornecido: tudo permitido (default).
+     * Diretivas estáticas (const/let/return/throw) são sempre permitidas.
+     */
+    blockedDirectives?: readonly DirectivePermissionEntry[];
+}
+interface IActionEngine<TCtx> {
+    /** Registra actions. Valida, analisa, indexa no grafo, compila. */
+    register(actions: readonly ActionDefinition<TCtx>[]): RegisterResult;
+    /** Remove action do registry. Cascade: remove children (path-based). */
+    unregister(id: string): boolean;
+    /** Inicia batch. Registros acumulados, análise adiada pro endBatch. */
+    beginBatch(): void;
+    /** Finaliza batch. Executa análise, typecheck, indexação. */
+    endBatch(): RegisterResult;
+    /** Invoca action por ID. Lookup O(1). */
+    invoke(id: string, params?: Record<string, unknown>): DirectiveResult;
+    /** Invoca action async. */
+    invokeAsync(id: string, params?: Record<string, unknown>): Promise<DirectiveResult>;
+    /** Seta ctx global. */
+    setContext(ctx: TCtx): void;
+    /** Override temporário de ctx dentro do callback. */
+    context<R>(ctx: TCtx, fn: () => R): R;
+    /**
+     * Subscribe em lifecycle events do engine.
+     * Retorna função de unsubscribe idempotente.
+     */
+    on<K extends keyof EngineEventMap<TCtx> & string>(event: K, listener: (payload: EngineEventMap<TCtx>[K]) => void): () => void;
+    /** Handler definitions registradas (V2). Leitura por camadas externas. */
+    readonly handlerDefinitions: ReadonlyMap<string, HandlerDefinition<TCtx>>;
+    /** IDs de todas as actions no registry. */
+    readonly registeredIds: ReadonlySet<string>;
+    /** Lê uma action definition pelo ID. undefined se não registrada. */
+    getActionDefinition(id: string): ActionDefinition<TCtx> | undefined;
+    /** Campo de tipo pra dispatch de diretivas (default: "type"). */
+    readonly typeField: string;
+    /**
+     * Mapa de permissões de diretivas, computado no boot (imutável).
+     * Contém apenas handlers registrados (available ou denied).
+     * `unavailable` é derivado: key não presente = handler inexistente.
+     */
+    readonly directivePermissions: ReadonlyMap<string, DirectivePermission>;
+    readonly isAsync: boolean;
+    readonly compilationMode: "interpret" | "jit";
+    compile(): void;
+    readonly directiveHookSlots: ReadonlySet<string>;
+    readonly asyncSlots: ReadonlySet<string>;
+}
+
+/**
+ * Type-safe event emitter. Zero deps. Browser-compatible.
+ *
+ * Usage:
+ * ```ts
+ * type Events = {
+ *   register: { ids: string[] };
+ *   disable: { id: string };
+ * };
+ * const emitter = new SimpleEmitter<Events>();
+ * const unsub = emitter.on("register", (e) => console.log(e.ids));
+ * emitter.emit("register", { ids: ["a"] });
+ * unsub();
+ * ```
+ */
+type Listener<T> = (payload: T) => void;
+declare class SimpleEmitter<TEvents = Record<string, unknown>> {
+    private readonly _listeners;
+    /**
+     * Subscribe to an event. Returns idempotent unsubscribe function.
+     * Same listener on same event is deduplicated (Set semantics).
+     */
+    on<K extends keyof TEvents & string>(event: K, listener: Listener<TEvents[K]>): () => void;
+    /**
+     * Subscribe for a single emission, then auto-unsubscribe.
+     * Returns unsubscribe (can cancel before first emission).
+     */
+    once<K extends keyof TEvents & string>(event: K, listener: Listener<TEvents[K]>): () => void;
+    /**
+     * Emit event to all listeners.
+     * - Iterates a snapshot — safe if listeners add/remove during emit.
+     * - Listener errors are isolated: caught, logged, don't block others.
+     */
+    emit<K extends keyof TEvents & string>(event: K, payload: TEvents[K]): void;
+    /** Number of listeners for a specific event (0 if none). */
+    listenerCount<K extends keyof TEvents & string>(event: K): number;
+    /** True if at least one listener exists for the event. */
+    hasListeners<K extends keyof TEvents & string>(event: K): boolean;
+    /** Remove all listeners for a specific event. */
+    off<K extends keyof TEvents & string>(event: K): void;
+    /** Remove ALL listeners from ALL events. */
+    removeAllListeners(): void;
+}
+
+declare const RESERVED_TYPES: Set<string>;
+declare function normalizeDirectives<TCtx>(directives: readonly Directive<TCtx>[], typeField: string): Directive<TCtx>[];
+
+declare function createDirectiveInterpreter<TCtx>(analysis: SlotAnalysis, isAsync: boolean): DirectiveExecutorFn<TCtx>;
+
+declare function createActionEngine<TCtx>(config: IActionEngineConfig<TCtx>): IActionEngine<TCtx>;
+
+type RuntimeDirectiveExecutorFn = (directives: readonly unknown[], frame: unknown, handlers: unknown, directiveHooks: unknown, typeField: string, engine: unknown, maxDirectives: number) => unknown;
+interface GeneratedDirectiveExecutor {
+    fn: RuntimeDirectiveExecutorFn;
+    isAsync: boolean;
+}
+declare function buildDirectiveExecutor(analysis: SlotAnalysis): GeneratedDirectiveExecutor;
+
+type RuntimeActionExecutorFn = (frame: unknown, scope: unknown, $: unknown) => unknown;
+interface GeneratedActionExecutor {
+    fn: RuntimeActionExecutorFn;
+    isAsync: boolean;
+}
+declare function buildActionExecutor(directives: readonly Directive[], analysis: SlotAnalysis, typeField: string): GeneratedActionExecutor;
+
+export { type ActionDefinition, type DirectiveExecutorFn, type DirectiveHandler, type DirectiveHandlerMap, type DirectiveHooks, type DirectivePermission, type DirectivePermissionConfig, type DirectivePermissionEntry, type DirectivePermissionStatus, type DirectiveRunnerFn, type EngineEventMap, type EngineEventName, type GeneratedActionExecutor, type GeneratedDirectiveExecutor, type HandlerAnalysis, type HandlerDefinition, type HandlerInput, type HandlerInputMap, type IActionEngine, type IActionEngineConfig, type Listener, RESERVED_TYPES, type RegisterError, type RegisterEvent, type RegisterResult, type RegisterWarning, SimpleEmitter, type UnregisterEvent, type ValidationResult, buildActionExecutor, buildDirectiveExecutor, createActionEngine, createDirectiveInterpreter, normalizeDirectives };

package/dist/index.d.ts

@@ -0,0 +1,277 @@
+import { Directive, ExecutionFrame, RuleEngineRef, ApplyResult, HookFn, InterceptResult, AbortDecision, DirectiveResult, ActionEngineRef, FrameLimits, SlotAnalysis } from '@statedelta-actions/core';
+
+type DirectiveHandler<TCtx> = (directive: Directive, frame: ExecutionFrame<TCtx>, engine: RuleEngineRef<TCtx>) => ApplyResult;
+type DirectiveHandlerMap<TCtx> = Record<string, DirectiveHandler<TCtx>>;
+interface DirectiveHooks<TCtx> {
+    beforeDirective?: HookFn<[
+        directive: Directive,
+        frame: ExecutionFrame<TCtx>
+    ], InterceptResult<TCtx>>;
+    afterDirective?: HookFn<[
+        directive: Directive,
+        result: ApplyResult,
+        frame: ExecutionFrame<TCtx>
+    ], AbortDecision>;
+    onDirectivesComplete?: HookFn<[result: DirectiveResult], void>;
+}
+type DirectiveExecutorFn<TCtx> = (directives: readonly Directive[], frame: ExecutionFrame<TCtx>, handlers: DirectiveHandlerMap<TCtx>, directiveHooks: DirectiveHooks<TCtx>, typeField: string, engine: RuleEngineRef<TCtx>, maxDirectives: number) => DirectiveResult | Promise<DirectiveResult>;
+type DirectiveRunnerFn<TCtx> = (directives: readonly Directive[], frame: ExecutionFrame<TCtx>) => DirectiveResult | Promise<DirectiveResult>;
+interface HandlerAnalysis {
+    capabilities: string[];
+    dependencies: string[];
+}
+interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    warnings?: string[];
+}
+interface HandlerDefinition<TCtx> {
+    /** Register-time: extrai capabilities e dependências. */
+    analyze?: (directive: Directive) => HandlerAnalysis;
+    /** Register-time: valida estrutura da directive. */
+    validate?: (directive: Directive) => ValidationResult | void;
+    /** JIT-time: contribui código inline per-action (Fase 2c). */
+    compile?: (directive: Directive, compiler: unknown) => string | void;
+    /** Runtime: executa a directive (obrigatório). */
+    execute: (directive: Directive, frame: ExecutionFrame<TCtx>, engine: ActionEngineRef<TCtx>) => ApplyResult;
+}
+/**
+ * Aceita handler V1 (função) ou V2 (objeto com fases).
+ * Backwards compat: função simples é tratada como { execute: fn }.
+ */
+type HandlerInput<TCtx> = DirectiveHandler<TCtx> | HandlerDefinition<TCtx>;
+type HandlerInputMap<TCtx> = Record<string, HandlerInput<TCtx>>;
+interface ActionDefinition<TCtx = unknown> {
+    /** ID único da Action. */
+    id: string;
+    /** Directives estáticas. */
+    directives: readonly Directive<TCtx>[];
+    /**
+     * Tags categóricas explícitas (identidade).
+     * O que a action É: "controller", "service", "admin", "ui".
+     * Não propagam via grafo. Usadas pelo composition control.
+     */
+    tags?: readonly string[];
+    /** Schema de params aceitos (opcional, Fase 2d). */
+    params?: Record<string, unknown>;
+    /** Metadata opaca pro consumer (opcional). */
+    metadata?: Record<string, unknown>;
+    /**
+     * Tier — nível mínimo necessário pra invocar esta action.
+     * Propagado transitivamente via Math.max pelo analyzer.
+     *
+     * Se declarado, o analyzer valida: tier declarado >= tier inferido (max da sub-árvore).
+     * Se não declarado, apenas infere (sem restrição).
+     *
+     * O engine ignora este campo — é puramente declarativo pro analyzer.
+     * Requer tierPropagator habilitado no grafo.
+     */
+    tier?: number;
+    /**
+     * Declarações — contratos públicos (trust boundaries).
+     * Cada key = nome de um propagator registrado no grafo.
+     *
+     * O engine infere capabilities/propriedades via handler.analyze() + grafo.
+     * Declarations são o contrato que o autor assina.
+     * Se inferência contradiz declaração → DECLARATION_CONFLICT reportado.
+     * Dependentes veem o valor DECLARADO (barreira de propagação).
+     *
+     * Ex: { readonly: true, leaf: true }
+     */
+    declarations?: Record<string, unknown>;
+}
+/** Emitido após register() ou endBatch(). */
+interface RegisterEvent<TCtx = unknown> {
+    readonly actions: readonly ActionDefinition<TCtx>[];
+    readonly result: RegisterResult;
+    readonly registered: readonly string[];
+}
+/** Emitido após unregister(). */
+interface UnregisterEvent {
+    readonly id: string;
+    readonly cascaded: readonly string[];
+}
+/** Mapa de eventos tipados do engine. */
+interface EngineEventMap<TCtx = unknown> {
+    register: RegisterEvent<TCtx>;
+    unregister: UnregisterEvent;
+}
+/** Union dos nomes de lifecycle events. */
+type EngineEventName = keyof EngineEventMap;
+interface RegisterError {
+    actionId: string;
+    error: string;
+    code?: string;
+}
+interface RegisterWarning {
+    actionId: string;
+    code: string;
+    message: string;
+}
+interface RegisterResult {
+    registered: readonly string[];
+    errors: readonly RegisterError[];
+    warnings: readonly RegisterWarning[];
+}
+/** Status de uma diretiva no contexto da instância. */
+type DirectivePermissionStatus = "available" | "denied";
+/**
+ * Informação completa de permissão de uma diretiva.
+ * O mapa só contém handlers que existem (available ou denied).
+ * `unavailable` é derivado: key referenciada mas sem handler registrado.
+ */
+interface DirectivePermission {
+    readonly status: DirectivePermissionStatus;
+    /** Motivação do bloqueio (humana). Presente apenas em denied. */
+    readonly reason?: string;
+    /** Quem bloqueou (auditoria). Presente apenas em denied. */
+    readonly source?: string;
+}
+/** Forma estruturada de entrada de permissão na config. */
+interface DirectivePermissionConfig {
+    readonly pattern: string;
+    readonly reason?: string;
+    readonly source?: string;
+}
+/**
+ * Entrada de permissão: string (shorthand) ou objeto com pattern + motivação.
+ * String pura é equivalente a `{ pattern: string }`.
+ */
+type DirectivePermissionEntry = string | DirectivePermissionConfig;
+interface IActionEngineConfig<TCtx> {
+    /** Handlers com fases (V2) ou funções simples (V1 compat). */
+    handlers: HandlerInputMap<TCtx>;
+    /** Campo de tipo pra dispatch (default: "type"). */
+    typeField?: string;
+    /** Hooks de directive. */
+    directiveHooks?: DirectiveHooks<TCtx>;
+    /** Limites de execução. */
+    limits?: Partial<FrameLimits>;
+    /** Modo de compilação. */
+    mode?: "interpret" | "jit" | "auto";
+    /** Threshold pra auto-promote (default: 8). */
+    autoJitThreshold?: number;
+    /**
+     * Whitelist de diretivas permitidas (pattern matching com wildcard `*`).
+     * Mutuamente exclusivo com `blockedDirectives`.
+     * Se nenhum fornecido: tudo permitido (default).
+     * Diretivas estáticas (const/let/return/throw) são sempre permitidas.
+     */
+    allowedDirectives?: readonly DirectivePermissionEntry[];
+    /**
+     * Blacklist de diretivas bloqueadas (pattern matching com wildcard `*`).
+     * Mutuamente exclusivo com `allowedDirectives`.
+     * Se nenhum fornecido: tudo permitido (default).
+     * Diretivas estáticas (const/let/return/throw) são sempre permitidas.
+     */
+    blockedDirectives?: readonly DirectivePermissionEntry[];
+}
+interface IActionEngine<TCtx> {
+    /** Registra actions. Valida, analisa, indexa no grafo, compila. */
+    register(actions: readonly ActionDefinition<TCtx>[]): RegisterResult;
+    /** Remove action do registry. Cascade: remove children (path-based). */
+    unregister(id: string): boolean;
+    /** Inicia batch. Registros acumulados, análise adiada pro endBatch. */
+    beginBatch(): void;
+    /** Finaliza batch. Executa análise, typecheck, indexação. */
+    endBatch(): RegisterResult;
+    /** Invoca action por ID. Lookup O(1). */
+    invoke(id: string, params?: Record<string, unknown>): DirectiveResult;
+    /** Invoca action async. */
+    invokeAsync(id: string, params?: Record<string, unknown>): Promise<DirectiveResult>;
+    /** Seta ctx global. */
+    setContext(ctx: TCtx): void;
+    /** Override temporário de ctx dentro do callback. */
+    context<R>(ctx: TCtx, fn: () => R): R;
+    /**
+     * Subscribe em lifecycle events do engine.
+     * Retorna função de unsubscribe idempotente.
+     */
+    on<K extends keyof EngineEventMap<TCtx> & string>(event: K, listener: (payload: EngineEventMap<TCtx>[K]) => void): () => void;
+    /** Handler definitions registradas (V2). Leitura por camadas externas. */
+    readonly handlerDefinitions: ReadonlyMap<string, HandlerDefinition<TCtx>>;
+    /** IDs de todas as actions no registry. */
+    readonly registeredIds: ReadonlySet<string>;
+    /** Lê uma action definition pelo ID. undefined se não registrada. */
+    getActionDefinition(id: string): ActionDefinition<TCtx> | undefined;
+    /** Campo de tipo pra dispatch de diretivas (default: "type"). */
+    readonly typeField: string;
+    /**
+     * Mapa de permissões de diretivas, computado no boot (imutável).
+     * Contém apenas handlers registrados (available ou denied).
+     * `unavailable` é derivado: key não presente = handler inexistente.
+     */
+    readonly directivePermissions: ReadonlyMap<string, DirectivePermission>;
+    readonly isAsync: boolean;
+    readonly compilationMode: "interpret" | "jit";
+    compile(): void;
+    readonly directiveHookSlots: ReadonlySet<string>;
+    readonly asyncSlots: ReadonlySet<string>;
+}
+
+/**
+ * Type-safe event emitter. Zero deps. Browser-compatible.
+ *
+ * Usage:
+ * ```ts
+ * type Events = {
+ *   register: { ids: string[] };
+ *   disable: { id: string };
+ * };
+ * const emitter = new SimpleEmitter<Events>();
+ * const unsub = emitter.on("register", (e) => console.log(e.ids));
+ * emitter.emit("register", { ids: ["a"] });
+ * unsub();
+ * ```
+ */
+type Listener<T> = (payload: T) => void;
+declare class SimpleEmitter<TEvents = Record<string, unknown>> {
+    private readonly _listeners;
+    /**
+     * Subscribe to an event. Returns idempotent unsubscribe function.
+     * Same listener on same event is deduplicated (Set semantics).
+     */
+    on<K extends keyof TEvents & string>(event: K, listener: Listener<TEvents[K]>): () => void;
+    /**
+     * Subscribe for a single emission, then auto-unsubscribe.
+     * Returns unsubscribe (can cancel before first emission).
+     */
+    once<K extends keyof TEvents & string>(event: K, listener: Listener<TEvents[K]>): () => void;
+    /**
+     * Emit event to all listeners.
+     * - Iterates a snapshot — safe if listeners add/remove during emit.
+     * - Listener errors are isolated: caught, logged, don't block others.
+     */
+    emit<K extends keyof TEvents & string>(event: K, payload: TEvents[K]): void;
+    /** Number of listeners for a specific event (0 if none). */
+    listenerCount<K extends keyof TEvents & string>(event: K): number;
+    /** True if at least one listener exists for the event. */
+    hasListeners<K extends keyof TEvents & string>(event: K): boolean;
+    /** Remove all listeners for a specific event. */
+    off<K extends keyof TEvents & string>(event: K): void;
+    /** Remove ALL listeners from ALL events. */
+    removeAllListeners(): void;
+}
+
+declare const RESERVED_TYPES: Set<string>;
+declare function normalizeDirectives<TCtx>(directives: readonly Directive<TCtx>[], typeField: string): Directive<TCtx>[];
+
+declare function createDirectiveInterpreter<TCtx>(analysis: SlotAnalysis, isAsync: boolean): DirectiveExecutorFn<TCtx>;
+
+declare function createActionEngine<TCtx>(config: IActionEngineConfig<TCtx>): IActionEngine<TCtx>;
+
+type RuntimeDirectiveExecutorFn = (directives: readonly unknown[], frame: unknown, handlers: unknown, directiveHooks: unknown, typeField: string, engine: unknown, maxDirectives: number) => unknown;
+interface GeneratedDirectiveExecutor {
+    fn: RuntimeDirectiveExecutorFn;
+    isAsync: boolean;
+}
+declare function buildDirectiveExecutor(analysis: SlotAnalysis): GeneratedDirectiveExecutor;
+
+type RuntimeActionExecutorFn = (frame: unknown, scope: unknown, $: unknown) => unknown;
+interface GeneratedActionExecutor {
+    fn: RuntimeActionExecutorFn;
+    isAsync: boolean;
+}
+declare function buildActionExecutor(directives: readonly Directive[], analysis: SlotAnalysis, typeField: string): GeneratedActionExecutor;
+
+export { type ActionDefinition, type DirectiveExecutorFn, type DirectiveHandler, type DirectiveHandlerMap, type DirectiveHooks, type DirectivePermission, type DirectivePermissionConfig, type DirectivePermissionEntry, type DirectivePermissionStatus, type DirectiveRunnerFn, type EngineEventMap, type EngineEventName, type GeneratedActionExecutor, type GeneratedDirectiveExecutor, type HandlerAnalysis, type HandlerDefinition, type HandlerInput, type HandlerInputMap, type IActionEngine, type IActionEngineConfig, type Listener, RESERVED_TYPES, type RegisterError, type RegisterEvent, type RegisterResult, type RegisterWarning, SimpleEmitter, type UnregisterEvent, type ValidationResult, buildActionExecutor, buildDirectiveExecutor, createActionEngine, createDirectiveInterpreter, normalizeDirectives };

package/dist/index.js

@@ -0,0 +1,9 @@
+import {processIntercept,Intercept,analyzeSlots,DIRECTIVE_SLOT_NAMES,createRootFrame}from'@statedelta-actions/core';var F=class{_listeners=new Map;on(e,i){let n=this._listeners.get(e);n||(n=new Set,this._listeners.set(e,n)),n.add(i);let s=false;return ()=>{s||(s=true,n.delete(i),n.size===0&&this._listeners.delete(e));}}once(e,i){let n=this.on(e,s=>{n(),i(s);});return n}emit(e,i){let n=this._listeners.get(e);if(!n||n.size===0)return;let s=[...n];for(let r=0;r<s.length;r++)try{s[r](i);}catch(c){console.error(`[SimpleEmitter] Listener error on "${e}":`,c);}}listenerCount(e){return this._listeners.get(e)?.size??0}hasListeners(e){let i=this._listeners.get(e);return i!==void 0&&i.size>0}off(e){this._listeners.delete(e);}removeAllListeners(){this._listeners.clear();}};var S=new Set(["const","let","return","throw"]);function W(t,e,i,n){let s=[];for(let r=0;r<t.directives.length;r++){let c=t.directives[r];if("const"in c||"let"in c||"return"in c||"throw"in c)continue;let h=c[n];if(!h){s.push(`directive[${r}]: missing type field "${n}"`);continue}if(!e[h]){s.push(`directive[${r}]: no handler for type "${h}"`);continue}let x=i.get(h);if(x?.validate)try{let D=x.validate(c);D&&!D.valid&&s.push(`directive[${r}]: ${D.error??"validation failed"}`);}catch(D){s.push(`directive[${r}]: validate threw: ${D}`);}let m=c.catch;if(m&&Array.isArray(m))for(let D=0;D<m.length;D++){let R=m[D];if("const"in R||"let"in R||"return"in R||"throw"in R)continue;let v=R[n];v&&!e[v]&&s.push(`directive[${r}].catch[${D}]: no handler for type "${v}"`);}}return s}function H(t,e){let i=t.length,n=new Array(i);for(let s=0;s<i;s++){let r=t[s];if("const"in r)n[s]=q(r,"const");else if("let"in r)n[s]=q(r,"let");else if("return"in r)n[s]=te(r);else if("throw"in r)n[s]=re(r);else {let c=r.catch;Array.isArray(c)&&c.length>0?n[s]={...r,catch:H(c)}:n[s]=r;}}return n}function q(t,e){let{[e]:i,...n}=t;return {...n,type:e,name:i}}function te(t){let{return:e,...i}=t;return {...i,type:"return",value:e}}function re(t){let{throw:e,...i}=t;return {...i,type:"throw",message:e}}function M(t,e,i,n,s,r,c){return {success:false,aborted:true,abortedBy:t,appliedCount:e,skippedCount:i,errors:n,processedCount:s,totalCount:r,counters:c}}function ie(t){let e=t.filledNames.has("beforeDirective"),i=t.filledNames.has("afterDirective"),n=t.filledNames.has("onDirectivesComplete");return function(r,c,h,x,m,D,R){let v=Math.min(r.length,R),l=[],f=0,_=0,{counters:u,scope:C}=c,A=c.ctx;for(let a=0;a<v;a++){let p=r[a],$=p[m];if($==="const"||$==="let"){let o=p.name;if(typeof p.resolve=="function")try{C[o]=p.resolve(A,C).value;}catch(d){l.push({directiveIndex:a,error:`Binding resolve: ${d}`}),u.errors++;}else C[o]=p.value;continue}if($==="return"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="value"in d?d.value:"return"in d?d.return:p.value;return {success:!0,aborted:!1,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.value};continue}if($==="throw"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="message"in d?d.message:"throw"in d?d.throw:p.message;return {success:!1,aborted:!0,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:false,aborted:true,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.message};continue}let y=p,E=c;if(e)try{let o=processIntercept(x.beforeDirective(y,c),"beforeDirective");if(o.action===Intercept.SKIP){_++,u.directivesSkipped++;continue}if(o.action===Intercept.ABORT)return M(o.abortReason,f,_,l,a,v,u);o.ctx!==void 0&&(E=c.withCtx(o.ctx)),o.directive!==void 0&&(y=o.directive);}catch(o){l.push({directiveIndex:a,error:`Hook beforeDirective: ${o}`}),u.errors++;}if(typeof y.resolve=="function")try{let o=y.resolve(E.ctx,E.scope);y={...y,...o};}catch(o){l.push({directiveIndex:a,error:`Directive resolve: ${o}`}),u.errors++;continue}let w=y[m],I=w?h[w]:void 0;if(!I){l.push({directiveIndex:a,error:`No handler for directive type: ${w??"undefined"}`}),u.errors++;continue}let g;try{g=I(y,E,D);}catch(o){g={ok:false,error:String(o)};}let T=a+1;if(g.ok){if(f++,u.directivesApplied++,typeof y.as=="string"&&(C[y.as]=g.data),g.halt)return {success:true,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data}}else {if(g.halt)return {success:false,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data};let o=y.catch;if(Array.isArray(o)&&o.length>0){C.$exception=g.error??"handler failed";let d=D.runDirectives(o,E);f+=d.appliedCount;for(let b=0;b<d.errors.length;b++)l.push(d.errors[b]);if(d.aborted)return {success:d.success,aborted:true,abortedBy:d.abortedBy,appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:d.data}}else l.push({directiveIndex:a,error:g.error??"handler failed"}),u.errors++;}if(i)try{if(x.afterDirective(y,g,E)==="abort")return M("afterDirective",f,_,l,T,v,u)}catch(o){l.push({directiveIndex:a,error:`Hook afterDirective: ${o}`}),u.errors++;}}let k={success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:v,totalCount:v,counters:u};if(n)try{x.onDirectivesComplete(k);}catch{}return k}}function ne(t){let e=t.filledNames.has("beforeDirective"),i=t.filledNames.has("afterDirective"),n=t.filledNames.has("onDirectivesComplete");return async function(r,c,h,x,m,D,R){let v=Math.min(r.length,R),l=[],f=0,_=0,{counters:u,scope:C}=c,A=c.ctx;for(let a=0;a<v;a++){let p=r[a],$=p[m];if($==="const"||$==="let"){let o=p.name;if(typeof p.resolve=="function")try{C[o]=p.resolve(A,C).value;}catch(d){l.push({directiveIndex:a,error:`Binding resolve: ${d}`}),u.errors++;}else C[o]=p.value;continue}if($==="return"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="value"in d?d.value:"return"in d?d.return:p.value;return {success:!0,aborted:!1,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.value};continue}if($==="throw"){let o=a+1;if(typeof p.resolve=="function")try{let d=p.resolve(A,C),b="message"in d?d.message:"throw"in d?d.throw:p.message;return {success:!1,aborted:!0,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:b}}catch(d){l.push({directiveIndex:a,error:`Control resolve: ${d}`}),u.errors++;}else return {success:false,aborted:true,abortedBy:"throw",appliedCount:f,skippedCount:_,errors:l,processedCount:o,totalCount:v,counters:u,data:p.message};continue}let y=p,E=c;if(e)try{let o=processIntercept(await x.beforeDirective(y,c),"beforeDirective");if(o.action===Intercept.SKIP){_++,u.directivesSkipped++;continue}if(o.action===Intercept.ABORT)return M(o.abortReason,f,_,l,a,v,u);o.ctx!==void 0&&(E=c.withCtx(o.ctx)),o.directive!==void 0&&(y=o.directive);}catch(o){l.push({directiveIndex:a,error:`Hook beforeDirective: ${o}`}),u.errors++;}if(typeof y.resolve=="function")try{let o=y.resolve(E.ctx,E.scope);y={...y,...o};}catch(o){l.push({directiveIndex:a,error:`Directive resolve: ${o}`}),u.errors++;continue}let w=y[m],I=w?h[w]:void 0;if(!I){l.push({directiveIndex:a,error:`No handler for directive type: ${w??"undefined"}`}),u.errors++;continue}let g;try{g=I(y,E,D);}catch(o){g={ok:false,error:String(o)};}let T=a+1;if(g.ok){if(f++,u.directivesApplied++,typeof y.as=="string"&&(C[y.as]=g.data),g.halt)return {success:true,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data}}else {if(g.halt)return {success:false,aborted:true,abortedBy:"halt",appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:g.data};let o=y.catch;if(Array.isArray(o)&&o.length>0){C.$exception=g.error??"handler failed";let d=await D.runDirectivesAsync(o,E);f+=d.appliedCount;for(let b=0;b<d.errors.length;b++)l.push(d.errors[b]);if(d.aborted)return {success:d.success,aborted:true,abortedBy:d.abortedBy,appliedCount:f,skippedCount:_,errors:l,processedCount:T,totalCount:v,counters:u,data:d.data}}else l.push({directiveIndex:a,error:g.error??"handler failed"}),u.errors++;}if(i)try{if(await x.afterDirective(y,g,E)==="abort")return M("afterDirective",f,_,l,T,v,u)}catch(o){l.push({directiveIndex:a,error:`Hook afterDirective: ${o}`}),u.errors++;}}let k={success:true,aborted:false,appliedCount:f,skippedCount:_,errors:l,processedCount:v,totalCount:v,counters:u};if(n)try{await x.onDirectivesComplete(k);}catch{}return k}}function B(t,e){return e?ne(t):ie(t)}function j(t){let{filledNames:e,hasAnyAsync:i}=t,n=m=>e.has(m),s=m=>t.asyncNames.has(m)?"await ":"",r=[];for(let m of e)r.push(`const ${m} = directiveHooks.${m};`);r.push("const len = Math.min(directives.length, maxDirectives);"),r.push("const errors = []; let appliedCount = 0; let skippedCount = 0;"),r.push("const counters = frame.counters;"),r.push("for (let i = 0; i < len; i++) {"),r.push("  let directive = directives[i];"),n("beforeDirective")?(r.push("  let _df = frame;"),r.push("  try {"),r.push(`    const _bd = ${s("beforeDirective")}beforeDirective(directive, frame);`),r.push('    if (_bd === "skip") { skippedCount++; counters.directivesSkipped++; continue; }'),r.push('    if (_bd === "abort") return { success: false, aborted: true, abortedBy: "beforeDirective", appliedCount, skippedCount, errors, processedCount: i, totalCount: len, counters };'),r.push('    if (typeof _bd === "object" && _bd !== null) {'),r.push('      if ("abort" in _bd) return { success: false, aborted: true, abortedBy: _bd.abort, appliedCount, skippedCount, errors, processedCount: i, totalCount: len, counters };'),r.push('      if ("ctx" in _bd) _df = frame.withCtx(_bd.ctx);'),r.push('      if ("directive" in _bd) directive = _bd.directive;'),r.push("    }"),r.push('  } catch (_e) { errors.push({ directiveIndex: i, error: "Hook beforeDirective: " + _e }); counters.errors++; }')):r.push("  const _df = frame;"),r.push('  if (typeof directive.resolve === "function") {'),r.push("    try { const _r = directive.resolve(_df.ctx); directive = Object.assign({}, directive, _r); }"),r.push('    catch (_e) { errors.push({ directiveIndex: i, error: "Directive resolve: " + _e }); counters.errors++; continue; }'),r.push("  }"),r.push("  const _type = directive[typeField];"),r.push("  const _handler = _type ? handlers[_type] : undefined;"),r.push('  if (!_handler) { errors.push({ directiveIndex: i, error: "No handler for directive type: " + (_type || "undefined") }); counters.errors++; continue; }'),r.push("  let _result;"),r.push("  try { _result = _handler(directive, _df, engine); } catch (_e) { errors.push({ directiveIndex: i, error: String(_e) }); counters.errors++; continue; }"),r.push("  if (_result.ok) { appliedCount++; counters.directivesApplied++; }"),r.push('  else { errors.push({ directiveIndex: i, error: _result.error || "handler failed" }); counters.errors++; }'),n("afterDirective")&&(r.push("  try {"),r.push(`    const _ad = ${s("afterDirective")}afterDirective(directive, _result, _df);`),r.push('    if (_ad === "abort") return { success: false, aborted: true, abortedBy: "afterDirective", appliedCount, skippedCount, errors, processedCount: i + 1, totalCount: len, counters };'),r.push('  } catch (_e) { errors.push({ directiveIndex: i, error: "Hook afterDirective: " + _e }); counters.errors++; }')),r.push("}"),r.push("const _finalResult = { success: true, aborted: false, appliedCount, skippedCount, errors, processedCount: len, totalCount: len, counters };"),n("onDirectivesComplete")&&r.push(`try { ${s("onDirectivesComplete")}onDirectivesComplete(_finalResult); } catch (_e) {}`),r.push("return _finalResult;");let c=r.join(`
+`),h=i?"async ":"";return {fn:new Function("directives","frame","handlers","directiveHooks","typeField","engine","maxDirectives",`"use strict";
+return (${h}() => {
+${c}
+})();`),isAsync:i}}function N(t,e,i){return `return{success:false,aborted:true,abortedBy:${t},appliedCount,skippedCount,errors,processedCount:${e},totalCount:${i},counters};`}function se(t,e){return `return{success:true,aborted:true,abortedBy:"halt",appliedCount,skippedCount,errors,processedCount:${t},totalCount:${e},counters,data:_result.data};`}function oe(t,e){return `return{success:false,aborted:true,abortedBy:"halt",appliedCount,skippedCount,errors,processedCount:${t},totalCount:${e},counters,data:_result.data};`}function ce(t,e,i){let n=JSON.stringify(e.name);typeof e.resolve=="function"?(t.push("try{"),t.push(`scope[${n}]=$.d[${i}].resolve(ctx,scope).value;`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Binding resolve: "+_e});counters.errors++;}`)):t.push(`scope[${n}]=$.d[${i}].value;`);}function ae(t,e,i,n){let s=typeof e.resolve=="function",r=i+1;s?(t.push("try{"),t.push(`const _rv=$.d[${i}].resolve(ctx,scope);`),t.push(`return{success:true,aborted:false,appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:"value" in _rv?_rv.value:"return" in _rv?_rv.return:$.d[${i}].value};`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Control resolve: "+_e});counters.errors++;}`)):t.push(`return{success:true,aborted:false,appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:$.d[${i}].value};`);}function ue(t,e,i,n){let s=typeof e.resolve=="function",r=i+1;s?(t.push("try{"),t.push(`const _rv=$.d[${i}].resolve(ctx,scope);`),t.push(`return{success:false,aborted:true,abortedBy:"throw",appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:"message" in _rv?_rv.message:"throw" in _rv?_rv.throw:$.d[${i}].message};`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Control resolve: "+_e});counters.errors++;}`)):t.push(`return{success:false,aborted:true,abortedBy:"throw",appliedCount,skippedCount,errors,processedCount:${r},totalCount:${n},counters,data:$.d[${i}].message};`);}function de(t,e,i,n,s,r,c,h,x,m){let D=e[s],R=r.get(D),v=typeof e.resolve=="function",l=typeof e.as=="string",f=Array.isArray(e.catch)&&e.catch.length>0,_=l?JSON.stringify(e.as):"",u=i+1;t.push(`_b${i}:{`);let C=c||v,A=c;C&&t.push(`let _dir=$.d[${i}];`),A&&t.push("let _df=frame;"),c&&(t.push("try{"),t.push(`const _bd=${x}_hookBefore($.d[${i}],frame);`),t.push(`if(_bd==="skip"){skippedCount++;counters.directivesSkipped++;break _b${i};}`),t.push(`if(_bd==="abort")${N('"beforeDirective"',i,n)}`),t.push('if(typeof _bd==="object"&&_bd!==null){'),t.push(`if("abort" in _bd)${N("_bd.abort",i,n)}`),t.push('if("ctx" in _bd)_df=frame.withCtx(_bd.ctx);'),t.push('if("directive" in _bd)_dir=_bd.directive;'),t.push("}"),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Hook beforeDirective: "+_e});counters.errors++;}`)),c?(t.push('if(typeof _dir.resolve==="function"){'),t.push("try{const _r=_dir.resolve(_df.ctx,scope);_dir=Object.assign({},_dir,_r);}"),t.push(`catch(_e){errors.push({directiveIndex:${i},error:"Directive resolve: "+_e});counters.errors++;break _b${i};}}`)):v&&(t.push(`try{const _r=$.d[${i}].resolve(ctx,scope);_dir=Object.assign({},$.d[${i}],_r);}`),t.push(`catch(_e){errors.push({directiveIndex:${i},error:"Directive resolve: "+_e});counters.errors++;break _b${i};}`));let k=C?"_dir":`$.d[${i}]`,a=A?"_df":"frame";t.push("let _result;"),t.push(`try{_result=${R}(${k},${a},$.engine);}`),t.push("catch(_e){_result={ok:false,error:String(_e)};}"),t.push("if(_result.ok){"),t.push("appliedCount++;counters.directivesApplied++;"),l&&t.push(`scope[${_}]=_result.data;`),t.push(`if(_result.halt)${se(u,n)}`),t.push("}else{"),t.push(`if(_result.halt)${oe(u,n)}`),f?(t.push('scope.$exception=_result.error||"handler failed";'),t.push(`const _cr=$.runner($.d[${i}].catch,${a});`),t.push("appliedCount+=_cr.appliedCount;"),t.push("for(let _j=0;_j<_cr.errors.length;_j++)errors.push(_cr.errors[_j]);"),t.push(`if(_cr.aborted)return{success:_cr.success,aborted:true,abortedBy:_cr.abortedBy,appliedCount,skippedCount,errors,processedCount:${u},totalCount:${n},counters,data:_cr.data};`)):t.push(`errors.push({directiveIndex:${i},error:_result.error||"handler failed"});counters.errors++;`),t.push("}"),h&&(t.push("try{"),t.push(`const _ad=${m}_hookAfter(${k},_result,${a});`),t.push(`if(_ad==="abort")${N('"afterDirective"',u,n)}`),t.push(`}catch(_e){errors.push({directiveIndex:${i},error:"Hook afterDirective: "+_e});counters.errors++;}`)),t.push("}");}function O(t,e,i){let n=[],s=t.length,{filledNames:r,hasAnyAsync:c,asyncNames:h}=e,x=r.has("beforeDirective"),m=r.has("afterDirective"),D=r.has("onDirectivesComplete"),R=h.has("beforeDirective")?"await ":"",v=h.has("afterDirective")?"await ":"",l=h.has("onDirectivesComplete")?"await ":"",f=new Set;for(let a of t){let p=a[i];p&&!S.has(p)&&f.add(p);}let _=new Map,u=0;for(let a of f)_.set(a,`_h${u++}`);n.push("const counters=frame.counters;"),n.push("const ctx=frame.ctx;"),n.push("const errors=[];"),n.push("let appliedCount=0;"),n.push("let skippedCount=0;");for(let[a,p]of _)n.push(`const ${p}=$.h[${JSON.stringify(a)}];`);x&&n.push("const _hookBefore=$.hooks.beforeDirective;"),m&&n.push("const _hookAfter=$.hooks.afterDirective;");for(let a=0;a<t.length;a++){let p=t[a];switch(p[i]){case "const":case "let":ce(n,p,a);break;case "return":ae(n,p,a,s);break;case "throw":ue(n,p,a,s);break;default:de(n,p,a,s,i,_,x,m,R,v);break}}n.push(`const _finalResult={success:true,aborted:false,appliedCount,skippedCount,errors,processedCount:${s},totalCount:${s},counters};`),D&&n.push(`try{${l}$.hooks.onDirectivesComplete(_finalResult);}catch(_e){}`),n.push("return _finalResult;");let C=n.join(`
+`),A=c?"async ":"";return {fn:new Function("frame","scope","$",`"use strict";
+return(${A}()=>{
+${C}
+})();`),isAsync:c}}function K(t,e,i){return {success:false,aborted:false,appliedCount:0,skippedCount:0,processedCount:0,totalCount:0,errors:[{directiveIndex:-1,error:e}],counters:t,...i}}function U(t,e){return K(e,`Action not found: "${t}"`)}function G(t,e,i){return K(i,`Max depth ${e} exceeded invoking "${t}"`,{aborted:true,abortedBy:"maxDepth"})}function Y(t,e){return K(e,`Action "${t}" is private (sub-action). Can only be invoked from within its parent scope.`)}function le(t){return typeof t=="object"&&t!==null&&"execute"in t}function Q(t){let e=Object.create(null),i=new Map;for(let n of Object.keys(t)){let s=t[n];le(s)?(e[n]=s.execute,i.set(n,s)):(e[n]=s,i.set(n,{execute:s}));}return {handlers:e,definitions:i}}function X(t,e){if(t==="*")return  true;if(!t.includes("*"))return t===e;let i=t.replace(/[.+^${}()|[\]\\]/g,"\\$&");return new RegExp("^"+i.replace(/\*/g,".*")+"$").test(e)}function Z(t){return typeof t=="string"?{pattern:t}:t}function L(t,e,i){let n=new Map;if(!e&&!i){for(let s of t)n.set(s,{status:"available"});return n}if(e){let s=e.map(Z);for(let r of t){let c=s.some(h=>X(h.pattern,r));n.set(r,{status:c?"available":"denied"});}}else {let s=i.map(Z);for(let r of t){let c=s.find(h=>X(h.pattern,r));c?n.set(r,{status:"denied",reason:c.reason,source:c.source}):n.set(r,{status:"available"});}}return n}var ve=8,fe="type",z={maxDepth:10,maxRules:1e4,maxDirectives:1e5},V=class{_directiveExecutor;_mode;_ctx;_requestedMode;_threshold;_limits;_typeField;_handlers;_definitions;_directiveHooks;_directiveAnalysis;_isAsync;_directivePermissions;_registry=new Map;_emitter=new F;_batchDepth=0;_batchErrors=[];_batchWarnings=[];_batchActions=[];_batchRegistered=[];_registeredIds=new Set;_directiveRunner;_engineRef;constructor(e){this._requestedMode=e.mode??"auto",this._threshold=e.autoJitThreshold??ve,this._typeField=e.typeField??fe,this._limits={maxDepth:e.limits?.maxDepth??z.maxDepth,maxRules:e.limits?.maxRules??z.maxRules,maxDirectives:e.limits?.maxDirectives??z.maxDirectives};let{handlers:i,definitions:n}=Q(e.handlers);for(let s of Object.keys(e.handlers))if(S.has(s))throw new Error(`Handler type "${s}" is reserved for engine-internal directives`);if(e.allowedDirectives&&e.blockedDirectives)throw new Error("allowedDirectives and blockedDirectives are mutually exclusive. Provide one or neither.");this._handlers=i,this._definitions=n,this._directivePermissions=L(Object.keys(i),e.allowedDirectives,e.blockedDirectives),this._directiveHooks=e.directiveHooks??{},this._directiveAnalysis=analyzeSlots(this._directiveHooks,DIRECTIVE_SLOT_NAMES),this._isAsync=this._directiveAnalysis.hasAnyAsync,this._engineRef={runDirectives:(s,r)=>this._executeDirectives(s,r),runDirectivesAsync:(s,r)=>this._executeDirectivesAsync(s,r),invoke:(s,r,c)=>this._invokeInternal(s,r,c),invokeAsync:(s,r,c)=>this._invokeInternalAsync(s,r,c),evaluateRules:()=>{throw new Error("evaluateRules() not available in ActionEngine context. Use createRuleEngine().")},evaluateRulesAsync:()=>{throw new Error("evaluateRulesAsync() not available in ActionEngine context. Use createRuleEngine().")}},this._directiveRunner=(s,r)=>this._directiveExecutor(s,r,this._handlers,this._directiveHooks,this._typeField,this._engineRef,this._limits.maxDirectives),this._requestedMode==="jit"?(this._directiveExecutor=this._buildJitDirectiveExecutor(),this._mode="jit"):(this._directiveExecutor=B(this._directiveAnalysis,this._isAsync),this._mode="interpret");}register(e){let i=[],n=[],s=[],r=[];for(let h of e){if(!h.id){n.push({actionId:"",error:"Action must have an id"});continue}let x=W(h,this._handlers,this._definitions,this._typeField);if(x.length>0){for(let m of x)n.push({actionId:h.id,error:m});continue}r.push(h);}for(let h of r){let x=H(h.directives,this._typeField),m={definition:h,directives:x,compiled:null,invokeCount:0};this._requestedMode==="jit"&&(m.compiled=this._compileAction(x)),this._registry.set(h.id,m),this._registeredIds.add(h.id),i.push(h.id);}if(this._batchDepth>0){this._batchErrors.push(...n),this._batchWarnings.push(...s);for(let h of r)this._batchActions.push(h);return this._batchRegistered.push(...i),{registered:i,errors:n,warnings:s}}let c={registered:i,errors:n,warnings:s};return i.length>0&&this._emitter.emit("register",{actions:r,result:c,registered:i}),c}unregister(e){let i=this._registry.delete(e);i&&this._registeredIds.delete(e);let n=e+"/",s=[];for(let r of this._registry.keys())r.startsWith(n)&&(this._registry.delete(r),this._registeredIds.delete(r),s.push(r));return i&&this._emitter.emit("unregister",{id:e,cascaded:s}),i}invoke(e,i){if(this._isAsync)throw new Error("Cannot call invoke() with async hooks. Use invokeAsync() instead.");let n=this._requireCtx(),s=createRootFrame(n,this._limits);return this._invokeInternal(e,i,s)}async invokeAsync(e,i){let n=this._requireCtx(),s=createRootFrame(n,this._limits);return this._invokeInternalAsync(e,i,s)}setContext(e){this._ctx=e;}context(e,i){let n=this._ctx;this._ctx=e;try{return i()}finally{this._ctx=n;}}beginBatch(){this._batchDepth++,this._batchDepth===1&&(this._batchErrors=[],this._batchWarnings=[],this._batchActions=[],this._batchRegistered=[]);}endBatch(){if(this._batchDepth<=0)throw new Error("endBatch() called without matching beginBatch()");if(this._batchDepth--,this._batchDepth>0)return {registered:[],errors:[],warnings:[]};let e={registered:this._batchRegistered,errors:this._batchErrors,warnings:this._batchWarnings};return this._batchRegistered.length>0&&this._emitter.emit("register",{actions:this._batchActions,result:e,registered:this._batchRegistered}),e}on(e,i){return this._emitter.on(e,i)}get handlerDefinitions(){return this._definitions}get registeredIds(){return this._registeredIds}getActionDefinition(e){return this._registry.get(e)?.definition}get typeField(){return this._typeField}get directivePermissions(){return this._directivePermissions}get isAsync(){return this._isAsync}get compilationMode(){return this._mode}get directiveHookSlots(){return this._directiveAnalysis.filledNames}get asyncSlots(){return this._directiveAnalysis.asyncNames}compile(){if(this._requestedMode!=="interpret"){this._mode!=="jit"&&this._promote();for(let e of this._registry.values())e.compiled||(e.compiled=this._compileAction(e.directives));}}_invokeInternal(e,i,n){let s=this._prepareInvoke(e,i,n);if("success"in s)return s;let{stored:r,childFrame:c,childScope:h}=s;if(r.compiled)return r.compiled.fn(c,h,r.compiled.$);let x=this._directiveRunner(r.directives,c);return this._maybeAutoPromote(r),x}async _invokeInternalAsync(e,i,n){let s=this._prepareInvoke(e,i,n);if("success"in s)return s;let{stored:r,childFrame:c,childScope:h}=s;if(r.compiled)return r.compiled.fn(c,h,r.compiled.$);let x=this._directiveRunner(r.directives,c);return this._maybeAutoPromote(r),x}_prepareInvoke(e,i,n){let s=this._registry.get(e);if(!s)return U(e,n.counters);if(e.includes("/")&&!this._isAccessible(e,n))return Y(e,n.counters);if(n.depth>=n.limits.maxDepth)return G(e,n.limits.maxDepth,n.counters);let r=Object.create(n.scope);i&&Object.assign(r,i);let c=n.child("action:"+e,0,e).withScope(r);return {stored:s,childFrame:c,childScope:r}}_maybeAutoPromote(e){this._requestedMode==="auto"&&++e.invokeCount>=this._threshold&&(e.compiled=this._compileAction(e.directives),this._mode!=="jit"&&this._promote());}_executeDirectives(e,i){return this._directiveExecutor(e,i,this._handlers,this._directiveHooks,this._typeField,this._engineRef,this._limits.maxDirectives)}async _executeDirectivesAsync(e,i){return this._directiveExecutor(e,i,this._handlers,this._directiveHooks,this._typeField,this._engineRef,this._limits.maxDirectives)}_compileAction(e){let{fn:i}=O(e,this._directiveAnalysis,this._typeField),n={d:e,h:this._handlers,hooks:this._directiveHooks,engine:this._engineRef,runner:this._directiveRunner};return {fn:i,$:n}}_isAccessible(e,i){let s="action:"+e.slice(0,e.lastIndexOf("/"));return i.path.includes(s)}_requireCtx(){if(this._ctx===void 0)throw new Error("No context set. Call setContext(ctx) or use context(ctx, fn) before invoke.");return this._ctx}_promote(){this._directiveExecutor=this._buildJitDirectiveExecutor(),this._mode="jit";}_buildJitDirectiveExecutor(){let{fn:e}=j(this._directiveAnalysis);return e}};function _e(t){return new V(t)}export{S as RESERVED_TYPES,F as SimpleEmitter,O as buildActionExecutor,j as buildDirectiveExecutor,_e as createActionEngine,B as createDirectiveInterpreter,H as normalizeDirectives};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@statedelta-actions/actions",
+  "version": "0.1.0",
+  "description": "Directive execution engine with JIT compilation and BailHook interception",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@statedelta-actions/core": "0.1.0"
+  },
+  "author": "Anderson D. Rosa <andersondrosa@outlook.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andersondrosa/statedelta-actions.git",
+    "directory": "packages/actions"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}