@cnstra/core 2.3.0 → 2.4.0

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export type { ICNS } from './interfaces/ICNS';
 export type { TCNSNeuron } from './types/TCNSNeuron';
 export type { TCNSAxon } from './types/TCNSAxon';
 export type { TCNSDendrite } from './types/TCNSDendrite';
+export type { TCNSHandlerContext } from './types/TCNSHandlerContext';
 export type { TCNSSignal } from './types/TCNSSignal';
 export type { TCNSNeuronActivationTask } from './types/TCNSNeuronActivationTask';
 export type { TCNSStimulationOptions } from './types/TCNSStimulationOptions';
@@ -15,5 +16,6 @@ export type { TCNSAfferentPath } from './types/TCNSAfferentPath';
 export type { TCNSNeuronActivationTaskFailure } from './types/TCNSNeuronActivationTaskFailure';
 export type { TCNSNeuronPersistOptions, TCNSCollateralPersistOptions, TCNSStimulationPersistOptions } from './types/TCNSPersist';
 export type { TCNSStimulationGateOptions, TCNSStimulationGateSignal } from './utils/CNSStimulationGate';
-export { collateral, neuron, withCtx, afferentPath, modality, createPersistRegistry, } from './factory/index';
+export { collateral, neuron, neuronFactory, withCtx, withGlobal, afferentPath, modality, createPersistRegistry, createCNS, } from './factory/index';
+export type { TNeuronFactory } from './factory/index';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC/F,YAAY,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACjI,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAGxG,OAAO,EACH,UAAU,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,qBAAqB,GACxB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC/F,YAAY,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACjI,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAGxG,OAAO,EACH,UAAU,EACV,MAAM,EACN,aAAa,EACb,OAAO,EACP,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,qBAAqB,EACrB,SAAS,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -31,6 +31,12 @@ var CNSDendriteContext = class {
     this.abortSignal = abortSignal;
     this.cns = cns;
   }
+  // Prototype getter, not a constructor field: the per-activation allocation is
+  // unchanged (still 4 fields) and you only pay a single `cns.global` read on the
+  // dendrites that actually reach for it. Value getter, so `{ global }` destructuring is safe.
+  get global() {
+    return this.cns.global;
+  }
   get() {
     return this.stimulation.getContext().get(this.neuron);
   }
@@ -942,7 +948,7 @@ var CNSNetwork = class {
 
 // src/CNS.ts
 var CNS = class {
-  constructor(neurons, options) {
+  constructor(neurons, options, global) {
     this.neurons = neurons;
     this.options = options;
     /**
@@ -955,6 +961,7 @@ var CNS = class {
      */
     this.globalResponseListeners = [];
     this.network = new CNSNetwork(this.neurons);
+    this.global = global;
   }
   addResponseListener(listener) {
     this.globalResponseListeners.push(listener);
@@ -1280,11 +1287,16 @@ var neuron = (axon) => {
   };
   return api;
 };
-var withCtx = () => ({
-  neuron: (axon) => {
-    return neuron(axon);
-  }
-});
+var neuronFactory = () => {
+  const factory = {
+    withCtx: () => factory,
+    withGlobal: () => factory,
+    neuron: (axon) => neuron(axon)
+  };
+  return factory;
+};
+var withCtx = () => neuronFactory();
+var withGlobal = () => neuronFactory();
 var afferentPath = (parentAfferentPath) => {
   return {
     ...parentAfferentPath !== void 0 && {
@@ -1313,7 +1325,15 @@ var createPersistRegistry = (namedNeurons) => {
   }
   return registry;
 };
+var createCNS = (namedNeurons, options) => {
+  const neurons = Object.values(namedNeurons).map(
+    (entry) => entry && typeof entry === "object" && "neuron" in entry ? entry.neuron : entry
+  );
+  const cns = new CNS(neurons, options, options?.global);
+  const registry = createPersistRegistry(namedNeurons);
+  return { cns, registry };
+};
 
-export { CNS, CNSCollateral, CNSPersistOptionsRegistry, CNSStimulationContextStore, CNSStimulationGate, afferentPath, collateral, createPersistRegistry, modality, neuron, withCtx };
+export { CNS, CNSCollateral, CNSPersistOptionsRegistry, CNSStimulationContextStore, CNSStimulationGate, afferentPath, collateral, createCNS, createPersistRegistry, modality, neuron, neuronFactory, withCtx, withGlobal };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map