@typia/core 12.0.0-dev.20260225

package/lib/factories/CommentFactory.mjs

@@ -0,0 +1,76 @@
+import ts from 'typescript';
+
+/**
+ * Factory for extracting JSDoc comments from TypeScript symbols.
+ *
+ * Extracts documentation comments and JSDoc tags from TypeScript AST symbols.
+ * Handles both legacy (TS < 5.2) and modern TypeScript versions.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var CommentFactory;
+(function (CommentFactory) {
+    CommentFactory.description = (symbol, includeTags = false) => {
+        const node = symbol.declarations?.[0];
+        if (!node)
+            return undefined;
+        // FOR LEGACY TS < 5.2
+        const [major, minor] = ts.versionMajorMinor.split(".").map(Number);
+        if (major < 5 || (major === 5 && minor < 1)) {
+            const content = [];
+            const main = ts.displayPartsToString(symbol.getDocumentationComment(undefined));
+            if (main.length) {
+                content.push(main);
+                if (includeTags && symbol.getJsDocTags().length)
+                    content.push("");
+            }
+            if (includeTags)
+                for (const tag of symbol.getJsDocTags()) {
+                    content.push(tag.text
+                        ? `@${tag.name} ${ts.displayPartsToString(tag.text)}`
+                        : `@${tag.name}`);
+                }
+            return content.length
+                ? content.map((line) => line.split("\r\n").join("\n")).join("\n")
+                : undefined;
+        }
+        // NEW FEATURE OF TS 5.2
+        const elements = ts.getJSDocCommentsAndTags(node);
+        if (elements.length === 0)
+            return undefined;
+        const content = [];
+        for (const comment of elements) {
+            if (ts.isJSDoc(comment)) {
+                const parsed = ts.getTextOfJSDocComment(comment.comment);
+                if (parsed?.length) {
+                    content.push(parsed);
+                    if (includeTags && comment.tags?.length)
+                        content.push("");
+                }
+                if (includeTags)
+                    for (const tag of comment.tags ?? [])
+                        content.push(parseJSDocTag(tag));
+            }
+            else if (includeTags)
+                content.push(parseJSDocTag(comment));
+        }
+        const output = content
+            .map((line) => line.split("\r\n").join("\n"))
+            .join("\n");
+        return output.length ? output : undefined;
+    };
+    CommentFactory.merge = (comments) => comments
+        .map((part) => part.text)
+        .map((str) => str.split("\r\n").join("\n"))
+        .join("");
+})(CommentFactory || (CommentFactory = {}));
+const parseJSDocTag = (tag) => {
+    const name = tag.name?.getText();
+    const parsed = ts.getTextOfJSDocComment(tag.comment);
+    return [`@${tag.tagName.text}`, name, parsed]
+        .filter((str) => !!str?.length)
+        .join(" ");
+};
+
+export { CommentFactory };
+//# sourceMappingURL=CommentFactory.mjs.map

package/lib/factories/CommentFactory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentFactory.mjs","sources":["../../src/factories/CommentFactory.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/factories/ExpressionFactory.d.ts

@@ -0,0 +1,38 @@
+import ts from "typescript";
+import { ImportProgrammer } from "../programmers/ImportProgrammer";
+/**
+ * Factory for creating TypeScript expression nodes.
+ *
+ * Creates numeric literals, type checks, instanceof expressions, and more. Also
+ * provides {@link transpile} for converting string code to AST with `$input`
+ * placeholder substitution and import handling.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace ExpressionFactory {
+    const number: (value: number) => ts.PrefixUnaryExpression | ts.NumericLiteral;
+    const bigint: (value: number | bigint) => ts.CallExpression;
+    const isRequired: (input: ts.Expression) => ts.Expression;
+    const isArray: (input: ts.Expression) => ts.Expression;
+    const isObject: (props: {
+        checkNull: boolean;
+        checkArray: boolean;
+        input: ts.Expression;
+    }) => ts.Expression;
+    const isInstanceOf: (type: string, input: ts.Expression) => ts.Expression;
+    const coalesce: (x: ts.Expression, y: ts.Expression) => ts.Expression;
+    const currying: (props: {
+        function: ts.Expression;
+        arguments: ts.Expression[];
+    }) => ts.CallExpression;
+    const selfCall: (body: ts.ConciseBody, type?: ts.TypeNode | undefined) => ts.CallExpression;
+    const getEscapedText: (props: {
+        printer: ts.Printer;
+        input: ts.Expression;
+    }) => string;
+    const transpile: (props: {
+        transformer?: ts.TransformationContext;
+        importer?: ImportProgrammer;
+        script: string;
+    }) => (input: ts.Expression) => ts.Expression;
+}

package/lib/factories/ExpressionFactory.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressionFactory = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+/**
+ * Factory for creating TypeScript expression nodes.
+ *
+ * Creates numeric literals, type checks, instanceof expressions, and more. Also
+ * provides {@link transpile} for converting string code to AST with `$input`
+ * placeholder substitution and import handling.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var ExpressionFactory;
+(function (ExpressionFactory) {
+    ExpressionFactory.number = (value) => value < 0
+        ? typescript_1.default.factory.createPrefixUnaryExpression(typescript_1.default.SyntaxKind.MinusToken, typescript_1.default.factory.createNumericLiteral(Math.abs(value)))
+        : typescript_1.default.factory.createNumericLiteral(value);
+    ExpressionFactory.bigint = (value) => typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createIdentifier("BigInt"), undefined, [typescript_1.default.factory.createIdentifier(value.toString())]);
+    ExpressionFactory.isRequired = (input) => typescript_1.default.factory.createStrictInequality(typescript_1.default.factory.createIdentifier("undefined"), input);
+    ExpressionFactory.isArray = (input) => typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createIdentifier("Array.isArray"), undefined, [input]);
+    ExpressionFactory.isObject = (props) => {
+        const conditions = [
+            typescript_1.default.factory.createStrictEquality(typescript_1.default.factory.createStringLiteral("object"), typescript_1.default.factory.createTypeOfExpression(props.input)),
+        ];
+        if (props.checkNull === true)
+            conditions.push(typescript_1.default.factory.createStrictInequality(typescript_1.default.factory.createNull(), props.input));
+        if (props.checkArray === true)
+            conditions.push(typescript_1.default.factory.createStrictEquality(typescript_1.default.factory.createFalse(), typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createIdentifier("Array.isArray"), undefined, [props.input])));
+        return conditions.length === 1
+            ? conditions[0]
+            : conditions.reduce((x, y) => typescript_1.default.factory.createLogicalAnd(x, y));
+    };
+    ExpressionFactory.isInstanceOf = (type, input) => {
+        return typescript_1.default.factory.createBinaryExpression(input, typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.InstanceOfKeyword), typescript_1.default.factory.createIdentifier(type));
+    };
+    ExpressionFactory.coalesce = (x, y) => typescript_1.default.factory.createBinaryExpression(x, typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.QuestionQuestionToken), y);
+    ExpressionFactory.currying = (props) => {
+        if (props.arguments.length === 0)
+            return typescript_1.default.factory.createCallExpression(props.function, undefined, undefined);
+        let prev = typescript_1.default.factory.createCallExpression(props.function, undefined, [props.arguments[0]]);
+        for (const param of props.arguments.slice(1))
+            prev = typescript_1.default.factory.createCallExpression(prev, undefined, [param]);
+        return prev;
+    };
+    ExpressionFactory.selfCall = (body, type) => typescript_1.default.isCallExpression(body)
+        ? body
+        : typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createParenthesizedExpression(typescript_1.default.factory.createArrowFunction(undefined, undefined, [], type, undefined, body)), undefined, undefined);
+    ExpressionFactory.getEscapedText = (props) => props.printer.printNode(typescript_1.default.EmitHint.Expression, props.input, props.input.getSourceFile());
+    ExpressionFactory.transpile = (props) => {
+        const file = typescript_1.default.createSourceFile(`${_randomFormatUuid()}.ts`, props.script, typescript_1.default.ScriptTarget.ESNext, true, typescript_1.default.ScriptKind.TS);
+        const statement = file.statements[0];
+        if (statement === undefined)
+            throw new ReferenceError("Error on ExpressionFactory.transpile(): no statement exists.");
+        else if (!typescript_1.default.isExpressionStatement(statement))
+            throw new TypeError("Error on ExpressionFactory.transpile(): statement is not an expression statement.");
+        return (input) => {
+            const visitor = (node) => {
+                if (typescript_1.default.isIdentifier(node) && node.text === "$input")
+                    return input;
+                else if (props.importer !== undefined && typescript_1.default.isCallExpression(node))
+                    if (node.expression.getText() === "$importInternal" &&
+                        node.arguments.length === 1 &&
+                        typescript_1.default.isStringLiteralLike(node.arguments[0])) {
+                        const name = node.arguments[0].text;
+                        return props.importer.internal(name);
+                    }
+                    else if (node.expression.getText() === "$importInstance" &&
+                        node.arguments.length === 2 &&
+                        typescript_1.default.isStringLiteralLike(node.arguments[0]) &&
+                        typescript_1.default.isStringLiteralLike(node.arguments[1])) {
+                        const name = node.arguments[0].text;
+                        const file = node.arguments[1].text;
+                        return props.importer.instance({
+                            file,
+                            name,
+                            alias: null,
+                        });
+                    }
+                    else if (node.expression.getText() === "$importNamespace" &&
+                        node.arguments.length === 2 &&
+                        typescript_1.default.isStringLiteralLike(node.arguments[0]) &&
+                        typescript_1.default.isStringLiteralLike(node.arguments[1])) {
+                        const name = node.arguments[0].text;
+                        const file = node.arguments[1].text;
+                        return props.importer.namespace({
+                            file,
+                            name,
+                        });
+                    }
+                    else if (node.expression.getText() === "$importDefault" &&
+                        node.arguments.length === 3 &&
+                        typescript_1.default.isStringLiteralLike(node.arguments[0]) &&
+                        typescript_1.default.isStringLiteralLike(node.arguments[1])) {
+                        const name = node.arguments[0].text;
+                        const file = node.arguments[1].text;
+                        return props.importer.default({
+                            file,
+                            name,
+                            type: false,
+                        });
+                    }
+                return typescript_1.default.visitEachChild(typescript_1.default.factory.cloneNode(node), visitor, props.transformer);
+            };
+            return visitor(typescript_1.default.factory.cloneNode(statement.expression));
+        };
+    };
+})(ExpressionFactory || (exports.ExpressionFactory = ExpressionFactory = {}));
+const _randomFormatUuid = () => "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === "x" ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+});
+//# sourceMappingURL=ExpressionFactory.js.map

package/lib/factories/ExpressionFactory.js.map

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

package/lib/factories/ExpressionFactory.mjs

@@ -0,0 +1,114 @@
+import ts from 'typescript';
+
+/**
+ * Factory for creating TypeScript expression nodes.
+ *
+ * Creates numeric literals, type checks, instanceof expressions, and more. Also
+ * provides {@link transpile} for converting string code to AST with `$input`
+ * placeholder substitution and import handling.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var ExpressionFactory;
+(function (ExpressionFactory) {
+    ExpressionFactory.number = (value) => value < 0
+        ? ts.factory.createPrefixUnaryExpression(ts.SyntaxKind.MinusToken, ts.factory.createNumericLiteral(Math.abs(value)))
+        : ts.factory.createNumericLiteral(value);
+    ExpressionFactory.bigint = (value) => ts.factory.createCallExpression(ts.factory.createIdentifier("BigInt"), undefined, [ts.factory.createIdentifier(value.toString())]);
+    ExpressionFactory.isRequired = (input) => ts.factory.createStrictInequality(ts.factory.createIdentifier("undefined"), input);
+    ExpressionFactory.isArray = (input) => ts.factory.createCallExpression(ts.factory.createIdentifier("Array.isArray"), undefined, [input]);
+    ExpressionFactory.isObject = (props) => {
+        const conditions = [
+            ts.factory.createStrictEquality(ts.factory.createStringLiteral("object"), ts.factory.createTypeOfExpression(props.input)),
+        ];
+        if (props.checkNull === true)
+            conditions.push(ts.factory.createStrictInequality(ts.factory.createNull(), props.input));
+        if (props.checkArray === true)
+            conditions.push(ts.factory.createStrictEquality(ts.factory.createFalse(), ts.factory.createCallExpression(ts.factory.createIdentifier("Array.isArray"), undefined, [props.input])));
+        return conditions.length === 1
+            ? conditions[0]
+            : conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
+    };
+    ExpressionFactory.isInstanceOf = (type, input) => {
+        return ts.factory.createBinaryExpression(input, ts.factory.createToken(ts.SyntaxKind.InstanceOfKeyword), ts.factory.createIdentifier(type));
+    };
+    ExpressionFactory.coalesce = (x, y) => ts.factory.createBinaryExpression(x, ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken), y);
+    ExpressionFactory.currying = (props) => {
+        if (props.arguments.length === 0)
+            return ts.factory.createCallExpression(props.function, undefined, undefined);
+        let prev = ts.factory.createCallExpression(props.function, undefined, [props.arguments[0]]);
+        for (const param of props.arguments.slice(1))
+            prev = ts.factory.createCallExpression(prev, undefined, [param]);
+        return prev;
+    };
+    ExpressionFactory.selfCall = (body, type) => ts.isCallExpression(body)
+        ? body
+        : ts.factory.createCallExpression(ts.factory.createParenthesizedExpression(ts.factory.createArrowFunction(undefined, undefined, [], type, undefined, body)), undefined, undefined);
+    ExpressionFactory.getEscapedText = (props) => props.printer.printNode(ts.EmitHint.Expression, props.input, props.input.getSourceFile());
+    ExpressionFactory.transpile = (props) => {
+        const file = ts.createSourceFile(`${_randomFormatUuid()}.ts`, props.script, ts.ScriptTarget.ESNext, true, ts.ScriptKind.TS);
+        const statement = file.statements[0];
+        if (statement === undefined)
+            throw new ReferenceError("Error on ExpressionFactory.transpile(): no statement exists.");
+        else if (!ts.isExpressionStatement(statement))
+            throw new TypeError("Error on ExpressionFactory.transpile(): statement is not an expression statement.");
+        return (input) => {
+            const visitor = (node) => {
+                if (ts.isIdentifier(node) && node.text === "$input")
+                    return input;
+                else if (props.importer !== undefined && ts.isCallExpression(node))
+                    if (node.expression.getText() === "$importInternal" &&
+                        node.arguments.length === 1 &&
+                        ts.isStringLiteralLike(node.arguments[0])) {
+                        const name = node.arguments[0].text;
+                        return props.importer.internal(name);
+                    }
+                    else if (node.expression.getText() === "$importInstance" &&
+                        node.arguments.length === 2 &&
+                        ts.isStringLiteralLike(node.arguments[0]) &&
+                        ts.isStringLiteralLike(node.arguments[1])) {
+                        const name = node.arguments[0].text;
+                        const file = node.arguments[1].text;
+                        return props.importer.instance({
+                            file,
+                            name,
+                            alias: null,
+                        });
+                    }
+                    else if (node.expression.getText() === "$importNamespace" &&
+                        node.arguments.length === 2 &&
+                        ts.isStringLiteralLike(node.arguments[0]) &&
+                        ts.isStringLiteralLike(node.arguments[1])) {
+                        const name = node.arguments[0].text;
+                        const file = node.arguments[1].text;
+                        return props.importer.namespace({
+                            file,
+                            name,
+                        });
+                    }
+                    else if (node.expression.getText() === "$importDefault" &&
+                        node.arguments.length === 3 &&
+                        ts.isStringLiteralLike(node.arguments[0]) &&
+                        ts.isStringLiteralLike(node.arguments[1])) {
+                        const name = node.arguments[0].text;
+                        const file = node.arguments[1].text;
+                        return props.importer.default({
+                            file,
+                            name,
+                            type: false,
+                        });
+                    }
+                return ts.visitEachChild(ts.factory.cloneNode(node), visitor, props.transformer);
+            };
+            return visitor(ts.factory.cloneNode(statement.expression));
+        };
+    };
+})(ExpressionFactory || (ExpressionFactory = {}));
+const _randomFormatUuid = () => "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === "x" ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+});
+
+export { ExpressionFactory };
+//# sourceMappingURL=ExpressionFactory.mjs.map

package/lib/factories/ExpressionFactory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressionFactory.mjs","sources":["../../src/factories/ExpressionFactory.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/factories/FormatCheatSheet.d.ts

@@ -0,0 +1,25 @@
+/** @reference https://github.dev/ajv-validator/ajv-formats/blob/master/src/formats.ts */
+export declare const FormatCheatSheet: {
+    readonly byte: "/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm.test($input)";
+    readonly password: "true";
+    readonly regex: "(() => { try { new RegExp($input); return true; } catch { return false; } })()";
+    readonly uuid: "/^(?:urn:uuid:)?[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i.test($input)";
+    readonly email: "/^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test($input)";
+    readonly hostname: "/^(?=.{1,253}\\.?$)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[-0-9a-z]{0,61}[0-9a-z])?)*\\.?$/i.test($input)";
+    readonly "idn-email": "/^(([^<>()[\\]\\.,;:\\s@\\\"]+(\\.[^<>()[\\]\\.,;:\\s@\\\"]+)*)|(\\\".+\\\"))@(([^<>()[\\]\\.,;:\\s@\\\"]+\\.)+[^<>()[\\]\\.,;:\\s@\\\"]{2,})$/i.test($input)";
+    readonly "idn-hostname": "/^([a-z0-9\\u00a1-\\uffff0-9]+(-[a-z0-9\\u00a1-\\uffff0-9]+)*\\.)+[a-z\\u00a1-\\uffff]{2,}$/i.test($input)";
+    readonly iri: "/^[A-Za-z][\\d+-.A-Za-z]*:[^\\u0000-\\u0020\"<>\\\\^`{|}]*$/u.test($input)";
+    readonly "iri-reference": "/^[A-Za-z][\\d+-.A-Za-z]*:[^\\u0000-\\u0020\"<>\\\\^`{|}]*$/u.test($input)";
+    readonly ipv4: "/^(?:(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)$/.test($input)";
+    readonly ipv6: "/^((([0-9a-f]{1,4}:){7}([0-9a-f]{1,4}|:))|(([0-9a-f]{1,4}:){6}(:[0-9a-f]{1,4}|((25[0-5]|2[0-4]d|1dd|[1-9]?d)(.(25[0-5]|2[0-4]d|1dd|[1-9]?d)){3})|:))|(([0-9a-f]{1,4}:){5}(((:[0-9a-f]{1,4}){1,2})|:((25[0-5]|2[0-4]d|1dd|[1-9]?d)(.(25[0-5]|2[0-4]d|1dd|[1-9]?d)){3})|:))|(([0-9a-f]{1,4}:){4}(((:[0-9a-f]{1,4}){1,3})|((:[0-9a-f]{1,4})?:((25[0-5]|2[0-4]d|1dd|[1-9]?d)(.(25[0-5]|2[0-4]d|1dd|[1-9]?d)){3}))|:))|(([0-9a-f]{1,4}:){3}(((:[0-9a-f]{1,4}){1,4})|((:[0-9a-f]{1,4}){0,2}:((25[0-5]|2[0-4]d|1dd|[1-9]?d)(.(25[0-5]|2[0-4]d|1dd|[1-9]?d)){3}))|:))|(([0-9a-f]{1,4}:){2}(((:[0-9a-f]{1,4}){1,5})|((:[0-9a-f]{1,4}){0,3}:((25[0-5]|2[0-4]d|1dd|[1-9]?d)(.(25[0-5]|2[0-4]d|1dd|[1-9]?d)){3}))|:))|(([0-9a-f]{1,4}:){1}(((:[0-9a-f]{1,4}){1,6})|((:[0-9a-f]{1,4}){0,4}:((25[0-5]|2[0-4]d|1dd|[1-9]?d)(.(25[0-5]|2[0-4]d|1dd|[1-9]?d)){3}))|:))|(:(((:[0-9a-f]{1,4}){1,7})|((:[0-9a-f]{1,4}){0,5}:((25[0-5]|2[0-4]d|1dd|[1-9]?d)(.(25[0-5]|2[0-4]d|1dd|[1-9]?d)){3}))|:)))$/i.test($input)";
+    readonly uri: "/\\/|:/.test($input) && /^(?:[a-z][a-z0-9+\\-.]*:)(?:\\/?\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\\.[a-z0-9\\-._~!$&'()*+,;=:]+)\\]|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)|(?:[a-z0-9\\-._~!$&'()*+,;=]|%[0-9a-f]{2})*)(?::\\d*)?(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*|\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)(?:\\?(?:[a-z0-9\\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i.test($input)";
+    readonly "uri-reference": "/^(?:[a-z][a-z0-9+\\-.]*:)?(?:\\/?\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\\.[a-z0-9\\-._~!$&'()*+,;=:]+)\\]|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)|(?:[a-z0-9\\-._~!$&'\"()*+,;=]|%[0-9a-f]{2})*)(?::\\d*)?(?:\\/(?:[a-z0-9\\-._~!$&'\"()*+,;=:@]|%[0-9a-f]{2})*)*|\\/(?:(?:[a-z0-9\\-._~!$&'\"()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'\"()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\\-._~!$&'\"()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'\"()*+,;=:@]|%[0-9a-f]{2})*)*)?(?:\\?(?:[a-z0-9\\-._~!$&'\"()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\\-._~!$&'\"()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i.test($input)";
+    readonly "uri-template": "/^(?:(?:[^\\x00-\\x20\"'<>%\\\\^`{|}]|%[0-9a-f]{2})|\\{[+#./;?&=,!@|]?(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\\*)?(?:,(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\\*)?)*\\})*$/i.test($input)";
+    readonly url: "/^(?:https?|ftp):\\/\\/(?:\\S+(?::\\S*)?@)?(?:(?!(?:10|127)(?:\\.\\d{1,3}){3})(?!(?:169\\.254|192\\.168)(?:\\.\\d{1,3}){2})(?!172\\.(?:1[6-9]|2\\d|3[0-1])(?:\\.\\d{1,3}){2})(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))|(?:(?:[a-z0-9\\u{00a1}-\\u{ffff}]+-)*[a-z0-9\\u{00a1}-\\u{ffff}]+)(?:\\.(?:[a-z0-9\\u{00a1}-\\u{ffff}]+-)*[a-z0-9\\u{00a1}-\\u{ffff}]+)*(?:\\.(?:[a-z\\u{00a1}-\\u{ffff}]{2,})))(?::\\d{2,5})?(?:\\/[^\\s]*)?$/iu.test($input)";
+    readonly "date-time": "/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(T|\\s)([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i.test($input)";
+    readonly date: "/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$/.test($input)";
+    readonly time: "/^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i.test($input)";
+    readonly duration: "/^P(?!$)((\\d+Y)?(\\d+M)?(\\d+D)?(T(?=\\d)(\\d+H)?(\\d+M)?(\\d+S)?)?|(\\d+W)?)$/.test($input)";
+    readonly "json-pointer": "/^(?:\\/(?:[^~/]|~0|~1)*)*$/.test($input)";
+    readonly "relative-json-pointer": "/^(?:0|[1-9][0-9]*)(?:#|(?:\\/(?:[^~/]|~0|~1)*)*)$/.test($input)";
+};

package/lib/factories/FormatCheatSheet.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormatCheatSheet = void 0;
+const RegexCall = (text) => `${text}.test($input)`;
+/** @reference https://github.dev/ajv-validator/ajv-formats/blob/master/src/formats.ts */
+exports.FormatCheatSheet = {
+    // SPECIAL CHARACTERS
+    byte: RegexCall(`/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm`),
+    password: `true`,
+    regex: `(() => { try { new RegExp($input); return true; } catch { return false; } })()`,
+    uuid: RegexCall(`/^(?:urn:uuid:)?[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i`),
+    // ADDRESSES
+    email: RegexCall(`/^[a-z0-9!#$%&'*+/=?^_\`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_\`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i`),
+    hostname: RegexCall(`/^(?=.{1,253}\\.?$)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[-0-9a-z]{0,61}[0-9a-z])?)*\\.?$/i`),
+    "idn-email": RegexCall(`/^(([^<>()[\\]\\.,;:\\s@\\"]+(\\.[^<>()[\\]\\.,;:\\s@\\"]+)*)|(\\".+\\"))@(([^<>()[\\]\\.,;:\\s@\\"]+\\.)+[^<>()[\\]\\.,;:\\s@\\"]{2,})$/i`),
+    "idn-hostname": RegexCall(`/^([a-z0-9\\u00a1-\\uffff0-9]+(-[a-z0-9\\u00a1-\\uffff0-9]+)*\\.)+[a-z\\u00a1-\\uffff]{2,}$/i`),
+    iri: RegexCall(`/^[A-Za-z][\\d+-.A-Za-z]*:[^\\u0000-\\u0020"<>\\\\^\`{|}]*$/u`),
+    "iri-reference": RegexCall(`/^[A-Za-z][\\d+-.A-Za-z]*:[^\\u0000-\\u0020"<>\\\\^\`{|}]*$/u`),
+    ipv4: RegexCall(`/^(?:(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)$/`),
+    ipv6: RegexCall(`/^((([0-9a-f]{1,4}:){7}([0-9a-f]{1,4}|:))|(([0-9a-f]{1,4}:){6}(:[0-9a-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){5}(((:[0-9a-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){4}(((:[0-9a-f]{1,4}){1,3})|((:[0-9a-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){3}(((:[0-9a-f]{1,4}){1,4})|((:[0-9a-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){2}(((:[0-9a-f]{1,4}){1,5})|((:[0-9a-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){1}(((:[0-9a-f]{1,4}){1,6})|((:[0-9a-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9a-f]{1,4}){1,7})|((:[0-9a-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))$/i`),
+    uri: `${RegexCall(`/\\/|:/`)} && ${RegexCall(`/^(?:[a-z][a-z0-9+\\-.]*:)(?:\\/?\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\\.[a-z0-9\\-._~!$&'()*+,;=:]+)\\]|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)|(?:[a-z0-9\\-._~!$&'()*+,;=]|%[0-9a-f]{2})*)(?::\\d*)?(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*|\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)(?:\\?(?:[a-z0-9\\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i`)}`,
+    "uri-reference": RegexCall(`/^(?:[a-z][a-z0-9+\\-.]*:)?(?:\\/?\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\\.[a-z0-9\\-._~!$&'()*+,;=:]+)\\]|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)|(?:[a-z0-9\\-._~!$&'"()*+,;=]|%[0-9a-f]{2})*)(?::\\d*)?(?:\\/(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})*)*|\\/(?:(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})*)*)?(?:\\?(?:[a-z0-9\\-._~!$&'"()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\\-._~!$&'"()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i`),
+    "uri-template": RegexCall(`/^(?:(?:[^\\x00-\\x20"'<>%\\\\^\`{|}]|%[0-9a-f]{2})|\\{[+#./;?&=,!@|]?(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\\*)?(?:,(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\\*)?)*\\})*$/i`),
+    url: RegexCall(`/^(?:https?|ftp):\\/\\/(?:\\S+(?::\\S*)?@)?(?:(?!(?:10|127)(?:\\.\\d{1,3}){3})(?!(?:169\\.254|192\\.168)(?:\\.\\d{1,3}){2})(?!172\\.(?:1[6-9]|2\\d|3[0-1])(?:\\.\\d{1,3}){2})(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))|(?:(?:[a-z0-9\\u{00a1}-\\u{ffff}]+-)*[a-z0-9\\u{00a1}-\\u{ffff}]+)(?:\\.(?:[a-z0-9\\u{00a1}-\\u{ffff}]+-)*[a-z0-9\\u{00a1}-\\u{ffff}]+)*(?:\\.(?:[a-z\\u{00a1}-\\u{ffff}]{2,})))(?::\\d{2,5})?(?:\\/[^\\s]*)?$/iu`),
+    // TIMESTAMPS
+    "date-time": RegexCall(`/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(T|\\s)([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i`),
+    date: RegexCall(`/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$/`),
+    time: RegexCall(`/^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i`),
+    duration: RegexCall(`/^P(?!$)((\\d+Y)?(\\d+M)?(\\d+D)?(T(?=\\d)(\\d+H)?(\\d+M)?(\\d+S)?)?|(\\d+W)?)$/`),
+    // POINTERS
+    "json-pointer": RegexCall(`/^(?:\\/(?:[^~/]|~0|~1)*)*$/`),
+    "relative-json-pointer": RegexCall(`/^(?:0|[1-9][0-9]*)(?:#|(?:\\/(?:[^~/]|~0|~1)*)*)$/`),
+};
+//# sourceMappingURL=FormatCheatSheet.js.map

package/lib/factories/FormatCheatSheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormatCheatSheet.js","sourceRoot":"","sources":["../../src/factories/FormatCheatSheet.ts"],"names":[],"mappings":";;;AAAA,MAAM,SAAS,GAAG,CAAsB,IAAU,EAAE,EAAE,CACpD,GAAG,IAAI,eAAwB,CAAC;AAElC,yFAAyF;AAC5E,QAAA,gBAAgB,GAAG;IAC9B,qBAAqB;IACrB,IAAI,EAAE,SAAS,CACb,sEAAsE,CACvE;IACD,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,gFAAgF;IACvF,IAAI,EAAE,SAAS,CACb,gEAAgE,CACjE;IAED,YAAY;IACZ,KAAK,EAAE,SAAS,CACd,gJAAgJ,CACjJ;IACD,QAAQ,EAAE,SAAS,CACjB,4GAA4G,CAC7G;IACD,WAAW,EAAE,SAAS,CACpB,4IAA4I,CAC7I;IACD,cAAc,EAAE,SAAS,CACvB,+FAA+F,CAChG;IACD,GAAG,EAAE,SAAS,CACZ,+DAA+D,CAChE;IACD,eAAe,EAAE,SAAS,CACxB,+DAA+D,CAChE;IACD,IAAI,EAAE,SAAS,CACb,8FAA8F,CAC/F;IACD,IAAI,EAAE,SAAS,CACb,o/BAAo/B,CACr/B;IACD,GAAG,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,SAAS,CAC1C,oqCAAoqC,CACrqC,EAAE;IACH,eAAe,EAAE,SAAS,CACxB,8qCAA8qC,CAC/qC;IACD,cAAc,EAAE,SAAS,CACvB,8LAA8L,CAC/L;IACD,GAAG,EAAE,SAAS,CACZ,+fAA+f,CAChgB;IAED,aAAa;IACb,WAAW,EAAE,SAAS,CACpB,8JAA8J,CAC/J;IACD,IAAI,EAAE,SAAS,CAAC,uDAAuD,CAAC;IACxE,IAAI,EAAE,SAAS,CACb,sGAAsG,CACvG;IACD,QAAQ,EAAE,SAAS,CACjB,kFAAkF,CACnF;IAED,WAAW;IACX,cAAc,EAAE,SAAS,CAAC,8BAA8B,CAAC;IACzD,uBAAuB,EAAE,SAAS,CAChC,qDAAqD,CACtD;CACO,CAAC"}

package/lib/factories/FormatCheatSheet.mjs

@@ -0,0 +1,33 @@
+const RegexCall = (text) => `${text}.test($input)`;
+/** @reference https://github.dev/ajv-validator/ajv-formats/blob/master/src/formats.ts */
+const FormatCheatSheet = {
+    // SPECIAL CHARACTERS
+    byte: RegexCall(`/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm`),
+    password: `true`,
+    regex: `(() => { try { new RegExp($input); return true; } catch { return false; } })()`,
+    uuid: RegexCall(`/^(?:urn:uuid:)?[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i`),
+    // ADDRESSES
+    email: RegexCall(`/^[a-z0-9!#$%&'*+/=?^_\`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_\`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i`),
+    hostname: RegexCall(`/^(?=.{1,253}\\.?$)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[-0-9a-z]{0,61}[0-9a-z])?)*\\.?$/i`),
+    "idn-email": RegexCall(`/^(([^<>()[\\]\\.,;:\\s@\\"]+(\\.[^<>()[\\]\\.,;:\\s@\\"]+)*)|(\\".+\\"))@(([^<>()[\\]\\.,;:\\s@\\"]+\\.)+[^<>()[\\]\\.,;:\\s@\\"]{2,})$/i`),
+    "idn-hostname": RegexCall(`/^([a-z0-9\\u00a1-\\uffff0-9]+(-[a-z0-9\\u00a1-\\uffff0-9]+)*\\.)+[a-z\\u00a1-\\uffff]{2,}$/i`),
+    iri: RegexCall(`/^[A-Za-z][\\d+-.A-Za-z]*:[^\\u0000-\\u0020"<>\\\\^\`{|}]*$/u`),
+    "iri-reference": RegexCall(`/^[A-Za-z][\\d+-.A-Za-z]*:[^\\u0000-\\u0020"<>\\\\^\`{|}]*$/u`),
+    ipv4: RegexCall(`/^(?:(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)$/`),
+    ipv6: RegexCall(`/^((([0-9a-f]{1,4}:){7}([0-9a-f]{1,4}|:))|(([0-9a-f]{1,4}:){6}(:[0-9a-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){5}(((:[0-9a-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){4}(((:[0-9a-f]{1,4}){1,3})|((:[0-9a-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){3}(((:[0-9a-f]{1,4}){1,4})|((:[0-9a-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){2}(((:[0-9a-f]{1,4}){1,5})|((:[0-9a-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){1}(((:[0-9a-f]{1,4}){1,6})|((:[0-9a-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9a-f]{1,4}){1,7})|((:[0-9a-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))$/i`),
+    uri: `${RegexCall(`/\\/|:/`)} && ${RegexCall(`/^(?:[a-z][a-z0-9+\\-.]*:)(?:\\/?\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\\.[a-z0-9\\-._~!$&'()*+,;=:]+)\\]|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)|(?:[a-z0-9\\-._~!$&'()*+,;=]|%[0-9a-f]{2})*)(?::\\d*)?(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*|\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)(?:\\?(?:[a-z0-9\\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i`)}`,
+    "uri-reference": RegexCall(`/^(?:[a-z][a-z0-9+\\-.]*:)?(?:\\/?\\/(?:(?:[a-z0-9\\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\\.[a-z0-9\\-._~!$&'()*+,;=:]+)\\]|(?:(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d\\d?)|(?:[a-z0-9\\-._~!$&'"()*+,;=]|%[0-9a-f]{2})*)(?::\\d*)?(?:\\/(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})*)*|\\/(?:(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})+(?:\\/(?:[a-z0-9\\-._~!$&'"()*+,;=:@]|%[0-9a-f]{2})*)*)?(?:\\?(?:[a-z0-9\\-._~!$&'"()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\\-._~!$&'"()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i`),
+    "uri-template": RegexCall(`/^(?:(?:[^\\x00-\\x20"'<>%\\\\^\`{|}]|%[0-9a-f]{2})|\\{[+#./;?&=,!@|]?(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\\*)?(?:,(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\\*)?)*\\})*$/i`),
+    url: RegexCall(`/^(?:https?|ftp):\\/\\/(?:\\S+(?::\\S*)?@)?(?:(?!(?:10|127)(?:\\.\\d{1,3}){3})(?!(?:169\\.254|192\\.168)(?:\\.\\d{1,3}){2})(?!172\\.(?:1[6-9]|2\\d|3[0-1])(?:\\.\\d{1,3}){2})(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))|(?:(?:[a-z0-9\\u{00a1}-\\u{ffff}]+-)*[a-z0-9\\u{00a1}-\\u{ffff}]+)(?:\\.(?:[a-z0-9\\u{00a1}-\\u{ffff}]+-)*[a-z0-9\\u{00a1}-\\u{ffff}]+)*(?:\\.(?:[a-z\\u{00a1}-\\u{ffff}]{2,})))(?::\\d{2,5})?(?:\\/[^\\s]*)?$/iu`),
+    // TIMESTAMPS
+    "date-time": RegexCall(`/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(T|\\s)([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i`),
+    date: RegexCall(`/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$/`),
+    time: RegexCall(`/^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i`),
+    duration: RegexCall(`/^P(?!$)((\\d+Y)?(\\d+M)?(\\d+D)?(T(?=\\d)(\\d+H)?(\\d+M)?(\\d+S)?)?|(\\d+W)?)$/`),
+    // POINTERS
+    "json-pointer": RegexCall(`/^(?:\\/(?:[^~/]|~0|~1)*)*$/`),
+    "relative-json-pointer": RegexCall(`/^(?:0|[1-9][0-9]*)(?:#|(?:\\/(?:[^~/]|~0|~1)*)*)$/`),
+};
+
+export { FormatCheatSheet };
+//# sourceMappingURL=FormatCheatSheet.mjs.map

package/lib/factories/FormatCheatSheet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormatCheatSheet.mjs","sources":["../../src/factories/FormatCheatSheet.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,CAAsB,IAAU,KAChD,CAAA,EAAG,IAAI,CAAA,aAAA,CAAwB;AAEjC;AACO,MAAM,gBAAgB,GAAG;;AAE9B,IAAA,IAAI,EAAE,SAAS,CACb,CAAA,oEAAA,CAAsE,CACvE;AACD,IAAA,QAAQ,EAAE,CAAA,IAAA,CAAM;AAChB,IAAA,KAAK,EAAE,CAAA,8EAAA,CAAgF;AACvF,IAAA,IAAI,EAAE,SAAS,CACb,CAAA,8DAAA,CAAgE,CACjE;;AAGD,IAAA,KAAK,EAAE,SAAS,CACd,CAAA,8IAAA,CAAgJ,CACjJ;AACD,IAAA,QAAQ,EAAE,SAAS,CACjB,CAAA,0GAAA,CAA4G,CAC7G;AACD,IAAA,WAAW,EAAE,SAAS,CACpB,CAAA,0IAAA,CAA4I,CAC7I;AACD,IAAA,cAAc,EAAE,SAAS,CACvB,CAAA,6FAAA,CAA+F,CAChG;AACD,IAAA,GAAG,EAAE,SAAS,CACZ,CAAA,6DAAA,CAA+D,CAChE;AACD,IAAA,eAAe,EAAE,SAAS,CACxB,CAAA,6DAAA,CAA+D,CAChE;AACD,IAAA,IAAI,EAAE,SAAS,CACb,CAAA,4FAAA,CAA8F,CAC/F;AACD,IAAA,IAAI,EAAE,SAAS,CACb,CAAA,k/BAAA,CAAo/B,CACr/B;IACD,GAAG,EAAE,CAAA,EAAG,SAAS,CAAC,CAAA,OAAA,CAAS,CAAC,CAAA,IAAA,EAAO,SAAS,CAC1C,CAAA,kqCAAA,CAAoqC,CACrqC,CAAA,CAAE;AACH,IAAA,eAAe,EAAE,SAAS,CACxB,CAAA,4qCAAA,CAA8qC,CAC/qC;AACD,IAAA,cAAc,EAAE,SAAS,CACvB,CAAA,4LAAA,CAA8L,CAC/L;AACD,IAAA,GAAG,EAAE,SAAS,CACZ,CAAA,6fAAA,CAA+f,CAChgB;;AAGD,IAAA,WAAW,EAAE,SAAS,CACpB,CAAA,4JAAA,CAA8J,CAC/J;AACD,IAAA,IAAI,EAAE,SAAS,CAAC,CAAA,qDAAA,CAAuD,CAAC;AACxE,IAAA,IAAI,EAAE,SAAS,CACb,CAAA,oGAAA,CAAsG,CACvG;AACD,IAAA,QAAQ,EAAE,SAAS,CACjB,CAAA,gFAAA,CAAkF,CACnF;;AAGD,IAAA,cAAc,EAAE,SAAS,CAAC,CAAA,4BAAA,CAA8B,CAAC;AACzD,IAAA,uBAAuB,EAAE,SAAS,CAChC,CAAA,mDAAA,CAAqD,CACtD;;;;;"}

package/lib/factories/IdentifierFactory.d.ts

@@ -0,0 +1,17 @@
+import ts from "typescript";
+/**
+ * Factory for creating TypeScript identifier and property access nodes.
+ *
+ * Creates identifiers, property access expressions, and parameter declarations.
+ * Handles both valid JavaScript identifiers and string literals for property
+ * names that contain special characters.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace IdentifierFactory {
+    const identifier: (name: string) => ts.Identifier | ts.StringLiteral;
+    const access: (input: ts.Expression, key: string, chain?: boolean) => ts.PropertyAccessExpression | ts.ElementAccessExpression;
+    const getName: (input: ts.Expression) => string;
+    const postfix: (str: string) => string;
+    const parameter: (name: string | ts.BindingName, type?: ts.TypeNode | undefined, init?: ts.Expression | ts.PunctuationToken<ts.SyntaxKind.QuestionToken> | undefined) => ts.ParameterDeclaration;
+}

package/lib/factories/IdentifierFactory.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentifierFactory = void 0;
+const utils_1 = require("@typia/utils");
+const typescript_1 = __importDefault(require("typescript"));
+const TypeFactory_1 = require("./TypeFactory");
+/**
+ * Factory for creating TypeScript identifier and property access nodes.
+ *
+ * Creates identifiers, property access expressions, and parameter declarations.
+ * Handles both valid JavaScript identifiers and string literals for property
+ * names that contain special characters.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var IdentifierFactory;
+(function (IdentifierFactory) {
+    IdentifierFactory.identifier = (name) => utils_1.NamingConvention.variable(name)
+        ? typescript_1.default.factory.createIdentifier(name)
+        : typescript_1.default.factory.createStringLiteral(name);
+    IdentifierFactory.access = (input, key, chain) => {
+        const postfix = IdentifierFactory.identifier(key);
+        return typescript_1.default.isStringLiteral(postfix)
+            ? chain === true
+                ? typescript_1.default.factory.createElementAccessChain(input, typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.QuestionDotToken), postfix)
+                : typescript_1.default.factory.createElementAccessExpression(input, postfix)
+            : chain === true
+                ? typescript_1.default.factory.createPropertyAccessChain(input, typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.QuestionDotToken), postfix)
+                : typescript_1.default.factory.createPropertyAccessExpression(input, postfix);
+    };
+    IdentifierFactory.getName = (input) => {
+        var _a;
+        const value = (_a = input.escapedText) === null || _a === void 0 ? void 0 : _a.toString();
+        if (typeof value === "string")
+            return value;
+        if (typescript_1.default.isPropertyAccessExpression(input))
+            return `${IdentifierFactory.getName(input.expression)}.${input.name.escapedText.toString()}`;
+        else if (typescript_1.default.isElementAccessExpression(input))
+            return `${IdentifierFactory.getName(input.expression)}[${IdentifierFactory.getName(input.argumentExpression)}]`;
+        return "unknown";
+    };
+    IdentifierFactory.postfix = (str) => utils_1.NamingConvention.variable(str)
+        ? `".${str}"`
+        : `"[${JSON.stringify(str).split('"').join('\\"')}]"`;
+    IdentifierFactory.parameter = (name, type, init) => {
+        // instead of ts.version >= "4.8"
+        if (typescript_1.default.getDecorators !== undefined)
+            return typescript_1.default.factory.createParameterDeclaration(undefined, undefined, name, (init === null || init === void 0 ? void 0 : init.kind) === typescript_1.default.SyntaxKind.QuestionToken
+                ? typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.QuestionToken)
+                : undefined, type !== null && type !== void 0 ? type : TypeFactory_1.TypeFactory.keyword("any"), init && init.kind !== typescript_1.default.SyntaxKind.QuestionToken ? init : undefined);
+        // eslint-disable-next-line
+        return typescript_1.default.factory.createParameterDeclaration(undefined, undefined, undefined, name, (init === null || init === void 0 ? void 0 : init.kind) === typescript_1.default.SyntaxKind.QuestionToken
+            ? typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.QuestionToken)
+            : undefined, type, init && init.kind !== typescript_1.default.SyntaxKind.QuestionToken ? init : undefined);
+    };
+})(IdentifierFactory || (exports.IdentifierFactory = IdentifierFactory = {}));
+//# sourceMappingURL=IdentifierFactory.js.map

package/lib/factories/IdentifierFactory.js.map

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