@walkeros/explorer 0.3.1 → 1.0.0

package/dist/utils/type-detector.js

@@ -0,0 +1,241 @@
+import { isRule } from './path-analyzer';
+import { MAPPING_RULE_STRUCTURE } from '../schemas/config-structures/mapping-rule';
+/**
+ * Detect NodeType for a value at a given path
+ *
+ * Single source of truth for type detection. Uses structure + schemas.
+ *
+ * Detection priority:
+ * 1. Structure definition (explicit nodeType for properties)
+ * 2. Schema detection (enum, boolean, primitives from JSON Schema)
+ * 3. Value introspection (for complex types and fallback)
+ *
+ * @param value - The value to inspect
+ * @param path - Path array to the value
+ * @param structure - Structure definition (REQUIRED for schema-driven detection)
+ * @param schemas - Schemas bundle for this config
+ * @returns NodeType for editing
+ */
+export function detectNodeType(value, path, structure, schemas) {
+    if (path.length === 0) {
+        return structure.rootNodeType || 'entity';
+    }
+    let currentStructure = structure;
+    let propertyDef;
+    let propertyDefIndex = -1;
+    // Navigate structure to find property definition
+    for (let i = 0; i < path.length; i++) {
+        const segment = path[i];
+        const foundDef = currentStructure.properties?.[segment];
+        if (foundDef) {
+            propertyDef = foundDef;
+            propertyDefIndex = i;
+            if (foundDef.structure) {
+                currentStructure = foundDef.structure;
+            }
+        }
+        else {
+            break;
+        }
+    }
+    // Handle entity-action pattern (mapping)
+    if (propertyDef?.children === 'entity-action' && propertyDefIndex >= 0) {
+        const depth = path.length - propertyDefIndex;
+        if (depth === 1 || depth === 2)
+            return 'entity';
+        if (depth === 3 && isRule(value)) {
+            return 'rule';
+        }
+        if (depth >= 4) {
+            const rulePath = path.slice(propertyDefIndex + 3);
+            return detectNodeType(value, rulePath, MAPPING_RULE_STRUCTURE, schemas);
+        }
+    }
+    const skipExplicitNodeType = propertyDef?.children === 'entity-action' && path.length >= 3;
+    const isAtPropertyDefEnd = propertyDefIndex === path.length - 1;
+    // Priority 1: Explicit nodeType from structure (only at end of path)
+    if (propertyDef?.nodeType && !skipExplicitNodeType && isAtPropertyDefEnd) {
+        return propertyDef.nodeType;
+    }
+    // Priority 2: Schema detection
+    const schema = propertyDef && schemas
+        ? resolveSchema(path.slice(propertyDefIndex), propertyDef, schemas)
+        : undefined;
+    if (schema) {
+        const primitiveType = typeof value;
+        const isPrimitive = primitiveType === 'string' ||
+            primitiveType === 'number' ||
+            primitiveType === 'boolean' ||
+            value === undefined ||
+            value === null;
+        if (schema.type === 'boolean' &&
+            (primitiveType === 'boolean' || value === undefined || value === null)) {
+            return 'boolean';
+        }
+        if (schema.enum && Array.isArray(schema.enum) && schema.enum.length > 0 && isPrimitive) {
+            return 'enum';
+        }
+        if ((schema.type === 'string' || schema.type === 'number') && isPrimitive) {
+            return 'primitive';
+        }
+        if (schema.type === 'array') {
+            if (schema.minItems === 2 && schema.maxItems === 2)
+                return 'loop';
+            return 'set';
+        }
+        if (schema.type === 'object')
+            return 'map';
+    }
+    // Priority 3: Value introspection
+    if (value !== undefined && value !== null) {
+        if (isRule(value))
+            return 'rule';
+        if (typeof value === 'boolean')
+            return 'boolean';
+        if (typeof value === 'string' || typeof value === 'number') {
+            return 'valueType';
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0 || value.length === 1)
+                return 'set';
+            if (value.length === 2) {
+                const [first, second] = value;
+                if (typeof second === 'object' && second !== null) {
+                    if (typeof first === 'string')
+                        return 'loop';
+                    if (typeof first === 'object' && first !== null && 'key' in first) {
+                        return 'loop';
+                    }
+                }
+                return 'set';
+            }
+            return 'set';
+        }
+        if (typeof value === 'object') {
+            const obj = value;
+            if ('fn' in obj)
+                return 'fn';
+            if ('loop' in obj)
+                return 'loop';
+            if ('map' in obj)
+                return 'map';
+            if ('set' in obj)
+                return 'set';
+            if ('condition' in obj)
+                return 'condition';
+            if ('validate' in obj)
+                return 'validate';
+            if ('value' in obj)
+                return 'value';
+            return 'map';
+        }
+    }
+    // Priority 4: Schema fallback for undefined values
+    if (schema) {
+        if (schema.type === 'array') {
+            if (schema.minItems === 2 && schema.maxItems === 2)
+                return 'loop';
+            return 'set';
+        }
+        if (schema.type === 'object')
+            return 'map';
+        if (schema.type === 'boolean')
+            return 'boolean';
+        if (schema.type === 'string' || schema.type === 'number')
+            return 'primitive';
+    }
+    return 'valueType';
+}
+/**
+ * Resolve schema for a property using its schemaPath
+ */
+function resolveSchema(relativePath, propertyDef, schemas) {
+    const schemaPath = propertyDef.schemaPath;
+    if (!schemaPath)
+        return undefined;
+    let current = schemas[schemaPath];
+    if (!current)
+        return undefined;
+    // For schema-driven properties, navigate nested schema
+    if (propertyDef.children === 'schema-driven' && relativePath.length >= 2) {
+        for (let i = 1; i < relativePath.length; i++) {
+            const segment = relativePath[i];
+            if (!current.properties || !(segment in current.properties)) {
+                return undefined;
+            }
+            current = current.properties[segment];
+        }
+    }
+    return current;
+}
+/**
+ * Get schema for a path (exported for components that need schema access)
+ */
+export function getSchemaForPath(value, path, structure, schemas) {
+    if (!schemas || path.length === 0)
+        return undefined;
+    let currentStructure = structure;
+    let propertyDef;
+    let propertyDefIndex = -1;
+    for (let i = 0; i < path.length; i++) {
+        const segment = path[i];
+        const foundDef = currentStructure.properties?.[segment];
+        if (foundDef) {
+            propertyDef = foundDef;
+            propertyDefIndex = i;
+            if (foundDef.structure) {
+                currentStructure = foundDef.structure;
+            }
+        }
+        else {
+            break;
+        }
+    }
+    // Handle entity-action pattern recursively
+    if (propertyDef?.children === 'entity-action' && propertyDefIndex >= 0) {
+        const depth = path.length - propertyDefIndex;
+        if (depth >= 4) {
+            const rulePath = path.slice(propertyDefIndex + 3);
+            return getSchemaForPath(value, rulePath, MAPPING_RULE_STRUCTURE, schemas);
+        }
+    }
+    return propertyDef ? resolveSchema(path.slice(propertyDefIndex), propertyDef, schemas) : undefined;
+}
+/**
+ * Detect NodeType from JSON Schema alone (without value or structure)
+ *
+ * Used for property suggestions where we only have the schema definition.
+ * This is a lightweight detection based purely on JSON Schema properties.
+ *
+ * @param schema - JSON Schema for the property
+ * @returns NodeType for editing
+ */
+export function detectNodeTypeFromSchema(schema) {
+    // Check for boolean type
+    if (schema.type === 'boolean') {
+        return 'boolean';
+    }
+    // Check for enum with options
+    if (schema.enum && Array.isArray(schema.enum) && schema.enum.length > 0) {
+        return 'enum';
+    }
+    // Check for primitive string/number
+    if (schema.type === 'string' || schema.type === 'number') {
+        return 'primitive';
+    }
+    // Check for array
+    if (schema.type === 'array') {
+        // Loop arrays have exactly 2 items
+        if (schema.minItems === 2 && schema.maxItems === 2) {
+            return 'loop';
+        }
+        return 'set';
+    }
+    // Check for object
+    if (schema.type === 'object') {
+        return 'map';
+    }
+    // Default fallback
+    return 'valueType';
+}
+//# sourceMappingURL=type-detector.js.map

package/dist/utils/type-detector.js.map

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

package/dist/utils/value-display-formatter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Value Display Formatter
+ *
+ * Utilities for formatting values and extracting configured properties
+ * from ValueConfig objects for display in badges and UI elements.
+ */
+export interface PropertyBadge {
+    prop: string;
+    value: string;
+    isLong: boolean;
+}
+/**
+ * Format a value for display in a badge
+ *
+ * @param val - The value to format
+ * @returns Formatted string representation
+ */
+export declare function formatValueForDisplay(val: unknown): string;
+/**
+ * Extract configured properties from a value for display
+ *
+ * Handles:
+ * - Simple strings: Returns without prop label
+ * - ValueConfig with only key: Returns without prop label
+ * - Full ValueConfig: Returns all configured properties with labels
+ *
+ * @param value - The value to analyze (string or ValueConfig object)
+ * @returns Array of property badges for display
+ */
+export declare function getConfiguredProperties(value: unknown): PropertyBadge[];
+//# sourceMappingURL=value-display-formatter.d.ts.map

package/dist/utils/value-display-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-display-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/value-display-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAuB1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CAyDvE"}

package/dist/utils/value-display-formatter.js

@@ -0,0 +1,110 @@
+/**
+ * Value Display Formatter
+ *
+ * Utilities for formatting values and extracting configured properties
+ * from ValueConfig objects for display in badges and UI elements.
+ */
+/**
+ * Format a value for display in a badge
+ *
+ * @param val - The value to format
+ * @returns Formatted string representation
+ */
+export function formatValueForDisplay(val) {
+    if (typeof val === 'string')
+        return `"${val}"`;
+    if (typeof val === 'number' || typeof val === 'boolean')
+        return String(val);
+    if (Array.isArray(val)) {
+        if (val.length === 0)
+            return '[]';
+        // For arrays, show the first item (useful for loop/set arrays)
+        const firstItem = val[0];
+        if (typeof firstItem === 'string')
+            return `"${firstItem}"`;
+        if (typeof firstItem === 'number' || typeof firstItem === 'boolean')
+            return String(firstItem);
+        // For complex first items, show count
+        return `[${val.length}]`;
+    }
+    if (typeof val === 'object' && val !== null) {
+        const keys = Object.keys(val);
+        if (keys.length === 0)
+            return '{}';
+        // For objects (like map), show the keys in curly braces
+        return `{ ${keys.join(', ')} }`;
+    }
+    return '';
+}
+/**
+ * Extract configured properties from a value for display
+ *
+ * Handles:
+ * - Simple strings: Returns without prop label
+ * - ValueConfig with only key: Returns without prop label
+ * - Full ValueConfig: Returns all configured properties with labels
+ *
+ * @param value - The value to analyze (string or ValueConfig object)
+ * @returns Array of property badges for display
+ */
+export function getConfiguredProperties(value) {
+    // Simple string value - return without prop label
+    if (typeof value === 'string') {
+        return [
+            {
+                prop: '', // Empty prop means no label, just show the value
+                value: `"${value}"`,
+                isLong: value.length > 20,
+            },
+        ];
+    }
+    if (!value || typeof value !== 'object')
+        return [];
+    const props = [];
+    const obj = value;
+    // Check if this is a ValueConfig with ONLY a key property
+    // In this case, display it as a simple value without the "key:" label
+    const objKeys = Object.keys(obj);
+    if (objKeys.length === 1 &&
+        'key' in obj &&
+        obj.key &&
+        typeof obj.key === 'string') {
+        return [
+            {
+                prop: '', // No label, just show the key value
+                value: `"${obj.key}"`,
+                isLong: obj.key.length > 20,
+            },
+        ];
+    }
+    // Helper to add a property to the list
+    const addProp = (prop, val) => {
+        const formatted = formatValueForDisplay(val);
+        props.push({
+            prop,
+            value: formatted,
+            isLong: formatted.length > 20,
+        });
+    };
+    // Check all possible ValueConfig properties in consistent order
+    if ('fn' in obj && obj.fn)
+        addProp('fn', obj.fn);
+    if ('key' in obj && obj.key)
+        addProp('key', obj.key);
+    if ('value' in obj && obj.value !== undefined)
+        addProp('value', obj.value);
+    if ('map' in obj && obj.map)
+        addProp('map', obj.map);
+    if ('loop' in obj && obj.loop)
+        addProp('loop', obj.loop);
+    if ('set' in obj && obj.set)
+        addProp('set', obj.set);
+    if ('consent' in obj && obj.consent)
+        addProp('consent', obj.consent);
+    if ('condition' in obj && obj.condition)
+        addProp('condition', obj.condition);
+    if ('validate' in obj && obj.validate)
+        addProp('validate', obj.validate);
+    return props;
+}
+//# sourceMappingURL=value-display-formatter.js.map

package/dist/utils/value-display-formatter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkeros/explorer",
-  "version": "0.3.1",
+  "version": "1.0.0",
   "description": "Interactive React components for walkerOS documentation and exploration",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,9 @@
     "./styles": "./dist/styles.css"
   },
   "files": [
-    "dist/**"
+    "dist/**",
+    "AGENT.md",
+    "STYLE.md"
   ],
   "scripts": {
     "build": "tsup --silent",
@@ -33,17 +35,19 @@
     "format": "prettier --write ."
   },
   "dependencies": {
+    "@iconify/react": "^6.0.2",
     "@monaco-editor/react": "^4.7.0",
-    "@rjsf/core": "^5.24.13",
-    "@rjsf/utils": "^5.24.13",
-    "@rjsf/validator-ajv8": "^5.24.13",
+    "@rjsf/core": "^6.1.2",
+    "@rjsf/utils": "^6.1.2",
+    "@rjsf/validator-ajv8": "^6.1.2",
     "clsx": "^2.1.1",
-    "monaco-editor": "^0.54.0",
-    "prettier": "^3.6.2",
-    "tailwind-merge": "^2.5.5"
+    "monaco-editor": "^0.55.1",
+    "prettier": "^3.7.4",
+    "roughjs": "^4.6.6",
+    "tailwind-merge": "^3.4.0"
   },
   "peerDependencies": {
-    "@walkeros/core": "^0.3.1",
+    "@walkeros/core": "^0.8.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
@@ -56,29 +60,41 @@
     }
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.7",
-    "@storybook/addon-docs": "^10.0.4",
-    "@storybook/react-vite": "^10.0.4",
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/react": "^16.1.0",
-    "@testing-library/user-event": "^14.5.2",
-    "@types/react": "^19.0.2",
-    "@types/react-dom": "^19.0.2",
-    "@vitejs/plugin-react": "^5.1.0",
-    "@walkeros/collector": "^0.3.1",
-    "@walkeros/config": "^0.1.3",
-    "@walkeros/core": "^0.3.1",
-    "@walkeros/web-destination-gtag": "^0.3.1",
-    "@walkeros/web-source-browser": "^0.3.2",
-    "eslint-plugin-storybook": "^10.0.4",
+    "@changesets/cli": "^2.29.8",
+    "@storybook/addon-docs": "^10.1.11",
+    "@storybook/react-vite": "^10.1.11",
+    "@swc/core": "^1.11.13",
+    "@swc/jest": "^0.2.37",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.28.0",
+    "@typescript-eslint/parser": "^8.28.0",
+    "@vitejs/plugin-react": "^5.1.2",
+    "@walkeros/collector": "^0.9.0",
+    "@walkeros/core": "^0.8.0",
+    "@walkeros/web-destination-gtag": "^0.8.0",
+    "@walkeros/web-source-browser": "^0.8.0",
+    "baseline-browser-mapping": "^2.9.14",
+    "eslint": "^9.23.0",
+    "eslint-plugin-jest": "^28.11.0",
+    "eslint-plugin-storybook": "^10.1.11",
+    "globals": "^16.0.0",
     "husky": "^9.1.7",
     "identity-obj-proxy": "^3.0.0",
-    "lint-staged": "^16.2.6",
+    "jest": "^30.0.4",
+    "jest-environment-jsdom": "^30.0.4",
+    "lint-staged": "^16.2.7",
     "rehype-external-links": "^3.0.0",
     "rehype-slug": "^6.0.0",
-    "sass": "^1.93.2",
-    "storybook": "^10.0.4",
-    "vite": "^7.1.12"
+    "sass": "^1.96.0",
+    "storybook": "^10.1.11",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.7"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",