@walkeros/explorer 2.1.0 → 2.1.2

package/AGENT.md

@@ -16,6 +16,11 @@ configuration.
 
 - **ALWAYS import modules at the top of files** - Never use inline
   `typeof import()` or dynamic `await import()`
+- **Exception — `monaco-editor`**: Use lazy `require()` accessors (cached in a
+  module variable) instead of top-level imports. Monaco accesses `window` at
+  module evaluation time, which crashes SSR. See `monaco-json-schema.ts` and
+  `code-box.tsx` for the pattern. `@monaco-editor/react` and `import type` from
+  `monaco-editor` are both SSR-safe.
 - Use proper type imports: `import type { Monaco } from '@monaco-editor/react';`
 
 ## Development Commands
@@ -391,6 +396,20 @@ step.
 - [ ] Build succeeds: `npm run build`
 - [ ] Exported from `src/index.ts` if public API
 
+## Storybook Story Guidelines
+
+- **Prefer Storybook controls over separate stories** for trivial prop
+  variations (e.g., `disabled: true`, `size: 'lg'`). Users can toggle these in
+  the controls panel.
+- **Use composite stories** to showcase multiple variants side-by-side when
+  visual comparison matters (e.g., ThemeComparison, MarkersWithLegend).
+- **One story per distinct feature** — each story should demonstrate a unique
+  component capability, not a minor prop tweak.
+- **No design exploration galleries** — layout/typography comparison stories
+  belong in design tools, not Storybook.
+- **No website/CI-specific stories** — stories should demo generic component
+  features, not site-specific styling or marketing use cases.
+
 ## Integration with walkerOS
 
 This library depends on `@walkeros/core`, `@walkeros/collector`, and

package/STYLE.md

@@ -612,6 +612,12 @@ import { setupV2JsonSchema } from '@walkeros/core/dev';
 - `hover` — tooltip descriptions from schema `description` fields
 - Unique model `path` — auto-generated to isolate schema per editor instance
 
+**`intellisenseContext` prop:** Provides `$var.`, `$def.`, `$secret.`
+completions, hover tooltips, and semantic validation markers. Also generates a
+unique model `path` and enables `quickSuggestions` and `hover` independently of
+`jsonSchema`. Both props can be combined for full schema validation +
+context-driven features.
+
 **Advanced: Direct Registry Access:**
 
 ```typescript