@walkeros/explorer 4.1.0 → 4.1.1-next-1779822275564

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @walkeros/explorer
 
+## 4.1.1-next-1779822275564
+
+### Patch Changes
+
+- b0279ee: Export the `$`-ref completion builders (`getVariableCompletions`,
+  `getEnvCompletions`, `getStoreCompletions`, `getFlowCompletions`,
+  `getSecretCompletions`) and the `CompletionEntry` type from the package barrel
+  so custom inputs can reuse them outside Monaco.
+- b0279ee: Export `getMappingPathCompletions` and `getContractCompletions` so
+  custom form inputs can seed contract-driven path and `$contract` reference
+  suggestions outside Monaco. Add `allowedRefKinds` (the cursor-scoped `$`-ref
+  gate, now covering `$contract`) and `getJsonPathAtOffset`, and gate the open
+  `$` completion fallback by the same scope rule so Monaco offers only the ref
+  kinds valid at the cursor.
+- Updated dependencies [b0279ee]
+- Updated dependencies [b0279ee]
+- Updated dependencies [0b7f494]
+- Updated dependencies [edd3836]
+- Updated dependencies [edd3836]
+  - @walkeros/core@4.1.1-next-1779822275564
+  - @walkeros/collector@4.1.1-next-1779822275564
+  - @walkeros/web-core@4.1.1-next-1779822275564
+  - @walkeros/web-source-browser@4.1.1-next-1779822275564
+
 ## 4.1.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -939,6 +939,52 @@ declare function Spinner({ size, className }: SpinnerProps): react_jsx_runtime.J
  */
 declare function isMonacoCancellation(value: unknown): boolean;
 
+interface CompletionEntry {
+    label: string;
+    insertText: string;
+    detail?: string;
+    documentation?: string;
+    kind: 'variable' | 'reference' | 'secret' | 'module' | 'property';
+    sortText?: string;
+}
+declare function getVariableCompletions(variables: IntelliSenseContext['variables']): CompletionEntry[];
+declare function getSecretCompletions(secrets: IntelliSenseContext['secrets']): CompletionEntry[];
+declare function getStoreCompletions(stores: IntelliSenseContext['stores']): CompletionEntry[];
+declare function getFlowCompletions(flows: IntelliSenseContext['flows']): CompletionEntry[];
+declare function getEnvCompletions(envNames: IntelliSenseContext['envNames']): CompletionEntry[];
+/**
+ * Get mapping value path completions based on contract schemas.
+ *
+ * When typing "data." inside a mapping rule for entity "page" action "view",
+ * this returns the properties defined in the contract for page.view.
+ */
+declare function getMappingPathCompletions(contractRaw: IntelliSenseContext['contractRaw'], entity: string, action: string, prefix: string): CompletionEntry[];
+declare function getContractCompletions(contractRaw: IntelliSenseContext['contractRaw'], pathSegments: string[]): CompletionEntry[];
+
+/** The `$`-ref kinds the completion gate can offer. Mirrors core's ref families. */
+type RefKind = 'var' | 'env' | 'store' | 'flow' | 'secret' | 'contract';
+/**
+ * Single pure scope gate for `$`-ref completion, shared by Monaco (subPath derived
+ * live from the cursor) and every Form field (subPath passed statically):
+ * - `$var`/`$env`/`$secret` broadly
+ * - `$store` only under an `env` subPath
+ * - `$flow` only in settings/env of source/destination
+ * - `$contract` only at a `validate.events.<entity>.<action>` value path
+ */
+declare function allowedRefKinds(nodeType: IntelliSenseContext['nodeType'], subPath?: string[]): RefKind[];
+
+/**
+ * Extract the JSON key path at a given character offset in a JSON string.
+ *
+ * Uses a simple stack-based parser that tracks object keys as we scan
+ * from the start to the offset position.
+ *
+ * @param json - The full JSON string
+ * @param offset - Character offset (0-based) of cursor position
+ * @returns Array of key segments from root to cursor
+ */
+declare function getJsonPathAtOffset(json: string, offset: number): string[];
+
 /**
  * MDXProvider - Makes components available in MDX files without explicit imports
  *
@@ -1380,4 +1426,4 @@ declare function validateWalkerOSReferences(text: string, context: Partial<Intel
  */
 declare function extractFlowIntelliSenseContext(json: string): Partial<IntelliSenseContext>;
 
-export { ArchitectureFlow, type ArchitectureFlowProps, Box, type BoxProps, type BoxTab, BrowserBox, type BrowserBoxProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, Code, CodeBox, type CodeBoxProps, type CodeBoxTab, CodeDiff, CodeDiffBox, type CodeDiffBoxProps, type CodeDiffProps, type CodeDiffSummary, type CodeProps, CodeSnippet, type CodeSnippetProps, CodeStatic, type CodeStaticProps, CodeView, type CodeViewProps, type CodeViewTab, CollectorBox, type CollectorBoxProps, DEFAULT_FALLBACK_HTML, Dropdown, DropdownDivider, type DropdownDividerProps, DropdownItem, type DropdownItemProps, type DropdownProps, type ExplorerTheme, type FlowColumn, type FlowItem, FlowMap, type FlowMapProps, type FlowSection, type FlowStageConfig, Footer, type FooterProps, Grid, type GridProps, Header, type HeaderProps, type IntelliSenseContext, LiveCode, type LiveCodeProps, type LoadPackageTypesOptions, MDXCode, MDXProvider, type MonacoSchemaExtension, type PackageInfo, Preview, type PreviewProps, PromotionPlayground, type PromotionPlaygroundProps, PropertyTable, type PropertyTableProps, REFERENCE_PATTERNS, Spinner, type SpinnerProps, type UseDropdownReturn, applyWalkerOSDecorations, cn, createFbqDestination, createGtagDestination, createPlausibleDestination, disposeWalkerOSProviders, enrichFlowConfigSchema, enrichSchema, extractFlowIntelliSenseContext, findWalkerOSReferences, generateModelPath, getEnrichedContractSchema, getVariablesSchema, initializeMonacoTypes, isMonacoCancellation, lighthouseTheme, loadPackageTypes, loadTypeLibraryFromURL, palenightTheme, registerAllThemes, registerJsonSchema, registerLighthouseTheme, registerPalenightTheme, registerWalkerOSDecorationStyles, registerWalkerOSProviders, registerWalkerOSTypes, removeIntelliSenseContext, resolveTypesUrl, setIntelliSenseContext, setPackageTypesBaseUrl, unregisterJsonSchema, useDropdown, validateWalkerOSReferences };
+export { ArchitectureFlow, type ArchitectureFlowProps, Box, type BoxProps, type BoxTab, BrowserBox, type BrowserBoxProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, Code, CodeBox, type CodeBoxProps, type CodeBoxTab, CodeDiff, CodeDiffBox, type CodeDiffBoxProps, type CodeDiffProps, type CodeDiffSummary, type CodeProps, CodeSnippet, type CodeSnippetProps, CodeStatic, type CodeStaticProps, CodeView, type CodeViewProps, type CodeViewTab, CollectorBox, type CollectorBoxProps, type CompletionEntry, DEFAULT_FALLBACK_HTML, Dropdown, DropdownDivider, type DropdownDividerProps, DropdownItem, type DropdownItemProps, type DropdownProps, type ExplorerTheme, type FlowColumn, type FlowItem, FlowMap, type FlowMapProps, type FlowSection, type FlowStageConfig, Footer, type FooterProps, Grid, type GridProps, Header, type HeaderProps, type IntelliSenseContext, LiveCode, type LiveCodeProps, type LoadPackageTypesOptions, MDXCode, MDXProvider, type MonacoSchemaExtension, type PackageInfo, Preview, type PreviewProps, PromotionPlayground, type PromotionPlaygroundProps, PropertyTable, type PropertyTableProps, REFERENCE_PATTERNS, type RefKind, Spinner, type SpinnerProps, type UseDropdownReturn, allowedRefKinds, applyWalkerOSDecorations, cn, createFbqDestination, createGtagDestination, createPlausibleDestination, disposeWalkerOSProviders, enrichFlowConfigSchema, enrichSchema, extractFlowIntelliSenseContext, findWalkerOSReferences, generateModelPath, getContractCompletions, getEnrichedContractSchema, getEnvCompletions, getFlowCompletions, getJsonPathAtOffset, getMappingPathCompletions, getSecretCompletions, getStoreCompletions, getVariableCompletions, getVariablesSchema, initializeMonacoTypes, isMonacoCancellation, lighthouseTheme, loadPackageTypes, loadTypeLibraryFromURL, palenightTheme, registerAllThemes, registerJsonSchema, registerLighthouseTheme, registerPalenightTheme, registerWalkerOSDecorationStyles, registerWalkerOSProviders, registerWalkerOSTypes, removeIntelliSenseContext, resolveTypesUrl, setIntelliSenseContext, setPackageTypesBaseUrl, unregisterJsonSchema, useDropdown, validateWalkerOSReferences };

package/dist/index.d.ts

@@ -939,6 +939,52 @@ declare function Spinner({ size, className }: SpinnerProps): react_jsx_runtime.J
  */
 declare function isMonacoCancellation(value: unknown): boolean;
 
+interface CompletionEntry {
+    label: string;
+    insertText: string;
+    detail?: string;
+    documentation?: string;
+    kind: 'variable' | 'reference' | 'secret' | 'module' | 'property';
+    sortText?: string;
+}
+declare function getVariableCompletions(variables: IntelliSenseContext['variables']): CompletionEntry[];
+declare function getSecretCompletions(secrets: IntelliSenseContext['secrets']): CompletionEntry[];
+declare function getStoreCompletions(stores: IntelliSenseContext['stores']): CompletionEntry[];
+declare function getFlowCompletions(flows: IntelliSenseContext['flows']): CompletionEntry[];
+declare function getEnvCompletions(envNames: IntelliSenseContext['envNames']): CompletionEntry[];
+/**
+ * Get mapping value path completions based on contract schemas.
+ *
+ * When typing "data." inside a mapping rule for entity "page" action "view",
+ * this returns the properties defined in the contract for page.view.
+ */
+declare function getMappingPathCompletions(contractRaw: IntelliSenseContext['contractRaw'], entity: string, action: string, prefix: string): CompletionEntry[];
+declare function getContractCompletions(contractRaw: IntelliSenseContext['contractRaw'], pathSegments: string[]): CompletionEntry[];
+
+/** The `$`-ref kinds the completion gate can offer. Mirrors core's ref families. */
+type RefKind = 'var' | 'env' | 'store' | 'flow' | 'secret' | 'contract';
+/**
+ * Single pure scope gate for `$`-ref completion, shared by Monaco (subPath derived
+ * live from the cursor) and every Form field (subPath passed statically):
+ * - `$var`/`$env`/`$secret` broadly
+ * - `$store` only under an `env` subPath
+ * - `$flow` only in settings/env of source/destination
+ * - `$contract` only at a `validate.events.<entity>.<action>` value path
+ */
+declare function allowedRefKinds(nodeType: IntelliSenseContext['nodeType'], subPath?: string[]): RefKind[];
+
+/**
+ * Extract the JSON key path at a given character offset in a JSON string.
+ *
+ * Uses a simple stack-based parser that tracks object keys as we scan
+ * from the start to the offset position.
+ *
+ * @param json - The full JSON string
+ * @param offset - Character offset (0-based) of cursor position
+ * @returns Array of key segments from root to cursor
+ */
+declare function getJsonPathAtOffset(json: string, offset: number): string[];
+
 /**
  * MDXProvider - Makes components available in MDX files without explicit imports
  *
@@ -1380,4 +1426,4 @@ declare function validateWalkerOSReferences(text: string, context: Partial<Intel
  */
 declare function extractFlowIntelliSenseContext(json: string): Partial<IntelliSenseContext>;
 
-export { ArchitectureFlow, type ArchitectureFlowProps, Box, type BoxProps, type BoxTab, BrowserBox, type BrowserBoxProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, Code, CodeBox, type CodeBoxProps, type CodeBoxTab, CodeDiff, CodeDiffBox, type CodeDiffBoxProps, type CodeDiffProps, type CodeDiffSummary, type CodeProps, CodeSnippet, type CodeSnippetProps, CodeStatic, type CodeStaticProps, CodeView, type CodeViewProps, type CodeViewTab, CollectorBox, type CollectorBoxProps, DEFAULT_FALLBACK_HTML, Dropdown, DropdownDivider, type DropdownDividerProps, DropdownItem, type DropdownItemProps, type DropdownProps, type ExplorerTheme, type FlowColumn, type FlowItem, FlowMap, type FlowMapProps, type FlowSection, type FlowStageConfig, Footer, type FooterProps, Grid, type GridProps, Header, type HeaderProps, type IntelliSenseContext, LiveCode, type LiveCodeProps, type LoadPackageTypesOptions, MDXCode, MDXProvider, type MonacoSchemaExtension, type PackageInfo, Preview, type PreviewProps, PromotionPlayground, type PromotionPlaygroundProps, PropertyTable, type PropertyTableProps, REFERENCE_PATTERNS, Spinner, type SpinnerProps, type UseDropdownReturn, applyWalkerOSDecorations, cn, createFbqDestination, createGtagDestination, createPlausibleDestination, disposeWalkerOSProviders, enrichFlowConfigSchema, enrichSchema, extractFlowIntelliSenseContext, findWalkerOSReferences, generateModelPath, getEnrichedContractSchema, getVariablesSchema, initializeMonacoTypes, isMonacoCancellation, lighthouseTheme, loadPackageTypes, loadTypeLibraryFromURL, palenightTheme, registerAllThemes, registerJsonSchema, registerLighthouseTheme, registerPalenightTheme, registerWalkerOSDecorationStyles, registerWalkerOSProviders, registerWalkerOSTypes, removeIntelliSenseContext, resolveTypesUrl, setIntelliSenseContext, setPackageTypesBaseUrl, unregisterJsonSchema, useDropdown, validateWalkerOSReferences };
+export { ArchitectureFlow, type ArchitectureFlowProps, Box, type BoxProps, type BoxTab, BrowserBox, type BrowserBoxProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, Code, CodeBox, type CodeBoxProps, type CodeBoxTab, CodeDiff, CodeDiffBox, type CodeDiffBoxProps, type CodeDiffProps, type CodeDiffSummary, type CodeProps, CodeSnippet, type CodeSnippetProps, CodeStatic, type CodeStaticProps, CodeView, type CodeViewProps, type CodeViewTab, CollectorBox, type CollectorBoxProps, type CompletionEntry, DEFAULT_FALLBACK_HTML, Dropdown, DropdownDivider, type DropdownDividerProps, DropdownItem, type DropdownItemProps, type DropdownProps, type ExplorerTheme, type FlowColumn, type FlowItem, FlowMap, type FlowMapProps, type FlowSection, type FlowStageConfig, Footer, type FooterProps, Grid, type GridProps, Header, type HeaderProps, type IntelliSenseContext, LiveCode, type LiveCodeProps, type LoadPackageTypesOptions, MDXCode, MDXProvider, type MonacoSchemaExtension, type PackageInfo, Preview, type PreviewProps, PromotionPlayground, type PromotionPlaygroundProps, PropertyTable, type PropertyTableProps, REFERENCE_PATTERNS, type RefKind, Spinner, type SpinnerProps, type UseDropdownReturn, allowedRefKinds, applyWalkerOSDecorations, cn, createFbqDestination, createGtagDestination, createPlausibleDestination, disposeWalkerOSProviders, enrichFlowConfigSchema, enrichSchema, extractFlowIntelliSenseContext, findWalkerOSReferences, generateModelPath, getContractCompletions, getEnrichedContractSchema, getEnvCompletions, getFlowCompletions, getJsonPathAtOffset, getMappingPathCompletions, getSecretCompletions, getStoreCompletions, getVariableCompletions, getVariablesSchema, initializeMonacoTypes, isMonacoCancellation, lighthouseTheme, loadPackageTypes, loadTypeLibraryFromURL, palenightTheme, registerAllThemes, registerJsonSchema, registerLighthouseTheme, registerPalenightTheme, registerWalkerOSDecorationStyles, registerWalkerOSProviders, registerWalkerOSTypes, removeIntelliSenseContext, resolveTypesUrl, setIntelliSenseContext, setPackageTypesBaseUrl, unregisterJsonSchema, useDropdown, validateWalkerOSReferences };