inklet 4.0.0.dev3__tar.gz → 4.0.0.dev4__tar.gz

{inklet-4.0.0.dev3 → inklet-4.0.0.dev4}/.github/workflows/publish.yml

@@ -6,7 +6,7 @@ on:
       tag:
         description: Published GitHub release tag
         required: true
-        default: v4.0.0.dev3
+        default: v4.0.0.dev4
         type: string
       dry_run:
         description: Validate release files without uploading to PyPI
@@ -43,7 +43,7 @@ jobs:
           RELEASE_TAG: ${{ inputs.tag }}
         run: |
           [[ "$RELEASE_TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(\.dev[0-9]+)?$ ]] || {
-            echo 'Expected a stable or development tag such as v3.1.0 or v4.0.0.dev3' >&2
+            echo 'Expected a stable or development tag such as v3.1.0 or v4.0.0.dev4' >&2
             exit 1
           }
           gh release view "$RELEASE_TAG" --json isDraft,isPrerelease > "$RUNNER_TEMP/release.json"

{inklet-4.0.0.dev3 → inklet-4.0.0.dev4}/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## Unreleased
 
+## 4.0.0.dev4 — 2026-09-12
+
+Fourth development preview: correct closed polar geometry and make the plot
+documentation visual and easier to navigate. 3.1.0 remains stable.
+
+- Fix closed polar curves retracing the angular range and shaded bands crossing
+  themselves. Complete the closing arc in sample order and retain both band
+  endpoints; refresh polar previews and cover angular units and winding directions.
+
+- Reorganize documentation around plotting, interactive documents and microscopy.
+  Add a searchable visual plot gallery and six guides with 22 rendered, runnable
+  examples; check plot-family coverage, gallery links and guide execution.
+
 ## 4.0.0.dev3 — 2026-09-12
 
 Third development preview: shared scene execution, dense marker rendering,

{inklet-4.0.0.dev3 → inklet-4.0.0.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: inklet
-Version: 4.0.0.dev3
+Version: 4.0.0.dev4
 Summary: Scientific figures with live data, measured layout, and consistent vector exports.
 Project-URL: Repository, https://github.com/Mapika/inklet
 Project-URL: Documentation, https://inklet.readthedocs.io/en/latest/
@@ -81,17 +81,16 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**4.0.0.dev3** adds shared compiled rendering, packed dense markers, offline
-WebGL2/Canvas viewing, and a plot-style inspector with undo/redo and saved
-visual overrides. Linked charts, maps and scientific reports preserve selections,
-source revisions and reproducible vector exports.
+**4.0.0.dev4** fixes closed polar curves and shaded bands, and adds a visual
+plot gallery with 22 runnable examples. It retains shared compiled rendering,
+offline viewing, linked reports, and reproducible plot editing with undo/redo.
 ```sh
-python -m pip install "inklet==4.0.0.dev3"
+python -m pip install "inklet==4.0.0.dev4"
 ```
 
 [Preview guide and examples](https://inklet.readthedocs.io/en/latest/development-preview/) ·
 [4.0 roadmap](https://inklet.readthedocs.io/en/latest/roadmap/) ·
-[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev3)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev4)
 
 This is an opt-in development release. Experimental APIs and saved-state schemas
 may change; 3.1.0 remains the stable release. General browser editing,

{inklet-4.0.0.dev3 → inklet-4.0.0.dev4}/README.md

@@ -31,17 +31,16 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**4.0.0.dev3** adds shared compiled rendering, packed dense markers, offline
-WebGL2/Canvas viewing, and a plot-style inspector with undo/redo and saved
-visual overrides. Linked charts, maps and scientific reports preserve selections,
-source revisions and reproducible vector exports.
+**4.0.0.dev4** fixes closed polar curves and shaded bands, and adds a visual
+plot gallery with 22 runnable examples. It retains shared compiled rendering,
+offline viewing, linked reports, and reproducible plot editing with undo/redo.
 ```sh
-python -m pip install "inklet==4.0.0.dev3"
+python -m pip install "inklet==4.0.0.dev4"
 ```
 
 [Preview guide and examples](https://inklet.readthedocs.io/en/latest/development-preview/) ·
 [4.0 roadmap](https://inklet.readthedocs.io/en/latest/roadmap/) ·
-[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev3)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev4)
 
 This is an opt-in development release. Experimental APIs and saved-state schemas
 may change; 3.1.0 remains the stable release. General browser editing,

inklet-4.0.0.dev4/docs/bars-and-areas.md

@@ -0,0 +1,164 @@
+# Bars and areas
+
+Bars compare values at category or numeric positions. Areas show the extent
+between a curve and a baseline or between two curves. Use stacked displays only
+when adding the contributions has a stated meaning.
+
+All values below are illustrative. Each snippet can be run independently with
+core Inklet; PNG preview generation additionally uses the `render` extra.
+
+## Categorical bars
+
+Compare values across named categories.
+`bar_colors` maps colours to individual bars; `colors` maps colours to series
+in grouped or stacked bars. Declare a suitable baseline explicitly.
+
+```python
+import inklet as i
+p = i.plot_spec(x=['Control', 'Treatment'], y=(0, 10), height=45)
+p.bars(['Control', 'Treatment'], [5, 8],
+       bar_colors=['#527da8', '#b96932'])
+p.axes(y='Response / a.u.')
+doc = i.document(width=105)
+doc.add('bars', p)
+doc.save('bars.svg', 'bars.pdf')
+```
+
+![Categorical bars: Compare values across named categories.](assets/guides/plots-bars.png)
+
+*Rendered from the code above.*
+
+## Grouped bars
+
+Grouped bars compare several series within each category.
+The outer list of heights is series-major. Keep the same category order across
+series and use the legend to identify them.
+
+```python
+import inklet as i
+p = i.plot_spec(x=['A', 'B', 'C'], y=(0, 10), height=45)
+p.bars(['A', 'B', 'C'], [[4, 7, 5], [6, 5, 8]], grouped=True,
+       colors=['#527da8', '#b96932'], names=['Before', 'After'])
+p.axes(y='Response / a.u.').legend(side='bottom')
+doc = i.document(width=105)
+doc.add('grouped-bars', p)
+doc.save('grouped-bars.svg', 'grouped-bars.pdf')
+```
+
+![Grouped bars: Grouped bars compare several series within each category.](assets/guides/plots-grouped-bars.png)
+
+*Rendered from the code above.*
+
+## Stacked bars
+
+Stacked bars show each contribution and the total at each category.
+Values are supplied per series. For contributions that are difficult to compare
+without a common baseline, consider grouped bars instead.
+
+```python
+import inklet as i
+p = i.plot_spec(x=['A', 'B', 'C'], y=(0, 10), height=45)
+p.bars(['A', 'B', 'C'], [[3, 4, 2], [4, 2, 5]], stacked=True,
+       colors=['#527da8', '#80ad91'], names=['Part one', 'Part two'])
+p.axes(y='Total / a.u.').legend(side='bottom')
+doc = i.document(width=105)
+doc.add('stacked-bars', p)
+doc.save('stacked-bars.svg', 'stacked-bars.pdf')
+```
+
+![Stacked bars: Stacked bars show each contribution and the total at each category.](assets/guides/plots-stacked-bars.png)
+
+*Rendered from the code above.*
+
+## Horizontal bars
+
+Horizontal bars give category labels more room.
+The first categorical y value is at the bottom. Reverse the category order
+when the first label should appear at the top.
+
+```python
+import inklet as i
+p = i.plot_spec(x=(0, 10), y=['West', 'Central', 'North'], height=45)
+p.bars(['West', 'Central', 'North'], [6, 8, 5], orient='h',
+       bar_colors=['#527da8', '#80ad91', '#b96932'])
+p.axes(x='Value / a.u.')
+doc = i.document(width=105)
+doc.add('horizontal-bars', p)
+doc.save('horizontal-bars.svg', 'horizontal-bars.pdf')
+```
+
+![Horizontal bars: Horizontal bars give category labels more room.](assets/guides/plots-horizontal-bars.png)
+
+*Rendered from the code above.*
+
+## Filled areas
+
+Fill the region between a curve and a stated baseline.
+Declare the area before an overlaid line so the outline remains visible.
+
+```python
+import inklet as i
+p = i.plot_spec(x=(0, 5), y=(0, 6), height=45)
+points = [(0, 1), (1, 3), (2, 2), (3, 4), (4, 3), (5, 5)]
+p.fill(points, baseline=0, fill='#a5c8b7', stroke='none')
+p.line(points, stroke='#34735f', stroke_width=.5)
+p.axes(x='Position / mm', y='Value / a.u.')
+doc = i.document(width=105)
+doc.add('fill', p)
+doc.save('fill.svg', 'fill.pdf')
+```
+
+![Filled areas: Fill the region between a curve and a stated baseline.](assets/guides/plots-fill.png)
+
+*Rendered from the code above.*
+
+## Between curves
+
+Fill a region between two supplied curves.
+`fill_between` takes absolute y coordinates. A coloured region alone does not
+imply uncertainty; describe the meaning of the two boundaries.
+
+```python
+import inklet as i
+p = i.plot_spec(x=(0, 4), y=(0, 6), height=45)
+x = [0, 1, 2, 3, 4]
+lower, upper = [1, 2, 1.5, 2.5, 2], [3, 4, 3.5, 5, 4]
+p.fill_between(x, lower, upper, fill='#c6b3d6', stroke='none')
+p.line(list(zip(x, lower)), stroke='#76578f')
+p.line(list(zip(x, upper)), stroke='#76578f')
+p.axes(x='Position / mm', y='Boundary / a.u.')
+doc = i.document(width=105)
+doc.add('fill-between', p)
+doc.save('fill-between.svg', 'fill-between.pdf')
+```
+
+![Between curves: Fill a region between two supplied curves.](assets/guides/plots-fill-between.png)
+
+*Rendered from the code above.*
+
+## Stacked areas
+
+Stacked areas accumulate nonnegative series over x.
+Values are series-major; each series must contain one value per x coordinate.
+For signed regions, calculate the boundaries and use `fill_between` explicitly.
+
+```python
+import inklet as i
+p = i.plot_spec(x=(0, 4), y=(0, 9), height=45)
+p.stackarea([0, 1, 2, 3, 4], [[2, 3, 2, 4, 3], [3, 2, 4, 2, 4]],
+            colors=['#527da8', '#80ad91'], names=['Part one', 'Part two'],
+            stroke='none')
+p.axes(x='Time / s', y='Total / a.u.').legend(side='bottom')
+doc = i.document(width=105)
+doc.add('stackarea', p)
+doc.save('stackarea.svg', 'stackarea.pdf')
+```
+
+![Stacked areas: Stacked areas accumulate nonnegative series over x.](assets/guides/plots-stackarea.png)
+
+*Rendered from the code above.*
+
+## Next steps
+
+[Compare plot types](plot-types.md), configure [axes and scales](axes-and-scales.md),
+or [arrange several panels](layout.md). For exact options, see the [API](api.md).

{inklet-4.0.0.dev3 → inklet-4.0.0.dev4}/docs/compatibility.md

@@ -48,7 +48,7 @@ Blender. Scene creation and rendering run Blender in a separate process.
 ### Development-preview table adapters
 
 The [pandas and Polars adapters](table-inputs.md) are included in the experimental
-[4.0.0.dev3 preview](development-preview.md), not in stable 3.1.0. Their `pandas` and `polars` extras are separate
+[4.0.0.dev4 preview](development-preview.md), not in stable 3.1.0. Their `pandas` and `polars` extras are separate
 from core dependencies. The adapter CI jobs use Linux/Python 3.12 with pandas
 2.2.0 / Polars 1.0.0 and the versions pinned in `requirements-tables.txt`.
 Both paths check scalar/identity contracts and saved-state SVG reconstruction.

{inklet-4.0.0.dev3 → inklet-4.0.0.dev4}/docs/development-preview.md

@@ -1,6 +1,6 @@
-# Inklet 4.0.0.dev3
+# Inklet 4.0.0.dev4
 
-The third 4.0 development release includes the linked plotting, mapping,
+The fourth 4.0 development release includes the linked plotting, mapping,
 engineering and scientific workflows developed since 3.1.0. It is an installable
 snapshot for trying real examples and reporting problems. **3.1.0 remains the
 stable release.** The [4.0 roadmap](roadmap.md) still has open work.
@@ -8,7 +8,7 @@ stable release.** The [4.0 roadmap](roadmap.md) still has open work.
 ```sh
 python -m venv .venv
 source .venv/bin/activate
-python -m pip install "inklet==4.0.0.dev3"
+python -m pip install "inklet==4.0.0.dev4"
 ```
 
 On Windows PowerShell, activate with `.venv\Scripts\Activate.ps1` instead.
@@ -19,9 +19,9 @@ stable releases; see its [installation documentation](https://pip.pypa.io/en/sta
 Optional extras can be installed with the same pin:
 
 ```sh
-python -m pip install "inklet[render,pandas,polars]==4.0.0.dev3"
+python -m pip install "inklet[render,pandas,polars]==4.0.0.dev4"
 # Add calibrated volumes and TIFF workflows when needed:
-python -m pip install "inklet[volume,render]==4.0.0.dev3"
+python -m pip install "inklet[volume,render]==4.0.0.dev4"
 ```
 
 The core preview needs no browser server, NumPy, pandas, Polars or Blender.
@@ -29,7 +29,19 @@ Opening the generated HTML requires a browser. PNG/PDF exports from browser
 figures use separate Chrome/Chromium and Pillow; native Diagram exports retain
 their existing requirements. See [installation](installation.md).
 
-## Rendering and authoring in dev3
+## Plot corrections and visual guides in dev4
+
+Closed polar curves now complete the angular turn without retracing the samples,
+and closed bands retain their endpoints without a missing wedge. This fixes
+incorrect self-crossings in both static exports and their previews.
+
+The [visual plot gallery](plot-types.md) adds 22 rendered examples across six
+focused guides. Navigation now separates core plots, interactive documents,
+microscopy and development studies. Existing guide URLs remain valid.
+
+![Corrected closed polar curve and uncertainty band](assets/guides/plots-polar-curve.png)
+
+## Rendering and authoring retained from dev3
 
 This preview adds shared [native compiled scenes](compiled-scenes.md),
 [packed markers](marker-batches.md), [spatial culling](marker-culling.md), and
@@ -37,7 +49,7 @@ an offline [compiled viewer](compiled-viewer.md) with reported WebGL2/Canvas
 fallback. The [regional report](regional-report.md) connects that executor to
 keyed selection, filtering and saved-state revision controls.
 
-The new [plot-style inspector](visual-editing.md) supports named colours, marker
+The [plot-style inspector](visual-editing.md) supports named colours, marker
 sizes and line widths, undo/redo, and saved overrides for Python reconstruction.
 It preserves compatible edits across revisions and reports orphaned targets.
 This is a bounded start on authoring, not the full 4.0 editor.
@@ -74,7 +86,7 @@ The wheel contains the library. To obtain recipes and fixtures, use the matching
 release checkout or source archive:
 
 ```sh
-git clone --branch v4.0.0.dev3 https://github.com/Mapika/inklet.git
+git clone --branch v4.0.0.dev4 https://github.com/Mapika/inklet.git
 cd inklet
 python -m pip install -e '.[render]'
 python examples/v4/regional_report.py --renderer compiled --editor --output out/regional

inklet-4.0.0.dev4/docs/distributions.md

@@ -0,0 +1,104 @@
+# Distributions and individual samples
+
+A histogram groups observations into bins; boxplots summarize quartiles;
+violins estimate a smooth density; swarms retain the individual values. State
+the sample population and any grouping or smoothing used.
+
+All values below are illustrative. Each snippet can be run independently with
+core Inklet; PNG preview generation additionally uses the `render` extra.
+
+## Histograms
+
+Histograms count observations within explicit bins.
+`density=True` divides by sample size and bin width so the bar area integrates
+to one. Use `inklet.plot.histogram` first when the counts should determine the
+y domain.
+
+```python
+import inklet as i
+values = [1, 1.2, 1.4, 1.9, 2.1, 2.4, 2.4, 2.8, 3, 3.2, 3.5, 4]
+p = i.plot_spec(x=(0, 5), y=(0, 6), height=45)
+p.hist(values, bins=[0, 1, 2, 3, 4, 5], colors='#527da8')
+p.axes(x='Duration / s', y='Count')
+doc = i.document(width=105)
+doc.add('hist', p)
+doc.save('hist.svg', 'hist.pdf')
+```
+
+![Histograms: Histograms count observations within explicit bins.](assets/guides/plots-hist.png)
+
+*Rendered from the code above.*
+
+## Boxplots
+
+Boxplots show the median, quartiles and Tukey whiskers.
+Whiskers stop at the furthest observation within `whisker` times the interquartile
+range. More distant observations are shown separately by default.
+
+```python
+import inklet as i
+samples = {'A': [1, 2, 2.2, 2.5, 3, 3.2, 4, 7.5],
+           'B': [2, 3, 3.5, 4, 4.2, 4.5, 5, 6]}
+p = i.plot_spec(x=['A', 'B'], y=(0, 8), height=45)
+p.boxplot(samples, colors=['#527da8', '#b96932'])
+p.axes(y='Measurement / a.u.')
+doc = i.document(width=105)
+doc.add('boxplot', p)
+doc.save('boxplot.svg', 'boxplot.pdf')
+```
+
+![Boxplots: Boxplots show the median, quartiles and Tukey whiskers.](assets/guides/plots-boxplot.png)
+
+*Rendered from the code above.*
+
+## Violins
+
+Violins show a kernel-smoothed sample distribution.
+The default bandwidth follows Silverman’s robust rule; `bandwidth`, `cut` and
+`samples` control smoothing and drawing extent. For small groups, showing the
+individual observations can reveal more than a smooth outline.
+
+```python
+import inklet as i
+import math
+samples = {'A': [3 + math.sin(k * .6) + .2 * math.cos(k) for k in range(48)],
+           'B': [5 + 1.5 * math.sin(k * .8) for k in range(48)]}
+p = i.plot_spec(x=['A', 'B'], y=(0, 9), height=45)
+p.violin(samples, colors=['#527da8', '#b96932'], cut=1.5)
+p.axes(y='Measurement / a.u.')
+doc = i.document(width=105)
+doc.add('violin', p)
+doc.save('violin.svg', 'violin.pdf')
+```
+
+![Violins: Violins show a kernel-smoothed sample distribution.](assets/guides/plots-violin.png)
+
+*Rendered from the code above.*
+
+## Swarms
+
+Swarms show every observation, including repeated values.
+Only the sideways placement changes to separate markers. The measured value
+stays fixed. `size` is marker diameter in millimetres; crowded groups may need
+more panel width or smaller markers.
+
+```python
+import inklet as i
+samples = {'A': [1.8, 2, 2, 2.1, 2.5, 3, 3.1, 4],
+           'B': [3, 3.1, 3.1, 3.3, 3.5, 4, 4.2, 5]}
+p = i.plot_spec(x=['A', 'B'], y=(0, 6), height=45)
+p.swarm(samples, size=1.5, colors=['#527da8', '#b96932'])
+p.axes(y='Measurement / a.u.')
+doc = i.document(width=105)
+doc.add('swarm', p)
+doc.save('swarm.svg', 'swarm.pdf')
+```
+
+![Swarms: Swarms show every observation, including repeated values.](assets/guides/plots-swarm.png)
+
+*Rendered from the code above.*
+
+## Next steps
+
+[Compare plot types](plot-types.md), configure [axes and scales](axes-and-scales.md),
+or [arrange several panels](layout.md). For exact options, see the [API](api.md).

inklet-4.0.0.dev4/docs/index.md

@@ -0,0 +1,27 @@
+---
+layout: home
+title: Overview
+---
+## Find the right guide
+
+| You want to… | Start here |
+|---|---|
+| Choose a plot for your data | [Visual plot gallery](plot-types.md) |
+| Combine marks, legends and insets | [Plotting](plotting.md) |
+| Set scales, tick labels and fonts | [Axes, scales and text](axes-and-scales.md) |
+| Share data, colours and units | [Live data](data.md) |
+| Draw measured components and connections | [Diagrams](diagrams.md) |
+| Add images, meshes or Blender scenes | [3D and images](three-images.md) |
+| Build an offline interactive report | [Interactive documents (4.0 preview)](interactive-documents.md) |
+| Work with microscopy data | [Calibrated volumes (preview)](calibrated-volumes.md) |
+
+## Reference and development
+
+Use the [Python API](api.md) for signatures, the [command-line reference](cli.md)
+for script workflows and [troubleshooting](troubleshooting.md) for diagnostics.
+[Migration](migration.md) covers existing projects.
+
+Core guides work with the stable release. Features marked **preview** require
+[the development installation](development-preview.md). Engine studies and
+historical designs are grouped under Development; see the [4.0 roadmap](roadmap.md)
+and [contributing guide](../CONTRIBUTING.md) to follow or contribute to that work.

{inklet-4.0.0.dev3 → inklet-4.0.0.dev4}/docs/installation.md

@@ -3,7 +3,7 @@
 Inklet requires Python 3.11 or later and an installed TrueType/OpenType font.
 The core Python dependencies are HarfBuzz bindings and fontTools.
 
-This page covers stable **Inklet 3.1** and the opt-in **4.0.0.dev3 preview**. See the
+This page covers stable **Inklet 3.1** and the opt-in **4.0.0.dev4 preview**. See the
 [compatibility matrix](compatibility.md) for tested platforms and Blender versions.
 
 ## From PyPI
@@ -24,9 +24,9 @@ Activate the environment or prefix commands with `.venv/bin/` on Linux/macOS.
 ## 4.0 development preview
 
 ```sh
-python -m pip install "inklet==4.0.0.dev3"
+python -m pip install "inklet==4.0.0.dev4"
 # Optional rendering and DataFrame adapters:
-python -m pip install "inklet[render,pandas,polars]==4.0.0.dev3"
+python -m pip install "inklet[render,pandas,polars]==4.0.0.dev4"
 ```
 
 Use a separate virtual environment when trying the preview. Experimental APIs

inklet-4.0.0.dev4/docs/interactive-documents.md

@@ -0,0 +1,52 @@
+# Interactive documents
+
+The **4.0 development preview** adds offline HTML exploration and reproducible
+visual editing. Install the [preview version](development-preview.md) explicitly;
+`pip install inklet` still selects the stable release.
+
+![A regional report linking a map, time series, distribution and category panels](assets/v4/regional-report.png)
+
+## Choose a workflow
+
+| You want to… | Start here | What stays reproducible |
+| --- | --- | --- |
+| Inspect, pan and zoom a native figure | [Compiled-scene viewer](compiled-viewer.md) | Native vector export and the compiled snapshot |
+| Select and filter observations across plots | [Linked plots](linked-plots.md) | Stable row IDs and a saved selection/view state |
+| Build category panels or time series | [Facets](linked-facets.md), [dates and time series](time-series.md) | Category order, missing-value gaps and shared selection |
+| Join a regional map to values | [Linked maps](linked-maps.md) | Explicit geometry keys, bins and source attribution |
+| Display distributions or supplied intervals | [Linked statistics](statistical-views.md) | Stated methods, reference populations and interval meaning |
+| Edit plot appearance in the browser | [Visual editing](visual-editing.md) | Versioned overrides, undo/redo and Python reconstruction |
+| Replace source data | [Data revisions](data-revisions.md) | Explicit missing-ID policy and a revision report |
+
+## Run a complete report
+
+Start with the [regional report](regional-report.md): a real map with simulated
+measurements, linked histories, an ECDF and faceted comparisons. It exercises
+selection, filtering, save/reopen, source replacement and exports at two widths.
+
+```bash
+python examples/v4/regional_report.py --renderer compiled --editor --output out/regional
+```
+
+Open the generated `index.html`. Save the view for selection/filter/zoom and
+save overrides for edited styles. Keep both files with the matching source
+recipe and data revision. The [visual editing guide](visual-editing.md) shows
+how to rebuild the same appearance in Python.
+
+For other data, follow the [engineering report](engineering-report.md),
+[calibrated image measurements](scientific-report.md), [mesh fields](mesh-fields.md)
+or [contours and streamlines](contours-streamlines.md). Optional
+[pandas and Polars adapters](table-inputs.md) preserve explicit row identities.
+
+## Know the boundary
+
+Standalone pages embed their supported operations and assets. They need no
+Python server or CDN to use those controls. Arbitrary Python callbacks do not
+run inside the exported HTML. Source replacement in the browser switches among
+precompiled alternatives; CSV processing and fresh compilation happen in Python.
+
+A native compiled viewer does not automatically infer row relationships for
+arbitrary scene objects. Linked figures declare those correspondences explicitly.
+The first style editor covers named colours, marker radii and line widths;
+label/panel/camera editing remains open. Read the feature guide's limits before
+relying on an experimental API or saved-state schema.