@walkeros/explorer 4.7.0 → 4.7.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @walkeros/explorer
 
+## 4.7.1
+
+### Patch Changes
+
+- dbc172c: Read-only code boxes (`CodeView`, `CodeSnippet`) now size to their
+  content instead of a fixed height, and snippets show a copy button. New
+  `StepExample` shows a step's event, mapping and output side by side, wrapping
+  to a stack on narrow screens. `Grid` now honors `columns`: at most that many
+  boxes per row, the rest wrap.
+- 91e9aeb: Read-only code blocks (`CodeView`, `CodeSnippet`, `StepExample`) now
+  name their language on the rendered `<code>` element, so Markdown converted
+  from the page keeps each code fence's language, including languages that
+  render as plain text.
+- Updated dependencies [91e9aeb]
+- Updated dependencies [0635330]
+- Updated dependencies [0635330]
+- Updated dependencies [91e9aeb]
+- Updated dependencies [0635330]
+  - @walkeros/web-core@4.7.1
+  - @walkeros/web-source-browser@4.7.1
+  - @walkeros/collector@4.7.1
+  - @walkeros/core@4.7.1
+
 ## 4.7.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Destination, WalkerOS, Elb } from '@walkeros/core';
+import { Destination, WalkerOS, Flow, Elb } from '@walkeros/core';
 import React, { ReactNode, FC, PropsWithChildren, RefObject } from 'react';
 import * as monaco_editor from 'monaco-editor';
 import { editor } from 'monaco-editor';
@@ -522,6 +522,26 @@ interface PropertyTableProps {
 }
 declare function PropertyTable({ schema, className, emptyMessage, }: PropertyTableProps): react_jsx_runtime.JSX.Element;
 
+interface StepExampleProps {
+    example: Flow.StepExample;
+    className?: string;
+}
+/**
+ * StepExample - A step example's Event, Mapping and Out, read-only.
+ *
+ * The boxes sit side by side while each keeps a readable width and wrap to
+ * fewer per row, down to a stack, as the container narrows. A row is as tall
+ * as its tallest box up to a cap; longer code scrolls inside its box.
+ *
+ * Rendered with the static Shiki path, so the code is in server-rendered HTML
+ * and in the docs Markdown export. That export relies on this DOM: one
+ * labelled box per part, each with a `pre > code` that names its language.
+ *
+ * @example
+ * <StepExample example={data.examples.step.addToCart} />
+ */
+declare function StepExample({ example, className }: StepExampleProps): react_jsx_runtime.JSX.Element;
+
 interface DropdownProps {
     /** Trigger element (button, link, etc.) */
     trigger: React.ReactNode;
@@ -750,6 +770,10 @@ declare function Box({ header, headerActions, footer, children, className, style
 
 interface GridProps {
     children: React.ReactNode;
+    /**
+     * Boxes per row; further boxes wrap to a new row. Pass the number of boxes
+     * you render, since unused columns stay empty. Omit for one row of all boxes.
+     */
     columns?: number;
     minBoxWidth?: number | string;
     gap?: number | string;
@@ -762,8 +786,9 @@ interface GridProps {
  * Grid - Horizontal scrolling layout component for arranging boxes
  *
  * Provides consistent grid layout for box components with horizontal
- * scrolling when content exceeds available space. Boxes maintain minimum
- * width and never wrap to new rows.
+ * scrolling when content exceeds available space. Boxes keep a minimum width.
+ * By default all boxes share one row; `columns` sets the boxes per row and
+ * wraps the rest. Narrow containers stack the boxes.
  *
  * @example
  * // 5 boxes with default 350px minimum width
@@ -1410,4 +1435,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, 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 };
+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, StepExample, type StepExampleProps, 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

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Destination, WalkerOS, Elb } from '@walkeros/core';
+import { Destination, WalkerOS, Flow, Elb } from '@walkeros/core';
 import React, { ReactNode, FC, PropsWithChildren, RefObject } from 'react';
 import * as monaco_editor from 'monaco-editor';
 import { editor } from 'monaco-editor';
@@ -522,6 +522,26 @@ interface PropertyTableProps {
 }
 declare function PropertyTable({ schema, className, emptyMessage, }: PropertyTableProps): react_jsx_runtime.JSX.Element;
 
+interface StepExampleProps {
+    example: Flow.StepExample;
+    className?: string;
+}
+/**
+ * StepExample - A step example's Event, Mapping and Out, read-only.
+ *
+ * The boxes sit side by side while each keeps a readable width and wrap to
+ * fewer per row, down to a stack, as the container narrows. A row is as tall
+ * as its tallest box up to a cap; longer code scrolls inside its box.
+ *
+ * Rendered with the static Shiki path, so the code is in server-rendered HTML
+ * and in the docs Markdown export. That export relies on this DOM: one
+ * labelled box per part, each with a `pre > code` that names its language.
+ *
+ * @example
+ * <StepExample example={data.examples.step.addToCart} />
+ */
+declare function StepExample({ example, className }: StepExampleProps): react_jsx_runtime.JSX.Element;
+
 interface DropdownProps {
     /** Trigger element (button, link, etc.) */
     trigger: React.ReactNode;
@@ -750,6 +770,10 @@ declare function Box({ header, headerActions, footer, children, className, style
 
 interface GridProps {
     children: React.ReactNode;
+    /**
+     * Boxes per row; further boxes wrap to a new row. Pass the number of boxes
+     * you render, since unused columns stay empty. Omit for one row of all boxes.
+     */
     columns?: number;
     minBoxWidth?: number | string;
     gap?: number | string;
@@ -762,8 +786,9 @@ interface GridProps {
  * Grid - Horizontal scrolling layout component for arranging boxes
  *
  * Provides consistent grid layout for box components with horizontal
- * scrolling when content exceeds available space. Boxes maintain minimum
- * width and never wrap to new rows.
+ * scrolling when content exceeds available space. Boxes keep a minimum width.
+ * By default all boxes share one row; `columns` sets the boxes per row and
+ * wraps the rest. Narrow containers stack the boxes.
  *
  * @example
  * // 5 boxes with default 350px minimum width
@@ -1410,4 +1435,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, 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 };
+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, StepExample, type StepExampleProps, 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 };