@smthrs/plugin 1.0.0-rc.6 → 1.0.0-rc.8

package/README.md

@@ -12,7 +12,9 @@ A typed, bounded plugin kernel for Effect programs: Vite's plugin model, with
 hooks that are ordinary Effects, ordering that follows Vite's rules exactly, and
 a resolution boundary that copies every value a caller hands it.
 
-Not on npm yet; see [Installation](https://github.com/smithersai/smithers/blob/main/packages/smithers/flows/flow/docs/installation.md#use-the-libraries).
+```bash
+npm install @smthrs/plugin@next effect
+```
 
 ```ts
 import { type FlowsPlugin, Kernel } from "@smthrs/plugin"

package/dist/cjs/Resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Resolve.d.ts","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Resolve.d.ts","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"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"}

package/dist/cjs/Resolve.js

@@ -228,18 +228,18 @@ const flatten = (input) => {
   }
   return output;
 };
-const included = (plugin, config, target) => {
+const included = ({ path, plugin }, config, target) => {
   const apply = plugin.apply;
   if (apply === void 0) return Effect.succeed(true);
   if (typeof apply !== "function") return Effect.succeed(apply === target);
   return Effect.try({
     try: () => apply(config),
-    catch: () => failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, "$.apply", {
+    catch: () => failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, `${path}.apply`, {
       plugin: plugin.name
     })
   }).pipe(
     Effect.flatMap(
-      (result) => typeof result === "boolean" ? Effect.succeed(result) : Effect.fail(invalidPlugin("$.apply", "predicate must return a boolean", { plugin: plugin.name }))
+      (result) => typeof result === "boolean" ? Effect.succeed(result) : Effect.fail(invalidPlugin(`${path}.apply`, "predicate must return a boolean", { plugin: plugin.name }))
     )
   );
 };
@@ -276,7 +276,7 @@ const resolve = (input, options = {}, configOverride) => Effect.gen(function* ()
     catch: (cause) => cause instanceof import_PluginError.PluginError ? cause : invalidPlugin("$", "could not be inspected without executing user code")
   });
   const target = raw.target ?? "engine";
-  const selected = yield* Effect.filter(admitted, ({ plugin }) => included(plugin, config, target));
+  const selected = yield* Effect.filter(admitted, (entry) => included(entry, config, target));
   let handlerCount = 0;
   for (const { path, plugin } of selected) {
     const pluginHooks = plugin.hooks;
@@ -301,20 +301,21 @@ const resolve = (input, options = {}, configOverride) => Effect.gen(function* ()
     }
   }
   const seen = /* @__PURE__ */ new Set();
-  for (const { plugin } of selected) {
+  for (const { path, plugin } of selected) {
     if (seen.has(plugin.name)) {
       return yield* Effect.fail(failure(
         "duplicate_name",
         `duplicate plugin name "${plugin.name}"`,
-        "$.name",
+        `${path}.name`,
         { plugin: plugin.name }
       ));
     }
     seen.add(plugin.name);
   }
-  const plugins = Object.freeze(
-    selected.map(({ plugin }, index) => ({ plugin, index })).sort((left, right) => rank(left.plugin.enforce) - rank(right.plugin.enforce) || left.index - right.index).map(({ plugin }) => plugin)
-  );
+  const orderedEntries = selected.map((entry, index) => ({ entry, index })).sort(
+    (left, right) => rank(left.entry.plugin.enforce) - rank(right.entry.plugin.enforce) || left.index - right.index
+  ).map(({ entry }) => entry);
+  const plugins = Object.freeze(orderedEntries.map(({ plugin }) => plugin));
   const entries = [];
   for (const hook of Object.keys(known)) {
     const records = [];
@@ -330,7 +331,7 @@ const resolve = (input, options = {}, configOverride) => Effect.gen(function* ()
     ).map(({ record }) => record);
     if (ordered.length > 0) entries.push([hook, Object.freeze(ordered)]);
   }
-  const cacheEnvironment = yield* (0, import_snapshotCacheEnvironment.snapshotCacheEnvironment)(raw.cacheEnvironment, plugins);
+  const cacheEnvironment = yield* (0, import_snapshotCacheEnvironment.snapshotCacheEnvironment)(raw.cacheEnvironment, orderedEntries);
   return Object.freeze({
     plugins,
     handlers: ImmutableMap.make(entries),

package/dist/cjs/Resolve.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/Resolve.ts"],
-  "sourcesContent": ["/**\n * Bounded plugin resolution: admit, filter, validate, order, and snapshot.\n *\n * The resulting catalog owns every record it exposes. Dispatch never reads a\n * caller-owned map, plugin record, hook object, config value, or cache identity.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as ImmutableMap from \"@smthrs/canonical/ReadonlyMap\"\nimport type { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport type { FlowsConfig } from \"./Config.ts\"\nimport * as Config from \"./Config.ts\"\nimport type { HookCatalog, HookKind, HookObject } from \"./Hooks.ts\"\nimport { engineHooks, handlerOf, orderOf } from \"./Hooks.ts\"\nimport type { FlowsHooks } from \"./index.ts\"\nimport * as Boundary from \"./internal/Boundary.ts\"\nimport { mergePluginLayers } from \"./internal/mergePluginLayers.ts\"\nimport { snapshotCacheEnvironment } from \"./internal/snapshotCacheEnvironment.ts\"\nimport type { Apply, FlowsPlugin, PluginInput } from \"./Plugin.ts\"\nimport { PluginError, type PluginErrorCode } from \"./PluginError.ts\"\n\n/**\n * Maximum nested preset-array depth accepted at startup.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginDepth = 64\n\n/**\n * Maximum plugins accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPlugins = 256\n\n/**\n * Maximum aggregate hook handlers accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumHandlers = 1_024\n\n/**\n * Maximum input nodes, including arrays and omitted entries.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginInputNodes = 4_096\n\n/**\n * Maximum UTF-16 length of one plugin or hook name.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginNameLength = 256\n\n/**\n * Default fiber bound for parallel observers.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const defaultParallelConcurrency = 16\n\n/**\n * Maximum configurable parallel-observer bound.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumParallelConcurrency = 256\n\n/**\n * One resolved handler with immutable attribution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface HandlerRecord {\n  readonly plugin: string\n  readonly hook: string\n  readonly handler: (...args: Array<any>) => unknown\n}\n\n/**\n * The immutable output of plugin resolution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Resolved<H = FlowsHooks> {\n  readonly plugins: ReadonlyArray<FlowsPlugin<H>>\n  readonly handlers: ReadonlyMap<string, ReadonlyArray<HandlerRecord>>\n  /** The frozen runtime catalog this resolution admitted. Dispatch refuses a method whose kind differs from it. */\n  readonly kinds: Readonly<Record<string, HookKind>>\n  readonly parallelConcurrency: number\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n}\n\n/**\n * Options for {@link resolve}.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Options<H = FlowsHooks> {\n  /** Pre-resolution config tested by `apply` predicates. */\n  readonly config?: FlowsConfig | undefined\n  /** Host whose literal `apply` selectors are active. Defaults to `\"engine\"`. */\n  readonly target?: \"engine\" | \"harness\" | undefined\n  /**\n   * Hook names recognized by this host, each with the kind `H` declares for\n   * it. The shared `config` and `configResolved` hooks are fixed to\n   * `waterfall` and `parallel`; another kind fails with `hook_kind_mismatch`.\n   */\n  readonly hooks?: HookCatalog<H> | undefined\n  /** Complete composition identity for sealed activity keys. Requires every selected plugin to have a version. */\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n  /** Maximum observers run at once. Defaults to 16 and cannot exceed 256. */\n  readonly parallelConcurrency?: number | undefined\n}\n\ninterface RawOptions {\n  readonly config: unknown\n  readonly target: unknown\n  readonly hooks: unknown\n  readonly cacheEnvironment: unknown\n  readonly parallelConcurrency: unknown\n}\n\nconst failure = (\n  code: PluginErrorCode,\n  message: string,\n  path: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => new PluginError({ code, message, path, ...fields })\n\nconst invalidPlugin = (\n  path: string,\n  complaint: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => failure(\"invalid_plugin\", `plugin input ${complaint}`, path, fields)\n\n// Bound before quoting or scanning caller-controlled keys. Keep Boundary's\n// identifier/dot and JSON-quoted/bracket path convention.\nconst diagnosticKey = (key: string): string => key.length > 64 ? `${key.slice(0, 64)}...` : key\n\nconst childPath = (path: string, key: string): string => {\n  const bounded = diagnosticKey(key)\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bounded) ? `${path}.${bounded}` : `${path}[${JSON.stringify(bounded)}]`\n}\n\nconst ownData = (\n  input: unknown,\n  path: string,\n  allowed?: ReadonlySet<string>\n): Readonly<Record<string, unknown>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(path, \"must be an ordinary record\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) throw invalidPlugin(path, \"must be an ordinary record\")\n  const output: Record<string, unknown> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\") throw invalidPlugin(path, \"must not contain symbol keys\")\n    if (allowed !== undefined && !allowed.has(key)) {\n      throw invalidPlugin(childPath(path, key), \"contains an unknown property\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(path, key), \"must be an enumerable data property\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  return output\n}\n\nconst snapshotOptions = (input: unknown): RawOptions => {\n  const values = ownData(\n    input,\n    \"$options\",\n    new Set([\"config\", \"target\", \"hooks\", \"cacheEnvironment\", \"parallelConcurrency\"])\n  )\n  return {\n    config: values.config,\n    target: values.target,\n    hooks: values.hooks,\n    cacheEnvironment: values.cacheEnvironment,\n    parallelConcurrency: values.parallelConcurrency\n  }\n}\n\nconst validName = (value: unknown): value is string =>\n  typeof value === \"string\" && value.length > 0 && value.length <= maximumPluginNameLength &&\n  Boundary.isWellFormedText(value) && !/^\\s*$/u.test(value) && !/\\p{Cc}/u.test(value)\n\nconst snapshotCatalog = (input: unknown): Readonly<Record<string, HookKind>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const output: Record<string, HookKind> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\" || !validName(key)) {\n      throw invalidPlugin(\"$options.hooks\", \"contains an invalid hook name\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"must be an enumerable data property\")\n    }\n    if (!([\"sequential\", \"parallel\", \"first\", \"waterfall\"] as ReadonlyArray<unknown>).includes(descriptor.value)) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"contains an invalid hook kind\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  for (const hook of Object.keys(engineHooks) as ReadonlyArray<keyof typeof engineHooks>) {\n    if (Object.hasOwn(output, hook) && output[hook] !== engineHooks[hook]) {\n      throw failure(\n        \"hook_kind_mismatch\",\n        `hook catalog declares shared hook ${JSON.stringify(hook)} as ${\n          JSON.stringify(output[hook])\n        }, the kernel dispatches it as ${JSON.stringify(engineHooks[hook])}`,\n        childPath(\"$options.hooks\", hook),\n        { hook }\n      )\n    }\n  }\n  return Object.freeze(output)\n}\n\nconst snapshotHook = (\n  entry: unknown,\n  path: string,\n  plugin: string,\n  hook: string\n): ((...args: Array<any>) => unknown) | HookObject<(...args: Array<any>) => unknown> => {\n  if (typeof entry === \"function\") return entry as (...args: Array<any>) => unknown\n  if (entry === undefined) {\n    throw invalidPlugin(path, \"must be a function or a hook object\", { plugin, hook })\n  }\n  const values = ownData(entry, path, new Set([\"order\", \"handler\"]))\n  if (typeof values.handler !== \"function\") {\n    throw invalidPlugin(`${path}.handler`, \"must be a function\", { plugin, hook })\n  }\n  if (values.order !== undefined && values.order !== \"pre\" && values.order !== \"post\") {\n    throw invalidPlugin(`${path}.order`, \"must be pre or post\", { plugin, hook })\n  }\n  return Object.freeze({\n    ...(values.order === undefined ? {} : { order: values.order }),\n    handler: values.handler\n  }) as HookObject<(...args: Array<any>) => unknown>\n}\n\nconst snapshotPlugin = <H>(\n  input: unknown,\n  path: string\n): FlowsPlugin<H> => {\n  const values = ownData(input, path, new Set([\"name\", \"version\", \"enforce\", \"apply\", \"layer\", \"hooks\"]))\n  if (!validName(values.name)) throw invalidPlugin(`${path}.name`, \"requires a bounded non-empty name\")\n  const name = values.name\n  if (values.version !== undefined && !validName(values.version)) {\n    throw invalidPlugin(`${path}.version`, \"requires a bounded non-empty version\", { plugin: name })\n  }\n  if (values.enforce !== undefined && values.enforce !== \"pre\" && values.enforce !== \"post\") {\n    throw invalidPlugin(`${path}.enforce`, \"must be pre or post\", { plugin: name })\n  }\n  if (\n    values.apply !== undefined && values.apply !== \"engine\" && values.apply !== \"harness\" &&\n    typeof values.apply !== \"function\"\n  ) throw invalidPlugin(`${path}.apply`, \"must be engine, harness, or a predicate\", { plugin: name })\n  if (values.layer !== undefined && !Layer.isLayer(values.layer)) {\n    throw invalidPlugin(`${path}.layer`, \"must be an Effect Layer\", { plugin: name })\n  }\n\n  let hooks: Readonly<Record<string, unknown>> | undefined\n  if (values.hooks !== undefined) {\n    const rawHooks = ownData(values.hooks, `${path}.hooks`)\n    const snapshot: Record<string, unknown> = Object.create(null)\n    for (const [index, hook] of Object.keys(rawHooks).entries()) {\n      if (!validName(hook)) {\n        throw invalidPlugin(`${path}.hooks[${index}]`, \"contains an invalid hook name\")\n      }\n      const entry = rawHooks[hook]\n      Object.defineProperty(snapshot, hook, {\n        value: snapshotHook(entry, childPath(`${path}.hooks`, hook), name, hook),\n        enumerable: true\n      })\n    }\n    hooks = Object.freeze(snapshot)\n  }\n\n  return Object.freeze({\n    name,\n    ...(values.version === undefined ? {} : { version: values.version }),\n    ...(values.enforce === undefined ? {} : { enforce: values.enforce }),\n    ...(values.apply === undefined ? {} : { apply: values.apply as Apply }),\n    ...(values.layer === undefined ? {} : { layer: values.layer as Layer.Layer<never, any, any> }),\n    ...(hooks === undefined ? {} : { hooks: hooks as Partial<H> })\n  })\n}\n\ninterface AdmittedPlugin<H> {\n  readonly plugin: FlowsPlugin<H>\n  readonly path: string\n}\n\nconst flatten = <H>(input: unknown): ReadonlyArray<AdmittedPlugin<H>> => {\n  const output: Array<AdmittedPlugin<H>> = []\n  const arrays = new WeakSet<object>()\n  const stack: Array<{ readonly value: unknown; readonly path: string; readonly depth: number }> = [\n    { value: input, path: \"$\", depth: 0 }\n  ]\n  let nodes = 0\n  while (stack.length > 0) {\n    const current = stack.pop()!\n    nodes += 1\n    if (current.value === false || current.value === null || current.value === undefined) continue\n    if (Array.isArray(current.value)) {\n      if (current.depth >= maximumPluginDepth) {\n        throw failure(\"resource_limit\", `plugin input exceeds the depth limit of ${maximumPluginDepth}`, current.path)\n      }\n      if (arrays.has(current.value)) throw invalidPlugin(current.path, \"contains a cycle or repeated preset array\")\n      arrays.add(current.value)\n      const length = current.value.length\n      // Every queued frame and array element costs a node, including omitted\n      // entries. Refuse before enumerating keys, descriptors, or child frames.\n      if (length > maximumPluginInputNodes - nodes - stack.length) {\n        throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPluginInputNodes}-node limit`, current.path)\n      }\n      const keys = Reflect.ownKeys(current.value)\n      if (keys.length !== length + 1 || !keys.includes(\"length\")) {\n        throw invalidPlugin(current.path, \"must be a dense preset array with no extra properties\")\n      }\n      for (let index = length - 1; index >= 0; index--) {\n        const descriptor = Object.getOwnPropertyDescriptor(current.value, String(index))\n        if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n          throw invalidPlugin(`${current.path}[${index}]`, \"must be an enumerable data property\")\n        }\n        stack.push({ value: descriptor.value, path: `${current.path}[${index}]`, depth: current.depth + 1 })\n      }\n      continue\n    }\n    output.push(Object.freeze({ plugin: snapshotPlugin<H>(current.value, current.path), path: current.path }))\n    if (output.length > maximumPlugins) {\n      throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPlugins}-plugin limit`, current.path)\n    }\n  }\n  return output\n}\n\nconst included = <H>(\n  plugin: FlowsPlugin<H>,\n  config: FlowsConfig,\n  target: \"engine\" | \"harness\"\n): Effect.Effect<boolean, PluginError> => {\n  const apply = plugin.apply\n  if (apply === undefined) return Effect.succeed(true)\n  if (typeof apply !== \"function\") return Effect.succeed(apply === target)\n  return Effect.try({\n    try: () => apply(config),\n    catch: () =>\n      failure(\"apply_failed\", `plugin \"${plugin.name}\" apply predicate failed`, \"$.apply\", {\n        plugin: plugin.name\n      })\n  }).pipe(\n    Effect.flatMap((result) =>\n      typeof result === \"boolean\"\n        ? Effect.succeed(result)\n        : Effect.fail(invalidPlugin(\"$.apply\", \"predicate must return a boolean\", { plugin: plugin.name }))\n    )\n  )\n}\n\nconst rank = (enforce: \"pre\" | \"post\" | undefined): number => (enforce === \"pre\" ? 0 : enforce === \"post\" ? 2 : 1)\n\n/**\n * Resolves a plugin preset into an immutable, resource-bounded catalog.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const resolve = <H = FlowsHooks>(\n  input: PluginInput<NoInfer<H>>,\n  options: Options<NoInfer<H>> = {},\n  configOverride?: FlowsConfig\n): Effect.Effect<Resolved<H>, PluginError> =>\n  Effect.gen(function*() {\n    const raw = yield* Effect.try({\n      try: () => snapshotOptions(options),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options\", \"could not be inspected without executing user code\")\n    })\n    if (configOverride !== undefined && raw.config !== undefined) {\n      return yield* Effect.fail(invalidPlugin(\n        \"$options.config\",\n        \"cannot declare config in options alongside the positional override\"\n      ))\n    }\n    if (raw.target !== undefined && raw.target !== \"engine\" && raw.target !== \"harness\") {\n      return yield* Effect.fail(invalidPlugin(\"$options.target\", \"must be engine or harness\"))\n    }\n    if (\n      raw.parallelConcurrency !== undefined &&\n      (typeof raw.parallelConcurrency !== \"number\" || !Number.isSafeInteger(raw.parallelConcurrency) ||\n        raw.parallelConcurrency <= 0 ||\n        raw.parallelConcurrency > maximumParallelConcurrency)\n    ) {\n      return yield* Effect.fail(failure(\n        \"resource_limit\",\n        `parallel concurrency must be between 1 and ${maximumParallelConcurrency}`,\n        \"$options.parallelConcurrency\"\n      ))\n    }\n    const parallelConcurrency = raw.parallelConcurrency === undefined\n      ? defaultParallelConcurrency\n      : raw.parallelConcurrency\n    const config = yield* Config.snapshot(configOverride ?? raw.config ?? {})\n    const known = yield* Effect.try({\n      try: () => snapshotCatalog(raw.hooks ?? engineHooks),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options.hooks\", \"could not be inspected without executing user code\")\n    })\n    const admitted = yield* Effect.try({\n      try: () => flatten<H>(input),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$\", \"could not be inspected without executing user code\")\n    })\n    const target = raw.target ?? \"engine\"\n    const selected = yield* Effect.filter(admitted, ({ plugin }) => included(plugin, config, target))\n\n    let handlerCount = 0\n    for (const { path, plugin } of selected) {\n      const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n      if (pluginHooks === undefined) continue\n      for (const hook of Object.keys(pluginHooks)) {\n        if (!Object.hasOwn(known, hook)) {\n          return yield* Effect.fail(failure(\n            \"unknown_hook\",\n            `plugin ${JSON.stringify(plugin.name)} declares unknown hook ${JSON.stringify(diagnosticKey(hook))}`,\n            childPath(`${path}.hooks`, hook),\n            { plugin: plugin.name, hook }\n          ))\n        }\n        handlerCount += 1\n        if (handlerCount > maximumHandlers) {\n          return yield* Effect.fail(failure(\n            \"resource_limit\",\n            `plugin handlers exceed the limit of ${maximumHandlers}`,\n            childPath(`${path}.hooks`, hook)\n          ))\n        }\n      }\n    }\n\n    const seen = new Set<string>()\n    for (const { plugin } of selected) {\n      if (seen.has(plugin.name)) {\n        return yield* Effect.fail(failure(\n          \"duplicate_name\",\n          `duplicate plugin name \"${plugin.name}\"`,\n          \"$.name\",\n          { plugin: plugin.name }\n        ))\n      }\n      seen.add(plugin.name)\n    }\n\n    const plugins = Object.freeze(\n      selected\n        .map(({ plugin }, index) => ({ plugin, index }))\n        .sort((left, right) => rank(left.plugin.enforce) - rank(right.plugin.enforce) || left.index - right.index)\n        .map(({ plugin }) => plugin)\n    )\n    const entries: Array<readonly [string, ReadonlyArray<HandlerRecord>]> = []\n    for (const hook of Object.keys(known)) {\n      const records: Array<{\n        readonly record: HandlerRecord\n        readonly enforceRank: number\n        readonly orderRank: number\n        readonly index: number\n      }> = []\n      for (const [index, plugin] of plugins.entries()) {\n        const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n        if (pluginHooks === undefined || !Object.hasOwn(pluginHooks, hook)) continue\n        const entry = pluginHooks[hook]\n        const record = Object.freeze({ plugin: plugin.name, hook, handler: handlerOf(entry) })\n        records.push({ record, enforceRank: rank(plugin.enforce), orderRank: rank(orderOf(entry)), index })\n      }\n      // Vite's rule, verbatim: the per-hook `order` is the outer partition and\n      // the enforce-sorted plugin list supplies the stable order inside it, so a\n      // hook marked `order: \"pre\"` runs ahead of every normal-order handler even\n      // when its plugin is `enforce: \"post\"`.\n      const ordered = records\n        .sort((left, right) =>\n          left.orderRank - right.orderRank || left.enforceRank - right.enforceRank || left.index - right.index\n        )\n        .map(({ record }) => record)\n      if (ordered.length > 0) entries.push([hook, Object.freeze(ordered)])\n    }\n    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, plugins)\n    return Object.freeze({\n      plugins,\n      handlers: ImmutableMap.make(entries),\n      kinds: known,\n      parallelConcurrency,\n      ...(cacheEnvironment === undefined ? {} : { cacheEnvironment })\n    })\n  })\n\n/**\n * Merges every resolved plugin layer left-to-right and supplies the detached\n * cache environment captured during resolution.\n *\n * @category combinators\n * @since 1.0.0-rc.0\n */\nexport const layer = <H>(resolved: Resolved<H>): Layer.Layer<any, PluginError, any> =>\n  mergePluginLayers(resolved.plugins, resolved.cacheEnvironment)\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Bounded plugin resolution: admit, filter, validate, order, and snapshot.\n *\n * The resulting catalog owns every record it exposes. Dispatch never reads a\n * caller-owned map, plugin record, hook object, config value, or cache identity.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as ImmutableMap from \"@smthrs/canonical/ReadonlyMap\"\nimport type { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport type { FlowsConfig } from \"./Config.ts\"\nimport * as Config from \"./Config.ts\"\nimport type { HookCatalog, HookKind, HookObject } from \"./Hooks.ts\"\nimport { engineHooks, handlerOf, orderOf } from \"./Hooks.ts\"\nimport type { FlowsHooks } from \"./index.ts\"\nimport * as Boundary from \"./internal/Boundary.ts\"\nimport { mergePluginLayers } from \"./internal/mergePluginLayers.ts\"\nimport { snapshotCacheEnvironment } from \"./internal/snapshotCacheEnvironment.ts\"\nimport type { Apply, FlowsPlugin, PluginInput } from \"./Plugin.ts\"\nimport { PluginError, type PluginErrorCode } from \"./PluginError.ts\"\n\n/**\n * Maximum nested preset-array depth accepted at startup.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginDepth = 64\n\n/**\n * Maximum plugins accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPlugins = 256\n\n/**\n * Maximum aggregate hook handlers accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumHandlers = 1_024\n\n/**\n * Maximum input nodes, including arrays and omitted entries.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginInputNodes = 4_096\n\n/**\n * Maximum UTF-16 length of one plugin or hook name.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginNameLength = 256\n\n/**\n * Default fiber bound for parallel observers.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const defaultParallelConcurrency = 16\n\n/**\n * Maximum configurable parallel-observer bound.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumParallelConcurrency = 256\n\n/**\n * One resolved handler with immutable attribution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface HandlerRecord {\n  readonly plugin: string\n  readonly hook: string\n  readonly handler: (...args: Array<any>) => unknown\n}\n\n/**\n * The immutable output of plugin resolution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Resolved<H = FlowsHooks> {\n  readonly plugins: ReadonlyArray<FlowsPlugin<H>>\n  readonly handlers: ReadonlyMap<string, ReadonlyArray<HandlerRecord>>\n  /** The frozen runtime catalog this resolution admitted. Dispatch refuses a method whose kind differs from it. */\n  readonly kinds: Readonly<Record<string, HookKind>>\n  readonly parallelConcurrency: number\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n}\n\n/**\n * Options for {@link resolve}.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Options<H = FlowsHooks> {\n  /** Pre-resolution config tested by `apply` predicates. */\n  readonly config?: FlowsConfig | undefined\n  /** Host whose literal `apply` selectors are active. Defaults to `\"engine\"`. */\n  readonly target?: \"engine\" | \"harness\" | undefined\n  /**\n   * Hook names recognized by this host, each with the kind `H` declares for\n   * it. The shared `config` and `configResolved` hooks are fixed to\n   * `waterfall` and `parallel`; another kind fails with `hook_kind_mismatch`.\n   */\n  readonly hooks?: HookCatalog<H> | undefined\n  /** Complete composition identity for sealed activity keys. Requires every selected plugin to have a version. */\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n  /** Maximum observers run at once. Defaults to 16 and cannot exceed 256. */\n  readonly parallelConcurrency?: number | undefined\n}\n\ninterface RawOptions {\n  readonly config: unknown\n  readonly target: unknown\n  readonly hooks: unknown\n  readonly cacheEnvironment: unknown\n  readonly parallelConcurrency: unknown\n}\n\nconst failure = (\n  code: PluginErrorCode,\n  message: string,\n  path: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => new PluginError({ code, message, path, ...fields })\n\nconst invalidPlugin = (\n  path: string,\n  complaint: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => failure(\"invalid_plugin\", `plugin input ${complaint}`, path, fields)\n\n// Bound before quoting or scanning caller-controlled keys. Keep Boundary's\n// identifier/dot and JSON-quoted/bracket path convention.\nconst diagnosticKey = (key: string): string => key.length > 64 ? `${key.slice(0, 64)}...` : key\n\nconst childPath = (path: string, key: string): string => {\n  const bounded = diagnosticKey(key)\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bounded) ? `${path}.${bounded}` : `${path}[${JSON.stringify(bounded)}]`\n}\n\nconst ownData = (\n  input: unknown,\n  path: string,\n  allowed?: ReadonlySet<string>\n): Readonly<Record<string, unknown>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(path, \"must be an ordinary record\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) throw invalidPlugin(path, \"must be an ordinary record\")\n  const output: Record<string, unknown> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\") throw invalidPlugin(path, \"must not contain symbol keys\")\n    if (allowed !== undefined && !allowed.has(key)) {\n      throw invalidPlugin(childPath(path, key), \"contains an unknown property\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(path, key), \"must be an enumerable data property\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  return output\n}\n\nconst snapshotOptions = (input: unknown): RawOptions => {\n  const values = ownData(\n    input,\n    \"$options\",\n    new Set([\"config\", \"target\", \"hooks\", \"cacheEnvironment\", \"parallelConcurrency\"])\n  )\n  return {\n    config: values.config,\n    target: values.target,\n    hooks: values.hooks,\n    cacheEnvironment: values.cacheEnvironment,\n    parallelConcurrency: values.parallelConcurrency\n  }\n}\n\nconst validName = (value: unknown): value is string =>\n  typeof value === \"string\" && value.length > 0 && value.length <= maximumPluginNameLength &&\n  Boundary.isWellFormedText(value) && !/^\\s*$/u.test(value) && !/\\p{Cc}/u.test(value)\n\nconst snapshotCatalog = (input: unknown): Readonly<Record<string, HookKind>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const output: Record<string, HookKind> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\" || !validName(key)) {\n      throw invalidPlugin(\"$options.hooks\", \"contains an invalid hook name\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"must be an enumerable data property\")\n    }\n    if (!([\"sequential\", \"parallel\", \"first\", \"waterfall\"] as ReadonlyArray<unknown>).includes(descriptor.value)) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"contains an invalid hook kind\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  for (const hook of Object.keys(engineHooks) as ReadonlyArray<keyof typeof engineHooks>) {\n    if (Object.hasOwn(output, hook) && output[hook] !== engineHooks[hook]) {\n      throw failure(\n        \"hook_kind_mismatch\",\n        `hook catalog declares shared hook ${JSON.stringify(hook)} as ${\n          JSON.stringify(output[hook])\n        }, the kernel dispatches it as ${JSON.stringify(engineHooks[hook])}`,\n        childPath(\"$options.hooks\", hook),\n        { hook }\n      )\n    }\n  }\n  return Object.freeze(output)\n}\n\nconst snapshotHook = (\n  entry: unknown,\n  path: string,\n  plugin: string,\n  hook: string\n): ((...args: Array<any>) => unknown) | HookObject<(...args: Array<any>) => unknown> => {\n  if (typeof entry === \"function\") return entry as (...args: Array<any>) => unknown\n  if (entry === undefined) {\n    throw invalidPlugin(path, \"must be a function or a hook object\", { plugin, hook })\n  }\n  const values = ownData(entry, path, new Set([\"order\", \"handler\"]))\n  if (typeof values.handler !== \"function\") {\n    throw invalidPlugin(`${path}.handler`, \"must be a function\", { plugin, hook })\n  }\n  if (values.order !== undefined && values.order !== \"pre\" && values.order !== \"post\") {\n    throw invalidPlugin(`${path}.order`, \"must be pre or post\", { plugin, hook })\n  }\n  return Object.freeze({\n    ...(values.order === undefined ? {} : { order: values.order }),\n    handler: values.handler\n  }) as HookObject<(...args: Array<any>) => unknown>\n}\n\nconst snapshotPlugin = <H>(\n  input: unknown,\n  path: string\n): FlowsPlugin<H> => {\n  const values = ownData(input, path, new Set([\"name\", \"version\", \"enforce\", \"apply\", \"layer\", \"hooks\"]))\n  if (!validName(values.name)) throw invalidPlugin(`${path}.name`, \"requires a bounded non-empty name\")\n  const name = values.name\n  if (values.version !== undefined && !validName(values.version)) {\n    throw invalidPlugin(`${path}.version`, \"requires a bounded non-empty version\", { plugin: name })\n  }\n  if (values.enforce !== undefined && values.enforce !== \"pre\" && values.enforce !== \"post\") {\n    throw invalidPlugin(`${path}.enforce`, \"must be pre or post\", { plugin: name })\n  }\n  if (\n    values.apply !== undefined && values.apply !== \"engine\" && values.apply !== \"harness\" &&\n    typeof values.apply !== \"function\"\n  ) throw invalidPlugin(`${path}.apply`, \"must be engine, harness, or a predicate\", { plugin: name })\n  if (values.layer !== undefined && !Layer.isLayer(values.layer)) {\n    throw invalidPlugin(`${path}.layer`, \"must be an Effect Layer\", { plugin: name })\n  }\n\n  let hooks: Readonly<Record<string, unknown>> | undefined\n  if (values.hooks !== undefined) {\n    const rawHooks = ownData(values.hooks, `${path}.hooks`)\n    const snapshot: Record<string, unknown> = Object.create(null)\n    for (const [index, hook] of Object.keys(rawHooks).entries()) {\n      if (!validName(hook)) {\n        throw invalidPlugin(`${path}.hooks[${index}]`, \"contains an invalid hook name\")\n      }\n      const entry = rawHooks[hook]\n      Object.defineProperty(snapshot, hook, {\n        value: snapshotHook(entry, childPath(`${path}.hooks`, hook), name, hook),\n        enumerable: true\n      })\n    }\n    hooks = Object.freeze(snapshot)\n  }\n\n  return Object.freeze({\n    name,\n    ...(values.version === undefined ? {} : { version: values.version }),\n    ...(values.enforce === undefined ? {} : { enforce: values.enforce }),\n    ...(values.apply === undefined ? {} : { apply: values.apply as Apply }),\n    ...(values.layer === undefined ? {} : { layer: values.layer as Layer.Layer<never, any, any> }),\n    ...(hooks === undefined ? {} : { hooks: hooks as Partial<H> })\n  })\n}\n\ninterface AdmittedPlugin<H> {\n  readonly plugin: FlowsPlugin<H>\n  readonly path: string\n}\n\nconst flatten = <H>(input: unknown): ReadonlyArray<AdmittedPlugin<H>> => {\n  const output: Array<AdmittedPlugin<H>> = []\n  const arrays = new WeakSet<object>()\n  const stack: Array<{ readonly value: unknown; readonly path: string; readonly depth: number }> = [\n    { value: input, path: \"$\", depth: 0 }\n  ]\n  let nodes = 0\n  while (stack.length > 0) {\n    const current = stack.pop()!\n    nodes += 1\n    if (current.value === false || current.value === null || current.value === undefined) continue\n    if (Array.isArray(current.value)) {\n      if (current.depth >= maximumPluginDepth) {\n        throw failure(\"resource_limit\", `plugin input exceeds the depth limit of ${maximumPluginDepth}`, current.path)\n      }\n      if (arrays.has(current.value)) throw invalidPlugin(current.path, \"contains a cycle or repeated preset array\")\n      arrays.add(current.value)\n      const length = current.value.length\n      // Every queued frame and array element costs a node, including omitted\n      // entries. Refuse before enumerating keys, descriptors, or child frames.\n      if (length > maximumPluginInputNodes - nodes - stack.length) {\n        throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPluginInputNodes}-node limit`, current.path)\n      }\n      const keys = Reflect.ownKeys(current.value)\n      if (keys.length !== length + 1 || !keys.includes(\"length\")) {\n        throw invalidPlugin(current.path, \"must be a dense preset array with no extra properties\")\n      }\n      for (let index = length - 1; index >= 0; index--) {\n        const descriptor = Object.getOwnPropertyDescriptor(current.value, String(index))\n        if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n          throw invalidPlugin(`${current.path}[${index}]`, \"must be an enumerable data property\")\n        }\n        stack.push({ value: descriptor.value, path: `${current.path}[${index}]`, depth: current.depth + 1 })\n      }\n      continue\n    }\n    output.push(Object.freeze({ plugin: snapshotPlugin<H>(current.value, current.path), path: current.path }))\n    if (output.length > maximumPlugins) {\n      throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPlugins}-plugin limit`, current.path)\n    }\n  }\n  return output\n}\n\nconst included = <H>(\n  { path, plugin }: AdmittedPlugin<H>,\n  config: FlowsConfig,\n  target: \"engine\" | \"harness\"\n): Effect.Effect<boolean, PluginError> => {\n  const apply = plugin.apply\n  if (apply === undefined) return Effect.succeed(true)\n  if (typeof apply !== \"function\") return Effect.succeed(apply === target)\n  return Effect.try({\n    try: () => apply(config),\n    catch: () =>\n      failure(\"apply_failed\", `plugin \"${plugin.name}\" apply predicate failed`, `${path}.apply`, {\n        plugin: plugin.name\n      })\n  }).pipe(\n    Effect.flatMap((result) =>\n      typeof result === \"boolean\"\n        ? Effect.succeed(result)\n        : Effect.fail(invalidPlugin(`${path}.apply`, \"predicate must return a boolean\", { plugin: plugin.name }))\n    )\n  )\n}\n\nconst rank = (enforce: \"pre\" | \"post\" | undefined): number => (enforce === \"pre\" ? 0 : enforce === \"post\" ? 2 : 1)\n\n/**\n * Resolves a plugin preset into an immutable, resource-bounded catalog.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const resolve = <H = FlowsHooks>(\n  input: PluginInput<NoInfer<H>>,\n  options: Options<NoInfer<H>> = {},\n  configOverride?: FlowsConfig\n): Effect.Effect<Resolved<H>, PluginError> =>\n  Effect.gen(function*() {\n    const raw = yield* Effect.try({\n      try: () => snapshotOptions(options),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options\", \"could not be inspected without executing user code\")\n    })\n    if (configOverride !== undefined && raw.config !== undefined) {\n      return yield* Effect.fail(invalidPlugin(\n        \"$options.config\",\n        \"cannot declare config in options alongside the positional override\"\n      ))\n    }\n    if (raw.target !== undefined && raw.target !== \"engine\" && raw.target !== \"harness\") {\n      return yield* Effect.fail(invalidPlugin(\"$options.target\", \"must be engine or harness\"))\n    }\n    if (\n      raw.parallelConcurrency !== undefined &&\n      (typeof raw.parallelConcurrency !== \"number\" || !Number.isSafeInteger(raw.parallelConcurrency) ||\n        raw.parallelConcurrency <= 0 ||\n        raw.parallelConcurrency > maximumParallelConcurrency)\n    ) {\n      return yield* Effect.fail(failure(\n        \"resource_limit\",\n        `parallel concurrency must be between 1 and ${maximumParallelConcurrency}`,\n        \"$options.parallelConcurrency\"\n      ))\n    }\n    const parallelConcurrency = raw.parallelConcurrency === undefined\n      ? defaultParallelConcurrency\n      : raw.parallelConcurrency\n    const config = yield* Config.snapshot(configOverride ?? raw.config ?? {})\n    const known = yield* Effect.try({\n      try: () => snapshotCatalog(raw.hooks ?? engineHooks),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options.hooks\", \"could not be inspected without executing user code\")\n    })\n    const admitted = yield* Effect.try({\n      try: () => flatten<H>(input),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$\", \"could not be inspected without executing user code\")\n    })\n    const target = raw.target ?? \"engine\"\n    const selected = yield* Effect.filter(admitted, (entry) => included(entry, config, target))\n\n    let handlerCount = 0\n    for (const { path, plugin } of selected) {\n      const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n      if (pluginHooks === undefined) continue\n      for (const hook of Object.keys(pluginHooks)) {\n        if (!Object.hasOwn(known, hook)) {\n          return yield* Effect.fail(failure(\n            \"unknown_hook\",\n            `plugin ${JSON.stringify(plugin.name)} declares unknown hook ${JSON.stringify(diagnosticKey(hook))}`,\n            childPath(`${path}.hooks`, hook),\n            { plugin: plugin.name, hook }\n          ))\n        }\n        handlerCount += 1\n        if (handlerCount > maximumHandlers) {\n          return yield* Effect.fail(failure(\n            \"resource_limit\",\n            `plugin handlers exceed the limit of ${maximumHandlers}`,\n            childPath(`${path}.hooks`, hook)\n          ))\n        }\n      }\n    }\n\n    const seen = new Set<string>()\n    for (const { path, plugin } of selected) {\n      if (seen.has(plugin.name)) {\n        return yield* Effect.fail(failure(\n          \"duplicate_name\",\n          `duplicate plugin name \"${plugin.name}\"`,\n          `${path}.name`,\n          { plugin: plugin.name }\n        ))\n      }\n      seen.add(plugin.name)\n    }\n\n    const orderedEntries = selected\n      .map((entry, index) => ({ entry, index }))\n      .sort((left, right) =>\n        rank(left.entry.plugin.enforce) - rank(right.entry.plugin.enforce) || left.index - right.index\n      )\n      .map(({ entry }) => entry)\n    const plugins = Object.freeze(orderedEntries.map(({ plugin }) => plugin))\n    const entries: Array<readonly [string, ReadonlyArray<HandlerRecord>]> = []\n    for (const hook of Object.keys(known)) {\n      const records: Array<{\n        readonly record: HandlerRecord\n        readonly enforceRank: number\n        readonly orderRank: number\n        readonly index: number\n      }> = []\n      for (const [index, plugin] of plugins.entries()) {\n        const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n        if (pluginHooks === undefined || !Object.hasOwn(pluginHooks, hook)) continue\n        const entry = pluginHooks[hook]\n        const record = Object.freeze({ plugin: plugin.name, hook, handler: handlerOf(entry) })\n        records.push({ record, enforceRank: rank(plugin.enforce), orderRank: rank(orderOf(entry)), index })\n      }\n      // Vite's rule, verbatim: the per-hook `order` is the outer partition and\n      // the enforce-sorted plugin list supplies the stable order inside it, so a\n      // hook marked `order: \"pre\"` runs ahead of every normal-order handler even\n      // when its plugin is `enforce: \"post\"`.\n      const ordered = records\n        .sort((left, right) =>\n          left.orderRank - right.orderRank || left.enforceRank - right.enforceRank || left.index - right.index\n        )\n        .map(({ record }) => record)\n      if (ordered.length > 0) entries.push([hook, Object.freeze(ordered)])\n    }\n    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, orderedEntries)\n    return Object.freeze({\n      plugins,\n      handlers: ImmutableMap.make(entries),\n      kinds: known,\n      parallelConcurrency,\n      ...(cacheEnvironment === undefined ? {} : { cacheEnvironment })\n    })\n  })\n\n/**\n * Merges every resolved plugin layer left-to-right and supplies the detached\n * cache environment captured during resolution.\n *\n * @category combinators\n * @since 1.0.0-rc.0\n */\nexport const layer = <H>(resolved: Resolved<H>): Layer.Layer<any, PluginError, any> =>\n  mergePluginLayers(resolved.plugins, resolved.cacheEnvironment)\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/internal/snapshotCacheEnvironment.d.ts

@@ -10,10 +10,14 @@ import type { FlowsPlugin } from "../Plugin.ts";
 import { PluginError } from "../PluginError.ts";
 /**
  * Admits a caller cache environment and prepends one escaped `name@version`
- * identity per plugin, in resolved order. An absent input stays absent.
+ * identity per plugin, in resolved order. An absent input stays absent. A
+ * versionless plugin is refused at the dollar-path it was admitted from.
  *
  * @private
  * @since 1.0.0-rc.0
  */
-export declare const snapshotCacheEnvironment: <H>(input: unknown, plugins: ReadonlyArray<FlowsPlugin<H>>) => Effect.Effect<Action.CacheEnvironment | undefined, PluginError>;
+export declare const snapshotCacheEnvironment: <H>(input: unknown, plugins: ReadonlyArray<{
+    readonly plugin: FlowsPlugin<H>;
+    readonly path: string;
+}>) => Effect.Effect<Action.CacheEnvironment | undefined, PluginError>;
 //# sourceMappingURL=snapshotCacheEnvironment.d.ts.map

package/dist/cjs/internal/snapshotCacheEnvironment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshotCacheEnvironment.d.ts","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,OAAO,OAAO,EACd,SAAS,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,WAAW,CAgDhE,CAAA"}
+{"version":3,"file":"snapshotCacheEnvironment.d.ts","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,OAAO,OAAO,EACd,SAAS,aAAa,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,KACjF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,WAAW,CAgDhE,CAAA"}

package/dist/cjs/internal/snapshotCacheEnvironment.js

@@ -43,13 +43,13 @@ const escapePluginIdentityPart = (value) => (
 const snapshotCacheEnvironment = (input, plugins) => {
   if (input === void 0) return Effect.succeed(void 0);
   const pluginIdentities = [];
-  for (const plugin of plugins) {
+  for (const { path, plugin } of plugins) {
     if (plugin.version === void 0) {
       return Effect.fail(
         new import_PluginError.PluginError({
           code: "cache_environment_invalid",
           message: `cache environment requires a version for plugin "${plugin.name}"`,
-          path: "$.version",
+          path: `${path}.version`,
           plugin: plugin.name
         })
       );

package/dist/cjs/internal/snapshotCacheEnvironment.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/internal/snapshotCacheEnvironment.ts"],
-  "sourcesContent": ["/**\n * Cache identity admission for a resolved plugin list.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\nimport { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport type { FlowsPlugin } from \"../Plugin.ts\"\nimport { PluginError } from \"../PluginError.ts\"\nimport * as Boundary from \"./Boundary.ts\"\n\nconst escapePluginIdentityPart = (value: string): string =>\n  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.\n  value.replaceAll(\"%\", \"%25\").replaceAll(\"@\", \"%40\")\n\n/**\n * Admits a caller cache environment and prepends one escaped `name@version`\n * identity per plugin, in resolved order. An absent input stays absent.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const snapshotCacheEnvironment = <H>(\n  input: unknown,\n  plugins: ReadonlyArray<FlowsPlugin<H>>\n): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {\n  if (input === undefined) return Effect.succeed(undefined)\n  const pluginIdentities: Array<string> = []\n  for (const plugin of plugins) {\n    if (plugin.version === undefined) {\n      return Effect.fail(\n        new PluginError({\n          code: \"cache_environment_invalid\",\n          message: `cache environment requires a version for plugin \"${plugin.name}\"`,\n          path: \"$.version\",\n          plugin: plugin.name\n        })\n      )\n    }\n    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`)\n  }\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) {\n    return Effect.fail(\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: `cache environment ${admitted.complaint}`,\n        path: `$options.cacheEnvironment${admitted.path.slice(1)}`\n      })\n    )\n  }\n  return Schema.decodeUnknownEffect(Action.CacheEnvironment)(admitted.value).pipe(\n    Effect.mapError(() =>\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: \"cache environment does not match the complete cache identity schema\",\n        path: \"$options.cacheEnvironment\"\n      })\n    ),\n    Effect.map((environment) => {\n      const capabilities: Record<string, ReadonlyArray<string>> = {}\n      for (const name of Object.keys(environment.capabilities)) {\n        Object.defineProperty(capabilities, name, {\n          value: Object.freeze([...environment.capabilities[name]!]),\n          enumerable: true\n        })\n      }\n      return Object.freeze({\n        layers: Object.freeze([...pluginIdentities, ...environment.layers]),\n        capabilities: Object.freeze(capabilities)\n      })\n    })\n  )\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,kBAAuB;AACvB,aAAwB;AACxB,aAAwB;AAExB,yBAA4B;AAC5B,eAA0B;AAE1B,MAAM,2BAA2B,CAAC;AAAA;AAAA,EAEhC,MAAM,WAAW,KAAK,KAAK,EAAE,WAAW,KAAK,KAAK;AAAA;AAS7C,MAAM,2BAA2B,CACtC,OACA,YACoE;AACpE,MAAI,UAAU,OAAW,QAAO,OAAO,QAAQ,MAAS;AACxD,QAAM,mBAAkC,CAAC;AACzC,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,YAAY,QAAW;AAChC,aAAO,OAAO;AAAA,QACZ,IAAI,+BAAY;AAAA,UACd,MAAM;AAAA,UACN,SAAS,oDAAoD,OAAO,IAAI;AAAA,UACxE,MAAM;AAAA,UACN,QAAQ,OAAO;AAAA,QACjB,CAAC;AAAA,MACH;AAAA,IACF;AACA,qBAAiB,KAAK,GAAG,yBAAyB,OAAO,IAAI,CAAC,IAAI,yBAAyB,OAAO,OAAO,CAAC,EAAE;AAAA,EAC9G;AACA,QAAM,WAAW,SAAS,OAAO,KAAK;AACtC,MAAI,CAAC,SAAS,IAAI;AAChB,WAAO,OAAO;AAAA,MACZ,IAAI,+BAAY;AAAA,QACd,MAAM;AAAA,QACN,SAAS,qBAAqB,SAAS,SAAS;AAAA,QAChD,MAAM,4BAA4B,SAAS,KAAK,MAAM,CAAC,CAAC;AAAA,MAC1D,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO,OAAO,oBAAoB,mBAAO,gBAAgB,EAAE,SAAS,KAAK,EAAE;AAAA,IACzE,OAAO;AAAA,MAAS,MACd,IAAI,+BAAY;AAAA,QACd,MAAM;AAAA,QACN,SAAS;AAAA,QACT,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,IACA,OAAO,IAAI,CAAC,gBAAgB;AAC1B,YAAM,eAAsD,CAAC;AAC7D,iBAAW,QAAQ,OAAO,KAAK,YAAY,YAAY,GAAG;AACxD,eAAO,eAAe,cAAc,MAAM;AAAA,UACxC,OAAO,OAAO,OAAO,CAAC,GAAG,YAAY,aAAa,IAAI,CAAE,CAAC;AAAA,UACzD,YAAY;AAAA,QACd,CAAC;AAAA,MACH;AACA,aAAO,OAAO,OAAO;AAAA,QACnB,QAAQ,OAAO,OAAO,CAAC,GAAG,kBAAkB,GAAG,YAAY,MAAM,CAAC;AAAA,QAClE,cAAc,OAAO,OAAO,YAAY;AAAA,MAC1C,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;",
+  "sourcesContent": ["/**\n * Cache identity admission for a resolved plugin list.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\nimport { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport type { FlowsPlugin } from \"../Plugin.ts\"\nimport { PluginError } from \"../PluginError.ts\"\nimport * as Boundary from \"./Boundary.ts\"\n\nconst escapePluginIdentityPart = (value: string): string =>\n  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.\n  value.replaceAll(\"%\", \"%25\").replaceAll(\"@\", \"%40\")\n\n/**\n * Admits a caller cache environment and prepends one escaped `name@version`\n * identity per plugin, in resolved order. An absent input stays absent. A\n * versionless plugin is refused at the dollar-path it was admitted from.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const snapshotCacheEnvironment = <H>(\n  input: unknown,\n  plugins: ReadonlyArray<{ readonly plugin: FlowsPlugin<H>; readonly path: string }>\n): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {\n  if (input === undefined) return Effect.succeed(undefined)\n  const pluginIdentities: Array<string> = []\n  for (const { path, plugin } of plugins) {\n    if (plugin.version === undefined) {\n      return Effect.fail(\n        new PluginError({\n          code: \"cache_environment_invalid\",\n          message: `cache environment requires a version for plugin \"${plugin.name}\"`,\n          path: `${path}.version`,\n          plugin: plugin.name\n        })\n      )\n    }\n    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`)\n  }\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) {\n    return Effect.fail(\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: `cache environment ${admitted.complaint}`,\n        path: `$options.cacheEnvironment${admitted.path.slice(1)}`\n      })\n    )\n  }\n  return Schema.decodeUnknownEffect(Action.CacheEnvironment)(admitted.value).pipe(\n    Effect.mapError(() =>\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: \"cache environment does not match the complete cache identity schema\",\n        path: \"$options.cacheEnvironment\"\n      })\n    ),\n    Effect.map((environment) => {\n      const capabilities: Record<string, ReadonlyArray<string>> = {}\n      for (const name of Object.keys(environment.capabilities)) {\n        Object.defineProperty(capabilities, name, {\n          value: Object.freeze([...environment.capabilities[name]!]),\n          enumerable: true\n        })\n      }\n      return Object.freeze({\n        layers: Object.freeze([...pluginIdentities, ...environment.layers]),\n        capabilities: Object.freeze(capabilities)\n      })\n    })\n  )\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,kBAAuB;AACvB,aAAwB;AACxB,aAAwB;AAExB,yBAA4B;AAC5B,eAA0B;AAE1B,MAAM,2BAA2B,CAAC;AAAA;AAAA,EAEhC,MAAM,WAAW,KAAK,KAAK,EAAE,WAAW,KAAK,KAAK;AAAA;AAU7C,MAAM,2BAA2B,CACtC,OACA,YACoE;AACpE,MAAI,UAAU,OAAW,QAAO,OAAO,QAAQ,MAAS;AACxD,QAAM,mBAAkC,CAAC;AACzC,aAAW,EAAE,MAAM,OAAO,KAAK,SAAS;AACtC,QAAI,OAAO,YAAY,QAAW;AAChC,aAAO,OAAO;AAAA,QACZ,IAAI,+BAAY;AAAA,UACd,MAAM;AAAA,UACN,SAAS,oDAAoD,OAAO,IAAI;AAAA,UACxE,MAAM,GAAG,IAAI;AAAA,UACb,QAAQ,OAAO;AAAA,QACjB,CAAC;AAAA,MACH;AAAA,IACF;AACA,qBAAiB,KAAK,GAAG,yBAAyB,OAAO,IAAI,CAAC,IAAI,yBAAyB,OAAO,OAAO,CAAC,EAAE;AAAA,EAC9G;AACA,QAAM,WAAW,SAAS,OAAO,KAAK;AACtC,MAAI,CAAC,SAAS,IAAI;AAChB,WAAO,OAAO;AAAA,MACZ,IAAI,+BAAY;AAAA,QACd,MAAM;AAAA,QACN,SAAS,qBAAqB,SAAS,SAAS;AAAA,QAChD,MAAM,4BAA4B,SAAS,KAAK,MAAM,CAAC,CAAC;AAAA,MAC1D,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO,OAAO,oBAAoB,mBAAO,gBAAgB,EAAE,SAAS,KAAK,EAAE;AAAA,IACzE,OAAO;AAAA,MAAS,MACd,IAAI,+BAAY;AAAA,QACd,MAAM;AAAA,QACN,SAAS;AAAA,QACT,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,IACA,OAAO,IAAI,CAAC,gBAAgB;AAC1B,YAAM,eAAsD,CAAC;AAC7D,iBAAW,QAAQ,OAAO,KAAK,YAAY,YAAY,GAAG;AACxD,eAAO,eAAe,cAAc,MAAM;AAAA,UACxC,OAAO,OAAO,OAAO,CAAC,GAAG,YAAY,aAAa,IAAI,CAAE,CAAC;AAAA,UACzD,YAAY;AAAA,QACd,CAAC;AAAA,MACH;AACA,aAAO,OAAO,OAAO;AAAA,QACnB,QAAQ,OAAO,OAAO,CAAC,GAAG,kBAAkB,GAAG,YAAY,MAAM,CAAC;AAAA,QAClE,cAAc,OAAO,OAAO,YAAY;AAAA,MAC1C,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;",
   "names": []
 }

package/dist/esm/Resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Resolve.d.ts","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Resolve.d.ts","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAc,MAAM,YAAY,CAAA;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI5C,OAAO,KAAK,EAAS,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,WAAW,EAAwB,MAAM,kBAAkB,CAAA;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,MAAM,CAAA;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,OAAQ,CAAA;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,OAAQ,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,CAAA;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,UAAU;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAA;IACpE,iHAAiH;IACjH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,gBAAgB,GAAG,SAAS,CAAA;CAChE;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,UAAU;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;IAClD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IAC3C,gHAAgH;IAChH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,gBAAgB,GAAG,SAAS,CAAA;IAC/D,2EAA2E;IAC3E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClD;AAkQD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,UAAU,EACpC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,UAAS,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAM,EACjC,iBAAiB,WAAW,KAC3B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,CAiIrC,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,UAAU,QAAQ,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAClB,CAAA"}

package/dist/esm/Resolve.js

@@ -241,7 +241,7 @@ const flatten = (input) => {
     }
     return output;
 };
-const included = (plugin, config, target) => {
+const included = ({ path, plugin }, config, target) => {
     const apply = plugin.apply;
     if (apply === undefined)
         return Effect.succeed(true);
@@ -249,12 +249,12 @@ const included = (plugin, config, target) => {
         return Effect.succeed(apply === target);
     return Effect.try({
         try: () => apply(config),
-        catch: () => failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, "$.apply", {
+        catch: () => failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, `${path}.apply`, {
             plugin: plugin.name
         })
     }).pipe(Effect.flatMap((result) => typeof result === "boolean"
         ? Effect.succeed(result)
-        : Effect.fail(invalidPlugin("$.apply", "predicate must return a boolean", { plugin: plugin.name }))));
+        : Effect.fail(invalidPlugin(`${path}.apply`, "predicate must return a boolean", { plugin: plugin.name }))));
 };
 const rank = (enforce) => (enforce === "pre" ? 0 : enforce === "post" ? 2 : 1);
 /**
@@ -299,7 +299,7 @@ export const resolve = (input, options = {}, configOverride) => Effect.gen(funct
             : invalidPlugin("$", "could not be inspected without executing user code")
     });
     const target = raw.target ?? "engine";
-    const selected = yield* Effect.filter(admitted, ({ plugin }) => included(plugin, config, target));
+    const selected = yield* Effect.filter(admitted, (entry) => included(entry, config, target));
     let handlerCount = 0;
     for (const { path, plugin } of selected) {
         const pluginHooks = plugin.hooks;
@@ -316,16 +316,17 @@ export const resolve = (input, options = {}, configOverride) => Effect.gen(funct
         }
     }
     const seen = new Set();
-    for (const { plugin } of selected) {
+    for (const { path, plugin } of selected) {
         if (seen.has(plugin.name)) {
-            return yield* Effect.fail(failure("duplicate_name", `duplicate plugin name "${plugin.name}"`, "$.name", { plugin: plugin.name }));
+            return yield* Effect.fail(failure("duplicate_name", `duplicate plugin name "${plugin.name}"`, `${path}.name`, { plugin: plugin.name }));
         }
         seen.add(plugin.name);
     }
-    const plugins = Object.freeze(selected
-        .map(({ plugin }, index) => ({ plugin, index }))
-        .sort((left, right) => rank(left.plugin.enforce) - rank(right.plugin.enforce) || left.index - right.index)
-        .map(({ plugin }) => plugin));
+    const orderedEntries = selected
+        .map((entry, index) => ({ entry, index }))
+        .sort((left, right) => rank(left.entry.plugin.enforce) - rank(right.entry.plugin.enforce) || left.index - right.index)
+        .map(({ entry }) => entry);
+    const plugins = Object.freeze(orderedEntries.map(({ plugin }) => plugin));
     const entries = [];
     for (const hook of Object.keys(known)) {
         const records = [];
@@ -347,7 +348,7 @@ export const resolve = (input, options = {}, configOverride) => Effect.gen(funct
         if (ordered.length > 0)
             entries.push([hook, Object.freeze(ordered)]);
     }
-    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, plugins);
+    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, orderedEntries);
     return Object.freeze({
         plugins,
         handlers: ImmutableMap.make(entries),

package/dist/esm/Resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"Resolve.js","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,YAAY,MAAM,+BAA+B,CAAA;AAE7D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAE5D,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AAEjF,OAAO,EAAE,WAAW,EAAwB,MAAM,kBAAkB,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAA;AA4D7C,MAAM,OAAO,GAAG,CACd,IAAqB,EACrB,OAAe,EACf,IAAY,EACZ,SAA+D,EAAE,EACpD,EAAE,CAAC,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAErE,MAAM,aAAa,GAAG,CACpB,IAAY,EACZ,SAAiB,EACjB,SAA+D,EAAE,EACpD,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAEtF,2EAA2E;AAC3E,0DAA0D;AAC1D,MAAM,aAAa,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAA;AAE/F,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE;IACtD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAClC,OAAO,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAA;AAClH,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CACd,KAAc,EACd,IAAY,EACZ,OAA6B,EACM,EAAE;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,aAAa,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAA;IACzD,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IAC9C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI;QAAE,MAAM,aAAa,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAA;IACjH,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,MAAM,aAAa,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAA;QACtF,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,8BAA8B,CAAC,CAAA;QAC3E,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC9D,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YACnF,MAAM,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,qCAAqC,CAAC,CAAA;QAClF,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,KAAc,EAAc,EAAE;IACrD,MAAM,MAAM,GAAG,OAAO,CACpB,KAAK,EACL,UAAU,EACV,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,CAAC,CAClF,CAAA;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;KAChD,CAAA;AACH,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAmB,EAAE,CACpD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,uBAAuB;IACxF,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAErF,MAAM,eAAe,GAAG,CAAC,KAAc,EAAsC,EAAE;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,aAAa,CAAC,gBAAgB,EAAE,kCAAkC,CAAC,CAAA;IAC3E,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IAC9C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACzD,MAAM,aAAa,CAAC,gBAAgB,EAAE,kCAAkC,CAAC,CAAA;IAC3E,CAAC;IACD,MAAM,MAAM,GAA6B,EAAE,CAAA;IAC3C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,aAAa,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAA;QACxE,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC9D,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YACnF,MAAM,aAAa,CAAC,SAAS,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,qCAAqC,CAAC,CAAA;QAC9F,CAAC;QACD,IAAI,CAAE,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAA4B,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7G,MAAM,aAAa,CAAC,SAAS,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,+BAA+B,CAAC,CAAA;QACxF,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;IACnF,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAA4C,EAAE,CAAC;QACvF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,OAAO,CACX,oBAAoB,EACpB,qCAAqC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OACvD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAC7B,iCAAiC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EACpE,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,EACjC,EAAE,IAAI,EAAE,CACT,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CACnB,KAAc,EACd,IAAY,EACZ,MAAc,EACd,IAAY,EACuE,EAAE;IACrF,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAyC,CAAA;IACjF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,aAAa,CAAC,IAAI,EAAE,qCAAqC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAClE,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,aAAa,CAAC,GAAG,IAAI,UAAU,EAAE,oBAAoB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAChF,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACpF,MAAM,aAAa,CAAC,GAAG,IAAI,QAAQ,EAAE,qBAAqB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9D,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAiD,CAAA;AACpD,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CACrB,KAAc,EACd,IAAY,EACI,EAAE;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACvG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,MAAM,aAAa,CAAC,GAAG,IAAI,OAAO,EAAE,mCAAmC,CAAC,CAAA;IACrG,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACxB,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,aAAa,CAAC,GAAG,IAAI,UAAU,EAAE,sCAAsC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAClG,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC1F,MAAM,aAAa,CAAC,GAAG,IAAI,UAAU,EAAE,qBAAqB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC;IACD,IACE,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QACrF,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;QAClC,MAAM,aAAa,CAAC,GAAG,IAAI,QAAQ,EAAE,yCAAyC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACnG,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,aAAa,CAAC,GAAG,IAAI,QAAQ,EAAE,yBAAyB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACnF,CAAC;IAED,IAAI,KAAoD,CAAA;IACxD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAA;QACvD,MAAM,QAAQ,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC7D,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,aAAa,CAAC,GAAG,IAAI,UAAU,KAAK,GAAG,EAAE,+BAA+B,CAAC,CAAA;YACjF,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE;gBACpC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,IAAI,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;gBACxE,UAAU,EAAE,IAAI;aACjB,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACjC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAc,EAAE,CAAC;QACvE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAqC,EAAE,CAAC;QAC9F,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAmB,EAAE,CAAC;KAC/D,CAAC,CAAA;AACJ,CAAC,CAAA;AAOD,MAAM,OAAO,GAAG,CAAI,KAAc,EAAoC,EAAE;IACtE,MAAM,MAAM,GAA6B,EAAE,CAAA;IAC3C,MAAM,MAAM,GAAG,IAAI,OAAO,EAAU,CAAA;IACpC,MAAM,KAAK,GAAsF;QAC/F,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE;KACtC,CAAA;IACD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAA;QAC5B,KAAK,IAAI,CAAC,CAAA;QACV,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,SAAQ;QAC9F,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,KAAK,IAAI,kBAAkB,EAAE,CAAC;gBACxC,MAAM,OAAO,CAAC,gBAAgB,EAAE,2CAA2C,kBAAkB,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;YAChH,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,2CAA2C,CAAC,CAAA;YAC7G,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACzB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAA;YACnC,uEAAuE;YACvE,yEAAyE;YACzE,IAAI,MAAM,GAAG,uBAAuB,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC5D,MAAM,OAAO,CAAC,gBAAgB,EAAE,4BAA4B,uBAAuB,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;YACjH,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3D,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,uDAAuD,CAAC,CAAA;YAC5F,CAAC;YACD,KAAK,IAAI,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;gBAChF,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;oBACnF,MAAM,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,qCAAqC,CAAC,CAAA;gBACzF,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAA;YACtG,CAAC;YACD,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,cAAc,CAAI,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC1G,IAAI,MAAM,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACnC,MAAM,OAAO,CAAC,gBAAgB,EAAE,4BAA4B,cAAc,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QAC1G,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CACf,MAAsB,EACtB,MAAmB,EACnB,MAA4B,EACS,EAAE;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC1B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,CAAA;IACxE,OAAO,MAAM,CAAC,GAAG,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;QACxB,KAAK,EAAE,GAAG,EAAE,CACV,OAAO,CAAC,cAAc,EAAE,WAAW,MAAM,CAAC,IAAI,0BAA0B,EAAE,SAAS,EAAE;YACnF,MAAM,EAAE,MAAM,CAAC,IAAI;SACpB,CAAC;KACL,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACxB,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,iCAAiC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CACtG,CACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,OAAmC,EAAU,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAElH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,KAA8B,EAC9B,UAA+B,EAAE,EACjC,cAA4B,EACa,EAAE,CAC3C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC5B,GAAG,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;QACnC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,YAAY,WAAW;YAC1B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,aAAa,CAAC,UAAU,EAAE,oDAAoD,CAAC;KACtF,CAAC,CAAA;IACF,IAAI,cAAc,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CACrC,iBAAiB,EACjB,oEAAoE,CACrE,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,2BAA2B,CAAC,CAAC,CAAA;IAC1F,CAAC;IACD,IACE,GAAG,CAAC,mBAAmB,KAAK,SAAS;QACrC,CAAC,OAAO,GAAG,CAAC,mBAAmB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC;YAC5F,GAAG,CAAC,mBAAmB,IAAI,CAAC;YAC5B,GAAG,CAAC,mBAAmB,GAAG,0BAA0B,CAAC,EACvD,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAC/B,gBAAgB,EAChB,8CAA8C,0BAA0B,EAAE,EAC1E,8BAA8B,CAC/B,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,mBAAmB,GAAG,GAAG,CAAC,mBAAmB,KAAK,SAAS;QAC/D,CAAC,CAAC,0BAA0B;QAC5B,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAA;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IACzE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC;QACpD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,YAAY,WAAW;YAC1B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,aAAa,CAAC,gBAAgB,EAAE,oDAAoD,CAAC;KAC5F,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACjC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAI,KAAK,CAAC;QAC5B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,YAAY,WAAW;YAC1B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,oDAAoD,CAAC;KAC/E,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAA;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAEjG,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAsD,CAAA;QACjF,IAAI,WAAW,KAAK,SAAS;YAAE,SAAQ;QACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAC/B,cAAc,EACd,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,EACpG,SAAS,CAAC,GAAG,IAAI,QAAQ,EAAE,IAAI,CAAC,EAChC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAC9B,CAAC,CAAA;YACJ,CAAC;YACD,YAAY,IAAI,CAAC,CAAA;YACjB,IAAI,YAAY,GAAG,eAAe,EAAE,CAAC;gBACnC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAC/B,gBAAgB,EAChB,uCAAuC,eAAe,EAAE,EACxD,SAAS,CAAC,GAAG,IAAI,QAAQ,EAAE,IAAI,CAAC,CACjC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAC/B,gBAAgB,EAChB,0BAA0B,MAAM,CAAC,IAAI,GAAG,EACxC,QAAQ,EACR,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CACxB,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAC3B,QAAQ;SACL,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;SAC/C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;SACzG,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAC/B,CAAA;IACD,MAAM,OAAO,GAA2D,EAAE,CAAA;IAC1E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAKR,EAAE,CAAA;QACP,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAsD,CAAA;YACjF,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC;gBAAE,SAAQ;YAC5E,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;YAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACtF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACrG,CAAC;QACD,yEAAyE;QACzE,2EAA2E;QAC3E,2EAA2E;QAC3E,wCAAwC;QACxC,MAAM,OAAO,GAAG,OAAO;aACpB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CACrG;aACA,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;QAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACtE,CAAC;IACD,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IACvF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;QACpC,KAAK,EAAE,KAAK;QACZ,mBAAmB;QACnB,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC;KAChE,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,QAAqB,EAAsC,EAAE,CACpF,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA","sourcesContent":["/**\n * Bounded plugin resolution: admit, filter, validate, order, and snapshot.\n *\n * The resulting catalog owns every record it exposes. Dispatch never reads a\n * caller-owned map, plugin record, hook object, config value, or cache identity.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as ImmutableMap from \"@smthrs/canonical/ReadonlyMap\"\nimport type { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport type { FlowsConfig } from \"./Config.ts\"\nimport * as Config from \"./Config.ts\"\nimport type { HookCatalog, HookKind, HookObject } from \"./Hooks.ts\"\nimport { engineHooks, handlerOf, orderOf } from \"./Hooks.ts\"\nimport type { FlowsHooks } from \"./index.ts\"\nimport * as Boundary from \"./internal/Boundary.ts\"\nimport { mergePluginLayers } from \"./internal/mergePluginLayers.ts\"\nimport { snapshotCacheEnvironment } from \"./internal/snapshotCacheEnvironment.ts\"\nimport type { Apply, FlowsPlugin, PluginInput } from \"./Plugin.ts\"\nimport { PluginError, type PluginErrorCode } from \"./PluginError.ts\"\n\n/**\n * Maximum nested preset-array depth accepted at startup.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginDepth = 64\n\n/**\n * Maximum plugins accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPlugins = 256\n\n/**\n * Maximum aggregate hook handlers accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumHandlers = 1_024\n\n/**\n * Maximum input nodes, including arrays and omitted entries.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginInputNodes = 4_096\n\n/**\n * Maximum UTF-16 length of one plugin or hook name.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginNameLength = 256\n\n/**\n * Default fiber bound for parallel observers.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const defaultParallelConcurrency = 16\n\n/**\n * Maximum configurable parallel-observer bound.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumParallelConcurrency = 256\n\n/**\n * One resolved handler with immutable attribution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface HandlerRecord {\n  readonly plugin: string\n  readonly hook: string\n  readonly handler: (...args: Array<any>) => unknown\n}\n\n/**\n * The immutable output of plugin resolution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Resolved<H = FlowsHooks> {\n  readonly plugins: ReadonlyArray<FlowsPlugin<H>>\n  readonly handlers: ReadonlyMap<string, ReadonlyArray<HandlerRecord>>\n  /** The frozen runtime catalog this resolution admitted. Dispatch refuses a method whose kind differs from it. */\n  readonly kinds: Readonly<Record<string, HookKind>>\n  readonly parallelConcurrency: number\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n}\n\n/**\n * Options for {@link resolve}.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Options<H = FlowsHooks> {\n  /** Pre-resolution config tested by `apply` predicates. */\n  readonly config?: FlowsConfig | undefined\n  /** Host whose literal `apply` selectors are active. Defaults to `\"engine\"`. */\n  readonly target?: \"engine\" | \"harness\" | undefined\n  /**\n   * Hook names recognized by this host, each with the kind `H` declares for\n   * it. The shared `config` and `configResolved` hooks are fixed to\n   * `waterfall` and `parallel`; another kind fails with `hook_kind_mismatch`.\n   */\n  readonly hooks?: HookCatalog<H> | undefined\n  /** Complete composition identity for sealed activity keys. Requires every selected plugin to have a version. */\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n  /** Maximum observers run at once. Defaults to 16 and cannot exceed 256. */\n  readonly parallelConcurrency?: number | undefined\n}\n\ninterface RawOptions {\n  readonly config: unknown\n  readonly target: unknown\n  readonly hooks: unknown\n  readonly cacheEnvironment: unknown\n  readonly parallelConcurrency: unknown\n}\n\nconst failure = (\n  code: PluginErrorCode,\n  message: string,\n  path: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => new PluginError({ code, message, path, ...fields })\n\nconst invalidPlugin = (\n  path: string,\n  complaint: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => failure(\"invalid_plugin\", `plugin input ${complaint}`, path, fields)\n\n// Bound before quoting or scanning caller-controlled keys. Keep Boundary's\n// identifier/dot and JSON-quoted/bracket path convention.\nconst diagnosticKey = (key: string): string => key.length > 64 ? `${key.slice(0, 64)}...` : key\n\nconst childPath = (path: string, key: string): string => {\n  const bounded = diagnosticKey(key)\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bounded) ? `${path}.${bounded}` : `${path}[${JSON.stringify(bounded)}]`\n}\n\nconst ownData = (\n  input: unknown,\n  path: string,\n  allowed?: ReadonlySet<string>\n): Readonly<Record<string, unknown>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(path, \"must be an ordinary record\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) throw invalidPlugin(path, \"must be an ordinary record\")\n  const output: Record<string, unknown> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\") throw invalidPlugin(path, \"must not contain symbol keys\")\n    if (allowed !== undefined && !allowed.has(key)) {\n      throw invalidPlugin(childPath(path, key), \"contains an unknown property\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(path, key), \"must be an enumerable data property\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  return output\n}\n\nconst snapshotOptions = (input: unknown): RawOptions => {\n  const values = ownData(\n    input,\n    \"$options\",\n    new Set([\"config\", \"target\", \"hooks\", \"cacheEnvironment\", \"parallelConcurrency\"])\n  )\n  return {\n    config: values.config,\n    target: values.target,\n    hooks: values.hooks,\n    cacheEnvironment: values.cacheEnvironment,\n    parallelConcurrency: values.parallelConcurrency\n  }\n}\n\nconst validName = (value: unknown): value is string =>\n  typeof value === \"string\" && value.length > 0 && value.length <= maximumPluginNameLength &&\n  Boundary.isWellFormedText(value) && !/^\\s*$/u.test(value) && !/\\p{Cc}/u.test(value)\n\nconst snapshotCatalog = (input: unknown): Readonly<Record<string, HookKind>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const output: Record<string, HookKind> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\" || !validName(key)) {\n      throw invalidPlugin(\"$options.hooks\", \"contains an invalid hook name\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"must be an enumerable data property\")\n    }\n    if (!([\"sequential\", \"parallel\", \"first\", \"waterfall\"] as ReadonlyArray<unknown>).includes(descriptor.value)) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"contains an invalid hook kind\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  for (const hook of Object.keys(engineHooks) as ReadonlyArray<keyof typeof engineHooks>) {\n    if (Object.hasOwn(output, hook) && output[hook] !== engineHooks[hook]) {\n      throw failure(\n        \"hook_kind_mismatch\",\n        `hook catalog declares shared hook ${JSON.stringify(hook)} as ${\n          JSON.stringify(output[hook])\n        }, the kernel dispatches it as ${JSON.stringify(engineHooks[hook])}`,\n        childPath(\"$options.hooks\", hook),\n        { hook }\n      )\n    }\n  }\n  return Object.freeze(output)\n}\n\nconst snapshotHook = (\n  entry: unknown,\n  path: string,\n  plugin: string,\n  hook: string\n): ((...args: Array<any>) => unknown) | HookObject<(...args: Array<any>) => unknown> => {\n  if (typeof entry === \"function\") return entry as (...args: Array<any>) => unknown\n  if (entry === undefined) {\n    throw invalidPlugin(path, \"must be a function or a hook object\", { plugin, hook })\n  }\n  const values = ownData(entry, path, new Set([\"order\", \"handler\"]))\n  if (typeof values.handler !== \"function\") {\n    throw invalidPlugin(`${path}.handler`, \"must be a function\", { plugin, hook })\n  }\n  if (values.order !== undefined && values.order !== \"pre\" && values.order !== \"post\") {\n    throw invalidPlugin(`${path}.order`, \"must be pre or post\", { plugin, hook })\n  }\n  return Object.freeze({\n    ...(values.order === undefined ? {} : { order: values.order }),\n    handler: values.handler\n  }) as HookObject<(...args: Array<any>) => unknown>\n}\n\nconst snapshotPlugin = <H>(\n  input: unknown,\n  path: string\n): FlowsPlugin<H> => {\n  const values = ownData(input, path, new Set([\"name\", \"version\", \"enforce\", \"apply\", \"layer\", \"hooks\"]))\n  if (!validName(values.name)) throw invalidPlugin(`${path}.name`, \"requires a bounded non-empty name\")\n  const name = values.name\n  if (values.version !== undefined && !validName(values.version)) {\n    throw invalidPlugin(`${path}.version`, \"requires a bounded non-empty version\", { plugin: name })\n  }\n  if (values.enforce !== undefined && values.enforce !== \"pre\" && values.enforce !== \"post\") {\n    throw invalidPlugin(`${path}.enforce`, \"must be pre or post\", { plugin: name })\n  }\n  if (\n    values.apply !== undefined && values.apply !== \"engine\" && values.apply !== \"harness\" &&\n    typeof values.apply !== \"function\"\n  ) throw invalidPlugin(`${path}.apply`, \"must be engine, harness, or a predicate\", { plugin: name })\n  if (values.layer !== undefined && !Layer.isLayer(values.layer)) {\n    throw invalidPlugin(`${path}.layer`, \"must be an Effect Layer\", { plugin: name })\n  }\n\n  let hooks: Readonly<Record<string, unknown>> | undefined\n  if (values.hooks !== undefined) {\n    const rawHooks = ownData(values.hooks, `${path}.hooks`)\n    const snapshot: Record<string, unknown> = Object.create(null)\n    for (const [index, hook] of Object.keys(rawHooks).entries()) {\n      if (!validName(hook)) {\n        throw invalidPlugin(`${path}.hooks[${index}]`, \"contains an invalid hook name\")\n      }\n      const entry = rawHooks[hook]\n      Object.defineProperty(snapshot, hook, {\n        value: snapshotHook(entry, childPath(`${path}.hooks`, hook), name, hook),\n        enumerable: true\n      })\n    }\n    hooks = Object.freeze(snapshot)\n  }\n\n  return Object.freeze({\n    name,\n    ...(values.version === undefined ? {} : { version: values.version }),\n    ...(values.enforce === undefined ? {} : { enforce: values.enforce }),\n    ...(values.apply === undefined ? {} : { apply: values.apply as Apply }),\n    ...(values.layer === undefined ? {} : { layer: values.layer as Layer.Layer<never, any, any> }),\n    ...(hooks === undefined ? {} : { hooks: hooks as Partial<H> })\n  })\n}\n\ninterface AdmittedPlugin<H> {\n  readonly plugin: FlowsPlugin<H>\n  readonly path: string\n}\n\nconst flatten = <H>(input: unknown): ReadonlyArray<AdmittedPlugin<H>> => {\n  const output: Array<AdmittedPlugin<H>> = []\n  const arrays = new WeakSet<object>()\n  const stack: Array<{ readonly value: unknown; readonly path: string; readonly depth: number }> = [\n    { value: input, path: \"$\", depth: 0 }\n  ]\n  let nodes = 0\n  while (stack.length > 0) {\n    const current = stack.pop()!\n    nodes += 1\n    if (current.value === false || current.value === null || current.value === undefined) continue\n    if (Array.isArray(current.value)) {\n      if (current.depth >= maximumPluginDepth) {\n        throw failure(\"resource_limit\", `plugin input exceeds the depth limit of ${maximumPluginDepth}`, current.path)\n      }\n      if (arrays.has(current.value)) throw invalidPlugin(current.path, \"contains a cycle or repeated preset array\")\n      arrays.add(current.value)\n      const length = current.value.length\n      // Every queued frame and array element costs a node, including omitted\n      // entries. Refuse before enumerating keys, descriptors, or child frames.\n      if (length > maximumPluginInputNodes - nodes - stack.length) {\n        throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPluginInputNodes}-node limit`, current.path)\n      }\n      const keys = Reflect.ownKeys(current.value)\n      if (keys.length !== length + 1 || !keys.includes(\"length\")) {\n        throw invalidPlugin(current.path, \"must be a dense preset array with no extra properties\")\n      }\n      for (let index = length - 1; index >= 0; index--) {\n        const descriptor = Object.getOwnPropertyDescriptor(current.value, String(index))\n        if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n          throw invalidPlugin(`${current.path}[${index}]`, \"must be an enumerable data property\")\n        }\n        stack.push({ value: descriptor.value, path: `${current.path}[${index}]`, depth: current.depth + 1 })\n      }\n      continue\n    }\n    output.push(Object.freeze({ plugin: snapshotPlugin<H>(current.value, current.path), path: current.path }))\n    if (output.length > maximumPlugins) {\n      throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPlugins}-plugin limit`, current.path)\n    }\n  }\n  return output\n}\n\nconst included = <H>(\n  plugin: FlowsPlugin<H>,\n  config: FlowsConfig,\n  target: \"engine\" | \"harness\"\n): Effect.Effect<boolean, PluginError> => {\n  const apply = plugin.apply\n  if (apply === undefined) return Effect.succeed(true)\n  if (typeof apply !== \"function\") return Effect.succeed(apply === target)\n  return Effect.try({\n    try: () => apply(config),\n    catch: () =>\n      failure(\"apply_failed\", `plugin \"${plugin.name}\" apply predicate failed`, \"$.apply\", {\n        plugin: plugin.name\n      })\n  }).pipe(\n    Effect.flatMap((result) =>\n      typeof result === \"boolean\"\n        ? Effect.succeed(result)\n        : Effect.fail(invalidPlugin(\"$.apply\", \"predicate must return a boolean\", { plugin: plugin.name }))\n    )\n  )\n}\n\nconst rank = (enforce: \"pre\" | \"post\" | undefined): number => (enforce === \"pre\" ? 0 : enforce === \"post\" ? 2 : 1)\n\n/**\n * Resolves a plugin preset into an immutable, resource-bounded catalog.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const resolve = <H = FlowsHooks>(\n  input: PluginInput<NoInfer<H>>,\n  options: Options<NoInfer<H>> = {},\n  configOverride?: FlowsConfig\n): Effect.Effect<Resolved<H>, PluginError> =>\n  Effect.gen(function*() {\n    const raw = yield* Effect.try({\n      try: () => snapshotOptions(options),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options\", \"could not be inspected without executing user code\")\n    })\n    if (configOverride !== undefined && raw.config !== undefined) {\n      return yield* Effect.fail(invalidPlugin(\n        \"$options.config\",\n        \"cannot declare config in options alongside the positional override\"\n      ))\n    }\n    if (raw.target !== undefined && raw.target !== \"engine\" && raw.target !== \"harness\") {\n      return yield* Effect.fail(invalidPlugin(\"$options.target\", \"must be engine or harness\"))\n    }\n    if (\n      raw.parallelConcurrency !== undefined &&\n      (typeof raw.parallelConcurrency !== \"number\" || !Number.isSafeInteger(raw.parallelConcurrency) ||\n        raw.parallelConcurrency <= 0 ||\n        raw.parallelConcurrency > maximumParallelConcurrency)\n    ) {\n      return yield* Effect.fail(failure(\n        \"resource_limit\",\n        `parallel concurrency must be between 1 and ${maximumParallelConcurrency}`,\n        \"$options.parallelConcurrency\"\n      ))\n    }\n    const parallelConcurrency = raw.parallelConcurrency === undefined\n      ? defaultParallelConcurrency\n      : raw.parallelConcurrency\n    const config = yield* Config.snapshot(configOverride ?? raw.config ?? {})\n    const known = yield* Effect.try({\n      try: () => snapshotCatalog(raw.hooks ?? engineHooks),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options.hooks\", \"could not be inspected without executing user code\")\n    })\n    const admitted = yield* Effect.try({\n      try: () => flatten<H>(input),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$\", \"could not be inspected without executing user code\")\n    })\n    const target = raw.target ?? \"engine\"\n    const selected = yield* Effect.filter(admitted, ({ plugin }) => included(plugin, config, target))\n\n    let handlerCount = 0\n    for (const { path, plugin } of selected) {\n      const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n      if (pluginHooks === undefined) continue\n      for (const hook of Object.keys(pluginHooks)) {\n        if (!Object.hasOwn(known, hook)) {\n          return yield* Effect.fail(failure(\n            \"unknown_hook\",\n            `plugin ${JSON.stringify(plugin.name)} declares unknown hook ${JSON.stringify(diagnosticKey(hook))}`,\n            childPath(`${path}.hooks`, hook),\n            { plugin: plugin.name, hook }\n          ))\n        }\n        handlerCount += 1\n        if (handlerCount > maximumHandlers) {\n          return yield* Effect.fail(failure(\n            \"resource_limit\",\n            `plugin handlers exceed the limit of ${maximumHandlers}`,\n            childPath(`${path}.hooks`, hook)\n          ))\n        }\n      }\n    }\n\n    const seen = new Set<string>()\n    for (const { plugin } of selected) {\n      if (seen.has(plugin.name)) {\n        return yield* Effect.fail(failure(\n          \"duplicate_name\",\n          `duplicate plugin name \"${plugin.name}\"`,\n          \"$.name\",\n          { plugin: plugin.name }\n        ))\n      }\n      seen.add(plugin.name)\n    }\n\n    const plugins = Object.freeze(\n      selected\n        .map(({ plugin }, index) => ({ plugin, index }))\n        .sort((left, right) => rank(left.plugin.enforce) - rank(right.plugin.enforce) || left.index - right.index)\n        .map(({ plugin }) => plugin)\n    )\n    const entries: Array<readonly [string, ReadonlyArray<HandlerRecord>]> = []\n    for (const hook of Object.keys(known)) {\n      const records: Array<{\n        readonly record: HandlerRecord\n        readonly enforceRank: number\n        readonly orderRank: number\n        readonly index: number\n      }> = []\n      for (const [index, plugin] of plugins.entries()) {\n        const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n        if (pluginHooks === undefined || !Object.hasOwn(pluginHooks, hook)) continue\n        const entry = pluginHooks[hook]\n        const record = Object.freeze({ plugin: plugin.name, hook, handler: handlerOf(entry) })\n        records.push({ record, enforceRank: rank(plugin.enforce), orderRank: rank(orderOf(entry)), index })\n      }\n      // Vite's rule, verbatim: the per-hook `order` is the outer partition and\n      // the enforce-sorted plugin list supplies the stable order inside it, so a\n      // hook marked `order: \"pre\"` runs ahead of every normal-order handler even\n      // when its plugin is `enforce: \"post\"`.\n      const ordered = records\n        .sort((left, right) =>\n          left.orderRank - right.orderRank || left.enforceRank - right.enforceRank || left.index - right.index\n        )\n        .map(({ record }) => record)\n      if (ordered.length > 0) entries.push([hook, Object.freeze(ordered)])\n    }\n    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, plugins)\n    return Object.freeze({\n      plugins,\n      handlers: ImmutableMap.make(entries),\n      kinds: known,\n      parallelConcurrency,\n      ...(cacheEnvironment === undefined ? {} : { cacheEnvironment })\n    })\n  })\n\n/**\n * Merges every resolved plugin layer left-to-right and supplies the detached\n * cache environment captured during resolution.\n *\n * @category combinators\n * @since 1.0.0-rc.0\n */\nexport const layer = <H>(resolved: Resolved<H>): Layer.Layer<any, PluginError, any> =>\n  mergePluginLayers(resolved.plugins, resolved.cacheEnvironment)\n"]}
+{"version":3,"file":"Resolve.js","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bounded plugin resolution: admit, filter, validate, order, and snapshot.\n *\n * The resulting catalog owns every record it exposes. Dispatch never reads a\n * caller-owned map, plugin record, hook object, config value, or cache identity.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as ImmutableMap from \"@smthrs/canonical/ReadonlyMap\"\nimport type { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport type { FlowsConfig } from \"./Config.ts\"\nimport * as Config from \"./Config.ts\"\nimport type { HookCatalog, HookKind, HookObject } from \"./Hooks.ts\"\nimport { engineHooks, handlerOf, orderOf } from \"./Hooks.ts\"\nimport type { FlowsHooks } from \"./index.ts\"\nimport * as Boundary from \"./internal/Boundary.ts\"\nimport { mergePluginLayers } from \"./internal/mergePluginLayers.ts\"\nimport { snapshotCacheEnvironment } from \"./internal/snapshotCacheEnvironment.ts\"\nimport type { Apply, FlowsPlugin, PluginInput } from \"./Plugin.ts\"\nimport { PluginError, type PluginErrorCode } from \"./PluginError.ts\"\n\n/**\n * Maximum nested preset-array depth accepted at startup.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginDepth = 64\n\n/**\n * Maximum plugins accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPlugins = 256\n\n/**\n * Maximum aggregate hook handlers accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumHandlers = 1_024\n\n/**\n * Maximum input nodes, including arrays and omitted entries.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginInputNodes = 4_096\n\n/**\n * Maximum UTF-16 length of one plugin or hook name.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginNameLength = 256\n\n/**\n * Default fiber bound for parallel observers.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const defaultParallelConcurrency = 16\n\n/**\n * Maximum configurable parallel-observer bound.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumParallelConcurrency = 256\n\n/**\n * One resolved handler with immutable attribution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface HandlerRecord {\n  readonly plugin: string\n  readonly hook: string\n  readonly handler: (...args: Array<any>) => unknown\n}\n\n/**\n * The immutable output of plugin resolution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Resolved<H = FlowsHooks> {\n  readonly plugins: ReadonlyArray<FlowsPlugin<H>>\n  readonly handlers: ReadonlyMap<string, ReadonlyArray<HandlerRecord>>\n  /** The frozen runtime catalog this resolution admitted. Dispatch refuses a method whose kind differs from it. */\n  readonly kinds: Readonly<Record<string, HookKind>>\n  readonly parallelConcurrency: number\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n}\n\n/**\n * Options for {@link resolve}.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Options<H = FlowsHooks> {\n  /** Pre-resolution config tested by `apply` predicates. */\n  readonly config?: FlowsConfig | undefined\n  /** Host whose literal `apply` selectors are active. Defaults to `\"engine\"`. */\n  readonly target?: \"engine\" | \"harness\" | undefined\n  /**\n   * Hook names recognized by this host, each with the kind `H` declares for\n   * it. The shared `config` and `configResolved` hooks are fixed to\n   * `waterfall` and `parallel`; another kind fails with `hook_kind_mismatch`.\n   */\n  readonly hooks?: HookCatalog<H> | undefined\n  /** Complete composition identity for sealed activity keys. Requires every selected plugin to have a version. */\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n  /** Maximum observers run at once. Defaults to 16 and cannot exceed 256. */\n  readonly parallelConcurrency?: number | undefined\n}\n\ninterface RawOptions {\n  readonly config: unknown\n  readonly target: unknown\n  readonly hooks: unknown\n  readonly cacheEnvironment: unknown\n  readonly parallelConcurrency: unknown\n}\n\nconst failure = (\n  code: PluginErrorCode,\n  message: string,\n  path: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => new PluginError({ code, message, path, ...fields })\n\nconst invalidPlugin = (\n  path: string,\n  complaint: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => failure(\"invalid_plugin\", `plugin input ${complaint}`, path, fields)\n\n// Bound before quoting or scanning caller-controlled keys. Keep Boundary's\n// identifier/dot and JSON-quoted/bracket path convention.\nconst diagnosticKey = (key: string): string => key.length > 64 ? `${key.slice(0, 64)}...` : key\n\nconst childPath = (path: string, key: string): string => {\n  const bounded = diagnosticKey(key)\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bounded) ? `${path}.${bounded}` : `${path}[${JSON.stringify(bounded)}]`\n}\n\nconst ownData = (\n  input: unknown,\n  path: string,\n  allowed?: ReadonlySet<string>\n): Readonly<Record<string, unknown>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(path, \"must be an ordinary record\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) throw invalidPlugin(path, \"must be an ordinary record\")\n  const output: Record<string, unknown> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\") throw invalidPlugin(path, \"must not contain symbol keys\")\n    if (allowed !== undefined && !allowed.has(key)) {\n      throw invalidPlugin(childPath(path, key), \"contains an unknown property\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(path, key), \"must be an enumerable data property\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  return output\n}\n\nconst snapshotOptions = (input: unknown): RawOptions => {\n  const values = ownData(\n    input,\n    \"$options\",\n    new Set([\"config\", \"target\", \"hooks\", \"cacheEnvironment\", \"parallelConcurrency\"])\n  )\n  return {\n    config: values.config,\n    target: values.target,\n    hooks: values.hooks,\n    cacheEnvironment: values.cacheEnvironment,\n    parallelConcurrency: values.parallelConcurrency\n  }\n}\n\nconst validName = (value: unknown): value is string =>\n  typeof value === \"string\" && value.length > 0 && value.length <= maximumPluginNameLength &&\n  Boundary.isWellFormedText(value) && !/^\\s*$/u.test(value) && !/\\p{Cc}/u.test(value)\n\nconst snapshotCatalog = (input: unknown): Readonly<Record<string, HookKind>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const output: Record<string, HookKind> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\" || !validName(key)) {\n      throw invalidPlugin(\"$options.hooks\", \"contains an invalid hook name\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"must be an enumerable data property\")\n    }\n    if (!([\"sequential\", \"parallel\", \"first\", \"waterfall\"] as ReadonlyArray<unknown>).includes(descriptor.value)) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"contains an invalid hook kind\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  for (const hook of Object.keys(engineHooks) as ReadonlyArray<keyof typeof engineHooks>) {\n    if (Object.hasOwn(output, hook) && output[hook] !== engineHooks[hook]) {\n      throw failure(\n        \"hook_kind_mismatch\",\n        `hook catalog declares shared hook ${JSON.stringify(hook)} as ${\n          JSON.stringify(output[hook])\n        }, the kernel dispatches it as ${JSON.stringify(engineHooks[hook])}`,\n        childPath(\"$options.hooks\", hook),\n        { hook }\n      )\n    }\n  }\n  return Object.freeze(output)\n}\n\nconst snapshotHook = (\n  entry: unknown,\n  path: string,\n  plugin: string,\n  hook: string\n): ((...args: Array<any>) => unknown) | HookObject<(...args: Array<any>) => unknown> => {\n  if (typeof entry === \"function\") return entry as (...args: Array<any>) => unknown\n  if (entry === undefined) {\n    throw invalidPlugin(path, \"must be a function or a hook object\", { plugin, hook })\n  }\n  const values = ownData(entry, path, new Set([\"order\", \"handler\"]))\n  if (typeof values.handler !== \"function\") {\n    throw invalidPlugin(`${path}.handler`, \"must be a function\", { plugin, hook })\n  }\n  if (values.order !== undefined && values.order !== \"pre\" && values.order !== \"post\") {\n    throw invalidPlugin(`${path}.order`, \"must be pre or post\", { plugin, hook })\n  }\n  return Object.freeze({\n    ...(values.order === undefined ? {} : { order: values.order }),\n    handler: values.handler\n  }) as HookObject<(...args: Array<any>) => unknown>\n}\n\nconst snapshotPlugin = <H>(\n  input: unknown,\n  path: string\n): FlowsPlugin<H> => {\n  const values = ownData(input, path, new Set([\"name\", \"version\", \"enforce\", \"apply\", \"layer\", \"hooks\"]))\n  if (!validName(values.name)) throw invalidPlugin(`${path}.name`, \"requires a bounded non-empty name\")\n  const name = values.name\n  if (values.version !== undefined && !validName(values.version)) {\n    throw invalidPlugin(`${path}.version`, \"requires a bounded non-empty version\", { plugin: name })\n  }\n  if (values.enforce !== undefined && values.enforce !== \"pre\" && values.enforce !== \"post\") {\n    throw invalidPlugin(`${path}.enforce`, \"must be pre or post\", { plugin: name })\n  }\n  if (\n    values.apply !== undefined && values.apply !== \"engine\" && values.apply !== \"harness\" &&\n    typeof values.apply !== \"function\"\n  ) throw invalidPlugin(`${path}.apply`, \"must be engine, harness, or a predicate\", { plugin: name })\n  if (values.layer !== undefined && !Layer.isLayer(values.layer)) {\n    throw invalidPlugin(`${path}.layer`, \"must be an Effect Layer\", { plugin: name })\n  }\n\n  let hooks: Readonly<Record<string, unknown>> | undefined\n  if (values.hooks !== undefined) {\n    const rawHooks = ownData(values.hooks, `${path}.hooks`)\n    const snapshot: Record<string, unknown> = Object.create(null)\n    for (const [index, hook] of Object.keys(rawHooks).entries()) {\n      if (!validName(hook)) {\n        throw invalidPlugin(`${path}.hooks[${index}]`, \"contains an invalid hook name\")\n      }\n      const entry = rawHooks[hook]\n      Object.defineProperty(snapshot, hook, {\n        value: snapshotHook(entry, childPath(`${path}.hooks`, hook), name, hook),\n        enumerable: true\n      })\n    }\n    hooks = Object.freeze(snapshot)\n  }\n\n  return Object.freeze({\n    name,\n    ...(values.version === undefined ? {} : { version: values.version }),\n    ...(values.enforce === undefined ? {} : { enforce: values.enforce }),\n    ...(values.apply === undefined ? {} : { apply: values.apply as Apply }),\n    ...(values.layer === undefined ? {} : { layer: values.layer as Layer.Layer<never, any, any> }),\n    ...(hooks === undefined ? {} : { hooks: hooks as Partial<H> })\n  })\n}\n\ninterface AdmittedPlugin<H> {\n  readonly plugin: FlowsPlugin<H>\n  readonly path: string\n}\n\nconst flatten = <H>(input: unknown): ReadonlyArray<AdmittedPlugin<H>> => {\n  const output: Array<AdmittedPlugin<H>> = []\n  const arrays = new WeakSet<object>()\n  const stack: Array<{ readonly value: unknown; readonly path: string; readonly depth: number }> = [\n    { value: input, path: \"$\", depth: 0 }\n  ]\n  let nodes = 0\n  while (stack.length > 0) {\n    const current = stack.pop()!\n    nodes += 1\n    if (current.value === false || current.value === null || current.value === undefined) continue\n    if (Array.isArray(current.value)) {\n      if (current.depth >= maximumPluginDepth) {\n        throw failure(\"resource_limit\", `plugin input exceeds the depth limit of ${maximumPluginDepth}`, current.path)\n      }\n      if (arrays.has(current.value)) throw invalidPlugin(current.path, \"contains a cycle or repeated preset array\")\n      arrays.add(current.value)\n      const length = current.value.length\n      // Every queued frame and array element costs a node, including omitted\n      // entries. Refuse before enumerating keys, descriptors, or child frames.\n      if (length > maximumPluginInputNodes - nodes - stack.length) {\n        throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPluginInputNodes}-node limit`, current.path)\n      }\n      const keys = Reflect.ownKeys(current.value)\n      if (keys.length !== length + 1 || !keys.includes(\"length\")) {\n        throw invalidPlugin(current.path, \"must be a dense preset array with no extra properties\")\n      }\n      for (let index = length - 1; index >= 0; index--) {\n        const descriptor = Object.getOwnPropertyDescriptor(current.value, String(index))\n        if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n          throw invalidPlugin(`${current.path}[${index}]`, \"must be an enumerable data property\")\n        }\n        stack.push({ value: descriptor.value, path: `${current.path}[${index}]`, depth: current.depth + 1 })\n      }\n      continue\n    }\n    output.push(Object.freeze({ plugin: snapshotPlugin<H>(current.value, current.path), path: current.path }))\n    if (output.length > maximumPlugins) {\n      throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPlugins}-plugin limit`, current.path)\n    }\n  }\n  return output\n}\n\nconst included = <H>(\n  { path, plugin }: AdmittedPlugin<H>,\n  config: FlowsConfig,\n  target: \"engine\" | \"harness\"\n): Effect.Effect<boolean, PluginError> => {\n  const apply = plugin.apply\n  if (apply === undefined) return Effect.succeed(true)\n  if (typeof apply !== \"function\") return Effect.succeed(apply === target)\n  return Effect.try({\n    try: () => apply(config),\n    catch: () =>\n      failure(\"apply_failed\", `plugin \"${plugin.name}\" apply predicate failed`, `${path}.apply`, {\n        plugin: plugin.name\n      })\n  }).pipe(\n    Effect.flatMap((result) =>\n      typeof result === \"boolean\"\n        ? Effect.succeed(result)\n        : Effect.fail(invalidPlugin(`${path}.apply`, \"predicate must return a boolean\", { plugin: plugin.name }))\n    )\n  )\n}\n\nconst rank = (enforce: \"pre\" | \"post\" | undefined): number => (enforce === \"pre\" ? 0 : enforce === \"post\" ? 2 : 1)\n\n/**\n * Resolves a plugin preset into an immutable, resource-bounded catalog.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const resolve = <H = FlowsHooks>(\n  input: PluginInput<NoInfer<H>>,\n  options: Options<NoInfer<H>> = {},\n  configOverride?: FlowsConfig\n): Effect.Effect<Resolved<H>, PluginError> =>\n  Effect.gen(function*() {\n    const raw = yield* Effect.try({\n      try: () => snapshotOptions(options),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options\", \"could not be inspected without executing user code\")\n    })\n    if (configOverride !== undefined && raw.config !== undefined) {\n      return yield* Effect.fail(invalidPlugin(\n        \"$options.config\",\n        \"cannot declare config in options alongside the positional override\"\n      ))\n    }\n    if (raw.target !== undefined && raw.target !== \"engine\" && raw.target !== \"harness\") {\n      return yield* Effect.fail(invalidPlugin(\"$options.target\", \"must be engine or harness\"))\n    }\n    if (\n      raw.parallelConcurrency !== undefined &&\n      (typeof raw.parallelConcurrency !== \"number\" || !Number.isSafeInteger(raw.parallelConcurrency) ||\n        raw.parallelConcurrency <= 0 ||\n        raw.parallelConcurrency > maximumParallelConcurrency)\n    ) {\n      return yield* Effect.fail(failure(\n        \"resource_limit\",\n        `parallel concurrency must be between 1 and ${maximumParallelConcurrency}`,\n        \"$options.parallelConcurrency\"\n      ))\n    }\n    const parallelConcurrency = raw.parallelConcurrency === undefined\n      ? defaultParallelConcurrency\n      : raw.parallelConcurrency\n    const config = yield* Config.snapshot(configOverride ?? raw.config ?? {})\n    const known = yield* Effect.try({\n      try: () => snapshotCatalog(raw.hooks ?? engineHooks),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options.hooks\", \"could not be inspected without executing user code\")\n    })\n    const admitted = yield* Effect.try({\n      try: () => flatten<H>(input),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$\", \"could not be inspected without executing user code\")\n    })\n    const target = raw.target ?? \"engine\"\n    const selected = yield* Effect.filter(admitted, (entry) => included(entry, config, target))\n\n    let handlerCount = 0\n    for (const { path, plugin } of selected) {\n      const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n      if (pluginHooks === undefined) continue\n      for (const hook of Object.keys(pluginHooks)) {\n        if (!Object.hasOwn(known, hook)) {\n          return yield* Effect.fail(failure(\n            \"unknown_hook\",\n            `plugin ${JSON.stringify(plugin.name)} declares unknown hook ${JSON.stringify(diagnosticKey(hook))}`,\n            childPath(`${path}.hooks`, hook),\n            { plugin: plugin.name, hook }\n          ))\n        }\n        handlerCount += 1\n        if (handlerCount > maximumHandlers) {\n          return yield* Effect.fail(failure(\n            \"resource_limit\",\n            `plugin handlers exceed the limit of ${maximumHandlers}`,\n            childPath(`${path}.hooks`, hook)\n          ))\n        }\n      }\n    }\n\n    const seen = new Set<string>()\n    for (const { path, plugin } of selected) {\n      if (seen.has(plugin.name)) {\n        return yield* Effect.fail(failure(\n          \"duplicate_name\",\n          `duplicate plugin name \"${plugin.name}\"`,\n          `${path}.name`,\n          { plugin: plugin.name }\n        ))\n      }\n      seen.add(plugin.name)\n    }\n\n    const orderedEntries = selected\n      .map((entry, index) => ({ entry, index }))\n      .sort((left, right) =>\n        rank(left.entry.plugin.enforce) - rank(right.entry.plugin.enforce) || left.index - right.index\n      )\n      .map(({ entry }) => entry)\n    const plugins = Object.freeze(orderedEntries.map(({ plugin }) => plugin))\n    const entries: Array<readonly [string, ReadonlyArray<HandlerRecord>]> = []\n    for (const hook of Object.keys(known)) {\n      const records: Array<{\n        readonly record: HandlerRecord\n        readonly enforceRank: number\n        readonly orderRank: number\n        readonly index: number\n      }> = []\n      for (const [index, plugin] of plugins.entries()) {\n        const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n        if (pluginHooks === undefined || !Object.hasOwn(pluginHooks, hook)) continue\n        const entry = pluginHooks[hook]\n        const record = Object.freeze({ plugin: plugin.name, hook, handler: handlerOf(entry) })\n        records.push({ record, enforceRank: rank(plugin.enforce), orderRank: rank(orderOf(entry)), index })\n      }\n      // Vite's rule, verbatim: the per-hook `order` is the outer partition and\n      // the enforce-sorted plugin list supplies the stable order inside it, so a\n      // hook marked `order: \"pre\"` runs ahead of every normal-order handler even\n      // when its plugin is `enforce: \"post\"`.\n      const ordered = records\n        .sort((left, right) =>\n          left.orderRank - right.orderRank || left.enforceRank - right.enforceRank || left.index - right.index\n        )\n        .map(({ record }) => record)\n      if (ordered.length > 0) entries.push([hook, Object.freeze(ordered)])\n    }\n    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, orderedEntries)\n    return Object.freeze({\n      plugins,\n      handlers: ImmutableMap.make(entries),\n      kinds: known,\n      parallelConcurrency,\n      ...(cacheEnvironment === undefined ? {} : { cacheEnvironment })\n    })\n  })\n\n/**\n * Merges every resolved plugin layer left-to-right and supplies the detached\n * cache environment captured during resolution.\n *\n * @category combinators\n * @since 1.0.0-rc.0\n */\nexport const layer = <H>(resolved: Resolved<H>): Layer.Layer<any, PluginError, any> =>\n  mergePluginLayers(resolved.plugins, resolved.cacheEnvironment)\n"]}

package/dist/esm/internal/snapshotCacheEnvironment.d.ts

@@ -10,10 +10,14 @@ import type { FlowsPlugin } from "../Plugin.ts";
 import { PluginError } from "../PluginError.ts";
 /**
  * Admits a caller cache environment and prepends one escaped `name@version`
- * identity per plugin, in resolved order. An absent input stays absent.
+ * identity per plugin, in resolved order. An absent input stays absent. A
+ * versionless plugin is refused at the dollar-path it was admitted from.
  *
  * @private
  * @since 1.0.0-rc.0
  */
-export declare const snapshotCacheEnvironment: <H>(input: unknown, plugins: ReadonlyArray<FlowsPlugin<H>>) => Effect.Effect<Action.CacheEnvironment | undefined, PluginError>;
+export declare const snapshotCacheEnvironment: <H>(input: unknown, plugins: ReadonlyArray<{
+    readonly plugin: FlowsPlugin<H>;
+    readonly path: string;
+}>) => Effect.Effect<Action.CacheEnvironment | undefined, PluginError>;
 //# sourceMappingURL=snapshotCacheEnvironment.d.ts.map

package/dist/esm/internal/snapshotCacheEnvironment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshotCacheEnvironment.d.ts","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,OAAO,OAAO,EACd,SAAS,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,WAAW,CAgDhE,CAAA"}
+{"version":3,"file":"snapshotCacheEnvironment.d.ts","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,OAAO,OAAO,EACd,SAAS,aAAa,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,KACjF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,WAAW,CAgDhE,CAAA"}

package/dist/esm/internal/snapshotCacheEnvironment.js

@@ -14,7 +14,8 @@ const escapePluginIdentityPart = (value) =>
 value.replaceAll("%", "%25").replaceAll("@", "%40");
 /**
  * Admits a caller cache environment and prepends one escaped `name@version`
- * identity per plugin, in resolved order. An absent input stays absent.
+ * identity per plugin, in resolved order. An absent input stays absent. A
+ * versionless plugin is refused at the dollar-path it was admitted from.
  *
  * @private
  * @since 1.0.0-rc.0
@@ -23,12 +24,12 @@ export const snapshotCacheEnvironment = (input, plugins) => {
     if (input === undefined)
         return Effect.succeed(undefined);
     const pluginIdentities = [];
-    for (const plugin of plugins) {
+    for (const { path, plugin } of plugins) {
         if (plugin.version === undefined) {
             return Effect.fail(new PluginError({
                 code: "cache_environment_invalid",
                 message: `cache environment requires a version for plugin "${plugin.name}"`,
-                path: "$.version",
+                path: `${path}.version`,
                 plugin: plugin.name
             }));
         }

package/dist/esm/internal/snapshotCacheEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshotCacheEnvironment.js","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cache identity admission for a resolved plugin list.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\nimport { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport type { FlowsPlugin } from \"../Plugin.ts\"\nimport { PluginError } from \"../PluginError.ts\"\nimport * as Boundary from \"./Boundary.ts\"\n\nconst escapePluginIdentityPart = (value: string): string =>\n  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.\n  value.replaceAll(\"%\", \"%25\").replaceAll(\"@\", \"%40\")\n\n/**\n * Admits a caller cache environment and prepends one escaped `name@version`\n * identity per plugin, in resolved order. An absent input stays absent.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const snapshotCacheEnvironment = <H>(\n  input: unknown,\n  plugins: ReadonlyArray<FlowsPlugin<H>>\n): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {\n  if (input === undefined) return Effect.succeed(undefined)\n  const pluginIdentities: Array<string> = []\n  for (const plugin of plugins) {\n    if (plugin.version === undefined) {\n      return Effect.fail(\n        new PluginError({\n          code: \"cache_environment_invalid\",\n          message: `cache environment requires a version for plugin \"${plugin.name}\"`,\n          path: \"$.version\",\n          plugin: plugin.name\n        })\n      )\n    }\n    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`)\n  }\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) {\n    return Effect.fail(\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: `cache environment ${admitted.complaint}`,\n        path: `$options.cacheEnvironment${admitted.path.slice(1)}`\n      })\n    )\n  }\n  return Schema.decodeUnknownEffect(Action.CacheEnvironment)(admitted.value).pipe(\n    Effect.mapError(() =>\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: \"cache environment does not match the complete cache identity schema\",\n        path: \"$options.cacheEnvironment\"\n      })\n    ),\n    Effect.map((environment) => {\n      const capabilities: Record<string, ReadonlyArray<string>> = {}\n      for (const name of Object.keys(environment.capabilities)) {\n        Object.defineProperty(capabilities, name, {\n          value: Object.freeze([...environment.capabilities[name]!]),\n          enumerable: true\n        })\n      }\n      return Object.freeze({\n        layers: Object.freeze([...pluginIdentities, ...environment.layers]),\n        capabilities: Object.freeze(capabilities)\n      })\n    })\n  )\n}\n"]}
+{"version":3,"file":"snapshotCacheEnvironment.js","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cache identity admission for a resolved plugin list.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\nimport { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport type { FlowsPlugin } from \"../Plugin.ts\"\nimport { PluginError } from \"../PluginError.ts\"\nimport * as Boundary from \"./Boundary.ts\"\n\nconst escapePluginIdentityPart = (value: string): string =>\n  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.\n  value.replaceAll(\"%\", \"%25\").replaceAll(\"@\", \"%40\")\n\n/**\n * Admits a caller cache environment and prepends one escaped `name@version`\n * identity per plugin, in resolved order. An absent input stays absent. A\n * versionless plugin is refused at the dollar-path it was admitted from.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const snapshotCacheEnvironment = <H>(\n  input: unknown,\n  plugins: ReadonlyArray<{ readonly plugin: FlowsPlugin<H>; readonly path: string }>\n): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {\n  if (input === undefined) return Effect.succeed(undefined)\n  const pluginIdentities: Array<string> = []\n  for (const { path, plugin } of plugins) {\n    if (plugin.version === undefined) {\n      return Effect.fail(\n        new PluginError({\n          code: \"cache_environment_invalid\",\n          message: `cache environment requires a version for plugin \"${plugin.name}\"`,\n          path: `${path}.version`,\n          plugin: plugin.name\n        })\n      )\n    }\n    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`)\n  }\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) {\n    return Effect.fail(\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: `cache environment ${admitted.complaint}`,\n        path: `$options.cacheEnvironment${admitted.path.slice(1)}`\n      })\n    )\n  }\n  return Schema.decodeUnknownEffect(Action.CacheEnvironment)(admitted.value).pipe(\n    Effect.mapError(() =>\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: \"cache environment does not match the complete cache identity schema\",\n        path: \"$options.cacheEnvironment\"\n      })\n    ),\n    Effect.map((environment) => {\n      const capabilities: Record<string, ReadonlyArray<string>> = {}\n      for (const name of Object.keys(environment.capabilities)) {\n        Object.defineProperty(capabilities, name, {\n          value: Object.freeze([...environment.capabilities[name]!]),\n          enumerable: true\n        })\n      }\n      return Object.freeze({\n        layers: Object.freeze([...pluginIdentities, ...environment.layers]),\n        capabilities: Object.freeze(capabilities)\n      })\n    })\n  )\n}\n"]}

package/docs/README.md

@@ -51,7 +51,9 @@ class, no registration call, and no inheritance.
 
 ## Install
 
-Not on npm yet; see [Installation](https://github.com/smithersai/smithers/blob/main/packages/smithers/flows/flow/docs/installation.md#use-the-libraries).
+```bash
+npm install @smthrs/plugin@next effect
+```
 
 Node.js 26.4.0 or later is required. For the runtime requirements, the import
 forms, and the subpaths the export map blocks, see

package/docs/guides/cache-identity.md

@@ -67,7 +67,7 @@ const refused = Kernel.make(
   {},
   { cacheEnvironment: { layers: [], capabilities: {} } }
 )
-// Fails with PluginError { code: "cache_environment_invalid", plugin: "flows-plugin-model-sonnet", path: "$.version" }
+// Fails with PluginError { code: "cache_environment_invalid", plugin: "flows-plugin-model-sonnet", path: "$[0].version" }
 ```
 
 A versionless plugin is refused rather than folded in as a bare name, because a

package/docs/installation.md

@@ -7,7 +7,11 @@ sidebar:
 
 ## Install the package
 
-Not on npm yet; see [Installation](https://github.com/smithersai/smithers/blob/main/packages/smithers/flows/flow/docs/installation.md#use-the-libraries).
+```bash
+npm install @smthrs/plugin@next effect
+```
+
+The `next` tag carries the 1.0 release candidates.
 
 Install `effect` explicitly, in the range `^4.0.4`. The kernel depends on it, but your
 plugins import `Effect`, `Layer`, and `Option` directly, so `effect` belongs in

package/docs/quickstart.md

@@ -16,7 +16,8 @@ defines the plugins and runs the host. There are no services to provide.
 ## Prerequisites
 
 - Node.js 26.4.0 or later.
-- A TypeScript project with the package installed. Not on npm yet; see [Installation](https://github.com/smithersai/smithers/blob/main/packages/smithers/flows/flow/docs/installation.md#use-the-libraries).
+- A TypeScript project with the package installed:
+  `npm install @smthrs/plugin@next effect`.
 
 ## Declare the host's hook catalog
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@smthrs/plugin",
   "type": "module",
-  "version": "1.0.0-rc.6",
+  "version": "1.0.0-rc.8",
   "license": "MIT",
   "smthrs": {
     "group": "agent"
@@ -145,8 +145,8 @@
     "tag": "next"
   },
   "dependencies": {
-    "@smthrs/canonical": "1.0.0-rc.6",
-    "@smthrs/flow": "1.0.0-rc.6"
+    "@smthrs/canonical": "1.0.0-rc.8",
+    "@smthrs/flow": "1.0.0-rc.8"
   },
   "devDependencies": {
     "@effect/language-service": "0.87.2",

package/src/Resolve.ts

@@ -360,7 +360,7 @@ const flatten = <H>(input: unknown): ReadonlyArray<AdmittedPlugin<H>> => {
 }
 
 const included = <H>(
-  plugin: FlowsPlugin<H>,
+  { path, plugin }: AdmittedPlugin<H>,
   config: FlowsConfig,
   target: "engine" | "harness"
 ): Effect.Effect<boolean, PluginError> => {
@@ -370,14 +370,14 @@ const included = <H>(
   return Effect.try({
     try: () => apply(config),
     catch: () =>
-      failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, "$.apply", {
+      failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, `${path}.apply`, {
         plugin: plugin.name
       })
   }).pipe(
     Effect.flatMap((result) =>
       typeof result === "boolean"
         ? Effect.succeed(result)
-        : Effect.fail(invalidPlugin("$.apply", "predicate must return a boolean", { plugin: plugin.name }))
+        : Effect.fail(invalidPlugin(`${path}.apply`, "predicate must return a boolean", { plugin: plugin.name }))
     )
   )
 }
@@ -443,7 +443,7 @@ export const resolve = <H = FlowsHooks>(
           : invalidPlugin("$", "could not be inspected without executing user code")
     })
     const target = raw.target ?? "engine"
-    const selected = yield* Effect.filter(admitted, ({ plugin }) => included(plugin, config, target))
+    const selected = yield* Effect.filter(admitted, (entry) => included(entry, config, target))
 
     let handlerCount = 0
     for (const { path, plugin } of selected) {
@@ -470,24 +470,25 @@ export const resolve = <H = FlowsHooks>(
     }
 
     const seen = new Set<string>()
-    for (const { plugin } of selected) {
+    for (const { path, plugin } of selected) {
       if (seen.has(plugin.name)) {
         return yield* Effect.fail(failure(
           "duplicate_name",
           `duplicate plugin name "${plugin.name}"`,
-          "$.name",
+          `${path}.name`,
           { plugin: plugin.name }
         ))
       }
       seen.add(plugin.name)
     }
 
-    const plugins = Object.freeze(
-      selected
-        .map(({ plugin }, index) => ({ plugin, index }))
-        .sort((left, right) => rank(left.plugin.enforce) - rank(right.plugin.enforce) || left.index - right.index)
-        .map(({ plugin }) => plugin)
-    )
+    const orderedEntries = selected
+      .map((entry, index) => ({ entry, index }))
+      .sort((left, right) =>
+        rank(left.entry.plugin.enforce) - rank(right.entry.plugin.enforce) || left.index - right.index
+      )
+      .map(({ entry }) => entry)
+    const plugins = Object.freeze(orderedEntries.map(({ plugin }) => plugin))
     const entries: Array<readonly [string, ReadonlyArray<HandlerRecord>]> = []
     for (const hook of Object.keys(known)) {
       const records: Array<{
@@ -514,7 +515,7 @@ export const resolve = <H = FlowsHooks>(
         .map(({ record }) => record)
       if (ordered.length > 0) entries.push([hook, Object.freeze(ordered)])
     }
-    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, plugins)
+    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, orderedEntries)
     return Object.freeze({
       plugins,
       handlers: ImmutableMap.make(entries),

package/src/internal/snapshotCacheEnvironment.ts

@@ -18,24 +18,25 @@ const escapePluginIdentityPart = (value: string): string =>
 
 /**
  * Admits a caller cache environment and prepends one escaped `name@version`
- * identity per plugin, in resolved order. An absent input stays absent.
+ * identity per plugin, in resolved order. An absent input stays absent. A
+ * versionless plugin is refused at the dollar-path it was admitted from.
  *
  * @private
  * @since 1.0.0-rc.0
  */
 export const snapshotCacheEnvironment = <H>(
   input: unknown,
-  plugins: ReadonlyArray<FlowsPlugin<H>>
+  plugins: ReadonlyArray<{ readonly plugin: FlowsPlugin<H>; readonly path: string }>
 ): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {
   if (input === undefined) return Effect.succeed(undefined)
   const pluginIdentities: Array<string> = []
-  for (const plugin of plugins) {
+  for (const { path, plugin } of plugins) {
     if (plugin.version === undefined) {
       return Effect.fail(
         new PluginError({
           code: "cache_environment_invalid",
           message: `cache environment requires a version for plugin "${plugin.name}"`,
-          path: "$.version",
+          path: `${path}.version`,
           plugin: plugin.name
         })
       )