@ix-xs/node-comfort 2.0.0 → 2.1.0

package/types/src/Schema.d.ts

@@ -1,5 +1,5 @@
 declare namespace _exports {
-    export { Infer, Shape, Simplify, ObjectOutput, SafeParseResult, Message, RefineOptions, ParseContext, Step, CoerceBuilders };
+    export { Infer, Shape, Simplify, ObjectOutput, SafeParseResult, Message, RefineOptions, ParseContext, Step, JSONSchema, _JSONContext, CoerceBuilders };
 }
 declare namespace _exports {
     export { string };
@@ -12,6 +12,7 @@ declare namespace _exports {
     export { array };
     export { object };
     export { union };
+    export { discriminatedUnion };
     export { tuple };
     export { record };
     export { lazy };
@@ -40,16 +41,19 @@ type Simplify<T> = { [K in keyof T]: T[K]; } & {};
  */
 type ObjectOutput<S extends Shape> = Simplify<{ [K in keyof S as undefined extends Infer<S[K]> ? never : K]: Infer<S[K]>; } & { [K in keyof S as undefined extends Infer<S[K]> ? K : never]?: Infer<S[K]>; }>;
 /**
- * What `safeParse()` returns.
+ * What `safeParse()` returns. On failure, `issues` is the plain list and
+ * `error` the same thing as a `ValidationError`, built when you read it.
  */
 type SafeParseResult<T> = {
     success: true;
     data: T;
     error?: undefined;
+    issues?: undefined;
 } | {
     success: false;
     data?: undefined;
     error: ValidationError;
+    issues: import("./errors").ValidationIssue[];
 };
 /**
  * An error message: a string, or a function that gets the invalid value.
@@ -77,7 +81,8 @@ type ParseContext = {
     path: Array<string | number>;
 };
 /**
- * A step in a schema: a check, a transformation or a refinement.
+ * A step in a schema: a check, a transformation, a refinement or a pipe
+ * into another schema.
  */
 type Step = {
     kind: "check";
@@ -85,6 +90,7 @@ type Step = {
     code: string;
     message: Message;
     details?: Record<string, unknown>;
+    json?: Record<string, unknown>;
 } | {
     kind: "transform";
     fn: (value: any) => any;
@@ -92,6 +98,19 @@ type Step = {
     kind: "refine";
     test: (value: any) => boolean;
     options: RefineOptions;
+} | {
+    kind: "pipe";
+    schema: Schema<any>;
+};
+/**
+ * A JSON Schema, as made by `toJSONSchema()`.
+ */
+type JSONSchema = {
+    [keyword: string]: any;
+};
+type _JSONContext = {
+    defs: Record<string, JSONSchema>;
+    names: Map<Schema<any>, string>;
 };
 /**
  * The `s.coerce` builders.
@@ -233,6 +252,24 @@ declare function object<S extends Shape>(shape: S): ObjectSchema<S>;
  * @returns {UnionSchema<Infer<U[number]>>}
  */
 declare function union<U extends ReadonlyArray<Schema<any>>>(options: U): UnionSchema<Infer<U[number]>>;
+/**
+ * A union of objects told apart by one key, like the `type` of an event.
+ * Unlike `union()`, it goes straight to the right schema, and a wrong
+ * object gets the errors of the kind it claims to be.
+ *
+ * @example
+ * const Event = s.discriminatedUnion("type", [
+ *   s.object({ type: s.literal("click"), x: s.number(), y: s.number() }),
+ *   s.object({ type: s.literal("key"), key: s.string() }),
+ * ]);
+ * Event.parse({ type: "key", key: "Enter" });
+ *
+ * @template {ReadonlyArray<ObjectSchema<any>>} U
+ * @param {string} key The key every option has, with a different literal in each.
+ * @param {U} options
+ * @returns {DiscriminatedUnionSchema<Infer<U[number]>>}
+ */
+declare function discriminatedUnion<U extends ReadonlyArray<ObjectSchema<any>>>(key: string, options: U): DiscriminatedUnionSchema<Infer<U[number]>>;
 /**
  * A fixed-length array with one schema per position.
  *
@@ -404,7 +441,7 @@ declare class Schema<T = unknown> {
      */
     safeParse(value: unknown): SafeParseResult<T>;
     /**
-     * Is the value valid? Works as a type guard. Transformations don't run.
+     * Is the value valid? Works as a type guard, and builds no error.
      *
      * @example
      * if (Email.is(input)) sendMail(input); // input is a string here
@@ -499,6 +536,53 @@ declare class Schema<T = unknown> {
      * @returns {ArraySchema<T>}
      */
     array(): ArraySchema<T>;
+    /**
+     * Sends the result into another schema. With `transform()` in between,
+     * it validates what a conversion produced.
+     *
+     * @example
+     * const Port = s.string().transform(Number).pipe(s.number().int().min(1).max(65535));
+     * Port.parse("8080"); // 8080
+     * Port.parse("abc");  // ValidationError: Expected number, received NaN
+     *
+     * @template U
+     * @param {Schema<U>} next
+     * @returns {Schema<U>}
+     */
+    pipe<U>(next: Schema<U>): Schema<U>;
+    /**
+     * Describes what this schema accepts as a JSON Schema (draft 2020-12).
+     * Use it for an OpenAPI document, a form generator, or the input of a
+     * tool you give to a language model. Rules that only exist in code,
+     * like `refine()`, `transform()` and what follows a `pipe()`, can't be
+     * expressed and are left out.
+     *
+     * @example
+     * s.object({ name: s.string().min(2), age: s.number().int().optional() }).toJSONSchema();
+     * // {
+     * //   type: "object",
+     * //   properties: { name: { type: "string", minLength: 2 }, age: { type: "integer" } },
+     * //   required: ["name"],
+     * // }
+     *
+     * @returns {JSONSchema}
+     */
+    toJSONSchema(): JSONSchema;
+    /**
+     * The JSON Schema of the type itself. Subclasses override it.
+     * @param {_JSONContext} _ctx
+     * @returns {JSONSchema}
+     * @protected
+     */
+    protected _json(_ctx: _JSONContext): JSONSchema;
+    /**
+     * The JSON Schema with what every schema can carry: rules, `null`,
+     * a description, a default.
+     * @param {_JSONContext} ctx
+     * @returns {JSONSchema}
+     * @protected
+     */
+    protected _toJSON(ctx: _JSONContext): JSONSchema;
     /**
      * Attaches a description, available as `.description`. Useful to generate
      * docs or forms.
@@ -525,10 +609,11 @@ declare class StringSchema extends Schema<string> {
      * @param {string} code
      * @param {Message} message
      * @param {Record<string, unknown>} [details]
+     * @param {Record<string, unknown>} [json] What the rule is called in JSON Schema.
      * @returns {this}
      * @protected
      */
-    protected _rule(test: (v: string) => boolean, code: string, message: Message, details?: Record<string, unknown>): this;
+    protected _rule(test: (v: string) => boolean, code: string, message: Message, details?: Record<string, unknown>, json?: Record<string, unknown>): this;
     /**
      * At least `length` characters.
      * @param {number} length
@@ -633,6 +718,54 @@ declare class StringSchema extends Schema<string> {
      * @returns {this}
      */
     toUpperCase(): this;
+    /**
+     * A calendar date like `2024-01-31`, without a time.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    date(message?: Message): this;
+    /**
+     * A URL slug like `my-first-post`: lowercase letters, digits and single dashes.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    slug(message?: Message): this;
+    /**
+     * Hexadecimal digits only.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    hex(message?: Message): this;
+    /**
+     * Base64 data.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    base64(message?: Message): this;
+    /**
+     * A ULID.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    ulid(message?: Message): this;
+    /**
+     * A semantic version like `1.4.0` or `2.0.0-beta.1`.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    semver(message?: Message): this;
+    /**
+     * A host name like `api.example.com`.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    hostname(message?: Message): this;
+    /**
+     * @returns {JSONSchema}
+     * @override
+     * @protected
+     */
+    protected override _json(): JSONSchema;
 }
 /**
  * A number schema.
@@ -648,10 +781,11 @@ declare class NumberSchema extends Schema<number> {
      * @param {string} code
      * @param {Message} message
      * @param {Record<string, unknown>} [details]
+     * @param {Record<string, unknown>} [json] What the rule is called in JSON Schema.
      * @returns {this}
      * @protected
      */
-    protected _rule(test: (v: number) => boolean, code: string, message: Message, details?: Record<string, unknown>): this;
+    protected _rule(test: (v: number) => boolean, code: string, message: Message, details?: Record<string, unknown>, json?: Record<string, unknown>): this;
     /**
      * At least `value`.
      * @param {number} value
@@ -697,6 +831,33 @@ declare class NumberSchema extends Schema<number> {
      * @returns {this}
      */
     multipleOf(step: number, message?: Message): this;
+    /**
+     * Greater than `value`, which itself is refused.
+     * @param {number} value
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    gt(value: number, message?: Message): this;
+    /**
+     * Less than `value`, which itself is refused.
+     * @param {number} value
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    lt(value: number, message?: Message): this;
+    /**
+     * An integer JavaScript can hold exactly: up to 2^53 - 1 either way.
+     * Ids from a database or an API should pass this before any arithmetic.
+     * @param {Message} [message]
+     * @returns {this}
+     */
+    safe(message?: Message): this;
+    /**
+     * @returns {JSONSchema}
+     * @override
+     * @protected
+     */
+    protected override _json(): JSONSchema;
 }
 /**
  * A boolean schema.
@@ -707,6 +868,12 @@ declare class BooleanSchema extends Schema<boolean> {
     constructor();
     /** @protected */
     protected _coerce: boolean;
+    /**
+     * @returns {JSONSchema}
+     * @override
+     * @protected
+     */
+    protected override _json(): JSONSchema;
 }
 /**
  * A date schema.
@@ -731,6 +898,12 @@ declare class DateSchema extends Schema<Date> {
      * @returns {this}
      */
     max(date: Date | number | string, message?: Message): this;
+    /**
+     * @returns {JSONSchema}
+     * @override
+     * @protected
+     */
+    protected override _json(): JSONSchema;
 }
 /**
  * A bigint schema.
@@ -741,6 +914,12 @@ declare class BigIntSchema extends Schema<bigint> {
     constructor();
     /** @protected */
     protected _coerce: boolean;
+    /**
+     * @returns {JSONSchema}
+     * @override
+     * @protected
+     */
+    protected override _json(): JSONSchema;
 }
 /**
  * A schema that accepts a fixed set of values.
@@ -753,6 +932,14 @@ declare class LiteralSchema<T> extends Schema<T> {
     constructor(values: readonly T[]);
     /** @protected */
     protected _values: readonly T[];
+    /** @protected @type {Set<unknown>} */
+    protected _set: Set<unknown>;
+    /**
+     * @returns {JSONSchema}
+     * @override
+     * @protected
+     */
+    protected override _json(): JSONSchema;
     /** The accepted values. */
     get options(): T[];
 }
@@ -771,10 +958,12 @@ declare class ArraySchema<T> extends Schema<T[]> {
      * @param {(v: T[]) => boolean} test
      * @param {string} code
      * @param {Message} message
+     * @param {Record<string, unknown>} [details]
+     * @param {Record<string, unknown>} [json]
      * @returns {this}
      * @protected
      */
-    protected _rule(test: (v: T[]) => boolean, code: string, message: Message): this;
+    protected _rule(test: (v: T[]) => boolean, code: string, message: Message, details?: Record<string, unknown>, json?: Record<string, unknown>): this;
     /**
      * At least `count` items.
      * @param {number} count
@@ -825,6 +1014,17 @@ declare class ObjectSchema<S extends Shape> extends Schema<{ [K_1 in keyof S as
     protected _unknown: "strip" | "strict" | "passthrough";
     /** @protected */
     protected _shape: S;
+    /** @protected @type {string[]} */
+    protected _keys: string[];
+    /** @protected @type {Array<Schema<any>>} */
+    protected _schemas: Array<Schema<any>>;
+    /**
+     * A schema with another shape that keeps how this one treats unknown keys.
+     * @param {Shape} shape
+     * @returns {any}
+     * @protected
+     */
+    protected _reshape(shape: Shape): any;
     /** The schema of each key. */
     get shape(): S;
     /**
@@ -863,6 +1063,34 @@ declare class ObjectSchema<S extends Shape> extends Schema<{ [K_1 in keyof S as
      * @returns {ObjectSchema<{ [K in keyof S]: Schema<Infer<S[K]> | undefined> }>}
      */
     partial(): ObjectSchema<{ [K_3 in keyof S]: Schema<Infer<S[K_3]> | undefined>; }>;
+    /**
+     * Makes every key required again: the opposite of `partial()`.
+     * @returns {ObjectSchema<{ [K in keyof S]: Schema<Exclude<Infer<S[K]>, undefined>> }>}
+     */
+    required(): ObjectSchema<{ [K_3 in keyof S]: Schema<Exclude<Infer<S[K_3]>, undefined>>; }>;
+    /**
+     * Combines two object schemas. Keys of the other one win, and so does
+     * its way of treating unknown keys.
+     *
+     * @example
+     * const Timestamps = s.object({ createdAt: s.date(), updatedAt: s.date() });
+     * const Post = s.object({ title: s.string() }).merge(Timestamps);
+     *
+     * @template {Shape} M
+     * @param {ObjectSchema<M>} other
+     * @returns {ObjectSchema<Omit<S, keyof M> & M>}
+     */
+    merge<M extends Shape>(other: ObjectSchema<M>): ObjectSchema<Omit<S, keyof M> & M>;
+    /**
+     * A schema that accepts the name of any key: handy for a `sort` or
+     * `fields` query parameter.
+     *
+     * @example
+     * const SortBy = User.keyof(); // "name" | "email" | "age" | "role"
+     *
+     * @returns {LiteralSchema<keyof S & string>}
+     */
+    keyof(): LiteralSchema<keyof S & string>;
 }
 /**
  * A schema that accepts any of several schemas.
@@ -876,6 +1104,25 @@ declare class UnionSchema<T> extends Schema<T> {
     /** @protected */
     protected _options: readonly Schema<any>[];
 }
+/**
+ * A union of objects told apart by one key.
+ *
+ * @template T
+ * @extends {Schema<T>}
+ */
+declare class DiscriminatedUnionSchema<T> extends Schema<T> {
+    /**
+     * @param {string} key
+     * @param {ReadonlyArray<ObjectSchema<any>>} options
+     */
+    constructor(key: string, options: ReadonlyArray<ObjectSchema<any>>);
+    /** @protected */
+    protected _key: string;
+    /** @protected */
+    protected _options: readonly ObjectSchema<any>[];
+    /** @protected @type {Map<unknown, Schema<any>>} */
+    protected _byValue: Map<unknown, Schema<any>>;
+}
 /**
  * A fixed-length array schema.
  *
@@ -916,6 +1163,8 @@ declare class LazySchema<T> extends Schema<T> {
     constructor(getter: () => Schema<T>);
     /** @protected */
     protected _getter: () => Schema<T>;
+    /** @protected @type {Schema<T> | undefined} */
+    protected _resolved: Schema<T> | undefined;
 }
 /**
  * A schema built from a test function.

package/types/src/Schema.d.ts.map

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

package/types/src/Str.d.ts

@@ -24,9 +24,13 @@ export type TruncateOptions = {
      */
     omission?: string | undefined;
     /**
-     * Cut at the previous space rather than inside a word.
+     * Cut at the previous space rather than inside a word, when the end is what gets cut.
      */
     words?: boolean | undefined;
+    /**
+     * Where the text is cut. `"middle"` keeps both ends, which suits paths and ids. Defaults to `"end"`.
+     */
+    position?: "end" | "middle" | "start" | undefined;
 };
 /**
  * Options for `template()`.
@@ -183,6 +187,38 @@ export type RandomStringOptions = {
  * @returns {string}
  */
 export function capitalize(input: unknown): string;
+/**
+ * Uppercases the first character and leaves the rest alone.
+ *
+ * @example
+ * str.upperFirst("userName"); // "UserName"
+ *
+ * @param {unknown} input
+ * @returns {string}
+ */
+export function upperFirst(input: unknown): string;
+/**
+ * Lowercases the first character and leaves the rest alone.
+ *
+ * @example
+ * str.lowerFirst("UserName"); // "userName"
+ *
+ * @param {unknown} input
+ * @returns {string}
+ */
+export function lowerFirst(input: unknown): string;
+/**
+ * Turns an identifier into a label people can read. Acronyms stay as they are.
+ *
+ * @example
+ * str.humanize("user_first_name"); // "User first name"
+ * str.humanize("createdAt");       // "Created at"
+ * str.humanize("userID");          // "User ID"
+ *
+ * @param {unknown} input
+ * @returns {string}
+ */
+export function humanize(input: unknown): string;
 /**
  * Uppercases the first letter of each word and leaves the rest alone.
  *
@@ -405,6 +441,18 @@ export function count(input: unknown, search: string): number;
  * @returns {string}
  */
 export function truncate(input: unknown, length: number, options?: TruncateOptions): string;
+/**
+ * Splits text into pieces of `size` visible characters. The last one can be
+ * shorter.
+ *
+ * @example
+ * str.chunk("4242424242424242", 4).join(" "); // "4242 4242 4242 4242"
+ *
+ * @param {unknown} input
+ * @param {number} size
+ * @returns {string[]}
+ */
+export function chunk(input: unknown, size: number): string[];
 /**
  * Returns the text between `start` and the next `end`, or `undefined` if a
  * marker is missing.

package/types/src/Str.d.ts.map

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

package/types/src/Sys.d.ts

@@ -7,7 +7,7 @@ export type RunOptions = {
      */
     cwd?: string | undefined;
     /**
-     * Extra environment variables, added to `process.env`.
+     * Extra environment variables, added to `process.env`. `undefined` removes one.
      */
     env?: Record<string, string | undefined> | undefined;
     /**
@@ -19,11 +19,11 @@ export type RunOptions = {
      */
     input?: string | Buffer<ArrayBufferLike> | undefined;
     /**
-     * Kill the command after this long, like `"30s"`.
+     * Kill the command after this long, like `"30s"`. On Windows, what it started is stopped with it.
      */
     timeout?: string | number | undefined;
     /**
-     * Kills the command when aborted.
+     * Kills the command when aborted. On Windows, what it started is stopped with it.
      */
     signal?: AbortSignal | undefined;
     /**
@@ -84,6 +84,11 @@ export type ShutdownOptions = {
      */
     signals?: NodeJS.Signals[] | undefined;
 };
+/**
+ * Why the process is stopping: the signal it got, or `"shutdown"` when
+ * `sys.shutdown()` was called.
+ */
+export type ShutdownReason = NodeJS.Signals | "shutdown";
 /**
  * Returned by `info()`.
  */
@@ -198,13 +203,53 @@ export function open(target: string): boolean;
  * @example
  * const server = app.listen(3000);
  * sys.onShutdown(() => new Promise((done) => server.close(done)));
- * sys.onShutdown(() => db.close());
+ * sys.onShutdown((reason) => log.info(`Stopping (${reason})`));
  *
- * @param {() => unknown} handler Can be async.
+ * @param {(reason: ShutdownReason) => unknown} handler Can be async. Gets the signal that stopped the process.
  * @param {ShutdownOptions} [options]
  * @returns {() => void} Removes the handler.
  */
-export function onShutdown(handler: () => unknown, options?: ShutdownOptions): () => void;
+export function onShutdown(handler: (reason: ShutdownReason) => unknown, options?: ShutdownOptions): () => void;
+/**
+ * Stops the process the clean way: runs the `onShutdown()` handlers, then
+ * exits. Use it instead of `process.exit()` when something goes wrong for
+ * good, so servers and databases still get closed.
+ *
+ * @example
+ * process.on("uncaughtException", (error) => {
+ *   log.fatal(error);
+ *   sys.shutdown(1);
+ * });
+ *
+ * @param {number} [exitCode] Defaults to the `exitCode` given to `onShutdown()`, or `0`. A failing handler makes it `1`.
+ * @returns {Promise<void>} Never resolves: the process exits first.
+ */
+export function shutdown(exitCode?: number): Promise<void>;
+/**
+ * Finds a TCP port nobody is listening on. Give a preferred port to get it
+ * back when it's free, and another one when it's taken.
+ *
+ * @example
+ * const port = await sys.freePort(3000); // 3000, or a free one if 3000 is in use
+ * app.listen(port);
+ *
+ * @param {number} [preferred] Tried first.
+ * @param {string} [host] The address to check. Defaults to all of them.
+ * @returns {Promise<number>}
+ */
+export function freePort(preferred?: number, host?: string): Promise<number>;
+/**
+ * The address of this machine on the local network, like `"192.168.1.20"`.
+ * It's what you print next to `localhost` so a phone on the same Wi-Fi can
+ * reach a dev server.
+ *
+ * @example
+ * console.log(`http://${sys.localIP() ?? "localhost"}:3000`);
+ *
+ * @param {4 | 6} [family=4] IPv4 or IPv6.
+ * @returns {string | undefined} `undefined` when the machine has no network.
+ */
+export function localIP(family?: 4 | 6): string | undefined;
 /**
  * Are we on Windows?
  * @returns {boolean}

package/types/src/Sys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sys.d.ts","sourceRoot":"","sources":["../../src/Sys.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAgCqB,MAAM,KAAK,IAAI;;;;uBACf,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;aAQtB,MAAM;YACN,MAAM;YACN,MAAM;;;;cACN,MAAM,GAAG,IAAI;YACb,MAAM,GAAG,IAAI;;;;cACb,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;cAcN,MAAM,CAAC,QAAQ;;;;UACf,MAAM;;;;aACN,MAAM;;;;UACN,MAAM;;;;UACN,MAAM;cACN,MAAM;;;;YACN;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;YAC7C,MAAM;cACN,MAAM;UACN,MAAM;SACN,MAAM;;;;QACN,OAAO;;;;YACP,OAAO;;;;SACP,OAAO;;AA2IrB;;;;;;;;;;;;;;;GAeG;AACH,0BANW,MAAM,SACN,MAAM,EAAE,YACR,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAM9B;AAED;;;;;;;;;;;;GAYG;AACH,8BALW,MAAM,YACN,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAK9B;AAED;;;;;;;;;GASG;AACH,+BAHW,MAAM,GACJ,MAAM,GAAG,SAAS,CAwB9B;AAED;;;;;;;;GAQG;AACH,6BAHW,MAAM,GACJ,OAAO,CAenB;AASD;;;;;;;;;;;;;;GAcG;AACH,oCAJW,MAAM,OAAO,YACb,eAAe,GACb,MAAM,IAAI,CAyBtB;AA6BD;;;GAGG;AACH,6BAFa,OAAO,CAInB;AAED;;;GAGG;AACH,yBAFa,OAAO,CAInB;AAED;;;GAGG;AACH,2BAFa,OAAO,CAInB;AAED;;;;;;;;GAQG;AACH,wBAFa,OAAO,CAUnB;AAED;;;;GAIG;AACH,4BAFa,OAAO,CAUnB;AAED;;;;GAIG;AACH,yBAFa,OAAO,CAInB;AAED;;;;;;;GAOG;AACH,wBAFa,UAAU,CA0BtB;AAED;;;;;;;GAOG;AACH,0BAFa;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAKxG"}
+{"version":3,"file":"Sys.d.ts","sourceRoot":"","sources":["../../src/Sys.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAqCqB,MAAM,KAAK,IAAI;;;;uBACf,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;aAQtB,MAAM;YACN,MAAM;YACN,MAAM;;;;cACN,MAAM,GAAG,IAAI;YACb,MAAM,GAAG,IAAI;;;;cACb,MAAM;;;;;;;;;;;;;;;;;;;;;;;6BAcP,MAAM,CAAC,OAAO,GAAG,UAAU;;;;;;;;cAM1B,MAAM,CAAC,QAAQ;;;;UACf,MAAM;;;;aACN,MAAM;;;;UACN,MAAM;;;;UACN,MAAM;cACN,MAAM;;;;YACN;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;YAC7C,MAAM;cACN,MAAM;UACN,MAAM;SACN,MAAM;;;;QACN,OAAO;;;;YACP,OAAO;;;;SACP,OAAO;;AA0KrB;;;;;;;;;;;;;;;GAeG;AACH,0BANW,MAAM,SACN,MAAM,EAAE,YACR,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAM9B;AAED;;;;;;;;;;;;GAYG;AACH,8BALW,MAAM,YACN,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAK9B;AAgBD;;;;;;;;;GASG;AACH,+BAHW,MAAM,GACJ,MAAM,GAAG,SAAS,CA8B9B;AAED;;;;;;;;GAQG;AACH,6BAHW,MAAM,GACJ,OAAO,CAenB;AAUD;;;;;;;;;;;;;;GAcG;AACH,oCAJW,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,YACnC,eAAe,GACb,MAAM,IAAI,CAsBtB;AAgCD;;;;;;;;;;;;;GAaG;AACH,oCAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;AA2GD;;;;;;;;;;;GAWG;AACH,qCAJW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAqB3B;AAED;;;;;;;;;;GAUG;AACH,iCAHW,CAAC,GAAG,CAAC,GACH,MAAM,GAAG,SAAS,CAW9B;AA9JD;;;GAGG;AACH,6BAFa,OAAO,CAInB;AAED;;;GAGG;AACH,yBAFa,OAAO,CAInB;AAED;;;GAGG;AACH,2BAFa,OAAO,CAInB;AAED;;;;;;;;GAQG;AACH,wBAFa,OAAO,CAUnB;AAKD;;;;GAIG;AACH,4BAFa,OAAO,CAWnB;AAED;;;;GAIG;AACH,yBAFa,OAAO,CAInB;AAED;;;;;;;GAOG;AACH,wBAFa,UAAU,CA0BtB;AAyDD;;;;;;;GAOG;AACH,0BAFa;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAKxG"}