@purview-dev/pm-docs-site 0.0.0-stage → 0.1.0-pre.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/LICENSE.md +9 -0
  2. package/README.md +219 -2
  3. package/dist/cli.d.ts +2 -0
  4. package/dist/cli.js +90 -0
  5. package/dist/index.d.ts +7 -0
  6. package/dist/index.js +118 -0
  7. package/dist/options.d.ts +5 -0
  8. package/dist/options.js +46 -0
  9. package/dist/repo-docs.d.ts +33 -0
  10. package/dist/repo-docs.js +94 -0
  11. package/dist/schema-version.d.ts +10 -0
  12. package/dist/schema-version.js +19 -0
  13. package/dist/sidebar.d.ts +10 -0
  14. package/dist/sidebar.js +30 -0
  15. package/dist/site-options.d.ts +9 -0
  16. package/dist/site-options.js +39 -0
  17. package/dist/types.d.ts +47 -0
  18. package/dist/types.js +4 -0
  19. package/lib/repo-docs.ts +124 -0
  20. package/lib/schema-version.ts +24 -0
  21. package/package.json +68 -5
  22. package/src/components/ExportStamp.astro +29 -0
  23. package/src/components/FeatureSummary.astro +160 -0
  24. package/src/components/FeatureTable.astro +64 -0
  25. package/src/components/ItemDetail.astro +16 -0
  26. package/src/components/ItemDialog.astro +16 -0
  27. package/src/components/LinkedFrom.astro +33 -0
  28. package/src/components/LinkedText.astro +12 -0
  29. package/src/components/PlanInteractions.astro +30 -0
  30. package/src/components/RefLink.astro +18 -0
  31. package/src/components/StateBadge.astro +15 -0
  32. package/src/components/board/Board.tsx +244 -0
  33. package/src/components/board/KanbanItemCard.tsx +129 -0
  34. package/src/components/board/LinkRuns.tsx +21 -0
  35. package/src/components/board/TaskKanbanCard.tsx +81 -0
  36. package/src/components/board/useBoardUrlState.ts +41 -0
  37. package/src/components/lib/KanbanItemCard.astro +264 -0
  38. package/src/components/lib/StatusTimelineFeed.astro +194 -0
  39. package/src/components/lib/TaskKanbanCard.astro +215 -0
  40. package/src/components/timeline/Timeline.tsx +159 -0
  41. package/src/components/timeline/useTimelineLayout.ts +39 -0
  42. package/src/content.config.ts +16 -0
  43. package/src/env.d.ts +7 -0
  44. package/src/lib/board-data.ts +84 -0
  45. package/src/lib/board.ts +209 -0
  46. package/src/lib/planning-types.ts +207 -0
  47. package/src/lib/planning.ts +415 -0
  48. package/src/lib/references.ts +360 -0
  49. package/src/lib/timeline.ts +156 -0
  50. package/src/loaders/repo-docs.ts +69 -0
  51. package/src/pages/index.astro +158 -0
  52. package/src/pages/plan/board.astro +41 -0
  53. package/src/pages/plan/log.astro +83 -0
  54. package/src/pages/plan/risks/[id].astro +72 -0
  55. package/src/pages/plan/risks.astro +263 -0
  56. package/src/pages/plan/roadmap.astro +108 -0
  57. package/src/routes/plan/briefs.astro +66 -0
  58. package/src/routes/plan/features/[id].astro +113 -0
  59. package/src/routes/plan/features/index.astro +29 -0
  60. package/src/routes/plan/inbox.astro +78 -0
  61. package/src/routes/plan/milestones/[milestone].astro +113 -0
  62. package/src/routes/plan/milestones/index.astro +56 -0
  63. package/src/routes/plan/now.astro +135 -0
  64. package/src/routes/plan/strategy.astro +194 -0
  65. package/src/scripts/plan.ts +40 -0
  66. package/src/styles/components.css +491 -0
  67. package/src/styles/kanban.css +277 -0
  68. package/src/styles/timeline.css +210 -0
  69. package/src/styles/width.css +4 -0
@@ -0,0 +1,277 @@
1
+ /*
2
+ * The Board island's cards (src/components/board/KanbanItemCard.tsx and
3
+ * TaskKanbanCard.tsx): the <style> blocks of src/components/lib/KanbanItemCard.astro
4
+ * and TaskKanbanCard.astro as global CSS, plus the size pill and RAG dot group.
5
+ *
6
+ * KanbanItemCard and TaskKanbanCard are from the Astro Components Kit by Konstantin
7
+ * (https://astrocomponents.dev/docs/kanban-item-card/, https://astrocomponents.dev/docs/task-kanban-card/,
8
+ * https://github.com/konstantinWDK/astro-components), MIT License. Copied from its manual-install
9
+ * source; the only changes are that hard-coded dark-theme colours use Starlight theme variables,
10
+ * so the cards read in light and dark themes, and the RAG dot added beside the size pill.
11
+ */
12
+
13
+ .k-item {
14
+ background: var(--sl-color-bg-nav, rgba(17, 24, 39, 0.7));
15
+ backdrop-filter: blur(12px);
16
+ border: 1px solid var(--sl-color-hairline, rgba(255, 255, 255, 0.08));
17
+ border-radius: var(--r-md, 12px);
18
+ padding: var(--sp-4, 1rem);
19
+ display: flex;
20
+ flex-direction: column;
21
+ gap: 0.65rem;
22
+ cursor: grab;
23
+ transition:
24
+ transform 0.2s cubic-bezier(0.16, 1, 0.3, 1),
25
+ border-color 0.2s ease,
26
+ box-shadow 0.2s ease;
27
+ max-width: 300px;
28
+ box-sizing: border-box;
29
+ outline: none;
30
+ }
31
+
32
+ .k-item:hover,
33
+ .k-item:focus-visible {
34
+ transform: translateY(-2px);
35
+ border-color: var(--sl-color-accent, rgba(99, 102, 241, 0.4));
36
+ box-shadow: 0 10px 24px -6px rgba(0, 0, 0, 0.25);
37
+ }
38
+
39
+ .k-item:focus-visible {
40
+ box-shadow: 0 0 0 2px var(--c-primary, #6366f1);
41
+ }
42
+
43
+ .k-item__head {
44
+ display: flex;
45
+ justify-content: space-between;
46
+ align-items: center;
47
+ gap: 0.5rem;
48
+ }
49
+
50
+ .k-item__tag {
51
+ font-size: 0.68rem;
52
+ font-weight: 700;
53
+ color: var(--c-text-2, #94a3b8);
54
+ background: var(--sl-color-bg, rgba(255, 255, 255, 0.04));
55
+ border: 1px solid var(--sl-color-hairline, rgba(255, 255, 255, 0.08));
56
+ padding: 2px 7px;
57
+ border-radius: 4px;
58
+ letter-spacing: 0.03em;
59
+ }
60
+
61
+ .k-item__priority {
62
+ font-size: 0.66rem;
63
+ font-weight: 800;
64
+ padding: 2px 7px;
65
+ border-radius: 4px;
66
+ border: 1px solid;
67
+ display: inline-flex;
68
+ align-items: center;
69
+ gap: 4px;
70
+ text-transform: uppercase;
71
+ letter-spacing: 0.04em;
72
+ }
73
+
74
+ .k-item__priority-dot {
75
+ width: 5px;
76
+ height: 5px;
77
+ border-radius: 50%;
78
+ }
79
+
80
+ .k-item__title {
81
+ margin: 0;
82
+ font-size: 0.88rem;
83
+ font-weight: 600;
84
+ color: var(--c-text-1, #f8fafc);
85
+ line-height: 1.45;
86
+ }
87
+
88
+ .k-item__footer {
89
+ display: flex;
90
+ justify-content: space-between;
91
+ align-items: center;
92
+ gap: 0.5rem;
93
+ padding-top: 0.5rem;
94
+ border-top: 1px solid var(--sl-color-hairline, rgba(255, 255, 255, 0.06));
95
+ margin-top: 0.1rem;
96
+ }
97
+
98
+ .k-item__meta {
99
+ display: flex;
100
+ align-items: center;
101
+ gap: 0.6rem;
102
+ }
103
+
104
+ .k-item__meta-item {
105
+ display: flex;
106
+ align-items: center;
107
+ gap: 3px;
108
+ font-size: 0.72rem;
109
+ color: var(--c-text-3, #64748b);
110
+ }
111
+
112
+ .k-item__icon {
113
+ opacity: 0.75;
114
+ }
115
+
116
+ .k-item__assignee {
117
+ min-width: 24px;
118
+ height: 24px;
119
+ padding: 0 4px;
120
+ box-sizing: border-box;
121
+ border-radius: 12px;
122
+ background: linear-gradient(135deg, var(--c-primary, #6366f1), var(--c-primary-light, #818cf8));
123
+ color: #fff;
124
+ font-size: 0.6rem;
125
+ font-weight: 800;
126
+ display: grid;
127
+ place-items: center;
128
+ border: 1px solid rgba(255, 255, 255, 0.2);
129
+ }
130
+
131
+ /* The size pill and the RAG dot beside it, on both cards. */
132
+ .k-item__badges {
133
+ display: inline-flex;
134
+ align-items: center;
135
+ gap: 0.4rem;
136
+ }
137
+
138
+ .k-item__rag {
139
+ display: inline-block;
140
+ width: 0.6rem;
141
+ height: 0.6rem;
142
+ border-radius: 50%;
143
+ flex: none;
144
+ }
145
+
146
+ .k-item__rag[data-rag='red'] {
147
+ background: var(--sl-color-red);
148
+ }
149
+
150
+ .k-item__rag[data-rag='amber'] {
151
+ background: var(--sl-color-orange);
152
+ }
153
+
154
+ .k-item__rag[data-rag='green'] {
155
+ background: var(--sl-color-green);
156
+ }
157
+
158
+ .task-card {
159
+ background: var(--sl-color-bg-nav, rgba(30, 41, 59, 0.7));
160
+ backdrop-filter: blur(12px);
161
+ padding: var(--sp-4, 1rem);
162
+ border-radius: var(--r-md, 12px);
163
+ border: 1px solid var(--sl-color-hairline, rgba(255, 255, 255, 0.08));
164
+ display: flex;
165
+ flex-direction: column;
166
+ gap: 0.65rem;
167
+ max-width: 320px;
168
+ box-sizing: border-box;
169
+ transition:
170
+ transform 0.2s ease,
171
+ border-color 0.2s ease,
172
+ box-shadow 0.2s ease;
173
+ }
174
+
175
+ .task-card:hover {
176
+ transform: translateY(-2px);
177
+ border-color: var(--sl-color-accent, rgba(99, 102, 241, 0.35));
178
+ box-shadow: 0 10px 24px -6px rgba(0, 0, 0, 0.25);
179
+ }
180
+
181
+ .task-card__tags {
182
+ display: flex;
183
+ justify-content: space-between;
184
+ align-items: center;
185
+ }
186
+
187
+ .task-card__tag {
188
+ font-size: 0.7rem;
189
+ font-weight: 700;
190
+ padding: 2px 8px;
191
+ border-radius: 4px;
192
+ display: inline-flex;
193
+ align-items: center;
194
+ gap: 4px;
195
+ }
196
+
197
+ .task-card__tag-dot {
198
+ width: 5px;
199
+ height: 5px;
200
+ border-radius: 50%;
201
+ background: currentColor;
202
+ }
203
+
204
+ .task-card__tag--high {
205
+ background: rgba(239, 68, 68, 0.12);
206
+ color: #dc2626;
207
+ }
208
+
209
+ .task-card__tag--med {
210
+ background: rgba(245, 158, 11, 0.12);
211
+ color: #d97706;
212
+ }
213
+
214
+ .task-card__tag--low {
215
+ background: rgba(16, 185, 129, 0.12);
216
+ color: #059669;
217
+ }
218
+
219
+ .task-card__pct {
220
+ font-size: 0.72rem;
221
+ font-weight: 700;
222
+ color: var(--c-text-2, #94a3b8);
223
+ }
224
+
225
+ .task-card__desc {
226
+ font-size: 0.88rem;
227
+ color: var(--c-text-1, #f1f5f9);
228
+ margin: 0;
229
+ font-weight: 500;
230
+ line-height: 1.45;
231
+ }
232
+
233
+ .task-card__progress-wrap {
234
+ height: 4px;
235
+ background: var(--sl-color-hairline, rgba(255, 255, 255, 0.08));
236
+ border-radius: 2px;
237
+ overflow: hidden;
238
+ }
239
+
240
+ .task-card__progress-bar {
241
+ height: 100%;
242
+ background: linear-gradient(90deg, var(--c-primary, #6366f1), var(--c-primary-light, #818cf8));
243
+ border-radius: 2px;
244
+ }
245
+
246
+ .task-card__footer {
247
+ display: flex;
248
+ justify-content: space-between;
249
+ align-items: center;
250
+ padding-top: 0.35rem;
251
+ }
252
+
253
+ .task-card__date {
254
+ display: flex;
255
+ align-items: center;
256
+ gap: 4px;
257
+ font-size: 0.75rem;
258
+ color: var(--c-text-2, #94a3b8);
259
+ }
260
+
261
+ .task-card__date-icon {
262
+ opacity: 0.75;
263
+ }
264
+
265
+ .task-card__assignee {
266
+ min-width: 24px;
267
+ height: 24px;
268
+ padding: 0 4px;
269
+ box-sizing: border-box;
270
+ background: var(--c-primary, #6366f1);
271
+ color: #fff;
272
+ font-size: 0.6rem;
273
+ border-radius: 12px;
274
+ display: grid;
275
+ place-items: center;
276
+ font-weight: 800;
277
+ }
@@ -0,0 +1,210 @@
1
+ /* The Roadmap page's milestone timeline (src/components/timeline/Timeline.tsx).
2
+ Zoom is one custom property, --timeline-zoom, set on the strip: every size
3
+ below that should grow with it is written as calc(<base> * zoom), so text
4
+ stays sharp and the strip's scroll extent matches its content. Colours come
5
+ from Starlight's variables only, so light and dark themes both work. */
6
+
7
+ .plan-timeline {
8
+ margin-block: 1rem 2rem;
9
+ }
10
+
11
+ .plan-timeline__toolbar {
12
+ display: flex;
13
+ flex-wrap: wrap;
14
+ gap: 0.5rem 1rem;
15
+ margin-bottom: 0.75rem;
16
+ }
17
+
18
+ .plan-timeline__toolbar[hidden] {
19
+ display: none;
20
+ }
21
+
22
+ .plan-timeline__group {
23
+ display: flex;
24
+ flex-wrap: wrap;
25
+ align-items: center;
26
+ gap: 0.25rem;
27
+ }
28
+
29
+ .plan-timeline__toolbar button {
30
+ padding: 0.2rem 0.6rem;
31
+ border: 1px solid var(--sl-color-gray-5);
32
+ border-radius: 0.375rem;
33
+ background: var(--sl-color-bg);
34
+ color: var(--sl-color-text);
35
+ font-size: var(--sl-text-sm);
36
+ cursor: pointer;
37
+ }
38
+
39
+ .plan-timeline__toolbar button[aria-pressed='true'] {
40
+ border-color: var(--sl-color-accent);
41
+ background: var(--sl-color-accent-low);
42
+ color: var(--sl-color-accent-high);
43
+ }
44
+
45
+ .plan-timeline__toolbar button:disabled {
46
+ cursor: default;
47
+ opacity: 0.5;
48
+ }
49
+
50
+ .plan-timeline__zoom {
51
+ min-width: 3.5em;
52
+ color: var(--sl-color-gray-2);
53
+ font-size: var(--sl-text-sm);
54
+ font-variant-numeric: tabular-nums;
55
+ text-align: center;
56
+ }
57
+
58
+ /* The sizes are declared here, where --timeline-zoom is set, so they follow it. */
59
+ .plan-timeline__strip {
60
+ --timeline-gap: calc(1.5rem * var(--timeline-zoom, 1));
61
+ --timeline-pad: calc(0.75rem * var(--timeline-zoom, 1));
62
+ --timeline-marker: calc(0.75rem * var(--timeline-zoom, 1));
63
+
64
+ position: relative;
65
+ display: flex;
66
+ gap: var(--timeline-gap);
67
+ margin: 0;
68
+ padding: 0.25rem;
69
+ list-style: none;
70
+ }
71
+
72
+ .plan-timeline__strip:focus-visible {
73
+ outline: 2px solid var(--sl-color-accent);
74
+ outline-offset: 2px;
75
+ }
76
+
77
+ /* Left to right: one row of a fixed height, scrolling sideways inside itself. */
78
+ .plan-timeline__strip[data-layout='horizontal'] {
79
+ flex-wrap: nowrap;
80
+ align-items: stretch;
81
+ overflow-x: auto;
82
+ overflow-y: hidden;
83
+ }
84
+
85
+ /* Top to bottom: no height limit and no scroll box, so the page's own scroll moves through it. */
86
+ .plan-timeline__strip[data-layout='vertical'] {
87
+ flex-direction: column;
88
+ align-items: flex-start;
89
+ }
90
+
91
+ .plan-timeline__card {
92
+ position: relative;
93
+ box-sizing: border-box;
94
+ flex: 0 0 auto;
95
+ width: calc(14rem * var(--timeline-zoom, 1));
96
+ margin: 0;
97
+ padding: var(--timeline-pad);
98
+ border: 1px solid var(--sl-color-hairline);
99
+ border-radius: calc(0.5rem * var(--timeline-zoom, 1));
100
+ background: var(--sl-color-bg-nav);
101
+ color: var(--sl-color-text);
102
+ font-size: calc(var(--sl-text-sm) * var(--timeline-zoom, 1));
103
+ line-height: 1.4;
104
+ }
105
+
106
+ .plan-timeline__strip[data-layout='vertical'] .plan-timeline__card {
107
+ max-width: 100%;
108
+ }
109
+
110
+ /* The connector: a line from the previous card's marker to this one's. */
111
+ .plan-timeline__card + .plan-timeline__card::before {
112
+ position: absolute;
113
+ content: '';
114
+ background: var(--sl-color-gray-4);
115
+ }
116
+
117
+ .plan-timeline__strip[data-layout='horizontal'] .plan-timeline__card + .plan-timeline__card::before {
118
+ top: calc(var(--timeline-pad) + var(--timeline-marker) / 2 - 1px);
119
+ left: calc(-1 * var(--timeline-gap) - 1px);
120
+ width: var(--timeline-gap);
121
+ height: 2px;
122
+ }
123
+
124
+ .plan-timeline__strip[data-layout='vertical'] .plan-timeline__card + .plan-timeline__card::before {
125
+ top: calc(-1 * var(--timeline-gap) - 1px);
126
+ left: calc(var(--timeline-pad) + var(--timeline-marker) / 2 - 1px);
127
+ width: 2px;
128
+ height: var(--timeline-gap);
129
+ }
130
+
131
+ /* The marker, by state: filled for done, ringed and accented for active, hollow for planned and any other status. */
132
+ .plan-timeline__marker {
133
+ display: block;
134
+ box-sizing: border-box;
135
+ width: var(--timeline-marker);
136
+ height: var(--timeline-marker);
137
+ margin-bottom: calc(0.5rem * var(--timeline-zoom, 1));
138
+ border: 2px solid var(--sl-color-gray-3);
139
+ border-radius: 50%;
140
+ background: transparent;
141
+ }
142
+
143
+ .plan-timeline__card[data-state='done'] .plan-timeline__marker {
144
+ border-color: var(--sl-color-gray-2);
145
+ background: var(--sl-color-gray-2);
146
+ }
147
+
148
+ .plan-timeline__card[data-state='active'] .plan-timeline__marker {
149
+ border-color: var(--sl-color-accent);
150
+ background: var(--sl-color-bg);
151
+ box-shadow: 0 0 0 3px var(--sl-color-accent-low);
152
+ }
153
+
154
+ .plan-timeline__card p {
155
+ margin: 0;
156
+ }
157
+
158
+ .plan-timeline__card p + p,
159
+ .plan-timeline__bar {
160
+ margin-top: calc(0.25rem * var(--timeline-zoom, 1));
161
+ }
162
+
163
+ .plan-timeline__title {
164
+ font-weight: 600;
165
+ overflow-wrap: anywhere;
166
+ }
167
+
168
+ .plan-timeline__title a {
169
+ color: var(--sl-color-text-accent);
170
+ }
171
+
172
+ .plan-timeline__focus {
173
+ margin-left: 0.4em;
174
+ padding: 0.05em 0.5em;
175
+ border-radius: 999px;
176
+ background: var(--sl-color-accent-low);
177
+ color: var(--sl-color-accent-high);
178
+ font-size: 0.85em;
179
+ font-weight: 400;
180
+ white-space: nowrap;
181
+ }
182
+
183
+ .plan-timeline__status,
184
+ .plan-timeline__target,
185
+ .plan-timeline__count {
186
+ color: var(--sl-color-gray-2);
187
+ }
188
+
189
+ .plan-timeline__bar {
190
+ display: block;
191
+ width: 100%;
192
+ height: calc(0.5rem * var(--timeline-zoom, 1));
193
+ accent-color: var(--sl-color-accent);
194
+ }
195
+
196
+ /* While <html> has the pending mark (`?layout=vertical`, the inline script in
197
+ roadmap.astro) the strip is hidden until the island has rendered the
198
+ vertical layout, so a vertical link never flashes horizontal. If the island
199
+ never loads and so never clears the mark, the strip shows anyway after 3s,
200
+ horizontally: never a blank strip. */
201
+ :root[data-timeline-pending] .plan-timeline__strip {
202
+ visibility: hidden;
203
+ animation: plan-timeline-reveal 0s 3s forwards;
204
+ }
205
+
206
+ @keyframes plan-timeline-reveal {
207
+ to {
208
+ visibility: visible;
209
+ }
210
+ }
@@ -0,0 +1,4 @@
1
+ /* Every page uses the full width of the window, not Starlight's 45rem prose column. */
2
+ :root {
3
+ --sl-content-width: 100%;
4
+ }