@designfever/web-review-kit 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/README.md +77 -179
  2. package/dist/{chunk-U5K2YGGL.js → chunk-I76WEDLA.js} +2248 -2722
  3. package/dist/chunk-I76WEDLA.js.map +1 -0
  4. package/dist/index.cjs +2346 -2603
  5. package/dist/index.cjs.map +1 -1
  6. package/dist/index.d.cts +10 -6
  7. package/dist/index.d.ts +10 -6
  8. package/dist/index.js +220 -7
  9. package/dist/index.js.map +1 -1
  10. package/dist/react-shell.cjs +8953 -6632
  11. package/dist/react-shell.cjs.map +1 -1
  12. package/dist/react-shell.d.cts +8 -3
  13. package/dist/react-shell.d.ts +8 -3
  14. package/dist/react-shell.js +5956 -3636
  15. package/dist/react-shell.js.map +1 -1
  16. package/dist/{types-D_mNjOHx.d.cts → types-Cf2x5ky6.d.cts} +8 -14
  17. package/dist/{types-D_mNjOHx.d.ts → types-Cf2x5ky6.d.ts} +8 -14
  18. package/dist/vite.cjs +186 -0
  19. package/dist/vite.cjs.map +1 -0
  20. package/dist/vite.d.cts +16 -0
  21. package/dist/vite.d.ts +16 -0
  22. package/dist/vite.js +161 -0
  23. package/dist/vite.js.map +1 -0
  24. package/docs/README.md +21 -30
  25. package/docs/adaptor.sample.ts +182 -0
  26. package/docs/architecture.md +125 -0
  27. package/docs/db-setup.md +253 -0
  28. package/docs/figma-overlay.md +52 -0
  29. package/docs/grid-overlay.md +38 -0
  30. package/docs/installation.md +108 -40
  31. package/package.json +22 -6
  32. package/dist/chunk-U5K2YGGL.js.map +0 -1
  33. package/docs/adapter-handoff.md +0 -146
  34. package/docs/concept.md +0 -102
  35. package/docs/df-sheet-adapter.md +0 -336
  36. package/docs/df-sheet-next.md +0 -222
  37. package/docs/initial-plan.md +0 -226
  38. package/docs/package-split-checkpoint.md +0 -79
  39. package/docs/presence-handoff.md +0 -138
  40. package/docs/review-feedback-2026-06-20.md +0 -267
  41. package/docs/smoke-baseline-2026-06-20.md +0 -41
  42. package/docs/stabilize-ui-work-guide.md +0 -243
  43. package/docs/supabase-presence.md +0 -198
  44. package/docs/supabase-review-items.md +0 -365
  45. package/docs/supabase.md +0 -205
@@ -1,5 +1,5 @@
1
+ import { f as ReviewItemScope, r as ReviewSource, n as ReviewMode, W as WebReviewKitAdapter, a as ReviewItemStatus, e as ReviewItem, p as ReviewRulerConfig } from './types-Cf2x5ky6.cjs';
1
2
  import React from 'react';
2
- import { f as ReviewItemScope, s as ReviewSource, o as ReviewMode, W as WebReviewKitAdapter, a as ReviewItemStatus, e as ReviewItem, q as ReviewRulerConfig } from './types-D_mNjOHx.cjs';
3
3
 
4
4
  type ReviewShellViewportKind = Exclude<ReviewItemScope, 'dom'>;
5
5
  type ReviewShellViewportPreset = {
@@ -18,6 +18,7 @@ type ReviewShellStatusOption = {
18
18
  value: ReviewItemStatus;
19
19
  label: string;
20
20
  };
21
+ type ReviewShellWriteMode = 'dom' | 'note' | 'area';
21
22
  type ReviewShellUpdateStatusInput = {
22
23
  id: string;
23
24
  item: ReviewItem;
@@ -36,8 +37,10 @@ type ReviewShellAdapter = {
36
37
  pageId?: string;
37
38
  get: WebReviewKitAdapter['get'];
38
39
  list: WebReviewKitAdapter['list'];
39
- create: WebReviewKitAdapter['create'];
40
+ create?: WebReviewKitAdapter['create'];
41
+ update?: WebReviewKitAdapter['update'];
40
42
  statusOptions?: readonly ReviewShellStatusOption[];
43
+ canWrite?: boolean | readonly ReviewShellWriteMode[];
41
44
  updateStatus?: (input: ReviewShellUpdateStatusInput) => Promise<ReviewItem>;
42
45
  syncSubmission?: (input: ReviewShellSyncSubmissionInput) => Promise<ReviewItem>;
43
46
  remove?: WebReviewKitAdapter['remove'];
@@ -101,12 +104,15 @@ interface ReviewShellProps {
101
104
  ruler?: ReviewRulerConfig;
102
105
  initialPrompt?: string;
103
106
  reviewPathPrefix?: string;
107
+ sourceRoot?: string;
104
108
  presence?: ReviewPresenceAdapter;
105
109
  }
106
110
  interface ReviewShellMountOptions extends ReviewShellProps {
107
111
  rootId?: string;
108
112
  }
109
113
 
114
+ declare const ReviewShell: ({ projectId, pages, adapters, presets, ruler, initialPrompt, reviewPathPrefix, sourceRoot, presence }: ReviewShellProps) => React.JSX.Element;
115
+
110
116
  declare const createReviewPagesFromGlob: (entries: ReviewShellGlobEntries, options?: CreateReviewPagesOptions) => ReviewShellPage[];
111
117
 
112
118
  declare const DEFAULT_REVIEW_VIEWPORT_PRESETS: ReviewShellViewportPreset[];
@@ -150,7 +156,6 @@ type SupabasePresenceAdapterOptions = {
150
156
  };
151
157
  declare const createSupabasePresenceAdapter: ({ client, channelPrefix, private: isPrivate, }: SupabasePresenceAdapterOptions) => ReviewPresenceAdapter;
152
158
 
153
- declare const ReviewShell: ({ projectId, pages, adapters, presets, ruler, initialPrompt, reviewPathPrefix, presence }: ReviewShellProps) => React.JSX.Element;
154
159
  declare const mountReviewShell: (options: ReviewShellMountOptions) => void;
155
160
 
156
161
  export { type CreateReviewPagesOptions, DEFAULT_REVIEW_VIEWPORT_PRESETS, type LocalPresenceAdapterOptions, type ReviewPresenceAdapter, type ReviewPresenceContext, type ReviewPresenceSession, type ReviewPresenceState, type ReviewPresenceStatus, type ReviewPresenceUser, ReviewShell, type ReviewShellAdapter, type ReviewShellAdapters, type ReviewShellGlobEntries, type ReviewShellMountOptions, type ReviewShellPage, type ReviewShellProps, type ReviewShellStatusOption, type ReviewShellViewportKind, type ReviewShellViewportPreset, type SupabasePresenceAdapterOptions, type SupabasePresenceClient, createFallbackPresenceAdapter, createLocalPresenceAdapter, createReviewPagesFromGlob, createSupabasePresenceAdapter, mountReviewShell };
@@ -1,5 +1,5 @@
1
+ import { f as ReviewItemScope, r as ReviewSource, n as ReviewMode, W as WebReviewKitAdapter, a as ReviewItemStatus, e as ReviewItem, p as ReviewRulerConfig } from './types-Cf2x5ky6.js';
1
2
  import React from 'react';
2
- import { f as ReviewItemScope, s as ReviewSource, o as ReviewMode, W as WebReviewKitAdapter, a as ReviewItemStatus, e as ReviewItem, q as ReviewRulerConfig } from './types-D_mNjOHx.js';
3
3
 
4
4
  type ReviewShellViewportKind = Exclude<ReviewItemScope, 'dom'>;
5
5
  type ReviewShellViewportPreset = {
@@ -18,6 +18,7 @@ type ReviewShellStatusOption = {
18
18
  value: ReviewItemStatus;
19
19
  label: string;
20
20
  };
21
+ type ReviewShellWriteMode = 'dom' | 'note' | 'area';
21
22
  type ReviewShellUpdateStatusInput = {
22
23
  id: string;
23
24
  item: ReviewItem;
@@ -36,8 +37,10 @@ type ReviewShellAdapter = {
36
37
  pageId?: string;
37
38
  get: WebReviewKitAdapter['get'];
38
39
  list: WebReviewKitAdapter['list'];
39
- create: WebReviewKitAdapter['create'];
40
+ create?: WebReviewKitAdapter['create'];
41
+ update?: WebReviewKitAdapter['update'];
40
42
  statusOptions?: readonly ReviewShellStatusOption[];
43
+ canWrite?: boolean | readonly ReviewShellWriteMode[];
41
44
  updateStatus?: (input: ReviewShellUpdateStatusInput) => Promise<ReviewItem>;
42
45
  syncSubmission?: (input: ReviewShellSyncSubmissionInput) => Promise<ReviewItem>;
43
46
  remove?: WebReviewKitAdapter['remove'];
@@ -101,12 +104,15 @@ interface ReviewShellProps {
101
104
  ruler?: ReviewRulerConfig;
102
105
  initialPrompt?: string;
103
106
  reviewPathPrefix?: string;
107
+ sourceRoot?: string;
104
108
  presence?: ReviewPresenceAdapter;
105
109
  }
106
110
  interface ReviewShellMountOptions extends ReviewShellProps {
107
111
  rootId?: string;
108
112
  }
109
113
 
114
+ declare const ReviewShell: ({ projectId, pages, adapters, presets, ruler, initialPrompt, reviewPathPrefix, sourceRoot, presence }: ReviewShellProps) => React.JSX.Element;
115
+
110
116
  declare const createReviewPagesFromGlob: (entries: ReviewShellGlobEntries, options?: CreateReviewPagesOptions) => ReviewShellPage[];
111
117
 
112
118
  declare const DEFAULT_REVIEW_VIEWPORT_PRESETS: ReviewShellViewportPreset[];
@@ -150,7 +156,6 @@ type SupabasePresenceAdapterOptions = {
150
156
  };
151
157
  declare const createSupabasePresenceAdapter: ({ client, channelPrefix, private: isPrivate, }: SupabasePresenceAdapterOptions) => ReviewPresenceAdapter;
152
158
 
153
- declare const ReviewShell: ({ projectId, pages, adapters, presets, ruler, initialPrompt, reviewPathPrefix, presence }: ReviewShellProps) => React.JSX.Element;
154
159
  declare const mountReviewShell: (options: ReviewShellMountOptions) => void;
155
160
 
156
161
  export { type CreateReviewPagesOptions, DEFAULT_REVIEW_VIEWPORT_PRESETS, type LocalPresenceAdapterOptions, type ReviewPresenceAdapter, type ReviewPresenceContext, type ReviewPresenceSession, type ReviewPresenceState, type ReviewPresenceStatus, type ReviewPresenceUser, ReviewShell, type ReviewShellAdapter, type ReviewShellAdapters, type ReviewShellGlobEntries, type ReviewShellMountOptions, type ReviewShellPage, type ReviewShellProps, type ReviewShellStatusOption, type ReviewShellViewportKind, type ReviewShellViewportPreset, type SupabasePresenceAdapterOptions, type SupabasePresenceClient, createFallbackPresenceAdapter, createLocalPresenceAdapter, createReviewPagesFromGlob, createSupabasePresenceAdapter, mountReviewShell };