@walkeros/explorer 0.3.1 → 1.0.0

package/dist/utils/mapping-path.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Pure utility functions for mapping path navigation
+ *
+ * These functions handle:
+ * - Path-based value extraction from nested objects
+ * - Immutable path-based value updates
+ * - Breadcrumb segment generation
+ * - Rule path parsing (entity action format)
+ * - Path validation and normalization
+ *
+ * All functions are pure (no side effects, no state, no UI)
+ * Designed for maximum reusability across different UI implementations
+ */
+/**
+ * Extract value from nested object using path array
+ *
+ * @example
+ * getValueAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: 'value'
+ *
+ * @example
+ * getValueAtPath({ data: {} }, ['data', 'missing'])
+ * // Returns: undefined
+ */
+export declare function getValueAtPath(obj: unknown, path: string[]): unknown;
+/**
+ * Set value in nested object at path (immutable)
+ *
+ * Creates a new object with the value updated at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * setValueAtPath({ data: { map: {} } }, ['data', 'map', 'items'], 'new')
+ * // Returns: { data: { map: { items: 'new' } } }
+ */
+export declare function setValueAtPath(obj: unknown, path: string[], value: unknown): unknown;
+/**
+ * Delete value at path (immutable)
+ *
+ * Creates a new object with the key removed at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * deleteAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: { data: { map: {} } }
+ */
+export declare function deleteAtPath(obj: unknown, path: string[]): unknown;
+/**
+ * Parse rule path into entity and action
+ *
+ * WalkerOS uses "ENTITY ACTION" format with space separator
+ *
+ * @example
+ * parseRulePath('product view')
+ * // Returns: { entity: 'product', action: 'view' }
+ *
+ * @example
+ * parseRulePath('invalid')
+ * // Returns: { entity: 'invalid', action: undefined }
+ */
+export declare function parseRulePath(rulePath: string): {
+    entity: string;
+    action: string | undefined;
+};
+/**
+ * Build rule path from entity and action
+ *
+ * @example
+ * buildRulePath('product', 'view')
+ * // Returns: 'product view'
+ */
+export declare function buildRulePath(entity: string, action: string): string;
+/**
+ * Breadcrumb segment for UI display
+ */
+export interface BreadcrumbSegment {
+    label: string;
+    path: string[];
+    nodeType?: string;
+}
+/**
+ * Build breadcrumb segments from path
+ *
+ * Converts a flat path array into human-readable breadcrumb segments
+ *
+ * @example
+ * buildBreadcrumbSegments(['product', 'view', 'data', 'map', 'items'])
+ * // Returns: [
+ * //   { label: 'Overview', path: [] },
+ * //   { label: 'product', path: ['product'] },
+ * //   { label: 'view', path: ['product', 'view'] },
+ * //   { label: 'data', path: ['product', 'view', 'data'] },
+ * //   { label: 'map', path: ['product', 'view', 'data', 'map'] },
+ * //   { label: 'items', path: ['product', 'view', 'data', 'map', 'items'] }
+ * // ]
+ */
+export declare function buildBreadcrumbSegments(path: string[]): BreadcrumbSegment[];
+/**
+ * Validate if a path is valid for a mapping rule
+ *
+ * @example
+ * isValidRulePath(['product', 'view'])
+ * // Returns: true
+ *
+ * @example
+ * isValidRulePath(['product'])
+ * // Returns: false (missing action)
+ */
+export declare function isValidRulePath(path: string[]): boolean;
+/**
+ * Get parent path
+ *
+ * @example
+ * getParentPath(['data', 'map', 'items'])
+ * // Returns: ['data', 'map']
+ *
+ * @example
+ * getParentPath(['data'])
+ * // Returns: []
+ *
+ * @example
+ * getParentPath([])
+ * // Returns: []
+ */
+export declare function getParentPath(path: string[]): string[];
+/**
+ * Check if path is ancestor of another path
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'map', 'items'])
+ * // Returns: true
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'set'])
+ * // Returns: false
+ */
+export declare function isAncestorPath(ancestorPath: string[], descendantPath: string[]): boolean;
+/**
+ * Normalize path by removing empty strings and trimming
+ *
+ * @example
+ * normalizePath(['  data  ', '', 'map', '  items'])
+ * // Returns: ['data', 'map', 'items']
+ */
+export declare function normalizePath(path: string[]): string[];
+//# sourceMappingURL=mapping-path.d.ts.map

package/dist/utils/mapping-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-path.d.ts","sourceRoot":"","sources":["../../src/utils/mapping-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAcpE;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CA6BT;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAsBlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAYA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAa3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAQvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAItD"}

package/dist/utils/mapping-path.js

@@ -0,0 +1,271 @@
+/**
+ * Pure utility functions for mapping path navigation
+ *
+ * These functions handle:
+ * - Path-based value extraction from nested objects
+ * - Immutable path-based value updates
+ * - Breadcrumb segment generation
+ * - Rule path parsing (entity action format)
+ * - Path validation and normalization
+ *
+ * All functions are pure (no side effects, no state, no UI)
+ * Designed for maximum reusability across different UI implementations
+ */
+/**
+ * Extract value from nested object using path array
+ *
+ * @example
+ * getValueAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: 'value'
+ *
+ * @example
+ * getValueAtPath({ data: {} }, ['data', 'missing'])
+ * // Returns: undefined
+ */
+export function getValueAtPath(obj, path) {
+    if (!obj || typeof obj !== 'object')
+        return undefined;
+    if (path.length === 0)
+        return obj;
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Deep clone that preserves all value types including function strings
+ *
+ * In the explorer, functions are stored as strings (e.g., fn: "(event) => event.data")
+ * so they need to be preserved during cloning operations.
+ *
+ * This implementation:
+ * - Handles primitives, arrays, objects
+ * - Preserves function strings
+ * - Handles nested structures recursively
+ * - Creates new object references (true immutability)
+ */
+function deepClone(obj) {
+    // Handle primitives and null
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    // Handle arrays
+    if (Array.isArray(obj)) {
+        return obj.map((item) => deepClone(item));
+    }
+    // Handle objects
+    const cloned = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            cloned[key] = deepClone(obj[key]);
+        }
+    }
+    return cloned;
+}
+/**
+ * Set value in nested object at path (immutable)
+ *
+ * Creates a new object with the value updated at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * setValueAtPath({ data: { map: {} } }, ['data', 'map', 'items'], 'new')
+ * // Returns: { data: { map: { items: 'new' } } }
+ */
+export function setValueAtPath(obj, path, value) {
+    if (!obj || typeof obj !== 'object') {
+        throw new Error('Cannot set value on non-object');
+    }
+    if (path.length === 0)
+        return value;
+    // Deep clone for immutability
+    const cloned = deepClone(obj);
+    let current = cloned;
+    // Navigate to parent of target
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        // Create missing intermediate objects
+        if (!current[key] || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    // Set the final value
+    const lastKey = path[path.length - 1];
+    current[lastKey] = value;
+    return cloned;
+}
+/**
+ * Delete value at path (immutable)
+ *
+ * Creates a new object with the key removed at the specified path.
+ * Does not mutate the original object.
+ *
+ * @example
+ * deleteAtPath({ data: { map: { items: 'value' } } }, ['data', 'map', 'items'])
+ * // Returns: { data: { map: {} } }
+ */
+export function deleteAtPath(obj, path) {
+    if (!obj || typeof obj !== 'object') {
+        throw new Error('Cannot delete from non-object');
+    }
+    if (path.length === 0)
+        return undefined;
+    const cloned = deepClone(obj);
+    let current = cloned;
+    // Navigate to parent
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        if (!current[key])
+            return cloned; // Path doesn't exist, return unchanged
+        current = current[key];
+    }
+    // Delete the final key
+    const lastKey = path[path.length - 1];
+    delete current[lastKey];
+    return cloned;
+}
+/**
+ * Parse rule path into entity and action
+ *
+ * WalkerOS uses "ENTITY ACTION" format with space separator
+ *
+ * @example
+ * parseRulePath('product view')
+ * // Returns: { entity: 'product', action: 'view' }
+ *
+ * @example
+ * parseRulePath('invalid')
+ * // Returns: { entity: 'invalid', action: undefined }
+ */
+export function parseRulePath(rulePath) {
+    const parts = rulePath
+        .trim()
+        .split(' ')
+        .filter((p) => p.trim());
+    if (parts.length < 2) {
+        return { entity: parts[0] || '', action: undefined };
+    }
+    const [entity, ...actionParts] = parts;
+    return { entity, action: actionParts.join(' ') };
+}
+/**
+ * Build rule path from entity and action
+ *
+ * @example
+ * buildRulePath('product', 'view')
+ * // Returns: 'product view'
+ */
+export function buildRulePath(entity, action) {
+    return `${entity} ${action}`;
+}
+/**
+ * Build breadcrumb segments from path
+ *
+ * Converts a flat path array into human-readable breadcrumb segments
+ *
+ * @example
+ * buildBreadcrumbSegments(['product', 'view', 'data', 'map', 'items'])
+ * // Returns: [
+ * //   { label: 'Overview', path: [] },
+ * //   { label: 'product', path: ['product'] },
+ * //   { label: 'view', path: ['product', 'view'] },
+ * //   { label: 'data', path: ['product', 'view', 'data'] },
+ * //   { label: 'map', path: ['product', 'view', 'data', 'map'] },
+ * //   { label: 'items', path: ['product', 'view', 'data', 'map', 'items'] }
+ * // ]
+ */
+export function buildBreadcrumbSegments(path) {
+    const segments = [{ label: 'Overview', path: [] }];
+    if (path.length === 0)
+        return segments;
+    for (let i = 0; i < path.length; i++) {
+        segments.push({
+            label: path[i],
+            path: path.slice(0, i + 1),
+        });
+    }
+    return segments;
+}
+/**
+ * Validate if a path is valid for a mapping rule
+ *
+ * @example
+ * isValidRulePath(['product', 'view'])
+ * // Returns: true
+ *
+ * @example
+ * isValidRulePath(['product'])
+ * // Returns: false (missing action)
+ */
+export function isValidRulePath(path) {
+    if (path.length < 2)
+        return false;
+    const [entity, action] = path;
+    if (!entity || !action)
+        return false;
+    if (typeof entity !== 'string' || typeof action !== 'string')
+        return false;
+    return true;
+}
+/**
+ * Get parent path
+ *
+ * @example
+ * getParentPath(['data', 'map', 'items'])
+ * // Returns: ['data', 'map']
+ *
+ * @example
+ * getParentPath(['data'])
+ * // Returns: []
+ *
+ * @example
+ * getParentPath([])
+ * // Returns: []
+ */
+export function getParentPath(path) {
+    if (path.length === 0)
+        return [];
+    return path.slice(0, -1);
+}
+/**
+ * Check if path is ancestor of another path
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'map', 'items'])
+ * // Returns: true
+ *
+ * @example
+ * isAncestorPath(['data', 'map'], ['data', 'set'])
+ * // Returns: false
+ */
+export function isAncestorPath(ancestorPath, descendantPath) {
+    // Empty path cannot be ancestor (even though technically it is)
+    if (ancestorPath.length === 0)
+        return false;
+    if (ancestorPath.length >= descendantPath.length)
+        return false;
+    for (let i = 0; i < ancestorPath.length; i++) {
+        if (ancestorPath[i] !== descendantPath[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Normalize path by removing empty strings and trimming
+ *
+ * @example
+ * normalizePath(['  data  ', '', 'map', '  items'])
+ * // Returns: ['data', 'map', 'items']
+ */
+export function normalizePath(path) {
+    return path
+        .filter((segment) => segment && segment.trim())
+        .map((s) => s.trim());
+}
+//# sourceMappingURL=mapping-path.js.map

package/dist/utils/mapping-path.js.map

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

package/dist/utils/monaco-context-types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Monaco Editor Context Type Templates
+ *
+ * Hand-crafted global namespace declarations for function contexts.
+ * These provide full TypeScript IntelliSense in Monaco Editor without
+ * requiring import statements.
+ *
+ * Extracted from @walkeros/core types and simplified for editor use.
+ */
+/**
+ * Type template for 'fn' context (transformation functions)
+ *
+ * Provides types for:
+ * - value: WalkerOS.DeepPartialEvent | unknown
+ * - mapping: Mapping.Value
+ * - options: Mapping.Options
+ */
+export declare const FN_CONTEXT_TYPES = "\n// WalkerOS Core Types\ndeclare namespace WalkerOS {\n  // Utility types\n  type DeepPartial<T> = {\n    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];\n  };\n\n  type PromiseOrValue<T> = T | Promise<T>;\n\n  // Property types\n  type PropertyType = boolean | string | number | {\n    [key: string]: Property;\n  };\n\n  type Property = PropertyType | Array<PropertyType>;\n\n  interface Properties {\n    [key: string]: Property | undefined;\n  }\n\n  interface OrderedProperties {\n    [key: string]: [Property, number] | undefined;\n  }\n\n  // Consent\n  interface Consent {\n    [name: string]: boolean;\n  }\n\n  // User\n  interface User extends Properties {\n    id?: string;\n    device?: string;\n    session?: string;\n    hash?: string;\n    address?: string;\n    email?: string;\n    phone?: string;\n    userAgent?: string;\n    browser?: string;\n    browserVersion?: string;\n    deviceType?: string;\n    language?: string;\n    country?: string;\n    region?: string;\n    city?: string;\n    zip?: string;\n    timezone?: string;\n    os?: string;\n    osVersion?: string;\n    screenSize?: string;\n    ip?: string;\n    internal?: boolean;\n  }\n\n  // Version\n  interface Version extends Properties {\n    source: string;\n    tagging: number;\n  }\n\n  // Source\n  type SourceType = 'web' | 'server' | 'app' | 'other' | string;\n\n  interface Source extends Properties {\n    type: SourceType;\n    id: string;\n    previous_id: string;\n  }\n\n  // Entity\n  type Entities = Array<Entity>;\n\n  interface Entity {\n    entity: string;\n    data: Properties;\n    nested: Entities;\n    context: OrderedProperties;\n  }\n\n  // Event\n  interface Event {\n    name: string;\n    data: Properties;\n    context: OrderedProperties;\n    globals: Properties;\n    custom: Properties;\n    user: User;\n    nested: Entities;\n    consent: Consent;\n    id: string;\n    trigger: string;\n    entity: string;\n    action: string;\n    timestamp: number;\n    timing: number;\n    group: string;\n    count: number;\n    version: Version;\n    source: Source;\n  }\n\n  type DeepPartialEvent = DeepPartial<Event>;\n}\n\n// Mapping Types\ndeclare namespace Mapping {\n  type ValueType = string | ValueConfig;\n  type Value = ValueType | Array<ValueType>;\n  type Values = Array<Value>;\n\n  interface ValueConfig {\n    condition?: Condition;\n    consent?: WalkerOS.Consent;\n    fn?: Fn;\n    key?: string;\n    loop?: Loop;\n    map?: Map;\n    set?: Value[];\n    validate?: Validate;\n    value?: WalkerOS.PropertyType;\n  }\n\n  type Loop = [Value, Value];\n\n  type Map = {\n    [key: string]: Value;\n  };\n\n  interface Options {\n    consent?: WalkerOS.Consent;\n    collector?: Collector.Instance;\n    props?: unknown;\n  }\n\n  type Condition = (\n    value: WalkerOS.DeepPartialEvent | unknown,\n    mapping?: Value,\n    collector?: Collector.Instance\n  ) => WalkerOS.PromiseOrValue<boolean>;\n\n  type Fn = (\n    value: WalkerOS.DeepPartialEvent | unknown,\n    mapping: Value,\n    options: Options\n  ) => WalkerOS.PromiseOrValue<WalkerOS.Property | unknown>;\n\n  type Validate = (value?: unknown) => WalkerOS.PromiseOrValue<boolean>;\n}\n\n// Collector Types (minimal for fn context)\ndeclare namespace Collector {\n  interface Instance {\n    push: any;\n    command: any;\n    allowed: boolean;\n    config: any;\n    consent: WalkerOS.Consent;\n    count: number;\n    custom: WalkerOS.Properties;\n    globals: WalkerOS.Properties;\n    group: string;\n    queue: any[];\n    round: number;\n    session: any;\n    timing: number;\n    user: WalkerOS.User;\n    version: string;\n    [key: string]: any;\n  }\n}\n\n// Parameter declarations for fn context\ndeclare const value: WalkerOS.DeepPartialEvent | unknown;\ndeclare const mapping: Mapping.Value;\ndeclare const options: Mapping.Options;\n";
+/**
+ * Type template for 'condition' context (conditional functions)
+ *
+ * Provides types for:
+ * - value: WalkerOS.DeepPartialEvent | unknown
+ * - mapping: Mapping.Value
+ * - collector: Collector.Instance | undefined
+ */
+export declare const CONDITION_CONTEXT_TYPES = "\n// WalkerOS Core Types\ndeclare namespace WalkerOS {\n  // Utility types\n  type DeepPartial<T> = {\n    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];\n  };\n\n  type PromiseOrValue<T> = T | Promise<T>;\n\n  // Property types\n  type PropertyType = boolean | string | number | {\n    [key: string]: Property;\n  };\n\n  type Property = PropertyType | Array<PropertyType>;\n\n  interface Properties {\n    [key: string]: Property | undefined;\n  }\n\n  interface OrderedProperties {\n    [key: string]: [Property, number] | undefined;\n  }\n\n  // Consent\n  interface Consent {\n    [name: string]: boolean;\n  }\n\n  // User\n  interface User extends Properties {\n    id?: string;\n    device?: string;\n    session?: string;\n    hash?: string;\n    address?: string;\n    email?: string;\n    phone?: string;\n    userAgent?: string;\n    browser?: string;\n    browserVersion?: string;\n    deviceType?: string;\n    language?: string;\n    country?: string;\n    region?: string;\n    city?: string;\n    zip?: string;\n    timezone?: string;\n    os?: string;\n    osVersion?: string;\n    screenSize?: string;\n    ip?: string;\n    internal?: boolean;\n  }\n\n  // Version\n  interface Version extends Properties {\n    source: string;\n    tagging: number;\n  }\n\n  // Source\n  type SourceType = 'web' | 'server' | 'app' | 'other' | string;\n\n  interface Source extends Properties {\n    type: SourceType;\n    id: string;\n    previous_id: string;\n  }\n\n  // Entity\n  type Entities = Array<Entity>;\n\n  interface Entity {\n    entity: string;\n    data: Properties;\n    nested: Entities;\n    context: OrderedProperties;\n  }\n\n  // Event\n  interface Event {\n    name: string;\n    data: Properties;\n    context: OrderedProperties;\n    globals: Properties;\n    custom: Properties;\n    user: User;\n    nested: Entities;\n    consent: Consent;\n    id: string;\n    trigger: string;\n    entity: string;\n    action: string;\n    timestamp: number;\n    timing: number;\n    group: string;\n    count: number;\n    version: Version;\n    source: Source;\n  }\n\n  type DeepPartialEvent = DeepPartial<Event>;\n}\n\n// Mapping Types\ndeclare namespace Mapping {\n  type ValueType = string | ValueConfig;\n  type Value = ValueType | Array<ValueType>;\n\n  interface ValueConfig {\n    condition?: Condition;\n    consent?: WalkerOS.Consent;\n    fn?: Fn;\n    key?: string;\n    loop?: Loop;\n    map?: Map;\n    set?: Value[];\n    validate?: Validate;\n    value?: WalkerOS.PropertyType;\n  }\n\n  type Loop = [Value, Value];\n\n  type Map = {\n    [key: string]: Value;\n  };\n\n  type Condition = (\n    value: WalkerOS.DeepPartialEvent | unknown,\n    mapping?: Value,\n    collector?: Collector.Instance\n  ) => WalkerOS.PromiseOrValue<boolean>;\n\n  type Fn = (\n    value: WalkerOS.DeepPartialEvent | unknown,\n    mapping: Value,\n    options: any\n  ) => WalkerOS.PromiseOrValue<WalkerOS.Property | unknown>;\n\n  type Validate = (value?: unknown) => WalkerOS.PromiseOrValue<boolean>;\n}\n\n// Collector Types (full interface for condition context)\ndeclare namespace Collector {\n  interface SessionData extends WalkerOS.Properties {\n    isStart: boolean;\n    storage: boolean;\n    id?: string;\n    start?: number;\n    marketing?: true;\n    updated?: number;\n    isNew?: boolean;\n    device?: string;\n    count?: number;\n    runs?: number;\n  }\n\n  interface Config {\n    run?: boolean;\n    tagging: number;\n    globalsStatic: WalkerOS.Properties;\n    sessionStatic: Partial<SessionData>;\n    verbose: boolean;\n    onError?: any;\n    onLog?: any;\n  }\n\n  interface Instance {\n    push: any;\n    command: any;\n    allowed: boolean;\n    config: Config;\n    consent: WalkerOS.Consent;\n    count: number;\n    custom: WalkerOS.Properties;\n    sources: any;\n    destinations: any;\n    globals: WalkerOS.Properties;\n    group: string;\n    hooks: any;\n    on: any;\n    queue: any[];\n    round: number;\n    session: undefined | SessionData;\n    timing: number;\n    user: WalkerOS.User;\n    version: string;\n  }\n}\n\n// Parameter declarations for condition context\ndeclare const value: WalkerOS.DeepPartialEvent | unknown;\ndeclare const mapping: Mapping.Value;\ndeclare const collector: Collector.Instance | undefined;\n";
+/**
+ * Type template for 'validate' context (validation functions)
+ *
+ * Provides types for:
+ * - value: unknown
+ */
+export declare const VALIDATE_CONTEXT_TYPES = "\n// Parameter declaration for validate context\ndeclare const value: unknown;\n";
+/**
+ * Get the type template for a specific function context
+ */
+export declare function getContextTypes(contextType: 'fn' | 'condition' | 'validate'): string;
+//# sourceMappingURL=monaco-context-types.d.ts.map

package/dist/utils/monaco-context-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-context-types.d.ts","sourceRoot":"","sources":["../../src/utils/monaco-context-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,0xHAiL5B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,wtIAoMnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,qFAGlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAWpF"}