@digital-alchemy/core 0.1.0

package/dist/synapse/synapse.module.d.ts

@@ -0,0 +1,29 @@
+import { BinarySensor, Button, Registry, Scene, Sensor, Switch } from "./extensions";
+export declare const LIB_SYNAPSE: import("../boilerplate").LibraryDefinition<{
+    binary_sensor: typeof BinarySensor;
+    button: typeof Button;
+    registry: typeof Registry;
+    scene: typeof Scene;
+    sensor: typeof Sensor;
+    switch: typeof Switch;
+}, {
+    ANNOUNCE_AT_CONNECT: {
+        default: false;
+        description: string[];
+        type: "boolean";
+    };
+    APPLICATION_IDENTIFIER: {
+        description: string[];
+        type: "string";
+    };
+    EMIT_HEARTBEAT: {
+        default: true;
+        description: string[];
+        type: "boolean";
+    };
+}>;
+declare module "../boilerplate" {
+    interface LoadedModules {
+        synapse: typeof LIB_SYNAPSE;
+    }
+}

package/dist/synapse/synapse.module.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIB_SYNAPSE = void 0;
+const boilerplate_1 = require("../boilerplate");
+const extensions_1 = require("./extensions");
+exports.LIB_SYNAPSE = (0, boilerplate_1.CreateLibrary)({
+    configuration: {
+        ANNOUNCE_AT_CONNECT: {
+            default: false,
+            description: [
+                "Emit the entity list update every time this application is booted",
+                "digital-alchemy.reload() service available for manual reload",
+            ],
+            type: "boolean",
+        },
+        APPLICATION_IDENTIFIER: {
+            description: [
+                "Used to generate unique ids in home assistant",
+                "Defaults to application name",
+            ],
+            type: "string",
+        },
+        EMIT_HEARTBEAT: {
+            default: true,
+            description: ["Emit a pulse so the extension knows the service is alive"],
+            type: "boolean",
+        },
+    },
+    name: "synapse",
+    // everything depends registry
+    priorityInit: ["registry"],
+    services: {
+        binary_sensor: extensions_1.BinarySensor,
+        button: extensions_1.Button,
+        registry: extensions_1.Registry,
+        scene: extensions_1.Scene,
+        sensor: extensions_1.Sensor,
+        switch: extensions_1.Switch,
+    },
+});
+//# sourceMappingURL=synapse.module.js.map

package/dist/synapse/synapse.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synapse.module.js","sourceRoot":"","sources":["../../src/synapse/synapse.module.ts"],"names":[],"mappings":";;;AAAA,gDAA+C;AAC/C,6CAOsB;AAET,QAAA,WAAW,GAAG,IAAA,2BAAa,EAAC;IACvC,aAAa,EAAE;QACb,mBAAmB,EAAE;YACnB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE;gBACX,mEAAmE;gBACnE,8DAA8D;aAC/D;YACD,IAAI,EAAE,SAAS;SAChB;QACD,sBAAsB,EAAE;YACtB,WAAW,EAAE;gBACX,+CAA+C;gBAC/C,8BAA8B;aAC/B;YACD,IAAI,EAAE,QAAQ;SACf;QACD,cAAc,EAAE;YACd,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,CAAC,0DAA0D,CAAC;YACzE,IAAI,EAAE,SAAS;SAChB;KACF;IACD,IAAI,EAAE,SAAS;IACf,8BAA8B;IAC9B,YAAY,EAAE,CAAC,UAAU,CAAC;IAC1B,QAAQ,EAAE;QACR,aAAa,EAAE,yBAAY;QAC3B,MAAM,EAAE,mBAAM;QACd,QAAQ,EAAE,qBAAQ;QAClB,KAAK,EAAE,kBAAK;QACZ,MAAM,EAAE,mBAAM;QACd,MAAM,EAAE,mBAAM;KACf;CACF,CAAC,CAAC"}

package/dist/type-writer/build.extension.d.ts

@@ -0,0 +1,2 @@
+import { TServiceParams } from "..";
+export declare function BuildTypes({ logger, lifecycle, hass, type_writer, config, }: TServiceParams): void;

package/dist/type-writer/build.extension.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildTypes = void 0;
+const fs_1 = require("fs");
+const object_path_1 = require("object-path");
+const path_1 = require("path");
+const __1 = require("..");
+function BuildTypes({ logger, lifecycle, hass, type_writer, config, }) {
+    // ? join(__dirname, "..", "home-assistant", "src", "dynamic.d.ts")
+    lifecycle.onReady(async () => {
+        try {
+            const path = __1.is.empty(config.type_writer.TARGET_FILE)
+                ? (0, path_1.join)(__dirname, "..", "hass", "dynamic.d.ts")
+                : config.type_writer.TARGET_FILE;
+            if (!(0, fs_1.existsSync)(path)) {
+                if (config.type_writer.TARGET_FILE !== path) {
+                    // Represents an error with the script
+                    // Calculated the wrong path, and something is up
+                    logger.fatal({ path }, `cannot locate target file, aborting`);
+                    return;
+                }
+                logger.warn({ path }, `creating new type definitions file`);
+            }
+            const text = await DoBuild();
+            (0, fs_1.writeFileSync)(path, text);
+            logger.warn({ path }, `successfully wrote [hass] type definitions file`);
+        }
+        catch (error) {
+            logger.fatal({ error }, `failed to write type definitions file`);
+        }
+    });
+    // see file - libs/home-assistant/src/dynamic.ts
+    async function DoBuild() {
+        logger.info(`Pulling information`);
+        const typeInterface = await type_writer.type_writer();
+        const entities = await hass.fetch.getAllEntities();
+        const entitySetup = {};
+        entities.forEach(i => (0, object_path_1.set)(entitySetup, i.entity_id, i));
+        return [
+            `// This file is generated, and is automatically updated as a npm post install step`,
+            "// Do not edit this file, it will only affect type definitions, not functional code",
+            "",
+            `import { PICK_ENTITY } from "./helpers";`,
+            "",
+            `export const ENTITY_SETUP = ${JSON.stringify(entitySetup, undefined, "  ")};`,
+            "",
+            typeInterface,
+            "",
+        ].join(`\n`);
+    }
+}
+exports.BuildTypes = BuildTypes;
+//# sourceMappingURL=build.extension.js.map

package/dist/type-writer/build.extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.extension.js","sourceRoot":"","sources":["../../src/type-writer/build.extension.ts"],"names":[],"mappings":";;;AAAA,2BAA+C;AAC/C,6CAAkC;AAClC,+BAA4B;AAE5B,0BAAwC;AAExC,SAAgB,UAAU,CAAC,EACzB,MAAM,EACN,SAAS,EACT,IAAI,EACJ,WAAW,EACX,MAAM,GACS;IACf,mEAAmE;IACnE,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAE,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC;gBACnD,CAAC,CAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC;gBAC/C,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC;YACnC,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,IAAI,MAAM,CAAC,WAAW,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;oBAC5C,sCAAsC;oBACtC,iDAAiD;oBACjD,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,qCAAqC,CAAC,CAAC;oBAC9D,OAAO;gBACT,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,oCAAoC,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;YAC7B,IAAA,kBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,iDAAiD,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,uCAAuC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,KAAK,UAAU,OAAO;QACpB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnC,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QACnD,MAAM,WAAW,GAAG,EAAE,CAAC;QACvB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAA,iBAAG,EAAC,WAAW,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO;YACL,oFAAoF;YACpF,qFAAqF;YACrF,EAAE;YACF,0CAA0C;YAC1C,EAAE;YACF,+BAA+B,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG;YAC9E,EAAE;YACF,aAAa;YACb,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;AACH,CAAC;AAjDD,gCAiDC"}

package/dist/type-writer/main.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { BuildTypes } from "./build.extension";
+import { TypeWriter } from "./type-writer.extension";
+export declare const TYPE_WRITER: import("..").ApplicationDefinition<{
+    build: typeof BuildTypes;
+    type_writer: typeof TypeWriter;
+}, {
+    TARGET_FILE: {
+        description: string;
+        type: "string";
+    };
+}>;
+declare module "../boilerplate" {
+    interface LoadedModules {
+        type_writer: typeof TYPE_WRITER;
+    }
+}

package/dist/type-writer/main.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TYPE_WRITER = void 0;
+const __1 = require("..");
+const hass_1 = require("../hass");
+const build_extension_1 = require("./build.extension");
+const type_writer_extension_1 = require("./type-writer.extension");
+exports.TYPE_WRITER = (0, __1.CreateApplication)({
+    configuration: {
+        TARGET_FILE: {
+            description: "Define a file to write types to. Autodetect = default behavior",
+            type: "string",
+        },
+    },
+    libraries: [hass_1.LIB_HASS],
+    name: "type_writer",
+    services: {
+        build: build_extension_1.BuildTypes,
+        type_writer: type_writer_extension_1.TypeWriter,
+    },
+});
+setImmediate(async () => {
+    await exports.TYPE_WRITER.bootstrap({
+        configuration: {
+            boilerplate: {
+                LOG_LEVEL: "warn",
+            },
+            hass: {
+                AUTO_CONNECT_SOCKET: false,
+                AUTO_SCAN_CALL_PROXY: false,
+            },
+        },
+    });
+});
+//# sourceMappingURL=main.js.map

package/dist/type-writer/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/type-writer/main.ts"],"names":[],"mappings":";;;;AACA,0BAAuC;AACvC,kCAAmC;AACnC,uDAA+C;AAC/C,mEAAqD;AAExC,QAAA,WAAW,GAAG,IAAA,qBAAiB,EAAC;IAC3C,aAAa,EAAE;QACb,WAAW,EAAE;YACX,WAAW,EACT,gEAAgE;YAClE,IAAI,EAAE,QAAQ;SACf;KACF;IACD,SAAS,EAAE,CAAC,eAAQ,CAAC;IACrB,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE;QACR,KAAK,EAAE,4BAAU;QACjB,WAAW,EAAE,kCAAU;KACxB;CACF,CAAC,CAAC;AACH,YAAY,CAAC,KAAK,IAAI,EAAE;IACtB,MAAM,mBAAW,CAAC,SAAS,CAAC;QAC1B,aAAa,EAAE;YACb,WAAW,EAAE;gBACX,SAAS,EAAE,MAAM;aAClB;YACD,IAAI,EAAE;gBACJ,mBAAmB,EAAE,KAAK;gBAC1B,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/type-writer/type-writer.extension.d.ts

@@ -0,0 +1,2 @@
+import { TServiceParams } from "..";
+export declare function TypeWriter({ hass, logger }: TServiceParams): Promise<() => Promise<string>>;

package/dist/type-writer/type-writer.extension.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeWriter = void 0;
+/* eslint-disable sonarjs/cognitive-complexity */
+/* eslint-disable unicorn/consistent-function-scoping */
+const js_yaml_1 = require("js-yaml");
+const typescript_1 = require("typescript");
+const __1 = require("..");
+const printer = (0, typescript_1.createPrinter)({ newLine: typescript_1.NewLineKind.LineFeed });
+const resultFile = (0, typescript_1.createSourceFile)("", "", typescript_1.ScriptTarget.Latest, false, typescript_1.ScriptKind.TS);
+let lastBuild;
+let lastServices;
+async function TypeWriter({ hass, logger }) {
+    return async function () {
+        const domains = await hass.fetch.listServices();
+        const stringified = JSON.stringify(domains);
+        if (stringified === lastServices) {
+            return lastBuild;
+        }
+        // logger.info(`Services updated`);
+        lastServices = stringified;
+        lastBuild = printer.printNode(typescript_1.EmitHint.Unspecified, 
+        // Wrap all this into a top level `interface iCallService`
+        typescript_1.factory.createTypeAliasDeclaration([typescript_1.factory.createModifier(typescript_1.SyntaxKind.ExportKeyword)], typescript_1.factory.createIdentifier("iCallService"), undefined, 
+        // Create categories based off domain name
+        // { domain: {...services} }
+        typescript_1.factory.createTypeLiteralNode(domains
+            .sort((a, b) => (a.domain > b.domain ? __1.UP : __1.DOWN))
+            .map(({ domain, services }) => typescript_1.factory.createPropertySignature(undefined, typescript_1.factory.createIdentifier(domain), undefined, typescript_1.factory.createTypeLiteralNode(
+        // Create functions based on provided services
+        // { [...service_name](service_data): Promise<void> }
+        Object.entries(services)
+            .sort(([a], [b]) => (a > b ? __1.UP : __1.DOWN))
+            .map(([key, value]) => (0, typescript_1.addSyntheticLeadingComment)(typescript_1.factory.createMethodSignature(undefined, typescript_1.factory.createIdentifier(key), undefined, undefined, [
+            // f( service_data: { ...definition } )
+            //    Provide this        ^^^^^^
+            typescript_1.factory.createParameterDeclaration(undefined, undefined, typescript_1.factory.createIdentifier("service_data"), 
+            // ? If all the parameters are optional, then don't require the data at all
+            Object.values(value.fields).some(i => __1.is.boolean(i.required) ? !i.required : true)
+                ? typescript_1.factory.createToken(typescript_1.SyntaxKind.QuestionToken)
+                : undefined, typescript_1.factory.createTypeLiteralNode([
+                ...Object.entries(value.fields)
+                    .sort(([a], [b]) => (a > b ? __1.UP : __1.DOWN))
+                    .map(([service, details]) => fieldPropertySignature(service, details, domain, key)),
+                createTarget(value.target),
+            ].filter(i => !__1.is.undefined(i)))),
+        ], typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("Promise"), [
+            typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.VoidKeyword),
+        ])), typescript_1.SyntaxKind.MultiLineCommentTrivia, `*\n` +
+            [
+                `### ${value.name || key}`,
+                "",
+                ...value.description.split("\n").map(i => `> ${i}`),
+            ]
+                .map(i => ` * ${i}`)
+                .join(`\n`) +
+            "\n ", true))))))), resultFile);
+        function createTarget(target) {
+            if (__1.is.empty(target)) {
+                return undefined;
+            }
+            if (target.entity) {
+                const property = typescript_1.factory.createPropertySignature(undefined, typescript_1.factory.createIdentifier("entity_id"), undefined, generateEntityList(target));
+                return (0, typescript_1.addSyntheticLeadingComment)(property, typescript_1.SyntaxKind.MultiLineCommentTrivia, "*\n" +
+                    ["Assisted definition"].map(i => ` * ${i}`).join(`\n`) +
+                    "\n ", true);
+            }
+            if (target.integration) {
+                return undefined;
+            }
+            if (target.device) {
+                return undefined;
+            }
+            logger.error({ target }, `this#createTarget doesn't know what to do with target. Report as bug with this log line`);
+            return undefined;
+        }
+        /**
+         * # entity_id
+         *
+         * This block is specifically for refining the `entity_id` type definitions
+         */
+        function generateEntityList(target) {
+            const isEmpty = __1.is.empty(target.entity) || target.entity.every(i => __1.is.empty(i));
+            if (isEmpty) {
+                return typescript_1.factory.createParenthesizedType(typescript_1.factory.createUnionTypeNode([
+                    typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("PICK_ENTITY"), undefined),
+                    typescript_1.factory.createArrayTypeNode(typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("PICK_ENTITY"), undefined)),
+                ]));
+            }
+            const domain = target.entity.find(i => !__1.is.empty(i.domain))?.domain;
+            const domainReference = domain.shift();
+            return typescript_1.factory.createParenthesizedType(typescript_1.factory.createUnionTypeNode([
+                typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("PICK_ENTITY"), [
+                    typescript_1.factory.createLiteralTypeNode(typescript_1.factory.createStringLiteral(domainReference)),
+                ]),
+                typescript_1.factory.createArrayTypeNode(typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("PICK_ENTITY"), [
+                    typescript_1.factory.createLiteralTypeNode(typescript_1.factory.createStringLiteral(domainReference)),
+                ])),
+            ]));
+        }
+        // function getDomain(target: ServiceListEntityTarget) {
+        //   return target.
+        // }
+        function fieldPropertySignature(parameterName, { selector, ...details }, serviceDomain, serviceName) {
+            let node;
+            const { domain } = selector?.entity ?? {};
+            // : boolean
+            if (!__1.is.undefined(selector?.boolean))
+                node = typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.BooleanKeyword);
+            // : number
+            else if (!__1.is.undefined(selector?.number))
+                node = typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.NumberKeyword);
+            // : string
+            else if (!__1.is.undefined(selector?.text) || !__1.is.undefined(selector?.time))
+                node = typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.StringKeyword);
+            // string | `domain.${keyof typeof ENTITY_SETUP.domain}`
+            else if (!__1.is.undefined(selector?.entity))
+                node = __1.is.empty(domain)
+                    ? typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.StringKeyword)
+                    : typescript_1.factory.createParenthesizedType(typescript_1.factory.createUnionTypeNode([
+                        typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("PICK_ENTITY"), [
+                            typescript_1.factory.createLiteralTypeNode(typescript_1.factory.createStringLiteral(domain)),
+                        ]),
+                        typescript_1.factory.createArrayTypeNode(typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("PICK_ENTITY"), [
+                            typescript_1.factory.createLiteralTypeNode(typescript_1.factory.createStringLiteral(domain)),
+                        ])),
+                    ]));
+            // : "option" | "option" | "option" | "option"
+            else if (!__1.is.undefined(selector?.select))
+                node = typescript_1.factory.createUnionTypeNode(selector?.select.options.map((i) => typescript_1.factory.createLiteralTypeNode(typescript_1.factory.createStringLiteral(__1.is.string(i) ? i : i.value))));
+            // : Record<string, unknown> | (unknown[]);
+            else if (__1.is.undefined(selector?.object)) {
+                node = typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.UnknownKeyword);
+            }
+            // else if (!is.undefined(selector?.))
+            // : unknown
+            else {
+                node = handleSelectors(serviceDomain, serviceName, {
+                    selector,
+                    ...details,
+                });
+            }
+            const property = typescript_1.factory.createPropertySignature(undefined, typescript_1.factory.createIdentifier(parameterName), details.required
+                ? undefined
+                : typescript_1.factory.createToken(typescript_1.SyntaxKind.QuestionToken), node);
+            return (0, typescript_1.addSyntheticLeadingComment)(property, typescript_1.SyntaxKind.MultiLineCommentTrivia, buildParameterMultilineComment(parameterName, { selector, ...details }), true);
+        }
+        function handleSelectors(serviceDomain, serviceName, { selector }) {
+            if ("object" in selector && selector.object === null) {
+                // if (serviceDomain === "conversation") {
+                // console.log({ serviceDomain, serviceName }, selector, options);
+                // }
+                return typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.UnknownKeyword);
+            }
+            return typescript_1.factory.createUnionTypeNode([
+                serviceDomain === "scene" && serviceName === "apply"
+                    ? typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("Partial"), [
+                        typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("Record"), [
+                            typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("PICK_ENTITY"), undefined),
+                            typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.UnknownKeyword),
+                        ]),
+                    ])
+                    : typescript_1.factory.createTypeReferenceNode(typescript_1.factory.createIdentifier("Record"), [
+                        typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.StringKeyword),
+                        typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.UnknownKeyword),
+                    ]),
+                typescript_1.factory.createParenthesizedType(typescript_1.factory.createArrayTypeNode(typescript_1.factory.createKeywordTypeNode(typescript_1.SyntaxKind.UnknownKeyword))),
+            ]);
+        }
+        function buildParameterMultilineComment(parameterName, { selector, ...details }) {
+            const example = String(details.example ?? "");
+            let out = `*\n` +
+                [
+                    "## " + (__1.is.empty(details.name) ? parameterName : details.name),
+                    ...(__1.is.empty(details.description) ? [] : ["", details.description]),
+                    ...(__1.is.empty(example)
+                        ? []
+                        : [
+                            "",
+                            `### Example`,
+                            "",
+                            "```json",
+                            JSON.stringify(example, undefined, "  "),
+                            "```",
+                        ]),
+                    ...(__1.is.undefined(details.default)
+                        ? []
+                        : [
+                            "",
+                            `### Default`,
+                            "",
+                            "```json",
+                            ...JSON.stringify(details.default).split("\n"),
+                            "```",
+                        ]),
+                    "",
+                    "## Selector",
+                    "",
+                    "```yaml",
+                    (0, js_yaml_1.dump)(selector).trim(),
+                    "```",
+                ]
+                    .map(i => ` * ${i}`)
+                    .join(`\n`);
+            out = out + "`\n ";
+            return out;
+        }
+        return lastBuild;
+    };
+}
+exports.TypeWriter = TypeWriter;
+//# sourceMappingURL=type-writer.extension.js.map

package/dist/type-writer/type-writer.extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-writer.extension.js","sourceRoot":"","sources":["../../src/type-writer/type-writer.extension.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,wDAAwD;AACxD,qCAA+B;AAC/B,2CAYoB;AAEpB,0BAAkD;AAGlD,MAAM,OAAO,GAAG,IAAA,0BAAa,EAAC,EAAE,OAAO,EAAE,wBAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;AACjE,MAAM,UAAU,GAAG,IAAA,6BAAgB,EACjC,EAAE,EACF,EAAE,EACF,yBAAY,CAAC,MAAM,EACnB,KAAK,EACL,uBAAU,CAAC,EAAE,CACd,CAAC;AACF,IAAI,SAAiB,CAAC;AACtB,IAAI,YAAoB,CAAC;AAElB,KAAK,UAAU,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAkB;IAC/D,OAAO,KAAK;QACV,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,mCAAmC;QACnC,YAAY,GAAG,WAAW,CAAC;QAC3B,SAAS,GAAG,OAAO,CAAC,SAAS,CAC3B,qBAAQ,CAAC,WAAW;QACpB,0DAA0D;QAC1D,oBAAO,CAAC,0BAA0B,CAChC,CAAC,oBAAO,CAAC,cAAc,CAAC,uBAAU,CAAC,aAAa,CAAC,CAAC,EAClD,oBAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,EACxC,SAAS;QACT,0CAA0C;QAC1C,4BAA4B;QAC5B,oBAAO,CAAC,qBAAqB,CAC3B,OAAO;aACJ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAE,CAAC,CAAC,CAAC,QAAI,CAAC,CAAC;aACjD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC5B,oBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,oBAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAChC,SAAS,EACT,oBAAO,CAAC,qBAAqB;QAC3B,8CAA8C;QAC9C,qDAAqD;QACrD,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;aACrB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAE,CAAC,CAAC,CAAC,QAAI,CAAC,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACpB,IAAA,uCAA0B,EACxB,oBAAO,CAAC,qBAAqB,CAC3B,SAAS,EACT,oBAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAC7B,SAAS,EACT,SAAS,EACT;YACE,uCAAuC;YACvC,gCAAgC;YAChC,oBAAO,CAAC,0BAA0B,CAChC,SAAS,EACT,SAAS,EACT,oBAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC;YACxC,2EAA2E;YAC3E,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACnC,MAAE,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAC5C;gBACC,CAAC,CAAC,oBAAO,CAAC,WAAW,CAAC,uBAAU,CAAC,aAAa,CAAC;gBAC/C,CAAC,CAAC,SAAS,EACb,oBAAO,CAAC,qBAAqB,CAC3B;gBACE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;qBAC5B,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAE,CAAC,CAAC,CAAC,QAAI,CAAC,CAAC;qBACvC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAC1B,sBAAsB,CACpB,OAAO,EACP,OAAO,EACP,MAAM,EACN,GAAG,CACJ,CACF;gBACH,YAAY,CACV,KAAK,CAAC,MAAkC,CACzC;aACF,CAAC,MAAM,CACN,CAAC,CAAC,EAAE,CAAC,CAAC,MAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CACL,CACnB,CACF;SACF,EACD,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,EACnC;YACE,oBAAO,CAAC,qBAAqB,CAC3B,uBAAU,CAAC,WAAW,CACvB;SACF,CACF,CACF,EACD,uBAAU,CAAC,sBAAsB,EACjC,KAAK;YACH;gBACE,OAAO,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE;gBAC1B,EAAE;gBACF,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACpD;iBACE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;iBACnB,IAAI,CAAC,IAAI,CAAC;YACb,KAAK,EACP,IAAI,CACL,CACF,CACJ,CACF,CACF,CACJ,CACF,EACD,UAAU,CACX,CAAC;QAEF,SAAS,YAAY,CAAC,MAAgC;YACpD,IAAI,MAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrB,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,QAAQ,GAAG,oBAAO,CAAC,uBAAuB,CAC9C,SAAS,EACT,oBAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,EACrC,SAAS,EACT,kBAAkB,CAAC,MAAM,CAAC,CAC3B,CAAC;gBACF,OAAO,IAAA,uCAA0B,EAC/B,QAAQ,EACR,uBAAU,CAAC,sBAAsB,EACjC,KAAK;oBACH,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACtD,KAAK,EACP,IAAI,CACL,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,CAAC,KAAK,CACV,EAAE,MAAM,EAAE,EACV,yFAAyF,CAC1F,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED;;;;WAIG;QACH,SAAS,kBAAkB,CAAC,MAAgC;YAC1D,MAAM,OAAO,GACX,MAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,oBAAO,CAAC,uBAAuB,CACpC,oBAAO,CAAC,mBAAmB,CAAC;oBAC1B,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC,SAAS,CACV;oBACD,oBAAO,CAAC,mBAAmB,CACzB,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC,SAAS,CACV,CACF;iBACF,CAAC,CACH,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC;YACpE,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YACvC,OAAO,oBAAO,CAAC,uBAAuB,CACpC,oBAAO,CAAC,mBAAmB,CAAC;gBAC1B,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC;oBACE,oBAAO,CAAC,qBAAqB,CAC3B,oBAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAC7C;iBACF,CACF;gBACD,oBAAO,CAAC,mBAAmB,CACzB,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC;oBACE,oBAAO,CAAC,qBAAqB,CAC3B,oBAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAC7C;iBACF,CACF,CACF;aACF,CAAC,CACH,CAAC;QACJ,CAAC;QAED,wDAAwD;QACxD,mBAAmB;QACnB,IAAI;QAEJ,SAAS,sBAAsB,CAC7B,aAAqB,EACrB,EAAE,QAAQ,EAAE,GAAG,OAAO,EAA+B,EACrD,aAAqB,EACrB,WAAmB;YAEnB,IAAI,IAAc,CAAC;YACnB,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;YAC1C,YAAY;YACZ,IAAI,CAAC,MAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAClC,IAAI,GAAG,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,cAAc,CAAC,CAAC;YAClE,WAAW;iBACN,IAAI,CAAC,MAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACtC,IAAI,GAAG,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,aAAa,CAAC,CAAC;YACjE,WAAW;iBACN,IAAI,CAAC,MAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC;gBACrE,IAAI,GAAG,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,aAAa,CAAC,CAAC;YACjE,wDAAwD;iBACnD,IAAI,CAAC,MAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACtC,IAAI,GAAG,MAAE,CAAC,KAAK,CAAC,MAAM,CAAC;oBACrB,CAAC,CAAC,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,aAAa,CAAC;oBACzD,CAAC,CAAC,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,mBAAmB,CAAC;wBAC1B,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC;4BACE,oBAAO,CAAC,qBAAqB,CAC3B,oBAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CACpC;yBACF,CACF;wBACD,oBAAO,CAAC,mBAAmB,CACzB,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC;4BACE,oBAAO,CAAC,qBAAqB,CAC3B,oBAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CACpC;yBACF,CACF,CACF;qBACF,CAAC,CACH,CAAC;YACR,8CAA8C;iBACzC,IAAI,CAAC,MAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACtC,IAAI,GAAG,oBAAO,CAAC,mBAAmB,CAChC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAC1B,CAAC,CAA6C,EAAE,EAAE,CAChD,oBAAO,CAAC,qBAAqB,CAC3B,oBAAO,CAAC,mBAAmB,CAAC,MAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CACxD,CACJ,CACF,CAAC;YACJ,2CAA2C;iBACtC,IAAI,MAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;gBACxC,IAAI,GAAG,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,cAAc,CAAC,CAAC;YAClE,CAAC;YACD,sCAAsC;YACtC,YAAY;iBACP,CAAC;gBACJ,IAAI,GAAG,eAAe,CAAC,aAAa,EAAE,WAAW,EAAE;oBACjD,QAAQ;oBACR,GAAG,OAAO;iBACX,CAAC,CAAC;YACL,CAAC;YAED,MAAM,QAAQ,GAAG,oBAAO,CAAC,uBAAuB,CAC9C,SAAS,EACT,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC,OAAO,CAAC,QAAQ;gBACd,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,oBAAO,CAAC,WAAW,CAAC,uBAAU,CAAC,aAAa,CAAC,EACjD,IAAI,CACL,CAAC;YACF,OAAO,IAAA,uCAA0B,EAC/B,QAAQ,EACR,uBAAU,CAAC,sBAAsB,EACjC,8BAA8B,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC,EACvE,IAAI,CACL,CAAC;QACJ,CAAC;QAED,SAAS,eAAe,CACtB,aAAqB,EACrB,WAAmB,EACnB,EAAE,QAAQ,EAA+B;YAEzC,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACrD,0CAA0C;gBAC1C,kEAAkE;gBAClE,IAAI;gBACJ,OAAO,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,cAAc,CAAC,CAAC;YAClE,CAAC;YAED,OAAO,oBAAO,CAAC,mBAAmB,CAAC;gBACjC,aAAa,KAAK,OAAO,IAAI,WAAW,KAAK,OAAO;oBAClD,CAAC,CAAC,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,EACnC;wBACE,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAClC;4BACE,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC,SAAS,CACV;4BACD,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,cAAc,CAAC;yBACzD,CACF;qBACF,CACF;oBACH,CAAC,CAAC,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAClC;wBACE,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,aAAa,CAAC;wBACvD,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,cAAc,CAAC;qBACzD,CACF;gBACL,oBAAO,CAAC,uBAAuB,CAC7B,oBAAO,CAAC,mBAAmB,CACzB,oBAAO,CAAC,qBAAqB,CAAC,uBAAU,CAAC,cAAc,CAAC,CACzD,CACF;aACF,CAAC,CAAC;QACL,CAAC;QAED,SAAS,8BAA8B,CACrC,aAAqB,EACrB,EAAE,QAAQ,EAAE,GAAG,OAAO,EAA+B;YAErD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC9C,IAAI,GAAG,GACL,KAAK;gBACL;oBACE,KAAK,GAAG,CAAC,MAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;oBAC/D,GAAG,CAAC,MAAE,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;oBACnE,GAAG,CAAC,MAAE,CAAC,KAAK,CAAC,OAAO,CAAC;wBACnB,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE,EAAE;4BACF,aAAa;4BACb,EAAE;4BACF,SAAS;4BACT,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC;4BACxC,KAAK;yBACN,CAAC;oBACN,GAAG,CAAC,MAAE,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;wBAC/B,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE,EAAE;4BACF,aAAa;4BACb,EAAE;4BACF,SAAS;4BACT,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;4BAC9C,KAAK;yBACN,CAAC;oBACN,EAAE;oBAEF,aAAa;oBACb,EAAE;oBACF,SAAS;oBACT,IAAA,cAAI,EAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;oBACrB,KAAK;iBACN;qBACE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;qBACnB,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;YACnB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAxWD,gCAwWC"}

package/dist/utilities/extensions/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./is.extension";
+export * from "./zcc.extension";
+export * from "./zcc-testing.extension";

package/dist/utilities/extensions/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./is.extension"), exports);
+tslib_1.__exportStar(require("./zcc.extension"), exports);
+tslib_1.__exportStar(require("./zcc-testing.extension"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utilities/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/extensions/index.ts"],"names":[],"mappings":";;;AAAA,yDAA+B;AAC/B,0DAAgC;AAChC,kEAAwC"}

package/dist/utilities/extensions/is.extension.d.ts

@@ -0,0 +1,38 @@
+import { TBlackHole, TContext } from "../helpers";
+type MaybeEmptyTypes = string | undefined | Array<unknown> | Set<unknown> | Map<unknown, unknown> | object;
+type MaybeFunction = (...parameters: unknown[]) => TBlackHole;
+/**
+ * type testing and basic conversion tools
+ */
+export declare class IsIt {
+    array(test: unknown): test is Array<unknown>;
+    boolean(test: unknown): test is boolean;
+    /**
+     * The internals of this test may get more creative as context evolves
+     */
+    context(test: unknown): test is TContext;
+    date(test: unknown): test is Date;
+    empty(test: MaybeEmptyTypes): boolean;
+    /**
+     * ### Deep equality test
+     */
+    equal<T extends unknown>(a: T, b: T): boolean;
+    even(test: number): boolean;
+    function<T extends MaybeFunction>(test: unknown): test is T;
+    /**
+     * Generates a hash code for a string, based on the Java String hash function.
+     * It iterates through the characters of the string, combining the ASCII values
+     * with a prime multiplier to create a unique hash value.
+     * This method can be useful for creating a simple, consistent hash code.
+     */
+    hash(text: string): string;
+    number(test: unknown): test is number;
+    object(test: unknown): test is object;
+    random<T>(list: T[]): T;
+    string(test: unknown): test is string;
+    symbol(test: unknown): test is symbol;
+    undefined(test: unknown): test is undefined;
+    unique<T>(items: T[]): T[];
+}
+export declare const is: IsIt;
+export {};

package/dist/utilities/extensions/is.extension.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.is = exports.IsIt = void 0;
+const assert_1 = require("assert");
+const helpers_1 = require("../helpers");
+const HASH_PRIME_MULTIPLIER = 31;
+/**
+ * type testing and basic conversion tools
+ */
+class IsIt {
+    array(test) {
+        return Array.isArray(test);
+    }
+    boolean(test) {
+        return typeof test === "boolean";
+    }
+    /**
+     * The internals of this test may get more creative as context evolves
+     */
+    context(test) {
+        return typeof test === "string";
+    }
+    date(test) {
+        return test instanceof Date;
+    }
+    empty(test) {
+        if (test === undefined) {
+            return true;
+        }
+        if (typeof test === "string" || Array.isArray(test)) {
+            return test.length === helpers_1.EMPTY;
+        }
+        if (test instanceof Map || test instanceof Set) {
+            return test.size === helpers_1.EMPTY;
+        }
+        if (typeof test === "object") {
+            for (const key in test) {
+                if (Object.prototype.hasOwnProperty.call(test, key)) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        // Optional: Throw an error or return a default value for unsupported types
+        throw new Error("Unsupported type");
+    }
+    /**
+     * ### Deep equality test
+     */
+    equal(a, b) {
+        try {
+            (0, assert_1.deepEqual)(a, b);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    even(test) {
+        return test % helpers_1.EVEN === helpers_1.EMPTY;
+    }
+    function(test) {
+        return typeof test === "function";
+    }
+    /**
+     * Generates a hash code for a string, based on the Java String hash function.
+     * It iterates through the characters of the string, combining the ASCII values
+     * with a prime multiplier to create a unique hash value.
+     * This method can be useful for creating a simple, consistent hash code.
+     */
+    hash(text) {
+        let hash = helpers_1.START;
+        for (let i = helpers_1.START; i < text.length; i++) {
+            hash =
+                (hash << HASH_PRIME_MULTIPLIER) - hash + (text.codePointAt(i) || helpers_1.NONE);
+            hash = Math.trunc(hash);
+        }
+        return hash.toString();
+    }
+    number(test) {
+        return typeof test === "number" && !Number.isNaN(test);
+    }
+    object(test) {
+        return typeof test === "object" && test !== null && !Array.isArray(test);
+    }
+    random(list) {
+        return list[Math.floor(Math.random() * list.length)];
+    }
+    string(test) {
+        return typeof test === "string";
+    }
+    symbol(test) {
+        return typeof test === "symbol";
+    }
+    undefined(test) {
+        return test === undefined;
+    }
+    unique(items) {
+        return [...new Set(items)];
+    }
+}
+exports.IsIt = IsIt;
+exports.is = new IsIt();
+//# sourceMappingURL=is.extension.js.map

package/dist/utilities/extensions/is.extension.js.map

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

package/dist/utilities/extensions/zcc-testing.extension.d.ts

@@ -0,0 +1,4 @@
+export declare class ZCCTestingDefinition {
+    APP_NAME: string;
+}
+export declare const ZCC_Testing: ZCCTestingDefinition;

package/dist/utilities/extensions/zcc-testing.extension.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZCC_Testing = exports.ZCCTestingDefinition = void 0;
+class ZCCTestingDefinition {
+    APP_NAME = "digital-alchemy-unit-tests";
+}
+exports.ZCCTestingDefinition = ZCCTestingDefinition;
+exports.ZCC_Testing = new ZCCTestingDefinition();
+//# sourceMappingURL=zcc-testing.extension.js.map

package/dist/utilities/extensions/zcc-testing.extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zcc-testing.extension.js","sourceRoot":"","sources":["../../../src/utilities/extensions/zcc-testing.extension.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAoB;IACxB,QAAQ,GAAG,4BAA4B,CAAC;CAChD;AAFD,oDAEC;AAEY,QAAA,WAAW,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/utilities/extensions/zcc.extension.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" />
+import { Dayjs } from "dayjs";
+import { EventEmitter } from "events";
+type inputFormats = Date | string | number | Dayjs;
+export declare class ZCCDefinition_Utils {
+    TitleCase(input: string): string;
+    relativeDate(pastDate: inputFormats, futureDate?: inputFormats): string;
+}
+export declare class ZCCDefinition {
+    /**
+     * The global eventemitter. All of `@digital-alchemy` will be wired through this
+     *
+     * **NOTE:** bootstrapping process will initialize this at boot, and cleanup at teardown.
+     * Making listener changes should only be done from within the context of service functions
+     */
+    event: EventEmitter;
+    utils: ZCCDefinition_Utils;
+}
+export declare const ZCC: ZCCDefinition;
+export {};