@zthun/helpful-reflection 9.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+# MIT License
+
+Copyright © 2025 Anthony Bonta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# Helpful Functions
+
+Provides reflection decorators that halp describe metadata about a class,
+function, or field.
+
+## Installation
+
+```sh
+# NPM
+npm install @zthun/helpful-reflection
+# Yarn
+yarn add @zthun/helpful-reflection
+```

package/dist/index.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const helpfulFn = require("@zthun/helpful-fn");
+const noConflict = require("reflect-metadata/no-conflict");
+const Key = "zthunworks:tags";
+function ZTag(by) {
+  return (target, property) => {
+    if (property == null) {
+      const current = helpfulFn.firstDefined({}, noConflict.getMetadata(Key, target));
+      noConflict.defineMetadata(Key, { ...current, [by]: true }, target);
+    } else {
+      const current = helpfulFn.firstDefined({}, noConflict.getMetadata(Key, target, property));
+      noConflict.defineMetadata(Key, { ...current, [by]: true }, target, property);
+    }
+  };
+}
+function isTagged(by, target, property) {
+  if (target == null || typeof target !== "function" && typeof target !== "object") {
+    return false;
+  }
+  const tags = property ? noConflict.getMetadata(Key, target, property) : noConflict.getMetadata(Key, target);
+  return Object.prototype.hasOwnProperty.call(helpfulFn.firstDefined({}, tags), by);
+}
+exports.ZTag = ZTag;
+exports.isTagged = isTagged;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/tag/tag.ts"],"sourcesContent":["import { firstDefined } from \"@zthun/helpful-fn\";\nimport { defineMetadata, getMetadata } from \"reflect-metadata/no-conflict\";\n\nconst Key = \"zthunworks:tags\";\n\nexport function ZTag(\n  by: string,\n): MethodDecorator & ClassDecorator & PropertyDecorator {\n  return (target: any, property?: string | symbol) => {\n    if (property == null) {\n      // Class.\n      const current = firstDefined({}, getMetadata(Key, target));\n      defineMetadata(Key, { ...current, [by]: true }, target);\n    } else {\n      // Member.\n      const current = firstDefined({}, getMetadata(Key, target, property));\n      defineMetadata(Key, { ...current, [by]: true }, target, property);\n    }\n  };\n}\n\nexport function isTagged(\n  by: string,\n  target: any,\n  property?: string | symbol,\n): boolean {\n  if (\n    target == null ||\n    (typeof target !== \"function\" && typeof target !== \"object\")\n  ) {\n    return false;\n  }\n\n  const tags = property\n    ? getMetadata(Key, target, property)\n    : getMetadata(Key, target);\n\n  return Object.prototype.hasOwnProperty.call(firstDefined({}, tags), by);\n}\n"],"names":["firstDefined","getMetadata","defineMetadata"],"mappings":";;;;AAGA,MAAM,MAAM;AAEL,SAAS,KACd,IACsD;AAC/C,SAAA,CAAC,QAAa,aAA+B;AAClD,QAAI,YAAY,MAAM;AAEpB,YAAM,UAAUA,UAAAA,aAAa,CAAA,GAAIC,WAAAA,YAAY,KAAK,MAAM,CAAC;AAC1CC,iBAAA,eAAA,KAAK,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,KAAK,GAAG,MAAM;AAAA,IAAA,OACjD;AAEC,YAAA,UAAUF,UAAAA,aAAa,CAAC,GAAGC,uBAAY,KAAK,QAAQ,QAAQ,CAAC;AACpDC,gCAAA,KAAK,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,KAAA,GAAQ,QAAQ,QAAQ;AAAA,IAAA;AAAA,EAEpE;AACF;AAEgB,SAAA,SACd,IACA,QACA,UACS;AACT,MACE,UAAU,QACT,OAAO,WAAW,cAAc,OAAO,WAAW,UACnD;AACO,WAAA;AAAA,EAAA;AAGH,QAAA,OAAO,WACTD,WAAAA,YAAY,KAAK,QAAQ,QAAQ,IACjCA,WAAAA,YAAY,KAAK,MAAM;AAEpB,SAAA,OAAO,UAAU,eAAe,KAAKD,UAAAA,aAAa,CAAC,GAAG,IAAI,GAAG,EAAE;AACxE;;;"}

package/dist/index.d.mts

@@ -0,0 +1 @@
+export * from './tag/tag.js';

package/dist/index.js

@@ -0,0 +1,26 @@
+import { firstDefined } from "@zthun/helpful-fn";
+import { getMetadata, defineMetadata } from "reflect-metadata/no-conflict";
+const Key = "zthunworks:tags";
+function ZTag(by) {
+  return (target, property) => {
+    if (property == null) {
+      const current = firstDefined({}, getMetadata(Key, target));
+      defineMetadata(Key, { ...current, [by]: true }, target);
+    } else {
+      const current = firstDefined({}, getMetadata(Key, target, property));
+      defineMetadata(Key, { ...current, [by]: true }, target, property);
+    }
+  };
+}
+function isTagged(by, target, property) {
+  if (target == null || typeof target !== "function" && typeof target !== "object") {
+    return false;
+  }
+  const tags = property ? getMetadata(Key, target, property) : getMetadata(Key, target);
+  return Object.prototype.hasOwnProperty.call(firstDefined({}, tags), by);
+}
+export {
+  ZTag,
+  isTagged
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/tag/tag.ts"],"sourcesContent":["import { firstDefined } from \"@zthun/helpful-fn\";\nimport { defineMetadata, getMetadata } from \"reflect-metadata/no-conflict\";\n\nconst Key = \"zthunworks:tags\";\n\nexport function ZTag(\n  by: string,\n): MethodDecorator & ClassDecorator & PropertyDecorator {\n  return (target: any, property?: string | symbol) => {\n    if (property == null) {\n      // Class.\n      const current = firstDefined({}, getMetadata(Key, target));\n      defineMetadata(Key, { ...current, [by]: true }, target);\n    } else {\n      // Member.\n      const current = firstDefined({}, getMetadata(Key, target, property));\n      defineMetadata(Key, { ...current, [by]: true }, target, property);\n    }\n  };\n}\n\nexport function isTagged(\n  by: string,\n  target: any,\n  property?: string | symbol,\n): boolean {\n  if (\n    target == null ||\n    (typeof target !== \"function\" && typeof target !== \"object\")\n  ) {\n    return false;\n  }\n\n  const tags = property\n    ? getMetadata(Key, target, property)\n    : getMetadata(Key, target);\n\n  return Object.prototype.hasOwnProperty.call(firstDefined({}, tags), by);\n}\n"],"names":[],"mappings":";;AAGA,MAAM,MAAM;AAEL,SAAS,KACd,IACsD;AAC/C,SAAA,CAAC,QAAa,aAA+B;AAClD,QAAI,YAAY,MAAM;AAEpB,YAAM,UAAU,aAAa,CAAA,GAAI,YAAY,KAAK,MAAM,CAAC;AAC1C,qBAAA,KAAK,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,KAAK,GAAG,MAAM;AAAA,IAAA,OACjD;AAEC,YAAA,UAAU,aAAa,CAAC,GAAG,YAAY,KAAK,QAAQ,QAAQ,CAAC;AACpD,qBAAA,KAAK,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,KAAA,GAAQ,QAAQ,QAAQ;AAAA,IAAA;AAAA,EAEpE;AACF;AAEgB,SAAA,SACd,IACA,QACA,UACS;AACT,MACE,UAAU,QACT,OAAO,WAAW,cAAc,OAAO,WAAW,UACnD;AACO,WAAA;AAAA,EAAA;AAGH,QAAA,OAAO,WACT,YAAY,KAAK,QAAQ,QAAQ,IACjC,YAAY,KAAK,MAAM;AAEpB,SAAA,OAAO,UAAU,eAAe,KAAK,aAAa,CAAC,GAAG,IAAI,GAAG,EAAE;AACxE;"}

package/dist/tag/tag.d.ts

@@ -0,0 +1,2 @@
+export declare function ZTag(by: string): MethodDecorator & ClassDecorator & PropertyDecorator;
+export declare function isTagged(by: string, target: any, property?: string | symbol): boolean;

package/dist/tag/tag.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@zthun/helpful-reflection",
+  "version": "9.0.0",
+  "description": "Helpful decorators built around reflect-metadata.",
+  "author": "Anthony Bonta",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zthun/helpful",
+    "directory": "packages/helpful-reflection"
+  },
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    "types": "./dist/index.d.mts",
+    "require": "./dist/index.cjs",
+    "import": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "vite build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@zthun/helpful-fn": "^9.0.0",
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@zthun/janitor-build-config": "^19.2.0",
+    "typescript": "~5.8.3",
+    "vite": "^6.3.5",
+    "vitest": "^3.2.4"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "gitHead": "0ea541ec8e23c662fbd9e56582b259926201a128"
+}