@aglyn/shared-util-tools 1.0.0-beta.143

package/src/lib/crud.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { CrudModel } from '@aglyn/shared-data-types';
+/**
+ * Methods (set, get, has, del) to c.r.u.d. an index of the data property
+ *
+ * @export
+ * @abstract
+ * @class Crud
+ * @implements {Crud<T>}
+ * @template T
+ */
+export declare abstract class Crud<T = any> implements CrudModel<T> {
+    model: T;
+    /**
+     * Creates an instance of Crud.
+     * @param {T} [model={} as any]
+     * @memberof Crud
+     */
+    constructor(model?: T);
+    /** @inheritdoc */
+    toJSON(): T;
+    /** @inheritdoc */
+    set<K extends keyof T>(id: K, value: any): this;
+    /** @inheritdoc */
+    get<K extends keyof T>(id: K): T[K] | null;
+    /** @inheritdoc */
+    has<K extends keyof T>(id: K): boolean;
+    /** @inheritdoc */
+    delete<K extends keyof T>(id: K): this;
+    private get hasOwnProperty();
+}

package/src/lib/crud.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ // eslint-disable-next-line @nx/enforce-module-boundaries
+/**
+ * Methods (set, get, has, del) to c.r.u.d. an index of the data property
+ *
+ * @export
+ * @abstract
+ * @class Crud
+ * @implements {Crud<T>}
+ * @template T
+ */ export class Crud {
+    /** @inheritdoc */ toJSON() {
+        return this.model;
+    }
+    /** @inheritdoc */ set(id, value) {
+        this.model[id] = value;
+        return this;
+    }
+    /** @inheritdoc */ get(id) {
+        return this.model[id];
+    }
+    /** @inheritdoc */ has(id) {
+        return this.hasOwnProperty.call(this.model, id);
+    }
+    /** @inheritdoc */ delete(id) {
+        delete this.model[id];
+        return this;
+    }
+    get hasOwnProperty() {
+        return Object.prototype.hasOwnProperty;
+    }
+    /**
+   * Creates an instance of Crud.
+   * @param {T} [model={} as any]
+   * @memberof Crud
+   */ constructor(model = {}){
+        this.model = model;
+    }
+}
+
+//# sourceMappingURL=crud.js.map

package/src/lib/crud.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/crud.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// eslint-disable-next-line @nx/enforce-module-boundaries\nimport type { CrudModel } from '@aglyn/shared-data-types'\n\n/**\n * Methods (set, get, has, del) to c.r.u.d. an index of the data property\n *\n * @export\n * @abstract\n * @class Crud\n * @implements {Crud<T>}\n * @template T\n */\nexport abstract class Crud<T = any> implements CrudModel<T> {\n  /**\n   * Creates an instance of Crud.\n   * @param {T} [model={} as any]\n   * @memberof Crud\n   */\n  constructor(public model: T = {} as any) {}\n\n  /** @inheritdoc */\n  public toJSON(): T {\n    return this.model\n  }\n\n  /** @inheritdoc */\n  public set<K extends keyof T>(id: K, value: any): this {\n    this.model[id] = value\n    return this\n  }\n\n  /** @inheritdoc */\n  public get<K extends keyof T>(id: K): T[K] | null {\n    return this.model[id]\n  }\n\n  /** @inheritdoc */\n  public has<K extends keyof T>(id: K): boolean {\n    return this.hasOwnProperty.call(this.model, id)\n  }\n\n  /** @inheritdoc */\n  public delete<K extends keyof T>(id: K): this {\n    delete this.model[id]\n    return this\n  }\n\n  private get hasOwnProperty() {\n    return Object.prototype.hasOwnProperty\n  }\n}\n"],"names":["Crud","toJSON","model","set","id","value","get","has","hasOwnProperty","call","delete","Object","prototype"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,yDAAyD;AAGzD;;;;;;;;CAQC,GACD,OAAO,MAAeA;IAQpB,gBAAgB,GAChB,AAAOC,SAAY;QACjB,OAAO,IAAI,CAACC,KAAK;IACnB;IAEA,gBAAgB,GAChB,AAAOC,IAAuBC,EAAK,EAAEC,KAAU,EAAQ;QACrD,IAAI,CAACH,KAAK,CAACE,GAAG,GAAGC;QACjB,OAAO,IAAI;IACb;IAEA,gBAAgB,GAChB,AAAOC,IAAuBF,EAAK,EAAe;QAChD,OAAO,IAAI,CAACF,KAAK,CAACE,GAAG;IACvB;IAEA,gBAAgB,GAChB,AAAOG,IAAuBH,EAAK,EAAW;QAC5C,OAAO,IAAI,CAACI,cAAc,CAACC,IAAI,CAAC,IAAI,CAACP,KAAK,EAAEE;IAC9C;IAEA,gBAAgB,GAChB,AAAOM,OAA0BN,EAAK,EAAQ;QAC5C,OAAO,IAAI,CAACF,KAAK,CAACE,GAAG;QACrB,OAAO,IAAI;IACb;IAEA,IAAYI,iBAAiB;QAC3B,OAAOG,OAAOC,SAAS,CAACJ,cAAc;IACxC;IApCA;;;;GAIC,GACD,YAAY,AAAON,QAAW,CAAC,CAAQ,CAAE;aAAtBA,QAAAA;IAAuB;AAgC5C"}

package/src/lib/css.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type Transform = {
+    x: number;
+    y: number;
+    scaleX: number;
+    scaleY: number;
+};
+export interface Transition {
+    property: string;
+    easing: string;
+    duration: number;
+}
+export declare const CSS: Readonly<{
+    Translate: {
+        toString(transform: Transform | null): string | undefined;
+    };
+    Scale: {
+        toString(transform: Transform | null): string | undefined;
+    };
+    Transform: {
+        toString(transform: Transform | null): string | undefined;
+    };
+    Transition: {
+        toString({ property, duration, easing }: Transition): string;
+    };
+}>;

package/src/lib/css.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ export const CSS = Object.freeze({
+    Translate: {
+        toString (transform) {
+            if (!transform) {
+                return undefined;
+            }
+            const x = transform.x ? Math.round(transform.x) : 0;
+            const y = transform.y ? Math.round(transform.y) : 0;
+            return `translate3d(${x}px, ${y}px, 0)`;
+        }
+    },
+    Scale: {
+        toString (transform) {
+            if (!transform) {
+                return undefined;
+            }
+            const { scaleX, scaleY } = transform;
+            return `scaleX(${scaleX}) scaleY(${scaleY})`;
+        }
+    },
+    Transform: {
+        toString (transform) {
+            if (!transform) {
+                return undefined;
+            }
+            return [
+                CSS.Translate.toString(transform),
+                CSS.Scale.toString(transform)
+            ].join(' ');
+        }
+    },
+    Transition: {
+        toString ({ property, duration, easing }) {
+            return `${property} ${duration}ms ${easing}`;
+        }
+    }
+});
+
+//# sourceMappingURL=css.js.map

package/src/lib/css.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/css.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2021 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport type Transform = {\n  x: number;\n  y: number;\n  scaleX: number;\n  scaleY: number;\n};\n\nexport interface Transition {\n  property: string;\n  easing: string;\n  duration: number;\n}\n\nexport const CSS = Object.freeze({\n  Translate: {\n    toString(transform: Transform | null): string | undefined {\n      if (!transform) {\n        return undefined;\n      }\n\n      const x = transform.x ? Math.round(transform.x) : 0\n      const y = transform.y ? Math.round(transform.y) : 0\n\n      return `translate3d(${x}px, ${y}px, 0)`;\n    },\n  },\n  Scale: {\n    toString(transform: Transform | null): string | undefined {\n      if (!transform) {\n        return undefined;\n      }\n\n      const {scaleX, scaleY} = transform;\n\n      return `scaleX(${scaleX}) scaleY(${scaleY})`;\n    },\n  },\n  Transform: {\n    toString(transform: Transform | null): string | undefined {\n      if (!transform) {\n        return undefined;\n      }\n\n      return [\n        CSS.Translate.toString(transform),\n        CSS.Scale.toString(transform),\n      ].join(' ');\n    },\n  },\n  Transition: {\n    toString({property, duration, easing}: Transition) {\n      return `${property} ${duration}ms ${easing}`;\n    },\n  },\n})\n"],"names":["CSS","Object","freeze","Translate","toString","transform","undefined","x","Math","round","y","Scale","scaleX","scaleY","Transform","join","Transition","property","duration","easing"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAeD,OAAO,MAAMA,MAAMC,OAAOC,MAAM,CAAC;IAC/BC,WAAW;QACTC,UAASC,SAA2B;YAClC,IAAI,CAACA,WAAW;gBACd,OAAOC;YACT;YAEA,MAAMC,IAAIF,UAAUE,CAAC,GAAGC,KAAKC,KAAK,CAACJ,UAAUE,CAAC,IAAI;YAClD,MAAMG,IAAIL,UAAUK,CAAC,GAAGF,KAAKC,KAAK,CAACJ,UAAUK,CAAC,IAAI;YAElD,OAAO,CAAC,YAAY,EAAEH,EAAE,IAAI,EAAEG,EAAE,MAAM,CAAC;QACzC;IACF;IACAC,OAAO;QACLP,UAASC,SAA2B;YAClC,IAAI,CAACA,WAAW;gBACd,OAAOC;YACT;YAEA,MAAM,EAACM,MAAM,EAAEC,MAAM,EAAC,GAAGR;YAEzB,OAAO,CAAC,OAAO,EAAEO,OAAO,SAAS,EAAEC,OAAO,CAAC,CAAC;QAC9C;IACF;IACAC,WAAW;QACTV,UAASC,SAA2B;YAClC,IAAI,CAACA,WAAW;gBACd,OAAOC;YACT;YAEA,OAAO;gBACLN,IAAIG,SAAS,CAACC,QAAQ,CAACC;gBACvBL,IAAIW,KAAK,CAACP,QAAQ,CAACC;aACpB,CAACU,IAAI,CAAC;QACT;IACF;IACAC,YAAY;QACVZ,UAAS,EAACa,QAAQ,EAAEC,QAAQ,EAAEC,MAAM,EAAa;YAC/C,OAAO,GAAGF,SAAS,CAAC,EAAEC,SAAS,GAAG,EAAEC,QAAQ;QAC9C;IACF;AACF,GAAE"}

package/src/lib/escape-html.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * HTML-escape a value for interpolation into markup assembled as a string.
+ *
+ * Every place in this repo that builds HTML by concatenation rather than
+ * through React needs this, and each one that wrote its own arrived at a
+ * different set of characters. Two of them omitted `'`, which is not a
+ * cosmetic difference: single quotes delimit attributes just as well as
+ * double quotes do, so `<a href='…'>` with an unescaped apostrophe in the
+ * value is an attribute break, and an attribute break is a tag.
+ *
+ * The five characters below are the complete set for both HTML text and
+ * attribute values. `'` becomes `&#39;` rather than `&apos;`, which HTML 4
+ * does not define. Non-string input coerces rather than throwing: callers
+ * read optional fields off stored documents, and a `null` slipping through
+ * must produce empty text, never a crash in the middle of rendering a page
+ * somebody is already waiting on.
+ *
+ * Deliberately NOT re-exported from this library's index — reach it as
+ * `@aglyn/shared-util-tools/escape-html`. The index note records why.
+ */
+export declare function escapeHtml(value: unknown): string;
+export default escapeHtml;

package/src/lib/escape-html.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * HTML-escape a value for interpolation into markup assembled as a string.
+ *
+ * Every place in this repo that builds HTML by concatenation rather than
+ * through React needs this, and each one that wrote its own arrived at a
+ * different set of characters. Two of them omitted `'`, which is not a
+ * cosmetic difference: single quotes delimit attributes just as well as
+ * double quotes do, so `<a href='…'>` with an unescaped apostrophe in the
+ * value is an attribute break, and an attribute break is a tag.
+ *
+ * The five characters below are the complete set for both HTML text and
+ * attribute values. `'` becomes `&#39;` rather than `&apos;`, which HTML 4
+ * does not define. Non-string input coerces rather than throwing: callers
+ * read optional fields off stored documents, and a `null` slipping through
+ * must produce empty text, never a crash in the middle of rendering a page
+ * somebody is already waiting on.
+ *
+ * Deliberately NOT re-exported from this library's index — reach it as
+ * `@aglyn/shared-util-tools/escape-html`. The index note records why.
+ */ export function escapeHtml(value) {
+    if (value == null) return '';
+    return String(value).replace(/[&<>"']/g, (character)=>({
+            '&': '&amp;',
+            '<': '&lt;',
+            '>': '&gt;',
+            '"': '&quot;',
+            "'": '&#39;'
+        })[character]);
+}
+export default escapeHtml;
+
+//# sourceMappingURL=escape-html.js.map

package/src/lib/escape-html.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/escape-html.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * HTML-escape a value for interpolation into markup assembled as a string.\n *\n * Every place in this repo that builds HTML by concatenation rather than\n * through React needs this, and each one that wrote its own arrived at a\n * different set of characters. Two of them omitted `'`, which is not a\n * cosmetic difference: single quotes delimit attributes just as well as\n * double quotes do, so `<a href='…'>` with an unescaped apostrophe in the\n * value is an attribute break, and an attribute break is a tag.\n *\n * The five characters below are the complete set for both HTML text and\n * attribute values. `'` becomes `&#39;` rather than `&apos;`, which HTML 4\n * does not define. Non-string input coerces rather than throwing: callers\n * read optional fields off stored documents, and a `null` slipping through\n * must produce empty text, never a crash in the middle of rendering a page\n * somebody is already waiting on.\n *\n * Deliberately NOT re-exported from this library's index — reach it as\n * `@aglyn/shared-util-tools/escape-html`. The index note records why.\n */\nexport function escapeHtml(value: unknown): string {\n  if (value == null) return ''\n  return String(value).replace(\n    /[&<>\"']/g,\n    (character) =>\n      ({\n        '&': '&amp;',\n        '<': '&lt;',\n        '>': '&gt;',\n        '\"': '&quot;',\n        \"'\": '&#39;',\n      })[character] as string,\n  )\n}\n\nexport default escapeHtml\n"],"names":["escapeHtml","value","String","replace","character"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,SAASA,WAAWC,KAAc;IACvC,IAAIA,SAAS,MAAM,OAAO;IAC1B,OAAOC,OAAOD,OAAOE,OAAO,CAC1B,YACA,CAACC,YACC,AAAC,CAAA;YACC,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;QACP,CAAA,CAAE,CAACA,UAAU;AAEnB;AAEA,eAAeJ,WAAU"}

package/src/lib/falsy.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type FalsyParams = unknown[];
+/**
+ * Shortcut for checking multiple falsy values e.g., `!Boolean(i of val)`
+ * @returns return true unless any value is truthy otherwise returns false
+ */
+export declare function falsy(...val: FalsyParams): boolean;
+export default falsy;

package/src/lib/falsy.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import truthy from "./truthy.js";
+/**
+ * Shortcut for checking multiple falsy values e.g., `!Boolean(i of val)`
+ * @returns return true unless any value is truthy otherwise returns false
+ */ export function falsy(...val) {
+    return !truthy(...val);
+}
+export default falsy;
+
+//# sourceMappingURL=falsy.js.map

package/src/lib/falsy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/falsy.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport truthy from './truthy'\n\n\nexport type FalsyParams = unknown[]\n\n/**\n * Shortcut for checking multiple falsy values e.g., `!Boolean(i of val)`\n * @returns return true unless any value is truthy otherwise returns false\n */\nexport function falsy(...val: FalsyParams): boolean {\n  return !truthy(...val)\n}\nexport default falsy\n"],"names":["truthy","falsy","val"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAOA,YAAY,cAAU;AAK7B;;;CAGC,GACD,OAAO,SAASC,MAAM,GAAGC,GAAgB;IACvC,OAAO,CAACF,UAAUE;AACpB;AACA,eAAeD,MAAK"}

package/src/lib/get-display-name.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare const fnNameMatchRegex: RegExp;
+export declare const getPureFunctionName: (fn: any) => string;
+/**
+ *
+ */
+export declare const getFunctionComponentName: (Component: {
+    displayName?: string;
+    name?: string;
+}, fallback?: string) => string;
+export declare const getWrappedComponentName: (outerType: {
+    displayName?: string;
+}, innerType: {
+    displayName?: string;
+    name?: string;
+}, wrapperName: string) => string;
+/**
+ * Get the display name of a function, react component, object, or string
+ * @example getDisplayName('hello') => 'hello'
+ * @example getDisplayName(null, 'N/A') => 'N/A'
+ * @example getDisplayName(getCount) => 'getCount'
+ * @example getDisplayName(class MyComp {displayName = 'My'}) => 'My'
+ * @example
+ * MyComp = () => {...};
+ * MyComp.displayName = 'MyComp'
+MyComp.aglyn = true;
+ * MyComp = forwardRef(MyComp)
+ * getDisplayName(MyComp) => 'My'
+ */
+export declare function getDisplayName(fn: any, fallback?: string): string;
+export default getDisplayName;

package/src/lib/get-display-name.js

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ // https://github.com/JamesMGreene/Function.name/blob/58b314d4a983110c3682f1228f845d39ccca1817/Function.name.js#L3
+export const fnNameMatchRegex = /^\s*function(?:\s|\s*\/\*.*\*\/\s*)+([^(\s/]*)\s*/;
+export const getPureFunctionName = (fn)=>{
+    const match = `${fn}`.match(fnNameMatchRegex);
+    const name = match && match[1];
+    return name || '';
+};
+/**
+ *
+ */ export const getFunctionComponentName = (Component, fallback = 'fn')=>Component.displayName || Component.name || getPureFunctionName(Component) || fallback;
+export const getWrappedComponentName = (outerType, innerType, wrapperName)=>{
+    const functionName = getFunctionComponentName(innerType);
+    return outerType.displayName || (functionName !== '' ? `${wrapperName}(${functionName})` : wrapperName);
+};
+/**
+ * Get the display name of a function, react component, object, or string
+ * @example getDisplayName('hello') => 'hello'
+ * @example getDisplayName(null, 'N/A') => 'N/A'
+ * @example getDisplayName(getCount) => 'getCount'
+ * @example getDisplayName(class MyComp {displayName = 'My'}) => 'My'
+ * @example
+ * MyComp = () => {...};
+ * MyComp.displayName = 'MyComp'
+MyComp.aglyn = true;
+ * MyComp = forwardRef(MyComp)
+ * getDisplayName(MyComp) => 'My'
+ */ export function getDisplayName(fn, fallback = 'Component') {
+    if (fn == null) {
+        return fallback;
+    }
+    if (typeof fn === 'string') {
+        return fn;
+    }
+    if (typeof fn === 'function') {
+        return getFunctionComponentName(fn, fallback);
+    }
+    if (typeof fn === 'object') {
+        switch(fn.$$typeof){
+            case Symbol.for('react.forward_ref') || 0xead0:
+                return getWrappedComponentName(fn, fn.render, 'ForwardRef');
+            default:
+                return fallback;
+        }
+    }
+    return fallback;
+}
+export default getDisplayName;
+
+//# sourceMappingURL=get-display-name.js.map

package/src/lib/get-display-name.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/get-display-name.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n\n// https://github.com/JamesMGreene/Function.name/blob/58b314d4a983110c3682f1228f845d39ccca1817/Function.name.js#L3\nexport const fnNameMatchRegex = /^\\s*function(?:\\s|\\s*\\/\\*.*\\*\\/\\s*)+([^(\\s/]*)\\s*/\nexport const getPureFunctionName = (fn: any) => {\n  const match = `${fn}`.match(fnNameMatchRegex)\n  const name = match && match[1]\n  return name || ''\n}\n\n/**\n *\n */\nexport const getFunctionComponentName = (Component: { displayName?: string; name?: string }, fallback = 'fn') => (\n  Component.displayName\n  || Component.name\n  || getPureFunctionName(Component)\n  || fallback\n)\n\nexport const getWrappedComponentName = (outerType: { displayName?: string }, innerType: { displayName?: string; name?: string }, wrapperName: string) => {\n  const functionName = getFunctionComponentName(innerType)\n  return (\n    outerType.displayName\n    || (\n      functionName !== ''\n        ? `${wrapperName}(${functionName})`\n        : wrapperName\n    )\n  )\n}\n\n/**\n * Get the display name of a function, react component, object, or string\n * @example getDisplayName('hello') => 'hello'\n * @example getDisplayName(null, 'N/A') => 'N/A'\n * @example getDisplayName(getCount) => 'getCount'\n * @example getDisplayName(class MyComp {displayName = 'My'}) => 'My'\n * @example\n * MyComp = () => {...};\n * MyComp.displayName = 'MyComp'\nMyComp.aglyn = true;\n * MyComp = forwardRef(MyComp)\n * getDisplayName(MyComp) => 'My'\n */\nexport function getDisplayName(fn: any, fallback = 'Component'): string {\n  if (fn == null) {\n    return fallback\n  }\n\n  if (typeof fn === 'string') {\n    return fn\n  }\n\n  if (typeof fn === 'function') {\n    return getFunctionComponentName(fn, fallback)\n  }\n\n  if (typeof fn === 'object') {\n    switch (fn.$$typeof) {\n\n      case Symbol.for('react.forward_ref') || 0xead0:\n        return getWrappedComponentName(fn, fn.render, 'ForwardRef')\n\n      default:\n        return fallback\n    }\n  }\n\n  return fallback\n}\n\nexport default getDisplayName\n"],"names":["fnNameMatchRegex","getPureFunctionName","fn","match","name","getFunctionComponentName","Component","fallback","displayName","getWrappedComponentName","outerType","innerType","wrapperName","functionName","getDisplayName","$$typeof","Symbol","for","render"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,kHAAkH;AAClH,OAAO,MAAMA,mBAAmB,oDAAmD;AACnF,OAAO,MAAMC,sBAAsB,CAACC;IAClC,MAAMC,QAAQ,GAAGD,IAAI,CAACC,KAAK,CAACH;IAC5B,MAAMI,OAAOD,SAASA,KAAK,CAAC,EAAE;IAC9B,OAAOC,QAAQ;AACjB,EAAC;AAED;;CAEC,GACD,OAAO,MAAMC,2BAA2B,CAACC,WAAoDC,WAAW,IAAI,GAC1GD,UAAUE,WAAW,IAClBF,UAAUF,IAAI,IACdH,oBAAoBK,cACpBC,SACJ;AAED,OAAO,MAAME,0BAA0B,CAACC,WAAqCC,WAAoDC;IAC/H,MAAMC,eAAeR,yBAAyBM;IAC9C,OACED,UAAUF,WAAW,IAEnBK,CAAAA,iBAAiB,KACb,GAAGD,YAAY,CAAC,EAAEC,aAAa,CAAC,CAAC,GACjCD,WAAU;AAGpB,EAAC;AAED;;;;;;;;;;;;CAYC,GACD,OAAO,SAASE,eAAeZ,EAAO,EAAEK,WAAW,WAAW;IAC5D,IAAIL,MAAM,MAAM;QACd,OAAOK;IACT;IAEA,IAAI,OAAOL,OAAO,UAAU;QAC1B,OAAOA;IACT;IAEA,IAAI,OAAOA,OAAO,YAAY;QAC5B,OAAOG,yBAAyBH,IAAIK;IACtC;IAEA,IAAI,OAAOL,OAAO,UAAU;QAC1B,OAAQA,GAAGa,QAAQ;YAEjB,KAAKC,OAAOC,GAAG,CAAC,wBAAwB;gBACtC,OAAOR,wBAAwBP,IAAIA,GAAGgB,MAAM,EAAE;YAEhD;gBACE,OAAOX;QACX;IACF;IAEA,OAAOA;AACT;AAEA,eAAeO,eAAc"}

package/src/lib/get-property.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Get safe property
+ *
+ * @see objectGetDeepProperty
+ * @see objectSetDeepProperty
+ *
+ * @export
+ * @template T
+ * @template K
+ * @param {T} obj
+ * @param {K} key
+ * @returns {T[K]}
+ */
+export declare function getProperty<T, K extends keyof T>(obj: T, key: K): T[K] | undefined;

package/src/lib/get-property.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _hasOwnProperty, _isObj } from "./guards/index.js";
+/**
+ * Get safe property
+ *
+ * @see objectGetDeepProperty
+ * @see objectSetDeepProperty
+ *
+ * @export
+ * @template T
+ * @template K
+ * @param {T} obj
+ * @param {K} key
+ * @returns {T[K]}
+ */ export function getProperty(obj, key) {
+    if (!_isObj(obj) || !_hasOwnProperty(key, obj)) {
+        return undefined;
+    }
+    return obj[key];
+}
+
+//# sourceMappingURL=get-property.js.map

package/src/lib/get-property.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/get-property.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { _hasOwnProperty, _isObj } from './guards'\n\n\n/**\n * Get safe property\n *\n * @see objectGetDeepProperty\n * @see objectSetDeepProperty\n *\n * @export\n * @template T\n * @template K\n * @param {T} obj\n * @param {K} key\n * @returns {T[K]}\n */\nexport function getProperty<T, K extends keyof T>(\n  obj: T,\n  key: K,\n): T[K] | undefined {\n  if (!_isObj(obj) || !_hasOwnProperty(key, obj)) {\n    return undefined\n  }\n  return obj[key]\n}\n"],"names":["_hasOwnProperty","_isObj","getProperty","obj","key","undefined"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,eAAe,EAAEC,MAAM,QAAQ,oBAAU;AAGlD;;;;;;;;;;;;CAYC,GACD,OAAO,SAASC,YACdC,GAAM,EACNC,GAAM;IAEN,IAAI,CAACH,OAAOE,QAAQ,CAACH,gBAAgBI,KAAKD,MAAM;QAC9C,OAAOE;IACT;IACA,OAAOF,GAAG,CAACC,IAAI;AACjB"}

package/src/lib/get-static-field.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Return a static property of the
+ * @param {keyof any} field
+ * @param thisArg
+ * @returns {any}
+ */
+export declare function getStaticField<T>(field: keyof any, thisArg: T): any;

package/src/lib/get-static-field.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Return a static property of the
+ * @param {keyof any} field
+ * @param thisArg
+ * @returns {any}
+ */ export function getStaticField(field, thisArg) {
+    return Object.getPrototypeOf(thisArg).constructor[field];
+}
+
+//# sourceMappingURL=get-static-field.js.map

package/src/lib/get-static-field.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/get-static-field.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2021 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Return a static property of the\n * @param {keyof any} field\n * @param thisArg\n * @returns {any}\n */\nexport function getStaticField<T>(field: keyof any, thisArg: T): any {\n  return Object.getPrototypeOf(thisArg).constructor[field]\n}\n"],"names":["getStaticField","field","thisArg","Object","getPrototypeOf"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;CAKC,GACD,OAAO,SAASA,eAAkBC,KAAgB,EAAEC,OAAU;IAC5D,OAAOC,OAAOC,cAAc,CAACF,SAAS,WAAW,CAACD,MAAM;AAC1D"}