@tsonic/frontend 0.0.1 → 0.0.2

package/dist/types/ref-parameters.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Ref/Out Parameter Handling - Generate C# ref/out/in keywords from TSByRef wrapper.
+ *
+ * C# supports pass-by-reference parameters (ref, out, in) which don't have direct
+ * JavaScript equivalents. TypeScript code uses TSByRef<T> wrapper:
+ *
+ * TypeScript: const result = { value: 0 }; TryParse("42", result);
+ * C#:         int result; TryParse("42", out result);
+ *
+ * @see spec/ref-out-parameters.md for complete documentation
+ */
+import * as ts from "typescript";
+import type { ParameterMetadata } from "./metadata.js";
+/**
+ * Parameter modifier for C# emission.
+ */
+export type ParameterModifier = "ref" | "out" | "in" | "none";
+/**
+ * Information about a ref/out/in parameter.
+ */
+export type RefParameterInfo = {
+    readonly isRef: boolean;
+    readonly isOut: boolean;
+    readonly isIn: boolean;
+    readonly modifier: ParameterModifier;
+    readonly wrappedType: ts.Type;
+};
+/**
+ * Get ref/out/in information from parameter metadata.
+ *
+ * @param paramMetadata - Parameter metadata from .metadata.json
+ * @returns Parameter modifier to use in C# emission
+ */
+export declare const getParameterModifier: (paramMetadata: ParameterMetadata) => ParameterModifier;
+/**
+ * Check if parameter requires TSByRef wrapper based on metadata.
+ *
+ * @param paramMetadata - Parameter metadata from .metadata.json
+ * @returns True if parameter should use TSByRef<T> in TypeScript
+ */
+export declare const requiresTSByRef: (paramMetadata: ParameterMetadata) => boolean;
+/**
+ * Get ref parameter info from TypeScript type and metadata.
+ *
+ * @param paramType - TypeScript parameter type
+ * @param paramMetadata - Parameter metadata from .metadata.json
+ * @param checker - TypeScript type checker
+ * @returns Ref parameter info if applicable, undefined otherwise
+ */
+export declare const getRefParameterInfo: (paramType: ts.Type, paramMetadata: ParameterMetadata, checker: ts.TypeChecker) => RefParameterInfo | undefined;
+/**
+ * Extract variable name from TSByRef argument expression.
+ *
+ * TypeScript: TryParse("42", result)  // where result = { value: 0 }
+ * C#:         TryParse("42", out result)
+ *
+ * @param argumentNode - Argument AST node
+ * @returns Variable identifier name, or undefined if not extractable
+ */
+export declare const extractRefArgumentVariable: (argumentNode: ts.Expression) => string | undefined;
+/**
+ * Check if argument expression is a TSByRef wrapper object literal.
+ *
+ * Detects: { value: 0 } or { value: initialValue }
+ *
+ * @param argumentNode - Argument AST node
+ * @returns True if argument is object literal with 'value' property
+ */
+export declare const isTSByRefObjectLiteral: (argumentNode: ts.Expression) => boolean;
+/**
+ * Generate C# parameter declaration with modifier.
+ *
+ * @param modifier - Parameter modifier (ref/out/in/none)
+ * @param typeName - C# type name
+ * @param paramName - Parameter name
+ * @returns C# parameter declaration
+ */
+export declare const generateCSharpParameter: (modifier: ParameterModifier, typeName: string, paramName: string) => string;
+/**
+ * Generate C# argument with modifier for method call.
+ *
+ * @param modifier - Parameter modifier (ref/out/in/none)
+ * @param argumentExpression - C# argument expression
+ * @returns C# argument with modifier
+ */
+export declare const generateCSharpArgument: (modifier: ParameterModifier, argumentExpression: string) => string;
+/**
+ * Check if variable declaration is needed for out parameter.
+ *
+ * For out parameters in TypeScript:
+ *   const result = { value: 0 };  // Declaration
+ *   TryParse("42", result);       // Usage
+ *
+ * For out parameters in C#:
+ *   TryParse("42", out int result);  // Inline declaration
+ *
+ * @param argumentNode - Argument AST node
+ * @returns True if variable should be declared before the call
+ */
+export declare const needsOutVariableDeclaration: (argumentNode: ts.Expression) => boolean;
+/**
+ * Extract initial value from TSByRef object literal.
+ *
+ * { value: 42 } → 42
+ * { value: getDefault() } → getDefault()
+ *
+ * @param argumentNode - Argument AST node (must be object literal)
+ * @returns Initial value expression, or undefined if no initializer
+ */
+export declare const extractTSByRefInitialValue: (argumentNode: ts.Expression) => ts.Expression | undefined;
+/**
+ * Determine if ref/out parameter should use inline declaration in C#.
+ *
+ * C# 7.0+ supports inline out var:
+ *   if (int.TryParse("42", out var result)) { ... }
+ *
+ * We use this when the TypeScript code declares the wrapper inline.
+ *
+ * @param argumentNode - Argument AST node
+ * @returns True if should use inline declaration
+ */
+export declare const shouldUseInlineDeclaration: (argumentNode: ts.Expression) => boolean;
+//# sourceMappingURL=ref-parameters.d.ts.map

package/dist/types/ref-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-parameters.d.ts","sourceRoot":"","sources":["../../src/types/ref-parameters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,eAAe,iBAAiB,KAC/B,iBAWF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,eAAe,iBAAiB,KAAG,OAIlE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,EAAE,CAAC,IAAI,EAClB,eAAe,iBAAiB,EAChC,SAAS,EAAE,CAAC,WAAW,KACtB,gBAAgB,GAAG,SAmBrB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,EAAE,CAAC,UAAU,KAC1B,MAAM,GAAG,SAaX,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GACjC,cAAc,EAAE,CAAC,UAAU,KAC1B,OAqBF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,iBAAiB,EAC3B,UAAU,MAAM,EAChB,WAAW,MAAM,KAChB,MAKF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,iBAAiB,EAC3B,oBAAoB,MAAM,KACzB,MAKF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,GACtC,cAAc,EAAE,CAAC,UAAU,KAC1B,OAYF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,EAAE,CAAC,UAAU,KAC1B,EAAE,CAAC,UAAU,GAAG,SAgBlB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,EAAE,CAAC,UAAU,KAC1B,OAGF,CAAC"}

package/dist/types/ref-parameters.js

@@ -0,0 +1,203 @@
+/**
+ * Ref/Out Parameter Handling - Generate C# ref/out/in keywords from TSByRef wrapper.
+ *
+ * C# supports pass-by-reference parameters (ref, out, in) which don't have direct
+ * JavaScript equivalents. TypeScript code uses TSByRef<T> wrapper:
+ *
+ * TypeScript: const result = { value: 0 }; TryParse("42", result);
+ * C#:         int result; TryParse("42", out result);
+ *
+ * @see spec/ref-out-parameters.md for complete documentation
+ */
+import * as ts from "typescript";
+import { isTSByRef, getTSByRefWrappedType } from "./support-types.js";
+/**
+ * Get ref/out/in information from parameter metadata.
+ *
+ * @param paramMetadata - Parameter metadata from .metadata.json
+ * @returns Parameter modifier to use in C# emission
+ */
+export const getParameterModifier = (paramMetadata) => {
+    if (paramMetadata.isOut) {
+        return "out";
+    }
+    if (paramMetadata.isRef) {
+        return "ref";
+    }
+    if (paramMetadata.isIn) {
+        return "in";
+    }
+    return "none";
+};
+/**
+ * Check if parameter requires TSByRef wrapper based on metadata.
+ *
+ * @param paramMetadata - Parameter metadata from .metadata.json
+ * @returns True if parameter should use TSByRef<T> in TypeScript
+ */
+export const requiresTSByRef = (paramMetadata) => {
+    return (paramMetadata.isRef || paramMetadata.isOut || (paramMetadata.isIn ?? false));
+};
+/**
+ * Get ref parameter info from TypeScript type and metadata.
+ *
+ * @param paramType - TypeScript parameter type
+ * @param paramMetadata - Parameter metadata from .metadata.json
+ * @param checker - TypeScript type checker
+ * @returns Ref parameter info if applicable, undefined otherwise
+ */
+export const getRefParameterInfo = (paramType, paramMetadata, checker) => {
+    // Check if type is TSByRef<T>
+    if (!isTSByRef(paramType, checker)) {
+        return undefined;
+    }
+    // Extract wrapped type
+    const wrappedType = getTSByRefWrappedType(paramType, checker);
+    if (!wrappedType) {
+        return undefined;
+    }
+    return {
+        isRef: paramMetadata.isRef,
+        isOut: paramMetadata.isOut,
+        isIn: paramMetadata.isIn ?? false,
+        modifier: getParameterModifier(paramMetadata),
+        wrappedType,
+    };
+};
+/**
+ * Extract variable name from TSByRef argument expression.
+ *
+ * TypeScript: TryParse("42", result)  // where result = { value: 0 }
+ * C#:         TryParse("42", out result)
+ *
+ * @param argumentNode - Argument AST node
+ * @returns Variable identifier name, or undefined if not extractable
+ */
+export const extractRefArgumentVariable = (argumentNode) => {
+    // Handle simple identifier
+    if (ts.isIdentifier(argumentNode)) {
+        return argumentNode.text;
+    }
+    // Handle property access (unlikely for ref params, but possible)
+    if (ts.isPropertyAccessExpression(argumentNode)) {
+        return argumentNode.name.text;
+    }
+    // Cannot extract variable name from complex expressions
+    return undefined;
+};
+/**
+ * Check if argument expression is a TSByRef wrapper object literal.
+ *
+ * Detects: { value: 0 } or { value: initialValue }
+ *
+ * @param argumentNode - Argument AST node
+ * @returns True if argument is object literal with 'value' property
+ */
+export const isTSByRefObjectLiteral = (argumentNode) => {
+    if (!ts.isObjectLiteralExpression(argumentNode)) {
+        return false;
+    }
+    // Check if object has exactly one property named 'value'
+    const properties = argumentNode.properties;
+    if (properties.length !== 1) {
+        return false;
+    }
+    const prop = properties[0];
+    if (!prop || !ts.isPropertyAssignment(prop)) {
+        return false;
+    }
+    if (!ts.isIdentifier(prop.name)) {
+        return false;
+    }
+    return prop.name.text === "value";
+};
+/**
+ * Generate C# parameter declaration with modifier.
+ *
+ * @param modifier - Parameter modifier (ref/out/in/none)
+ * @param typeName - C# type name
+ * @param paramName - Parameter name
+ * @returns C# parameter declaration
+ */
+export const generateCSharpParameter = (modifier, typeName, paramName) => {
+    if (modifier === "none") {
+        return `${typeName} ${paramName}`;
+    }
+    return `${modifier} ${typeName} ${paramName}`;
+};
+/**
+ * Generate C# argument with modifier for method call.
+ *
+ * @param modifier - Parameter modifier (ref/out/in/none)
+ * @param argumentExpression - C# argument expression
+ * @returns C# argument with modifier
+ */
+export const generateCSharpArgument = (modifier, argumentExpression) => {
+    if (modifier === "none") {
+        return argumentExpression;
+    }
+    return `${modifier} ${argumentExpression}`;
+};
+/**
+ * Check if variable declaration is needed for out parameter.
+ *
+ * For out parameters in TypeScript:
+ *   const result = { value: 0 };  // Declaration
+ *   TryParse("42", result);       // Usage
+ *
+ * For out parameters in C#:
+ *   TryParse("42", out int result);  // Inline declaration
+ *
+ * @param argumentNode - Argument AST node
+ * @returns True if variable should be declared before the call
+ */
+export const needsOutVariableDeclaration = (argumentNode) => {
+    // If argument is already a simple identifier, it's already declared
+    if (ts.isIdentifier(argumentNode)) {
+        return false;
+    }
+    // If argument is an object literal { value: ... }, we need to declare the variable
+    if (isTSByRefObjectLiteral(argumentNode)) {
+        return true;
+    }
+    return false;
+};
+/**
+ * Extract initial value from TSByRef object literal.
+ *
+ * { value: 42 } → 42
+ * { value: getDefault() } → getDefault()
+ *
+ * @param argumentNode - Argument AST node (must be object literal)
+ * @returns Initial value expression, or undefined if no initializer
+ */
+export const extractTSByRefInitialValue = (argumentNode) => {
+    if (!ts.isObjectLiteralExpression(argumentNode)) {
+        return undefined;
+    }
+    const properties = argumentNode.properties;
+    if (properties.length !== 1) {
+        return undefined;
+    }
+    const prop = properties[0];
+    if (!prop || !ts.isPropertyAssignment(prop)) {
+        return undefined;
+    }
+    return prop.initializer;
+};
+/**
+ * Determine if ref/out parameter should use inline declaration in C#.
+ *
+ * C# 7.0+ supports inline out var:
+ *   if (int.TryParse("42", out var result)) { ... }
+ *
+ * We use this when the TypeScript code declares the wrapper inline.
+ *
+ * @param argumentNode - Argument AST node
+ * @returns True if should use inline declaration
+ */
+export const shouldUseInlineDeclaration = (argumentNode) => {
+    // Use inline declaration if argument is an object literal
+    return isTSByRefObjectLiteral(argumentNode);
+};
+//# sourceMappingURL=ref-parameters.js.map

package/dist/types/ref-parameters.js.map

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

package/dist/types/ref-parameters.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for ref/out parameter handling
+ */
+export {};
+//# sourceMappingURL=ref-parameters.test.d.ts.map

package/dist/types/ref-parameters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-parameters.test.d.ts","sourceRoot":"","sources":["../../src/types/ref-parameters.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/ref-parameters.test.js

@@ -0,0 +1,147 @@
+/**
+ * Tests for ref/out parameter handling
+ */
+import { describe, it } from "mocha";
+import { strict as assert } from "assert";
+import { getParameterModifier, requiresTSByRef, generateCSharpParameter, generateCSharpArgument, } from "./ref-parameters.js";
+describe("Ref Parameters", () => {
+    describe("getParameterModifier", () => {
+        it("should return 'out' for out parameter", () => {
+            const param = {
+                name: "result",
+                type: "System.Int32",
+                isRef: false,
+                isOut: true,
+                isParams: false,
+            };
+            const modifier = getParameterModifier(param);
+            assert.equal(modifier, "out");
+        });
+        it("should return 'ref' for ref parameter", () => {
+            const param = {
+                name: "value",
+                type: "System.Int32",
+                isRef: true,
+                isOut: false,
+                isParams: false,
+            };
+            const modifier = getParameterModifier(param);
+            assert.equal(modifier, "ref");
+        });
+        it("should return 'in' for in parameter", () => {
+            const param = {
+                name: "data",
+                type: "LargeStruct",
+                isRef: false,
+                isOut: false,
+                isIn: true,
+                isParams: false,
+            };
+            const modifier = getParameterModifier(param);
+            assert.equal(modifier, "in");
+        });
+        it("should return 'none' for regular parameter", () => {
+            const param = {
+                name: "input",
+                type: "System.String",
+                isRef: false,
+                isOut: false,
+                isParams: false,
+            };
+            const modifier = getParameterModifier(param);
+            assert.equal(modifier, "none");
+        });
+        it("should prioritize 'out' over 'ref'", () => {
+            // This should not happen in valid metadata, but test defensive behavior
+            const param = {
+                name: "weird",
+                type: "System.Int32",
+                isRef: true,
+                isOut: true,
+                isParams: false,
+            };
+            const modifier = getParameterModifier(param);
+            assert.equal(modifier, "out");
+        });
+    });
+    describe("requiresTSByRef", () => {
+        it("should return true for out parameter", () => {
+            const param = {
+                name: "result",
+                type: "System.Int32",
+                isRef: false,
+                isOut: true,
+                isParams: false,
+            };
+            assert.ok(requiresTSByRef(param));
+        });
+        it("should return true for ref parameter", () => {
+            const param = {
+                name: "value",
+                type: "System.Int32",
+                isRef: true,
+                isOut: false,
+                isParams: false,
+            };
+            assert.ok(requiresTSByRef(param));
+        });
+        it("should return true for in parameter", () => {
+            const param = {
+                name: "data",
+                type: "LargeStruct",
+                isRef: false,
+                isOut: false,
+                isIn: true,
+                isParams: false,
+            };
+            assert.ok(requiresTSByRef(param));
+        });
+        it("should return false for regular parameter", () => {
+            const param = {
+                name: "input",
+                type: "System.String",
+                isRef: false,
+                isOut: false,
+                isParams: false,
+            };
+            assert.ok(!requiresTSByRef(param));
+        });
+    });
+    describe("generateCSharpParameter", () => {
+        it("should generate out parameter", () => {
+            const param = generateCSharpParameter("out", "int", "result");
+            assert.equal(param, "out int result");
+        });
+        it("should generate ref parameter", () => {
+            const param = generateCSharpParameter("ref", "string", "value");
+            assert.equal(param, "ref string value");
+        });
+        it("should generate in parameter", () => {
+            const param = generateCSharpParameter("in", "LargeStruct", "data");
+            assert.equal(param, "in LargeStruct data");
+        });
+        it("should generate regular parameter without keyword", () => {
+            const param = generateCSharpParameter("none", "string", "input");
+            assert.equal(param, "string input");
+        });
+    });
+    describe("generateCSharpArgument", () => {
+        it("should generate out argument", () => {
+            const arg = generateCSharpArgument("out", "result");
+            assert.equal(arg, "out result");
+        });
+        it("should generate ref argument", () => {
+            const arg = generateCSharpArgument("ref", "value");
+            assert.equal(arg, "ref value");
+        });
+        it("should generate in argument", () => {
+            const arg = generateCSharpArgument("in", "data");
+            assert.equal(arg, "in data");
+        });
+        it("should generate regular argument without keyword", () => {
+            const arg = generateCSharpArgument("none", "input");
+            assert.equal(arg, "input");
+        });
+    });
+});
+//# sourceMappingURL=ref-parameters.test.js.map

package/dist/types/ref-parameters.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-parameters.test.js","sourceRoot":"","sources":["../../src/types/ref-parameters.test.ts"],"names":[],"mappings":"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"}

package/dist/types/result.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Result type for functional error handling
+ */
+export type Result<T, E> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+export declare const ok: <T, E>(value: T) => Result<T, E>;
+export declare const error: <T, E>(error: E) => Result<T, E>;
+export declare const map: <T, U, E>(result: Result<T, E>, fn: (value: T) => U) => Result<U, E>;
+export declare const flatMap: <T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>) => Result<U, E>;
+export declare const mapError: <T, E, F>(result: Result<T, E>, fn: (error: E) => F) => Result<T, F>;
+export declare const unwrapOr: <T, E>(result: Result<T, E>, defaultValue: T) => T;
+export declare const unwrapOrElse: <T, E>(result: Result<T, E>, fn: (error: E) => T) => T;
+export declare const isOk: <T, E>(result: Result<T, E>) => result is {
+    readonly ok: true;
+    readonly value: T;
+};
+export declare const isError: <T, E>(result: Result<T, E>) => result is {
+    readonly ok: false;
+    readonly error: E;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE9C,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAG7C,CAAC;AAEH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAGhD,CAAC;AAEH,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EACzB,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAClB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAgD,CAAC;AAE/D,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC7B,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAC7B,MAAM,CAAC,CAAC,EAAE,CAAC,CAA4C,CAAC;AAE3D,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC9B,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAClB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAmD,CAAC;AAElE,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,KAAG,CAC9B,CAAC;AAE1C,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,CAAC,EAC/B,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAClB,CAAkD,CAAC;AAEtD,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EACvB,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KACnB,MAAM,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAe,CAAC;AAEnE,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,EAC1B,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KACnB,MAAM,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAgB,CAAC"}

package/dist/types/result.js

@@ -0,0 +1,19 @@
+/**
+ * Result type for functional error handling
+ */
+export const ok = (value) => ({
+    ok: true,
+    value,
+});
+export const error = (error) => ({
+    ok: false,
+    error,
+});
+export const map = (result, fn) => (result.ok ? ok(fn(result.value)) : result);
+export const flatMap = (result, fn) => (result.ok ? fn(result.value) : result);
+export const mapError = (result, fn) => (result.ok ? result : error(fn(result.error)));
+export const unwrapOr = (result, defaultValue) => result.ok ? result.value : defaultValue;
+export const unwrapOrElse = (result, fn) => (result.ok ? result.value : fn(result.error));
+export const isOk = (result) => result.ok;
+export const isError = (result) => !result.ok;
+//# sourceMappingURL=result.js.map

package/dist/types/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAO,KAAQ,EAAgB,EAAE,CAAC,CAAC;IACnD,EAAE,EAAE,IAAI;IACR,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAO,KAAQ,EAAgB,EAAE,CAAC,CAAC;IACtD,EAAE,EAAE,KAAK;IACT,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,MAAoB,EACpB,EAAmB,EACL,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,MAAoB,EACpB,EAA8B,EAChB,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,MAAoB,EACpB,EAAmB,EACL,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAO,MAAoB,EAAE,YAAe,EAAK,EAAE,CACzE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAoB,EACpB,EAAmB,EAChB,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,MAAoB,EACgC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;AAEnE,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,MAAoB,EACiC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC"}

package/dist/types/result.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for Result type
+ */
+export {};
+//# sourceMappingURL=result.test.d.ts.map

package/dist/types/result.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.test.d.ts","sourceRoot":"","sources":["../../src/types/result.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}