tickup 1.0.34 → 1.0.35

package/documentation/11-exports-and-advanced.md

@@ -1,20 +1,24 @@
 # Public exports & advanced topics
 
-Published API is split across **`tickup`** (default) and **`tickup/full`**. Symbols not listed here are **internal** (not semver-stable as public API).
+Published API is split across **`tickup`** and **`tickup/full`**. Undocumented deep imports are **not** semver-stable.
 
-## `tickup` (default — basic charts)
+## Standard Edition scope
+
+**TickUp Core** (this package) is the **Standard Edition**: Canvas 2D rendering, **2,000**-bar history cap, **1 Hz** live-update throttling on Standard shells, and **three** overlay indicators. Optional types and engine helpers in **`tickup/full`** exist for compatibility with advanced or commercial integrations; runtime behavior remains subject to Standard Tier guardrails unless you use a separate licensed Prime deployment.
+
+## `tickup` (default)
 
 | Export | Role |
 |--------|------|
-| `TickUpStage` | Chart + axes + toolbars (when enabled via props) + optional **compact symbol strip** when `showTopBar` is false and `symbol` / `defaultSymbol` is set + imperative handle. |
-| `TickUpMark` | DOM wordmark; **`TickUpThemeVariant`**: `light` \| `dark` \| `grey` — uses bundled **transparent** PNGs per variant. |
-| `TickUpAttribution` | DOM attribution strip (wordmark + legal line); theme follows props. |
-| `GlobalStyle` | Styled global CSS fragment (optional for hosts). |
+| `TickUpStage` | Chart + axes + optional toolbars + ref handle. |
+| `TickUpMark` | DOM wordmark (`light` \| `dark` \| `grey`). |
+| `TickUpAttribution` | Footer attribution strip. |
+| `GlobalStyle` | Optional global CSS fragment. |
 | `ModeProvider`, `useMode` | Drawing mode context. |
-| `ChartOptions`, `DeepRequired` | Configuration typing helpers. |
-| Plus | Intervals, live-data utils, overlays builders, drawing specs/factories/query helpers, snapshot helpers, graph math (`timeToX`, …), `ShapeType` & shape arg types, `IDrawingShape`, enums (`ChartType`, `AxesPosition`, overlay keys), branding types, **`TickUpPrime`** / **`TickUpStandardEngine`** / **`createTickUpPrimeEngine`** / **`getTickUpPrimeThemePatch`** / **`TickUpChartEngine`**, Prime palette constants. |
+| `ChartOptions`, `DeepRequired` | Configuration typing. |
+| Plus | Intervals, live-data utils, overlay builders, drawing helpers, snapshot helpers, graph math, enums, shape types. |
 
-## `tickup/full` (product shells + extended)
+## `tickup/full` (shells + extended)
 
 Everything in **`tickup`**, **plus**:
 
@@ -22,129 +26,65 @@ Everything in **`tickup`**, **plus**:
 
 | Export | Role |
 |--------|------|
-| `TickUpHost` | Full application shell (toolbar, settings, stage). |
-| `TickUpHost` | **Alias** of `TickUpHost`. |
-| `TickUpPulse` | Minimal product (plot + axes); symbol via compact strip when provided. |
-| `TickUpFlow` | Top bar, no drawing sidebar. |
-| `TickUpCommand` | Full trader UI. |
-| `TickUpDesk` | Same as Command; watermark on. |
-| `TickUpPrimeTier` | Licensed/eval shell: same chrome as Command; `productId: 'prime'`. |
-| `TickUpPrime`, `TickUpStandardEngine` | Engine profiles for **`setEngine`** / **`chartOptions.base.engine`**. **`TickUpPrime`** = dark Prime plot. |
-| `createTickUpPrimeEngine`, `getTickUpPrimeThemePatch` | **`'light' \| 'dark'`** Prime patches so the plot (and Prime **light glass** toolbars when `base.theme === 'light'`) match the host. |
-| `TICKUP_PRIME_PRIMARY`, `TICKUP_PRIME_SECONDARY`, `TICKUP_PRIME_TEXT` | Default Prime palette strings (hex / CSS color). |
-| `TickUpChartEngine` | Type for custom engines: `{ id, getChartOptionsPatch(): DeepPartial<ChartOptions> }`. |
-| `ChartStage` | **Deprecated** — use `TickUpStage`. |
-| `ShapePropertiesModal` | Shape property editor UI. |
-
-### Component prop / handle types (full)
-
-`TickUpHostProps`, `TickUpHostHandle`, `TickUpPulseProps`, `TickUpFlowProps`, `TickUpCommandProps`, `TickUpDeskProps`, `TickUpPrimeTierProps`, `TickUpStageProps`, `TickUpStageHandle`, `ChartStageProps`, `ChartStageHandle` (deprecated), `TickUpAttributionProps`, `ShapePropertiesFormState`, `ModalThemeVariant`, `TickUpThemeVariant`, `TickUpProductId`.
+| `TickUpHost` | Full shell: toolbar, settings, stage. |
+| `TickUpPulse`, `TickUpFlow`, `TickUpCommand`, `TickUpDesk` | Product layouts. |
+| `TickUpPrimeTier` | Prime product evaluation / licensed shell (`productId: 'prime'`). |
+| `ShapePropertiesModal` | Shape property editor. |
 
-## Context
+### Engine profiles (optional)
 
-| Export | Role |
-|--------|------|
-| `ModeProvider` | Wraps tree so drawing toolbar modes work. |
-| `useMode` | Access `{ mode, setMode }` inside provider. |
+Exports such as **`TickUpStandardEngine`**, **`TickUpChartEngine`**, and related symbols allow merging patches via **`setEngine`**. Standard Tier limits still apply in this open-source runtime unless paired with a licensed Prime backend.
 
-The **`Mode` enum** is exported from **`tickup`** and **`tickup/full`** (used by the drawing toolbar and **`setInteractionMode`**). Hosts can still prefer **`DrawingSpec`** + ref APIs for programmatic shapes.
+### Types
 
-## Core data types
+`TickUpHostProps`, `TickUpHostHandle`, product prop types, `TickUpStageProps`, `TickUpStageHandle`, `TickUpAttributionProps`, `TickUpProductId`, etc.
 
-| Export | Role |
-|--------|------|
-| `Interval` | OHLCV bar. |
-| `TimeRange`, `VisibleViewRanges`, `ChartDimensionsData` | Time window; **visible time + price snapshot** (`getVisibleRanges()`); layout metrics. |
-| `LiveDataPlacement`, `LiveDataApplyResult` | Live merge contract. |
-| `ChartContextInfo` | `getChartContext()` snapshot. |
-| `TickUpProductId` | Product id union — **`tickup/full` only**: `pulse` \| `flow` \| `command` \| `desk` \| `prime`. |
+## Context
 
-## Chart configuration types
+`ModeProvider`, `useMode`, exported **`Mode`** enum.
 
-| Export | Role |
-|--------|------|
-| `ChartType`, `TimeDetailLevel` | Chart mode & axis tick density. |
-| `AxesPosition` | Y-axis left/right. |
-| `OverlayWithCalc`, `OverlaySeries`, `OverlayOptions` | Indicator configuration. |
-| `OverlayKind`, `OverlayPriceKey` | Enum keys for overlays. |
+## Data & config types
+
+`Interval`, `TimeRange`, `VisibleViewRanges`, `LiveDataPlacement`, `LiveDataApplyResult`, `ChartContextInfo`, `ChartType`, `TimeDetailLevel`, `AxesPosition`, overlay types.
 
 ## Drawings
 
-| Export | Role |
-|--------|------|
-| `ShapeType` | String enum for spec `type`. |
-| `ShapeBaseArgs`, `Drawing` | Internal drawing description types. |
-| `DrawingSpec`, `DrawingPatch`, `DrawingInput` | Spec / patch / instance union for APIs. |
-| `drawingFromSpec`, `applyDrawingPatch`, `isDrawingPatch` | Build & merge helpers. |
-| `DrawingSnapshot`, `DrawingQuery`, `DrawingWithZIndex` | Query & serialization. |
-| `shapeToSnapshot`, `queryDrawingsToSnapshots`, `filterDrawingInstances`, `filterDrawingsWithMeta` | Snapshot pipelines. |
-| `IDrawingShape` | Instance interface. |
-| `LineShapeArgs`, `RectangleShapeArgs`, … `CustomSymbolShapeArgs` | Per-shape argument types. |
-| **Shape classes** | `LineShape`, `RectangleShape`, … — advanced/tests; **`tickup/full` only**. |
-| `generateDrawingShapeId` | Id factory. |
+`ShapeType`, `DrawingSpec`, `DrawingPatch`, factories, query helpers, `IDrawingShape`, shape classes (**`tickup/full`**).
 
 ## Overlay builders
 
-| Export | Role |
-|--------|------|
-| `OverlaySpecs`, `withOverlayStyle`, `overlay` | Build `OverlayWithCalc` entries. |
-
-Details: [Overlays & indicators](./12-overlays-and-indicators.md).
-
-## Live data utilities
-
-| Export | Role |
-|--------|------|
-| `applyLiveDataMerge` | Same merge as ref `applyLiveData` (pure function). |
-| `normalizeInterval`, `normalizeIntervals` | Validate/clamp bars. |
-| `dedupeByTimePreferLast` | Collapse duplicate timestamps. |
-
-## Snapshot / export helpers
-
-| Export | Role |
-|--------|------|
-| `captureChartRegionToPngDataUrl` | Rasterize a DOM region. |
-| `buildChartSnapshotFileName`, `sanitizeChartSnapshotToken`, `contrastingFooterTextColor` | Filename & contrast helpers. |
-| `ChartSnapshotMeta` | Metadata type for snapshots. |
+`OverlaySpecs`, `withOverlayStyle`, `overlay` — see [Overlays & indicators](./12-overlays-and-indicators.md).
 
-## Graph math (coordinate helpers)
+## Live data
 
-`timeToX`, `xToTime`, `priceToY`, `yToPrice`, `interpolatedCloseAtTime`, `lerp`, `xFromCenter`, `xFromStart` — align custom logic with chart scales.
+`applyLiveDataMerge`, `normalizeInterval`, `normalizeIntervals`, `dedupeByTimePreferLast`.
 
-## Not exported (internal)
+## Snapshot / export
 
-Examples: `FormattingService`, `deepMerge`, `deepEqual`, toolbar `Tooltip`, most styled wrappers. Do not import these from deep paths in apps if you want upgrade safety.
+`captureChartRegionToPngDataUrl`, filename helpers, `ChartSnapshotMeta`.
 
-## `TickUpStage` usage sketch
+## Graph math
 
-Wrap with **`ModeProvider`**. Pass **all** required `TickUpStageProps` from TypeScript (intervals, `chartOptions`, tick count, `timeDetailLevel`, `timeFormat12h`, selection state, chart-type handler, settings opener, toolbar flags, etc.). Many hosts use a **product component** or **`TickUpHost`** from **`tickup/full`** instead of wiring `TickUpStage` alone.
+`timeToX`, `xToTime`, `priceToY`, `yToPrice`, etc.
 
-## Init process (summary)
+## `TickUpStage` usage
 
-1. Mount product or `TickUpHost` / `TickUpStage`.  
-2. Merge `chartOptions` with defaults (stable prop reference recommended).  
-3. Load `intervalsArray`; derive visible time and price ranges.  
-4. Allocate canvases; draw grid, session shading, series, histogram, watermark, overlays (if enabled), drawings.  
-5. After mount, the **ref** is non-null — run imperative calls in `useEffect` or callbacks. **`getViewInfo()` / `getChartContext()`** may still return **`null`** until the inner stage is ready; use optional chaining or retry briefly (see the [`example/`](../example/) app for patterns).
+Wrap with **`ModeProvider`**. Pass required `TickUpStageProps` from TypeScript. Most apps use **`TickUpHost`** or a **product** component instead.
 
-## Updating (summary)
+## Init / update (summary)
 
-| Concern | Mechanism |
-|---------|-----------|
-| Series | `intervalsArray` or `applyLiveData` / `addInterval` / index update |
-| Styles | `chartOptions` (deep merge on real changes) or Settings modal |
-| Drawings | Toolbar, or `addShape` / `updateShape` / `patchShape` / `setDrawingsFromSpecs` |
-| View | Pan/zoom, `fitVisibleRangeToData`, `redrawCanvas`, `reloadCanvas` |
-| Theme | **`themeVariant` / `defaultThemeVariant` / `onThemeVariantChange`** on **`TickUpHost`** + `chartOptions.base.theme` (and Prime helpers above). |
+1. Mount host or stage.  
+2. Merge stable `chartOptions`.  
+3. Load `intervalsArray` (clamped by Standard Tier).  
+4. Canvases draw grid, series, histogram, watermark, overlays, drawings.  
+5. Ref APIs: use `useEffect` / callbacks; **`getViewInfo()`** may be **`null`** until ready.
 
 ## Deprecated
 
-- `ChartStage`, `ChartStageProps`, `ChartStageHandle` → use `TickUpStage*`.
-
-### Pro Tip
+`ChartStage` → use `TickUpStage`.
 
-Build on core exports first, then adopt Prime engine helpers to add premium behavior while preserving your existing API integration.
+---
 
-### Prime Showcase
+## Tier comparison: TickUp Prime
 
-[Explore the TickUp Prime Showcase](https://bardamri.github.io/tickup-charts/)
+**[TickUp Prime](https://github.com/BARDAMRI/tickup-prime)** documents the commercial WebGL product, unlimited studies, and enterprise integrations. **[Showcase](https://bardamri.github.io/tickup-charts/)**

package/documentation/12-overlays-and-indicators.md

@@ -1,23 +1,21 @@
 # Overlays and indicators
 
-Technical indicator lines are drawn **on top of** the main series when overlays are enabled in chart options.
+Indicator lines draw **on top of** the main series when overlays are enabled.
 
-## Enable drawing
+## Standard Tier guardrails
 
-Set **`base.showOverlayLine`** to `true` (via `chartOptions` or defaults). Style defaults for stroke live under **`base.style.overlay`** (`lineColor`, `lineWidth`, `lineStyle`: solid | dashed | dotted).
+- **Count** — At most **three** simultaneous overlay studies. Requesting more triggers a toast and options are capped (see host behavior).  
+- **Data window** — Calculations use the same **2,000**-bar window as the chart (see [Data & live updates](./07-data-and-live-updates.md)).
 
-## Two configuration styles
+## Enable drawing
 
-### 1. `base.overlays` — full control (`OverlayWithCalc[]`)
+Set **`base.showOverlayLine`** to `true`. Styles live under **`base.style.overlay`** (`lineColor`, `lineWidth`, `lineStyle`).
 
-Each entry combines:
+## Configuration styles
 
-- **Style** — line color, width, style (merged with defaults).  
-- **`calc`** — an `OverlayCalcSpec` describing the math (see below).  
-- **`connectNulls`** (optional) — draw through gaps in computed values (default true in helpers).  
-- **`useCenterX`** (optional) — plot at bar center vs edge (default true in helpers).
+### 1. `base.overlays` — `OverlayWithCalc[]`
 
-Build entries with exported helpers:
+Each entry: **style**, **`calc`** (`OverlayCalcSpec`), optional **`connectNulls`**, **`useCenterX`**.
 
 ```ts
 import {
@@ -37,37 +35,34 @@ const overlays: OverlayWithCalc[] = [
 
 ### 2. `base.overlayKinds` — shorthand
 
-An array of **`OverlayKind`** string keys (or calc specs in the type definition; the renderer maps kinds through the same `overlay()` factory with **default periods**, e.g. SMA/EMA/WMA period 20, Bollinger period 20 / stddev 2). Useful for quick demos; prefer **`overlays`** for explicit periods and prices.
+Array of **`OverlayKind`** keys with library default parameters. Prefer **`overlays`** for explicit periods.
 
 ## Calculation kinds (`OverlayCalcSpec`)
 
 | Kind | Role |
 |------|------|
-| `OverlayPriceKey` (`close`, `open`, `high`, `low`) | Raw price series. |
-| `sma`, `ema`, `wma` | Moving averages; `period` + optional `price` key. |
-| `vwap` | Volume-weighted average price (uses interval volume when present). |
-| `bbands_mid`, `bbands_upper`, `bbands_lower` | Bollinger mid/upper/lower; `period`, optional `stddev`, optional `price`. |
+| `OverlayPriceKey` | Raw price series (`close`, `open`, `high`, `low`). |
+| `sma`, `ema`, `wma` | Moving averages; `period` + optional `price`. |
+| `vwap` | In **TickUp Core**, the VWAP slot does **not** compute a series (no line drawn). Use other overlays for analysis in Standard Edition. |
+| `bbands_*` | Bollinger bands; `period`, optional `stddev`, optional `price`. |
 
-## Exported API (from `tickup`)
+## Exported API (`tickup`)
 
 | Export | Role |
 |--------|------|
-| `OverlaySpecs` | Factory for calc specs. |
-| `withOverlayStyle` | Curried builder: shared style → many overlays. |
-| `overlay(kindOrSpec?, style?, extras?)` | Single `OverlayWithCalc` with defaults. |
+| `OverlaySpecs` | Calc factories. |
+| `withOverlayStyle` | Shared style → many overlays. |
+| `overlay(...)` | Single `OverlayWithCalc` with defaults. |
 | `OverlayKind`, `OverlayPriceKey` | Enums. |
-| Types: `OverlayWithCalc`, `OverlaySeries`, `OverlayOptions` | Typing and advanced use. |
 
-Lower-level functions such as `computeSeriesBySpec`, `drawOverlays`, `drawOverlay` exist in source for maintainers; the **supported host integration path** is configuring **`chartOptions.base.overlays`** / **`overlayKinds`** and **`showOverlayLine`**.
+Lower-level functions (`computeSeriesBySpec`, …) exist for maintainers; hosts should configure **`chartOptions`**.
 
 ## Chart types
 
-Overlays are wired in **candlestick**, **line**, **area**, and **bar** draw paths when `showOverlayLine` is true.
-
-### Pro Tip
+Overlays apply to candlestick, line, area, and bar when `showOverlayLine` is true.
 
-Prime indicator packs are designed for desks that need richer multi-study analysis than the standard open-source baseline.
+---
 
-### Prime Showcase
+## Tier comparison: TickUp Prime
 
-[Explore the TickUp Prime Showcase](https://bardamri.github.io/tickup-charts/)
+**TickUp Prime** includes expanded indicator and analysis features. **TickUp Core** provides the overlay system and limits above. **[TickUp Prime](https://github.com/BARDAMRI/tickup-prime)** · **[Showcase](https://bardamri.github.io/tickup-charts/)**

package/documentation/13-internationalization-and-axes.md

@@ -2,63 +2,53 @@
 
 ## Locale and language
 
-Axis labels, dates, and many settings strings follow **`chartOptions.base.style.axes`**:
+Axis labels and many strings follow **`chartOptions.base.style.axes`**:
 
 | Field | Role |
 |-------|------|
-| `locale` | BCP 47 tag (e.g. `en-US`, `he-IL`). Drives date/number formatting and default direction. |
-| `language` | UI language key for built-in labels (toolbar tooltips, settings, etc.). |
+| `locale` | BCP 47 tag (e.g. `en-US`, `he-IL`). |
+| `language` | UI language key for built-in labels. |
 
-The in-app **Settings → Regional** category updates these fields. The library ships multiple locale presets (decimal/thousands separators, date patterns, default currency, **RTL** vs LTR) in internal locale tables.
+**Settings → Regional** updates these fields. The library ships locale presets (separators, date patterns, default currency, **RTL** vs LTR).
 
 ### RTL
 
-When the active locale defaults specify `direction: 'rtl'`, toolbar and settings layout flip appropriately (`dir` on toolbars/modals).
+When the active locale specifies `direction: 'rtl'`, toolbar and modal layout flip (`dir` on containers).
 
 ## Numeric and currency display
 
-Axes support:
-
-- Fraction digits, min/max significant digits, `tickSize`, `autoPrecision`  
-- `currency`, `useCurrency`, `currencyDisplay`  
-- `numberNotation`: `standard` | `scientific` | `compact`  
-- `unit` / `unitPlacement`  
-- Optional **`displayCurrency`** / **`conversionRate`** for converted display (host-defined semantics)
+Axes support fraction digits, significant digits, `tickSize`, `autoPrecision`, `currency`, `useCurrency`, `currencyDisplay`, `numberNotation`, `unit` / `unitPlacement`, optional **`displayCurrency`** / **`conversionRate`** (host-defined).
 
 ## Time axis
 
-- **`timezone`** — string such as `UTC` or `America/New_York` for session logic and labeling where used.  
-- **`dateFormat`** — pattern consumed by the formatting layer.  
-- Shell prop **`initialTimeFormat12h`** and settings **12-hour toggle** affect time presentation.  
-- **`TimeDetailLevel`** (`Auto` / `Low` / `Medium` / `High`) controls tick density (prop `initialTimeDetailLevel`).
+- **`timezone`** — e.g. `UTC`, `America/New_York`.  
+- **`dateFormat`** — formatting pattern.  
+- **`initialTimeFormat12h`** and settings toggle — 12h vs 24h.  
+- **`TimeDetailLevel`** — tick density (`initialTimeDetailLevel`).
 
 ## Trading sessions and holidays
 
-`axes` options include:
-
-- **`tradingSessions`** — array of `{ dayOfWeek, start, end }` with `start`/`end` as `'HH:mm'` strings; used to **shade off-session** periods on the chart.  
-- **`holidays`** — ISO `YYYY-MM-DD` strings for calendar context (where integrated).  
-- **`exchange`** — display/metadata string.
+- **`tradingSessions`** — `{ dayOfWeek, start, end }` with `HH:mm`; **shades** off-session periods.  
+- **`holidays`** — ISO `YYYY-MM-DD` where integrated.  
+- **`exchange`** — display/metadata.
 
 ## Grid and background
 
-- **`base.style.showGrid`** — toggles grid lines (`grid` sub-style: colors, dash, spacing).  
-- **`base.style.backgroundColor`** — plot background.
+- **`base.style.showGrid`**  
+- **`base.style.backgroundColor`**
 
 ## Y axis layout
 
-- **`axes.yAxisPosition`** — `AxesPosition.left` or `.right`.  
-- **`axes.numberOfYTicks`** — count (also `initialNumberOfYTicks` on the shell).  
-- **`initialYAxisWidth`** / **`initialXAxisHeight`** — layout hints passed into the stage.
-
-## Clipboard (shell behavior)
+- **`axes.yAxisPosition`** — left or right.  
+- **`axes.numberOfYTicks`**  
+- **`initialYAxisWidth`** / **`initialXAxisHeight`**
 
-When users copy selected text, the host shell may **normalize** numbers to a canonical plain form using the same axis parsing rules (implemented inside the chart app wrapper). This is a UX nicety for spreadsheets, not a separate public API export.
+## Clipboard (shell)
 
-### Pro Tip
+Copying selected text may normalize numbers for spreadsheets (formatting integration).
 
-TickUp Prime is the right upgrade path for teams that need production-grade multilingual interfaces with advanced layout and rendering requirements.
+---
 
-### Prime Showcase
+## Tier comparison: TickUp Prime
 
-[Explore the TickUp Prime Showcase](https://bardamri.github.io/tickup-charts/)
+Commercial Prime offerings may bundle additional locale or layout packages. **TickUp Core** behavior is as documented above. **[TickUp Prime](https://github.com/BARDAMRI/tickup-prime)** · **[Showcase](https://bardamri.github.io/tickup-charts/)**

package/documentation/14-legal-and-policies.md

@@ -1,10 +1,10 @@
 # Legal and policies
 
-TickUp ships as **open-source software** (see the **LICENSE** file in the repository root when present) and may also be described, demoed, or offered through **websites, accounts, or hosted services**. **Legal terms for those offerings**—including intellectual property, acceptable use, suspension or termination of access, privacy, and standard limitations of liability—are maintained as **templates** in the repository for you to customize with your lawyer.
+**TickUp Core** is **open-source software** (see the **LICENSE** file in the repository root). Hosted demos or commercial offerings may use separate terms.
 
 ## Where to read the documents
 
-Policy templates ship **next to** this folder in the npm package (`node_modules/tickup/legal/`) and in the Git clone. All files live under **[`../legal/`](../legal/)**:
+Policy templates ship next to this folder in the npm package (`node_modules/tickup/legal/`) and in the Git clone under **[`../legal/`](../legal/)**:
 
 | Document | File |
 |----------|------|
@@ -13,28 +13,26 @@ Policy templates ship **next to** this folder in the npm package (`node_modules/
 | **Privacy Policy** | [`../legal/PRIVACY_POLICY.md`](../legal/PRIVACY_POLICY.md) |
 | **Acceptable Use Policy** | [`../legal/ACCEPTABLE_USE_POLICY.md`](../legal/ACCEPTABLE_USE_POLICY.md) |
 
-## What the Terms of Service cover (summary)
+## Terms of Service (summary)
 
-The Terms of Service template is written so you can:
+The Terms template helps you:
 
-- **Retain ownership** of TickUp branding, product, documentation, and proprietary parts of the Services.
-- **Suspend or terminate** user access, change or discontinue features, and refuse service where appropriate, subject to applicable law and any stricter promises you make elsewhere.
-- Use **standard protections**: disclaimers of warranty, caps on liability, indemnity where appropriate, governing law and venue placeholders, and rules for changes to the terms.
+- **Retain ownership** of branding, product, and documentation.  
+- **Suspend or terminate** access where appropriate, subject to law.  
+- Use **standard protections**: warranty disclaimers, liability caps, indemnity, governing law placeholders.
 
-**Open-source code** released under the repo **LICENSE** is called out separately so the license for that code and the Terms for hosted products can coexist without confusion.
+**Open-source code** under the repo **LICENSE** is called out separately from terms for hosted products.
 
 ## Not legal advice
 
-These markdown files are **starting points**, not a substitute for counsel. Replace all bracketed placeholders (`[Legal Entity Name]`, `[Contact Email]`, `[Jurisdiction]`, etc.) and adapt clauses for your entity, products, and regions before publication.
+These files are **starting points**. Replace bracketed placeholders and adapt with qualified counsel before publication.
 
 ## Older stub
 
-A short legacy note lives in the repo under **`docs/Documentation/Terms_of_Use.md`** (that tree is **not** bundled on npm). [View on GitHub](https://github.com/BARDAMRI/TickUp/blob/main/docs/Documentation/Terms_of_Use.md) — it points here and to **`legal/`**.
+A legacy note may live under **`docs/Documentation/Terms_of_Use.md`** (not bundled on npm).
 
-### Pro Tip
+---
 
-Commercial Prime deployments should always pair technical rollout with the appropriate legal terms and policy templates for hosted services.
+## Tier comparison: TickUp Prime
 
-### Prime Showcase
-
-[Explore the TickUp Prime Showcase](https://bardamri.github.io/tickup-charts/)
+Commercial **TickUp Prime** subscriptions should use counsel-approved terms for billing and support. OSS **LICENSE** terms govern this Core package. **[TickUp Prime](https://github.com/BARDAMRI/tickup-prime)**

package/documentation/README.md

@@ -1,41 +1,40 @@
-# TickUp Charts documentation
+# TickUp Core documentation
 
-Complete guides for integrating and operating the TickUp Charts React charting library.
+Integration guides for **TickUp Core** (Standard Edition): the MIT open-source React charting library shipped as the **`tickup`** npm package.
 
-The **npm package** has **`tickup`** (default — `TickUpStage` and chart helpers) and **`tickup/full`** (e.g. `TickUpCommand`, `TickUpHost`, extended exports). Product-focused guides import from **`tickup/full`**.
+## Package entries
 
-Published tarballs **include this `documentation/` folder** and the sibling **`legal/`** policy templates (see root `package.json` **`files`**) so links in **[14-legal-and-policies.md](./14-legal-and-policies.md)** resolve under `node_modules/tickup/`. Type declarations ship in **`dist/*.d.ts`**. This documentation covers the open-source core package.
+- **`tickup`** — `TickUpStage`, types, overlays, live-data helpers, and drawing utilities.
+- **`tickup/full`** — Product shells (`TickUpCommand`, `TickUpHost`, …), extended exports, and optional engine profile types for advanced setups.
 
-The **reference example app** in [`../example/`](../example/) (Vite + React) exercises all product tiers, `chartOptions`, the compact symbol strip on Pulse, host symbol callbacks, and the imperative ref API; see [`../example/README.md`](../example/README.md). The example app itself is **not** published to npm.
+Published tarballs include this **`documentation/`** folder and sibling **`legal/`** templates (see root **`package.json`** **`files`**). Type declarations ship under **`dist/*.d.ts`**.
+
+The **example app** in [`../example/`](../example/) (Vite + React) demonstrates hosts, `chartOptions`, and the imperative ref API; it is **not** published to npm.
 
 ## Contents
 
 | # | Guide | Description |
 |---|--------|-------------|
-| 1 | [Introduction](./01-introduction.md) | Overview, package scope, and Prime upgrade path |
-| 2 | [Glossary](./01-glossary.md) | Terms: intervals, ranges, products, placements, etc. |
-| 3 | [Installation](./02-installation.md) | Peer dependencies, package install, styled-components |
-| 4 | [Quick start](./03-quick-start.md) | Minimal embed, ref, controlled data |
-| 5 | [Products & layout](./04-products-and-layout.md) | Pulse, Flow, Command, Desk; toolbars (public line) |
-| 6 | [Props & chart options](./05-props-and-chart-options.md) | `TickUpHost`, `chartOptions`, shell theme + chart theme |
-| 7 | [Imperative API](./06-imperative-api.md) | Ref handle: shapes, data, **`getVisibleRanges()`**, **`getCanvasSize()`**, view, context |
-| 8 | [Data & live updates](./07-data-and-live-updates.md) | `intervalsArray`, `applyLiveData`, merge helpers |
-| 9 | [Drawings & shapes](./08-drawings-and-shapes.md) | Toolbar tools, select/edit, programmatic shapes & patches |
-| 10 | [Settings modal](./09-settings-modal.md) | In-app settings categories and persistence |
-| 11 | [Toolbar & interactions](./10-toolbar-and-interactions.md) | Chart type, snapshot, crosshair, tooltip, pan/zoom |
-| 12 | [Exports & advanced](./11-exports-and-advanced.md) | Full export list, `TickUpStage`, branding, init/update |
-| 13 | [Overlays & indicators](./12-overlays-and-indicators.md) | SMA/EMA/VWAP/Bollinger, `overlays` / `overlayKinds` |
-| 14 | [i18n & axes](./13-internationalization-and-axes.md) | Locale, RTL, currency, sessions, grid |
-| 15 | [Legal & policies](./14-legal-and-policies.md) | Terms of Service, Privacy, Acceptable Use templates (`legal/`) |
-
-## Older material
-
-Additional notes and legacy pages may still live under [`../docs/`](../docs/) (roadmap, contributing, design). The **authoritative integration reference** is this `documentation/` folder.
-
-### Pro Tip
-
-Use this docs hub for core integration, then evaluate TickUp Prime for teams that require premium rendering profiles and commercial-grade analysis workflows.
-
-### Prime Showcase
-
-[Explore the TickUp Prime Showcase](https://bardamri.github.io/tickup-charts/)
+| 1 | [Introduction](./01-introduction.md) | Scope of TickUp Core (Standard Tier) |
+| 2 | [Glossary](./01-glossary.md) | Intervals, ranges, products, placements |
+| 3 | [Installation](./02-installation.md) | Peers, install, bundlers |
+| 4 | [Quick start](./03-quick-start.md) | Minimal embed and data flow |
+| 5 | [Products & layout](./04-products-and-layout.md) | Pulse, Flow, Command, Desk |
+| 6 | [Props & chart options](./05-props-and-chart-options.md) | `TickUpHost`, `chartOptions` |
+| 7 | [Imperative API](./06-imperative-api.md) | Ref handle: data, view, drawings |
+| 8 | [Data & live updates](./07-data-and-live-updates.md) | `intervalsArray`, `applyLiveData`, guardrails |
+| 9 | [Drawings & shapes](./08-drawings-and-shapes.md) | Toolbar tools and programmatic shapes |
+| 10 | [Settings modal](./09-settings-modal.md) | In-app settings categories |
+| 11 | [Toolbar & interactions](./10-toolbar-and-interactions.md) | Symbol strip, pan/zoom, snapshot |
+| 12 | [Exports & advanced](./11-exports-and-advanced.md) | Public export surface |
+| 13 | [Overlays & indicators](./12-overlays-and-indicators.md) | Standard Tier overlays |
+| 14 | [i18n & axes](./13-internationalization-and-axes.md) | Locale, RTL, sessions |
+| 15 | [Legal & policies](./14-legal-and-policies.md) | Policy templates in `legal/` |
+
+Legacy notes may appear under [`../docs/`](../docs/). **Authoritative integration reference** is this folder.
+
+---
+
+## Tier comparison: TickUp Prime
+
+**TickUp Core** (this package) is the **Standard Edition**: Canvas 2D, a **2,000**-candle cap, **1 Hz** live-update throttling on Standard shells, and **three** overlay indicators. For WebGL rendering, unlimited history, and expanded tooling, see **[TickUp Prime](https://github.com/BARDAMRI/tickup-prime)** and the **[live showcase](https://bardamri.github.io/tickup-charts/)**.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickup",
-  "version": "1.0.34",
+  "version": "1.0.35",
   "description": "High-performance React financial charts. Canvas 2D rendering, advanced technical analysis tools, and real-time data streaming.",
   "type": "module",
   "main": "./dist/tickup.cjs.js",