@pithos/core 2.3.0 → 2.5.0

package/dist/eidos/visitor/visitor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Functional Visitor Pattern.
+ *
+ * In OOP, the Visitor pattern requires a Component interface with `accept()`,
+ * concrete components that call `visitor.visitX(this)`, and Visitor interfaces
+ * with a method per component type. This "double dispatch" works around the
+ * limitation that OOP languages dispatch only on the receiver type.
+ *
+ * In functional TypeScript, this is absorbed by discriminated unions + switch:
+ * - Define your types as a union with a discriminant (`type`, `kind`, `_tag`)
+ * - Use `switch` on the discriminant — TypeScript narrows the type in each case
+ * - Exhaustiveness is checked at compile time
+ *
+ * No wrapper needed — it's native language behavior.
+ *
+ * @module eidos/visitor
+ * @since 2.4.0
+ *
+ * @see {@link https://pithos.dev/api/eidos/visitor/ | Explanations, examples and live demo}
+ *
+ * @example
+ * ```ts
+ * // No import needed — just use discriminated unions + switch:
+ *
+ * type Shape =
+ *   | { type: "circle"; radius: number }
+ *   | { type: "rectangle"; width: number; height: number }
+ *   | { type: "triangle"; base: number; height: number };
+ *
+ * // "Visitor 1" - calculate area
+ * const area = (shape: Shape): number => {
+ *   switch (shape.type) {
+ *     case "circle": return Math.PI * shape.radius ** 2;
+ *     case "rectangle": return shape.width * shape.height;
+ *     case "triangle": return (shape.base * shape.height) / 2;
+ *   }
+ * };
+ *
+ * // "Visitor 2" - describe shape
+ * const describe = (shape: Shape): string => {
+ *   switch (shape.type) {
+ *     case "circle": return `Circle with radius ${shape.radius}`;
+ *     case "rectangle": return `Rectangle ${shape.width}x${shape.height}`;
+ *     case "triangle": return `Triangle base=${shape.base}`;
+ *   }
+ * };
+ *
+ * // Same data, different "visitors" (functions)
+ * const shapes: Shape[] = [
+ *   { type: "circle", radius: 5 },
+ *   { type: "rectangle", width: 3, height: 4 },
+ * ];
+ *
+ * shapes.map(area);     // [78.54, 12]
+ * shapes.map(describe); // ["Circle with radius 5", "Rectangle 3x4"]
+ * ```
+ *
+ * @deprecated **Pattern absorbed by the language.**
+ *
+ * In functional TypeScript, the Visitor pattern is just a switch on a
+ * discriminated union. TypeScript narrows the type in each case branch.
+ *
+ * Write your visitor directly:
+ * ```ts
+ * const visit = (shape: Shape): number => {
+ *   switch (shape.type) {
+ *     case "circle": return Math.PI * shape.radius ** 2;
+ *     case "rectangle": return shape.width * shape.height;
+ *   }
+ * };
+ * ```
+ *
+ * This function is the identity — it exists only so you find this message.
+ *
+ * @see {@link https://pithos.dev/api/eidos/visitor/ | Full explanation, examples and live demo}
+ */
+export declare function visit<T, R>(value: T, visitor: (v: T) => R): R;
+//# sourceMappingURL=visitor.d.ts.map

package/dist/eidos/visitor/visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.d.ts","sourceRoot":"","sources":["../../../src/eidos/visitor/visitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAE7D"}

package/dist/eidos/visitor/visitor.js

@@ -0,0 +1,80 @@
+/**
+ * Functional Visitor Pattern.
+ *
+ * In OOP, the Visitor pattern requires a Component interface with `accept()`,
+ * concrete components that call `visitor.visitX(this)`, and Visitor interfaces
+ * with a method per component type. This "double dispatch" works around the
+ * limitation that OOP languages dispatch only on the receiver type.
+ *
+ * In functional TypeScript, this is absorbed by discriminated unions + switch:
+ * - Define your types as a union with a discriminant (`type`, `kind`, `_tag`)
+ * - Use `switch` on the discriminant — TypeScript narrows the type in each case
+ * - Exhaustiveness is checked at compile time
+ *
+ * No wrapper needed — it's native language behavior.
+ *
+ * @module eidos/visitor
+ * @since 2.4.0
+ *
+ * @see {@link https://pithos.dev/api/eidos/visitor/ | Explanations, examples and live demo}
+ *
+ * @example
+ * ```ts
+ * // No import needed — just use discriminated unions + switch:
+ *
+ * type Shape =
+ *   | { type: "circle"; radius: number }
+ *   | { type: "rectangle"; width: number; height: number }
+ *   | { type: "triangle"; base: number; height: number };
+ *
+ * // "Visitor 1" - calculate area
+ * const area = (shape: Shape): number => {
+ *   switch (shape.type) {
+ *     case "circle": return Math.PI * shape.radius ** 2;
+ *     case "rectangle": return shape.width * shape.height;
+ *     case "triangle": return (shape.base * shape.height) / 2;
+ *   }
+ * };
+ *
+ * // "Visitor 2" - describe shape
+ * const describe = (shape: Shape): string => {
+ *   switch (shape.type) {
+ *     case "circle": return `Circle with radius ${shape.radius}`;
+ *     case "rectangle": return `Rectangle ${shape.width}x${shape.height}`;
+ *     case "triangle": return `Triangle base=${shape.base}`;
+ *   }
+ * };
+ *
+ * // Same data, different "visitors" (functions)
+ * const shapes: Shape[] = [
+ *   { type: "circle", radius: 5 },
+ *   { type: "rectangle", width: 3, height: 4 },
+ * ];
+ *
+ * shapes.map(area);     // [78.54, 12]
+ * shapes.map(describe); // ["Circle with radius 5", "Rectangle 3x4"]
+ * ```
+ *
+ * @deprecated **Pattern absorbed by the language.**
+ *
+ * In functional TypeScript, the Visitor pattern is just a switch on a
+ * discriminated union. TypeScript narrows the type in each case branch.
+ *
+ * Write your visitor directly:
+ * ```ts
+ * const visit = (shape: Shape): number => {
+ *   switch (shape.type) {
+ *     case "circle": return Math.PI * shape.radius ** 2;
+ *     case "rectangle": return shape.width * shape.height;
+ *   }
+ * };
+ * ```
+ *
+ * This function is the identity — it exists only so you find this message.
+ *
+ * @see {@link https://pithos.dev/api/eidos/visitor/ | Full explanation, examples and live demo}
+ */
+export function visit(value, visitor) {
+    return visitor(value);
+}
+//# sourceMappingURL=visitor.js.map

package/dist/eidos/visitor/visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.js","sourceRoot":"","sources":["../../../src/eidos/visitor/visitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,MAAM,UAAU,KAAK,CAAO,KAAQ,EAAE,OAAoB;IACxD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/zygos/result/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Barrel re-export for Result.
+ *
+ * Provides a single import point for all Result-related exports.
+ *
+ * @example
+ * ```typescript
+ * import { Result, ok, err, Ok, Err, ResultAsync } from '@pithos/core/zygos/result';
+ *
+ * const r: Result<number, string> = ok(42);
+ * const safe = Result.fromThrowable(JSON.parse);
+ * const combined = Result.combine([ok(1), ok(2)]);
+ * ```
+ *
+ * @since 2.4.0
+ */
+export { Result, Ok, Err, ok, err, safeTry, safeAsyncTry, fromOption, fromEither, toEither, } from "./result.js";
+export { ResultAsync, okAsync, errAsync, } from "./result-async.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/zygos/result/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/zygos/result/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAEL,MAAM,EAGN,EAAE,EACF,GAAG,EAGH,EAAE,EACF,GAAG,EAGH,OAAO,EACP,YAAY,EAGZ,UAAU,EACV,UAAU,EACV,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,OAAO,EACP,QAAQ,GACT,MAAM,mBAAmB,CAAC"}

package/dist/zygos/result/index.js

@@ -0,0 +1,29 @@
+/**
+ * Barrel re-export for Result.
+ *
+ * Provides a single import point for all Result-related exports.
+ *
+ * @example
+ * ```typescript
+ * import { Result, ok, err, Ok, Err, ResultAsync } from '@pithos/core/zygos/result';
+ *
+ * const r: Result<number, string> = ok(42);
+ * const safe = Result.fromThrowable(JSON.parse);
+ * const combined = Result.combine([ok(1), ok(2)]);
+ * ```
+ *
+ * @since 2.4.0
+ */
+export { 
+// Type + Namespace (declaration merging: works as both)
+Result, 
+// Classes
+Ok, Err, 
+// Constructors
+ok, err, 
+// Utilities
+safeTry, safeAsyncTry, 
+// Conversions
+fromOption, fromEither, toEither, } from "./result.js";
+export { ResultAsync, okAsync, errAsync, } from "./result-async.js";
+//# sourceMappingURL=index.js.map

package/dist/zygos/result/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/zygos/result/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO;AACL,wDAAwD;AACxD,MAAM;AAEN,UAAU;AACV,EAAE,EACF,GAAG;AAEH,eAAe;AACf,EAAE,EACF,GAAG;AAEH,YAAY;AACZ,OAAO,EACP,YAAY;AAEZ,cAAc;AACd,UAAU,EACV,UAAU,EACV,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,OAAO,EACP,QAAQ,GACT,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pithos/core",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "Advanced JavaScript/TypeScript superset providing utilities, validation, and functional patterns",
   "type": "module",
   "publishConfig": {
@@ -27,6 +27,29 @@
     "./arkhe/types/utilities/*": "./dist/arkhe/types/utilities/*.js",
     "./arkhe/util/*": "./dist/arkhe/util/*.js",
     "./bridges/*": "./dist/bridges/*.js",
+    "./eidos/abstract-factory/*": "./dist/eidos/abstract-factory/*.js",
+    "./eidos/adapter/*": "./dist/eidos/adapter/*.js",
+    "./eidos/bridge/*": "./dist/eidos/bridge/*.js",
+    "./eidos/builder/*": "./dist/eidos/builder/*.js",
+    "./eidos/chain/*": "./dist/eidos/chain/*.js",
+    "./eidos/command/*": "./dist/eidos/command/*.js",
+    "./eidos/composite/*": "./dist/eidos/composite/*.js",
+    "./eidos/decorator/*": "./dist/eidos/decorator/*.js",
+    "./eidos/facade/*": "./dist/eidos/facade/*.js",
+    "./eidos/factory-method/*": "./dist/eidos/factory-method/*.js",
+    "./eidos/flyweight/*": "./dist/eidos/flyweight/*.js",
+    "./eidos/interpreter/*": "./dist/eidos/interpreter/*.js",
+    "./eidos/iterator/*": "./dist/eidos/iterator/*.js",
+    "./eidos/mediator/*": "./dist/eidos/mediator/*.js",
+    "./eidos/memento/*": "./dist/eidos/memento/*.js",
+    "./eidos/observer/*": "./dist/eidos/observer/*.js",
+    "./eidos/prototype/*": "./dist/eidos/prototype/*.js",
+    "./eidos/proxy/*": "./dist/eidos/proxy/*.js",
+    "./eidos/singleton/*": "./dist/eidos/singleton/*.js",
+    "./eidos/state/*": "./dist/eidos/state/*.js",
+    "./eidos/strategy/*": "./dist/eidos/strategy/*.js",
+    "./eidos/template/*": "./dist/eidos/template/*.js",
+    "./eidos/visitor/*": "./dist/eidos/visitor/*.js",
     "./kanon/core/consts/*": "./dist/kanon/core/consts/*.js",
     "./kanon/core/*": "./dist/kanon/core/*.js",
     "./kanon/helpers/*": "./dist/kanon/helpers/*.js",
@@ -60,7 +83,8 @@
     "./taphos/string/*": "./dist/taphos/string/*.js",
     "./taphos/util/*": "./dist/taphos/util/*.js",
     "./zygos/*": "./dist/zygos/*.js",
-    "./zygos/result/*": "./dist/zygos/result/*.js"
+    "./zygos/result/*": "./dist/zygos/result/*.js",
+    "./zygos/result": "./dist/zygos/result/index.js"
   },
   "files": [
     "dist",
@@ -77,7 +101,8 @@
     "lodash-alternative",
     "zod-alternative",
     "neverthrow-alternative",
-    "fp-ts-alternative"
+    "fp-ts-alternative",
+    "effect-alternative"
   ],
   "author": "Pierre Moati <mopi1402>",
   "license": "MIT",