@designfever/web-review-kit 0.2.0 → 0.3.0

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

@@ -20,6 +20,8 @@ interface DomAnchorCandidate {
 interface DomSourceHint {
     component?: string;
     file?: string;
+    line?: string;
+    column?: string;
     sectionId?: string;
     sectionIndex?: string;
 }

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

@@ -20,6 +20,8 @@ interface DomAnchorCandidate {
 interface DomSourceHint {
     component?: string;
     file?: string;
+    line?: string;
+    column?: string;
     sectionId?: string;
     sectionIndex?: string;
 }

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/installation.md

@@ -170,6 +170,39 @@ mountReviewShell({
 
 See [DB setup](db-setup.md) before enabling Supabase in a shared environment.
 
+## Source Locator
+
+Host projects can opt into source file hints for local QA. The Vite plugin wraps React's dev JSX runtime and writes source attributes to rendered DOM nodes.
+
+```ts
+import { defineConfig } from 'vite';
+import { reviewSourceLocator } from '@designfever/web-review-kit/vite';
+
+export default defineConfig({
+  plugins: [
+    reviewSourceLocator({
+      enabled: true,
+      include: ['src'],
+      filePath: 'absolute',
+    }),
+  ],
+});
+```
+
+Captured DOM nodes will include `data-wrk-source-file`, `data-wrk-source-line`, and `data-wrk-source-column`. In the review shell, `Option` + click inside the target iframe opens that source in VS Code. If the file path is absolute, it opens directly. If the plugin stores relative paths, pass `sourceRoot` when mounting the shell.
+
+```tsx
+mountReviewShell({
+  projectId: REVIEW_PROJECT_ID,
+  pages,
+  adapters,
+  reviewPathPrefix: REVIEW_PATH_PREFIX,
+  sourceRoot: import.meta.env.VITE_REVIEW_SOURCE_ROOT,
+});
+```
+
+Use this only in dev/review builds. Source paths are written into the browser DOM and can be persisted with QA items.
+
 ## 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@designfever/web-review-kit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Designfever web page review overlay toolkit.",
   "license": "UNLICENSED",
@@ -31,6 +31,11 @@
       "import": "./dist/react-shell.js",
       "require": "./dist/react-shell.cjs"
     },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js",
+      "require": "./dist/vite.cjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -39,8 +44,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/react-shell.tsx --format esm,cjs --dts --sourcemap --clean --external react --external react-dom --external react/jsx-runtime",
-    "dev": "tsup src/index.ts src/react-shell.tsx --format esm,cjs --dts --sourcemap --watch --external react --external react-dom --external react/jsx-runtime",
+    "build": "tsup src/index.ts src/react-shell.tsx src/vite.ts --format esm,cjs --dts --sourcemap --clean --external react --external react-dom --external react/jsx-runtime",
+    "dev": "tsup src/index.ts src/react-shell.tsx src/vite.ts --format esm,cjs --dts --sourcemap --watch --external react --external react-dom --external react/jsx-runtime",
     "dev:review": "vite --config dev/vite.config.ts",
     "build:dev": "vite build --config dev/vite.config.ts",
     "prepare": "pnpm build",
@@ -49,7 +54,13 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "react-dom": ">=18"
+    "react-dom": ">=18",
+    "vite": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@supabase/supabase-js": "^2.108.2",