pacc 9.2.5 → 9.2.7

package/README.md

@@ -24,6 +24,43 @@ const result = expand("${a + 1}",{ root: { a: 2 }});
 
 ```
 
+# Benchmark
+
+benchmark                                     avg (min … max) p75 / p99    (min … top 1%)
+
+***
+
+"\[n<5].l"                                        1.17 µs/iter   1.67 µs █
+(833.64 ns … 2.47 µs)   2.42 µs █
+(281.78  b …   3.28 kb)   3.01 kb █▇▂▁▃▂▁▁▁▁▁▃▂▄▄▂▂▁▁▂▁
+4.72 ipc (  2.55% stalls)  98.55% L1 data cache
+3.75k cycles  17.68k instructions  39.84% retired LD/ST (  7.04k)
+
+parse a.b.c.d.e.f.g.h.i.j.k.l.m.n                2.96 µs/iter   3.25 µs ▂█▂             ▅
+(2.60 µs … 3.44 µs)   3.41 µs ███▅▅          ▅█▂▂▂▂
+(  6.10 kb …   6.11 kb)   6.10 kb █████▄▁▁▁▁▁▁▄▄▁██████
+5.09 ipc (  2.02% stalls)  99.10% L1 data cache
+9.40k cycles  47.87k instructions  40.50% retired LD/ST ( 19.38k)
+
+parseOnly a.b.c.d.e.f.g.h.i.j.k.l.m.n            2.51 µs/iter   2.85 µs █
+(2.18 µs … 3.36 µs)   3.35 µs █▆
+(  4.54 kb …   5.43 kb)   5.41 kb ██▄▄▂▁▁▁▁▃▂█▇█▂▁▂▁▂▁▂
+5.12 ipc (  2.18% stalls)  98.98% L1 data cache
+8.05k cycles  41.20k instructions  40.73% retired LD/ST ( 16.78k)
+
+tokens a.b.c.d.e.f.g.h.i.j.k.l.m.n               1.66 µs/iter   1.68 µs  ▆ █▄   ▃
+(1.61 µs … 1.75 µs)   1.74 µs ▅█▄██▄  █▂     ▂▅
+(  4.41 kb …   4.42 kb)   4.41 kb ██████▅▁██▃▅▃▆▆██▃▃▁▆
+5.67 ipc (  2.53% stalls)  99.12% L1 data cache
+5.32k cycles  30.18k instructions  40.68% retired LD/ST ( 12.27k)
+
+tokens "abc" "
+" "abcdefghijklmnopqrstuvwxyz"   1.23 µs/iter   1.12 µs █
+(1.02 µs … 2.23 µs)   1.85 µs █▆
+(  2.52 kb …   4.17 kb)   3.43 kb ███▁▁▁▁▁▁▁▁▁▁▁▁▁▂▂▇▄▃
+6.02 ipc (  2.26% stalls)  99.24% L1 data cache
+3.94k cycles  23.72k instructions  39.67% retired LD/ST (  9.41k)
+
 # API
 
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->

package/benchmark/first.mjs

@@ -31,18 +31,14 @@ const root2 = {
 
 bench('"[n<5].l"', () => parse("[n<5].l", { root }));
 
-
 const expression = "a.b.c.d.e.f.g.h.i.j.k.l.m.n";
 
-bench('"a.b.c.d.e.f.g.h.i.j.k.l.m.n"', () =>
-  parse(expression, { root: root2 })
-);
+bench(`parse ${expression}`, () => parse(expression, { root: root2 }));
+bench(`parseOnly ${expression}`, () => parseOnly(expression, {}));
+bench(`tokens ${expression}`, () => Array.from(tokens(expression, {})));
+
+const expression2 = '"abc" "\t\n" "abcdefghijklmnopqrstuvwxyz"';
 
-bench('parseOnly "a.b.c.d.e.f.g.h.i.j.k.l.m.n"', () =>
-  parseOnly(expression, { })
-);
-bench('tokens "a.b.c.d.e.f.g.h.i.j.k.l.m.n"', () =>
-  Array.from(tokens(expression, { }))
-);
+bench(`tokens ${expression2}`, () => Array.from(tokens(expression2, {})));
 
 await run();

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "pacc",
-  "version": "9.2.5",
+  "version": "9.2.7",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "packageManager": "npm@11.10.0+sha512.8bc844e37892200305b98562f13c6c10849d10b3387c8cdaeb4d1a2e32746a79063cba9dd284cf28c26a01c3bf4169b7d3b31b4a5586cc970d6749463108073c",
+  "packageManager": "npm@11.13.0",
   "types": "./types/module.d.mts",
   "exports": {
     ".": {
@@ -29,7 +29,6 @@
   ],
   "license": "0BSD",
   "scripts": {
-    "benchmark": "node benchmark/*.mjs",
     "prepare": "node --run prepare:typescript",
     "prepare:typescript": "tsc --allowJs --declaration --emitDeclarationOnly --declarationDir types --resolveJsonModule --target esnext -m esnext --module nodenext --moduleResolution nodenext --rootDir src ./src**/*.mjs",
     "test": "node --run test:browser-ava && node --run test:ava",
@@ -39,20 +38,21 @@
     "docs": "documentation readme --section=API ./src**/*.mjs",
     "lint": "node --run lint:docs && node --run lint:typescript",
     "lint:docs": "documentation lint ./src**/*.mjs",
-    "lint:typescript": "tsc --allowJs --checkJs --noEmit --resolveJsonModule --target esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs"
+    "lint:typescript": "tsc --allowJs --checkJs --noEmit --resolveJsonModule --target esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs",
+    "benchmark": "node benchmark/*.mjs"
   },
   "devDependencies": {
     "@mitata/counters": "^0.0.8",
-    "ava": "^6.4.1",
-    "browser-ava": "^2.3.53",
-    "c8": "^10.1.3",
+    "ava": "^8.0.0",
+    "browser-ava": "^2.3.57",
+    "c8": "^11.0.0",
     "documentation": "^14.0.3",
     "mitata": "^1.0.34",
     "semantic-release": "^25.0.3",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.3"
   },
   "engines": {
-    "node": ">=24.13.1"
+    "node": ">=24.15.0"
   },
   "repository": {
     "type": "git",

package/types/ast.d.mts

@@ -12,5 +12,5 @@ export namespace ASTNullFilter {
     export { nullFilterEval as eval };
 }
 export type AST = {
-    eval?: Function;
+    eval?: Function | undefined;
 };

package/types/attributes.d.mts

@@ -4,7 +4,7 @@
  * @param {Object} [presentDefinitions] optional merge in attributes
  * @return {Object} attributes
  */
-export function prepareAttributesDefinitions(newDefinitions: any, presentDefinitions?: any): any;
+export function prepareAttributesDefinitions(newDefinitions: Object, presentDefinitions?: Object): Object;
 /**
  * Iterate over all attributes.
  * @param {Object} definition
@@ -12,8 +12,8 @@ export function prepareAttributesDefinitions(newDefinitions: any, presentDefinit
  * @param {string[]} path
  * @return {Iterable<[string[],object]>}
  */
-export function attributeIterator(definition: any, filter?: Function, path?: string[]): Iterable<[string[], object]>;
-export function writableAttributeIterator(definition: any): Generator<[string[], any], void, any>;
+export function attributeIterator(definition: Object, filter?: Function, path?: string[]): Iterable<[string[], object]>;
+export function writableAttributeIterator(definition: any): Generator<[string[], object], void, any>;
 export function toInternal(value: any, attribute: any): any;
 export function toExternal(value: any, attribute: any): any;
 export function mandatoryAttributesPresent(object: any, attributes: any): boolean;

package/types/common-attributes.d.mts

@@ -102,23 +102,23 @@ export namespace yesno_attribute_writable {
     export let isKey: boolean;
     export let mandatory: boolean;
     export let collection: boolean;
-    export let constructor: Function;
-    let _private: boolean;
+    export let constructor: Function | undefined;
+    let _private: boolean | undefined;
     export { _private as private };
-    export let credential: boolean;
-    export let persistent: boolean;
-    export let depends: string;
-    export let description: string;
+    export let credential: boolean | undefined;
+    export let persistent: boolean | undefined;
+    export let depends: string | undefined;
+    export let description: string | undefined;
     let _default: any;
     export { _default as default };
-    export let set: Function;
-    export let get: Function;
-    export let toInternal: Function;
-    export let toExternal: Function;
-    export let values: Set<any>;
-    export let externalName: string;
-    export let env: string[] | string;
-    export let additionalValues: object;
+    export let set: Function | undefined;
+    export let get: Function | undefined;
+    export let toInternal: Function | undefined;
+    export let toExternal: Function | undefined;
+    export let values: Set<any> | undefined;
+    export let externalName: string | undefined;
+    export let env: string | string[] | undefined;
+    export let additionalValues: object | undefined;
 }
 /**
  * @type {AttributeDefinition}
@@ -232,27 +232,27 @@ export type AttributeDefinition = {
     /**
      * (collection) constructor
      */
-    constructor?: Function;
+    constructor?: Function | undefined;
     /**
      * should the value be shown
      */
-    private?: boolean;
+    private?: boolean | undefined;
     /**
      * any type of credential
      */
-    credential?: boolean;
+    credential?: boolean | undefined;
     /**
      * should we be stored (especially critical for credentials)
      */
-    persistent?: boolean;
+    persistent?: boolean | undefined;
     /**
      * name of an attribute we depend on
      */
-    depends?: string;
+    depends?: string | undefined;
     /**
      * human readable
      */
-    description?: string;
+    description?: string | undefined;
     /**
      * the default value
      */
@@ -260,28 +260,28 @@ export type AttributeDefinition = {
     /**
      * set the value
      */
-    set?: Function;
+    set?: Function | undefined;
     /**
      * get the value can be used to calculate default values
      */
-    get?: Function;
-    toInternal?: Function;
-    toExternal?: Function;
+    get?: Function | undefined;
+    toInternal?: Function | undefined;
+    toExternal?: Function | undefined;
     /**
      * allowed values
      */
-    values?: Set<any>;
+    values?: Set<any> | undefined;
     /**
      * attribute name used by external system
      */
-    externalName?: string;
+    externalName?: string | undefined;
     /**
      * environment variable(s) used to provide the value
      */
-    env?: string[] | string;
+    env?: string | string[] | undefined;
     /**
      * other values to be set in case our attribute is set
      */
-    additionalValues?: object;
+    additionalValues?: object | undefined;
 };
 export { default_attribute as string_attribute, default_attribute_writable as string_attribute_writable, description_attribute as description_attribute_writable, default_attribute as type_attribute, default_attribute_writable as state_attribute_writable, boolean_attribute_writable_true as active_attribute, boolean_attribute as empty_attribute, secret_attribute as username_attribute, secret_attribute as password_attribute, secret_attribute as token_attribute, secret_attribute as certificate_attribute, integer_attribute as count_attribute, integer_attribute_writable as count_attribute_writable, integer_attribute as size_attribute, default_attribute_writable as body_attribute_writable };

package/types/environment.d.mts

@@ -5,4 +5,4 @@
  * @param {string} instanceIdentifier part of variable name.
  * @return {Object|undefined} undefined if no suitable environment variables have been found
  */
-export function environmentValues(env: any, attributes: any, instanceIdentifier: string): any | undefined;
+export function environmentValues(env: Object, attributes: Object, instanceIdentifier: string): Object | undefined;

package/types/expand.d.mts

@@ -10,9 +10,9 @@
  */
 export function expand(object: any, context: {
     root?: any;
-    stopClass?: Function;
-    leadIn?: string;
-    leadOut?: string;
+    stopClass?: Function | undefined;
+    leadIn?: string | undefined;
+    leadOut?: string | undefined;
 }): any | Promise<any>;
 export namespace expandContextDefault {
     let root: {};

package/types/filter.d.mts

@@ -3,4 +3,4 @@
  * @param {Object} [filterBy]
  * @returns {Function}
  */
-export function filter(filterBy?: any): Function;
+export function filter(filterBy?: Object): Function;

package/types/multiple.d.mts

@@ -5,7 +5,7 @@
  * @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 | null): void;
+export function setAttributes(object: Object, source: Object, definitions: Object, cb: Function | null): void;
 /**
  * Retrive attribute values from an object.
  * @param {Object} object attribute value source
@@ -13,7 +13,7 @@ export function setAttributes(object: any, source: any, definitions: any, cb: Fu
  * @param {Function} [filter]
  * @return {Object} values
  */
-export function getAttributes(object: any, definitions: any, filter?: Function): any;
+export function getAttributes(object: Object, definitions: Object, filter?: Function): Object;
 /**
  * Retrive attribute values from an object.
  * @param {Object} object attribute value source
@@ -21,4 +21,4 @@ export function getAttributes(object: any, definitions: any, filter?: Function):
  * @param {Function} [filter]
  * @return {Object} values
  */
-export function getAttributesJSON(object: any, definitions: any, filter?: Function): any;
+export function getAttributesJSON(object: Object, definitions: Object, filter?: Function): Object;

package/types/settergetter.d.mts

@@ -6,7 +6,7 @@
  * @param {any} value
  * @param {Object} [definition] type def
  */
-export function setAttribute(object: any, expression: string, value: any, definition?: any): void;
+export function setAttribute(object: Object, expression: string, value: any, definition?: Object): void;
 /**
  * Deliver attribute value.
  * The name may be a property path like 'a.b.c' or a[2]
@@ -15,7 +15,7 @@ export function setAttribute(object: any, expression: string, value: any, defini
  * @param {Object} [definition]
  * @returns {any} value associated with the given property name
  */
-export function getAttribute(object: any, expression: string, definition?: any): any;
+export function getAttribute(object: Object, expression: string, definition?: Object): any;
 /**
  * Deliver attribute value and operator.
  * The name may be a property path like 'a.b.c <='.
@@ -23,5 +23,5 @@ export function getAttribute(object: any, expression: string, definition?: any):
  * @param {string} expression
  * @returns {[any,Token]} value associated with the given property name
  */
-export function getAttributeAndOperator(object: any, expression: string): [any, Token];
+export function getAttributeAndOperator(object: Object, expression: string): [any, Token];
 export type Token = import("./tokens.mjs").Token;

package/types/types.d.mts

@@ -23,7 +23,7 @@ export const types: {
         name: string;
         primitive: boolean;
         toInternal: (value: any, attribute: any) => any;
-        toExternal: (value: any) => "no" | "yes";
+        toExternal: (value: any) => "no" | "yes" | undefined;
     };
     integer: {
         name: string;
@@ -39,7 +39,7 @@ export const types: {
         name: string;
         primitive: boolean;
         toInternal: (value: any) => number;
-        toExternal: (value: any) => string;
+        toExternal: (value: any) => string | undefined;
     };
     duration_ms: {
         name: string;
@@ -63,8 +63,8 @@ export const types: {
 };
 export type Type = {
     name: string;
-    primitive?: boolean;
-    toInternal?: Function;
-    toExternal?: Function;
+    primitive?: boolean | undefined;
+    toInternal?: Function | undefined;
+    toExternal?: Function | undefined;
 };
 import { parseBytes } from "./bytes.mjs";