@soundscript/soundscript 0.1.0

package/decode.d.ts

@@ -0,0 +1,84 @@
+import { type ErrorFrame, Failure } from '@soundscript/soundscript/failures';
+import type { Option, Result } from '@soundscript/soundscript/result';
+
+export type DecodePathSegment = string | number;
+export type DecodePath = readonly DecodePathSegment[];
+
+export class DecodeFailure extends Failure {
+  readonly path: DecodePath;
+  constructor(
+    message?: string,
+    options?: {
+      cause?: unknown;
+      path?: DecodePath;
+      trace?: readonly ErrorFrame[];
+    },
+  );
+  at(segment: DecodePathSegment): this;
+}
+
+export interface Decoder<T, E = DecodeFailure> {
+  decode(value: unknown): Result<T, E>;
+}
+
+export interface OptionalDecoder<T, E = DecodeFailure> extends Decoder<T | undefined, E> {
+  readonly __soundscriptOptional: true;
+  readonly inner: Decoder<T, E>;
+}
+
+type DecoderValue<TDecoder> = TDecoder extends Decoder<infer TValue, unknown> ? TValue : never;
+type DecoderError<TDecoder> = TDecoder extends Decoder<unknown, infer E> ? E : never;
+type ObjectShape = Record<string, Decoder<unknown, unknown>>;
+type TupleShape = readonly Decoder<unknown, unknown>[];
+
+export const string: Decoder<string>;
+export const number: Decoder<number>;
+export const boolean: Decoder<boolean>;
+export const bigint: Decoder<bigint>;
+export function lazy<T, E>(getDecoder: () => Decoder<T, E>): Decoder<T, E>;
+
+export function optional<T, E>(decoder: Decoder<T, E>): OptionalDecoder<T, E>;
+export function literal<const T extends string | number | boolean | null>(value: T): Decoder<T>;
+export function array<T, E>(item: Decoder<T, E>): Decoder<readonly T[], E | DecodeFailure>;
+export function tuple<const TElements extends TupleShape>(
+  ...elements: TElements
+): Decoder<
+  { readonly [K in keyof TElements]: DecoderValue<TElements[K]> },
+  DecoderError<TElements[number]> | DecodeFailure
+>;
+export function option<T, E>(item: Decoder<T, E>): Decoder<Option<T>, E | DecodeFailure>;
+export function result<T, EValue, EDecodeValue, EDecodeError>(
+  okDecoder: Decoder<T, EDecodeValue>,
+  errDecoder: Decoder<EValue, EDecodeError>,
+): Decoder<Result<T, EValue>, EDecodeValue | EDecodeError | DecodeFailure>;
+export function object<TShape extends ObjectShape>(
+  shape: TShape,
+): Decoder<
+  { readonly [K in keyof TShape]: DecoderValue<TShape[K]> },
+  DecoderError<TShape[keyof TShape]> | DecodeFailure
+>;
+export function field<K extends string, T, E>(
+  key: K,
+  decoder: Decoder<T, E>,
+): Decoder<T, E | DecodeFailure>;
+export function optionalField<K extends string, T, E>(
+  key: K,
+  decoder: Decoder<T, E>,
+): Decoder<T | undefined, E | DecodeFailure>;
+export function union<A, B, ELeft, ERight>(
+  left: Decoder<A, ELeft>,
+  right: Decoder<B, ERight>,
+): Decoder<A | B, ELeft | ERight | DecodeFailure>;
+export function map<A, B, E>(
+  decoder: Decoder<A, E>,
+  project: (value: A) => B,
+): Decoder<B, E>;
+export function andThen<A, B, E>(
+  decoder: Decoder<A, E>,
+  project: (value: A) => Decoder<B, E>,
+): Decoder<B, E>;
+export function refine<A, B extends A, E>(
+  decoder: Decoder<A, E>,
+  predicate: (value: A) => value is B,
+  message: string,
+): Decoder<B, E | DecodeFailure>;

package/decode.js

@@ -0,0 +1,249 @@
+import { Failure } from '@soundscript/soundscript/failures';
+import { err, isErr, ok } from '@soundscript/soundscript/result';
+export class DecodeFailure extends Failure {
+    constructor(message = 'Failed to decode value.', options = {}) {
+        super(message, { cause: options.cause, trace: options.trace });
+        this.path = options.path ?? [];
+    }
+    at(segment) {
+        const prototype = Object.getPrototypeOf(this);
+        const clone = (prototype === null ? Object.create(null) : Object.create(prototype));
+        Object.defineProperties(clone, Object.getOwnPropertyDescriptors(this));
+        Object.defineProperty(clone, 'path', {
+            configurable: true,
+            enumerable: true,
+            writable: false,
+            value: [segment, ...this.path],
+        });
+        return clone;
+    }
+}
+export const string = {
+    decode(value) {
+        return typeof value === 'string'
+            ? ok(value)
+            : err(new DecodeFailure('Expected string.', { cause: value }));
+    },
+};
+export const number = {
+    decode(value) {
+        return typeof value === 'number'
+            ? ok(value)
+            : err(new DecodeFailure('Expected number.', { cause: value }));
+    },
+};
+export const boolean = {
+    decode(value) {
+        return typeof value === 'boolean'
+            ? ok(value)
+            : err(new DecodeFailure('Expected boolean.', { cause: value }));
+    },
+};
+export const bigint = {
+    decode(value) {
+        if (typeof value === 'bigint') {
+            return ok(value);
+        }
+        if (typeof value === 'number') {
+            return Number.isInteger(value) && Number.isSafeInteger(value)
+                ? ok(BigInt(value))
+                : err(new DecodeFailure('Expected bigint.', { cause: value }));
+        }
+        if (typeof value === 'string') {
+            try {
+                return ok(BigInt(value));
+            }
+            catch {
+                return err(new DecodeFailure('Expected bigint.', { cause: value }));
+            }
+        }
+        return err(new DecodeFailure('Expected bigint.', { cause: value }));
+    },
+};
+export function lazy(getDecoder) {
+    return {
+        decode(value) {
+            return getDecoder().decode(value);
+        },
+    };
+}
+export function optional(decoder) {
+    return {
+        __soundscriptOptional: true,
+        inner: decoder,
+        decode(value) {
+            return value === undefined ? ok(undefined) : decoder.decode(value);
+        },
+    };
+}
+export function literal(value) {
+    return {
+        decode(input) {
+            return Object.is(input, value)
+                ? ok(value)
+                : err(new DecodeFailure(`Expected literal ${JSON.stringify(value)}.`, { cause: input }));
+        },
+    };
+}
+export function array(item) {
+    return {
+        decode(value) {
+            if (!Array.isArray(value)) {
+                return err(new DecodeFailure('Expected array.', { cause: value }));
+            }
+            const decodedValues = [];
+            for (let index = 0; index < value.length; index += 1) {
+                const decoded = item.decode(value[index]);
+                if (isErr(decoded)) {
+                    return err(prependPathIfPossible(decoded.error, index));
+                }
+                decodedValues.push(decoded.value);
+            }
+            return ok(decodedValues);
+        },
+    };
+}
+export function tuple(...elements) {
+    return {
+        decode(value) {
+            if (!Array.isArray(value)) {
+                return err(new DecodeFailure('Expected tuple.', { cause: value }));
+            }
+            if (value.length !== elements.length) {
+                return err(new DecodeFailure(`Expected tuple of length ${elements.length}.`, {
+                    cause: value,
+                }));
+            }
+            const decodedValues = [];
+            for (let index = 0; index < elements.length; index += 1) {
+                const elementDecoder = elements[index];
+                if (!elementDecoder) {
+                    continue;
+                }
+                const decoded = elementDecoder.decode(value[index]);
+                if (isErr(decoded)) {
+                    return err(prependPathIfPossible(decoded.error, index));
+                }
+                decodedValues.push(decoded.value);
+            }
+            return ok(decodedValues);
+        },
+    };
+}
+export function option(item) {
+    return union(map(object({
+        tag: literal('ok'),
+        value: item,
+    }), (value) => ok(value.value)), map(object({
+        tag: literal('err'),
+    }), () => err()));
+}
+export function result(okDecoder, errDecoder) {
+    return union(map(object({
+        tag: literal('ok'),
+        value: okDecoder,
+    }), (value) => ok(value.value)), map(object({
+        tag: literal('err'),
+        error: errDecoder,
+    }), (value) => err(value.error)));
+}
+export function object(shape) {
+    return {
+        decode(value) {
+            if (!isPlainObject(value)) {
+                return err(new DecodeFailure('Expected object.', { cause: value }));
+            }
+            const record = value;
+            const decodedObject = {};
+            for (const key of Object.keys(shape)) {
+                const decoder = shape[key];
+                const hasKey = key in record;
+                const rawValue = record[key];
+                if (!hasKey || rawValue === undefined) {
+                    if (isOptionalDecoder(decoder)) {
+                        decodedObject[key] = undefined;
+                        continue;
+                    }
+                    return err(new DecodeFailure(`Missing field "${key}".`, {
+                        cause: value,
+                        path: [key],
+                    }));
+                }
+                const decoded = decoder.decode(rawValue);
+                if (isErr(decoded)) {
+                    return err(prependPathIfPossible(decoded.error, key));
+                }
+                decodedObject[key] = decoded.value;
+            }
+            return ok(decodedObject);
+        },
+    };
+}
+export function field(key, decoder) {
+    const shape = { [key]: decoder };
+    return map(object(shape), (value) => value[key]);
+}
+export function optionalField(key, decoder) {
+    const shape = { [key]: optional(decoder) };
+    return map(object(shape), (value) => value[key]);
+}
+export function union(left, right) {
+    return {
+        decode(value) {
+            const leftDecoded = left.decode(value);
+            if (isErr(leftDecoded)) {
+                const rightDecoded = right.decode(value);
+                if (isErr(rightDecoded)) {
+                    return err(new DecodeFailure('Expected one of the union members.', {
+                        cause: value,
+                    }));
+                }
+                return rightDecoded;
+            }
+            return leftDecoded;
+        },
+    };
+}
+export function map(decoder, project) {
+    return {
+        decode(value) {
+            const decoded = decoder.decode(value);
+            return isErr(decoded) ? decoded : ok(project(decoded.value));
+        },
+    };
+}
+export function andThen(decoder, project) {
+    return {
+        decode(value) {
+            const decoded = decoder.decode(value);
+            return isErr(decoded) ? decoded : project(decoded.value).decode(valueOf(decoded));
+        },
+    };
+}
+export function refine(decoder, predicate, message) {
+    return {
+        decode(value) {
+            const decoded = decoder.decode(value);
+            if (isErr(decoded)) {
+                return decoded;
+            }
+            return predicate(decoded.value)
+                ? ok(decoded.value)
+                : err(new DecodeFailure(message, { cause: value }));
+        },
+    };
+}
+function prependPathIfPossible(error, segment) {
+    return error instanceof DecodeFailure ? error.at(segment) : error;
+}
+function isOptionalDecoder(value) {
+    return '__soundscriptOptional' in value &&
+        value.__soundscriptOptional === true;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function valueOf(decoded) {
+    return decoded.value;
+}
+//# sourceMappingURL=decode.js.map

package/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["./soundscript/decode.sts"],"names":[],"mappings":"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","sourcesContent":["import { type ErrorFrame, Failure } from '@soundscript/soundscript/failures';\nimport { err, isErr, ok, type Option, type Result } from '@soundscript/soundscript/result';\n\nexport type DecodePathSegment = string | number;\nexport type DecodePath = readonly DecodePathSegment[];\n\nexport class DecodeFailure extends Failure {\n  readonly path: DecodePath;\n\n  constructor(\n    message = 'Failed to decode value.',\n    options: {\n      cause?: unknown;\n      path?: DecodePath;\n      trace?: readonly ErrorFrame[];\n    } = {},\n  ) {\n    super(message, { cause: options.cause, trace: options.trace });\n    this.path = options.path ?? [];\n  }\n\n  at(segment: DecodePathSegment): this {\n    const prototype = Object.getPrototypeOf(this as object);\n    const clone = (prototype === null ? Object.create(null) : Object.create(prototype)) as this;\n    Object.defineProperties(clone, Object.getOwnPropertyDescriptors(this));\n    Object.defineProperty(clone, 'path', {\n      configurable: true,\n      enumerable: true,\n      writable: false,\n      value: [segment, ...this.path],\n    });\n    return clone;\n  }\n}\n\nexport interface Decoder<T, E = DecodeFailure> {\n  decode(value: unknown): Result<T, E>;\n}\n\nexport interface OptionalDecoder<T, E = DecodeFailure> extends Decoder<T | undefined, E> {\n  readonly __soundscriptOptional: true;\n  readonly inner: Decoder<T, E>;\n}\n\ntype DecoderValue<TDecoder> = TDecoder extends Decoder<infer TValue, unknown> ? TValue : never;\ntype DecoderError<TDecoder> = TDecoder extends Decoder<unknown, infer E> ? E : never;\n\ntype ObjectShape = Record<string, Decoder<unknown, unknown>>;\ntype TupleShape = readonly Decoder<unknown, unknown>[];\n\nexport const string: Decoder<string> = {\n  decode(value) {\n    return typeof value === 'string'\n      ? ok(value)\n      : err(new DecodeFailure('Expected string.', { cause: value }));\n  },\n};\n\nexport const number: Decoder<number> = {\n  decode(value) {\n    return typeof value === 'number'\n      ? ok(value)\n      : err(new DecodeFailure('Expected number.', { cause: value }));\n  },\n};\n\nexport const boolean: Decoder<boolean> = {\n  decode(value) {\n    return typeof value === 'boolean'\n      ? ok(value)\n      : err(new DecodeFailure('Expected boolean.', { cause: value }));\n  },\n};\n\nexport const bigint: Decoder<bigint> = {\n  decode(value) {\n    if (typeof value === 'bigint') {\n      return ok(value);\n    }\n\n    if (typeof value === 'number') {\n      return Number.isInteger(value) && Number.isSafeInteger(value)\n        ? ok(BigInt(value))\n        : err(new DecodeFailure('Expected bigint.', { cause: value }));\n    }\n\n    if (typeof value === 'string') {\n      try {\n        return ok(BigInt(value));\n      } catch {\n        return err(new DecodeFailure('Expected bigint.', { cause: value }));\n      }\n    }\n\n    return err(new DecodeFailure('Expected bigint.', { cause: value }));\n  },\n};\n\nexport function lazy<T, E>(getDecoder: () => Decoder<T, E>): Decoder<T, E> {\n  return {\n    decode(value) {\n      return getDecoder().decode(value);\n    },\n  };\n}\n\nexport function optional<T, E>(decoder: Decoder<T, E>): OptionalDecoder<T, E> {\n  return {\n    __soundscriptOptional: true,\n    inner: decoder,\n    decode(value) {\n      return value === undefined ? ok(undefined) : decoder.decode(value);\n    },\n  };\n}\n\nexport function literal<const T extends string | number | boolean | null>(value: T): Decoder<T> {\n  return {\n    decode(input) {\n      return Object.is(input, value)\n        ? ok(value)\n        : err(new DecodeFailure(`Expected literal ${JSON.stringify(value)}.`, { cause: input }));\n    },\n  };\n}\n\nexport function array<T, E>(item: Decoder<T, E>): Decoder<readonly T[], E | DecodeFailure> {\n  return {\n    decode(value) {\n      if (!Array.isArray(value)) {\n        return err(new DecodeFailure('Expected array.', { cause: value }));\n      }\n\n      const decodedValues: T[] = [];\n      for (let index = 0; index < value.length; index += 1) {\n        const decoded = item.decode(value[index]);\n        if (isErr(decoded)) {\n          return err(prependPathIfPossible(decoded.error, index));\n        }\n        decodedValues.push(decoded.value);\n      }\n\n      return ok(decodedValues);\n    },\n  };\n}\n\nexport function tuple<const TElements extends TupleShape>(\n  ...elements: TElements\n): Decoder<\n  { readonly [K in keyof TElements]: DecoderValue<TElements[K]> },\n  DecoderError<TElements[number]> | DecodeFailure\n> {\n  return {\n    decode(value) {\n      if (!Array.isArray(value)) {\n        return err(new DecodeFailure('Expected tuple.', { cause: value }));\n      }\n\n      if (value.length !== elements.length) {\n        return err(\n          new DecodeFailure(`Expected tuple of length ${elements.length}.`, {\n            cause: value,\n          }),\n        );\n      }\n\n      const decodedValues: unknown[] = [];\n      for (let index = 0; index < elements.length; index += 1) {\n        const elementDecoder = elements[index];\n        if (!elementDecoder) {\n          continue;\n        }\n        const decoded = elementDecoder.decode(value[index]);\n        if (isErr(decoded)) {\n          return err(\n            prependPathIfPossible(decoded.error, index) as\n              | DecoderError<TElements[number]>\n              | DecodeFailure,\n          );\n        }\n        decodedValues.push(decoded.value);\n      }\n\n      return ok(decodedValues as { readonly [K in keyof TElements]: DecoderValue<TElements[K]> });\n    },\n  };\n}\n\nexport function option<T, E>(item: Decoder<T, E>): Decoder<Option<T>, E | DecodeFailure> {\n  return union(\n    map(\n      object({\n        tag: literal('ok'),\n        value: item,\n      }),\n      (value) => ok(value.value) as Option<T>,\n    ),\n    map(\n      object({\n        tag: literal('err'),\n      }),\n      () => err() as Option<T>,\n    ),\n  );\n}\n\nexport function result<T, EValue, EDecodeValue, EDecodeError>(\n  okDecoder: Decoder<T, EDecodeValue>,\n  errDecoder: Decoder<EValue, EDecodeError>,\n): Decoder<Result<T, EValue>, EDecodeValue | EDecodeError | DecodeFailure> {\n  return union(\n    map(\n      object({\n        tag: literal('ok'),\n        value: okDecoder,\n      }),\n      (value) => ok(value.value) as Result<T, EValue>,\n    ),\n    map(\n      object({\n        tag: literal('err'),\n        error: errDecoder,\n      }),\n      (value) => err(value.error) as Result<T, EValue>,\n    ),\n  );\n}\n\nexport function object<TShape extends ObjectShape>(\n  shape: TShape,\n): Decoder<\n  { readonly [K in keyof TShape]: DecoderValue<TShape[K]> },\n  DecoderError<TShape[keyof TShape]> | DecodeFailure\n> {\n  return {\n    decode(value) {\n      if (!isPlainObject(value)) {\n        return err(new DecodeFailure('Expected object.', { cause: value }));\n      }\n\n      const record = value as Record<string, unknown>;\n      const decodedObject: Record<string, unknown> = {};\n\n      for (const key of Object.keys(shape)) {\n        const decoder = shape[key];\n        const hasKey = key in record;\n        const rawValue = record[key];\n\n        if (!hasKey || rawValue === undefined) {\n          if (isOptionalDecoder(decoder)) {\n            decodedObject[key] = undefined;\n            continue;\n          }\n\n          return err(\n            new DecodeFailure(`Missing field \"${key}\".`, {\n              cause: value,\n              path: [key],\n            }),\n          );\n        }\n\n        const decoded = decoder.decode(rawValue);\n        if (isErr(decoded)) {\n          return err(\n            prependPathIfPossible(decoded.error, key) as\n              | DecoderError<TShape[keyof TShape]>\n              | DecodeFailure,\n          );\n        }\n\n        decodedObject[key] = decoded.value;\n      }\n\n      return ok(decodedObject as { readonly [K in keyof TShape]: DecoderValue<TShape[K]> });\n    },\n  };\n}\n\nexport function field<K extends string, T, E>(\n  key: K,\n  decoder: Decoder<T, E>,\n): Decoder<T, E | DecodeFailure> {\n  const shape = { [key]: decoder } as { readonly [P in K]: Decoder<T, E> };\n  return map(object(shape), (value) => value[key]);\n}\n\nexport function optionalField<K extends string, T, E>(\n  key: K,\n  decoder: Decoder<T, E>,\n): Decoder<T | undefined, E | DecodeFailure> {\n  const shape = { [key]: optional(decoder) } as {\n    readonly [P in K]: OptionalDecoder<T, E>;\n  };\n  return map(object(shape), (value) => value[key]);\n}\n\nexport function union<A, B, ELeft, ERight>(\n  left: Decoder<A, ELeft>,\n  right: Decoder<B, ERight>,\n): Decoder<A | B, ELeft | ERight | DecodeFailure> {\n  return {\n    decode(value) {\n      const leftDecoded = left.decode(value);\n      if (isErr(leftDecoded)) {\n        const rightDecoded = right.decode(value);\n        if (isErr(rightDecoded)) {\n          return err(\n            new DecodeFailure('Expected one of the union members.', {\n              cause: value,\n            }),\n          );\n        }\n        return rightDecoded;\n      }\n      return leftDecoded;\n    },\n  };\n}\n\nexport function map<A, B, E>(\n  decoder: Decoder<A, E>,\n  project: (value: A) => B,\n): Decoder<B, E> {\n  return {\n    decode(value) {\n      const decoded = decoder.decode(value);\n      return isErr(decoded) ? decoded : ok(project(decoded.value));\n    },\n  };\n}\n\nexport function andThen<A, B, E>(\n  decoder: Decoder<A, E>,\n  project: (value: A) => Decoder<B, E>,\n): Decoder<B, E> {\n  return {\n    decode(value) {\n      const decoded = decoder.decode(value);\n      return isErr(decoded) ? decoded : project(decoded.value).decode(valueOf(decoded));\n    },\n  };\n}\n\nexport function refine<A, B extends A, E>(\n  decoder: Decoder<A, E>,\n  predicate: (value: A) => value is B,\n  message: string,\n): Decoder<B, E | DecodeFailure> {\n  return {\n    decode(value) {\n      const decoded = decoder.decode(value);\n      if (isErr(decoded)) {\n        return decoded;\n      }\n\n      return predicate(decoded.value)\n        ? ok(decoded.value)\n        : err(new DecodeFailure(message, { cause: value }));\n    },\n  };\n}\n\nfunction prependPathIfPossible<E>(error: E, segment: DecodePathSegment): E | DecodeFailure {\n  return error instanceof DecodeFailure ? error.at(segment) : error;\n}\n\nfunction isOptionalDecoder(\n  value: Decoder<unknown, unknown>,\n): value is OptionalDecoder<unknown, unknown> {\n  return '__soundscriptOptional' in value &&\n    value.__soundscriptOptional === true;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction valueOf<T>(decoded: { readonly value: T }): T {\n  return decoded.value;\n}\n"]}

package/encode.d.ts

@@ -0,0 +1,98 @@
+import type { Bind, Kind3, TypeLambda } from '@soundscript/soundscript/hkt';
+import { Failure } from '@soundscript/soundscript/failures';
+import type { Option, Result } from '@soundscript/soundscript/result';
+import type { Contravariant } from '@soundscript/soundscript/typeclasses';
+
+export class EncodeFailure extends Failure {
+  constructor(message?: string, cause?: unknown);
+}
+
+export interface Encoder<T, TEncoded = unknown, E = EncodeFailure> {
+  encode(value: T): Result<TEncoded, E>;
+}
+
+export interface OptionalEncoder<T, TEncoded = T, E = EncodeFailure>
+  extends Encoder<T | undefined, TEncoded | undefined, E> {
+  readonly __soundscriptOptional: true;
+  readonly inner: Encoder<T, TEncoded, E>;
+}
+
+type EncoderInput<TEncoder> = TEncoder extends Encoder<infer TValue, unknown, unknown> ? TValue
+  : never;
+type EncoderOutput<TEncoder> = TEncoder extends Encoder<unknown, infer TEncoded, unknown>
+  ? TEncoded
+  : never;
+type EncoderError<TEncoder> = TEncoder extends Encoder<unknown, unknown, infer E> ? E : never;
+type ObjectShape = Record<string, Encoder<unknown, unknown, unknown>>;
+type TupleShape = readonly Encoder<unknown, unknown, unknown>[];
+
+export interface EncoderF extends TypeLambda {
+  readonly type: Encoder<this['Args'][2], this['Args'][1], this['Args'][0]>;
+}
+
+export type EncoderKind<E, TEncoded, T> = Kind3<EncoderF, E, TEncoded, T>;
+
+export function fromEncode<T, TEncoded, E>(
+  encode: (value: T) => Result<TEncoded, E>,
+): Encoder<T, TEncoded, E>;
+export function contramap<A, B, TEncoded, E>(
+  encoder: Encoder<A, TEncoded, E>,
+  project: (value: B) => A,
+): Encoder<B, TEncoded, E>;
+export function encoderContravariant<TEncoded, E = EncodeFailure>(): Contravariant<
+  Bind<Bind<EncoderF, [E]>, [TEncoded]>
+>;
+
+export const stringEncoder: Encoder<string, string>;
+export const numberEncoder: Encoder<number, number>;
+export const booleanEncoder: Encoder<boolean, boolean>;
+export const bigintEncoder: Encoder<bigint, bigint>;
+
+export function optional<T, TEncoded, E>(
+  encoder: Encoder<T, TEncoded, E>,
+): OptionalEncoder<T, TEncoded, E>;
+export function lazy<T, TEncoded, E>(
+  getEncoder: () => Encoder<T, TEncoded, E>,
+): Encoder<T, TEncoded, E>;
+export function nullable<T, TEncoded, E>(
+  encoder: Encoder<T, TEncoded, E>,
+): Encoder<T | null, TEncoded | null, E>;
+export function literal<const T extends string | number | boolean | null>(value: T): Encoder<T, T>;
+export function array<T, TEncoded, E>(
+  item: Encoder<T, TEncoded, E>,
+): Encoder<readonly T[], readonly TEncoded[], E | EncodeFailure>;
+export function tuple<const TElements extends TupleShape>(
+  ...elements: TElements
+): Encoder<
+  { readonly [K in keyof TElements]: EncoderInput<TElements[K]> },
+  { readonly [K in keyof TElements]: EncoderOutput<TElements[K]> },
+  EncoderError<TElements[number]>
+>;
+export function option<T, TEncoded, E>(
+  item: Encoder<T, TEncoded, E>,
+): Encoder<
+  Option<T>,
+  { readonly error?: undefined; readonly tag: 'err' } | {
+    readonly tag: 'ok';
+    readonly value: TEncoded;
+  },
+  E
+>;
+export function result<T, EValue, TEncoded, EEncoded, EOk, EErr>(
+  okEncoder: Encoder<T, TEncoded, EOk>,
+  errEncoder: Encoder<EValue, EEncoded, EErr>,
+): Encoder<
+  Result<T, EValue>,
+  { readonly tag: 'ok'; readonly value: TEncoded } | {
+    readonly error: EEncoded;
+    readonly tag: 'err';
+  },
+  EOk | EErr
+>;
+export function object<TShape extends ObjectShape>(
+  shape: TShape,
+): Encoder<
+  { readonly [K in keyof TShape]: EncoderInput<TShape[K]> },
+  { readonly [K in keyof TShape]: EncoderOutput<TShape[K]> },
+  EncoderError<TShape[keyof TShape]> | EncodeFailure
+>;

package/encode.js

@@ -0,0 +1,128 @@
+import { Failure } from '@soundscript/soundscript/failures';
+import { err, isErr, ok } from '@soundscript/soundscript/result';
+export class EncodeFailure extends Failure {
+    constructor(message = 'Failed to encode value.', cause) {
+        super(message, { cause });
+    }
+}
+export function fromEncode(encode) {
+    return {
+        encode,
+    };
+}
+export function contramap(encoder, project) {
+    return fromEncode((value) => encoder.encode(project(value)));
+}
+export function encoderContravariant() {
+    return {
+        contramap,
+    };
+}
+export const stringEncoder = fromEncode((value) => ok(value));
+export const numberEncoder = fromEncode((value) => ok(value));
+export const booleanEncoder = fromEncode((value) => ok(value));
+export const bigintEncoder = fromEncode((value) => ok(value));
+export function optional(encoder) {
+    return {
+        __soundscriptOptional: true,
+        inner: encoder,
+        encode(value) {
+            return value === undefined ? ok(undefined) : encoder.encode(value);
+        },
+    };
+}
+export function lazy(getEncoder) {
+    return fromEncode((value) => getEncoder().encode(value));
+}
+export function nullable(encoder) {
+    return fromEncode((value) => value === null ? ok(null) : encoder.encode(value));
+}
+export function literal(value) {
+    return fromEncode((input) => Object.is(input, value)
+        ? ok(value)
+        : err(new EncodeFailure(`Expected literal ${JSON.stringify(value)}.`, input)));
+}
+export function array(item) {
+    return fromEncode((value) => {
+        const encodedValues = [];
+        for (const entry of value) {
+            const encoded = item.encode(entry);
+            if (isErr(encoded)) {
+                return encoded;
+            }
+            encodedValues.push(encoded.value);
+        }
+        return ok(encodedValues);
+    });
+}
+export function tuple(...elements) {
+    return fromEncode((value) => {
+        const values = value;
+        const encodedValues = [];
+        for (let index = 0; index < elements.length; index += 1) {
+            const elementEncoder = elements[index];
+            if (!elementEncoder) {
+                continue;
+            }
+            const encoded = elementEncoder.encode(values[index]);
+            if (isErr(encoded)) {
+                return encoded;
+            }
+            encodedValues.push(encoded.value);
+        }
+        return ok(encodedValues);
+    });
+}
+export function option(item) {
+    return fromEncode((value) => {
+        if (value.tag === 'ok') {
+            const encoded = item.encode(value.value);
+            return isErr(encoded) ? encoded : ok({ tag: 'ok', value: encoded.value });
+        }
+        return ok({ tag: 'err', error: undefined });
+    });
+}
+export function result(okEncoder, errEncoder) {
+    return fromEncode((value) => {
+        if (value.tag === 'ok') {
+            const encoded = okEncoder.encode(value.value);
+            return isErr(encoded) ? encoded : ok({ tag: 'ok', value: encoded.value });
+        }
+        const encoded = errEncoder.encode(value.error);
+        return isErr(encoded) ? encoded : ok({ tag: 'err', error: encoded.value });
+    });
+}
+export function object(shape) {
+    return fromEncode((value) => {
+        if (!isPlainObject(value)) {
+            return err(new EncodeFailure('Expected object.', value));
+        }
+        const record = value;
+        const encodedObject = {};
+        for (const key of Object.keys(shape)) {
+            const encoder = shape[key];
+            const hasKey = key in record;
+            const rawValue = record[key];
+            if (!hasKey || rawValue === undefined) {
+                if (isOptionalEncoder(encoder)) {
+                    encodedObject[key] = undefined;
+                    continue;
+                }
+                return err(new EncodeFailure(`Missing field "${key}".`, value));
+            }
+            const encoded = encoder.encode(rawValue);
+            if (isErr(encoded)) {
+                return encoded;
+            }
+            encodedObject[key] = encoded.value;
+        }
+        return ok(encodedObject);
+    });
+}
+function isOptionalEncoder(value) {
+    return '__soundscriptOptional' in value && value.__soundscriptOptional === true;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=encode.js.map

package/encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.js","sourceRoot":"","sources":["./soundscript/encode.sts"],"names":[],"mappings":"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","sourcesContent":["import { type Bind, type Kind3, type TypeLambda } from '@soundscript/soundscript/hkt';\nimport { Failure } from '@soundscript/soundscript/failures';\nimport { err, isErr, ok, type Option, type Result } from '@soundscript/soundscript/result';\nimport type { Contravariant } from '@soundscript/soundscript/typeclasses';\n\nexport class EncodeFailure extends Failure {\n  constructor(message = 'Failed to encode value.', cause?: unknown) {\n    super(message, { cause });\n  }\n}\n\nexport interface Encoder<T, TEncoded = unknown, E = EncodeFailure> {\n  encode(value: T): Result<TEncoded, E>;\n}\n\nexport interface OptionalEncoder<T, TEncoded = T, E = EncodeFailure>\n  extends Encoder<T | undefined, TEncoded | undefined, E> {\n  readonly __soundscriptOptional: true;\n  readonly inner: Encoder<T, TEncoded, E>;\n}\n\ntype EncoderInput<TEncoder> = TEncoder extends Encoder<infer T, unknown, unknown> ? T : never;\ntype EncoderOutput<TEncoder> = TEncoder extends Encoder<unknown, infer TEncoded, unknown> ? TEncoded\n  : never;\ntype EncoderError<TEncoder> = TEncoder extends Encoder<unknown, unknown, infer E> ? E : never;\ntype ObjectShape = Record<string, Encoder<unknown, unknown, unknown>>;\ntype TupleShape = readonly Encoder<unknown, unknown, unknown>[];\n\nexport interface EncoderF extends TypeLambda {\n  readonly type: Encoder<this['Args'][2], this['Args'][1], this['Args'][0]>;\n}\n\nexport type EncoderKind<E, TEncoded, T> = Kind3<EncoderF, E, TEncoded, T>;\n\nexport function fromEncode<T, TEncoded, E>(\n  encode: (value: T) => Result<TEncoded, E>,\n): Encoder<T, TEncoded, E> {\n  return {\n    encode,\n  };\n}\n\nexport function contramap<A, B, TEncoded, E>(\n  encoder: Encoder<A, TEncoded, E>,\n  project: (value: B) => A,\n): Encoder<B, TEncoded, E> {\n  return fromEncode((value) => encoder.encode(project(value)));\n}\n\nexport function encoderContravariant<TEncoded, E = EncodeFailure>(): Contravariant<\n  Bind<Bind<EncoderF, [E]>, [TEncoded]>\n> {\n  return {\n    contramap,\n  };\n}\n\nexport const stringEncoder: Encoder<string, string> = fromEncode((value) => ok(value));\nexport const numberEncoder: Encoder<number, number> = fromEncode((value) => ok(value));\nexport const booleanEncoder: Encoder<boolean, boolean> = fromEncode((value) => ok(value));\nexport const bigintEncoder: Encoder<bigint, bigint> = fromEncode((value) => ok(value));\n\nexport function optional<T, TEncoded, E>(\n  encoder: Encoder<T, TEncoded, E>,\n): OptionalEncoder<T, TEncoded, E> {\n  return {\n    __soundscriptOptional: true,\n    inner: encoder,\n    encode(value) {\n      return value === undefined ? ok(undefined) : encoder.encode(value);\n    },\n  };\n}\n\nexport function lazy<T, TEncoded, E>(\n  getEncoder: () => Encoder<T, TEncoded, E>,\n): Encoder<T, TEncoded, E> {\n  return fromEncode((value) => getEncoder().encode(value));\n}\n\nexport function nullable<T, TEncoded, E>(\n  encoder: Encoder<T, TEncoded, E>,\n): Encoder<T | null, TEncoded | null, E> {\n  return fromEncode((value) => value === null ? ok(null) : encoder.encode(value));\n}\n\nexport function literal<const T extends string | number | boolean | null>(value: T): Encoder<T, T> {\n  return fromEncode((input) =>\n    Object.is(input, value)\n      ? ok(value)\n      : err(new EncodeFailure(`Expected literal ${JSON.stringify(value)}.`, input))\n  );\n}\n\nexport function array<T, TEncoded, E>(\n  item: Encoder<T, TEncoded, E>,\n): Encoder<readonly T[], readonly TEncoded[], E | EncodeFailure> {\n  return fromEncode((value) => {\n    const encodedValues: TEncoded[] = [];\n    for (const entry of value) {\n      const encoded = item.encode(entry);\n      if (isErr(encoded)) {\n        return encoded;\n      }\n      encodedValues.push(encoded.value);\n    }\n    return ok(encodedValues);\n  });\n}\n\nexport function tuple<const TElements extends TupleShape>(\n  ...elements: TElements\n): Encoder<\n  { readonly [K in keyof TElements]: EncoderInput<TElements[K]> },\n  { readonly [K in keyof TElements]: EncoderOutput<TElements[K]> },\n  EncoderError<TElements[number]>\n> {\n  return fromEncode((value) => {\n    const values = value as readonly unknown[];\n    const encodedValues: unknown[] = [];\n    for (let index = 0; index < elements.length; index += 1) {\n      const elementEncoder = elements[index];\n      if (!elementEncoder) {\n        continue;\n      }\n      const encoded = elementEncoder.encode(values[index] as never);\n      if (isErr(encoded)) {\n        return encoded as Result<\n          { readonly [K in keyof TElements]: EncoderOutput<TElements[K]> },\n          EncoderError<TElements[number]>\n        >;\n      }\n      encodedValues.push(encoded.value);\n    }\n    return ok(encodedValues as { readonly [K in keyof TElements]: EncoderOutput<TElements[K]> });\n  });\n}\n\nexport function option<T, TEncoded, E>(\n  item: Encoder<T, TEncoded, E>,\n): Encoder<\n  Option<T>,\n  { readonly error?: undefined; readonly tag: 'err' } | {\n    readonly tag: 'ok';\n    readonly value: TEncoded;\n  },\n  E\n> {\n  return fromEncode<\n    Option<T>,\n    { readonly error?: undefined; readonly tag: 'err' } | {\n      readonly tag: 'ok';\n      readonly value: TEncoded;\n    },\n    E\n  >((value) => {\n    if (value.tag === 'ok') {\n      const encoded = item.encode(value.value);\n      return isErr(encoded) ? encoded : ok({ tag: 'ok', value: encoded.value });\n    }\n\n    return ok({ tag: 'err', error: undefined });\n  });\n}\n\nexport function result<T, EValue, TEncoded, EEncoded, EOk, EErr>(\n  okEncoder: Encoder<T, TEncoded, EOk>,\n  errEncoder: Encoder<EValue, EEncoded, EErr>,\n): Encoder<\n  Result<T, EValue>,\n  { readonly tag: 'ok'; readonly value: TEncoded } | {\n    readonly error: EEncoded;\n    readonly tag: 'err';\n  },\n  EOk | EErr\n> {\n  return fromEncode<\n    Result<T, EValue>,\n    { readonly tag: 'ok'; readonly value: TEncoded } | {\n      readonly error: EEncoded;\n      readonly tag: 'err';\n    },\n    EOk | EErr\n  >((value) => {\n    if (value.tag === 'ok') {\n      const encoded = okEncoder.encode(value.value);\n      return isErr(encoded) ? encoded : ok({ tag: 'ok', value: encoded.value });\n    }\n\n    const encoded = errEncoder.encode(value.error);\n    return isErr(encoded) ? encoded : ok({ tag: 'err', error: encoded.value });\n  });\n}\n\nexport function object<TShape extends ObjectShape>(\n  shape: TShape,\n): Encoder<\n  { readonly [K in keyof TShape]: EncoderInput<TShape[K]> },\n  { readonly [K in keyof TShape]: EncoderOutput<TShape[K]> },\n  EncoderError<TShape[keyof TShape]> | EncodeFailure\n> {\n  return fromEncode<\n    { readonly [K in keyof TShape]: EncoderInput<TShape[K]> },\n    { readonly [K in keyof TShape]: EncoderOutput<TShape[K]> },\n    EncoderError<TShape[keyof TShape]> | EncodeFailure\n  >((value) => {\n    if (!isPlainObject(value)) {\n      return err<EncoderError<TShape[keyof TShape]> | EncodeFailure>(\n        new EncodeFailure('Expected object.', value),\n      );\n    }\n\n    const record = value as Record<string, unknown>;\n    const encodedObject: Record<string, unknown> = {};\n\n    for (const key of Object.keys(shape)) {\n      const encoder = shape[key];\n      const hasKey = key in record;\n      const rawValue = record[key];\n\n      if (!hasKey || rawValue === undefined) {\n        if (isOptionalEncoder(encoder)) {\n          encodedObject[key] = undefined;\n          continue;\n        }\n\n        return err<EncoderError<TShape[keyof TShape]> | EncodeFailure>(\n          new EncodeFailure(`Missing field \"${key}\".`, value),\n        );\n      }\n\n      const encoded = encoder.encode(rawValue as never) as Result<\n        unknown,\n        EncoderError<TShape[keyof TShape]> | EncodeFailure\n      >;\n      if (isErr(encoded)) {\n        return encoded;\n      }\n      encodedObject[key] = encoded.value;\n    }\n\n    return ok(encodedObject as { readonly [K in keyof TShape]: EncoderOutput<TShape[K]> });\n  });\n}\n\nfunction isOptionalEncoder(\n  value: Encoder<unknown, unknown, unknown>,\n): value is OptionalEncoder<unknown, unknown, unknown> {\n  return '__soundscriptOptional' in value && value.__soundscriptOptional === true;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"]}

package/experimental/component.d.ts

@@ -0,0 +1,40 @@
+export interface ComponentContextKey<T> {
+  readonly __ss_component_context_key: symbol;
+  readonly __ss_component_context_type__?: (_value: T) => T;
+}
+
+export interface ComponentEvent<Detail = unknown, Target = unknown> {
+  readonly currentTarget: Target;
+  readonly detail: Detail;
+  readonly target: Target;
+  readonly type: string;
+}
+
+export function state<T>(value: T): T;
+export function awaited<T, PendingResult, FulfilledResult, RejectedResult = never>(
+  promise: PromiseLike<T>,
+  pending: PendingResult | (() => PendingResult),
+  fulfilled: (value: T) => FulfilledResult,
+  rejected?: (error: unknown) => RejectedResult,
+): PendingResult | FulfilledResult | RejectedResult;
+export function boundary<RenderResult, FallbackResult>(
+  render: () => RenderResult,
+  fallback: (error: unknown) => FallbackResult,
+): RenderResult | FallbackResult;
+export function context<T>(): ComponentContextKey<T>;
+export function dispatch<T = undefined>(type: string, detail?: T): void;
+export function derived<T>(compute: () => T): T;
+export function effect<T>(callback: () => T): T;
+export function onMount<T>(callback: () => T): T;
+export function prop<T = never>(): T;
+export function prop<T>(value: T): T;
+export function provide<T, R>(context: ComponentContextKey<T>, value: T, content: R): R;
+export function provide<T, R>(
+  context: ComponentContextKey<T>,
+  value: T,
+  content: () => R,
+): R;
+export function useContext<T>(value: ComponentContextKey<T>): T;
+export function useStore<T>(value: T): T;
+export function component<T>(value: T): T;
+export function store<T>(value: T): T;