@eightkk/vue-weave 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/CHANGELOG.md +42 -7
  2. package/CONTRIBUTING.md +13 -20
  3. package/README.ja.md +51 -37
  4. package/README.md +50 -36
  5. package/dist/{core-BH5rTsKp.js → core-C7J4FG_e.js} +5354 -2577
  6. package/dist/core.js +1 -1
  7. package/dist/index.js +6093 -3515
  8. package/dist/style.css +1 -1
  9. package/dist/types/components/EventCalendar.vue.d.ts +105 -0
  10. package/dist/types/components/GanttChart.vue.d.ts +15 -1
  11. package/dist/types/components/GraphPalette.vue.d.ts +38 -0
  12. package/dist/types/components/NetworkGraph.vue.d.ts +7 -1
  13. package/dist/types/components/PropertyInspector.vue.d.ts +41 -0
  14. package/dist/types/components/TaskBoard.vue.d.ts +72 -0
  15. package/dist/types/components/graphPalette.d.ts +12 -0
  16. package/dist/types/core/diagramEditor.d.ts +136 -0
  17. package/dist/types/core/earnedValue.d.ts +165 -0
  18. package/dist/types/core/eventCalendar.d.ts +214 -0
  19. package/dist/types/core/exportSvg.d.ts +8 -1
  20. package/dist/types/core/graph.d.ts +7 -2
  21. package/dist/types/core/graphCollapse.d.ts +1 -1
  22. package/dist/types/core/graphSwimlanes.d.ts +47 -0
  23. package/dist/types/core/index.d.ts +12 -0
  24. package/dist/types/core/interchange.d.ts +7 -0
  25. package/dist/types/core/interchangeDrawio.d.ts +60 -0
  26. package/dist/types/core/interchangeGraph.d.ts +153 -0
  27. package/dist/types/core/interchangeGraphMl.d.ts +32 -0
  28. package/dist/types/core/interchangeMermaid.d.ts +48 -0
  29. package/dist/types/core/sheetEditing.d.ts +36 -0
  30. package/dist/types/core/taskBoard.d.ts +150 -0
  31. package/dist/types/core/types.d.ts +49 -2
  32. package/dist/types/index.d.ts +44 -0
  33. package/docs/api.md +378 -0
  34. package/docs/architecture.md +6 -2
  35. package/docs/integration.md +180 -0
  36. package/docs/scheduling.md +31 -0
  37. package/docs/security.md +1 -0
  38. package/package.json +1 -1
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # Vue Weave
2
2
 
3
- [![CI](https://github.com/EightKK/vue-weave/actions/workflows/ci.yml/badge.svg)](https://github.com/EightKK/vue-weave/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/EightKK/vue-weave/blob/v1.0.0/LICENSE)
3
+ [![CI](https://github.com/EightKK/vue-weave/actions/workflows/ci.yml/badge.svg)](https://github.com/EightKK/vue-weave/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/EightKK/vue-weave/blob/v1.2.0/LICENSE)
4
4
 
5
- [日本語](https://github.com/EightKK/vue-weave/blob/v1.0.0/README.ja.md)
5
+ [日本語](https://github.com/EightKK/vue-weave/blob/v1.2.0/README.ja.md)
6
6
 
7
- [Source](https://github.com/EightKK/vue-weave) · [Issues](https://github.com/EightKK/vue-weave/issues) · [Releases](https://github.com/EightKK/vue-weave/releases)
7
+ [Interactive demo](https://eightkk.github.io/vue-weave/) · [Source](https://github.com/EightKK/vue-weave) · [Issues](https://github.com/EightKK/vue-weave/issues) · [Releases](https://github.com/EightKK/vue-weave/releases)
8
8
 
9
9
  Interactive network graphs and Gantt charts for Vue 3. Build relationship explorers, process flows, production views, project schedules and resource timelines from two typed components, and do the graph, scheduling and resource-load calculations in a headless core that also runs in Node.js, workers and on servers.
10
10
 
@@ -26,17 +26,17 @@ Import the stylesheet once, for example in your application's entry file:
26
26
  import '@eightkk/vue-weave/style.css'
27
27
  ```
28
28
 
29
- Vite handles this import as it is. If your `tsconfig.json` enables `noUncheckedSideEffectImports`, or your build has no CSS loader, see [The stylesheet and TypeScript](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#the-stylesheet-and-typescript).
29
+ Vite handles this import as it is. If your `tsconfig.json` enables `noUncheckedSideEffectImports`, or your build has no CSS loader, see [The stylesheet and TypeScript](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#the-stylesheet-and-typescript).
30
30
 
31
- **Core only (servers and Workers).** `@eightkk/vue-weave/core` runs without Vue at runtime, in Node.js 22.18+, Workers and on servers. Vue is still a required peer dependency (an optional peer is not configured), so `npm install @eightkk/vue-weave` installs Vue as well. To leave it out of a core-only deployment, install with `--omit=peer`. See [Core only: servers and Workers](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#core-only-servers-and-workers).
31
+ **Core only (servers and Workers).** `@eightkk/vue-weave/core` runs without Vue at runtime, in Node.js 22.18+, Workers and on servers. Vue is still a required peer dependency (an optional peer is not configured), so `npm install @eightkk/vue-weave` installs Vue as well. To leave it out of a core-only deployment, install with `--omit=peer`. See [Core only: servers and Workers](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#core-only-servers-and-workers).
32
32
 
33
- **Offline install.** Each [GitHub Release](https://github.com/EightKK/vue-weave/releases) also has the package tarball, the same file that is published to npm. Download `eightkk-vue-weave-1.0.0.tgz` and install it from your application's directory, replacing the example path with the actual one:
33
+ **Offline install.** Each [GitHub Release](https://github.com/EightKK/vue-weave/releases) also has the package tarball, the same file that is published to npm. Download `eightkk-vue-weave-1.2.0.tgz` and install it from your application's directory, replacing the example path with the actual one:
34
34
 
35
35
  ```sh
36
- npm install ./eightkk-vue-weave-1.0.0.tgz
36
+ npm install ./eightkk-vue-weave-1.2.0.tgz
37
37
  ```
38
38
 
39
- You can also [build a local package](https://github.com/EightKK/vue-weave/blob/v1.0.0/CONTRIBUTING.md#build-a-local-package) from a checkout.
39
+ You can also [build a local package](https://github.com/EightKK/vue-weave/blob/v1.2.0/CONTRIBUTING.md#build-a-local-package) from a checkout.
40
40
 
41
41
  ## Quick start
42
42
 
@@ -142,40 +142,40 @@ const activate = (event: ViewTargetEvent) => linked.select(event.target.view, [e
142
142
  </template>
143
143
  ```
144
144
 
145
- See [Linking views](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#linking-views) for hover, load rows and moving to collapsed items, and [Saving through a server](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#saving-through-a-server) for `useEditTransaction`.
145
+ See [Linking views](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#linking-views) for hover, load rows and moving to collapsed items, and [Saving through a server](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#saving-through-a-server) for `useEditTransaction`.
146
146
 
147
147
  ## Gallery
148
148
 
149
149
  All screenshots are from the [demo app](#run-the-demo) in this repository.
150
150
 
151
- ![NetworkGraph in the manufacturing demo: material, a split operation, two lots, a finishing operation and the product in a layered left-to-right layout](https://raw.githubusercontent.com/EightKK/vue-weave/v1.0.0/.github/images/network-graph.png)
151
+ ![NetworkGraph in the manufacturing demo: material, a split operation, two lots, a finishing operation and the product in a layered left-to-right layout](https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/network-graph.png)
152
152
 
153
- ![GanttChart in the scheduling demo: a calendar-aware schedule with a status date and progress line, critical-path outlines, float lines, split bars, a lead label, a deadline flag, Finish and Float columns, and a shaded plant closure day](https://raw.githubusercontent.com/EightKK/vue-weave/v1.0.0/.github/images/gantt-chart.png)
153
+ ![GanttChart in the scheduling demo: a calendar-aware schedule with a status date and progress line, critical-path outlines, float lines, split bars, a lead label, a deadline flag, Finish and Float columns, and a shaded plant closure day](https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/gantt-chart.png)
154
154
 
155
155
  <table>
156
156
  <tr>
157
157
  <td width="50%" valign="top">
158
- <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.0.0/.github/images/process-lanes.png" alt="Process lanes demo: a machining process in four department lanes (Purchasing, Machining, Inspection and an empty Shipping lane), with orthogonal hand-over edges crossing the lane boundaries and the lanes repeated in the minimap" width="100%"><br>
158
+ <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/process-lanes.png" alt="Process lanes demo: a machining process in four department lanes (Purchasing, Machining, Inspection and an empty Shipping lane), with orthogonal hand-over edges crossing the lane boundaries and the lanes repeated in the minimap" width="100%"><br>
159
159
  <b>Swimlanes.</b> One lane per department or work centre, in your order (<code>layoutSwimlaneGraph</code>, <code>lanes</code>).
160
160
  </td>
161
161
  <td width="50%" valign="top">
162
- <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.0.0/.github/images/quantity-flow.png" alt="Quantity flow demo: a Sankey diagram of a lot of 100 pieces that splits 60/40 between two lines, merges at inspection, loses 4 pieces on line B and loops 10 pieces through rework as a dashed band, with a table of inflow, outflow and difference per step" width="100%"><br>
162
+ <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/quantity-flow.png" alt="Quantity flow demo: a Sankey diagram of a lot of 100 pieces that splits 60/40 between two lines, merges at inspection, loses 4 pieces on line B and loops 10 pieces through rework as a dashed band, with a table of inflow, outflow and difference per step" width="100%"><br>
163
163
  <b>Quantity flows.</b> Edges drawn as bands as wide as their quantity, on one scale (<code>layoutFlowGraph</code>, <code>edgeBands</code>).
164
164
  </td>
165
165
  </tr>
166
166
  <tr>
167
167
  <td width="50%" valign="top">
168
- <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.0.0/.github/images/linked-views.png" alt="Linked views demo: Cut order A is selected in the Gantt chart, and the same task is highlighted in the network graph above and in the CNC cell load row below, where a red segment marks an overload" width="100%"><br>
168
+ <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/linked-views.png" alt="Linked views demo: Cut order A is selected in the Gantt chart, and the same task is highlighted in the network graph above and in the CNC cell load row below, where a red segment marks an overload" width="100%"><br>
169
169
  <b>Linked views.</b> Select in one view and the graph, Gantt chart and load rows highlight the same task (<code>useLinkedSelection</code>).
170
170
  </td>
171
171
  <td width="50%" valign="top">
172
- <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.0.0/.github/images/plan-comparison.png" alt="Plan scenarios demo: a candidate plan that pushes the cutting work after a maintenance window, compared with the current plan in a table of final completion, deadline misses, changed assignments and CNC cell overload, and a Gantt chart that shows the current plan as a strip below each candidate bar" width="100%"><br>
172
+ <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/plan-comparison.png" alt="Plan scenarios demo: a candidate plan that pushes the cutting work after a maintenance window, compared with the current plan in a table of final completion, deadline misses, changed assignments and CNC cell overload, and a Gantt chart that shows the current plan as a strip below each candidate bar" width="100%"><br>
173
173
  <b>Plan scenarios.</b> Compare a candidate plan with the current one before adopting it (<code>comparePlans</code>).
174
174
  </td>
175
175
  </tr>
176
176
  <tr>
177
177
  <td width="50%" valign="top">
178
- <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.0.0/.github/images/diagram-styles-dark.png" alt="Diagram styles demo in the dark theme: an order fulfilment flow with ellipse, diamond and hexagon nodes, dashed animated main-path edges, open-arrow and circle edge markers, and a pair of parallel edges spread apart" width="100%"><br>
178
+ <img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/diagram-styles-dark.png" alt="Diagram styles demo in the dark theme: an order fulfilment flow with ellipse, diamond and hexagon nodes, dashed animated main-path edges, open-arrow and circle edge markers, and a pair of parallel edges spread apart" width="100%"><br>
179
179
  <b>Diagram styles and dark theme.</b> Node shapes, edge markers, animated and parallel edges, and the built-in dark theme.
180
180
  </td>
181
181
  <td width="50%" valign="top">
@@ -186,36 +186,48 @@ All screenshots are from the [demo app](#run-the-demo) in this repository.
186
186
 
187
187
  ## Features
188
188
 
189
- Everything beyond the basics is opt-in. This is an overview; the full list of props, events, slots and functions is in [docs/api.md](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/api.md), with guides in [docs/integration.md](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md) and [docs/scheduling.md](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/scheduling.md).
189
+ Everything beyond the basics is opt-in. This is an overview; the full list of props, events, slots and functions is in [docs/api.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md), with guides in [docs/integration.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md) and [docs/scheduling.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md).
190
190
 
191
191
  ### NetworkGraph
192
192
 
193
- - **Layouts:** a built-in layered layout (`LR`, `TB`, `RL` or `BT`, with `crossingReduction: 'barycenter'`) that handles branches, merges, cycles and self-loops. Through the `layout` prop: tree, radial, circular, grid, concentric and deterministic force layouts (`layoutTreeGraph`, `layoutRadialGraph`, `layoutCircularGraph`, `layoutGridGraph`, `layoutConcentricGraph`, `layoutForceGraph`), or [ELK.js](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#use-elkjs-for-layout) installed by your application.
194
- - **Process lanes:** `layoutSwimlaneGraph` gives each department or work centre a lane in your order; the `lanes` prop draws the bands, also in the minimap and exports, and `graphSwimlaneAt` finds the lane a node was dragged to. See [Swimlanes for process flows](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#swimlanes-for-process-flows).
195
- - **Quantity flows (Sankey diagrams):** `layoutFlowGraph` sizes each edge by its quantity on one scale, reports inflow, outflow and their difference per node as given, never adds different units, and draws rework loops as dashed reference bands; the `edgeBands` prop renders them with names such as "Cut → Inspect: 60 pcs". See [Quantity flows](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#quantity-flows-sankey-diagrams).
193
+ - **Layouts:** a built-in layered layout (`LR`, `TB`, `RL` or `BT`, with `crossingReduction: 'barycenter'`) that handles branches, merges, cycles and self-loops. Through the `layout` prop: tree, radial, circular, grid, concentric and deterministic force layouts (`layoutTreeGraph`, `layoutRadialGraph`, `layoutCircularGraph`, `layoutGridGraph`, `layoutConcentricGraph`, `layoutForceGraph`), or [ELK.js](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#use-elkjs-for-layout) installed by your application.
194
+ - **Process lanes:** `layoutSwimlaneGraph` gives each department or work centre a lane in your order; the `lanes` prop draws the bands, also in the minimap and exports, and `graphSwimlaneAt` finds the lane a node was dragged to. See [Swimlanes for process flows](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#swimlanes-for-process-flows).
195
+ - **BPMN processes and flowcharts:** circle, stadium, parallelogram, document, cylinder and data-object nodes, BPMN event borders, gateway, event and task-type markers, labels below small shapes, dashed message flows, and pools around swimlanes (`pools`), also in exports. See [BPMN processes and flowcharts](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#bpmn-processes-and-flowcharts).
196
+ - **Quantity flows (Sankey diagrams):** `layoutFlowGraph` sizes each edge by its quantity on one scale, reports inflow, outflow and their difference per node as given, never adds different units, and draws rework loops as dashed reference bands; the `edgeBands` prop renders them with names such as "Cut → Inspect: 60 pcs". See [Quantity flows](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#quantity-flows-sankey-diagrams).
196
197
  - **Drawing:** `node`, `edge`, `group` and `minimap-node` slots for your own SVG, `tooltip`, `node-toolbar` and `edge-toolbar` slots for HTML; diamond, ellipse and hexagon nodes; orthogonal or straight edges (`edgeStyle`), routes around nodes (`avoidNodes`), waypoints, end markers, animated edges and spread parallel edges.
197
198
  - **Editing as proposals:** node moves, connections checked against typed port rules (`connectionRules`) with valid-target hints, inline label editing, box or lasso selection, nested and collapsible groups, node resizing, snap to grid with alignment guides, palette drops, clipboard, and keyboard deletion.
198
199
  - **Navigation:** minimap, viewport culling and level of detail for large graphs, pinch zoom, search highlighting (`matchIds`), `focusNode(id)` and `fit({ ids })`.
200
+ - **Diagram editor parts:** `GraphPalette` lists node templates to drag onto the graph or insert from the keyboard, and `PropertyInspector` edits the selected node through typed fields; both emit proposals. See [Diagram editor parts](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#diagram-editor-parts).
199
201
 
200
202
  ### GanttChart
201
203
 
202
204
  - **Display:** multiple lanes, progress, milestones and FS/SS/FF/SF dependencies with lag labels; row groups with summary rollups and optional summary dependencies; up to three named baseline sets with variance; header bands, date markers and highlighted ranges (`markerRanges`); a status-date line and progress line; non-working time shading; critical outlines, float lines, deadlines and split bars; a resource load histogram (`loadRows`) that accepts `calculateResourceLoad` output.
203
205
  - **Editing as proposals:** drag and keyboard moves and resizes, auto-scheduling previews of the bars a move would push (`cascade`), dependency creation and reconnection, multiple selection and batch moves, drag to create, progress sliders, deletion, row hierarchy moves, column resizing, scheduling constraint handles, typed cell editors (`field-edit`), and drops from your own lists (`bar-drop`).
206
+ - **Spreadsheet editing (`spreadsheet`):** select cell ranges, copy, cut and paste with Excel or Google Sheets, clear, fill down with Ctrl/Cmd+D or the corner handle, and type to edit; each operation is one `sheet-edit` proposal that `validateSheetEdit` can reject as a whole and `applyTimelineSheetEdit` applies. The demo homepage has a schedule sheet whose bars, arrows and critical path the scheduler derives from the grid, and a purchase approval workflow editor.
204
207
  - **Time scales:** zoom presets, ready calendar presets in an IANA time zone and locale (`calendarZoomPresets`, `intlTimeFormatter`), a scale that compresses non-working time (`createWorkingTimeScale`), Ctrl+wheel and pinch zoom, a now marker and `fitToBars()`.
205
208
  - **Scale:** row and time-window virtualization, and `visible-window-change` to load only the visible weeks and rows.
209
+ ### EventCalendar
210
+ - **Views:** day, week and month views of appointments in an IANA time zone and locale, an all-day row for multi-day events, a "+N more" overflow in the month grid, a now line and a built-in toolbar (or your own through a slot). With `resources`, the day view shows one column per room, machine or person.
211
+ - **Editing as proposals:** drag and keyboard moves and resizes, moves between resources and drag to create, checked by synchronous `validateEdit` and `validateCreate`. `range-change` reports the visible range for loading, and the core helpers (`eventCalendarRange`, `layoutCalendarDayEvents`, `packCalendarEventLanes`) run on servers too.
212
+
213
+ ### TaskBoard
214
+
215
+ - **Kanban board:** an opt-in third controlled component. Cards sit in status columns, optionally split into swimlanes; columns show their card count and warn when they are over a WIP limit. Pointer and touch drags (with a drop indicator and auto-scroll) and the keyboard (Space, arrows, Enter, Escape, with live announcements) propose `card-move`, which `validateCardMove` can reject and `applyBoardCardMove` applies. Use the same tasks and selection as a GanttChart. See [TaskBoard](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md#taskboard).
206
216
 
207
217
  ### Headless core (`@eightkk/vue-weave/core`)
208
218
 
209
219
  - **Graph algorithms and metrics:** `topologicalOrder`, `findGraphCycles`, `shortestGraphPath`, `searchGraphNodes`, `filterGraph`, connected components, degree, betweenness and PageRank centrality, and Louvain communities (`detectGraphCommunities`) that `graphCommunityGroups` turns into groups.
210
220
  - **Scheduling:** `scheduleTasks` on calendars from `buildWorkPeriods`, including IANA time zones, as-late-as-possible, manual, inactive and summary tasks, constraints, pauses and cycle and infeasibility diagnostics. `scheduleTasks(input, { explain: true })` traces why each task starts when it does, and `toPlanningDiagnostics` lists the problems.
211
221
  - **Resources:** `calculateResourceLoad` and `levelResources`, with capacity that changes over time (`capacityPeriods`) and assignments that cover only part of a task (`workOffset`, `workDuration`); `projectResourceTimeline` shows a plan by resource, and `buildPlacementInput` keeps unplanned tasks out of the calculation.
212
- - **Plan updates:** `propagateEdit`, `rescheduleFromStatusDate`, `rescheduleFromActuals` (keeps recorded actuals and forecasts the rest), and `comparePlans`, which separates what you changed from what moved as a result. See [Compare plan scenarios](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/scheduling.md#compare-plan-scenarios).
222
+ - **Plan updates:** `propagateEdit`, `rescheduleFromStatusDate`, `rescheduleFromActuals` (keeps recorded actuals and forecasts the rest), and `comparePlans`, which separates what you changed from what moved as a result. See [Compare plan scenarios](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md#compare-plan-scenarios).
223
+ - **Earned value:** `computeEarnedValue` calculates PV, EV and AC at a status date with SV, CV, SPI, CPI, EAC, ETC, VAC and TCPI per task and in total, accrues planned value on a work calendar, and returns a cumulative series for an S-curve; `rollupEarnedValue` sums summary rows. See [Earned value management](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md#earned-value-management).
213
224
  - **Interchange:** Microsoft Project XML (including calendars, resources and assignments), iCalendar and CSV import and export (`fromMsProjectXml`, `toMsProjectXml`, `fromICalendar`, `toICalendar`, `parseCsv`, `toCsv`), and `scheduleToGraph` for a PERT network diagram.
225
+ - **Diagram files:** Mermaid flowcharts, GraphML (including yEd) and draw.io import and export for NetworkGraph diagrams, with nested groups, shapes, positions and sizes (`fromMermaid`, `toMermaid`, `fromGraphMl`, `toGraphMl`, `fromDrawio`, `fromDrawioAsync` for compressed files, `toDrawio`).
214
226
 
215
227
  ### Linked views, large data and saving
216
228
 
217
- - **Linked views:** `useLinkedSelection` links a graph, a Gantt chart and load rows through entity bindings; `revealNode`, `revealBar` and `revealLinkedTarget` move to an item, also inside collapsed groups and rows; `timelineBarsInRange` and `resolveTimeRangeTargets` highlight what was worked on in a time range. See [Linking views](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#linking-views).
218
- - **Large data:** `useWindowedData` fetches only the visible window through your `load` function, with aborts, deduplication and retry; graph expansion helpers and `layoutGraphIncrementally` load a graph one hop at a time without moving the nodes on display; `useAsyncGraphLayout` runs a layout in a Worker, and `routingPolicy="preserve"` keeps the engine's routes. See [Loading only what is visible](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md#loading-only-what-is-visible).
229
+ - **Linked views:** `useLinkedSelection` links a graph, a Gantt chart and load rows through entity bindings; `revealNode`, `revealBar` and `revealLinkedTarget` move to an item, also inside collapsed groups and rows; `timelineBarsInRange` and `resolveTimeRangeTargets` highlight what was worked on in a time range. See [Linking views](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#linking-views).
230
+ - **Large data:** `useWindowedData` fetches only the visible window through your `load` function, with aborts, deduplication and retry; graph expansion helpers and `layoutGraphIncrementally` load a graph one hop at a time without moving the nodes on display; `useAsyncGraphLayout` runs a layout in a Worker, and `routingPolicy="preserve"` keeps the engine's routes. See [Loading only what is visible](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#loading-only-what-is-visible).
219
231
  - **Views and saving:** `useTimelineView` for searched and sorted rows, `useEditHistory` for undo and redo, `useEditTransaction` to save through your server adapter with conflict handling, and `serializeWeaveSnapshot` and `restoreWeaveSnapshot` for versioned, validated JSON.
220
232
 
221
233
  ### Export, themes and accessibility
@@ -232,16 +244,18 @@ const png = await chart.value!.exportPng({ scale: 2 })
232
244
 
233
245
  ## Status and support
234
246
 
235
- - **Version 1.0.** Releases follow [Semantic Versioning](https://semver.org/): breaking changes are made only in major releases and are listed under "Breaking changes" in the [changelog](https://github.com/EightKK/vue-weave/blob/v1.0.0/CHANGELOG.md). [Compatibility and versioning](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/api.md#compatibility-and-versioning) lists what that covers (exported names and types, props, events, slots, documented `--vw-*` properties and the snapshot format) and what it does not (the exact text of error messages, the emitted `vw-` classes, DOM structure and server-rendered markup).
247
+ - **Version 1.0.** Releases follow [Semantic Versioning](https://semver.org/): breaking changes are made only in major releases and are listed under "Breaking changes" in the [changelog](https://github.com/EightKK/vue-weave/blob/v1.2.0/CHANGELOG.md). [Compatibility and versioning](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md#compatibility-and-versioning) lists what that covers (exported names and types, props, events, slots, documented `--vw-*` properties and the snapshot format) and what it does not (the exact text of error messages, the emitted `vw-` classes, DOM structure and server-rendered markup).
236
248
  - **Vue:** 3.5 or later in 3.x (peer dependency `^3.5.0`).
237
249
  - **Modules and TypeScript:** ESM only. Declarations support `Bundler` and `NodeNext` resolution. Item `data` can be typed (`NetworkNode<MyData>`, `TimelineBar<MyData>`), and that type reaches slot props and callbacks without casts.
238
250
  - **Node.js:** 22.18 or later for the headless `@eightkk/vue-weave/core` entry, server-side rendering and development.
239
251
  - **Browsers:** current evergreen browsers (Chrome, Edge, Firefox and Safari). Automated browser tests run in Chromium only, so the other browsers are not covered by CI.
240
- - **Accessibility:** keyboard operation and ARIA names are included. Dedicated screen-reader testing has not been done yet (see [Architecture, performance and scope](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/architecture.md)), so do not assume full conformance.
252
+ - **Accessibility:** keyboard operation and ARIA names are included. Dedicated screen-reader testing has not been done yet (see [Architecture, performance and scope](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/architecture.md)), so do not assume full conformance.
241
253
 
242
254
  ## Run the demo
243
255
 
244
- There is no hosted demo. Run it locally with Node.js 22.18+ and npm. From a source checkout or GitHub source ZIP, run:
256
+ The main page opens the production planning and lot flow demos. Use **Examples** to open the full sample gallery.
257
+
258
+ The demo is hosted on [GitHub Pages](https://eightkk.github.io/vue-weave/) and is rebuilt from `main`, so it can be ahead of the latest release. To run it locally, use Node.js 22.18+ and npm. From a source checkout or GitHub source ZIP, run:
245
259
 
246
260
  ```sh
247
261
  npm ci
@@ -255,19 +269,19 @@ On Windows you can double-click `Start.cmd` instead. It serves `preview/` when i
255
269
 
256
270
  If you have a prebuilt demo archive containing `preview/` (it may be attached to a release), extract it completely and run `npm start`, or double-click `Start.cmd` on Windows. The prebuilt demo needs Node.js but does not require dependency installation. If you change its sources, `Start.cmd` rebuilds it, which needs npm and an internet connection the first time.
257
271
 
258
- For development and verification commands, see [Contributing](https://github.com/EightKK/vue-weave/blob/v1.0.0/CONTRIBUTING.md).
272
+ For development and verification commands, see [Contributing](https://github.com/EightKK/vue-weave/blob/v1.2.0/CONTRIBUTING.md).
259
273
 
260
274
  ## Documentation
261
275
 
262
- - [Public API and input contracts](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/api.md)
263
- - [Vue, Nuxt, custom rendering, time scales and persistence](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/integration.md)
264
- - [Architecture, performance and scope](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/architecture.md)
265
- - [Scheduling and resource load](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/scheduling.md)
266
- - [Contributing and release process](https://github.com/EightKK/vue-weave/blob/v1.0.0/CONTRIBUTING.md)
267
- - [Security and private vulnerability reporting](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/security.md)
268
- - [Code of conduct](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/code-of-conduct.md)
269
- - [Changelog](https://github.com/EightKK/vue-weave/blob/v1.0.0/CHANGELOG.md)
276
+ - [Public API and input contracts](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md)
277
+ - [Vue, Nuxt, custom rendering, time scales and persistence](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md)
278
+ - [Architecture, performance and scope](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/architecture.md)
279
+ - [Scheduling and resource load](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md)
280
+ - [Contributing and release process](https://github.com/EightKK/vue-weave/blob/v1.2.0/CONTRIBUTING.md)
281
+ - [Security and private vulnerability reporting](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/security.md)
282
+ - [Code of conduct](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/code-of-conduct.md)
283
+ - [Changelog](https://github.com/EightKK/vue-weave/blob/v1.2.0/CHANGELOG.md)
270
284
 
271
285
  ## License
272
286
 
273
- MIT. See [LICENSE](https://github.com/EightKK/vue-weave/blob/v1.0.0/LICENSE). Third-party notices for the prebuilt demo are in [THIRD_PARTY_NOTICES.md](https://github.com/EightKK/vue-weave/blob/v1.0.0/THIRD_PARTY_NOTICES.md) and [Third-party licenses](https://github.com/EightKK/vue-weave/blob/v1.0.0/docs/third-party-licenses.md).
287
+ MIT. See [LICENSE](https://github.com/EightKK/vue-weave/blob/v1.2.0/LICENSE). Third-party notices for the prebuilt demo are in [THIRD_PARTY_NOTICES.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/THIRD_PARTY_NOTICES.md) and [Third-party licenses](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/third-party-licenses.md).