@doeixd/machine 1.0.3 → 1.2.0

package/dist/cjs/development/delegate.js

@@ -0,0 +1,89 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/delegate.ts
+var delegate_exports = {};
+__export(delegate_exports, {
+  createDelegate: () => createDelegate,
+  delegate: () => delegate,
+  delegateAll: () => delegateAll,
+  renameMap: () => renameMap
+});
+module.exports = __toCommonJS(delegate_exports);
+function delegate(ctx, key, next, options) {
+  const child = ctx[key];
+  const delegated = {};
+  const allTransitions = Object.keys(child).filter(
+    (k) => typeof child[k] === "function"
+  );
+  let transitionMap;
+  if (!options) {
+    transitionMap = Object.fromEntries(allTransitions.map((t) => [t, t]));
+  } else if ("pick" in options) {
+    transitionMap = Object.fromEntries(
+      options.pick.filter((t) => allTransitions.includes(t)).map((t) => [t, t])
+    );
+  } else if ("omit" in options) {
+    const omitSet = new Set(options.omit);
+    transitionMap = Object.fromEntries(
+      allTransitions.filter((t) => !omitSet.has(t)).map((t) => [t, t])
+    );
+  } else if ("rename" in options) {
+    transitionMap = Object.fromEntries(
+      Object.entries(options.rename).filter(
+        ([childName]) => allTransitions.includes(childName)
+      )
+    );
+  } else {
+    transitionMap = {};
+  }
+  for (const [childName, parentName] of Object.entries(transitionMap)) {
+    const childTransition = child[childName];
+    delegated[parentName] = (...args) => {
+      const nextChild = childTransition.apply(child, args);
+      return next({ ...ctx, [key]: nextChild });
+    };
+  }
+  return delegated;
+}
+function createDelegate(ctx, next) {
+  return (key, options) => delegate(ctx, key, next, options);
+}
+function delegateAll(ctx, keys, next, prefix = false) {
+  const result = {};
+  for (const key of keys) {
+    const child = ctx[key];
+    const transitions = Object.keys(child).filter(
+      (k) => typeof child[k] === "function"
+    );
+    for (const transitionName of transitions) {
+      const parentName = prefix ? `${String(key)}_${transitionName}` : transitionName;
+      const childTransition = child[transitionName];
+      result[parentName] = (...args) => {
+        const nextChild = childTransition.apply(child, args);
+        return next({ ...ctx, [key]: nextChild });
+      };
+    }
+  }
+  return result;
+}
+function renameMap() {
+  return (mapping) => mapping;
+}
+//# sourceMappingURL=delegate.js.map

package/dist/cjs/development/delegate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/delegate.ts"],
+  "sourcesContent": ["// ============================================================================\n// DELEGATION: delegate()\n// ============================================================================\n\n/**\n * Extracts the names of all function properties (transitions) from a type.\n */\ntype TransitionNamesOf<T> = {\n  [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;\n}[keyof T];\n\n/**\n * Extracts the argument types of a function.\n */\ntype ArgsOf<F> = F extends (...args: infer A) => any ? A : never;\n\n/**\n * Creates delegated transitions that forward to a child and return the parent.\n * \n * @typeParam Child - Child machine type\n * @typeParam Parent - Parent machine return type\n */\ntype DelegatedTransitions<\n  Child extends object,\n  Parent\n> = {\n    [K in TransitionNamesOf<Child>]: (\n      ...args: ArgsOf<Child[K]>\n    ) => Parent;\n  };\n\n/**\n * Renamed delegated transitions using a mapping object.\n * \n * @typeParam Child - Child machine type\n * @typeParam Parent - Parent machine return type\n * @typeParam Mapping - Object mapping child transition names to parent names\n */\ntype RenamedDelegatedTransitions<\n  Child extends object,\n  Parent,\n  Mapping extends Partial<Record<TransitionNamesOf<Child>, string>>\n> = {\n    [K in keyof Mapping as Mapping[K] extends string ? Mapping[K] : never]: K extends TransitionNamesOf<Child>\n    ? (...args: ArgsOf<Child[K]>) => Parent\n    : never;\n  };\n\n/**\n * Subset of delegated transitions.\n * \n * @typeParam Child - Child machine type\n * @typeParam Parent - Parent machine return type\n * @typeParam Keys - Subset of child transition names to delegate\n */\ntype PickedDelegatedTransitions<\n  Child extends object,\n  Parent,\n  Keys extends TransitionNamesOf<Child>\n> = {\n    [K in Keys]: (...args: ArgsOf<Child[K]>) => Parent;\n  };\n\n/**\n * Options for delegate function.\n */\ntype DelegateOptions<Child extends object> =\n  | { pick: Array<TransitionNamesOf<Child>> }\n  | { omit: Array<TransitionNamesOf<Child>> }\n  | { rename: Partial<Record<TransitionNamesOf<Child>, string>> };\n\n/**\n * Delegates child machine transitions to the parent level.\n * \n * When a delegated transition is called on the parent, it:\n * 1. Calls the corresponding transition on the child\n * 2. Updates the parent's context with the new child state\n * 3. Returns a new parent machine\n * \n * This enables \"flat\" composition where child transitions appear directly\n * on the parent, as opposed to `withChildren()` which namespaces them.\n * \n * @typeParam Ctx - Parent context type\n * @typeParam Key - Key where child is stored in parent context\n * @typeParam R - Parent machine return type (e.g. Machine<Ctx, T>)\n * \n * @param ctx - Current parent context (from transition factory)\n * @param key - Property key of the child machine in context\n * @param next - The `next` function from the parent's transition factory\n * @param options - Optional: pick, omit, or rename specific transitions\n * \n * @returns Object of delegated transitions to spread into parent's transitions\n */\nexport function delegate<\n  Ctx extends object,\n  Key extends keyof Ctx,\n  R,\n  Child extends Ctx[Key] & object = Ctx[Key] & object\n>(\n  ctx: Ctx,\n  key: Key,\n  next: (c: Ctx) => R\n): DelegatedTransitions<Child, R>;\n\nexport function delegate<\n  Ctx extends object,\n  Key extends keyof Ctx,\n  R,\n  Child extends Ctx[Key] & object,\n  Keys extends TransitionNamesOf<Child>\n>(\n  ctx: Ctx,\n  key: Key,\n  next: (c: Ctx) => R,\n  options: { pick: Keys[] }\n): PickedDelegatedTransitions<Child, R, Keys>;\n\nexport function delegate<\n  Ctx extends object,\n  Key extends keyof Ctx,\n  R,\n  Child extends Ctx[Key] & object,\n  Keys extends TransitionNamesOf<Child>\n>(\n  ctx: Ctx,\n  key: Key,\n  next: (c: Ctx) => R,\n  options: { omit: Keys[] }\n): DelegatedTransitions<Omit<Child, Keys>, R>;\n\nexport function delegate<\n  Ctx extends object,\n  Key extends keyof Ctx,\n  R,\n  Child extends Ctx[Key] & object,\n  Mapping extends Partial<Record<TransitionNamesOf<Child>, string>>\n>(\n  ctx: Ctx,\n  key: Key,\n  next: (c: Ctx) => R,\n  options: { rename: Mapping }\n): RenamedDelegatedTransitions<Child, R, Mapping>;\n\nexport function delegate<\n  Ctx extends object,\n  Key extends keyof Ctx,\n  R\n>(\n  ctx: Ctx,\n  key: Key,\n  next: (c: Ctx) => R,\n  options?: DelegateOptions<Ctx[Key] & object>\n): Record<string, (...args: unknown[]) => R> {\n  const child = ctx[key] as Record<string, unknown>;\n  const delegated: Record<string, (...args: unknown[]) => R> = {};\n\n  // Get all function property names from child\n  const allTransitions = Object.keys(child).filter(\n    (k) => typeof child[k] === 'function'\n  );\n\n  // Determine which transitions to include and how to name them\n  let transitionMap: Record<string, string>; // childName -> parentName\n\n  if (!options) {\n    // Delegate all with same names\n    transitionMap = Object.fromEntries(allTransitions.map((t) => [t, t]));\n  } else if ('pick' in options) {\n    // Only picked transitions\n    transitionMap = Object.fromEntries(\n      (options.pick as string[]).filter((t) => allTransitions.includes(t)).map((t) => [t, t])\n    );\n  } else if ('omit' in options) {\n    // All except omitted\n    const omitSet = new Set(options.omit as string[]);\n    transitionMap = Object.fromEntries(\n      allTransitions.filter((t) => !omitSet.has(t)).map((t) => [t, t])\n    );\n  } else if ('rename' in options) {\n    // Only renamed transitions with new names\n    transitionMap = Object.fromEntries(\n      Object.entries(options.rename as Record<string, string>).filter(\n        ([childName]) => allTransitions.includes(childName)\n      )\n    );\n  } else {\n    transitionMap = {};\n  }\n\n  // Create delegated transitions\n  for (const [childName, parentName] of Object.entries(transitionMap)) {\n    const childTransition = child[childName] as (...args: unknown[]) => unknown;\n\n    delegated[parentName] = (...args: unknown[]) => {\n      const nextChild = childTransition.apply(child, args);\n      return next({ ...ctx, [key]: nextChild } as Ctx);\n    };\n  }\n\n  return delegated;\n}\n\n/**\n * Type helper to get transition names from a machine or object.\n * Useful for type-safe pick/omit/rename options.\n */\nexport type TransitionsOf<M> = TransitionNamesOf<M>;\n\n// ============================================================================\n// DELEGATION UTILITIES\n// ============================================================================\n\n/**\n * Creates a delegate helper bound to a specific context and next function.\n * Useful when delegating multiple children to avoid repetition.\n */\nexport function createDelegate<Ctx extends object, R>(\n  ctx: Ctx,\n  next: (c: Ctx) => R\n) {\n  return <Key extends keyof Ctx>(\n    key: Key,\n    options?: DelegateOptions<Ctx[Key] & object>\n  ) => delegate(ctx, key, next, options as any);\n}\n\n/**\n * Delegates all transitions from multiple children, optionally with a prefix.\n */\nexport function delegateAll<\n  Ctx extends object,\n  Keys extends keyof Ctx,\n  R\n>(\n  ctx: Ctx,\n  keys: Keys[],\n  next: (c: Ctx) => R,\n  prefix: boolean = false\n): Record<string, (...args: unknown[]) => R> {\n  const result: Record<string, (...args: unknown[]) => R> = {};\n\n  for (const key of keys) {\n    const child = ctx[key] as Record<string, unknown>;\n    const transitions = Object.keys(child).filter(\n      (k) => typeof child[k] === 'function'\n    );\n\n    for (const transitionName of transitions) {\n      const parentName = prefix ? `${String(key)}_${transitionName}` : transitionName;\n      const childTransition = child[transitionName] as (...args: unknown[]) => unknown;\n\n      result[parentName] = (...args: unknown[]) => {\n        const nextChild = childTransition.apply(child, args);\n        return next({ ...ctx, [key]: nextChild } as Ctx);\n      };\n    }\n  }\n\n  return result;\n}\n\n/**\n * Type-safe helper to create a rename mapping for delegate.\n */\nexport function renameMap<M extends object>() {\n  return <T extends Partial<Record<TransitionNamesOf<M>, string>>>(mapping: T): T => mapping;\n}"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+IO,SAAS,SAKd,KACA,KACA,MACA,SAC2C;AAC3C,QAAM,QAAQ,IAAI,GAAG;AACrB,QAAM,YAAuD,CAAC;AAG9D,QAAM,iBAAiB,OAAO,KAAK,KAAK,EAAE;AAAA,IACxC,CAAC,MAAM,OAAO,MAAM,CAAC,MAAM;AAAA,EAC7B;AAGA,MAAI;AAEJ,MAAI,CAAC,SAAS;AAEZ,oBAAgB,OAAO,YAAY,eAAe,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAAA,EACtE,WAAW,UAAU,SAAS;AAE5B,oBAAgB,OAAO;AAAA,MACpB,QAAQ,KAAkB,OAAO,CAAC,MAAM,eAAe,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAAA,IACxF;AAAA,EACF,WAAW,UAAU,SAAS;AAE5B,UAAM,UAAU,IAAI,IAAI,QAAQ,IAAgB;AAChD,oBAAgB,OAAO;AAAA,MACrB,eAAe,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAAA,IACjE;AAAA,EACF,WAAW,YAAY,SAAS;AAE9B,oBAAgB,OAAO;AAAA,MACrB,OAAO,QAAQ,QAAQ,MAAgC,EAAE;AAAA,QACvD,CAAC,CAAC,SAAS,MAAM,eAAe,SAAS,SAAS;AAAA,MACpD;AAAA,IACF;AAAA,EACF,OAAO;AACL,oBAAgB,CAAC;AAAA,EACnB;AAGA,aAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,aAAa,GAAG;AACnE,UAAM,kBAAkB,MAAM,SAAS;AAEvC,cAAU,UAAU,IAAI,IAAI,SAAoB;AAC9C,YAAM,YAAY,gBAAgB,MAAM,OAAO,IAAI;AACnD,aAAO,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,UAAU,CAAQ;AAAA,IACjD;AAAA,EACF;AAEA,SAAO;AACT;AAgBO,SAAS,eACd,KACA,MACA;AACA,SAAO,CACL,KACA,YACG,SAAS,KAAK,KAAK,MAAM,OAAc;AAC9C;AAKO,SAAS,YAKd,KACA,MACA,MACA,SAAkB,OACyB;AAC3C,QAAM,SAAoD,CAAC;AAE3D,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,IAAI,GAAG;AACrB,UAAM,cAAc,OAAO,KAAK,KAAK,EAAE;AAAA,MACrC,CAAC,MAAM,OAAO,MAAM,CAAC,MAAM;AAAA,IAC7B;AAEA,eAAW,kBAAkB,aAAa;AACxC,YAAM,aAAa,SAAS,GAAG,OAAO,GAAG,CAAC,IAAI,cAAc,KAAK;AACjE,YAAM,kBAAkB,MAAM,cAAc;AAE5C,aAAO,UAAU,IAAI,IAAI,SAAoB;AAC3C,cAAM,YAAY,gBAAgB,MAAM,OAAO,IAAI;AACnD,eAAO,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,UAAU,CAAQ;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,YAA8B;AAC5C,SAAO,CAA0D,YAAkB;AACrF;",
+  "names": []
+}