@designfever/web-review-kit 0.4.1 → 0.6.0

package/dist/{types-D_qYtwTs.d.cts → types-DFHHVRBc.d.cts}

@@ -163,6 +163,7 @@ interface WebReviewKitController {
     close(): void;
     toggle(): void;
     setMode(mode: ReviewMode): void;
+    startElementReview(element: Element, comment?: string): Promise<void>;
     getMode(): ReviewMode;
     highlightItem(itemId?: string): void;
     setHiddenItemIds(itemIds?: string[]): void;
@@ -175,6 +176,7 @@ interface WebReviewKitTarget {
     document: Document;
     getViewportRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
     getOverlayRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
+    getComposerHost?: () => HTMLElement | null | undefined;
 }
 
 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_qYtwTs.d.ts → types-DFHHVRBc.d.ts}

@@ -163,6 +163,7 @@ interface WebReviewKitController {
     close(): void;
     toggle(): void;
     setMode(mode: ReviewMode): void;
+    startElementReview(element: Element, comment?: string): Promise<void>;
     getMode(): ReviewMode;
     highlightItem(itemId?: string): void;
     setHiddenItemIds(itemIds?: string[]): void;
@@ -175,6 +176,7 @@ interface WebReviewKitTarget {
     document: Document;
     getViewportRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
     getOverlayRect?: () => Pick<DOMRect, 'left' | 'top' | 'width' | 'height'>;
+    getComposerHost?: () => HTMLElement | null | undefined;
 }
 
 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

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/vite.ts
 var vite_exports = {};
 __export(vite_exports, {
+  reviewDataLocator: () => reviewDataLocator,
   reviewSourceLocator: () => reviewSourceLocator
 });
 module.exports = __toCommonJS(vite_exports);
@@ -44,6 +45,54 @@ var reviewSourceLocator = (options = {}) => {
     }
   };
 };
+var reviewDataLocator = (options = {}) => {
+  let root = normalizePath(options.root ?? "");
+  let enabled = options.enabled ?? false;
+  const include = (options.include ?? []).map(createRuntimeMatcher);
+  const exclude = (options.exclude ?? ["node_modules", "dist"]).map(
+    createRuntimeMatcher
+  );
+  const componentPattern = options.componentPattern ?? /Section[A-Za-z0-9_]*/;
+  const fileKey = options.fileAttribute ?? "__wrkDataFile";
+  const lineKey = options.lineAttribute ?? "__wrkDataLine";
+  const componentSource = `(^|[\\n,{(\\[]\\s*)(component:\\s*)(['"\`])(${componentPattern.source})\\3`;
+  return {
+    name: "df-web-review-kit-data-locator",
+    enforce: "pre",
+    configResolved(config) {
+      root = normalizePath(options.root ?? config.root ?? "");
+      enabled = options.enabled ?? config.command === "serve";
+    },
+    transform(code, id) {
+      if (!enabled) return null;
+      const file = normalizePath(id.split("?")[0]);
+      const relativeFile = root && file.startsWith(root + "/") ? file.slice(root.length + 1) : file;
+      if (include.length > 0 && !include.some((m) => matchesPath(m, file, relativeFile)))
+        return null;
+      if (exclude.some((m) => matchesPath(m, file, relativeFile))) return null;
+      const sourceFile = (options.filePath ?? "relative") === "absolute" ? file : relativeFile;
+      const regex = new RegExp(componentSource, "g");
+      let changed = false;
+      const out = code.replace(
+        regex,
+        (_match, pre, comp, quote, name, offset) => {
+          const line = code.slice(0, offset + pre.length).split("\n").length;
+          changed = true;
+          return `${pre}${JSON.stringify(fileKey)}: ${JSON.stringify(sourceFile)}, ${JSON.stringify(lineKey)}: ${line}, ${comp}${quote}${name}${quote}`;
+        }
+      );
+      return changed ? { code: out, map: null } : null;
+    }
+  };
+};
+function matchesPath(matcher, absoluteFile, relativeFile) {
+  if (matcher.type === "regex") {
+    const regex = new RegExp(matcher.value, matcher.flags);
+    return regex.test(absoluteFile) || regex.test(relativeFile);
+  }
+  const target = matcher.value.startsWith("/") ? absoluteFile : relativeFile;
+  return target === matcher.value || target.startsWith(matcher.value + "/") || target.includes("/" + matcher.value);
+}
 function createRuntimeOptions(options, config) {
   const attributePrefix = (options.attributePrefix ?? "data-wrk-source").replace(
     /-+$/,
@@ -181,6 +230,7 @@ function normalizePath(value) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  reviewDataLocator,
   reviewSourceLocator
 });
 //# sourceMappingURL=vite.cjs.map

package/dist/vite.cjs.map

@@ -1 +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":[]}
+{"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\nexport interface ReviewDataLocatorOptions {\n  enabled?: boolean;\n  root?: string;\n  include?: readonly SourceLocatorPattern[];\n  exclude?: readonly SourceLocatorPattern[];\n  filePath?: 'relative' | 'absolute';\n  /** 매칭할 component 이름 패턴. 기본은 `Section`으로 시작하는 이름. */\n  componentPattern?: RegExp;\n  fileAttribute?: string;\n  lineAttribute?: string;\n}\n\n/**\n * page data 파일의 section 객체(`component: 'SectionXxx'`)에 출처 파일/라인을\n * `__wrkDataFile`/`__wrkDataLine` prop 으로 주입한다. 라인 보존을 위해 같은 줄에만 삽입한다.\n */\nexport const reviewDataLocator = (\n  options: ReviewDataLocatorOptions = {}\n): Plugin => {\n  let root = normalizePath(options.root ?? '');\n  let enabled = options.enabled ?? false;\n  const include = (options.include ?? []).map(createRuntimeMatcher);\n  const exclude = (options.exclude ?? ['node_modules', 'dist']).map(\n    createRuntimeMatcher\n  );\n  const componentPattern = options.componentPattern ?? /Section[A-Za-z0-9_]*/;\n  const fileKey = options.fileAttribute ?? '__wrkDataFile';\n  const lineKey = options.lineAttribute ?? '__wrkDataLine';\n\n  const componentSource = `(^|[\\\\n,{(\\\\[]\\\\s*)(component:\\\\s*)(['\"\\`])(${componentPattern.source})\\\\3`;\n\n  return {\n    name: 'df-web-review-kit-data-locator',\n    enforce: 'pre',\n    configResolved(config) {\n      root = normalizePath(options.root ?? config.root ?? '');\n      enabled = options.enabled ?? config.command === 'serve';\n    },\n    transform(code, id) {\n      if (!enabled) return null;\n      const file = normalizePath(id.split('?')[0]);\n      const relativeFile =\n        root && file.startsWith(root + '/') ? file.slice(root.length + 1) : file;\n      if (include.length > 0 && !include.some((m) => matchesPath(m, file, relativeFile)))\n        return null;\n      if (exclude.some((m) => matchesPath(m, file, relativeFile))) return null;\n\n      const sourceFile = (options.filePath ?? 'relative') === 'absolute' ? file : relativeFile;\n      const regex = new RegExp(componentSource, 'g');\n      let changed = false;\n      const out = code.replace(\n        regex,\n        (_match, pre: string, comp: string, quote: string, name: string, offset: number) => {\n          const line = code.slice(0, offset + pre.length).split('\\n').length;\n          changed = true;\n          return `${pre}${JSON.stringify(fileKey)}: ${JSON.stringify(sourceFile)}, ${JSON.stringify(lineKey)}: ${line}, ${comp}${quote}${name}${quote}`;\n        }\n      );\n\n      return changed ? { code: out, map: null } : null;\n    },\n  };\n};\n\nfunction matchesPath(\n  matcher: RuntimeMatcher,\n  absoluteFile: string,\n  relativeFile: string\n) {\n  if (matcher.type === 'regex') {\n    const regex = new RegExp(matcher.value, matcher.flags);\n    return regex.test(absoluteFile) || regex.test(relativeFile);\n  }\n  const target = matcher.value.startsWith('/') ? absoluteFile : relativeFile;\n  return target === matcher.value || target.startsWith(matcher.value + '/') || target.includes('/' + matcher.value);\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;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;AAkBO,IAAM,oBAAoB,CAC/B,UAAoC,CAAC,MAC1B;AACX,MAAI,OAAO,cAAc,QAAQ,QAAQ,EAAE;AAC3C,MAAI,UAAU,QAAQ,WAAW;AACjC,QAAM,WAAW,QAAQ,WAAW,CAAC,GAAG,IAAI,oBAAoB;AAChE,QAAM,WAAW,QAAQ,WAAW,CAAC,gBAAgB,MAAM,GAAG;AAAA,IAC5D;AAAA,EACF;AACA,QAAM,mBAAmB,QAAQ,oBAAoB;AACrD,QAAM,UAAU,QAAQ,iBAAiB;AACzC,QAAM,UAAU,QAAQ,iBAAiB;AAEzC,QAAM,kBAAkB,+CAA+C,iBAAiB,MAAM;AAE9F,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,eAAe,QAAQ;AACrB,aAAO,cAAc,QAAQ,QAAQ,OAAO,QAAQ,EAAE;AACtD,gBAAU,QAAQ,WAAW,OAAO,YAAY;AAAA,IAClD;AAAA,IACA,UAAU,MAAM,IAAI;AAClB,UAAI,CAAC,QAAS,QAAO;AACrB,YAAM,OAAO,cAAc,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC;AAC3C,YAAM,eACJ,QAAQ,KAAK,WAAW,OAAO,GAAG,IAAI,KAAK,MAAM,KAAK,SAAS,CAAC,IAAI;AACtE,UAAI,QAAQ,SAAS,KAAK,CAAC,QAAQ,KAAK,CAAC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC;AAC/E,eAAO;AACT,UAAI,QAAQ,KAAK,CAAC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,EAAG,QAAO;AAEpE,YAAM,cAAc,QAAQ,YAAY,gBAAgB,aAAa,OAAO;AAC5E,YAAM,QAAQ,IAAI,OAAO,iBAAiB,GAAG;AAC7C,UAAI,UAAU;AACd,YAAM,MAAM,KAAK;AAAA,QACf;AAAA,QACA,CAAC,QAAQ,KAAa,MAAc,OAAe,MAAc,WAAmB;AAClF,gBAAM,OAAO,KAAK,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,MAAM,IAAI,EAAE;AAC5D,oBAAU;AACV,iBAAO,GAAG,GAAG,GAAG,KAAK,UAAU,OAAO,CAAC,KAAK,KAAK,UAAU,UAAU,CAAC,KAAK,KAAK,UAAU,OAAO,CAAC,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK;AAAA,QAC7I;AAAA,MACF;AAEA,aAAO,UAAU,EAAE,MAAM,KAAK,KAAK,KAAK,IAAI;AAAA,IAC9C;AAAA,EACF;AACF;AAEA,SAAS,YACP,SACA,cACA,cACA;AACA,MAAI,QAAQ,SAAS,SAAS;AAC5B,UAAM,QAAQ,IAAI,OAAO,QAAQ,OAAO,QAAQ,KAAK;AACrD,WAAO,MAAM,KAAK,YAAY,KAAK,MAAM,KAAK,YAAY;AAAA,EAC5D;AACA,QAAM,SAAS,QAAQ,MAAM,WAAW,GAAG,IAAI,eAAe;AAC9D,SAAO,WAAW,QAAQ,SAAS,OAAO,WAAW,QAAQ,QAAQ,GAAG,KAAK,OAAO,SAAS,MAAM,QAAQ,KAAK;AAClH;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

@@ -12,5 +12,21 @@ interface ReviewSourceLocatorOptions {
     attributePrefix?: string;
 }
 declare const reviewSourceLocator: (options?: ReviewSourceLocatorOptions) => Plugin;
+interface ReviewDataLocatorOptions {
+    enabled?: boolean;
+    root?: string;
+    include?: readonly SourceLocatorPattern[];
+    exclude?: readonly SourceLocatorPattern[];
+    filePath?: 'relative' | 'absolute';
+    /** 매칭할 component 이름 패턴. 기본은 `Section`으로 시작하는 이름. */
+    componentPattern?: RegExp;
+    fileAttribute?: string;
+    lineAttribute?: string;
+}
+/**
+ * page data 파일의 section 객체(`component: 'SectionXxx'`)에 출처 파일/라인을
+ * `__wrkDataFile`/`__wrkDataLine` prop 으로 주입한다. 라인 보존을 위해 같은 줄에만 삽입한다.
+ */
+declare const reviewDataLocator: (options?: ReviewDataLocatorOptions) => Plugin;
 
-export { type ReviewSourceLocatorOptions, reviewSourceLocator };
+export { type ReviewDataLocatorOptions, type ReviewSourceLocatorOptions, reviewDataLocator, reviewSourceLocator };

package/dist/vite.d.ts

@@ -12,5 +12,21 @@ interface ReviewSourceLocatorOptions {
     attributePrefix?: string;
 }
 declare const reviewSourceLocator: (options?: ReviewSourceLocatorOptions) => Plugin;
+interface ReviewDataLocatorOptions {
+    enabled?: boolean;
+    root?: string;
+    include?: readonly SourceLocatorPattern[];
+    exclude?: readonly SourceLocatorPattern[];
+    filePath?: 'relative' | 'absolute';
+    /** 매칭할 component 이름 패턴. 기본은 `Section`으로 시작하는 이름. */
+    componentPattern?: RegExp;
+    fileAttribute?: string;
+    lineAttribute?: string;
+}
+/**
+ * page data 파일의 section 객체(`component: 'SectionXxx'`)에 출처 파일/라인을
+ * `__wrkDataFile`/`__wrkDataLine` prop 으로 주입한다. 라인 보존을 위해 같은 줄에만 삽입한다.
+ */
+declare const reviewDataLocator: (options?: ReviewDataLocatorOptions) => Plugin;
 
-export { type ReviewSourceLocatorOptions, reviewSourceLocator };
+export { type ReviewDataLocatorOptions, type ReviewSourceLocatorOptions, reviewDataLocator, reviewSourceLocator };

package/dist/vite.js

@@ -20,6 +20,54 @@ var reviewSourceLocator = (options = {}) => {
     }
   };
 };
+var reviewDataLocator = (options = {}) => {
+  let root = normalizePath(options.root ?? "");
+  let enabled = options.enabled ?? false;
+  const include = (options.include ?? []).map(createRuntimeMatcher);
+  const exclude = (options.exclude ?? ["node_modules", "dist"]).map(
+    createRuntimeMatcher
+  );
+  const componentPattern = options.componentPattern ?? /Section[A-Za-z0-9_]*/;
+  const fileKey = options.fileAttribute ?? "__wrkDataFile";
+  const lineKey = options.lineAttribute ?? "__wrkDataLine";
+  const componentSource = `(^|[\\n,{(\\[]\\s*)(component:\\s*)(['"\`])(${componentPattern.source})\\3`;
+  return {
+    name: "df-web-review-kit-data-locator",
+    enforce: "pre",
+    configResolved(config) {
+      root = normalizePath(options.root ?? config.root ?? "");
+      enabled = options.enabled ?? config.command === "serve";
+    },
+    transform(code, id) {
+      if (!enabled) return null;
+      const file = normalizePath(id.split("?")[0]);
+      const relativeFile = root && file.startsWith(root + "/") ? file.slice(root.length + 1) : file;
+      if (include.length > 0 && !include.some((m) => matchesPath(m, file, relativeFile)))
+        return null;
+      if (exclude.some((m) => matchesPath(m, file, relativeFile))) return null;
+      const sourceFile = (options.filePath ?? "relative") === "absolute" ? file : relativeFile;
+      const regex = new RegExp(componentSource, "g");
+      let changed = false;
+      const out = code.replace(
+        regex,
+        (_match, pre, comp, quote, name, offset) => {
+          const line = code.slice(0, offset + pre.length).split("\n").length;
+          changed = true;
+          return `${pre}${JSON.stringify(fileKey)}: ${JSON.stringify(sourceFile)}, ${JSON.stringify(lineKey)}: ${line}, ${comp}${quote}${name}${quote}`;
+        }
+      );
+      return changed ? { code: out, map: null } : null;
+    }
+  };
+};
+function matchesPath(matcher, absoluteFile, relativeFile) {
+  if (matcher.type === "regex") {
+    const regex = new RegExp(matcher.value, matcher.flags);
+    return regex.test(absoluteFile) || regex.test(relativeFile);
+  }
+  const target = matcher.value.startsWith("/") ? absoluteFile : relativeFile;
+  return target === matcher.value || target.startsWith(matcher.value + "/") || target.includes("/" + matcher.value);
+}
 function createRuntimeOptions(options, config) {
   const attributePrefix = (options.attributePrefix ?? "data-wrk-source").replace(
     /-+$/,
@@ -156,6 +204,7 @@ function normalizePath(value) {
 `;
 }
 export {
+  reviewDataLocator,
   reviewSourceLocator
 };
 //# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -1 +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":[]}
+{"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\nexport interface ReviewDataLocatorOptions {\n  enabled?: boolean;\n  root?: string;\n  include?: readonly SourceLocatorPattern[];\n  exclude?: readonly SourceLocatorPattern[];\n  filePath?: 'relative' | 'absolute';\n  /** 매칭할 component 이름 패턴. 기본은 `Section`으로 시작하는 이름. */\n  componentPattern?: RegExp;\n  fileAttribute?: string;\n  lineAttribute?: string;\n}\n\n/**\n * page data 파일의 section 객체(`component: 'SectionXxx'`)에 출처 파일/라인을\n * `__wrkDataFile`/`__wrkDataLine` prop 으로 주입한다. 라인 보존을 위해 같은 줄에만 삽입한다.\n */\nexport const reviewDataLocator = (\n  options: ReviewDataLocatorOptions = {}\n): Plugin => {\n  let root = normalizePath(options.root ?? '');\n  let enabled = options.enabled ?? false;\n  const include = (options.include ?? []).map(createRuntimeMatcher);\n  const exclude = (options.exclude ?? ['node_modules', 'dist']).map(\n    createRuntimeMatcher\n  );\n  const componentPattern = options.componentPattern ?? /Section[A-Za-z0-9_]*/;\n  const fileKey = options.fileAttribute ?? '__wrkDataFile';\n  const lineKey = options.lineAttribute ?? '__wrkDataLine';\n\n  const componentSource = `(^|[\\\\n,{(\\\\[]\\\\s*)(component:\\\\s*)(['\"\\`])(${componentPattern.source})\\\\3`;\n\n  return {\n    name: 'df-web-review-kit-data-locator',\n    enforce: 'pre',\n    configResolved(config) {\n      root = normalizePath(options.root ?? config.root ?? '');\n      enabled = options.enabled ?? config.command === 'serve';\n    },\n    transform(code, id) {\n      if (!enabled) return null;\n      const file = normalizePath(id.split('?')[0]);\n      const relativeFile =\n        root && file.startsWith(root + '/') ? file.slice(root.length + 1) : file;\n      if (include.length > 0 && !include.some((m) => matchesPath(m, file, relativeFile)))\n        return null;\n      if (exclude.some((m) => matchesPath(m, file, relativeFile))) return null;\n\n      const sourceFile = (options.filePath ?? 'relative') === 'absolute' ? file : relativeFile;\n      const regex = new RegExp(componentSource, 'g');\n      let changed = false;\n      const out = code.replace(\n        regex,\n        (_match, pre: string, comp: string, quote: string, name: string, offset: number) => {\n          const line = code.slice(0, offset + pre.length).split('\\n').length;\n          changed = true;\n          return `${pre}${JSON.stringify(fileKey)}: ${JSON.stringify(sourceFile)}, ${JSON.stringify(lineKey)}: ${line}, ${comp}${quote}${name}${quote}`;\n        }\n      );\n\n      return changed ? { code: out, map: null } : null;\n    },\n  };\n};\n\nfunction matchesPath(\n  matcher: RuntimeMatcher,\n  absoluteFile: string,\n  relativeFile: string\n) {\n  if (matcher.type === 'regex') {\n    const regex = new RegExp(matcher.value, matcher.flags);\n    return regex.test(absoluteFile) || regex.test(relativeFile);\n  }\n  const target = matcher.value.startsWith('/') ? absoluteFile : relativeFile;\n  return target === matcher.value || target.startsWith(matcher.value + '/') || target.includes('/' + matcher.value);\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;AAkBO,IAAM,oBAAoB,CAC/B,UAAoC,CAAC,MAC1B;AACX,MAAI,OAAO,cAAc,QAAQ,QAAQ,EAAE;AAC3C,MAAI,UAAU,QAAQ,WAAW;AACjC,QAAM,WAAW,QAAQ,WAAW,CAAC,GAAG,IAAI,oBAAoB;AAChE,QAAM,WAAW,QAAQ,WAAW,CAAC,gBAAgB,MAAM,GAAG;AAAA,IAC5D;AAAA,EACF;AACA,QAAM,mBAAmB,QAAQ,oBAAoB;AACrD,QAAM,UAAU,QAAQ,iBAAiB;AACzC,QAAM,UAAU,QAAQ,iBAAiB;AAEzC,QAAM,kBAAkB,+CAA+C,iBAAiB,MAAM;AAE9F,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,eAAe,QAAQ;AACrB,aAAO,cAAc,QAAQ,QAAQ,OAAO,QAAQ,EAAE;AACtD,gBAAU,QAAQ,WAAW,OAAO,YAAY;AAAA,IAClD;AAAA,IACA,UAAU,MAAM,IAAI;AAClB,UAAI,CAAC,QAAS,QAAO;AACrB,YAAM,OAAO,cAAc,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC;AAC3C,YAAM,eACJ,QAAQ,KAAK,WAAW,OAAO,GAAG,IAAI,KAAK,MAAM,KAAK,SAAS,CAAC,IAAI;AACtE,UAAI,QAAQ,SAAS,KAAK,CAAC,QAAQ,KAAK,CAAC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC;AAC/E,eAAO;AACT,UAAI,QAAQ,KAAK,CAAC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,EAAG,QAAO;AAEpE,YAAM,cAAc,QAAQ,YAAY,gBAAgB,aAAa,OAAO;AAC5E,YAAM,QAAQ,IAAI,OAAO,iBAAiB,GAAG;AAC7C,UAAI,UAAU;AACd,YAAM,MAAM,KAAK;AAAA,QACf;AAAA,QACA,CAAC,QAAQ,KAAa,MAAc,OAAe,MAAc,WAAmB;AAClF,gBAAM,OAAO,KAAK,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,MAAM,IAAI,EAAE;AAC5D,oBAAU;AACV,iBAAO,GAAG,GAAG,GAAG,KAAK,UAAU,OAAO,CAAC,KAAK,KAAK,UAAU,UAAU,CAAC,KAAK,KAAK,UAAU,OAAO,CAAC,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK;AAAA,QAC7I;AAAA,MACF;AAEA,aAAO,UAAU,EAAE,MAAM,KAAK,KAAK,KAAK,IAAI;AAAA,IAC9C;AAAA,EACF;AACF;AAEA,SAAS,YACP,SACA,cACA,cACA;AACA,MAAI,QAAQ,SAAS,SAAS;AAC5B,UAAM,QAAQ,IAAI,OAAO,QAAQ,OAAO,QAAQ,KAAK;AACrD,WAAO,MAAM,KAAK,YAAY,KAAK,MAAM,KAAK,YAAY;AAAA,EAC5D;AACA,QAAM,SAAS,QAAQ,MAAM,WAAW,GAAG,IAAI,eAAe;AAC9D,SAAO,WAAW,QAAQ,SAAS,OAAO,WAAW,QAAQ,QAAQ,GAAG,KAAK,OAAO,SAAS,MAAM,QAAQ,KAAK;AAClH;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

@@ -10,6 +10,7 @@ Public docs are intentionally small. Keep implementation history, handoff notes,
 4. [Architecture and runtime logic](architecture.md)
 5. [Figma overlay](figma-overlay.md)
 6. [Grid overlay](grid-overlay.md)
+7. [Release notes 0.6.0](release-notes-0.6.0.md)
 
 ## Document Roles
 
@@ -19,6 +20,7 @@ Public docs are intentionally small. Keep implementation history, handoff notes,
 - `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.
+- `release-notes-0.6.0.md`: latest release changes, host notes, and validation scope.
 
 ## Boundary
 

package/docs/architecture.md

@@ -35,6 +35,8 @@ createWebReviewKit({
 
 `ui.panel: false` means the React shell owns the side panel and toolbar. Core still owns target overlays such as note pins, area selection boxes, DOM hover outlines, saved item markers, and highlights.
 
+When the React shell provides a composer host, core docks DOM/area draft composer UI into the QA panel instead of rendering it as a floating target overlay. Core still owns draft creation, anchor capture, geometry, and adapter submission; React shell only provides the stable panel host.
+
 ## Core Modules
 
 - `web.review.kit.app.ts`: controller lifecycle, state transitions, adapter calls, item creation, restore flow.
@@ -95,6 +97,8 @@ The default local adapter is for draft/local review work. Supabase is optional h
 - ruler UI
 - presence UI
 - host overlay toggles such as grid and Figma
+- Source Tree UI, metadata toggles, and browser-local UI state persistence
+- QA panel composer host for shell-owned layout
 
 React shell should call the core controller instead of duplicating target overlay logic.
 

package/docs/installation.md

@@ -195,7 +195,10 @@ Host projects can opt into source file hints for local QA. The Vite plugin wraps
 
 ```ts
 import { defineConfig } from 'vite';
-import { reviewSourceLocator } from '@designfever/web-review-kit/vite';
+import {
+  reviewDataLocator,
+  reviewSourceLocator,
+} from '@designfever/web-review-kit/vite';
 
 export default defineConfig({
   plugins: [
@@ -204,11 +207,18 @@ export default defineConfig({
       include: ['src'],
       filePath: 'absolute',
     }),
+    reviewDataLocator({
+      enabled: true,
+      include: ['src/data'],
+      filePath: 'absolute',
+    }),
   ],
 });
 ```
 
-Captured DOM nodes will include `data-wrk-source-file`, `data-wrk-source-line`, and `data-wrk-source-column`. In the review shell, hold `Option` over the target iframe to show source candidates from the DOM ancestry. Click the target to pin the candidate list, then choose which file to open. If the file path is absolute, it opens directly. If the plugin stores relative paths, pass `sourceRoot` when mounting the shell.
+Captured DOM nodes will include `data-wrk-source-file`, `data-wrk-source-line`, and `data-wrk-source-column`. Data locator also injects `__wrkDataFile` and `__wrkDataLine` props into page data section objects so the shell can expose matching `data-wrk-data-*` hints when host components forward those props to section wrappers.
+
+In the review shell, hold `Option` over the target iframe to show source candidates from the DOM ancestry. Click the target to pin the candidate list, then choose which file to open. The side rail Source Tree panel lists section/source/data candidates and can scroll to a section or open its source/data file. It can also show live box metrics, text/font metadata, media URLs, and class tags for each node. If the file path is absolute, it opens directly. If the plugin stores relative paths, pass `sourceRoot` when mounting the shell.
 
 ```tsx
 mountReviewShell({
@@ -219,15 +229,23 @@ mountReviewShell({
   sourceRoot: import.meta.env.VITE_REVIEW_SOURCE_ROOT,
   sourceInspector: {
     editor: 'vscode', // 'vscode' | 'cursor' | 'webstorm' | 'custom'
+    maxDepth: 9,
+    hoverOutline: true,
+    includePlacer: false,
+    ignore: ['core.section', 'control.render'],
     // urlTemplate: 'my-editor://open?file={encodedPath}&line={line}&column={column}',
   },
 });
 ```
 
-Set `sourceInspector.enabled` to `false` when source code opening should be unavailable. The `data-font` overlay still belongs to the target project markup and is not required for source opening.
+Set `sourceInspector.enabled` to `false` when source code opening should be unavailable. Use `sourceInspector.ignore` to hide infrastructure files from source candidates and the Source Tree. Use `sourceInspector.maxDepth` to cap Source Tree traversal depth. Set `sourceInspector.hoverOutline` to `false` to disable iframe target outlines while hovering Source Tree items. Set `sourceInspector.includePlacer` to `true` when primitive Placer nodes should appear in Source Tree. The `data-font` overlay still belongs to the target project markup and is not required for source opening.
 
 Use this only in dev/review builds. Source paths are written into the browser DOM and can be persisted with QA items.
 
+Source Tree filter/options, side panel state, and QA status filter are browser-local UI preferences. They are stored in localStorage and are not sent through the adapter.
+
+In React shell mode, DOM/area draft composers dock into the QA panel when the shell provides a composer host. This keeps mobile Safari keyboard/viewport resize from moving a floating composer layer over the target frame.
+
 ## Custom Adapter
 
 If a team or host project owns its own QA backend, keep that adapter in the host project or in a separate package. Start from [adaptor.sample.ts](adaptor.sample.ts) and map its `WebReviewKitAdapter` methods to your backend API.

package/docs/release-notes-0.5.0.md

@@ -0,0 +1,134 @@
+# 릴리즈 노트: 0.5.0
+
+0.4.1 release 이후 변경 사항 정리.
+
+비교 기준: `a80ca35` (`release: 0.4.1`)
+검토 기준: 0.5.0 dogfood working tree (`Source Tree`, QA UI polish, Lexus host integration 포함)
+
+## 주요 변경
+
+- Review shell side rail에 Source Tree panel을 추가했다.
+- Source inspector 후보에서 infrastructure file을 숨길 수 있게 했다.
+- Source Tree 탐색 깊이를 `sourceInspector.maxDepth`로 제한할 수 있게 했다.
+- Vite dev plugin에 page data 출처를 주입하는 `reviewDataLocator()`를 추가했다.
+- Source candidate가 page data file hint를 함께 노출하도록 확장했다.
+- QA status filter가 iframe overlay 표시에도 반영되도록 했다.
+- 모바일 comment textarea focus 시 viewport zoom으로 popup 위치가 틀어지는 현상을 줄였다.
+- Lexus dogfood 기준 init, review route, Vite locator 설정을 0.5.0 host integration 기준으로 정리했다.
+
+## 추가
+
+### Source Tree Panel
+
+QA side rail에 `SOURCE` panel을 추가했다. Source inspector가 활성화된 상태에서 target iframe의 section/source 구조를 tree로 볼 수 있다.
+
+- section/source 후보 tree 표시
+- filter input으로 label, source file, data file 검색
+- section row 클릭 시 target section으로 scroll
+- source file open action
+- data file open action
+- DOM QA 작성 action
+- collapsible tree row
+
+Tree root는 source hint가 있는 section wrapper와 header/footer landmark를 기준으로 잡는다. Placer 계열 primitive는 tree noise를 줄이기 위해 기본 제외하고, 필요하면 `sourceInspector.includePlacer`로 표시할 수 있다.
+
+기본 펼침 정책은 Source Tree가 너무 길어지는 것을 막기 위해 2depth까지만 열고, 그 아래 subtree는 접는다. `FrameHeader`, `FrameFooter`는 root(1depth)여도 기본 접힘 상태로 시작한다.
+
+### Source Inspector 옵션
+
+`sourceInspector` mount option을 확장했다.
+
+- `sourceInspector.maxDepth`: Source Tree traversal depth 제한
+- `sourceInspector.ignore`: source candidate와 Source Tree에서 숨길 file pattern
+- `sourceInspector.hoverOutline`: Source Tree item hover 시 iframe target outline 표시 여부
+- `sourceInspector.includePlacer`: Source Tree에서 Placer primitive node 표시 여부
+
+문자열 pattern은 normalized path 부분 일치로 처리하고, `RegExp` pattern도 지원한다. Ignore 결과로 후보가 모두 사라지면 빈 list 대신 원본 후보를 보여준다.
+
+동일 source file 비교는 absolute/relative/suffix 경로를 정규화해서 같은 파일이 root와 child에 중복 표시되지 않게 했다. 단, 같은 이름의 sibling node는 branch-local 기준으로 유지해서 실제 sibling 구조가 사라지지 않게 했다.
+
+### Data Locator
+
+`@designfever/web-review-kit/vite`에 `reviewDataLocator()`를 추가했다. Page data 파일의 section object에서 `component: 'SectionXxx'` 패턴을 찾아 data file/line hint prop을 주입한다.
+
+기본 주입 prop:
+
+- `__wrkDataFile`
+- `__wrkDataLine`
+
+Host component가 이 prop을 section wrapper의 `data-wrk-data-file`, `data-wrk-data-line`으로 넘기면 Source Tree에서 data file open action을 사용할 수 있다.
+
+## 변경
+
+### Source Candidate 수집
+
+Source 후보 수집이 DOM source hint와 data hint를 함께 본다.
+
+- 클릭 지점에서 부모로 올라가며 source hint 수집
+- 같은 source file은 클릭 지점에 가까운 후보 1개만 유지
+- data hint는 별도 후보로 추가
+- `sourceInspector.ignore` 적용
+
+Option source candidate popup은 후보 row 사이 divider를 추가하고, row 높이를 고정값이 아니라 content 기반 padding/line-height로 정리했다. 위치가 없는 후보는 `file only` 대신 `-:-`로 표시해 `line:column` 양식과 맞췄다.
+
+### Source Open 표시
+
+`pages/` 경로도 display path 축약 규칙에 포함했다. 기존 `page/`, `app/`, `components/`, `src/` 계열 규칙은 유지한다.
+
+### Review Shell UI
+
+- side rail을 아이콘 중심 UI로 바꾸고 active 상태는 우측 line indicator로 표시한다.
+- Source Tree/QA 아이콘 weight와 전체 font weight를 낮춰 panel 밀도를 줄였다.
+- Source Tree filter clear button의 클릭 영역과 색상을 정리했다.
+- Source Tree 1depth item 사이 divider를 추가했다.
+- Source Tree hover 시 iframe target outline을 표시하고, row action에서 DOM QA 작성을 시작할 수 있게 했다.
+- Source Tree row click scroll은 smooth behavior를 제거하고 target element가 iframe center 쪽에 오도록 조정했다.
+- QA header와 Source Tree header/filter 높이를 34px control 기준으로 맞췄다.
+- 좁은 viewport에서는 해상도 선택을 dropdown으로, overlay tool group을 `...` menu로 줄여 2줄 layout을 유지한다.
+- 설정 modal에 Dark / Light / System theme icon option을 추가했다.
+- 사용자 presence는 side rail 하단 icon badge로 표시하고, 클릭 시 사용자 이름 list를 세로로 보여준다.
+
+### QA Filter / Overlay
+
+QA list의 status filter(`Todo`, `Doing`, `Done` 등)를 선택하면 해당 status item만 iframe overlay에 표시되도록 했다.
+
+### Mobile 입력
+
+모바일 Safari에서 comment textarea focus 시 16px 미만 input zoom이 popup layer 위치를 흔드는 문제를 줄이기 위해 coarse pointer 환경의 textarea/select font-size를 16px로 보정했다.
+
+## Host 적용 메모
+
+### Lexus dogfood integration
+
+`lexus_official_v2026` dogfood 적용 기준으로 아래 host 설정을 확인했다.
+
+- `vite.config.js`에서 `reviewSourceLocator()`와 `reviewDataLocator()`를 dev 전용으로 함께 사용한다.
+- `reviewSourceLocator({ include: ['src', 'page'], filePath: 'absolute' })`로 component/source hint를 주입한다.
+- `reviewDataLocator({ include: ['page', 'src/data'], filePath: 'absolute' })`로 page data object의 file/line hint를 주입한다.
+- Vite `define.__DFWR_SOURCE_ROOT__`로 review shell이 상대 source path를 editor open용 project root와 매칭할 수 있게 한다.
+- review route init(`page/review/index.tsx`)에서 `sourceRoot`, `sourceInspector.maxDepth`, `sourceInspector.includePlacer`, `sourceInspector.ignore`를 host별로 설정한다.
+- app-level dev init(`src/helper/helper.review-kit.ts`)은 `import.meta.env.DEV`에서만 동작하고, `__dfwr_target` query가 있으면 중복 mount를 피한다.
+- host section base interface는 `__wrkDataFile`, `__wrkDataLine` dev hint prop을 허용해야 `reviewDataLocator()` 주입값을 section wrapper까지 전달할 수 있다.
+- dogfood 중에는 `@designfever/web-review-kit`을 `file:../df-web-review-kit`로 연결해 0.5.0 dist를 Lexus review page에서 직접 검증했다.
+
+## 문서
+
+- README에 `reviewDataLocator()`와 Source Tree 설명을 추가했다.
+- Installation docs에 data locator, Source Tree, `ignore`, `maxDepth` 설정을 추가했다.
+
+## 검증
+
+검토한 main branch 기준으로 아래 명령을 확인했다.
+
+- `pnpm typecheck`
+- `pnpm typecheck:dev`
+- `pnpm build`
+- `pnpm build:dev`
+- `git diff --check`
+- `npm pack --dry-run`
+- Lexus dogfood review page에서 Source Tree, Option source popup, QA status filter, side rail, mobile textarea 보정을 수동 확인했다.
+
+## 메모
+
+- `package.json` version은 `0.5.0`이다.
+- npm publish 전에는 registry login 상태를 확인해야 한다.