@eightkk/vue-weave 1.1.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 +34 -7
- package/CONTRIBUTING.md +2 -2
- package/README.ja.md +45 -34
- package/README.md +45 -34
- package/dist/{core-LWK21xl4.js → core-C7J4FG_e.js} +4959 -2248
- package/dist/core.js +1 -1
- package/dist/index.js +5100 -3005
- package/dist/style.css +1 -1
- package/dist/types/components/EventCalendar.vue.d.ts +105 -0
- 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 +11 -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/taskBoard.d.ts +150 -0
- package/dist/types/core/types.d.ts +26 -1
- package/dist/types/index.d.ts +44 -0
- package/docs/api.md +358 -0
- package/docs/architecture.md +6 -2
- package/docs/integration.md +147 -0
- package/docs/scheduling.md +31 -0
- package/docs/security.md +1 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,33 @@
|
|
|
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
|
+
|
|
7
34
|
## 1.1.0 - 2026-11-21
|
|
8
35
|
|
|
9
36
|
Adds spreadsheet editing to GanttChart. All changes are additive; nothing from 1.0.0 changes or is removed.
|
|
@@ -18,7 +45,7 @@ This is the first stable release. From here on the package follows SemVer as def
|
|
|
18
45
|
|
|
19
46
|
### Breaking changes
|
|
20
47
|
|
|
21
|
-
- 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.
|
|
22
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.
|
|
23
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.
|
|
24
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.
|
|
@@ -105,13 +132,13 @@ This is a minor release because of the changes under "Breaking changes": error m
|
|
|
105
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.
|
|
106
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).
|
|
107
134
|
|
|
108
|
-
#### Graph core (
|
|
135
|
+
#### Graph core (`@eightkk/vue-weave/core`)
|
|
109
136
|
|
|
110
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`.
|
|
111
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).
|
|
112
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.
|
|
113
140
|
|
|
114
|
-
#### Timeline and calendars (
|
|
141
|
+
#### Timeline and calendars (`@eightkk/vue-weave/core`)
|
|
115
142
|
|
|
116
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.
|
|
117
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.
|
|
@@ -166,7 +193,7 @@ This is a minor release because of the changes under "Breaking changes": error m
|
|
|
166
193
|
|
|
167
194
|
### Packaging
|
|
168
195
|
|
|
169
|
-
- 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.
|
|
170
197
|
|
|
171
198
|
## 0.5.0 - 2026-11-17
|
|
172
199
|
|
|
@@ -195,7 +222,7 @@ A `switch` or `Record` over every value of either union needs an entry for the n
|
|
|
195
222
|
|
|
196
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.
|
|
197
224
|
|
|
198
|
-
#### Graph analysis (
|
|
225
|
+
#### Graph analysis (`@eightkk/vue-weave/core`)
|
|
199
226
|
|
|
200
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.
|
|
201
228
|
|
|
@@ -394,7 +421,7 @@ First public release. The version restarts at 0.1.0; earlier version numbers wer
|
|
|
394
421
|
- `NetworkGraph` with LR/TB layouts, branches, merges, disconnected nodes, directed cycles, self-loops, edge labels and custom layout/rendering.
|
|
395
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.
|
|
396
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.
|
|
397
|
-
- `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.
|
|
398
425
|
- `useEditHistory` gains `peekUndo`, `peekRedo` and `replaceCurrent`; existing methods are unchanged.
|
|
399
426
|
- Controlled graph editing with named ports, drag and keyboard connections, endpoint reconnection, box selection, disjoint visual groups, batch movement and a navigable minimap.
|
|
400
427
|
- `GanttChart` with controlled pointer and keyboard editing, validation, cancellation on source changes, lanes, milestones, progress and FS/SS/FF/SF dependencies.
|
|
@@ -405,7 +432,7 @@ First public release. The version restarts at 0.1.0; earlier version numbers wer
|
|
|
405
432
|
- Resource calendars, capacity comparisons and overload intervals with contributing task IDs, plus optional Gantt dependency highlighting.
|
|
406
433
|
- `useEditHistory` for bounded undo and redo over immutable application snapshots.
|
|
407
434
|
- Framework-independent TypeScript core, ESM entry points, Bundler/NodeNext declarations, namespaced themes, localization, typed slots and navigation methods.
|
|
408
|
-
- `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.
|
|
409
436
|
- Manufacturing, project delivery, large-resource and scheduling demos; public-entry, SSR, browser and isolated tarball-consumer checks.
|
|
410
437
|
- Verified local release preparation with matching source/demo archives, file inventories, offline smoke checks and SHA-256 records.
|
|
411
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
|
package/README.ja.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
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
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
|
|
|
@@ -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,16 +186,18 @@ 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
|
|
|
@@ -204,19 +206,28 @@ const activate = (event: ViewTargetEvent) => linked.select(event.target.view, [e
|
|
|
204
206
|
- **スプレッドシート編集(`spreadsheet`):** セル範囲の選択、Excel や Google スプレッドシートとのコピー・切り取り・貼り付け、Delete による消去、Ctrl/⌘+D や右下のハンドルによる下方向のコピー、文字入力による編集。操作ごとに一つの `sheet-edit` 変更案として届き、`validateSheetEdit` で一括で却下でき、`applyTimelineSheetEdit` で反映できます。デモには、表からスケジューラーがバー・矢印・クリティカルパスを計算する工程表と、購買申請の承認フローの編集画面があります。
|
|
205
207
|
- **時間軸:** ズームプリセット、IANAタイムゾーンとロケールに沿ったカレンダー用プリセット(`calendarZoomPresets`、`intlTimeFormatter`)、非稼働時間を圧縮する時間軸(`createWorkingTimeScale`)、Ctrl+ホイールとピンチによるズーム、現在時刻マーカー、`fitToBars()`。
|
|
206
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) を参照してください。
|
|
207
216
|
|
|
208
217
|
### ヘッドレスコア(`@eightkk/vue-weave/core`)
|
|
209
218
|
|
|
210
219
|
- **グラフのアルゴリズムと指標:** `topologicalOrder`、`findGraphCycles`、`shortestGraphPath`、`searchGraphNodes`、`filterGraph`、連結成分、次数・媒介・PageRankの各中心性、Louvain法によるコミュニティ検出(`detectGraphCommunities`)と、その結果をグループに変換する `graphCommunityGroups`。
|
|
211
220
|
- **日程計算:** `buildWorkPeriods` で作るカレンダー(IANAタイムゾーンを含む)上での `scheduleTasks`。最遅開始、手動・非アクティブ・サマリーのタスク、制約、中断区間、循環や実行不能の診断に対応します。`scheduleTasks(input, { explain: true })` は各タスクの開始が決まった理由をトレースし、`toPlanningDiagnostics` は問題を一覧にします。
|
|
212
221
|
- **リソース:** `calculateResourceLoad` と `levelResources`。時間とともに変わる能力(`capacityPeriods`)や、タスクの一部だけを占める割り当て(`workOffset`、`workDuration`)にも対応します。`projectResourceTimeline` はリソース別に計画を表示し、`buildPlacementInput` は未計画タスクを計算から除きます。
|
|
213
|
-
- **計画の更新:** `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)を参照してください。
|
|
214
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`)。
|
|
215
226
|
|
|
216
227
|
### ビューの連動・大規模データ・保存
|
|
217
228
|
|
|
218
|
-
- **ビューの連動:** `useLinkedSelection` はグラフ、ガントチャート、負荷行をエンティティの対応づけで連動させます。`revealNode`、`revealBar`、`revealLinkedTarget` は折り畳まれたグループや行の中も含めて項目へ移動し、`timelineBarsInRange` と `resolveTimeRangeTargets` はある時間範囲に作業していた対象を強調します。詳しくは[Linking views](https://github.com/EightKK/vue-weave/blob/v1.
|
|
219
|
-
- **大規模データ:** `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)を参照してください。
|
|
220
231
|
- **表示と保存:** 行を検索・並べ替える `useTimelineView`、Undo/Redoの `useEditHistory`、サーバーのアダプターを通じて版競合も扱いながら保存する `useEditTransaction`、版付きで検証されたJSONとして保存・復元する `serializeWeaveSnapshot` と `restoreWeaveSnapshot`。
|
|
221
232
|
|
|
222
233
|
### 書き出し・テーマ・アクセシビリティ
|
|
@@ -233,12 +244,12 @@ const png = await chart.value!.exportPng({ scale: 2 })
|
|
|
233
244
|
|
|
234
245
|
## 対応状況
|
|
235
246
|
|
|
236
|
-
- **バージョン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)に記載しています。
|
|
237
248
|
- **Vue:** 3.x の3.5以降(peer dependency `^3.5.0`)。
|
|
238
249
|
- **モジュールとTypeScript:** ESMのみ。型定義は `Bundler` と `NodeNext` の型解決に対応しています。項目の `data` に型を付けられ(`NetworkNode<MyData>`、`TimelineBar<MyData>`)、その型がキャストなしでスロットのpropsやコールバックに渡ります。
|
|
239
250
|
- **Node.js:** ヘッドレスの `@eightkk/vue-weave/core`、サーバーサイドレンダリング、開発には22.18以降が必要です。
|
|
240
251
|
- **ブラウザー:** 最新の主要ブラウザー(Chrome、Edge、Firefox、Safari)。自動ブラウザーテストはChromiumのみで実行するため、ほかのブラウザーはCIの対象外です。
|
|
241
|
-
- **アクセシビリティ:** キーボード操作とARIA名を備えています。専用のスクリーンリーダーでの検証はまだ行っていません([構成、性能上の扱い、対応範囲](https://github.com/EightKK/vue-weave/blob/v1.
|
|
252
|
+
- **アクセシビリティ:** キーボード操作とARIA名を備えています。専用のスクリーンリーダーでの検証はまだ行っていません([構成、性能上の扱い、対応範囲](https://github.com/EightKK/vue-weave/blob/v1.2.0/docs/architecture.md)を参照)。十分に対応していると想定しないでください。
|
|
242
253
|
|
|
243
254
|
## デモを起動する
|
|
244
255
|
|
|
@@ -258,21 +269,21 @@ Windowsでは代わりに `Start.cmd` をダブルクリックしても起動で
|
|
|
258
269
|
|
|
259
270
|
`preview/` を含むビルド済みデモのアーカイブ(リリースに添付されることがあります)を使う場合は、全体を展開して `npm start` を実行するか、Windowsで `Start.cmd` をダブルクリックします。ビルド済みデモはNode.jsがあれば依存関係のインストールなしで起動できます。ソースを変更した場合は `Start.cmd` がデモをビルドし直します。初回はnpmとインターネット接続が必要です。
|
|
260
271
|
|
|
261
|
-
開発・検証コマンドは[Contributing](https://github.com/EightKK/vue-weave/blob/v1.
|
|
272
|
+
開発・検証コマンドは[Contributing](https://github.com/EightKK/vue-weave/blob/v1.2.0/CONTRIBUTING.md)を参照してください。
|
|
262
273
|
|
|
263
274
|
## ドキュメント
|
|
264
275
|
|
|
265
276
|
API、コメント、詳細ドキュメントは英語です。
|
|
266
277
|
|
|
267
|
-
- [入力型と公開API](https://github.com/EightKK/vue-weave/blob/v1.
|
|
268
|
-
- [Vue・Nuxtへの組み込み、独自描画、時間軸、保存処理](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.
|
|
272
|
-
- [セキュリティ方針と脆弱性の非公開報告](https://github.com/EightKK/vue-weave/blob/v1.
|
|
273
|
-
- [行動規範](https://github.com/EightKK/vue-weave/blob/v1.
|
|
274
|
-
- [変更履歴](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)
|
|
275
286
|
|
|
276
287
|
## ライセンス
|
|
277
288
|
|
|
278
|
-
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) にあります。
|