@designfever/web-review-kit 0.1.0 → 0.3.0

package/dist/{types-D_mNjOHx.d.cts → types-Cf2x5ky6.d.cts}

@@ -3,7 +3,7 @@ type ReviewItemScope = 'mobile' | 'tablet' | 'desktop' | 'wide' | 'dom';
 type ReviewWorkflowStatus = 'todo' | 'doing' | 'review' | 'hold' | 'done';
 type ReviewItemStatus = 'open' | 'resolved' | ReviewWorkflowStatus;
 type ReviewMode = 'idle' | 'note' | 'element' | 'area';
-type ReviewSource = 'local' | 'df-sheet' | 'supabase' | (string & {});
+type ReviewSource = 'local' | 'supabase' | (string & {});
 type ReviewSubmitStatus = 'idle' | 'submitting' | 'submitted' | 'failed';
 type ReviewViewportScope = Exclude<ReviewItemScope, 'dom'>;
 type DomAnchorStrategy = 'configured-attribute' | 'id' | 'class' | 'dom-path';
@@ -20,6 +20,8 @@ interface DomAnchorCandidate {
 interface DomSourceHint {
     component?: string;
     file?: string;
+    line?: string;
+    column?: string;
     sectionId?: string;
     sectionIndex?: string;
 }
@@ -62,6 +64,7 @@ interface ReviewItem {
     kind: ReviewItemKind;
     title?: string;
     comment: string;
+    createdBy?: string;
     status: ReviewItemStatus;
     viewport: ViewportSize;
     devicePixelRatio?: number;
@@ -98,17 +101,6 @@ interface WebReviewKitAdapter {
 interface LocalAdapterOptions {
     storageKey?: string;
 }
-interface DfSheetAdapterOptions {
-    baseUrl?: string;
-    projectId: string;
-    pageId: string;
-    reviewProjectId?: string;
-    reviewPathPrefix?: string;
-    source?: string;
-    issueType?: string;
-    priority?: string;
-    token?: string;
-}
 interface SupabaseReviewClient {
     from(table: string): any;
     rpc?: (fn: string, args?: Record<string, unknown>) => any;
@@ -132,11 +124,12 @@ interface NumberedReviewItem {
     item: ReviewItem;
     scope: ReviewItemScope;
     label: string;
-    number: number;
+    number?: number;
     displayLabel: string;
 }
 interface WebReviewKitOptions {
     projectId: string;
+    userId?: string;
     adapter?: WebReviewKitAdapter;
     target?: WebReviewKitTarget | (() => WebReviewKitTarget | undefined);
     viewports?: {
@@ -150,6 +143,7 @@ interface WebReviewKitOptions {
         attribute?: string;
     };
     onRestoreItem?: (item: ReviewItem) => void | Promise<void>;
+    onCreateItem?: (item: ReviewItem) => void | Promise<void>;
     onItemsChange?: (items: ReviewItem[]) => void;
     onModeChange?: (mode: ReviewMode) => void;
     ui?: {
@@ -180,4 +174,4 @@ interface WebReviewKitTarget {
     getOverlayRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
 }
 
-export type { DfSheetAdapterOptions as D, LocalAdapterOptions as L, NumberedReviewItem as N, ReviewWorkflowStatus as R, SupabaseReviewAdapterOptions as S, ViewportSize as V, WebReviewKitAdapter as W, ReviewItemStatus as a, WebReviewKitOptions as b, WebReviewKitController as c, ReviewViewportPreset as d, ReviewItem as e, ReviewItemScope as f, DomAnchor as g, DomAnchorCandidate as h, DomAnchorStrategy as i, DomSourceHint as j, RelativeSelection as k, ReviewItemKind as l, ReviewItemQuery as m, ReviewMarker as n, ReviewMode as o, ReviewPoint as p, ReviewRulerConfig as q, ReviewSelection as r, ReviewSource as s, ReviewSubmitStatus as t, ReviewViewportScope as u, SupabaseReviewClient as v, WebReviewKitTarget as w };
+export type { DomAnchor as D, LocalAdapterOptions as L, NumberedReviewItem as N, ReviewWorkflowStatus as R, SupabaseReviewAdapterOptions as S, ViewportSize as V, WebReviewKitAdapter as W, ReviewItemStatus as a, WebReviewKitOptions as b, WebReviewKitController as c, ReviewViewportPreset as d, ReviewItem as e, ReviewItemScope as f, DomAnchorCandidate as g, DomAnchorStrategy as h, DomSourceHint as i, RelativeSelection as j, ReviewItemKind as k, ReviewItemQuery as l, ReviewMarker as m, ReviewMode as n, ReviewPoint as o, ReviewRulerConfig as p, ReviewSelection as q, ReviewSource as r, ReviewSubmitStatus as s, ReviewViewportScope as t, SupabaseReviewClient as u, WebReviewKitTarget as v };

package/dist/{types-D_mNjOHx.d.ts → types-Cf2x5ky6.d.ts}

@@ -3,7 +3,7 @@ type ReviewItemScope = 'mobile' | 'tablet' | 'desktop' | 'wide' | 'dom';
 type ReviewWorkflowStatus = 'todo' | 'doing' | 'review' | 'hold' | 'done';
 type ReviewItemStatus = 'open' | 'resolved' | ReviewWorkflowStatus;
 type ReviewMode = 'idle' | 'note' | 'element' | 'area';
-type ReviewSource = 'local' | 'df-sheet' | 'supabase' | (string & {});
+type ReviewSource = 'local' | 'supabase' | (string & {});
 type ReviewSubmitStatus = 'idle' | 'submitting' | 'submitted' | 'failed';
 type ReviewViewportScope = Exclude<ReviewItemScope, 'dom'>;
 type DomAnchorStrategy = 'configured-attribute' | 'id' | 'class' | 'dom-path';
@@ -20,6 +20,8 @@ interface DomAnchorCandidate {
 interface DomSourceHint {
     component?: string;
     file?: string;
+    line?: string;
+    column?: string;
     sectionId?: string;
     sectionIndex?: string;
 }
@@ -62,6 +64,7 @@ interface ReviewItem {
     kind: ReviewItemKind;
     title?: string;
     comment: string;
+    createdBy?: string;
     status: ReviewItemStatus;
     viewport: ViewportSize;
     devicePixelRatio?: number;
@@ -98,17 +101,6 @@ interface WebReviewKitAdapter {
 interface LocalAdapterOptions {
     storageKey?: string;
 }
-interface DfSheetAdapterOptions {
-    baseUrl?: string;
-    projectId: string;
-    pageId: string;
-    reviewProjectId?: string;
-    reviewPathPrefix?: string;
-    source?: string;
-    issueType?: string;
-    priority?: string;
-    token?: string;
-}
 interface SupabaseReviewClient {
     from(table: string): any;
     rpc?: (fn: string, args?: Record<string, unknown>) => any;
@@ -132,11 +124,12 @@ interface NumberedReviewItem {
     item: ReviewItem;
     scope: ReviewItemScope;
     label: string;
-    number: number;
+    number?: number;
     displayLabel: string;
 }
 interface WebReviewKitOptions {
     projectId: string;
+    userId?: string;
     adapter?: WebReviewKitAdapter;
     target?: WebReviewKitTarget | (() => WebReviewKitTarget | undefined);
     viewports?: {
@@ -150,6 +143,7 @@ interface WebReviewKitOptions {
         attribute?: string;
     };
     onRestoreItem?: (item: ReviewItem) => void | Promise<void>;
+    onCreateItem?: (item: ReviewItem) => void | Promise<void>;
     onItemsChange?: (items: ReviewItem[]) => void;
     onModeChange?: (mode: ReviewMode) => void;
     ui?: {
@@ -180,4 +174,4 @@ interface WebReviewKitTarget {
     getOverlayRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
 }
 
-export type { DfSheetAdapterOptions as D, LocalAdapterOptions as L, NumberedReviewItem as N, ReviewWorkflowStatus as R, SupabaseReviewAdapterOptions as S, ViewportSize as V, WebReviewKitAdapter as W, ReviewItemStatus as a, WebReviewKitOptions as b, WebReviewKitController as c, ReviewViewportPreset as d, ReviewItem as e, ReviewItemScope as f, DomAnchor as g, DomAnchorCandidate as h, DomAnchorStrategy as i, DomSourceHint as j, RelativeSelection as k, ReviewItemKind as l, ReviewItemQuery as m, ReviewMarker as n, ReviewMode as o, ReviewPoint as p, ReviewRulerConfig as q, ReviewSelection as r, ReviewSource as s, ReviewSubmitStatus as t, ReviewViewportScope as u, SupabaseReviewClient as v, WebReviewKitTarget as w };
+export type { DomAnchor as D, LocalAdapterOptions as L, NumberedReviewItem as N, ReviewWorkflowStatus as R, SupabaseReviewAdapterOptions as S, ViewportSize as V, WebReviewKitAdapter as W, ReviewItemStatus as a, WebReviewKitOptions as b, WebReviewKitController as c, ReviewViewportPreset as d, ReviewItem as e, ReviewItemScope as f, DomAnchorCandidate as g, DomAnchorStrategy as h, DomSourceHint as i, RelativeSelection as j, ReviewItemKind as k, ReviewItemQuery as l, ReviewMarker as m, ReviewMode as n, ReviewPoint as o, ReviewRulerConfig as p, ReviewSelection as q, ReviewSource as r, ReviewSubmitStatus as s, ReviewViewportScope as t, SupabaseReviewClient as u, WebReviewKitTarget as v };

package/dist/vite.cjs

@@ -0,0 +1,186 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vite.ts
+var vite_exports = {};
+__export(vite_exports, {
+  reviewSourceLocator: () => reviewSourceLocator
+});
+module.exports = __toCommonJS(vite_exports);
+var VIRTUAL_JSX_DEV_RUNTIME_ID = "\0@designfever/web-review-kit/source-locator/jsx-dev-runtime";
+var reviewSourceLocator = (options = {}) => {
+  let runtimeOptions = createRuntimeOptions(options);
+  return {
+    name: "df-web-review-kit-source-locator",
+    enforce: "pre",
+    configResolved(config) {
+      runtimeOptions = createRuntimeOptions(options, config);
+    },
+    resolveId(id, importer) {
+      if (!runtimeOptions.enabled) return null;
+      if (id !== "react/jsx-dev-runtime") return null;
+      if (importer === VIRTUAL_JSX_DEV_RUNTIME_ID) return null;
+      return VIRTUAL_JSX_DEV_RUNTIME_ID;
+    },
+    load(id) {
+      if (id !== VIRTUAL_JSX_DEV_RUNTIME_ID) return null;
+      return createJsxDevRuntime(runtimeOptions);
+    }
+  };
+};
+function createRuntimeOptions(options, config) {
+  const attributePrefix = (options.attributePrefix ?? "data-wrk-source").replace(
+    /-+$/,
+    ""
+  );
+  const root = normalizePath(options.root ?? config?.root ?? "");
+  const enabled = options.enabled ?? config?.command === "serve";
+  return {
+    enabled,
+    root,
+    include: (options.include ?? []).map(createRuntimeMatcher),
+    exclude: (options.exclude ?? ["node_modules", "dist"]).map(
+      createRuntimeMatcher
+    ),
+    filePath: options.filePath ?? "relative",
+    line: options.line ?? true,
+    column: options.column ?? true,
+    fileAttribute: `${attributePrefix}-file`,
+    lineAttribute: `${attributePrefix}-line`,
+    columnAttribute: `${attributePrefix}-column`
+  };
+}
+function createRuntimeMatcher(pattern) {
+  if (pattern instanceof RegExp) {
+    return { type: "regex", value: pattern.source, flags: pattern.flags };
+  }
+  return { type: "path", value: normalizePath(pattern).replace(/^\.\//, "") };
+}
+function normalizePath(value) {
+  return value.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+function createJsxDevRuntime(options) {
+  return `
+import { Fragment, jsxDEV as baseJsxDEV } from 'react/jsx-dev-runtime';
+
+const OPTIONS = ${JSON.stringify(options)};
+
+export { Fragment };
+
+export function jsxDEV(type, props, key, isStaticChildren, source, self) {
+  return baseJsxDEV(
+    type,
+    injectSourceProps(type, props, source),
+    key,
+    isStaticChildren,
+    source,
+    self
+  );
+}
+
+function injectSourceProps(type, props, source) {
+  if (typeof type !== 'string') return props;
+  if (!source || typeof source.fileName !== 'string') return props;
+
+  const sourceFile = getSourceFile(source.fileName);
+  if (!sourceFile) return props;
+
+  const nextProps = props ? { ...props } : {};
+  if (nextProps[OPTIONS.fileAttribute] == null) {
+    nextProps[OPTIONS.fileAttribute] = sourceFile;
+  }
+  if (OPTIONS.line && source.lineNumber != null && nextProps[OPTIONS.lineAttribute] == null) {
+    nextProps[OPTIONS.lineAttribute] = String(source.lineNumber);
+  }
+  if (OPTIONS.column && source.columnNumber != null && nextProps[OPTIONS.columnAttribute] == null) {
+    nextProps[OPTIONS.columnAttribute] = String(source.columnNumber);
+  }
+
+  return nextProps;
+}
+
+function getSourceFile(fileName) {
+  const absoluteFile = normalizePath(fileName);
+  const relativeFile = getRelativeFile(absoluteFile);
+
+  if (OPTIONS.include.length > 0 && !matchesAny(OPTIONS.include, absoluteFile, relativeFile)) {
+    return null;
+  }
+  if (matchesAny(OPTIONS.exclude, absoluteFile, relativeFile)) return null;
+
+  return OPTIONS.filePath === 'absolute' ? absoluteFile : relativeFile;
+}
+
+function getRelativeFile(absoluteFile) {
+  if (!OPTIONS.root) return absoluteFile;
+  if (absoluteFile === OPTIONS.root) return '';
+  if (absoluteFile.startsWith(OPTIONS.root + '/')) {
+    return absoluteFile.slice(OPTIONS.root.length + 1);
+  }
+
+  return absoluteFile;
+}
+
+function matchesAny(patterns, absoluteFile, relativeFile) {
+  return patterns.some((pattern) =>
+    matchesPattern(pattern, absoluteFile, relativeFile)
+  );
+}
+
+function matchesPattern(pattern, absoluteFile, relativeFile) {
+  if (pattern.type === 'regex') {
+    const regex = new RegExp(pattern.value, pattern.flags);
+    return regex.test(absoluteFile) || regex.test(relativeFile);
+  }
+
+  const value = pattern.value;
+  const target = isAbsolutePattern(value) ? absoluteFile : relativeFile;
+  if (!value.includes('*')) {
+    return target === value || target.startsWith(value + '/');
+  }
+
+  return globToRegExp(value).test(target);
+}
+
+function isAbsolutePattern(value) {
+  return value.startsWith('/') || /^[a-zA-Z]:\\//.test(value);
+}
+
+function globToRegExp(value) {
+  const source = escapeRegExp(value)
+    .replace(/\\\\\\*\\\\\\*/g, '.*')
+    .replace(/\\\\\\*/g, '[^/]*');
+
+  return new RegExp('^' + source + '$');
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[|\\\\{}()[\\]^$+*?.]/g, '\\\\$&');
+}
+
+function normalizePath(value) {
+  return value.replace(/\\\\/g, '/').replace(/\\/+$/, '');
+}
+`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  reviewSourceLocator
+});
+//# sourceMappingURL=vite.cjs.map

package/dist/vite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"sourcesContent":["import type { Plugin, ResolvedConfig } from 'vite';\n\ntype SourceLocatorPattern = string | RegExp;\n\nexport interface ReviewSourceLocatorOptions {\n  enabled?: boolean;\n  root?: string;\n  include?: readonly SourceLocatorPattern[];\n  exclude?: readonly SourceLocatorPattern[];\n  filePath?: 'relative' | 'absolute';\n  line?: boolean;\n  column?: boolean;\n  attributePrefix?: string;\n}\n\ntype RuntimeMatcher =\n  | { type: 'path'; value: string }\n  | { type: 'regex'; value: string; flags: string };\n\ntype RuntimeOptions = {\n  enabled: boolean;\n  root: string;\n  include: RuntimeMatcher[];\n  exclude: RuntimeMatcher[];\n  filePath: 'relative' | 'absolute';\n  line: boolean;\n  column: boolean;\n  fileAttribute: string;\n  lineAttribute: string;\n  columnAttribute: string;\n};\n\nconst VIRTUAL_JSX_DEV_RUNTIME_ID =\n  '\\0@designfever/web-review-kit/source-locator/jsx-dev-runtime';\n\nexport const reviewSourceLocator = (\n  options: ReviewSourceLocatorOptions = {}\n): Plugin => {\n  let runtimeOptions = createRuntimeOptions(options);\n\n  return {\n    name: 'df-web-review-kit-source-locator',\n    enforce: 'pre',\n    configResolved(config) {\n      runtimeOptions = createRuntimeOptions(options, config);\n    },\n    resolveId(id, importer) {\n      if (!runtimeOptions.enabled) return null;\n      if (id !== 'react/jsx-dev-runtime') return null;\n      if (importer === VIRTUAL_JSX_DEV_RUNTIME_ID) return null;\n\n      return VIRTUAL_JSX_DEV_RUNTIME_ID;\n    },\n    load(id) {\n      if (id !== VIRTUAL_JSX_DEV_RUNTIME_ID) return null;\n      return createJsxDevRuntime(runtimeOptions);\n    },\n  };\n};\n\nfunction createRuntimeOptions(\n  options: ReviewSourceLocatorOptions,\n  config?: ResolvedConfig\n): RuntimeOptions {\n  const attributePrefix = (options.attributePrefix ?? 'data-wrk-source').replace(\n    /-+$/,\n    ''\n  );\n  const root = normalizePath(options.root ?? config?.root ?? '');\n  const enabled = options.enabled ?? (config?.command === 'serve');\n\n  return {\n    enabled,\n    root,\n    include: (options.include ?? []).map(createRuntimeMatcher),\n    exclude: (options.exclude ?? ['node_modules', 'dist']).map(\n      createRuntimeMatcher\n    ),\n    filePath: options.filePath ?? 'relative',\n    line: options.line ?? true,\n    column: options.column ?? true,\n    fileAttribute: `${attributePrefix}-file`,\n    lineAttribute: `${attributePrefix}-line`,\n    columnAttribute: `${attributePrefix}-column`,\n  };\n}\n\nfunction createRuntimeMatcher(pattern: SourceLocatorPattern): RuntimeMatcher {\n  if (pattern instanceof RegExp) {\n    return { type: 'regex', value: pattern.source, flags: pattern.flags };\n  }\n\n  return { type: 'path', value: normalizePath(pattern).replace(/^\\.\\//, '') };\n}\n\nfunction normalizePath(value: string) {\n  return value.replace(/\\\\/g, '/').replace(/\\/+$/, '');\n}\n\nfunction createJsxDevRuntime(options: RuntimeOptions) {\n  return `\nimport { Fragment, jsxDEV as baseJsxDEV } from 'react/jsx-dev-runtime';\n\nconst OPTIONS = ${JSON.stringify(options)};\n\nexport { Fragment };\n\nexport function jsxDEV(type, props, key, isStaticChildren, source, self) {\n  return baseJsxDEV(\n    type,\n    injectSourceProps(type, props, source),\n    key,\n    isStaticChildren,\n    source,\n    self\n  );\n}\n\nfunction injectSourceProps(type, props, source) {\n  if (typeof type !== 'string') return props;\n  if (!source || typeof source.fileName !== 'string') return props;\n\n  const sourceFile = getSourceFile(source.fileName);\n  if (!sourceFile) return props;\n\n  const nextProps = props ? { ...props } : {};\n  if (nextProps[OPTIONS.fileAttribute] == null) {\n    nextProps[OPTIONS.fileAttribute] = sourceFile;\n  }\n  if (OPTIONS.line && source.lineNumber != null && nextProps[OPTIONS.lineAttribute] == null) {\n    nextProps[OPTIONS.lineAttribute] = String(source.lineNumber);\n  }\n  if (OPTIONS.column && source.columnNumber != null && nextProps[OPTIONS.columnAttribute] == null) {\n    nextProps[OPTIONS.columnAttribute] = String(source.columnNumber);\n  }\n\n  return nextProps;\n}\n\nfunction getSourceFile(fileName) {\n  const absoluteFile = normalizePath(fileName);\n  const relativeFile = getRelativeFile(absoluteFile);\n\n  if (OPTIONS.include.length > 0 && !matchesAny(OPTIONS.include, absoluteFile, relativeFile)) {\n    return null;\n  }\n  if (matchesAny(OPTIONS.exclude, absoluteFile, relativeFile)) return null;\n\n  return OPTIONS.filePath === 'absolute' ? absoluteFile : relativeFile;\n}\n\nfunction getRelativeFile(absoluteFile) {\n  if (!OPTIONS.root) return absoluteFile;\n  if (absoluteFile === OPTIONS.root) return '';\n  if (absoluteFile.startsWith(OPTIONS.root + '/')) {\n    return absoluteFile.slice(OPTIONS.root.length + 1);\n  }\n\n  return absoluteFile;\n}\n\nfunction matchesAny(patterns, absoluteFile, relativeFile) {\n  return patterns.some((pattern) =>\n    matchesPattern(pattern, absoluteFile, relativeFile)\n  );\n}\n\nfunction matchesPattern(pattern, absoluteFile, relativeFile) {\n  if (pattern.type === 'regex') {\n    const regex = new RegExp(pattern.value, pattern.flags);\n    return regex.test(absoluteFile) || regex.test(relativeFile);\n  }\n\n  const value = pattern.value;\n  const target = isAbsolutePattern(value) ? absoluteFile : relativeFile;\n  if (!value.includes('*')) {\n    return target === value || target.startsWith(value + '/');\n  }\n\n  return globToRegExp(value).test(target);\n}\n\nfunction isAbsolutePattern(value) {\n  return value.startsWith('/') || /^[a-zA-Z]:\\\\//.test(value);\n}\n\nfunction globToRegExp(value) {\n  const source = escapeRegExp(value)\n    .replace(/\\\\\\\\\\\\*\\\\\\\\\\\\*/g, '.*')\n    .replace(/\\\\\\\\\\\\*/g, '[^/]*');\n\n  return new RegExp('^' + source + '$');\n}\n\nfunction escapeRegExp(value) {\n  return value.replace(/[|\\\\\\\\{}()[\\\\]^$+*?.]/g, '\\\\\\\\$&');\n}\n\nfunction normalizePath(value) {\n  return value.replace(/\\\\\\\\/g, '/').replace(/\\\\/+$/, '');\n}\n`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,IAAM,6BACJ;AAEK,IAAM,sBAAsB,CACjC,UAAsC,CAAC,MAC5B;AACX,MAAI,iBAAiB,qBAAqB,OAAO;AAEjD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,eAAe,QAAQ;AACrB,uBAAiB,qBAAqB,SAAS,MAAM;AAAA,IACvD;AAAA,IACA,UAAU,IAAI,UAAU;AACtB,UAAI,CAAC,eAAe,QAAS,QAAO;AACpC,UAAI,OAAO,wBAAyB,QAAO;AAC3C,UAAI,aAAa,2BAA4B,QAAO;AAEpD,aAAO;AAAA,IACT;AAAA,IACA,KAAK,IAAI;AACP,UAAI,OAAO,2BAA4B,QAAO;AAC9C,aAAO,oBAAoB,cAAc;AAAA,IAC3C;AAAA,EACF;AACF;AAEA,SAAS,qBACP,SACA,QACgB;AAChB,QAAM,mBAAmB,QAAQ,mBAAmB,mBAAmB;AAAA,IACrE;AAAA,IACA;AAAA,EACF;AACA,QAAM,OAAO,cAAc,QAAQ,QAAQ,QAAQ,QAAQ,EAAE;AAC7D,QAAM,UAAU,QAAQ,WAAY,QAAQ,YAAY;AAExD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,QAAQ,WAAW,CAAC,GAAG,IAAI,oBAAoB;AAAA,IACzD,UAAU,QAAQ,WAAW,CAAC,gBAAgB,MAAM,GAAG;AAAA,MACrD;AAAA,IACF;AAAA,IACA,UAAU,QAAQ,YAAY;AAAA,IAC9B,MAAM,QAAQ,QAAQ;AAAA,IACtB,QAAQ,QAAQ,UAAU;AAAA,IAC1B,eAAe,GAAG,eAAe;AAAA,IACjC,eAAe,GAAG,eAAe;AAAA,IACjC,iBAAiB,GAAG,eAAe;AAAA,EACrC;AACF;AAEA,SAAS,qBAAqB,SAA+C;AAC3E,MAAI,mBAAmB,QAAQ;AAC7B,WAAO,EAAE,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,QAAQ,MAAM;AAAA,EACtE;AAEA,SAAO,EAAE,MAAM,QAAQ,OAAO,cAAc,OAAO,EAAE,QAAQ,SAAS,EAAE,EAAE;AAC5E;AAEA,SAAS,cAAc,OAAe;AACpC,SAAO,MAAM,QAAQ,OAAO,GAAG,EAAE,QAAQ,QAAQ,EAAE;AACrD;AAEA,SAAS,oBAAoB,SAAyB;AACpD,SAAO;AAAA;AAAA;AAAA,kBAGS,KAAK,UAAU,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmGzC;","names":[]}

package/dist/vite.d.cts

@@ -0,0 +1,16 @@
+import { Plugin } from 'vite';
+
+type SourceLocatorPattern = string | RegExp;
+interface ReviewSourceLocatorOptions {
+    enabled?: boolean;
+    root?: string;
+    include?: readonly SourceLocatorPattern[];
+    exclude?: readonly SourceLocatorPattern[];
+    filePath?: 'relative' | 'absolute';
+    line?: boolean;
+    column?: boolean;
+    attributePrefix?: string;
+}
+declare const reviewSourceLocator: (options?: ReviewSourceLocatorOptions) => Plugin;
+
+export { type ReviewSourceLocatorOptions, reviewSourceLocator };

package/dist/vite.d.ts

@@ -0,0 +1,16 @@
+import { Plugin } from 'vite';
+
+type SourceLocatorPattern = string | RegExp;
+interface ReviewSourceLocatorOptions {
+    enabled?: boolean;
+    root?: string;
+    include?: readonly SourceLocatorPattern[];
+    exclude?: readonly SourceLocatorPattern[];
+    filePath?: 'relative' | 'absolute';
+    line?: boolean;
+    column?: boolean;
+    attributePrefix?: string;
+}
+declare const reviewSourceLocator: (options?: ReviewSourceLocatorOptions) => Plugin;
+
+export { type ReviewSourceLocatorOptions, reviewSourceLocator };

package/dist/vite.js

@@ -0,0 +1,161 @@
+// src/vite.ts
+var VIRTUAL_JSX_DEV_RUNTIME_ID = "\0@designfever/web-review-kit/source-locator/jsx-dev-runtime";
+var reviewSourceLocator = (options = {}) => {
+  let runtimeOptions = createRuntimeOptions(options);
+  return {
+    name: "df-web-review-kit-source-locator",
+    enforce: "pre",
+    configResolved(config) {
+      runtimeOptions = createRuntimeOptions(options, config);
+    },
+    resolveId(id, importer) {
+      if (!runtimeOptions.enabled) return null;
+      if (id !== "react/jsx-dev-runtime") return null;
+      if (importer === VIRTUAL_JSX_DEV_RUNTIME_ID) return null;
+      return VIRTUAL_JSX_DEV_RUNTIME_ID;
+    },
+    load(id) {
+      if (id !== VIRTUAL_JSX_DEV_RUNTIME_ID) return null;
+      return createJsxDevRuntime(runtimeOptions);
+    }
+  };
+};
+function createRuntimeOptions(options, config) {
+  const attributePrefix = (options.attributePrefix ?? "data-wrk-source").replace(
+    /-+$/,
+    ""
+  );
+  const root = normalizePath(options.root ?? config?.root ?? "");
+  const enabled = options.enabled ?? config?.command === "serve";
+  return {
+    enabled,
+    root,
+    include: (options.include ?? []).map(createRuntimeMatcher),
+    exclude: (options.exclude ?? ["node_modules", "dist"]).map(
+      createRuntimeMatcher
+    ),
+    filePath: options.filePath ?? "relative",
+    line: options.line ?? true,
+    column: options.column ?? true,
+    fileAttribute: `${attributePrefix}-file`,
+    lineAttribute: `${attributePrefix}-line`,
+    columnAttribute: `${attributePrefix}-column`
+  };
+}
+function createRuntimeMatcher(pattern) {
+  if (pattern instanceof RegExp) {
+    return { type: "regex", value: pattern.source, flags: pattern.flags };
+  }
+  return { type: "path", value: normalizePath(pattern).replace(/^\.\//, "") };
+}
+function normalizePath(value) {
+  return value.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+function createJsxDevRuntime(options) {
+  return `
+import { Fragment, jsxDEV as baseJsxDEV } from 'react/jsx-dev-runtime';
+
+const OPTIONS = ${JSON.stringify(options)};
+
+export { Fragment };
+
+export function jsxDEV(type, props, key, isStaticChildren, source, self) {
+  return baseJsxDEV(
+    type,
+    injectSourceProps(type, props, source),
+    key,
+    isStaticChildren,
+    source,
+    self
+  );
+}
+
+function injectSourceProps(type, props, source) {
+  if (typeof type !== 'string') return props;
+  if (!source || typeof source.fileName !== 'string') return props;
+
+  const sourceFile = getSourceFile(source.fileName);
+  if (!sourceFile) return props;
+
+  const nextProps = props ? { ...props } : {};
+  if (nextProps[OPTIONS.fileAttribute] == null) {
+    nextProps[OPTIONS.fileAttribute] = sourceFile;
+  }
+  if (OPTIONS.line && source.lineNumber != null && nextProps[OPTIONS.lineAttribute] == null) {
+    nextProps[OPTIONS.lineAttribute] = String(source.lineNumber);
+  }
+  if (OPTIONS.column && source.columnNumber != null && nextProps[OPTIONS.columnAttribute] == null) {
+    nextProps[OPTIONS.columnAttribute] = String(source.columnNumber);
+  }
+
+  return nextProps;
+}
+
+function getSourceFile(fileName) {
+  const absoluteFile = normalizePath(fileName);
+  const relativeFile = getRelativeFile(absoluteFile);
+
+  if (OPTIONS.include.length > 0 && !matchesAny(OPTIONS.include, absoluteFile, relativeFile)) {
+    return null;
+  }
+  if (matchesAny(OPTIONS.exclude, absoluteFile, relativeFile)) return null;
+
+  return OPTIONS.filePath === 'absolute' ? absoluteFile : relativeFile;
+}
+
+function getRelativeFile(absoluteFile) {
+  if (!OPTIONS.root) return absoluteFile;
+  if (absoluteFile === OPTIONS.root) return '';
+  if (absoluteFile.startsWith(OPTIONS.root + '/')) {
+    return absoluteFile.slice(OPTIONS.root.length + 1);
+  }
+
+  return absoluteFile;
+}
+
+function matchesAny(patterns, absoluteFile, relativeFile) {
+  return patterns.some((pattern) =>
+    matchesPattern(pattern, absoluteFile, relativeFile)
+  );
+}
+
+function matchesPattern(pattern, absoluteFile, relativeFile) {
+  if (pattern.type === 'regex') {
+    const regex = new RegExp(pattern.value, pattern.flags);
+    return regex.test(absoluteFile) || regex.test(relativeFile);
+  }
+
+  const value = pattern.value;
+  const target = isAbsolutePattern(value) ? absoluteFile : relativeFile;
+  if (!value.includes('*')) {
+    return target === value || target.startsWith(value + '/');
+  }
+
+  return globToRegExp(value).test(target);
+}
+
+function isAbsolutePattern(value) {
+  return value.startsWith('/') || /^[a-zA-Z]:\\//.test(value);
+}
+
+function globToRegExp(value) {
+  const source = escapeRegExp(value)
+    .replace(/\\\\\\*\\\\\\*/g, '.*')
+    .replace(/\\\\\\*/g, '[^/]*');
+
+  return new RegExp('^' + source + '$');
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[|\\\\{}()[\\]^$+*?.]/g, '\\\\$&');
+}
+
+function normalizePath(value) {
+  return value.replace(/\\\\/g, '/').replace(/\\/+$/, '');
+}
+`;
+}
+export {
+  reviewSourceLocator
+};
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"sourcesContent":["import type { Plugin, ResolvedConfig } from 'vite';\n\ntype SourceLocatorPattern = string | RegExp;\n\nexport interface ReviewSourceLocatorOptions {\n  enabled?: boolean;\n  root?: string;\n  include?: readonly SourceLocatorPattern[];\n  exclude?: readonly SourceLocatorPattern[];\n  filePath?: 'relative' | 'absolute';\n  line?: boolean;\n  column?: boolean;\n  attributePrefix?: string;\n}\n\ntype RuntimeMatcher =\n  | { type: 'path'; value: string }\n  | { type: 'regex'; value: string; flags: string };\n\ntype RuntimeOptions = {\n  enabled: boolean;\n  root: string;\n  include: RuntimeMatcher[];\n  exclude: RuntimeMatcher[];\n  filePath: 'relative' | 'absolute';\n  line: boolean;\n  column: boolean;\n  fileAttribute: string;\n  lineAttribute: string;\n  columnAttribute: string;\n};\n\nconst VIRTUAL_JSX_DEV_RUNTIME_ID =\n  '\\0@designfever/web-review-kit/source-locator/jsx-dev-runtime';\n\nexport const reviewSourceLocator = (\n  options: ReviewSourceLocatorOptions = {}\n): Plugin => {\n  let runtimeOptions = createRuntimeOptions(options);\n\n  return {\n    name: 'df-web-review-kit-source-locator',\n    enforce: 'pre',\n    configResolved(config) {\n      runtimeOptions = createRuntimeOptions(options, config);\n    },\n    resolveId(id, importer) {\n      if (!runtimeOptions.enabled) return null;\n      if (id !== 'react/jsx-dev-runtime') return null;\n      if (importer === VIRTUAL_JSX_DEV_RUNTIME_ID) return null;\n\n      return VIRTUAL_JSX_DEV_RUNTIME_ID;\n    },\n    load(id) {\n      if (id !== VIRTUAL_JSX_DEV_RUNTIME_ID) return null;\n      return createJsxDevRuntime(runtimeOptions);\n    },\n  };\n};\n\nfunction createRuntimeOptions(\n  options: ReviewSourceLocatorOptions,\n  config?: ResolvedConfig\n): RuntimeOptions {\n  const attributePrefix = (options.attributePrefix ?? 'data-wrk-source').replace(\n    /-+$/,\n    ''\n  );\n  const root = normalizePath(options.root ?? config?.root ?? '');\n  const enabled = options.enabled ?? (config?.command === 'serve');\n\n  return {\n    enabled,\n    root,\n    include: (options.include ?? []).map(createRuntimeMatcher),\n    exclude: (options.exclude ?? ['node_modules', 'dist']).map(\n      createRuntimeMatcher\n    ),\n    filePath: options.filePath ?? 'relative',\n    line: options.line ?? true,\n    column: options.column ?? true,\n    fileAttribute: `${attributePrefix}-file`,\n    lineAttribute: `${attributePrefix}-line`,\n    columnAttribute: `${attributePrefix}-column`,\n  };\n}\n\nfunction createRuntimeMatcher(pattern: SourceLocatorPattern): RuntimeMatcher {\n  if (pattern instanceof RegExp) {\n    return { type: 'regex', value: pattern.source, flags: pattern.flags };\n  }\n\n  return { type: 'path', value: normalizePath(pattern).replace(/^\\.\\//, '') };\n}\n\nfunction normalizePath(value: string) {\n  return value.replace(/\\\\/g, '/').replace(/\\/+$/, '');\n}\n\nfunction createJsxDevRuntime(options: RuntimeOptions) {\n  return `\nimport { Fragment, jsxDEV as baseJsxDEV } from 'react/jsx-dev-runtime';\n\nconst OPTIONS = ${JSON.stringify(options)};\n\nexport { Fragment };\n\nexport function jsxDEV(type, props, key, isStaticChildren, source, self) {\n  return baseJsxDEV(\n    type,\n    injectSourceProps(type, props, source),\n    key,\n    isStaticChildren,\n    source,\n    self\n  );\n}\n\nfunction injectSourceProps(type, props, source) {\n  if (typeof type !== 'string') return props;\n  if (!source || typeof source.fileName !== 'string') return props;\n\n  const sourceFile = getSourceFile(source.fileName);\n  if (!sourceFile) return props;\n\n  const nextProps = props ? { ...props } : {};\n  if (nextProps[OPTIONS.fileAttribute] == null) {\n    nextProps[OPTIONS.fileAttribute] = sourceFile;\n  }\n  if (OPTIONS.line && source.lineNumber != null && nextProps[OPTIONS.lineAttribute] == null) {\n    nextProps[OPTIONS.lineAttribute] = String(source.lineNumber);\n  }\n  if (OPTIONS.column && source.columnNumber != null && nextProps[OPTIONS.columnAttribute] == null) {\n    nextProps[OPTIONS.columnAttribute] = String(source.columnNumber);\n  }\n\n  return nextProps;\n}\n\nfunction getSourceFile(fileName) {\n  const absoluteFile = normalizePath(fileName);\n  const relativeFile = getRelativeFile(absoluteFile);\n\n  if (OPTIONS.include.length > 0 && !matchesAny(OPTIONS.include, absoluteFile, relativeFile)) {\n    return null;\n  }\n  if (matchesAny(OPTIONS.exclude, absoluteFile, relativeFile)) return null;\n\n  return OPTIONS.filePath === 'absolute' ? absoluteFile : relativeFile;\n}\n\nfunction getRelativeFile(absoluteFile) {\n  if (!OPTIONS.root) return absoluteFile;\n  if (absoluteFile === OPTIONS.root) return '';\n  if (absoluteFile.startsWith(OPTIONS.root + '/')) {\n    return absoluteFile.slice(OPTIONS.root.length + 1);\n  }\n\n  return absoluteFile;\n}\n\nfunction matchesAny(patterns, absoluteFile, relativeFile) {\n  return patterns.some((pattern) =>\n    matchesPattern(pattern, absoluteFile, relativeFile)\n  );\n}\n\nfunction matchesPattern(pattern, absoluteFile, relativeFile) {\n  if (pattern.type === 'regex') {\n    const regex = new RegExp(pattern.value, pattern.flags);\n    return regex.test(absoluteFile) || regex.test(relativeFile);\n  }\n\n  const value = pattern.value;\n  const target = isAbsolutePattern(value) ? absoluteFile : relativeFile;\n  if (!value.includes('*')) {\n    return target === value || target.startsWith(value + '/');\n  }\n\n  return globToRegExp(value).test(target);\n}\n\nfunction isAbsolutePattern(value) {\n  return value.startsWith('/') || /^[a-zA-Z]:\\\\//.test(value);\n}\n\nfunction globToRegExp(value) {\n  const source = escapeRegExp(value)\n    .replace(/\\\\\\\\\\\\*\\\\\\\\\\\\*/g, '.*')\n    .replace(/\\\\\\\\\\\\*/g, '[^/]*');\n\n  return new RegExp('^' + source + '$');\n}\n\nfunction escapeRegExp(value) {\n  return value.replace(/[|\\\\\\\\{}()[\\\\]^$+*?.]/g, '\\\\\\\\$&');\n}\n\nfunction normalizePath(value) {\n  return value.replace(/\\\\\\\\/g, '/').replace(/\\\\/+$/, '');\n}\n`;\n}\n"],"mappings":";AAgCA,IAAM,6BACJ;AAEK,IAAM,sBAAsB,CACjC,UAAsC,CAAC,MAC5B;AACX,MAAI,iBAAiB,qBAAqB,OAAO;AAEjD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,eAAe,QAAQ;AACrB,uBAAiB,qBAAqB,SAAS,MAAM;AAAA,IACvD;AAAA,IACA,UAAU,IAAI,UAAU;AACtB,UAAI,CAAC,eAAe,QAAS,QAAO;AACpC,UAAI,OAAO,wBAAyB,QAAO;AAC3C,UAAI,aAAa,2BAA4B,QAAO;AAEpD,aAAO;AAAA,IACT;AAAA,IACA,KAAK,IAAI;AACP,UAAI,OAAO,2BAA4B,QAAO;AAC9C,aAAO,oBAAoB,cAAc;AAAA,IAC3C;AAAA,EACF;AACF;AAEA,SAAS,qBACP,SACA,QACgB;AAChB,QAAM,mBAAmB,QAAQ,mBAAmB,mBAAmB;AAAA,IACrE;AAAA,IACA;AAAA,EACF;AACA,QAAM,OAAO,cAAc,QAAQ,QAAQ,QAAQ,QAAQ,EAAE;AAC7D,QAAM,UAAU,QAAQ,WAAY,QAAQ,YAAY;AAExD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,QAAQ,WAAW,CAAC,GAAG,IAAI,oBAAoB;AAAA,IACzD,UAAU,QAAQ,WAAW,CAAC,gBAAgB,MAAM,GAAG;AAAA,MACrD;AAAA,IACF;AAAA,IACA,UAAU,QAAQ,YAAY;AAAA,IAC9B,MAAM,QAAQ,QAAQ;AAAA,IACtB,QAAQ,QAAQ,UAAU;AAAA,IAC1B,eAAe,GAAG,eAAe;AAAA,IACjC,eAAe,GAAG,eAAe;AAAA,IACjC,iBAAiB,GAAG,eAAe;AAAA,EACrC;AACF;AAEA,SAAS,qBAAqB,SAA+C;AAC3E,MAAI,mBAAmB,QAAQ;AAC7B,WAAO,EAAE,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,QAAQ,MAAM;AAAA,EACtE;AAEA,SAAO,EAAE,MAAM,QAAQ,OAAO,cAAc,OAAO,EAAE,QAAQ,SAAS,EAAE,EAAE;AAC5E;AAEA,SAAS,cAAc,OAAe;AACpC,SAAO,MAAM,QAAQ,OAAO,GAAG,EAAE,QAAQ,QAAQ,EAAE;AACrD;AAEA,SAAS,oBAAoB,SAAyB;AACpD,SAAO;AAAA;AAAA;AAAA,kBAGS,KAAK,UAAU,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmGzC;","names":[]}

package/docs/README.md

@@ -1,37 +1,28 @@
 # df-web-review-kit docs
 
-현재 문서의 읽는 순서:
+Public docs are intentionally small. Keep implementation history, handoff notes, and internal operator decisions out of this package documentation.
 
-1. [Concept](concept.md)
-2. [Installation](installation.md)
-3. [Supabase setup](supabase.md)
-4. [Supabase review item SQL](supabase-review-items.md)
-5. [Supabase presence](supabase-presence.md)
-6. [Adapter handoff](adapter-handoff.md)
-7. [df-sheet next](df-sheet-next.md)
-8. [Review feedback 2026-06-20](review-feedback-2026-06-20.md)
-9. [Stabilize UI work guide](stabilize-ui-work-guide.md)
-10. [Smoke baseline 2026-06-20](smoke-baseline-2026-06-20.md)
-11. [Package split checkpoint](package-split-checkpoint.md)
+## Read This Order
 
-## 문서 역할
+1. [Installation](installation.md)
+2. [Custom adapter sample](adaptor.sample.ts)
+3. [DB setup](db-setup.md)
+4. [Architecture and runtime logic](architecture.md)
+5. [Figma overlay](figma-overlay.md)
+6. [Grid overlay](grid-overlay.md)
 
-- `concept.md`: 왜 이 package가 있고 어떤 문제를 해결하는지.
-- `installation.md`: host project에 설치하고 `/review` route에 붙이는 방법.
-- `supabase.md`: Supabase를 remote QA 저장소와 presence backend로 연결하는 방법.
-- `supabase-review-items.md`: 실제 table/RPC/RLS SQL.
-- `supabase-presence.md`: Supabase Realtime Presence adapter 구조.
-- `adapter-handoff.md`: package repo로 옮길 때 필요한 adapter contract 정리.
-- `df-sheet-next.md`: df-sheet를 source of record로 쓸 때 필요한 제품/API 방향.
-- `review-feedback-2026-06-20.md`: 빵빵/팡팡/오빵 package 리뷰 메모와 우선순위.
-- `stabilize-ui-work-guide.md`: anchor 안정화, UI token화, package split 전 작업 순서.
-- `smoke-baseline-2026-06-20.md`: 761 현재 기능 smoke 기준선 결과.
-- `package-split-checkpoint.md`: 765 package export/file/peer dependency와 host 소비 경계.
-- `initial-plan.md`: 초기 계획 기록. 현재 기준 문서가 아니다.
+## Document Roles
 
-## 현재 기준
+- `installation.md`: install the npm package, create the `/review` route, wire adapters, and run checks.
+- `adaptor.sample.ts`: copyable starting point for host-owned remote adapters.
+- `db-setup.md`: optional Supabase review item table/RPC/RLS/presence setup.
+- `architecture.md`: core/runtime, React shell, coordinate, anchor, and feature boundary notes.
+- `figma-overlay.md`: host requirements for the Figma overlay toggle.
+- `grid-overlay.md`: host requirements for the grid/helper overlay toggle.
 
-- `local`: 개인 draft 저장소.
-- `supabase`: 팀 공유 remote 저장소.
-- `df-sheet`: 나중에 issue workflow로 연결할 수 있는 remote destination.
-- local 번호는 개인 draft용이고, remote 번호는 remote source가 새로 발급하는 canonical 번호다.
+## Boundary
+
+- `local` is the default draft storage.
+- `supabase` is an optional adapter sample for users who configure their own backend.
+- `presence` is temporary session state, not QA item persistence.
+- `kuku` and operator keys belong to OpenClaw or a backend/admin service, not this public package.