@walkeros/explorer 2.1.0 → 2.1.1

package/dist/{monaco-types-OLSF6MIE.mjs → monaco-types-KN2DINPW.mjs}

@@ -14,7 +14,7 @@ import {
   removeDestinationType,
   removeTypeLibrary,
   updateTypeLibrary
-} from "./chunk-YKT4D7MG.mjs";
+} from "./chunk-4AJX6MFW.mjs";
 export {
   addDestinationType,
   addFunctionContextTypes,
@@ -31,4 +31,4 @@ export {
   removeTypeLibrary,
   updateTypeLibrary
 };
-//# sourceMappingURL=monaco-types-OLSF6MIE.mjs.map
+//# sourceMappingURL=monaco-types-KN2DINPW.mjs.map

package/dist/styles.css

@@ -1981,6 +1981,37 @@
   margin: 0;
   cursor: pointer;
 }
+.elb-codebox-marker-badge {
+  display: flex;
+  align-items: center;
+  gap: 3px;
+  padding: 2px 6px;
+  border: none;
+  border-radius: var(--radius-button);
+  cursor: pointer;
+  font-size: calc(var(--font-size-base) - 2px);
+  font-weight: var(--font-weight-semibold);
+  font-family: var(--font-mono);
+  line-height: 1;
+  transition: all 0.15s;
+}
+.elb-codebox-marker-badge svg {
+  flex-shrink: 0;
+}
+.elb-codebox-marker-badge--error {
+  color: var(--color-alert-error-text);
+  background: var(--color-alert-error-bg);
+}
+.elb-codebox-marker-badge--error:hover {
+  background: var(--color-alert-error-border);
+}
+.elb-codebox-marker-badge--warning {
+  color: var(--color-alert-warning-text);
+  background: var(--color-alert-warning-bg);
+}
+.elb-codebox-marker-badge--warning:hover {
+  background: var(--color-alert-warning-border);
+}
 .elb-code-snippet {
   min-height: var(--height-snippet-min);
 }

package/dist/types/intellisense.d.ts

@@ -0,0 +1,31 @@
+export interface PackageInfo {
+    package: string;
+    shortName: string;
+    type: 'source' | 'destination' | 'transformer';
+    platform: 'web' | 'server';
+    description?: string;
+}
+export interface IntelliSenseContext {
+    /** Variable names and values from the flow's `variables` section */
+    variables?: Record<string, string | number | boolean>;
+    /** Definition names from the flow's `definitions` section */
+    definitions?: Record<string, unknown>;
+    /** Secret names available in the project (values are NOT included) */
+    secrets?: string[];
+    /** Step names from the current flow config, by type */
+    stepNames?: {
+        sources?: string[];
+        destinations?: string[];
+        transformers?: string[];
+    };
+    /** Contract entities and their actions */
+    contract?: Array<{
+        entity: string;
+        actions: string[];
+    }>;
+    /** Available packages for autocomplete */
+    packages?: PackageInfo[];
+    /** Current platform context (web or server) */
+    platform?: 'web' | 'server';
+}
+//# sourceMappingURL=intellisense.d.ts.map

package/dist/types/intellisense.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intellisense.d.ts","sourceRoot":"","sources":["../../src/types/intellisense.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,aAAa,CAAC;IAC/C,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAEtD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IAEF,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IAEH,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B"}

package/dist/types/intellisense.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=intellisense.js.map

package/dist/types/intellisense.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intellisense.js","sourceRoot":"","sources":["../../src/types/intellisense.ts"],"names":[],"mappings":""}

package/dist/utils/monaco-intellisense-flow-extractor.d.ts

@@ -0,0 +1,13 @@
+import type { IntelliSenseContext } from '../types/intellisense';
+/**
+ * Extract IntelliSense context from a Flow.Setup JSON string.
+ *
+ * Parses the JSON, walks setup → configs → steps, and collects
+ * all discoverable variables, definitions, step names, packages,
+ * platform, and contract entities.
+ *
+ * Returns `{}` for invalid JSON or non-Flow structures.
+ * Pure function — no side effects, no state.
+ */
+export declare function extractFlowIntelliSenseContext(json: string): Partial<IntelliSenseContext>;
+//# sourceMappingURL=monaco-intellisense-flow-extractor.d.ts.map

package/dist/utils/monaco-intellisense-flow-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-intellisense-flow-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/monaco-intellisense-flow-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,uBAAuB,CAAC;AAE9E;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CA4G9B"}

package/dist/utils/monaco-intellisense-flow-extractor.js

@@ -0,0 +1,161 @@
+/**
+ * Extract IntelliSense context from a Flow.Setup JSON string.
+ *
+ * Parses the JSON, walks setup → configs → steps, and collects
+ * all discoverable variables, definitions, step names, packages,
+ * platform, and contract entities.
+ *
+ * Returns `{}` for invalid JSON or non-Flow structures.
+ * Pure function — no side effects, no state.
+ */
+export function extractFlowIntelliSenseContext(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        return {};
+    }
+    if (!isFlowSetup(parsed))
+        return {};
+    const variables = {};
+    const definitions = {};
+    const sources = [];
+    const destinations = [];
+    const transformers = [];
+    const packages = [];
+    const contractEntities = [];
+    let platform;
+    // Setup-level
+    mergeVars(variables, parsed.variables);
+    mergeDefs(definitions, parsed.definitions);
+    extractContract(contractEntities, parsed.contract);
+    // Walk each flow config
+    for (const config of Object.values(parsed.flows)) {
+        if (!isObject(config))
+            continue;
+        // Platform detection (first match wins)
+        if (!platform) {
+            if ('web' in config)
+                platform = 'web';
+            else if ('server' in config)
+                platform = 'server';
+        }
+        // Config-level variables/definitions/contract
+        mergeVars(variables, config.variables);
+        mergeDefs(definitions, config.definitions);
+        extractContract(contractEntities, config.contract);
+        // Sources
+        if (isObject(config.sources)) {
+            for (const [name, ref] of Object.entries(config.sources)) {
+                sources.push(name);
+                if (isObject(ref)) {
+                    mergeVars(variables, ref.variables);
+                    mergeDefs(definitions, ref.definitions);
+                    if (typeof ref.package === 'string') {
+                        packages.push({
+                            package: ref.package,
+                            shortName: name,
+                            type: 'source',
+                            platform: platform || 'web',
+                        });
+                    }
+                }
+            }
+        }
+        // Destinations
+        if (isObject(config.destinations)) {
+            for (const [name, ref] of Object.entries(config.destinations)) {
+                destinations.push(name);
+                if (isObject(ref)) {
+                    mergeVars(variables, ref.variables);
+                    mergeDefs(definitions, ref.definitions);
+                    if (typeof ref.package === 'string') {
+                        packages.push({
+                            package: ref.package,
+                            shortName: name,
+                            type: 'destination',
+                            platform: platform || 'web',
+                        });
+                    }
+                }
+            }
+        }
+        // Transformers
+        if (isObject(config.transformers)) {
+            for (const [name, ref] of Object.entries(config.transformers)) {
+                transformers.push(name);
+                if (isObject(ref)) {
+                    mergeVars(variables, ref.variables);
+                    mergeDefs(definitions, ref.definitions);
+                    if (typeof ref.package === 'string') {
+                        packages.push({
+                            package: ref.package,
+                            shortName: name,
+                            type: 'transformer',
+                            platform: platform || 'web',
+                        });
+                    }
+                }
+            }
+        }
+    }
+    const result = {
+        variables,
+        definitions,
+        stepNames: { sources, destinations, transformers },
+    };
+    if (platform)
+        result.platform = platform;
+    if (packages.length > 0)
+        result.packages = packages;
+    if (contractEntities.length > 0)
+        result.contract = contractEntities;
+    return result;
+}
+// --- Helpers ---
+function isObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function isFlowSetup(v) {
+    return isObject(v) && 'version' in v && 'flows' in v && isObject(v.flows);
+}
+function isPrimitive(v) {
+    return (typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean');
+}
+function mergeVars(target, source) {
+    if (!isObject(source))
+        return;
+    for (const [k, v] of Object.entries(source)) {
+        if (isPrimitive(v))
+            target[k] = v;
+    }
+}
+function mergeDefs(target, source) {
+    if (!isObject(source))
+        return;
+    for (const [k, v] of Object.entries(source)) {
+        target[k] = v;
+    }
+}
+function extractContract(target, contract) {
+    if (!isObject(contract))
+        return;
+    for (const [key, value] of Object.entries(contract)) {
+        if (key.startsWith('$') || !isObject(value))
+            continue;
+        // Avoid duplicates when merging setup + config contracts
+        const existing = target.find((e) => e.entity === key);
+        const actions = Object.keys(value);
+        if (existing) {
+            for (const a of actions) {
+                if (!existing.actions.includes(a))
+                    existing.actions.push(a);
+            }
+        }
+        else {
+            target.push({ entity: key, actions });
+        }
+    }
+}
+//# sourceMappingURL=monaco-intellisense-flow-extractor.js.map

package/dist/utils/monaco-intellisense-flow-extractor.js.map

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

package/dist/utils/monaco-schema-contract.d.ts

@@ -0,0 +1,8 @@
+type AnySchema = Record<string, any>;
+/**
+ * Returns an enriched JSON Schema for the walkerOS Contract editor.
+ * Structure: { $tagging: number, entity: { action: JSONSchema } }
+ */
+export declare function getEnrichedContractSchema(): AnySchema;
+export {};
+//# sourceMappingURL=monaco-schema-contract.d.ts.map

package/dist/utils/monaco-schema-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-schema-contract.d.ts","sourceRoot":"","sources":["../../src/utils/monaco-schema-contract.ts"],"names":[],"mappings":"AACA,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAErC;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,SAAS,CAsErD"}

package/dist/utils/monaco-schema-contract.js

@@ -0,0 +1,73 @@
+/**
+ * Returns an enriched JSON Schema for the walkerOS Contract editor.
+ * Structure: { $tagging: number, entity: { action: JSONSchema } }
+ */
+export function getEnrichedContractSchema() {
+    return {
+        type: 'object',
+        markdownDescription: 'walkerOS Data Contract. Defines entity→action schemas for event validation.\n\n' +
+            '```json\n{\n  "$tagging": 1,\n  "page": {\n' +
+            '    "view": {\n      "type": "object",\n      "properties": {\n' +
+            '      "title": { "type": "string" }\n    }\n  }\n  }\n}\n```',
+        properties: {
+            $tagging: {
+                type: 'number',
+                markdownDescription: 'Contract version number. Increment when making breaking changes.\n\n```json\n"$tagging": 1\n```',
+            },
+        },
+        additionalProperties: {
+            type: 'object',
+            markdownDescription: 'Entity name. Contains action→schema mappings.',
+            additionalProperties: {
+                type: 'object',
+                markdownDescription: 'Action schema (JSON Schema). Defines valid event data for this entity+action.\n\n' +
+                    '```json\n{\n  "type": "object",\n  "properties": {\n' +
+                    '    "name": { "type": "string" },\n    "price": { "type": "number" }\n' +
+                    '  },\n  "required": ["name"]\n}\n```',
+                defaultSnippets: [
+                    {
+                        label: 'Object schema',
+                        description: 'Schema with typed properties',
+                        body: {
+                            type: 'object',
+                            properties: {
+                                '${1:name}': { type: '${2:string}' },
+                            },
+                        },
+                    },
+                ],
+            },
+            defaultSnippets: [
+                {
+                    label: 'Add action',
+                    description: 'Action with event data schema',
+                    body: {
+                        '${1:action}': {
+                            type: 'object',
+                            properties: {
+                                '${2:property}': { type: '${3:string}' },
+                            },
+                        },
+                    },
+                },
+            ],
+        },
+        defaultSnippets: [
+            {
+                label: 'Entity with action',
+                description: 'New entity with one action and properties',
+                body: {
+                    '${1:entity}': {
+                        '${2:action}': {
+                            type: 'object',
+                            properties: {
+                                '${3:property}': { type: '${4:string}' },
+                            },
+                        },
+                    },
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=monaco-schema-contract.js.map

package/dist/utils/monaco-schema-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-schema-contract.js","sourceRoot":"","sources":["../../src/utils/monaco-schema-contract.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,mBAAmB,EACjB,iFAAiF;YACjF,6CAA6C;YAC7C,iEAAiE;YACjE,8DAA8D;QAChE,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,mBAAmB,EACjB,iGAAiG;aACpG;SACF;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,mBAAmB,EAAE,+CAA+C;YACpE,oBAAoB,EAAE;gBACpB,IAAI,EAAE,QAAQ;gBACd,mBAAmB,EACjB,mFAAmF;oBACnF,sDAAsD;oBACtD,wEAAwE;oBACxE,sCAAsC;gBACxC,eAAe,EAAE;oBACf;wBACE,KAAK,EAAE,eAAe;wBACtB,WAAW,EAAE,8BAA8B;wBAC3C,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;6BACrC;yBACF;qBACF;iBACF;aACF;YACD,eAAe,EAAE;gBACf;oBACE,KAAK,EAAE,YAAY;oBACnB,WAAW,EAAE,+BAA+B;oBAC5C,IAAI,EAAE;wBACJ,aAAa,EAAE;4BACb,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;6BACzC;yBACF;qBACF;iBACF;aACF;SACF;QACD,eAAe,EAAE;YACf;gBACE,KAAK,EAAE,oBAAoB;gBAC3B,WAAW,EAAE,2CAA2C;gBACxD,IAAI,EAAE;oBACJ,aAAa,EAAE;wBACb,aAAa,EAAE;4BACb,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;6BACzC;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/monaco-schema-enrichment.d.ts

@@ -0,0 +1,26 @@
+export interface MonacoSchemaExtension {
+    defaultSnippets?: Array<{
+        label: string;
+        description?: string;
+        markdownDescription?: string;
+        body?: unknown;
+        bodyText?: string;
+    }>;
+    markdownDescription?: string;
+    enumDescriptions?: string[];
+    markdownEnumDescriptions?: string[];
+    deprecationMessage?: string;
+    errorMessage?: string;
+    patternErrorMessage?: string;
+    doNotSuggest?: boolean;
+    suggestSortText?: string;
+}
+type EnrichmentMap = Record<string, MonacoSchemaExtension>;
+/**
+ * Deep-merges Monaco-specific JSON Schema extensions into a base schema.
+ * Keys in the enrichment map are dot-paths (e.g., 'properties.sources').
+ * Empty string '' targets the root. Does not mutate the original.
+ */
+export declare function enrichSchema(baseSchema: Record<string, unknown>, enrichments: EnrichmentMap): Record<string, unknown>;
+export {};
+//# sourceMappingURL=monaco-schema-enrichment.d.ts.map

package/dist/utils/monaco-schema-enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-schema-enrichment.d.ts","sourceRoot":"","sources":["../../src/utils/monaco-schema-enrichment.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,aAAa,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}

package/dist/utils/monaco-schema-enrichment.js

@@ -0,0 +1,31 @@
+/**
+ * Deep-merges Monaco-specific JSON Schema extensions into a base schema.
+ * Keys in the enrichment map are dot-paths (e.g., 'properties.sources').
+ * Empty string '' targets the root. Does not mutate the original.
+ */
+export function enrichSchema(baseSchema, enrichments) {
+    const schema = JSON.parse(JSON.stringify(baseSchema));
+    for (const [path, extensions] of Object.entries(enrichments)) {
+        const target = path === '' ? schema : getNestedObject(schema, path);
+        if (target && typeof target === 'object') {
+            Object.assign(target, extensions);
+        }
+    }
+    return schema;
+}
+function getNestedObject(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current &&
+            typeof current === 'object' &&
+            key in current) {
+            current = current[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=monaco-schema-enrichment.js.map

package/dist/utils/monaco-schema-enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-schema-enrichment.js","sourceRoot":"","sources":["../../src/utils/monaco-schema-enrichment.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAmC,EACnC,WAA0B;IAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAEtD,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CACtB,GAA4B,EAC5B,IAAY;IAEZ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IACE,OAAO;YACP,OAAO,OAAO,KAAK,QAAQ;YAC3B,GAAG,IAAK,OAAmC,EAC3C,CAAC;YACD,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,OAA8C,CAAC;AACxD,CAAC"}

package/dist/utils/monaco-schema-flow-setup.d.ts

@@ -0,0 +1,10 @@
+type AnySchema = Record<string, any>;
+/**
+ * Takes the base Flow.Setup JSON Schema (from @walkeros/core z.toJSONSchema())
+ * and returns an enriched version with Monaco-specific extensions.
+ *
+ * The actual schema uses anyOf[0] at the top level.
+ */
+export declare function enrichFlowSetupSchema(baseSchema: AnySchema): AnySchema;
+export {};
+//# sourceMappingURL=monaco-schema-flow-setup.d.ts.map

package/dist/utils/monaco-schema-flow-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-schema-flow-setup.d.ts","sourceRoot":"","sources":["../../src/utils/monaco-schema-flow-setup.ts"],"names":[],"mappings":"AAGA,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAErC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CA8MtE"}

package/dist/utils/monaco-schema-flow-setup.js

@@ -0,0 +1,201 @@
+/**
+ * Takes the base Flow.Setup JSON Schema (from @walkeros/core z.toJSONSchema())
+ * and returns an enriched version with Monaco-specific extensions.
+ *
+ * The actual schema uses anyOf[0] at the top level.
+ */
+export function enrichFlowSetupSchema(baseSchema) {
+    // The schema structure is { anyOf: [{ type: 'object', properties: {...} }] }
+    // We need to enrich inside anyOf[0]
+    const schema = JSON.parse(JSON.stringify(baseSchema));
+    if (!schema.anyOf?.[0]?.properties)
+        return schema;
+    const root = schema.anyOf[0];
+    const props = root.properties;
+    const flowConfig = props.flows?.additionalProperties?.properties;
+    // Enrich version
+    if (props.version) {
+        props.version.markdownDescription =
+            'Schema version number. Must be `1` for the current format.\n\n```json\n"version": 1\n```';
+    }
+    // Enrich $schema
+    if (props.$schema) {
+        props.$schema.markdownDescription =
+            'JSON Schema URI for IDE validation.\n\n```json\n"$schema": "https://walkeros.io/schema/flow/v1.json"\n```';
+    }
+    // Enrich include
+    if (props.include) {
+        props.include.markdownDescription =
+            'Folders to include in the bundle output.\n\n```json\n"include": ["./src", "./lib"]\n```';
+    }
+    // Enrich variables
+    if (props.variables) {
+        props.variables.markdownDescription =
+            'Shared variables for `$var.name` interpolation across all flows.\n\n' +
+                '```json\n"variables": {\n  "measurementId": "G-XXXXXXXXXX",\n  "debug": false\n}\n```\n\n' +
+                'Reference in any config value: `"$var.measurementId"`';
+        props.variables.defaultSnippets = [
+            {
+                label: 'Add variable',
+                description: 'New key-value variable',
+                body: { '${1:name}': '${2:value}' },
+            },
+        ];
+    }
+    // Enrich definitions
+    if (props.definitions) {
+        props.definitions.markdownDescription =
+            'Reusable configuration fragments for `$def.name` references.\n\n' +
+                '```json\n"definitions": {\n  "gaConfig": {\n    "measurementId": "$var.trackingId"\n  }\n}\n```\n\n' +
+                'Reference in any config: `"$def.gaConfig"`';
+        props.definitions.defaultSnippets = [
+            {
+                label: 'Add definition',
+                description: 'New reusable config fragment',
+                body: { '${1:name}': { '${2:key}': '${3:value}' } },
+            },
+        ];
+    }
+    // Enrich flows with scaffolding snippets
+    if (props.flows) {
+        props.flows.markdownDescription =
+            'Flow configurations keyed by name. Each flow defines a complete event pipeline.\n\n' +
+                '```json\n"flows": {\n  "myFlow": {\n    "web": {},\n    "sources": { ... },\n    "destinations": { ... }\n  }\n}\n```';
+        props.flows.defaultSnippets = [
+            {
+                label: 'Web flow (basic)',
+                description: 'Minimal web flow with browser source',
+                body: {
+                    '${1:myFlow}': {
+                        web: {},
+                        sources: {
+                            browser: { package: '@walkeros/web-source-browser' },
+                        },
+                        destinations: {},
+                    },
+                },
+            },
+            {
+                label: 'Server flow (basic)',
+                description: 'Minimal server flow with Express source',
+                body: {
+                    '${1:myFlow}': {
+                        server: {},
+                        sources: {
+                            express: { package: '@walkeros/server-source-express' },
+                        },
+                        destinations: {},
+                    },
+                },
+            },
+            {
+                label: 'Web + GA4 flow',
+                description: 'Web flow with browser source and GA4 destination',
+                body: {
+                    '${1:myFlow}': {
+                        web: {},
+                        sources: {
+                            browser: { package: '@walkeros/web-source-browser' },
+                        },
+                        destinations: {
+                            ga4: {
+                                package: '@walkeros/web-destination-ga4',
+                                config: {
+                                    measurementId: '$var.${2:measurementId}',
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        ];
+    }
+    // Enrich FlowConfig sub-properties
+    if (flowConfig) {
+        if (flowConfig.sources) {
+            flowConfig.sources.markdownDescription =
+                'Source configurations for data capture, keyed by step name.\n\n' +
+                    '```json\n"sources": {\n  "browser": { "package": "@walkeros/web-source-browser" }\n}\n```';
+            flowConfig.sources.defaultSnippets = [
+                {
+                    label: 'Add web source',
+                    description: 'Browser source for web tracking',
+                    body: {
+                        '${1:browser}': {
+                            package: '@walkeros/web-source-browser',
+                        },
+                    },
+                },
+                {
+                    label: 'Add server source',
+                    description: 'Express source for server tracking',
+                    body: {
+                        '${1:express}': {
+                            package: '@walkeros/server-source-express',
+                        },
+                    },
+                },
+            ];
+        }
+        if (flowConfig.destinations) {
+            flowConfig.destinations.markdownDescription =
+                'Destination configurations for data output, keyed by step name.\n\n' +
+                    '```json\n"destinations": {\n  "ga4": {\n    "package": "@walkeros/web-destination-ga4",\n    "config": { "measurementId": "$var.trackingId" }\n  }\n}\n```';
+            flowConfig.destinations.defaultSnippets = [
+                {
+                    label: 'Add GA4 destination',
+                    description: 'Google Analytics 4 destination',
+                    body: {
+                        '${1:ga4}': {
+                            package: '@walkeros/web-destination-ga4',
+                            config: {
+                                measurementId: '$var.${2:measurementId}',
+                            },
+                        },
+                    },
+                },
+                {
+                    label: 'Add custom destination',
+                    description: 'Custom destination with inline code',
+                    body: {
+                        '${1:custom}': {
+                            code: {
+                                push: '$code:(event) => { ${2:// handle event} }',
+                            },
+                        },
+                    },
+                },
+            ];
+        }
+        if (flowConfig.transformers) {
+            flowConfig.transformers.markdownDescription =
+                'Transformer configurations for event transformation, keyed by step name.\n\n' +
+                    '```json\n"transformers": {\n  "validator": {\n    "code": { "push": "$code:(event) => event" }\n  }\n}\n```';
+            flowConfig.transformers.defaultSnippets = [
+                {
+                    label: 'Add transformer',
+                    description: 'Inline transformer with code',
+                    body: {
+                        '${1:transformer}': {
+                            code: {
+                                push: '$code:(event) => { ${2:return event;} }',
+                            },
+                        },
+                    },
+                },
+            ];
+        }
+        if (flowConfig.web) {
+            flowConfig.web.markdownDescription =
+                'Web platform configuration (browser-based). Mutually exclusive with `server`.\n\n' +
+                    '```json\n"web": {\n  "windowCollector": "collector",\n  "windowElb": "elb"\n}\n```';
+        }
+        if (flowConfig.server) {
+            flowConfig.server.markdownDescription =
+                'Server platform configuration (Node.js). Mutually exclusive with `web`.\n\n' +
+                    '```json\n"server": {}\n```';
+        }
+    }
+    return schema;
+}
+//# sourceMappingURL=monaco-schema-flow-setup.js.map