@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.
- package/CHANGELOG.md +42 -7
- package/CONTRIBUTING.md +13 -20
- package/README.ja.md +51 -37
- package/README.md +50 -36
- package/dist/{core-BH5rTsKp.js → core-C7J4FG_e.js} +5354 -2577
- package/dist/core.js +1 -1
- package/dist/index.js +6093 -3515
- package/dist/style.css +1 -1
- package/dist/types/components/EventCalendar.vue.d.ts +105 -0
- package/dist/types/components/GanttChart.vue.d.ts +15 -1
- package/dist/types/components/GraphPalette.vue.d.ts +38 -0
- package/dist/types/components/NetworkGraph.vue.d.ts +7 -1
- package/dist/types/components/PropertyInspector.vue.d.ts +41 -0
- package/dist/types/components/TaskBoard.vue.d.ts +72 -0
- package/dist/types/components/graphPalette.d.ts +12 -0
- package/dist/types/core/diagramEditor.d.ts +136 -0
- package/dist/types/core/earnedValue.d.ts +165 -0
- package/dist/types/core/eventCalendar.d.ts +214 -0
- package/dist/types/core/exportSvg.d.ts +8 -1
- package/dist/types/core/graph.d.ts +7 -2
- package/dist/types/core/graphCollapse.d.ts +1 -1
- package/dist/types/core/graphSwimlanes.d.ts +47 -0
- package/dist/types/core/index.d.ts +12 -0
- package/dist/types/core/interchange.d.ts +7 -0
- package/dist/types/core/interchangeDrawio.d.ts +60 -0
- package/dist/types/core/interchangeGraph.d.ts +153 -0
- package/dist/types/core/interchangeGraphMl.d.ts +32 -0
- package/dist/types/core/interchangeMermaid.d.ts +48 -0
- package/dist/types/core/sheetEditing.d.ts +36 -0
- package/dist/types/core/taskBoard.d.ts +150 -0
- package/dist/types/core/types.d.ts +49 -2
- package/dist/types/index.d.ts +44 -0
- package/docs/api.md +378 -0
- package/docs/architecture.md +6 -2
- package/docs/integration.md +180 -0
- package/docs/scheduling.md +31 -0
- package/docs/security.md +1 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,13 +4,48 @@
|
|
|
4
4
|
|
|
5
5
|
No changes yet.
|
|
6
6
|
|
|
7
|
+
## 1.2.0 - 2026-11-22
|
|
8
|
+
|
|
9
|
+
Adds a kanban board, an event calendar, diagram editor parts, BPMN and flowchart shapes with pools, earned value management and Mermaid, GraphML and draw.io interchange. All changes are additive; nothing from 1.1.0 changes or is removed.
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
- Earned value management: `computeEarnedValue(tasks, options)` returns PV, EV, AC, SV, CV, SPI, CPI, ETC, EAC, VAC, TCPI and percent complete per task and in total at a status date, with planned value accrued over a work calendar (or linearly), milestones at their start, three EAC methods (`cpi`, `cpi-spi`, `budget`), undefined instead of NaN or Infinity for zero denominators, and an optional cumulative PV/EV/AC series for S-curves (EV and AC from per-task `history` records). `rollupEarnedValue` sums any group, such as a summary row. New exports: `computeEarnedValue`, `rollupEarnedValue`, `maxEarnedValuePoints` and the `EarnedValue*` types. New **Earned value** demo. See [Earned value management](docs/scheduling.md#earned-value-management).
|
|
14
|
+
- New opt-in `TaskBoard` component (kanban): cards in status columns, optionally split into swimlanes, with card counts and WIP-limit warnings. It is controlled like the other components: pointer, touch and keyboard moves (Space to pick up, arrows, Space or Enter to drop, Escape to cancel, with live announcements) propose `card-move`, `validateCardMove` can reject it (`card-move-rejected`), and cancelled moves report `card-move-cancel`; `v-model:selected-id`, `card-activate`, `labels`, `dir` and the `card`, `column-header` and `empty` slots. New public types `TaskBoardComponent` and `TaskBoardExposed`. New core helpers `groupBoardCards`, `boardCardPosition` and `applyBoardCardMove` with the `TaskBoard*` types, and the CSS variables `--vw-board-column-width`, `--vw-board-cell-min-height`, `--vw-board-wip-warning` and `--vw-board-drop`. A new "Task board" demo shares tasks and selection with a GanttChart. Nothing existing changes.
|
|
15
|
+
- Added two diagram editor parts to the Vue entry, both controlled and opt-in: `GraphPalette`, a listbox of node templates (optional sections and filter box, shape previews) that are HTML5-draggable with a JSON payload under `graphPaletteMimeType` and emit `insert` on Enter or Space, with `readPaletteDrop(drop)` to read a NetworkGraph or GanttChart drop back; and `PropertyInspector`, a form generated from typed field definitions (`InspectorField`: the `TimelineFieldSpec` rules plus `label`, `readonly` and a `color` kind) that emits `change` proposals checked by a synchronous `validateChange`, shows rejection reasons inline (`change-rejected`), has a `field-<id>` slot per field and drops drafts when the item or the edited value changes. New types `GraphPaletteItem`, `GraphPaletteLabels`, `GraphPaletteDrop`, `PaletteDropSource`, `InspectorItem`, `InspectorField`, `InspectorFieldKind`, `InspectorChange`, `InspectorChangeValidator`, `PropertyInspectorLabels`, `PropertyInspectorFieldSlot`, `GraphPaletteComponent`, `GraphPaletteExposed`, `PropertyInspectorComponent` and `PropertyInspectorExposed`, and CSS variables `--vw-palette-preview-width` and `--vw-inspector-error`. The gallery has a new "Diagram editor" demo. Nothing existing changes.
|
|
16
|
+
- NetworkGraph and `renderGraphSvg`: opt-in flowchart and BPMN node shapes (`NetworkFlowchartShape`, part of `NetworkNodeShape`): `circle`, `stadium`, `parallelogram`, `document`, `cylinder` and `data-object`, with edge ends on their outlines (also for orthogonal routes) and the same drawing in exportSvg and exportPng. Unknown shapes still draw a box.
|
|
17
|
+
- NetworkGraph and `renderGraphSvg`: opt-in BPMN node decorations: `NetworkNode.event` (`start`, `intermediate` with a double border, `end` with a thick border), `NetworkNode.marker` (`NetworkNodeMarker`: the gateway symbols `exclusive`, `parallel`, `inclusive` and `event-based`, the event symbols `message` and `timer`, and the task types `user`, `service` and `manual`; decorative and `aria-hidden`) and `NetworkNode.labelPosition: 'below'` (`NetworkNodeLabelPosition`) for labels under small shapes. Accessible names stay the label and detail.
|
|
18
|
+
- `GraphEdge.dashed` draws an edge with a static dash pattern (class `vw-is-dashed`), and the new edge marker `'hollow-arrow'` is a triangle filled with the graph background, for BPMN message flows (`{ dashed: true, markerStart: 'circle', markerEnd: 'hollow-arrow' }`). `collapseGraphGroups` keeps `dashed` on merged edges when they agree.
|
|
19
|
+
- `layoutSwimlaneGraph`: opt-in `pools` (`GraphSwimlanePoolSpec`), `poolHeaderSize` and `poolGap` options and a `pools` result (`GraphSwimlanePool`) for BPMN participants around consecutive lanes; NetworkGraph has a `pools` prop (`GraphSwimlanePoolBand`) that draws each pool as a named group with a rotated title around its lanes, and `renderGraphSvg` a `pools` option. New CSS variables `--vw-pool-fill`, `--vw-pool-header-fill` and `--vw-pool-border`. Without pools the layout result and markup are unchanged.
|
|
20
|
+
- `EventCalendar`: a new controlled component for appointment-style scheduling, with day, week and month views, an all-day row, an optional per-resource day view (`resources`), a now line, a built-in toolbar and `event`/`toolbar` slots. Pointer and keyboard moves and resizes emit `edit` (`EventCalendarEdit`, with `resource` for a column change), drags over empty time emit `create` when `creatable` is set, both checked by synchronous `validateEdit` and `validateCreate` (`edit-rejected`, `create-rejected`); `v-model:view`, `v-model:date` and `v-model:selected-id`, `event-activate`, `range-change` and `edit-cancel` complete it. New core helpers `eventCalendarRange`, `eventCalendarDays`, `eventCalendarMonthGrid`, `shiftEventCalendarDate`, `eventCalendarTimeOfDay`, `eventCalendarTimeAt`, `layoutCalendarDayEvents`, `packCalendarEventLanes` and `validateCalendarEvents`, the `EventCalendarComponent` and `EventCalendarExposed` types, `vw-calendar-*` classes and the `--vw-calendar-gutter`, `--vw-calendar-today` and `--vw-calendar-event-accent` theme variables. Additive; nothing existing changes.
|
|
21
|
+
- Graph interchange (core): `toMermaid` and `fromMermaid` (Mermaid flowcharts with shapes, subgraphs as nested groups, chains, `&` lists, every link form and edge labels; IDs Mermaid cannot hold are encoded and decoded), `toGraphMl` and `fromGraphMl` (own keys for labels, details, shapes, tones, positions, sizes, markers and waypoints, nested graphs as groups, yEd labels, geometry, shapes and arrows), and `toDrawio`, `fromDrawio` and `fromDrawioAsync` (uncompressed `mxfile` export with container groups; import of uncompressed and, asynchronously, compressed pages, chosen by index or name). The readers return the NetworkGraph props with `warnings` (`GraphInterchangeImport`), never expand XML entities and bound their work with `maxItems` and `maxInflatedLength`. Shapes and markers are mapped through one table per format; unknown shapes become boxes with a warning. See [Graph interchange](docs/api.md#graph-interchange). The demo gallery has a "Diagram import/export" example.
|
|
22
|
+
|
|
23
|
+
### Demo
|
|
24
|
+
|
|
25
|
+
- The demo homepage now opens in English regardless of the browser language; add `?lang=ja` to the URL to open it in Japanese. The language buttons work as before.
|
|
26
|
+
- Widened the approval workflow demo so the branch amount labels no longer run into the step boxes.
|
|
27
|
+
- A BPMN process example (a purchase order between a Customer pool and a Supplier pool with Sales and Warehouse lanes) and a small flowchart.
|
|
28
|
+
|
|
29
|
+
### Development
|
|
30
|
+
|
|
31
|
+
- `VW_PORT` sets the port of the demo server and the Playwright browser tests (default 4173), so two checkouts can run browser tests at once.
|
|
32
|
+
- The public API baseline (`api/public-api.md`) also records the props, events, slots and exposed members of the new components.
|
|
33
|
+
|
|
34
|
+
## 1.1.0 - 2026-11-21
|
|
35
|
+
|
|
36
|
+
Adds spreadsheet editing to GanttChart. All changes are additive; nothing from 1.0.0 changes or is removed.
|
|
37
|
+
|
|
38
|
+
- Added opt-in spreadsheet editing on GanttChart (`spreadsheet`): rectangular selection, copy, cut and paste as tab-separated text, Delete to clear, fill down with Ctrl/Cmd+D or a pointer and touch fill handle, typing to edit and spreadsheet navigation keys. Each operation is one `sheet-edit` proposal (`TimelineSheetEdit`, actions `paste`, `fill` and `clear`), checked as a whole by the new `validateSheetEdit` prop and reported by `sheet-edit-rejected(reason, change?)`. New optional `GanttLabels` fields `sheetHint`, `sheetReadOnly`, `sheetRagged`, `sheetOutside` and `sheetRejected` localize the texts.
|
|
39
|
+
- Added core helpers `parseSheetText`, `formatSheetText` and `applyTimelineSheetEdit` (with the types `TimelineSheetChanges` and `TimelineSheetAppliers`).
|
|
40
|
+
- Added an auto-scheduled project plan sheet and an approval workflow editor to the bilingual demo homepage.
|
|
41
|
+
|
|
7
42
|
## 1.0.0 - 2026-11-21
|
|
8
43
|
|
|
9
44
|
This is the first stable release. From here on the package follows SemVer as defined in [Compatibility and versioning](docs/api.md#compatibility-and-versioning), and it is published on npm as `@eightkk/vue-weave` (`npm install @eightkk/vue-weave`). The changes below fix data-correctness and compatibility problems found in the pre-release review; the ones that change results or types are listed under "Breaking changes", each with who is affected and what to do.
|
|
10
45
|
|
|
11
46
|
### Breaking changes
|
|
12
47
|
|
|
13
|
-
- The package name is now `@eightkk/vue-weave` (was
|
|
48
|
+
- The package name is now `@eightkk/vue-weave` (was `@eightkk/vue-weave`), because npm does not accept the unscoped name. The entries are `@eightkk/vue-weave`, `@eightkk/vue-weave/core`, `@eightkk/vue-weave/style.css` and `@eightkk/vue-weave/package.json`, and the release tarball is `eightkk-vue-weave-<version>.tgz`. Who is affected: everyone who installed an earlier tarball. What to do: install `@eightkk/vue-weave`, remove `@eightkk/vue-weave`, and replace `'@eightkk/vue-weave'` with `'@eightkk/vue-weave'` in imports (also `/core` and `/style.css`). The exports, types and behaviour of each entry are otherwise as described below.
|
|
14
49
|
- `fromICalendar` now resolves a `TZID` local time that a daylight-saving change skips as RFC 5545 section 3.3.5 requires: with the UTC offset in effect before the change. `DTSTART;TZID=America/New_York:20070311T023000` is now 07:30 UTC (local 03:30) instead of 07:00 UTC. This applies to DTSTART, DTEND and the end of a day or week `DURATION`. A repeated local time still takes its first occurrence. Who is affected: anyone who imports `.ics` files with `TZID` times that fall in a skipped hour; re-importing such a file gives a start or end up to one gap length (usually one hour) later than 0.6.0 did, so events imported with 0.6 and re-imported with 1.0 can differ. What to do: re-import those files if you stored 0.6.0 results and need the RFC times. `buildWorkPeriods`, calendar bands and editing keep moving a skipped time to the change itself. `toICalendar` writes UTC and is unaffected.
|
|
15
50
|
- `comparePlans` now throws when a given successful `result` does not match the task set of its `input`: an active task is missing or listed twice, or `inactiveTaskIds` does not list exactly the inactive tasks (subtasks of an inactive summary included). A result calculated before a task was added, removed or (de)activated used to be compared as a complete plan, with the new task `unscheduled` and a stale finish. Who is affected: callers who pass a precomputed `result` that does not exactly match the input (stored, cached or hand-built results). What to do: recalculate the result whenever its input changes, or omit `result` and let `comparePlans` calculate it. Only task sets are checked; a result for an earlier version of the same tasks (a changed duration, say) is still not detected, so keep a shared revision if you store results separately from their input.
|
|
16
51
|
- `parseFieldValue` with a `select` spec that has `multiple: true` now always returns an array, also for a single entry (`'a'` → `['a']`, was `'a'`). GanttChart's built-in field input therefore proposes arrays for such columns. Who is affected: code reading `field-edit` `after` or `parseFieldValue` results for multiple selects. What to do: expect an array.
|
|
@@ -97,13 +132,13 @@ This is a minor release because of the changes under "Breaking changes": error m
|
|
|
97
132
|
- `markerRanges` (`TimelineMarkerRange`): highlighted half-open ranges `[start, end)` drawn as a band under the bars, across the body or only across `rowIds`, with a label strip at the bottom of the time header (`role="img"`, named `<label> <start>–<end>` with `formatTime`). Optional `tone`; otherwise the new `--vw-range`, `--vw-range-line`, `--vw-range-ink` and `--vw-range-opacity` variables (dark theme values included). Ranges are clipped to `range` and the visible time window, mirrored in right-to-left charts, hatched in forced colors, printed, and drawn by `exportSvg`, `exportPng` and `renderTimelineSvg` (`markerRanges` option; theme colours `range`, `rangeLine` and `rangeInk`). A duplicate or missing ID or an unknown row is an `Error`, and endpoints that are not finite with `start < end` (including a zero-width range) a `RangeError`, reported through `validation-error`. Point `markers` are unchanged.
|
|
98
133
|
- `visible-window-change` (`TimelineVisibleWindow`: the rendered half-open time window `[start, end)`, the rendered row IDs after collapsing with overscan, and the expanded parent rows), emitted after mounting once the window has settled for the new `visibleWindowDelay` prop (default 100 ms), and only when it changed; scrolling, resizing, zooming and collapsing re-emit it. Nothing is emitted during server rendering and the markup is unchanged. See [Partial data loading](docs/api.md#partial-data-loading).
|
|
99
134
|
|
|
100
|
-
#### Graph core (
|
|
135
|
+
#### Graph core (`@eightkk/vue-weave/core`)
|
|
101
136
|
|
|
102
137
|
- Swimlane layout for process flows: `layoutSwimlaneGraph(nodes, edges, { lanes, laneOf, direction, ... })` puts every node in its own lane's band, with ranks from the layered layout (cycles and self-loops share a rank), lanes in the caller's order (never reordered; empty lanes keep a band) and barycenter ordering inside a lane, with the shared layout defaults (nodes 144 × 58, `columnGap` 50, `rowGap` 24, `padding` 20). It returns a `GraphSwimlaneLayout` (a `GraphLayout` plus `lanes`: band, header, `index` and `nodeIds` per lane). A node without a lane or with an unknown lane throws an `Error`. `graphSwimlaneAt(lanes, pointOrBox)` tells which lane a point or box centre falls in, so an application can turn a `node-move` proposal into a lane change. `renderGraphSvg` takes the same `lanes` option as the NetworkGraph prop. Types `GraphSwimlaneSpec`, `GraphSwimlaneBand`, `GraphSwimlane`, `GraphSwimlaneLayout` and `GraphSwimlaneLayoutOptions`.
|
|
103
138
|
- Quantity flow (Sankey) projection: `layoutFlowGraph(nodes, edges, { quantity, unit, displayUnit, direction, nodeThickness, nodeGap, rankGap, scale, ... })` returns a `GraphFlowLayout`, a `GraphLayout` for the `layout` prop plus `nodes` (`GraphFlowNode`: box, rank, `inflow`, `outflow`, `difference`, `value` and the reference totals), `bands` (`GraphFlowBand`: edge ID, quantity, unit, `thickness = quantity × scale` on one scale for the whole picture, drawn `width`, source and target sides and offsets, centre-line path and a label such as `Cut → Inspect: 60 pcs`) and `excluded` (`GraphFlowExcludedEdge`). Ranks and orders come from the layered layout with barycenter sweeps; bands are stacked along each side by the position of their other end. The unit is required, and edges in another unit than the displayed one are listed in `excluded` and never added. Totals are reported as given, never balanced. A quantity must be a finite number of at least 0 (`RangeError`); a zero keeps a hairline band. Edges that close a cycle and self-loops become `reference` bands routed below the ranks and counted apart from the totals; loops are not unrolled by period. `scale` is `{ pixelsPerUnit }` or `{ fitExtent }` (`GraphFlowScale`). `graphFlowBands(flow)` builds the band map for the NetworkGraph `edgeBands` prop, and `renderGraphSvg` takes the same `edgeBands` option. See [Quantity flow projection](docs/api.md#quantity-flow-projection) and [Quantity flows](docs/integration.md#quantity-flows-sankey-diagrams).
|
|
104
139
|
- Stable incremental placement: `layoutGraphIncrementally(nodes, edges, positions, options?)` (`GraphIncrementalLayoutOptions`, `GraphKnownPosition`) returns a complete `GraphLayout` (`GraphIncrementalLayout`, with `placedIds`, `movedIds` and `fallbackIds`) in which every positioned node keeps its box exactly and each new node is placed on the flow side of its placed neighbours (after predecessors, before successors, in all four directions) in free space, keeping the column and row gaps; chains of new nodes follow their dependency order, components without a positioned node are laid out as a layered block next to the others, and positions of unknown IDs are ignored. `fixedIds` pins nodes; the relaxed mode `maxDisplacement` (default 0) may push unfixed blocking nodes across the flow by a bounded distance; new boxes stay nonnegative unless `allowNegative`; `previousLayout` keeps the paths of edges between unchanged boxes. Deterministic, iterative, with a bucket grid for overlap tests. `graphLayoutChangeMetrics(before, after, options?)` (`GraphLayoutChangeMetrics`, `GraphLayoutChangeOptions`) measures one layout change, as a diagnostic for tests and evaluation: maximum and total displacement of the nodes that had a position, overlapping box pairs and edges through unrelated boxes.
|
|
105
140
|
|
|
106
|
-
#### Timeline and calendars (
|
|
141
|
+
#### Timeline and calendars (`@eightkk/vue-weave/core`)
|
|
107
142
|
|
|
108
143
|
- `calendarZoomPresets(range, options)`: ready `zoomPresets` for hours, days, weeks, months, quarters and years (`CalendarZoomLevel`), each with `pixelsPerUnit`, `tickSteps`, `snap`, header bands from `calendarBands` in an IANA `timeZone` or fixed offset, and a matching `formatTime`, labelled in a `locale`. `calendarBands` takes the new options `locale` and `labelFormat` for locale-aware band labels.
|
|
109
144
|
- `intlTimeFormatter(options)`: a `formatTime`-compatible function on a cached `Intl.DateTimeFormat` for a locale, IANA time zone or fixed offset and format options. It never uses the runtime's default locale or time zone, so server and client output match.
|
|
@@ -158,7 +193,7 @@ This is a minor release because of the changes under "Breaking changes": error m
|
|
|
158
193
|
|
|
159
194
|
### Packaging
|
|
160
195
|
|
|
161
|
-
- Internal declaration files are no longer shipped: the build removes every file under `dist/types` that the declarations of
|
|
196
|
+
- Internal declaration files are no longer shipped: the build removes every file under `dist/types` that the declarations of `@eightkk/vue-weave` and `@eightkk/vue-weave/core` do not reach, and `npm run test:package` fails if one is packed. Deep imports of internal `.d.ts` paths were never supported. The entry declarations, JavaScript and stylesheet are unchanged.
|
|
162
197
|
|
|
163
198
|
## 0.5.0 - 2026-11-17
|
|
164
199
|
|
|
@@ -187,7 +222,7 @@ A `switch` or `Record` over every value of either union needs an entry for the n
|
|
|
187
222
|
|
|
188
223
|
- `TimelineBar.description`: your own text about a bar, for example "Manually scheduled" or "Inactive". It comes first in the bar's accessible description, before the critical, float, deadline, constraint and baseline facts, and after the dates in its native `title`; `exportSvg`, `exportPng` and `renderTimelineSvg` add it to the bar's `<title>`. The accessible name is unchanged, blank text is ignored, and a value that is not a string is reported through `validation-error`. The scheduling demo uses it for its manual and inactive bars.
|
|
189
224
|
|
|
190
|
-
#### Graph analysis (
|
|
225
|
+
#### Graph analysis (`@eightkk/vue-weave/core`)
|
|
191
226
|
|
|
192
227
|
- `graphComponents` (weakly connected components), `graphDegreeCentrality`, `graphBetweennessCentrality` (Brandes, optional edge lengths), `graphPageRank` (returns `{ scores, iterations, converged }`) and `detectGraphCommunities` (deterministic Louvain with modularity and a `resolution`). `graphCommunityGroups` turns communities into `NetworkGraph` `groups`. All validate input like the other graph helpers, iterate instead of recursing and never mutate their arguments.
|
|
193
228
|
|
|
@@ -386,7 +421,7 @@ First public release. The version restarts at 0.1.0; earlier version numbers wer
|
|
|
386
421
|
- `NetworkGraph` with LR/TB layouts, branches, merges, disconnected nodes, directed cycles, self-loops, edge labels and custom layout/rendering.
|
|
387
422
|
- Typed field specs on `TimelineColumn.field` with `parseFieldValue`, `validateFieldValue`, `formatFieldValue` and `fieldValuesEqual`. They separate empty, zero, negative and invalid input and use explicit time zones and duration units.
|
|
388
423
|
- Declarative Gantt view state with `projectTimelineView`, `parseTimelineViewState`, `resolveTimelineColumns` and `useTimelineView`: search with ancestors, stable sibling sort, hidden dependency reporting and JSON-safe saved views.
|
|
389
|
-
- `useEditTransaction` and core edit-transaction types and transitions (
|
|
424
|
+
- `useEditTransaction` and core edit-transaction types and transitions (`@eightkk/vue-weave/core`) for server-confirmed edits with `busy`, `rejected`, `conflict` and `uncertain` handling, stale-response discarding and snapshot-restore undo/redo.
|
|
390
425
|
- `useEditHistory` gains `peekUndo`, `peekRedo` and `replaceCurrent`; existing methods are unchanged.
|
|
391
426
|
- Controlled graph editing with named ports, drag and keyboard connections, endpoint reconnection, box selection, disjoint visual groups, batch movement and a navigable minimap.
|
|
392
427
|
- `GanttChart` with controlled pointer and keyboard editing, validation, cancellation on source changes, lanes, milestones, progress and FS/SS/FF/SF dependencies.
|
|
@@ -397,7 +432,7 @@ First public release. The version restarts at 0.1.0; earlier version numbers wer
|
|
|
397
432
|
- Resource calendars, capacity comparisons and overload intervals with contributing task IDs, plus optional Gantt dependency highlighting.
|
|
398
433
|
- `useEditHistory` for bounded undo and redo over immutable application snapshots.
|
|
399
434
|
- Framework-independent TypeScript core, ESM entry points, Bundler/NodeNext declarations, namespaced themes, localization, typed slots and navigation methods.
|
|
400
|
-
- `vw-` prefixed CSS classes and `--vw-*` theme variables, and a
|
|
435
|
+
- `vw-` prefixed CSS classes and `--vw-*` theme variables, and a `@eightkk/vue-weave/package.json` export so tools can read the installed version.
|
|
401
436
|
- Manufacturing, project delivery, large-resource and scheduling demos; public-entry, SSR, browser and isolated tarball-consumer checks.
|
|
402
437
|
- Verified local release preparation with matching source/demo archives, file inventories, offline smoke checks and SHA-256 records.
|
|
403
438
|
|
package/CONTRIBUTING.md
CHANGED
|
@@ -62,13 +62,13 @@ npm run test:e2e
|
|
|
62
62
|
npm run test:package
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
`check` type-checks the library and examples, builds the library, runs core/SSR tests and rebuilds the demo. Run browser tests after changes to components, styles, examples or accessible names. Browser regression fixtures also load the built library from `dist/`; build both the library and demo first, or use `check` as above. The Playwright server needs port 4173 free; the specs share that one static server and run on two workers (`workers: 2` in `playwright.config.ts`), so a test must not depend on another test, on run order or on server state; `CHROMIUM_PATH` can select an existing Chromium installation. Accessible-name changes may require updating the matching spec file in `test/browser/`, whose files are split by area and share their fixtures and helpers through `test/browser/support.ts`.
|
|
65
|
+
`check` type-checks the library and examples, builds the library, runs core/SSR tests and rebuilds the demo. Run browser tests after changes to components, styles, examples or accessible names. Browser regression fixtures also load the built library from `dist/`; build both the library and demo first, or use `check` as above. The Playwright server needs port 4173 free (or the port in `VW_PORT`); the specs share that one static server and run on two workers (`workers: 2` in `playwright.config.ts`), so a test must not depend on another test, on run order or on server state; `CHROMIUM_PATH` can select an existing Chromium installation. Accessible-name changes may require updating the matching spec file in `test/browser/`, whose files are split by area and share their fixtures and helpers through `test/browser/support.ts`.
|
|
66
66
|
|
|
67
67
|
`test:package` builds and packs the actual release files, rejects unexpected files (including declaration files not reachable from the two public entry declarations: `build` prunes internal ones from `dist/types`), installs the tarball into a temporary consumer, checks core use without Vue, then checks Vue SSR, stylesheet resolution, strict TypeScript consumption (`noUncheckedSideEffectImports`, library checks on) of the same tarball twice, with the pinned development Vue version and again with the minimum version of the `vue` peer range (`^3.5.0`, so Vue 3.5.0), so the declarations cannot rely on types that only newer Vue releases declare, and finally the [public API baseline](#public-api-baseline). It uses the project's existing TypeScript compiler and installs both Vue versions into the consumer in turn; registry access or a populated npm cache is required. It removes that temporary consumer and retains the reviewed tarball in `artifacts/package-check/`, apart from the verified release sets in `artifacts/release/`, which it never writes. It never publishes or changes the repository lockfile. CI runs it on the Node/OS package matrix. Run it after package, declaration, build or export changes and before a release.
|
|
68
68
|
|
|
69
69
|
### Public API baseline
|
|
70
70
|
|
|
71
|
-
[`api/public-api.md`](https://github.com/EightKK/vue-weave/blob/v1.0.0/api/public-api.md) records the public API of the built package: the runtime and type-only export names of `@eightkk/vue-weave` and `@eightkk/vue-weave/core`, the normalized declaration of every export (and of the non-exported types that public signatures refer to), the props, emits, slots and exposed members of
|
|
71
|
+
[`api/public-api.md`](https://github.com/EightKK/vue-weave/blob/v1.0.0/api/public-api.md) records the public API of the built package: the runtime and type-only export names of `@eightkk/vue-weave` and `@eightkk/vue-weave/core`, the normalized declaration of every export (and of the non-exported types that public signatures refer to), the props, emits, slots and exposed members of every component, and the `--vw-*` custom properties in `dist/style.css`. `test:package` fails with a per-item diff when the installed tarball differs from it. To check or regenerate it locally:
|
|
72
72
|
|
|
73
73
|
```sh
|
|
74
74
|
npm run build && node scripts/api-baseline.mjs # check
|
|
@@ -89,28 +89,21 @@ Versions follow [Semantic Versioning](https://semver.org/). From 1.0.0, breaking
|
|
|
89
89
|
|
|
90
90
|
## Prepare a release
|
|
91
91
|
|
|
92
|
-
A maintainer
|
|
92
|
+
A maintainer publishes a GitHub Release. The dedicated npm workflow uses npm Trusted Publishing (OIDC) to publish the same verified tarball for stable releases.
|
|
93
|
+
|
|
94
|
+
Set up the [npm trusted publisher](https://docs.npmjs.com/trusted-publishers/) once in the settings for `@eightkk/vue-weave`. Select GitHub Actions and use account `EightKK`, repository `vue-weave`, workflow filename `publish-npm.yml`, and environment `npm-publish`. Allow direct publishing (`npm publish`). The workflow uses a GitHub-hosted runner and needs no npm token. Trusted publishing needs npm 11.5.1 or later; the workflow stops before downloading anything if the runner's npm is older.
|
|
95
|
+
|
|
96
|
+
Also set the repository's **Settings > Pages > Build and deployment > Source** to **GitHub Actions** once, so the Pages workflow can deploy the demo. GitHub Pages requires a public repository on the Free plan.
|
|
93
97
|
|
|
94
98
|
1. Choose the version by the rules in [Versioning](#versioning) and set it with `npm version <version> --no-git-tag-version`, which updates `package.json` and `package-lock.json` together. Move the `Unreleased` entries into a `## <version> - <YYYY-MM-DD>` changelog entry and leave an empty `Unreleased` section. In `README.md` and `README.ja.md`, update the tarball name in the install instructions and the `v<version>` tag in the absolute image and document URLs (npm shows the README without the repository, so those links point at the release tag). Review package metadata and distribution rights for source, examples and assets.
|
|
95
99
|
2. From the final source revision, run `npm ci`, the checks in [Verify a pull request](#verify-a-pull-request), `npm pack --dry-run` and `npm audit`. Review every failure and inspect the actual packed file list. CI covers Node.js 22 and 24 on Linux and Windows, with Chromium interactions on Linux; use the results for the release commit.
|
|
96
100
|
3. Verify that private vulnerability reporting is enabled under the repository's **Settings > Advanced Security**. GitHub offers it only for public repositories, so enable it as soon as the repository is public. Review the source, package contents and Git history for credentials, personal data and confidential examples. Preserve project and third-party notices.
|
|
97
|
-
4. Run `npm run prepare:release` (below)
|
|
98
|
-
5. Create the `v<version>` tag on the checked revision
|
|
99
|
-
6.
|
|
100
|
-
|
|
101
|
-
```sh
|
|
102
|
-
npm publish <path-to-verified-tgz> --access public
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
7. Check that the registry holds the same bytes. The integrity npm reports must equal the local SHA-512 of the tarball:
|
|
106
|
-
|
|
107
|
-
```sh
|
|
108
|
-
npm view @eightkk/vue-weave@<version> dist.integrity
|
|
109
|
-
node -e "console.log('sha512-' + require('node:crypto').createHash('sha512').update(require('node:fs').readFileSync(process.argv[1])).digest('base64'))" <path-to-verified-tgz>
|
|
110
|
-
```
|
|
101
|
+
4. Run `npm run prepare:release` (below) to produce the verified tarball and offline demo under `artifacts/release/<version>/`.
|
|
102
|
+
5. Create and push the `v<version>` tag on the checked revision from `main`. The tagged revision must contain the npm workflow.
|
|
103
|
+
6. Draft the GitHub Release with the changelog entry as its notes. Attach `eightkk-vue-weave-<version>.tgz`, `eightkk-vue-weave-<version>-source-demo.tar.gz`, and `SHA256SUMS` before publishing the Release.
|
|
104
|
+
7. Check the **Publish to npm** run in Actions. It checks the tarball checksum and package version before publication, then waits up to about 90 seconds for the registry to list the version and compares its integrity with the attached tarball. Rerun a failed job after fixing its cause. If npm already holds the same bytes, the rerun succeeds without uploading again. If npm holds different bytes, investigate and release a new version.
|
|
111
105
|
|
|
112
|
-
|
|
113
|
-
8. Create the GitHub Release from the `v<version>` tag. Attach the same tarball bytes that were published, `eightkk-vue-weave-<version>-source-demo.tar.gz` and `SHA256SUMS` from `artifacts/release/<version>/`, and use the changelog entry as the release notes.
|
|
106
|
+
The workflow publishes every stable release with the `latest` dist-tag. After a patch release for an older release line (for example 1.0.4 after 1.1.0), move `latest` back to the newest version with `npm dist-tag add @eightkk/vue-weave@<newest-version> latest`.
|
|
114
107
|
|
|
115
108
|
To prepare matching local package and offline-demo candidates, install Chromium once with `npx playwright install chromium`, then run:
|
|
116
109
|
|
|
@@ -120,4 +113,4 @@ npm run prepare:release
|
|
|
120
113
|
|
|
121
114
|
This command reruns the full check, browser tests, package-consumer tests (including the public API baseline) and dependency audit. It requires registry access (or a populated npm cache), Chromium and a `tar` executable, which is supplied by current Windows and Linux environments. It uses an explicit source-file allowlist, rejects symlinks, and excludes `.git`, `node_modules`, local settings, credentials and test output. It checks that source files stay unchanged during verification, creates an archive with the generated `preview/`, compares every extracted file against the source inventory, and smoke-tests the extracted demo without installing dependencies. Each run writes all of its files (tarball, source archive, `SHA256SUMS` and `release-verification.json`) into a new candidate directory `artifacts/.candidate-*`, then checks that the checksums and the record match the files. Only then does it move that set into `artifacts/release/<version>/` with two directory renames, replacing the previous set for that version as a whole. If any step fails, the candidate is deleted and the previous verified set stays unchanged; a run that is killed can leave a `.candidate-*` directory, which is safe to delete. `VW_RELEASE_FAIL_AT=after-package`, `before-promote` or `during-promote` simulates a failure at that point, and `test/release-candidate.test.mjs` covers these cases. The verification record lists file hashes and outstanding publication checks; it does not certify distribution rights, Git history or hosted settings. No publishing, tags or repository changes are performed. Review the allowlisted source files for confidential content before sharing them. GitHub's generated source ZIP omits ignored `preview/` and requires a demo build.
|
|
122
115
|
|
|
123
|
-
|
|
116
|
+
The Pages workflow builds the public demo from `main` and deploys `preview/` to [GitHub Pages](https://eightkk.github.io/vue-weave/). The local preview server binds to `127.0.0.1`.
|
package/README.ja.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# Vue Weave
|
|
2
2
|
|
|
3
|
-
[](https://github.com/EightKK/vue-weave/actions/workflows/ci.yml) [](https://github.com/EightKK/vue-weave/blob/v1.
|
|
3
|
+
[](https://github.com/EightKK/vue-weave/actions/workflows/ci.yml) [](https://github.com/EightKK/vue-weave/blob/v1.2.0/LICENSE)
|
|
4
4
|
|
|
5
|
-
[English](https://github.com/EightKK/vue-weave/blob/v1.
|
|
5
|
+
[English](https://github.com/EightKK/vue-weave/blob/v1.2.0/README.md)
|
|
6
6
|
|
|
7
|
-
[ソースコード](https://github.com/EightKK/vue-weave) · [課題・問い合わせ](https://github.com/EightKK/vue-weave/issues) · [リリース](https://github.com/EightKK/vue-weave/releases)
|
|
7
|
+
[デモを試す](https://eightkk.github.io/vue-weave/) · [ソースコード](https://github.com/EightKK/vue-weave) · [課題・問い合わせ](https://github.com/EightKK/vue-weave/issues) · [リリース](https://github.com/EightKK/vue-weave/releases)
|
|
8
8
|
|
|
9
9
|
Vue 3でネットワークグラフとガントチャートを実装するためのライブラリです。関係の探索、工程フロー、製造のロット系譜、プロジェクト工程、設備・担当者別の予定などを、型付きの2つのコンポーネントで作れます。グラフ・日程計算・設備負荷の計算は、Node.js、Worker、サーバーでも動くヘッドレスのコアで行えます。
|
|
10
10
|
|
|
@@ -26,17 +26,17 @@ Vue `^3.5.0` をpeer dependencyとしています。npm 7以降では、アプ
|
|
|
26
26
|
import '@eightkk/vue-weave/style.css'
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
Viteではこのままimportできます。`tsconfig.json` で `noUncheckedSideEffectImports` を有効にしている場合や、CSSを扱えないビルド環境の場合は、[The stylesheet and TypeScript](https://github.com/EightKK/vue-weave/blob/v1.
|
|
29
|
+
Viteではこのままimportできます。`tsconfig.json` で `noUncheckedSideEffectImports` を有効にしている場合や、CSSを扱えないビルド環境の場合は、[The stylesheet and TypeScript](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#the-stylesheet-and-typescript)を参照してください。
|
|
30
30
|
|
|
31
|
-
**コアだけを使う場合(サーバー・Worker)。** `@eightkk/vue-weave/core` は実行時にVueを必要とせず、Node.js 22.18以降、Worker、サーバーで動作します。ただしVueは必須のpeer dependencyで、optionalなpeerとしては設定していないため、`npm install @eightkk/vue-weave` でVueもインストールされます。コアだけを配備する環境でVueを除くには `--omit=peer` を付けてインストールします。詳しくは[Core only: servers and Workers](https://github.com/EightKK/vue-weave/blob/v1.
|
|
31
|
+
**コアだけを使う場合(サーバー・Worker)。** `@eightkk/vue-weave/core` は実行時にVueを必要とせず、Node.js 22.18以降、Worker、サーバーで動作します。ただしVueは必須のpeer dependencyで、optionalなpeerとしては設定していないため、`npm install @eightkk/vue-weave` でVueもインストールされます。コアだけを配備する環境でVueを除くには `--omit=peer` を付けてインストールします。詳しくは[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
|
-
**オフラインでのインストール。** 各[GitHub Release](https://github.com/EightKK/vue-weave/releases)には、npmに公開したものと同じパッケージのtarballも添付しています。`eightkk-vue-weave-1.
|
|
33
|
+
**オフラインでのインストール。** 各[GitHub Release](https://github.com/EightKK/vue-weave/releases)には、npmに公開したものと同じパッケージのtarballも添付しています。`eightkk-vue-weave-1.2.0.tgz` をダウンロードし、利用するアプリケーションのフォルダーからインストールします。次のパスは実際のファイルのパスに置き換えます。
|
|
34
34
|
|
|
35
35
|
```sh
|
|
36
|
-
npm install ./eightkk-vue-weave-1.
|
|
36
|
+
npm install ./eightkk-vue-weave-1.2.0.tgz
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
チェックアウトから[ローカルパッケージを作成](https://github.com/EightKK/vue-weave/blob/v1.
|
|
39
|
+
チェックアウトから[ローカルパッケージを作成](https://github.com/EightKK/vue-weave/blob/v1.2.0/CONTRIBUTING.md#build-a-local-package)することもできます。
|
|
40
40
|
|
|
41
41
|
## クイックスタート
|
|
42
42
|
|
|
@@ -142,40 +142,40 @@ const activate = (event: ViewTargetEvent) => linked.select(event.target.view, [e
|
|
|
142
142
|
</template>
|
|
143
143
|
```
|
|
144
144
|
|
|
145
|
-
ホバー、負荷行、折り畳まれた項目への移動は [Linking views](https://github.com/EightKK/vue-weave/blob/v1.
|
|
145
|
+
ホバー、負荷行、折り畳まれた項目への移動は [Linking views](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#linking-views) を、`useEditTransaction` は [Saving through a server](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#saving-through-a-server) を参照してください。
|
|
146
146
|
|
|
147
147
|
## ギャラリー
|
|
148
148
|
|
|
149
149
|
画像はすべて、このリポジトリの[デモ](#デモを起動する)の画面です。
|
|
150
150
|
|
|
151
|
-

|
|
152
152
|
|
|
153
|
-

|
|
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.
|
|
158
|
+
<img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/process-lanes.png" alt="工程レーンのデモ。機械加工の工程を4つの部門レーン(購買、加工、検査、空の出荷レーン)に配置し、部門間の受け渡しを表す直角の辺がレーン境界をまたぎ、ミニマップにもレーンが表示されている" width="100%"><br>
|
|
159
159
|
<b>スイムレーン。</b>部門や作業区ごとのレーンを指定した順に並べます(<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.
|
|
162
|
+
<img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/quantity-flow.png" alt="数量フローのデモ。100個のロットが2つのラインに60対40で分かれ、検査で合流し、Bラインで4個減り、10個が手戻りとして破線の帯でループするサンキー図と、工程ごとの流入量・流出量・差の表" width="100%"><br>
|
|
163
163
|
<b>数量フロー。</b>辺を数量に比例した太さの帯として、図全体で同じ縮尺で描きます(<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.
|
|
168
|
+
<img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/linked-views.png" alt="ビュー連動のデモ。ガントチャートで「Cut order A」を選択すると、上のネットワークグラフと下のCNCセルの負荷行でも同じタスクが強調され、負荷行では赤い区間が負荷超過を示している" width="100%"><br>
|
|
169
169
|
<b>ビューの連動。</b>一つのビューで選ぶと、グラフ、ガントチャート、負荷行で同じタスクが強調されます(<code>useLinkedSelection</code>)。
|
|
170
170
|
</td>
|
|
171
171
|
<td width="50%" valign="top">
|
|
172
|
-
<img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.
|
|
172
|
+
<img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/plan-comparison.png" alt="計画シナリオのデモ。保守時間帯の後へ切断作業を送る候補計画を現行計画と比較し、最終完了、期限超過、割り当ての変更、CNCセルの負荷超過を表にまとめ、ガントチャートでは各候補バーの下に現行計画を細い帯で表示している" width="100%"><br>
|
|
173
173
|
<b>計画シナリオ。</b>候補計画を採用する前に現行計画と比較します(<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.
|
|
178
|
+
<img src="https://raw.githubusercontent.com/EightKK/vue-weave/v1.2.0/.github/images/diagram-styles-dark.png" alt="ダークテーマで表示したダイアグラム表現のデモ。楕円、ひし形、六角形のノード、主経路の破線のアニメーション辺、白抜き矢印や丸の端の記号、左右に振り分けた平行な辺の組を含む受注処理フロー" width="100%"><br>
|
|
179
179
|
<b>ダイアグラム表現とダークテーマ。</b>ノード形状、辺の端の記号、アニメーションする辺と平行な辺、組み込みのダークテーマ。
|
|
180
180
|
</td>
|
|
181
181
|
<td width="50%" valign="top">
|
|
@@ -186,36 +186,48 @@ const activate = (event: ViewTargetEvent) => linked.select(event.target.view, [e
|
|
|
186
186
|
|
|
187
187
|
## 機能
|
|
188
188
|
|
|
189
|
-
基本機能以外はすべてオプトインです。ここでは概要を示します。props、イベント、スロット、関数の一覧は [docs/api.md](https://github.com/EightKK/vue-weave/blob/v1.
|
|
189
|
+
基本機能以外はすべてオプトインです。ここでは概要を示します。props、イベント、スロット、関数の一覧は [docs/api.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md) に、手順は [docs/integration.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md) と [docs/scheduling.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md) にあります。
|
|
190
190
|
|
|
191
191
|
### NetworkGraph
|
|
192
192
|
|
|
193
|
-
- **レイアウト:** 分岐・合流、閉路、自己ループに対応した標準の階層レイアウト(`LR`・`TB`・`RL`・`BT`。`crossingReduction: 'barycenter'` で交差を削減)。`layout` propでは、木、放射状、円形、格子、同心円、決定的な力学モデルの各配置(`layoutTreeGraph`、`layoutRadialGraph`、`layoutCircularGraph`、`layoutGridGraph`、`layoutConcentricGraph`、`layoutForceGraph`)や、アプリケーションで導入した[ELK.js](https://github.com/EightKK/vue-weave/blob/v1.
|
|
194
|
-
- **工程レーン:** `layoutSwimlaneGraph` は部門や作業区ごとのレーンを指定した順に並べます。`lanes` propで帯を描き、ミニマップと書き出しにも反映されます。ドラッグしたノードが入るレーンは `graphSwimlaneAt` で判定できます。詳しくは[Swimlanes for process flows](https://github.com/EightKK/vue-weave/blob/v1.
|
|
195
|
-
-
|
|
193
|
+
- **レイアウト:** 分岐・合流、閉路、自己ループに対応した標準の階層レイアウト(`LR`・`TB`・`RL`・`BT`。`crossingReduction: 'barycenter'` で交差を削減)。`layout` propでは、木、放射状、円形、格子、同心円、決定的な力学モデルの各配置(`layoutTreeGraph`、`layoutRadialGraph`、`layoutCircularGraph`、`layoutGridGraph`、`layoutConcentricGraph`、`layoutForceGraph`)や、アプリケーションで導入した[ELK.js](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#use-elkjs-for-layout)の結果を使えます。
|
|
194
|
+
- **工程レーン:** `layoutSwimlaneGraph` は部門や作業区ごとのレーンを指定した順に並べます。`lanes` propで帯を描き、ミニマップと書き出しにも反映されます。ドラッグしたノードが入るレーンは `graphSwimlaneAt` で判定できます。詳しくは[Swimlanes for process flows](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#swimlanes-for-process-flows)を参照してください。
|
|
195
|
+
- **BPMNとフローチャート:** 円・スタジアム・平行四辺形・書類・円柱・データオブジェクトのノード、BPMNのイベント枠線、ゲートウェイ・イベント・タスク種別の記号、小さな図形の下に置くラベル、破線のメッセージフロー、スイムレーンを囲むプール(`pools`)。書き出しにも反映されます。詳しくは[BPMN processes and flowcharts](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#bpmn-processes-and-flowcharts)を参照してください。
|
|
196
|
+
- **数量フロー(サンキー図):** `layoutFlowGraph` は各辺を数量に応じた太さにして図全体で同じ縮尺で描き、ノードごとの流入量・流出量とその差を補正せずに報告します。単位の異なる数量は合算せず、手戻りのループは破線の参照帯にします。`edgeBands` propは「Cut → Inspect: 60 pcs」のような名前付きで帯を描きます。詳しくは[Quantity flows](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#quantity-flows-sankey-diagrams)を参照してください。
|
|
196
197
|
- **描画:** 独自のSVGを描く `node`・`edge`・`group`・`minimap-node` スロット、HTMLを表示する `tooltip`・`node-toolbar`・`edge-toolbar` スロット。ひし形・楕円・六角形のノード、直角・直線の辺(`edgeStyle`)、ノードを避ける経路(`avoidNodes`)、経由点、端の記号、アニメーションする辺、平行な辺の振り分け。
|
|
197
198
|
- **変更案としての編集:** ノードの移動、型付きのポートルール(`connectionRules`)で検査する接続と接続先のヒント、ラベルのその場編集、矩形・投げ縄による選択、入れ子で折りたためるグループ、ノードのサイズ変更、グリッドへの吸着と整列ガイド、パレットからのドロップ、クリップボード、キーボードによる削除。
|
|
198
199
|
- **表示範囲の操作:** ミニマップ、大規模グラフ向けの表示範囲外の描画省略と縮小時の簡略表示、ピンチズーム、検索結果の強調(`matchIds`)、`focusNode(id)`、`fit({ ids })`。
|
|
200
|
+
- **ダイアグラムエディタ部品:** `GraphPalette` はノードのテンプレートを並べ、グラフへのドラッグとキーボードでの追加を提供します。`PropertyInspector` は選択中のノードを型付きフィールドで編集します。どちらも変更案をイベントで通知します。詳しくは[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
|
- **表示:** 複数レーン、進捗率、マイルストーン、ラグのラベル付きのFS/SS/FF/SF依存関係。サマリーの集約バーと、オプトインのサマリー行への依存関係を持つ階層行。差異付きで最大3つの名前付きベースライン。多段見出し、日時マーカー、期間の強調(`markerRanges`)。ステータス日付線とイナズマ線。非稼働時間の網掛け。クリティカルパスの枠線、余裕の線、期限、分割バー。`calculateResourceLoad` の出力をそのまま渡せる設備負荷のヒストグラム(`loadRows`)。
|
|
203
205
|
- **変更案としての編集:** ドラッグとキーボードによる移動・伸縮、移動に連動して動くバーのプレビュー(`cascade`)、依存関係の作成と付け替え、複数選択と一括移動、ドラッグによるバーの作成、進捗率のスライダー、削除、行の階層移動、列幅の変更、スケジュール制約のハンドル、型付きのセル編集(`field-edit`)、アプリの一覧からのドロップ(`bar-drop`)。
|
|
206
|
+
- **スプレッドシート編集(`spreadsheet`):** セル範囲の選択、Excel や Google スプレッドシートとのコピー・切り取り・貼り付け、Delete による消去、Ctrl/⌘+D や右下のハンドルによる下方向のコピー、文字入力による編集。操作ごとに一つの `sheet-edit` 変更案として届き、`validateSheetEdit` で一括で却下でき、`applyTimelineSheetEdit` で反映できます。デモには、表からスケジューラーがバー・矢印・クリティカルパスを計算する工程表と、購買申請の承認フローの編集画面があります。
|
|
204
207
|
- **時間軸:** ズームプリセット、IANAタイムゾーンとロケールに沿ったカレンダー用プリセット(`calendarZoomPresets`、`intlTimeFormatter`)、非稼働時間を圧縮する時間軸(`createWorkingTimeScale`)、Ctrl+ホイールとピンチによるズーム、現在時刻マーカー、`fitToBars()`。
|
|
205
208
|
- **大規模データ:** 行と表示時間範囲の仮想化。表示中の週と行だけを読み込むための `visible-window-change`。
|
|
209
|
+
### EventCalendar
|
|
210
|
+
- **表示:** IANA タイムゾーンとロケールに従う日・週・月ビュー、複数日にまたがる予定のための終日行、月表示の「+N more」、現在時刻の線、組み込みツールバー(スロットで置き換え可能)。`resources` を渡すと、日ビューに会議室・設備・担当者ごとの列を表示します。
|
|
211
|
+
- **提案としての編集:** ドラッグとキーボードによる移動とリサイズ、リソース間の移動、ドラッグでの新規作成。同期の `validateEdit` と `validateCreate` で検証できます。`range-change` が表示範囲を通知するので必要な範囲だけ読み込めます。コアのヘルパー(`eventCalendarRange`、`layoutCalendarDayEvents`、`packCalendarEventLanes`)はサーバーでも動きます。
|
|
212
|
+
|
|
213
|
+
### TaskBoard
|
|
214
|
+
|
|
215
|
+
- **カンバンボード:** オプトインの3つ目の制御コンポーネント。カードをステータス列に並べ、必要ならスイムレーンで分けます。列にはカード数を表示し、WIP制限を超えると警告します。ポインターとタッチのドラッグ(ドロップ位置の表示と自動スクロール付き)とキーボード(Space、矢印キー、Enter、Escape、ライブリージョンでの読み上げ付き)で `card-move` を提案し、`validateCardMove` で却下でき、`applyBoardCardMove` で適用できます。GanttChart と同じタスクと選択を共有できます。[TaskBoard](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md#taskboard) を参照してください。
|
|
206
216
|
|
|
207
217
|
### ヘッドレスコア(`@eightkk/vue-weave/core`)
|
|
208
218
|
|
|
209
219
|
- **グラフのアルゴリズムと指標:** `topologicalOrder`、`findGraphCycles`、`shortestGraphPath`、`searchGraphNodes`、`filterGraph`、連結成分、次数・媒介・PageRankの各中心性、Louvain法によるコミュニティ検出(`detectGraphCommunities`)と、その結果をグループに変換する `graphCommunityGroups`。
|
|
210
220
|
- **日程計算:** `buildWorkPeriods` で作るカレンダー(IANAタイムゾーンを含む)上での `scheduleTasks`。最遅開始、手動・非アクティブ・サマリーのタスク、制約、中断区間、循環や実行不能の診断に対応します。`scheduleTasks(input, { explain: true })` は各タスクの開始が決まった理由をトレースし、`toPlanningDiagnostics` は問題を一覧にします。
|
|
211
221
|
- **リソース:** `calculateResourceLoad` と `levelResources`。時間とともに変わる能力(`capacityPeriods`)や、タスクの一部だけを占める割り当て(`workOffset`、`workDuration`)にも対応します。`projectResourceTimeline` はリソース別に計画を表示し、`buildPlacementInput` は未計画タスクを計算から除きます。
|
|
212
|
-
- **計画の更新:** `propagateEdit`、`rescheduleFromStatusDate`、`rescheduleFromActuals`(記録した実績を保ち、残りを予測)、そして編集した内容と結果として動いた内容を分けて示す `comparePlans`。詳しくは[Compare plan scenarios](https://github.com/EightKK/vue-weave/blob/v1.
|
|
222
|
+
- **計画の更新:** `propagateEdit`、`rescheduleFromStatusDate`、`rescheduleFromActuals`(記録した実績を保ち、残りを予測)、そして編集した内容と結果として動いた内容を分けて示す `comparePlans`。詳しくは[Compare plan scenarios](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md#compare-plan-scenarios)を参照してください。
|
|
223
|
+
- **アーンドバリュー:** `computeEarnedValue` はステータス日時点のPV・EV・ACと、SV・CV・SPI・CPI・EAC・ETC・VAC・TCPIをタスク別と合計で計算します。計画価値は稼働カレンダー上で積み上げ、Sカーブ用の累積系列も返します。`rollupEarnedValue` はサマリー行を集計します。詳しくは[Earned value management](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md#earned-value-management)を参照してください。
|
|
213
224
|
- **データ交換:** Microsoft Project XML(カレンダー、リソース、割り当てを含む)、iCalendar、CSVの読み込みと書き出し(`fromMsProjectXml`、`toMsProjectXml`、`fromICalendar`、`toICalendar`、`parseCsv`、`toCsv`)。日程をPERT図にする `scheduleToGraph`。
|
|
225
|
+
- **ダイアグラムファイル:** NetworkGraphの図を、Mermaidフローチャート、GraphML(yEdを含む)、draw.ioで読み込み・書き出し。入れ子のグループ、形状、位置、サイズに対応(`fromMermaid`、`toMermaid`、`fromGraphMl`、`toGraphMl`、`fromDrawio`、圧縮ファイル用の `fromDrawioAsync`、`toDrawio`)。
|
|
214
226
|
|
|
215
227
|
### ビューの連動・大規模データ・保存
|
|
216
228
|
|
|
217
|
-
- **ビューの連動:** `useLinkedSelection` はグラフ、ガントチャート、負荷行をエンティティの対応づけで連動させます。`revealNode`、`revealBar`、`revealLinkedTarget` は折り畳まれたグループや行の中も含めて項目へ移動し、`timelineBarsInRange` と `resolveTimeRangeTargets` はある時間範囲に作業していた対象を強調します。詳しくは[Linking views](https://github.com/EightKK/vue-weave/blob/v1.
|
|
218
|
-
- **大規模データ:** `useWindowedData` はアプリの `load` 関数を通じて表示中の範囲だけを取得し、中断、重複排除、再試行に対応します。グラフ展開ヘルパーと `layoutGraphIncrementally` は、表示中のノードを動かさずにグラフを1ホップずつ読み込みます。`useAsyncGraphLayout` はWorkerでレイアウトを計算し、`routingPolicy="preserve"` はエンジンの配線を保持します。詳しくは[Loading only what is visible](https://github.com/EightKK/vue-weave/blob/v1.
|
|
229
|
+
- **ビューの連動:** `useLinkedSelection` はグラフ、ガントチャート、負荷行をエンティティの対応づけで連動させます。`revealNode`、`revealBar`、`revealLinkedTarget` は折り畳まれたグループや行の中も含めて項目へ移動し、`timelineBarsInRange` と `resolveTimeRangeTargets` はある時間範囲に作業していた対象を強調します。詳しくは[Linking views](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md#linking-views)を参照してください。
|
|
230
|
+
- **大規模データ:** `useWindowedData` はアプリの `load` 関数を通じて表示中の範囲だけを取得し、中断、重複排除、再試行に対応します。グラフ展開ヘルパーと `layoutGraphIncrementally` は、表示中のノードを動かさずにグラフを1ホップずつ読み込みます。`useAsyncGraphLayout` はWorkerでレイアウトを計算し、`routingPolicy="preserve"` はエンジンの配線を保持します。詳しくは[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
|
- **表示と保存:** 行を検索・並べ替える `useTimelineView`、Undo/Redoの `useEditHistory`、サーバーのアダプターを通じて版競合も扱いながら保存する `useEditTransaction`、版付きで検証されたJSONとして保存・復元する `serializeWeaveSnapshot` と `restoreWeaveSnapshot`。
|
|
220
232
|
|
|
221
233
|
### 書き出し・テーマ・アクセシビリティ
|
|
@@ -232,16 +244,16 @@ const png = await chart.value!.exportPng({ scale: 2 })
|
|
|
232
244
|
|
|
233
245
|
## 対応状況
|
|
234
246
|
|
|
235
|
-
- **バージョン1.0です。** [セマンティックバージョニング](https://semver.org/lang/ja/)に従い、破壊的変更はメジャーリリースだけで行い、[変更履歴](https://github.com/EightKK/vue-weave/blob/v1.
|
|
247
|
+
- **バージョン1.0です。** [セマンティックバージョニング](https://semver.org/lang/ja/)に従い、破壊的変更はメジャーリリースだけで行い、[変更履歴](https://github.com/EightKK/vue-weave/blob/v1.2.0/CHANGELOG.md)の「Breaking changes」に記載します。対象となるもの(エクスポートされた名前と型、props、イベント、スロット、ドキュメントに記載した `--vw-*` 変数、スナップショットの形式)と対象外のもの(エラーメッセージの文言、コンポーネントが出力する `vw-` クラス、DOM構造、サーバーレンダリングのマークアップ)は[Compatibility and versioning](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md#compatibility-and-versioning)に記載しています。
|
|
236
248
|
- **Vue:** 3.x の3.5以降(peer dependency `^3.5.0`)。
|
|
237
249
|
- **モジュールとTypeScript:** ESMのみ。型定義は `Bundler` と `NodeNext` の型解決に対応しています。項目の `data` に型を付けられ(`NetworkNode<MyData>`、`TimelineBar<MyData>`)、その型がキャストなしでスロットのpropsやコールバックに渡ります。
|
|
238
250
|
- **Node.js:** ヘッドレスの `@eightkk/vue-weave/core`、サーバーサイドレンダリング、開発には22.18以降が必要です。
|
|
239
251
|
- **ブラウザー:** 最新の主要ブラウザー(Chrome、Edge、Firefox、Safari)。自動ブラウザーテストはChromiumのみで実行するため、ほかのブラウザーはCIの対象外です。
|
|
240
|
-
- **アクセシビリティ:** キーボード操作とARIA名を備えています。専用のスクリーンリーダーでの検証はまだ行っていません([構成、性能上の扱い、対応範囲](https://github.com/EightKK/vue-weave/blob/v1.
|
|
252
|
+
- **アクセシビリティ:** キーボード操作とARIA名を備えています。専用のスクリーンリーダーでの検証はまだ行っていません([構成、性能上の扱い、対応範囲](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/architecture.md)を参照)。十分に対応していると想定しないでください。
|
|
241
253
|
|
|
242
254
|
## デモを起動する
|
|
243
255
|
|
|
244
|
-
|
|
256
|
+
デモは[GitHub Pages](https://eightkk.github.io/vue-weave/)で公開しています。`main`から再ビルドされるため、最新リリースより新しい内容のことがあります。ローカルで起動するには、Node.js 22.18以降とnpmを用意します。cloneしたソースやGitHubのソースZIPのフォルダーで次を実行します。
|
|
245
257
|
|
|
246
258
|
```sh
|
|
247
259
|
npm ci
|
|
@@ -249,27 +261,29 @@ npm run build:demo
|
|
|
249
261
|
npm start
|
|
250
262
|
```
|
|
251
263
|
|
|
252
|
-
|
|
264
|
+
トップページでは「製造計画」と「ロットの流れ」を試せます。ほかの作例は「サンプル集」から開けます。
|
|
265
|
+
|
|
266
|
+
サンプル集には例ごとのページ([ギャラリー](#ギャラリー)を参照)、書き出しボタン、テーマ切り替え、採用済みの変更を戻す **Undo**/**Redo** があります。**Edit graph** や **Planning overlays** などの切り替えで、上記のオプトイン機能を試せます。**Design gallery** の行では、同じ2つのコンポーネントをスロット、`--vw-*` 変数、`vw-` クラスだけで作り替えています。編集結果はデモ画面内の状態として保持します。デモの未計画一覧、インスペクター、診断一覧、ツールバーは `examples/components/` の参考実装で、パッケージには含まれません。
|
|
253
267
|
|
|
254
268
|
Windowsでは代わりに `Start.cmd` をダブルクリックしても起動できます。`preview/` が現在のソースからビルドされたものであればそのまま表示し、そうでなければ先にビルドします。インストール済みの依存関係が `package-lock.json` と一致しない場合は、ビルドの前に `npm ci` も実行します。`npm start` は `preview/` をそのまま表示します。
|
|
255
269
|
|
|
256
270
|
`preview/` を含むビルド済みデモのアーカイブ(リリースに添付されることがあります)を使う場合は、全体を展開して `npm start` を実行するか、Windowsで `Start.cmd` をダブルクリックします。ビルド済みデモはNode.jsがあれば依存関係のインストールなしで起動できます。ソースを変更した場合は `Start.cmd` がデモをビルドし直します。初回はnpmとインターネット接続が必要です。
|
|
257
271
|
|
|
258
|
-
開発・検証コマンドは[Contributing](https://github.com/EightKK/vue-weave/blob/v1.
|
|
272
|
+
開発・検証コマンドは[Contributing](https://github.com/EightKK/vue-weave/blob/v1.2.0/CONTRIBUTING.md)を参照してください。
|
|
259
273
|
|
|
260
274
|
## ドキュメント
|
|
261
275
|
|
|
262
276
|
API、コメント、詳細ドキュメントは英語です。
|
|
263
277
|
|
|
264
|
-
- [入力型と公開API](https://github.com/EightKK/vue-weave/blob/v1.
|
|
265
|
-
- [Vue・Nuxtへの組み込み、独自描画、時間軸、保存処理](https://github.com/EightKK/vue-weave/blob/v1.
|
|
266
|
-
- [構成、性能上の扱い、対応範囲](https://github.com/EightKK/vue-weave/blob/v1.
|
|
267
|
-
- [日程計算と設備負荷](https://github.com/EightKK/vue-weave/blob/v1.
|
|
268
|
-
- [開発とリリース手順](https://github.com/EightKK/vue-weave/blob/v1.
|
|
269
|
-
- [セキュリティ方針と脆弱性の非公開報告](https://github.com/EightKK/vue-weave/blob/v1.
|
|
270
|
-
- [行動規範](https://github.com/EightKK/vue-weave/blob/v1.
|
|
271
|
-
- [変更履歴](https://github.com/EightKK/vue-weave/blob/v1.
|
|
278
|
+
- [入力型と公開API](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/api.md)
|
|
279
|
+
- [Vue・Nuxtへの組み込み、独自描画、時間軸、保存処理](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/integration.md)
|
|
280
|
+
- [構成、性能上の扱い、対応範囲](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/architecture.md)
|
|
281
|
+
- [日程計算と設備負荷](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/scheduling.md)
|
|
282
|
+
- [開発とリリース手順](https://github.com/EightKK/vue-weave/blob/v1.2.0/CONTRIBUTING.md)
|
|
283
|
+
- [セキュリティ方針と脆弱性の非公開報告](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/security.md)
|
|
284
|
+
- [行動規範](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/code-of-conduct.md)
|
|
285
|
+
- [変更履歴](https://github.com/EightKK/vue-weave/blob/v1.2.0/CHANGELOG.md)
|
|
272
286
|
|
|
273
287
|
## ライセンス
|
|
274
288
|
|
|
275
|
-
MITです。[LICENSE](https://github.com/EightKK/vue-weave/blob/v1.
|
|
289
|
+
MITです。[LICENSE](https://github.com/EightKK/vue-weave/blob/v1.2.0/LICENSE) を参照してください。ビルド済みデモの第三者ライセンス表示は [THIRD_PARTY_NOTICES.md](https://github.com/EightKK/vue-weave/blob/v1.2.0/THIRD_PARTY_NOTICES.md) と [Third-party licenses](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/third-party-licenses.md) にあります。
|