@jarenjs/json 0.9.2 → 0.34.0

package/dist/types/jslt/packs/finance.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @file The finance pack — parameterized aggregators over a sequence of
+ * numbers, wrapping the pure functions of `@jarenjs/core/finance`. Each
+ * `agg` entry declares which operands are folded sequences (`seq`) and
+ * which are scalars; the registry gathers the `seq` operands into arrays
+ * before the call (the fold contract). Whole-series functions (`irr`,
+ * `npv`, moving averages) are `pushable: false` — they run in the engine
+ * or the db residual, never as an index-eligible SQLite scalar UDF.
+ */
+export declare const financePack: {
+    name: string;
+    entries: {
+        $npv: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $irr: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $mirr: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $fv: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $pv: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $pmt: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $cagr: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $sma: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $ema: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $wma: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $rsi: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $roc: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $volatility: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $sharpe: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $maxDrawdown: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+    };
+};

package/dist/types/jslt/packs/index.d.ts

@@ -0,0 +1,310 @@
+/**
+ * @file The built-in operator packs, plain data wrapping `@jarenjs/core`.
+ * A caller composes them into a registry: `createJsltRegistry().use(
+ * mathPack).use(financePack)`. `allPacks` is the convenience array for
+ * "register everything".
+ */
+export { mathPack } from './math.js';
+export { financePack } from './finance.js';
+export { statsPack } from './stats.js';
+/** Every built-in pack, in a stable order. */
+export declare const allPacks: readonly ({
+    name: string;
+    entries: {
+        $abs: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sign: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sqrt: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $cbrt: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $pow: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $hypot: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $exp: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $expm1: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $log: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $log2: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $log10: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sin: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $cos: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $tan: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $asin: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $acos: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $atan: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $atan2: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sinh: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $cosh: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $tanh: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+    };
+} | {
+    name: string;
+    entries: {
+        $npv: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $irr: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $mirr: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $fv: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $pv: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $pmt: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $cagr: {
+            kind: string;
+            signature: any[];
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $sma: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $ema: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $wma: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $rsi: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $roc: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $volatility: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $sharpe: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $maxDrawdown: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+    };
+} | {
+    name: string;
+    entries: {
+        $mean: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $median: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $variance: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $stddev: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $percentile: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+    };
+})[];

package/dist/types/jslt/packs/math.d.ts

@@ -0,0 +1,159 @@
+/**
+ * @file The math pack — scalar `$`-operators the core query vocabulary
+ * lacks, wrapping the pure f64 functions of `@jarenjs/core/math`. Every
+ * entry is `kind: 'op'` (scalar operands, scalar result). `pushable:
+ * 'scalar'` marks the ones Ring 3 MAY register as a SQLite UDF; it is
+ * ignored in Rings 1–2.
+ */
+export declare const mathPack: {
+    name: string;
+    entries: {
+        $abs: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sign: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sqrt: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $cbrt: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $pow: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $hypot: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $exp: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $expm1: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $log: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $log2: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $log10: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sin: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $cos: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $tan: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $asin: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $acos: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $atan: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $atan2: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $sinh: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $cosh: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+        $tanh: {
+            kind: string;
+            signature: string[];
+            result: string;
+            fn: any;
+            pushable: string;
+        };
+    };
+};

package/dist/types/jslt/packs/stats.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file The statistics pack — aggregators core does not ship as
+ * operators. `sum`/`min`/`max`/`avg`/`count` are ALREADY core query
+ * operators and are NOT re-registered here; this pack adds the summaries
+ * they don't cover. The helpers are small pure functions defined in this
+ * file (their natural home — core carries no statistics module), each a
+ * deterministic function of its array argument.
+ */
+export declare const statsPack: {
+    name: string;
+    entries: {
+        $mean: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $median: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $variance: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $stddev: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+        $percentile: {
+            kind: string;
+            signature: any;
+            result: string;
+            fn: any;
+            pushable: boolean;
+        };
+    };
+};

package/dist/types/jslt/registry.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file The JSLT operator/aggregator registry (Ring 1): the
+ * `@jarenjs/formats` + `JarenValidator.addFormats` experience for the
+ * query/JSLT vocabulary. A caller composes packs of pure functions
+ * (`@jarenjs/core` math, finance, statistics) into a registry and gets
+ * a compiler bound to them — the operators then work in JSLT, in the
+ * query engine, and in linq-over-memory (which compiles to query
+ * documents).
+ *
+ * The mechanism is the engine's existing `options.extensions` seam (the
+ * same one the JSLT layer uses internally for `$apply`) plus
+ * `options.functions` (the `$call` registry). This file only TRANSLATES
+ * plain-data pack entries into those two shapes and holds them in an
+ * immutable-by-copy builder — so a pack never imports the operator ABI,
+ * exactly the decoupling `@jarenjs/formats` has from `@jarenjs/validate`.
+ *
+ * Entry kinds: `op` (scalar `$`-operator over scalar
+ * operands), `agg` (an operator whose declared `seq` operands are folded
+ * to arrays before the call — the generalization of core `$sum`'s fold),
+ * and `fn` (a bare `$call` function, the low-level escape). The published
+ * closed vocabulary is unchanged: without a registry a document using a
+ * pack operator fails `JQ0002` exactly as before.
+ */
+/**
+ * Build an immutable JSLT operator registry. `.use(pack)` returns a NEW
+ * registry with the pack merged (a value, not a mutable singleton, so
+ * the functional spirit of the compilers is preserved). A name that
+ * collides with the core vocabulary, or with an already-registered name,
+ * throws a `TypeError` at `.use()` time — a host programming error, never
+ * a `JQ` document error.
+ * @param {{ extensions: Record<string, any>, functions: Record<string, Function>,
+ *   meta: Record<string, any>, packs: string[] }} [state]
+ */
+export declare function createJsltRegistry(state?: {
+    extensions: Record<string, any>;
+    functions: Record<string, Function>;
+    meta: Record<string, any>;
+    packs: string[];
+}): Readonly<{
+    use: (pack: any) => Readonly</*elided*/ any>;
+    /** Every registered operator/function name (for docs, AI, errors). */
+    names: () => string[];
+    /** The raw `{ extensions, functions }` for a manual compile call. */
+    toOptions: () => {
+        extensions: {
+            [x: string]: any;
+        };
+        functions: {
+            [x: string]: Function;
+        };
+    };
+    /** The SQL-pushable subset, as `{ name -> meta }` (consumed by the db
+     * in Rings 2–3; here it is just the data). */
+    forSql: () => {
+        [k: string]: any;
+    };
+    /** The full registration metadata (Rings 2–3, tooling). */
+    describe: () => {
+        [x: string]: any;
+    };
+    /** Compile a JSLT stylesheet bound to this registry. */
+    compile: (stylesheet: any, opts: any) => Function;
+    /** Compile a bare query document bound to this registry (linq-over-memory). */
+    compileQuery: (document: any, opts: any) => import("../query/index.js").CompiledJsonQuery;
+}>;