pacc 3.4.7 → 3.5.0

package/README.md

@@ -103,7 +103,7 @@ Split property path into tokens
 
 ## setAttribute
 
-Set Object attribute.
+Set object attribute.
 The name may be a property path like 'a.b.c'.
 
 ### Parameters

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "pacc",
-  "version": "3.4.7",
+  "version": "3.5.0",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "types": "./types/attribute.d.mts",
+  "types": "./types/module.d.mts",
   "exports": {
     ".": {
-      "types": "./types/attribute.d.mts",
-      "default": "./src/attribute.mjs"
+      "types": "./types/module.d.mts",
+      "default": "./src/module.mjs"
     }
   },
   "description": "property path utils",
@@ -36,15 +36,15 @@
     "npm-pkgbuild": "^18.1.1"
   },
   "devDependencies": {
-    "ava": "^6.4.0",
+    "ava": "^6.4.1",
     "browser-ava": "^2.3.31",
     "c8": "^10.1.3",
     "documentation": "^14.0.3",
-    "semantic-release": "^24.2.5",
+    "semantic-release": "^24.2.7",
     "typescript": "^5.8.3"
   },
   "engines": {
-    "node": ">=22.16.0"
+    "node": ">=22.17.1"
   },
   "repository": {
     "type": "git",

package/src/attribute.mjs

@@ -1,19 +1,3 @@
-/**
- * @typedef {Object} AttributeDefinition
- *
- * @property {string} type
- * @property {boolean} isKey
- * @property {boolean} writable
- * @property {boolean} mandatory
- * @property {boolean} [private] should the value be shown
- * @property {string} [depends] name of an attribute we depend on
- * @property {string[]} additionalAttributes extra attributes that are present in case our attribute is set
- * @property {string} [description] human readable
- * @property {any} [default] the default value
- * @property {Function} [set] set the value
- * @property {Function} [get] get the value can be used to calculate default values
- * @property {string[]|string} [env] environment variable(s) used to provide the value
- */
 
 /**
  * @typedef {import('./tokens.mjs').Token} Token
@@ -32,11 +16,9 @@ import {
   GREATER_EQUAL,
   STAR
 } from "./tokens.mjs";
-export * from "./tokens.mjs";
-export * from "./filter.mjs";
 
 /**
- * Set Object attribute.
+ * Set object attribute.
  * The name may be a property path like 'a.b.c'.
  * @param {Object} object
  * @param {string} expression

package/src/module.mjs

@@ -0,0 +1,8 @@
+export * from "./tokens.mjs";
+export * from "./filter.mjs";
+export * from "./multiple.mjs";
+export {
+  setAttribute,
+  getAttribute,
+  getAttributeAndOperator
+} from "./attribute.mjs";

package/src/multiple.mjs

@@ -0,0 +1,55 @@
+import { setAttribute, getAttribute } from "./attribute.mjs";
+
+/**
+ * @typedef {Object} AttributeDefinition
+ *
+ * @property {string} name
+ * @property {string} type
+ * @property {boolean} isKey
+ * @property {boolean} writable
+ * @property {boolean} mandatory
+ * @property {boolean} [private] should the value be shown
+ * @property {string} [depends] name of an attribute we depend on
+ * @property {string[]} additionalAttributes extra attributes that are present in case our attribute is set
+ * @property {string} [description] human readable
+ * @property {any} [default] the default value
+ * @property {Function} [set] set the value
+ * @property {Function} [get] get the value can be used to calculate default values
+ * @property {string[]|string} [env] environment variable(s) used to provide the value
+ */
+
+/**
+ * Copies attribute values from a source object into a destination object.
+ * @param {Object} object target object to be modified
+ * @param {Object} source origin of the data to be copied
+ * @param {Object} definitions attribute definitions to be used
+ * @param {function} cb callback to be executed for each copied value
+ */
+export function setAttributes(object, source, definitions, cb) {
+  for (const [name, def] of Object.entries(definitions)) {
+    const value = getAttribute(source, name);
+    setAttribute(object, name, value);
+    if (cb) {
+      cb(def, name, value);
+    }
+  }
+}
+
+/**
+ * Retrive attribute values from an object.
+ * @param {Object} object attribute value source
+ * @param {Object} definitions
+ * @return {Object} values
+ */
+export function getAttributes(object, definitions) {
+  const result = {};
+
+  Object.keys(definitions).forEach(name => {
+    const value = getAttribute(object, name);
+    if (value !== undefined) {
+      result[name] = value;
+    }
+  });
+
+  return result;
+}

package/types/attribute.d.mts

@@ -1,5 +1,5 @@
 /**
- * Set Object attribute.
+ * Set object attribute.
  * The name may be a property path like 'a.b.c'.
  * @param {Object} object
  * @param {string} expression
@@ -22,44 +22,4 @@ export function getAttribute(object: any, expression: string): any;
  * @returns {[any,Token]} value associated with the given property name
  */
 export function getAttributeAndOperator(object: any, expression: string): [any, Token];
-export * from "./tokens.mjs";
-export * from "./filter.mjs";
-export type AttributeDefinition = {
-    type: string;
-    isKey: boolean;
-    writable: boolean;
-    mandatory: boolean;
-    /**
-     * should the value be shown
-     */
-    private?: boolean;
-    /**
-     * name of an attribute we depend on
-     */
-    depends?: string;
-    /**
-     * extra attributes that are present in case our attribute is set
-     */
-    additionalAttributes: string[];
-    /**
-     * human readable
-     */
-    description?: string;
-    /**
-     * the default value
-     */
-    default?: any;
-    /**
-     * set the value
-     */
-    set?: Function;
-    /**
-     * get the value can be used to calculate default values
-     */
-    get?: Function;
-    /**
-     * environment variable(s) used to provide the value
-     */
-    env?: string[] | string;
-};
 export type Token = import("./tokens.mjs").Token;

package/types/module.d.mts

@@ -0,0 +1,4 @@
+export * from "./tokens.mjs";
+export * from "./filter.mjs";
+export * from "./multiple.mjs";
+export { setAttribute, getAttribute, getAttributeAndOperator } from "./attribute.mjs";

package/types/multiple.d.mts

@@ -0,0 +1,71 @@
+/**
+ * @typedef {Object} AttributeDefinition
+ *
+ * @property {string} name
+ * @property {string} type
+ * @property {boolean} isKey
+ * @property {boolean} writable
+ * @property {boolean} mandatory
+ * @property {boolean} [private] should the value be shown
+ * @property {string} [depends] name of an attribute we depend on
+ * @property {string[]} additionalAttributes extra attributes that are present in case our attribute is set
+ * @property {string} [description] human readable
+ * @property {any} [default] the default value
+ * @property {Function} [set] set the value
+ * @property {Function} [get] get the value can be used to calculate default values
+ * @property {string[]|string} [env] environment variable(s) used to provide the value
+ */
+/**
+ * Copies attribute values from a source object into a destination object.
+ * @param {Object} object target object to be modified
+ * @param {Object} source origin of the data to be copied
+ * @param {Object} definitions attribute definitions to be used
+ * @param {function} cb callback to be executed for each copied value
+ */
+export function setAttributes(object: any, source: any, definitions: any, cb: Function): void;
+/**
+ * Retrive attribute values from an object.
+ * @param {Object} object attribute value source
+ * @param {Object} definitions
+ * @return {Object} values
+ */
+export function getAttributes(object: any, definitions: any): any;
+export type AttributeDefinition = {
+    name: string;
+    type: string;
+    isKey: boolean;
+    writable: boolean;
+    mandatory: boolean;
+    /**
+     * should the value be shown
+     */
+    private?: boolean;
+    /**
+     * name of an attribute we depend on
+     */
+    depends?: string;
+    /**
+     * extra attributes that are present in case our attribute is set
+     */
+    additionalAttributes: string[];
+    /**
+     * human readable
+     */
+    description?: string;
+    /**
+     * the default value
+     */
+    default?: any;
+    /**
+     * set the value
+     */
+    set?: Function;
+    /**
+     * get the value can be used to calculate default values
+     */
+    get?: Function;
+    /**
+     * environment variable(s) used to provide the value
+     */
+    env?: string[] | string;
+};