@marktoflow/core 2.0.0-alpha.13 → 2.0.0-alpha.15

package/dist/expression-helpers.d.ts

@@ -0,0 +1,309 @@
+/**
+ * Expression Helper Library for marktoflow
+ *
+ * Provides pipeline-style filters for template expressions:
+ * {{ value | filter1 | filter2(arg) | filter3 }}
+ *
+ * Categories:
+ * - String helpers: split, join, trim, upper, lower, slugify, prefix, suffix
+ * - Array helpers: first, last, nth, map, filter, unique, count, sum
+ * - Object helpers: path, keys, values, merge, pick, omit
+ * - Date helpers: now, format_date, add_days, subtract_days
+ * - Logic helpers: default, or, and, not
+ * - Validation helpers: is_array, is_object, is_empty, is_null
+ */
+export type HelperFunction = (value: unknown, ...args: unknown[]) => unknown;
+export interface HelperRegistry {
+    [name: string]: HelperFunction;
+}
+/**
+ * Split string by delimiter
+ * Usage: {{ "a,b,c" | split(',') }} → ['a', 'b', 'c']
+ */
+export declare function split(value: unknown, delimiter?: string): string[];
+/**
+ * Join array elements
+ * Usage: {{ ['a', 'b', 'c'] | join(', ') }} → "a, b, c"
+ */
+export declare function join(value: unknown, separator?: string): string;
+/**
+ * Trim whitespace
+ * Usage: {{ "  hello  " | trim }} → "hello"
+ */
+export declare function trim(value: unknown): string;
+/**
+ * Convert to uppercase
+ * Usage: {{ "hello" | upper }} → "HELLO"
+ */
+export declare function upper(value: unknown): string;
+/**
+ * Convert to lowercase
+ * Usage: {{ "HELLO" | lower }} → "hello"
+ */
+export declare function lower(value: unknown): string;
+/**
+ * Convert to title case
+ * Usage: {{ "hello world" | title }} → "Hello World"
+ */
+export declare function title(value: unknown): string;
+/**
+ * Capitalize first letter
+ * Usage: {{ "hello" | capitalize }} → "Hello"
+ */
+export declare function capitalize(value: unknown): string;
+/**
+ * Convert to URL-friendly slug
+ * Usage: {{ "Hello World!" | slugify }} → "hello-world"
+ */
+export declare function slugify(value: unknown): string;
+/**
+ * Add prefix to string
+ * Usage: {{ "hello" | prefix('@') }} → "@hello"
+ */
+export declare function prefix(value: unknown, prefixStr: string): string;
+/**
+ * Add suffix to string
+ * Usage: {{ "hello" | suffix('!') }} → "hello!"
+ */
+export declare function suffix(value: unknown, suffixStr: string): string;
+/**
+ * Replace all occurrences
+ * Usage: {{ "hello world" | replace('world', 'there') }} → "hello there"
+ */
+export declare function replace(value: unknown, search: string, replaceWith: string): string;
+/**
+ * Truncate string to length
+ * Usage: {{ "hello world" | truncate(5) }} → "hello..."
+ */
+export declare function truncate(value: unknown, length: number, ellipsis?: string): string;
+/**
+ * Extract substring
+ * Usage: {{ "hello world" | substring(0, 5) }} → "hello"
+ */
+export declare function substring(value: unknown, start: number, end?: number): string;
+/**
+ * Check if string/array contains value
+ * Usage: {{ "hello world" | contains('world') }} → true
+ */
+export declare function contains(value: unknown, search: unknown): boolean;
+/**
+ * Get first element
+ * Usage: {{ [1, 2, 3] | first }} → 1
+ */
+export declare function first(value: unknown): unknown;
+/**
+ * Get last element
+ * Usage: {{ [1, 2, 3] | last }} → 3
+ */
+export declare function last(value: unknown): unknown;
+/**
+ * Get nth element (0-indexed)
+ * Usage: {{ [1, 2, 3] | nth(1) }} → 2
+ */
+export declare function nth(value: unknown, index: number): unknown;
+/**
+ * Get array length or object property count
+ * Usage: {{ [1, 2, 3] | count }} → 3
+ */
+export declare function count(value: unknown): number;
+/**
+ * Sum array of numbers
+ * Usage: {{ [1, 2, 3] | sum }} → 6
+ */
+export declare function sum(value: unknown): number;
+/**
+ * Get unique values
+ * Usage: {{ [1, 2, 2, 3] | unique }} → [1, 2, 3]
+ */
+export declare function unique(value: unknown): unknown[];
+/**
+ * Flatten array one level
+ * Usage: {{ [[1, 2], [3, 4]] | flatten }} → [1, 2, 3, 4]
+ */
+export declare function flatten(value: unknown): unknown[];
+/**
+ * Reverse array
+ * Usage: {{ [1, 2, 3] | reverse }} → [3, 2, 1]
+ */
+export declare function reverse(value: unknown): unknown[];
+/**
+ * Sort array
+ * Usage: {{ [3, 1, 2] | sort }} → [1, 2, 3]
+ * Usage: {{ [3, 1, 2] | sort(true) }} → [3, 2, 1]
+ */
+export declare function sort(value: unknown, reverse?: boolean): unknown[];
+/**
+ * Get array slice
+ * Usage: {{ [1, 2, 3, 4, 5] | slice(1, 3) }} → [2, 3]
+ */
+export declare function slice(value: unknown, start: number, end?: number): unknown[];
+/**
+ * Get value at path
+ * Usage: {{ obj | path('user.name') }} → obj.user.name
+ */
+export declare function path(value: unknown, pathStr: string): unknown;
+/**
+ * Get object keys
+ * Usage: {{ {a: 1, b: 2} | keys }} → ['a', 'b']
+ */
+export declare function keys(value: unknown): string[];
+/**
+ * Get object values
+ * Usage: {{ {a: 1, b: 2} | values }} → [1, 2]
+ */
+export declare function values(value: unknown): unknown[];
+/**
+ * Get object entries (key-value pairs)
+ * Usage: {{ {a: 1, b: 2} | entries }} → [['a', 1], ['b', 2]]
+ */
+export declare function entries(value: unknown): [string, unknown][];
+/**
+ * Pick specific keys from object
+ * Usage: {{ {a: 1, b: 2, c: 3} | pick('a', 'c') }} → {a: 1, c: 3}
+ */
+export declare function pick(value: unknown, ...keysToPick: string[]): Record<string, unknown>;
+/**
+ * Omit specific keys from object
+ * Usage: {{ {a: 1, b: 2, c: 3} | omit('b') }} → {a: 1, c: 3}
+ */
+export declare function omit(value: unknown, ...keysToOmit: string[]): Record<string, unknown>;
+/**
+ * Merge objects
+ * Usage: {{ {a: 1} | merge({b: 2}) }} → {a: 1, b: 2}
+ */
+export declare function merge(value: unknown, ...objects: unknown[]): Record<string, unknown>;
+/**
+ * Get current timestamp
+ * Usage: {{ now() }} → 1706745600000
+ */
+export declare function now(): number;
+/**
+ * Format date
+ * Usage: {{ timestamp | format_date('YYYY-MM-DD') }} → "2025-01-31"
+ */
+export declare function format_date(value: unknown, format?: string): string;
+/**
+ * Add days to date
+ * Usage: {{ timestamp | add_days(7) }} → timestamp + 7 days
+ */
+export declare function add_days(value: unknown, days: number): number;
+/**
+ * Subtract days from date
+ * Usage: {{ timestamp | subtract_days(7) }} → timestamp - 7 days
+ */
+export declare function subtract_days(value: unknown, days: number): number;
+/**
+ * Get date difference in days (date1 - date2)
+ * Usage: {{ date1 | diff_days(date2) }} → number of days
+ */
+export declare function diff_days(value: unknown, compareDate: unknown): number;
+/**
+ * Return default value if input is null/undefined
+ * Usage: {{ null | default('N/A') }} → "N/A"
+ */
+export declare function defaultValue(value: unknown, defaultVal: unknown): unknown;
+/**
+ * Return first truthy value
+ * Usage: {{ null | or('fallback') }} → "fallback"
+ */
+export declare function or(value: unknown, ...alternatives: unknown[]): unknown;
+/**
+ * Check if all values are truthy
+ * Usage: {{ true | and(1, 'value') }} → true
+ */
+export declare function and(value: unknown, ...values: unknown[]): boolean;
+/**
+ * Negate boolean value
+ * Usage: {{ true | not }} → false
+ */
+export declare function not(value: unknown): boolean;
+/**
+ * Ternary operator
+ * Usage: {{ condition | ternary('yes', 'no') }}
+ */
+export declare function ternary(condition: unknown, trueVal: unknown, falseVal: unknown): unknown;
+/**
+ * Check if value is array
+ * Usage: {{ value | is_array }} → true/false
+ */
+export declare function is_array(value: unknown): boolean;
+/**
+ * Check if value is object
+ * Usage: {{ value | is_object }} → true/false
+ */
+export declare function is_object(value: unknown): boolean;
+/**
+ * Check if value is string
+ * Usage: {{ value | is_string }} → true/false
+ */
+export declare function is_string(value: unknown): boolean;
+/**
+ * Check if value is number
+ * Usage: {{ value | is_number }} → true/false
+ */
+export declare function is_number(value: unknown): boolean;
+/**
+ * Check if value is empty
+ * Usage: {{ value | is_empty }} → true/false
+ */
+export declare function is_empty(value: unknown): boolean;
+/**
+ * Check if value is null
+ * Usage: {{ value | is_null }} → true/false
+ */
+export declare function is_null(value: unknown): boolean;
+/**
+ * Parse JSON string
+ * Usage: {{ '{"a":1}' | parse_json }} → {a: 1}
+ */
+export declare function parse_json(value: unknown): unknown;
+/**
+ * Stringify to JSON
+ * Usage: {{ {a: 1} | to_json }} → '{"a":1}'
+ */
+export declare function to_json(value: unknown, pretty?: boolean): string;
+/**
+ * Absolute value
+ * Usage: {{ -5 | abs }} → 5
+ */
+export declare function abs(value: unknown): number;
+/**
+ * Round to nearest integer
+ * Usage: {{ 3.7 | round }} → 4
+ */
+export declare function round(value: unknown, decimals?: number): number;
+/**
+ * Round down
+ * Usage: {{ 3.7 | floor }} → 3
+ */
+export declare function floor(value: unknown): number;
+/**
+ * Round up
+ * Usage: {{ 3.1 | ceil }} → 4
+ */
+export declare function ceil(value: unknown): number;
+/**
+ * Get minimum value
+ * Usage: {{ [1, 2, 3] | min }} → 1
+ * Usage: {{ 5 | min(3) }} → 3
+ */
+export declare function min(value: unknown, ...values: unknown[]): number;
+/**
+ * Get maximum value
+ * Usage: {{ [1, 2, 3] | max }} → 3
+ * Usage: {{ 3 | max(5) }} → 5
+ */
+export declare function max(value: unknown, ...values: unknown[]): number;
+/**
+ * Global registry of all helper functions
+ */
+export declare const HELPER_REGISTRY: HelperRegistry;
+/**
+ * Apply a helper function to a value
+ */
+export declare function applyHelper(helperName: string, value: unknown, args: unknown[]): unknown;
+/**
+ * Check if a helper exists
+ */
+export declare function hasHelper(helperName: string): boolean;
+//# sourceMappingURL=expression-helpers.d.ts.map

package/dist/expression-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-helpers.d.ts","sourceRoot":"","sources":["../src/expression-helpers.ts"],"names":[],"mappings":"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"}