photosuite 0.3.0 → 0.4.0

package/README.md

@@ -130,6 +130,39 @@ photosuite({
 })
 ```
 
+**Per-Page Filtering:**
+
+`scope` is a CSS selector that only governs *client-side* behavior (lightbox, captions, grid). The EXIF rehype plugin runs at build time on **every** Markdown file's `<img>` tags and rewrites their DOM into `.photosuite-item` + `.photosuite-exif`. If you have non-article pages (e.g. `about.md`) outside the `scope` container, you'll still see the injected EXIF markup in the HTML.
+
+To restrict EXIF injection to specific pages, use either of:
+
+**Option 1 Glob patterns in config**:
+
+```javascript
+photosuite({
+  scope: '#article',
+  exif: {
+    // Only process matched files; omit to process all
+    include: ['src/content/posts/**/*.md'],
+    // Skip matched files; takes precedence over include
+    exclude: ['src/content/pages/**/*.md'],
+  },
+})
+```
+
+Patterns are matched against paths relative to the project root, normalized with `/` separators. Supported wildcards: `*` (within a segment), `**` (across segments), `?` (single character).
+
+**Option 2 Frontmatter opt-out**:
+
+```yaml
+---
+title: About
+exif: false        # or: photosuite: false
+---
+```
+
+Pages with `exif: false`, `photosuite: false`, or `photosuite.exif: false` in frontmatter are skipped regardless of `include`/`exclude`.
+
 ### 3. Image Grid
 
 Photosuite supports automatically combining consecutive images into a grid layout. When 2-3 images are placed adjacently in Markdown, they will be automatically combined into a grid, and each image remains independently clickable.
@@ -254,7 +287,10 @@ photosuite({
       'ISO',              // ISO
       'DateTimeOriginal'  // Date Original
     ],
-    separator: ' · '      // Separator
+    separator: ' · ',     // Separator
+    // Per-page filtering (since v0.3.1)
+    include: undefined,   // string[] of glob patterns; omit to process all pages
+    exclude: undefined,   // string[] of glob patterns; takes precedence over include
   },
 
   // Fancybox native options
@@ -282,6 +318,9 @@ photosuite({
 
 ## FAQ
 
+**Q: My non-article pages (e.g. about page) still show EXIF info even though they're outside the `scope` container.**
+A: `scope` only controls *client-side* behavior. The EXIF rehype plugin runs at build time on every Markdown file. Restrict it via `exif.include` / `exif.exclude` glob patterns, or add `exif: false` to a page's frontmatter. See [EXIF Data Display § Per-Page Filtering](#2-exif-data-display).
+
 **Q: Why isn't EXIF data showing?**
 A: Please check the following:
 1. Does the image contain EXIF data? (Some compression tools strip EXIF)

package/README.zh-CN.md

@@ -131,6 +131,39 @@ photosuite({
 })
 ```
 
+**按页面过滤：**
+
+`scope` 是一个 CSS 选择器，只控制**客户端**行为（灯箱、标题、拼图）。EXIF rehype 插件在**构建时**对**所有** Markdown 中的 `<img>` 进行处理，将其改写为 `.photosuite-item` + `.photosuite-exif` 的 DOM 结构。如果你有非文章页（如 `about.md`）不在 `scope` 容器内，构建产物的 HTML 中仍然会出现 EXIF 注入的标签。
+
+要限定 EXIF 注入只作用于特定页面，可任选其一：
+
+**方式一 配置 glob 模式**：
+
+```javascript
+photosuite({
+  scope: '#article',
+  exif: {
+    // 仅处理匹配的文件；未配置时处理所有 Markdown
+    include: ['src/content/posts/**/*.md'],
+    // 跳过匹配的文件；优先级高于 include
+    exclude: ['src/content/pages/**/*.md'],
+  },
+})
+```
+
+模式相对于项目根目录解析，分隔符自动归一化为 `/`。支持通配符：`*`（段内任意字符）、`**`（跨段匹配）、`?`（单字符）。
+
+**方式二 Frontmatter 单页 opt-out**：
+
+```yaml
+---
+title: 关于
+exif: false        # 或：photosuite: false
+---
+```
+
+页面 frontmatter 含 `exif: false`、`photosuite: false` 或 `photosuite.exif: false` 时直接跳过，优先级高于 `include` / `exclude`。
+
 ### 2. 图片拼图
 
 Photosuite 支持自动将连续的图片组合成拼图布局。当 Markdown 中有 2-3 张图片紧挨着时，它们会自动组合成拼图，且每张图片都独立可点击。
@@ -259,7 +292,10 @@ photosuite({
       'ISO',              // 感光度
       'DateTimeOriginal'  // 拍摄时间
     ],
-    separator: ' · '      // 分隔符
+    separator: ' · ',     // 分隔符
+    // 按页面过滤（v0.3.1 起支持）
+    include: undefined,   // string[] glob 模式；未配置时处理所有页面
+    exclude: undefined,   // string[] glob 模式；优先级高于 include
   },
 
   // Fancybox 原生配置传递
@@ -287,13 +323,16 @@ photosuite({
 
 ## 常见问题
 
-**1.为什么 EXIF 信息没有显示？**
+**1.我的非文章页（如关于页）虽然不在 `scope` 容器内，为什么仍然带有 EXIF 信息？**
+A: `scope` 仅控制**客户端**行为。EXIF rehype 插件在**构建时**对所有 Markdown 生效。可使用 `exif.include` / `exif.exclude` glob 模式过滤，或在页面 frontmatter 中添加 `exif: false`。详见 [EXIF 信息展示 § 按页面过滤](#2-exif-信息展示)。
+
+**2.为什么 EXIF 信息没有显示？**
 A: 请检查以下几点：
 
 1. 图片是否包含 EXIF 信息（某些压缩工具会去除 EXIF）
 2. EXIF 信息至少有曝光三要素（焦距、光圈、快门速度）时，才会显示
 
-**2.我想只在某些图片上使用 Photosuite，怎么办？**
+**3.我想只在某些图片上使用 Photosuite，怎么办？**
 A: 您可以通过 CSS 选择器精确控制范围（多个选择器用逗号分隔）例如，只在类名为 `'#main` 的元素内部生效：
 
 ```javascript
@@ -303,6 +342,8 @@ photosuite({
 })
 ```
 
+注意：`scope` 只影响客户端行为；若希望服务端 EXIF 注入也只对特定页面生效，请使用 `exif.include` / `exif.exclude` 或 frontmatter opt-out（见上）。
+
 ## 贡献者们
 
 一行代码，一个插件，对于独立博客而言，微不足道，如同尘埃。

package/dist/photosuite.integration.cjs

@@ -1,7 +1,7 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`exiftool-vendored`),l=require(`node:fs`);l=s(l);let u=require(`node:fs/promises`);u=s(u);let d=require(`node:path`);d=s(d);let f=require(`node:http`);f=s(f);let p=require(`node:https`);p=s(p);let m=require(`node:os`);m=s(m);let h=require(`node:url`);var g=(...e)=>{let t=e.filter(e=>typeof e==`string`&&e!==``);if(t.length===0)return``;if(t.length===1)return t[0];let n=t[0],r=t[1],i=`${n.endsWith(`/`)?n.slice(0,-1):n}/${r.startsWith(`/`)?r.slice(1):r}`;return t.length>2?g(i,...t.slice(2)):i},_=e=>!(!e||/^https?:\/\//i.test(e)||e.startsWith(`/`)||e.startsWith(`./`)||e.startsWith(`../`));function v(e={}){let{imageBase:t,imageDir:n=`imageDir`,fileDir:r=!1}=e;return(e,i)=>{let a=(i?.data?.astro?.frontmatter||i?.data?.frontmatter||{})[n]||``,o=(i?.path||i?.history?.[0]||``).split(/[\\/]/).pop()?.split(`.`).shift()||``,s=r?o:a,c=e=>{if(e){if(e.type===`image`){let n=e.url||``;(t||s)&&_(n)&&(e.url=g(t,s,n))}e.children&&e.children.length&&e.children.forEach(c)}};c(e)}}var y=[`Model`,`LensModel`,`FocalLength`,`FNumber`,`ExposureTime`,`ISO`,`DateTimeOriginal`];function b(e){let t=typeof e.exif==`object`&&e.exif!==null?e.exif:{};return{cache:t.cache!==!1,concurrency:typeof t.concurrency==`number`&&t.concurrency>0?t.concurrency:6,timeout:typeof t.timeout==`number`&&t.timeout>0?t.timeout:15e3,headerBytes:typeof t.headerBytes==`number`&&t.headerBytes>=0?t.headerBytes:131072,fields:Array.isArray(t.fields)&&t.fields.length>0?t.fields:y,separator:typeof t.separator==`string`?t.separator:` · `}}var x=class{available;waiters=[];constructor(e){this.available=Math.max(1,e)}async acquire(){this.available>0?this.available--:await new Promise(e=>this.waiters.push(e));let e=!1;return()=>{e||(e=!0,this.release())}}release(){let e=this.waiters.shift();e?e():this.available++}},S=null;function C(e){return S||=new x(e),S}var w=1,T=null,E=!1,D=Promise.resolve();function O(){return d.join(process.cwd(),`node_modules`,`.cache`,`photosuite`,`exif-cache.json`)}function k(){return T||=(async()=>{try{let e=await u.readFile(O(),`utf-8`),t=JSON.parse(e);if(t&&t.version===w&&t.entries&&typeof t.entries==`object`)return t}catch{}return{version:w,entries:{}}})(),T}async function A(){if(!E||!T)return;let e=await T;E=!1,D=D.then(async()=>{let t=O(),n=d.dirname(t);await u.mkdir(n,{recursive:!0});let r=d.join(n,`.exif-cache.${process.pid}.${Date.now()}.tmp`);await u.writeFile(r,JSON.stringify(e),`utf-8`),await u.rename(r,t)}).catch(()=>{}),await D}function j(e){try{let t=new h.URL(e);return t.protocol===`http:`||t.protocol===`https:`}catch{return!1}}function M(e,t,n){return new Promise((r,i)=>{let a=e.startsWith(`https:`)?p:f,o={};t.headerBytes>0&&(o.Range=`bytes=0-${t.headerBytes-1}`);let s=a.get(e,{headers:o},a=>{let o=a.statusCode||0;if(o>=300&&o<400&&a.headers.location){if(a.resume(),n>=5){i(Error(`Too many redirects`));return}M(new h.URL(a.headers.location,e).toString(),t,n+1).then(r,i);return}if(o!==200&&o!==206){a.resume(),i(Error(`HTTP `+o));return}let s=m.tmpdir(),c=`.bin`;try{c=d.extname(new h.URL(e).pathname)||`.bin`}catch{}let f=d.join(s,`exif-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}${c}`),p=l.createWriteStream(f);a.pipe(p),p.on(`finish`,()=>{r({path:f,cleanup:async()=>{try{await u.unlink(f)}catch{}}})}),p.on(`error`,e=>{try{l.unlinkSync(f)}catch{}i(e)})});s.setTimeout(t.timeout,()=>{s.destroy(Object.assign(Error(`timeout`),{code:`ETIMEDOUT`}))}),s.on(`error`,i)})}async function N(e,t){try{return await M(e,t,0)}catch(n){let r=n&&n.code;if(r===`ECONNRESET`||r===`ETIMEDOUT`||r===`ECONNREFUSED`)return await M(e,t,0);throw n}}async function P(e){let t=await c.exiftool.read(e);return{SourceFile:t.SourceFile,ExifToolVersion:t.ExifToolVersion,MIMEType:t.MIMEType,FileType:t.FileType,Make:t.Make,Model:t.Model,LensModel:t.LensModel,DateTimeOriginal:t.DateTimeOriginal,CreateDate:t.CreateDate,ModifyDate:t.ModifyDate,ImageWidth:t.ImageWidth,ImageHeight:t.ImageHeight,GPSLatitude:t.GPSLatitude,GPSLongitude:t.GPSLongitude,FNumber:t.FNumber,ExposureTime:t.ExposureTime,ISO:t.ISO,FocalLength:t.FocalLength,warnings:t.warnings||[],errors:t.errors||[]}}function F(e,t){if(t==null)return``;switch(e){case`FNumber`:return`ƒ/${Number(t).toFixed(1)}`;case`ExposureTime`:return typeof t==`number`?t>=1?`${t}s`:`1/${Math.round(1/t)}s`:t.toString();case`ISO`:return`ISO ${t}`;case`FocalLength`:let e=t.toString();return e.endsWith(`mm`)?e:`${e}mm`;case`DateTimeOriginal`:return typeof t==`object`&&t.year?`${t.year}/${t.month}/${t.day}`:t.toString();default:return t.toString()}}async function I(e,t,n){let r=``,i;try{if(j(e)){let t=await C(n.concurrency).acquire();try{let t=await N(e,n);r=t.path,i=t.cleanup}finally{t()}}else{if(d.isAbsolute(e))r=e;else{let n=d.dirname(t.path);r=d.resolve(n,e)}if(!l.existsSync(r)){let e=decodeURIComponent(r);if(l.existsSync(e))r=e;else return null}}if(!r||!l.existsSync(r))return null;let a=await P(r);return a.FNumber&&a.ExposureTime&&a.ISO?a:null}finally{i&&await i()}}function L(e,t,n){let r=n.fields.map(e=>{let n=t[e];return n?F(e,n):null}).filter(Boolean);if(r.length===0)return;let i=r.join(n.separator),a={...e.properties};e.tagName=`div`,e.properties={className:[`photosuite-item`]},e.children=[{type:`element`,tagName:`img`,properties:a,children:[]},{type:`element`,tagName:`div`,properties:{className:[`photosuite-exif`]},children:[{type:`text`,value:i}]}]}async function R(e,t,n){let r=e.properties?.src;if(!r)return;let i=j(r),a=n.cache&&i,o;if(a){let e=await k();Object.prototype.hasOwnProperty.call(e.entries,r)&&(o=e.entries[r])}if(o===void 0){try{o=await I(r,t,n)}catch(e){console.warn(`[photosuite] Failed to get EXIF for ${r}:`,e);return}if(a){let e=await k();e.entries[r]=o,E=!0}}o&&L(e,o,n)}function z(e={}){let t=b(e);return async(e,n)=>{let r=[],i=e=>{e.type===`element`&&e.tagName===`img`&&r.push(R(e,n,t)),e.children&&e.children.forEach(i)};i(e),r.length>0&&await Promise.all(r),t.cache&&await A()}}function B(e){return{name:`photosuite`,hooks:{"astro:config:setup":({injectScript:t,updateConfig:n})=>{t(`page`,`
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`exiftool-vendored`),l=require(`node:fs`);l=s(l);let u=require(`node:fs/promises`);u=s(u);let d=require(`node:path`);d=s(d);let f=require(`node:http`);f=s(f);let p=require(`node:https`);p=s(p);let m=require(`node:os`);m=s(m);let h=require(`node:url`);var g=(...e)=>{let t=e.filter(e=>typeof e==`string`&&e!==``);if(t.length===0)return``;if(t.length===1)return t[0];let n=t[0],r=t[1],i=`${n.endsWith(`/`)?n.slice(0,-1):n}/${r.startsWith(`/`)?r.slice(1):r}`;return t.length>2?g(i,...t.slice(2)):i},_=e=>!(!e||/^https?:\/\//i.test(e)||e.startsWith(`/`)||e.startsWith(`./`)||e.startsWith(`../`));function v(e={}){let{imageBase:t,imageDir:n=`imageDir`,fileDir:r=!1}=e;return(e,i)=>{let a=(i?.data?.astro?.frontmatter||i?.data?.frontmatter||{})[n]||``,o=(i?.path||i?.history?.[0]||``).split(/[\\/]/).pop()?.split(`.`).shift()||``,s=r?o:a,c=e=>{if(e){if(e.type===`image`){let n=e.url||``;(t||s)&&_(n)&&(e.url=g(t,s,n))}e.children&&e.children.length&&e.children.forEach(c)}};c(e)}}var y=[`Model`,`LensModel`,`FocalLength`,`FNumber`,`ExposureTime`,`ISO`,`DateTimeOriginal`];function b(e){let t=e.replace(/\\/g,`/`),n=``;for(let e=0;e<t.length;e++){let r=t[e];r===`*`?t[e+1]===`*`?(n+=`.*`,e++,t[e+1]===`/`&&e++):n+=`[^/]*`:r===`?`?n+=`[^/]`:/[.+^${}()|[\]\\]/.test(r)?n+=`\\`+r:n+=r}return RegExp(`^`+n+`$`)}function x(e){let t=typeof e.exif==`object`&&e.exif!==null?e.exif:{},n=e=>Array.isArray(e)&&e.length>0?e.filter(e=>typeof e==`string`).map(b):null;return{cache:t.cache!==!1,concurrency:typeof t.concurrency==`number`&&t.concurrency>0?t.concurrency:6,timeout:typeof t.timeout==`number`&&t.timeout>0?t.timeout:15e3,headerBytes:typeof t.headerBytes==`number`&&t.headerBytes>=0?t.headerBytes:131072,fields:Array.isArray(t.fields)&&t.fields.length>0?t.fields:y,separator:typeof t.separator==`string`?t.separator:` · `,include:n(t.include),exclude:n(t.exclude)??[]}}var S=class{available;waiters=[];constructor(e){this.available=Math.max(1,e)}async acquire(){this.available>0?this.available--:await new Promise(e=>this.waiters.push(e));let e=!1;return()=>{e||(e=!0,this.release())}}release(){let e=this.waiters.shift();e?e():this.available++}},C=null;function w(e){return C||=new S(e),C}var T=1,E=null,D=!1,O=Promise.resolve();function k(){return d.join(process.cwd(),`node_modules`,`.cache`,`photosuite`,`exif-cache.json`)}function A(){return E||=(async()=>{try{let e=await u.readFile(k(),`utf-8`),t=JSON.parse(e);if(t&&t.version===T&&t.entries&&typeof t.entries==`object`)return t}catch{}return{version:T,entries:{}}})(),E}async function j(){if(!D||!E)return;let e=await E;D=!1,O=O.then(async()=>{let t=k(),n=d.dirname(t);await u.mkdir(n,{recursive:!0});let r=d.join(n,`.exif-cache.${process.pid}.${Date.now()}.tmp`);await u.writeFile(r,JSON.stringify(e),`utf-8`),await u.rename(r,t)}).catch(()=>{}),await O}function M(e){try{let t=new h.URL(e);return t.protocol===`http:`||t.protocol===`https:`}catch{return!1}}function N(e,t,n){return new Promise((r,i)=>{let a=e.startsWith(`https:`)?p:f,o={};t.headerBytes>0&&(o.Range=`bytes=0-${t.headerBytes-1}`);let s=a.get(e,{headers:o},a=>{let o=a.statusCode||0;if(o>=300&&o<400&&a.headers.location){if(a.resume(),n>=5){i(Error(`Too many redirects`));return}N(new h.URL(a.headers.location,e).toString(),t,n+1).then(r,i);return}if(o!==200&&o!==206){a.resume(),i(Error(`HTTP `+o));return}let s=m.tmpdir(),c=`.bin`;try{c=d.extname(new h.URL(e).pathname)||`.bin`}catch{}let f=d.join(s,`exif-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}${c}`),p=l.createWriteStream(f);a.pipe(p),p.on(`finish`,()=>{r({path:f,cleanup:async()=>{try{await u.unlink(f)}catch{}}})}),p.on(`error`,e=>{try{l.unlinkSync(f)}catch{}i(e)})});s.setTimeout(t.timeout,()=>{s.destroy(Object.assign(Error(`timeout`),{code:`ETIMEDOUT`}))}),s.on(`error`,i)})}async function P(e,t){try{return await N(e,t,0)}catch(n){let r=n&&n.code;if(r===`ECONNRESET`||r===`ETIMEDOUT`||r===`ECONNREFUSED`)return await N(e,t,0);throw n}}async function F(e){let t=await c.exiftool.read(e);return{SourceFile:t.SourceFile,ExifToolVersion:t.ExifToolVersion,MIMEType:t.MIMEType,FileType:t.FileType,Make:t.Make,Model:t.Model,LensModel:t.LensModel,DateTimeOriginal:t.DateTimeOriginal,CreateDate:t.CreateDate,ModifyDate:t.ModifyDate,ImageWidth:t.ImageWidth,ImageHeight:t.ImageHeight,GPSLatitude:t.GPSLatitude,GPSLongitude:t.GPSLongitude,FNumber:t.FNumber,ExposureTime:t.ExposureTime,ISO:t.ISO,FocalLength:t.FocalLength,warnings:t.warnings||[],errors:t.errors||[]}}function I(e,t){if(t==null)return``;switch(e){case`FNumber`:return`ƒ/${Number(t).toFixed(1)}`;case`ExposureTime`:return typeof t==`number`?t>=1?`${t}s`:`1/${Math.round(1/t)}s`:t.toString();case`ISO`:return`ISO ${t}`;case`FocalLength`:let e=t.toString();return e.endsWith(`mm`)?e:`${e}mm`;case`DateTimeOriginal`:return typeof t==`object`&&t.year?`${t.year}/${t.month}/${t.day}`:t.toString();default:return t.toString()}}async function L(e,t,n){let r=``,i;try{if(M(e)){let t=await w(n.concurrency).acquire();try{let t=await P(e,n);r=t.path,i=t.cleanup}finally{t()}}else{if(d.isAbsolute(e))r=e;else{let n=d.dirname(t.path);r=d.resolve(n,e)}if(!l.existsSync(r)){let e=decodeURIComponent(r);if(l.existsSync(e))r=e;else return null}}if(!r||!l.existsSync(r))return null;let a=await F(r);return a.FNumber&&a.ExposureTime&&a.ISO?a:null}finally{i&&await i()}}function R(e,t,n){let r=n.fields.map(e=>{let n=t[e];return n?I(e,n):null}).filter(Boolean);if(r.length===0)return;let i=r.join(n.separator),a={...e.properties};e.tagName=`div`,e.properties={className:[`photosuite-item`]},e.children=[{type:`element`,tagName:`img`,properties:a,children:[]},{type:`element`,tagName:`div`,properties:{className:[`photosuite-exif`]},children:[{type:`text`,value:i}]}]}async function z(e,t,n){let r=e.properties?.src;if(!r)return;let i=M(r),a=n.cache&&i,o;if(a){let e=await A();Object.prototype.hasOwnProperty.call(e.entries,r)&&(o=e.entries[r])}if(o===void 0){try{o=await L(r,t,n)}catch(e){console.warn(`[photosuite] Failed to get EXIF for ${r}:`,e);return}if(a){let e=await A();e.entries[r]=o,D=!0}}o&&R(e,o,n)}function B(e,t){let n=e?.data?.astro?.frontmatter||e?.data?.frontmatter||{};if(n.exif===!1||n.photosuite===!1||n.photosuite&&typeof n.photosuite==`object`&&n.photosuite.exif===!1)return!1;let r=e?.path||e?.history?.[0]||``;if(!r)return!0;let i=d.relative(process.cwd(),r).replace(/\\/g,`/`);return!(t.exclude.length>0&&t.exclude.some(e=>e.test(i))||t.include&&!t.include.some(e=>e.test(i)))}function V(e={}){let t=x(e);return async(e,n)=>{if(!B(n,t))return;let r=[],i=e=>{e.type===`element`&&e.tagName===`img`&&r.push(z(e,n,t)),e.children&&e.children.forEach(i)};i(e),r.length>0&&await Promise.all(r),t.cache&&await j()}}function H(e){return{name:`photosuite`,hooks:{"astro:config:setup":({injectScript:t,updateConfig:n})=>{t(`page`,`
                     import { photosuite } from 'photosuite/client';
                     const __opts = ${JSON.stringify(e)};
                     const __run = () => photosuite(__opts);
                     __run();
                     document.addEventListener('astro:page-load', __run);
-                    `);let r=[],i=[];i.push([v,e]),e.exif!==!1&&r.push([z,e]);let a={markdown:{}};r.length>0&&(a.markdown.rehypePlugins=r),i.length>0&&(a.markdown.remarkPlugins=i),Object.keys(a.markdown).length>0&&n(a)}}}}const V=B;exports.default=B,exports.exiftoolVendored=z,exports.imageUrl=v,exports.photosuite=V;
+                    `);let r=[],i=[];i.push([v,e]),e.exif!==!1&&r.push([V,e]);let a={markdown:{}};r.length>0&&(a.markdown.rehypePlugins=r),i.length>0&&(a.markdown.remarkPlugins=i),Object.keys(a.markdown).length>0&&n(a)}}}}const U=H;exports.default=H,exports.exiftoolVendored=V,exports.imageUrl=v,exports.photosuite=U;

package/dist/photosuite.integration.js

@@ -7,25 +7,25 @@ import * as https from "node:https";
 import * as os from "node:os";
 import { URL } from "node:url";
 var join = (...n) => {
-	let y = n.filter((n) => typeof n == "string" && n !== "");
-	if (y.length === 0) return "";
-	if (y.length === 1) return y[0];
-	let b = y[0], x = y[1], S = `${b.endsWith("/") ? b.slice(0, -1) : b}/${x.startsWith("/") ? x.slice(1) : x}`;
-	return y.length > 2 ? join(S, ...y.slice(2)) : S;
+	let x = n.filter((n) => typeof n == "string" && n !== "");
+	if (x.length === 0) return "";
+	if (x.length === 1) return x[0];
+	let S = x[0], C = x[1], w = `${S.endsWith("/") ? S.slice(0, -1) : S}/${C.startsWith("/") ? C.slice(1) : C}`;
+	return x.length > 2 ? join(w, ...x.slice(2)) : w;
 }, isShort = (n) => !(!n || /^https?:\/\//i.test(n) || n.startsWith("/") || n.startsWith("./") || n.startsWith("../"));
 function imageUrl(n = {}) {
-	let { imageBase: y, imageDir: b = "imageDir", fileDir: x = !1 } = n;
-	return (n, S) => {
-		let C = (S?.data?.astro?.frontmatter || S?.data?.frontmatter || {})[b] || "", w = (S?.path || S?.history?.[0] || "").split(/[\\/]/).pop()?.split(".").shift() || "", T = x ? w : C, O = (n) => {
+	let { imageBase: x, imageDir: S = "imageDir", fileDir: C = !1 } = n;
+	return (n, w) => {
+		let T = (w?.data?.astro?.frontmatter || w?.data?.frontmatter || {})[S] || "", E = (w?.path || w?.history?.[0] || "").split(/[\\/]/).pop()?.split(".").shift() || "", D = C ? E : T, A = (n) => {
 			if (n) {
 				if (n.type === "image") {
-					let b = n.url || "";
-					(y || T) && isShort(b) && (n.url = join(y, T, b));
+					let S = n.url || "";
+					(x || D) && isShort(S) && (n.url = join(x, D, S));
 				}
-				n.children && n.children.length && n.children.forEach(O);
+				n.children && n.children.length && n.children.forEach(A);
 			}
 		};
-		O(n);
+		A(n);
 	};
 }
 var DEFAULT_FIELDS = [
@@ -37,15 +37,25 @@ var DEFAULT_FIELDS = [
 	"ISO",
 	"DateTimeOriginal"
 ];
+function globToRegExp(n) {
+	let x = n.replace(/\\/g, "/"), S = "";
+	for (let n = 0; n < x.length; n++) {
+		let C = x[n];
+		C === "*" ? x[n + 1] === "*" ? (S += ".*", n++, x[n + 1] === "/" && n++) : S += "[^/]*" : C === "?" ? S += "[^/]" : /[.+^${}()|[\]\\]/.test(C) ? S += "\\" + C : S += C;
+	}
+	return /* @__PURE__ */ RegExp("^" + S + "$");
+}
 function resolveExifOptions(n) {
-	let y = typeof n.exif == "object" && n.exif !== null ? n.exif : {};
+	let x = typeof n.exif == "object" && n.exif !== null ? n.exif : {}, S = (n) => Array.isArray(n) && n.length > 0 ? n.filter((n) => typeof n == "string").map(globToRegExp) : null;
 	return {
-		cache: y.cache !== !1,
-		concurrency: typeof y.concurrency == "number" && y.concurrency > 0 ? y.concurrency : 6,
-		timeout: typeof y.timeout == "number" && y.timeout > 0 ? y.timeout : 15e3,
-		headerBytes: typeof y.headerBytes == "number" && y.headerBytes >= 0 ? y.headerBytes : 131072,
-		fields: Array.isArray(y.fields) && y.fields.length > 0 ? y.fields : DEFAULT_FIELDS,
-		separator: typeof y.separator == "string" ? y.separator : " · "
+		cache: x.cache !== !1,
+		concurrency: typeof x.concurrency == "number" && x.concurrency > 0 ? x.concurrency : 6,
+		timeout: typeof x.timeout == "number" && x.timeout > 0 ? x.timeout : 15e3,
+		headerBytes: typeof x.headerBytes == "number" && x.headerBytes >= 0 ? x.headerBytes : 131072,
+		fields: Array.isArray(x.fields) && x.fields.length > 0 ? x.fields : DEFAULT_FIELDS,
+		separator: typeof x.separator == "string" ? x.separator : " · ",
+		include: S(x.include),
+		exclude: S(x.exclude) ?? []
 	};
 }
 var Semaphore = class {
@@ -76,8 +86,8 @@ function cacheFilePath() {
 function loadCache() {
 	return cachePromise ||= (async () => {
 		try {
-			let n = await fsp.readFile(cacheFilePath(), "utf-8"), y = JSON.parse(n);
-			if (y && y.version === CACHE_VERSION && y.entries && typeof y.entries == "object") return y;
+			let n = await fsp.readFile(cacheFilePath(), "utf-8"), x = JSON.parse(n);
+			if (x && x.version === CACHE_VERSION && x.entries && typeof x.entries == "object") return x;
 		} catch {}
 		return {
 			version: CACHE_VERSION,
@@ -89,152 +99,152 @@ async function flushCache() {
 	if (!cacheDirty || !cachePromise) return;
 	let n = await cachePromise;
 	cacheDirty = !1, writing = writing.then(async () => {
-		let y = cacheFilePath(), S = path.dirname(y);
-		await fsp.mkdir(S, { recursive: !0 });
-		let C = path.join(S, `.exif-cache.${process.pid}.${Date.now()}.tmp`);
-		await fsp.writeFile(C, JSON.stringify(n), "utf-8"), await fsp.rename(C, y);
+		let x = cacheFilePath(), w = path.dirname(x);
+		await fsp.mkdir(w, { recursive: !0 });
+		let T = path.join(w, `.exif-cache.${process.pid}.${Date.now()}.tmp`);
+		await fsp.writeFile(T, JSON.stringify(n), "utf-8"), await fsp.rename(T, x);
 	}).catch(() => {}), await writing;
 }
 function isHttpUrl(n) {
 	try {
-		let y = new URL(n);
-		return y.protocol === "http:" || y.protocol === "https:";
+		let x = new URL(n);
+		return x.protocol === "http:" || x.protocol === "https:";
 	} catch {
 		return !1;
 	}
 }
-function downloadAttempt(n, E, D) {
-	return new Promise((O, k) => {
-		let A = n.startsWith("https:") ? https : http, j = {};
-		E.headerBytes > 0 && (j.Range = `bytes=0-${E.headerBytes - 1}`);
-		let M = A.get(n, { headers: j }, (S) => {
-			let C = S.statusCode || 0;
-			if (C >= 300 && C < 400 && S.headers.location) {
-				if (S.resume(), D >= 5) {
-					k(/* @__PURE__ */ Error("Too many redirects"));
+function downloadAttempt(n, O, k) {
+	return new Promise((A, j) => {
+		let M = n.startsWith("https:") ? https : http, N = {};
+		O.headerBytes > 0 && (N.Range = `bytes=0-${O.headerBytes - 1}`);
+		let P = M.get(n, { headers: N }, (w) => {
+			let T = w.statusCode || 0;
+			if (T >= 300 && T < 400 && w.headers.location) {
+				if (w.resume(), k >= 5) {
+					j(/* @__PURE__ */ Error("Too many redirects"));
 					return;
 				}
-				downloadAttempt(new URL(S.headers.location, n).toString(), E, D + 1).then(O, k);
+				downloadAttempt(new URL(w.headers.location, n).toString(), O, k + 1).then(A, j);
 				return;
 			}
-			if (C !== 200 && C !== 206) {
-				S.resume(), k(/* @__PURE__ */ Error("HTTP " + C));
+			if (T !== 200 && T !== 206) {
+				w.resume(), j(/* @__PURE__ */ Error("HTTP " + T));
 				return;
 			}
-			let A = os.tmpdir(), j = ".bin";
+			let M = os.tmpdir(), N = ".bin";
 			try {
-				j = path.extname(new URL(n).pathname) || ".bin";
+				N = path.extname(new URL(n).pathname) || ".bin";
 			} catch {}
-			let M = path.join(A, `exif-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}${j}`), N = fs.createWriteStream(M);
-			S.pipe(N), N.on("finish", () => {
-				O({
-					path: M,
+			let P = path.join(M, `exif-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}${N}`), F = fs.createWriteStream(P);
+			w.pipe(F), F.on("finish", () => {
+				A({
+					path: P,
 					cleanup: async () => {
 						try {
-							await fsp.unlink(M);
+							await fsp.unlink(P);
 						} catch {}
 					}
 				});
-			}), N.on("error", (n) => {
+			}), F.on("error", (n) => {
 				try {
-					fs.unlinkSync(M);
+					fs.unlinkSync(P);
 				} catch {}
-				k(n);
+				j(n);
 			});
 		});
-		M.setTimeout(E.timeout, () => {
-			M.destroy(Object.assign(/* @__PURE__ */ Error("timeout"), { code: "ETIMEDOUT" }));
-		}), M.on("error", k);
+		P.setTimeout(O.timeout, () => {
+			P.destroy(Object.assign(/* @__PURE__ */ Error("timeout"), { code: "ETIMEDOUT" }));
+		}), P.on("error", j);
 	});
 }
-async function downloadToTemp(n, y) {
+async function downloadToTemp(n, x) {
 	try {
-		return await downloadAttempt(n, y, 0);
-	} catch (b) {
-		let x = b && b.code;
-		if (x === "ECONNRESET" || x === "ETIMEDOUT" || x === "ECONNREFUSED") return await downloadAttempt(n, y, 0);
-		throw b;
+		return await downloadAttempt(n, x, 0);
+	} catch (S) {
+		let C = S && S.code;
+		if (C === "ECONNRESET" || C === "ETIMEDOUT" || C === "ECONNREFUSED") return await downloadAttempt(n, x, 0);
+		throw S;
 	}
 }
-async function handleExif(y) {
-	let b = await exiftool.read(y);
+async function handleExif(x) {
+	let S = await exiftool.read(x);
 	return {
-		SourceFile: b.SourceFile,
-		ExifToolVersion: b.ExifToolVersion,
-		MIMEType: b.MIMEType,
-		FileType: b.FileType,
-		Make: b.Make,
-		Model: b.Model,
-		LensModel: b.LensModel,
-		DateTimeOriginal: b.DateTimeOriginal,
-		CreateDate: b.CreateDate,
-		ModifyDate: b.ModifyDate,
-		ImageWidth: b.ImageWidth,
-		ImageHeight: b.ImageHeight,
-		GPSLatitude: b.GPSLatitude,
-		GPSLongitude: b.GPSLongitude,
-		FNumber: b.FNumber,
-		ExposureTime: b.ExposureTime,
-		ISO: b.ISO,
-		FocalLength: b.FocalLength,
-		warnings: b.warnings || [],
-		errors: b.errors || []
+		SourceFile: S.SourceFile,
+		ExifToolVersion: S.ExifToolVersion,
+		MIMEType: S.MIMEType,
+		FileType: S.FileType,
+		Make: S.Make,
+		Model: S.Model,
+		LensModel: S.LensModel,
+		DateTimeOriginal: S.DateTimeOriginal,
+		CreateDate: S.CreateDate,
+		ModifyDate: S.ModifyDate,
+		ImageWidth: S.ImageWidth,
+		ImageHeight: S.ImageHeight,
+		GPSLatitude: S.GPSLatitude,
+		GPSLongitude: S.GPSLongitude,
+		FNumber: S.FNumber,
+		ExposureTime: S.ExposureTime,
+		ISO: S.ISO,
+		FocalLength: S.FocalLength,
+		warnings: S.warnings || [],
+		errors: S.errors || []
 	};
 }
-function formatField(n, y) {
-	if (y == null) return "";
+function formatField(n, x) {
+	if (x == null) return "";
 	switch (n) {
-		case "FNumber": return `ƒ/${Number(y).toFixed(1)}`;
-		case "ExposureTime": return typeof y == "number" ? y >= 1 ? `${y}s` : `1/${Math.round(1 / y)}s` : y.toString();
-		case "ISO": return `ISO ${y}`;
+		case "FNumber": return `ƒ/${Number(x).toFixed(1)}`;
+		case "ExposureTime": return typeof x == "number" ? x >= 1 ? `${x}s` : `1/${Math.round(1 / x)}s` : x.toString();
+		case "ISO": return `ISO ${x}`;
 		case "FocalLength":
-			let n = y.toString();
+			let n = x.toString();
 			return n.endsWith("mm") ? n : `${n}mm`;
-		case "DateTimeOriginal": return typeof y == "object" && y.year ? `${y.year}/${y.month}/${y.day}` : y.toString();
-		default: return y.toString();
+		case "DateTimeOriginal": return typeof x == "object" && x.year ? `${x.year}/${x.month}/${x.day}` : x.toString();
+		default: return x.toString();
 	}
 }
-async function extractExif(n, b, S) {
-	let C = "", w;
+async function extractExif(n, S, w) {
+	let T = "", E;
 	try {
 		if (isHttpUrl(n)) {
-			let y = await getSemaphore(S.concurrency).acquire();
+			let x = await getSemaphore(w.concurrency).acquire();
 			try {
-				let y = await downloadToTemp(n, S);
-				C = y.path, w = y.cleanup;
+				let x = await downloadToTemp(n, w);
+				T = x.path, E = x.cleanup;
 			} finally {
-				y();
+				x();
 			}
 		} else {
-			if (path.isAbsolute(n)) C = n;
+			if (path.isAbsolute(n)) T = n;
 			else {
-				let y = path.dirname(b.path);
-				C = path.resolve(y, n);
+				let x = path.dirname(S.path);
+				T = path.resolve(x, n);
 			}
-			if (!fs.existsSync(C)) {
-				let n = decodeURIComponent(C);
-				if (fs.existsSync(n)) C = n;
+			if (!fs.existsSync(T)) {
+				let n = decodeURIComponent(T);
+				if (fs.existsSync(n)) T = n;
 				else return null;
 			}
 		}
-		if (!C || !fs.existsSync(C)) return null;
-		let T = await handleExif(C);
-		return T.FNumber && T.ExposureTime && T.ISO ? T : null;
+		if (!T || !fs.existsSync(T)) return null;
+		let D = await handleExif(T);
+		return D.FNumber && D.ExposureTime && D.ISO ? D : null;
 	} finally {
-		w && await w();
+		E && await E();
 	}
 }
-function renderExifNode(n, y, b) {
-	let x = b.fields.map((n) => {
-		let b = y[n];
-		return b ? formatField(n, b) : null;
+function renderExifNode(n, x, S) {
+	let C = S.fields.map((n) => {
+		let S = x[n];
+		return S ? formatField(n, S) : null;
 	}).filter(Boolean);
-	if (x.length === 0) return;
-	let S = x.join(b.separator), C = { ...n.properties };
+	if (C.length === 0) return;
+	let w = C.join(S.separator), T = { ...n.properties };
 	n.tagName = "div", n.properties = { className: ["photosuite-item"] }, n.children = [{
 		type: "element",
 		tagName: "img",
-		properties: C,
+		properties: T,
 		children: []
 	}, {
 		type: "element",
@@ -242,56 +252,65 @@ function renderExifNode(n, y, b) {
 		properties: { className: ["photosuite-exif"] },
 		children: [{
 			type: "text",
-			value: S
+			value: w
 		}]
 	}];
 }
-async function processNode(n, y, b) {
-	let x = n.properties?.src;
-	if (!x) return;
-	let S = isHttpUrl(x), C = b.cache && S, w;
-	if (C) {
+async function processNode(n, x, S) {
+	let C = n.properties?.src;
+	if (!C) return;
+	let w = isHttpUrl(C), T = S.cache && w, E;
+	if (T) {
 		let n = await loadCache();
-		Object.prototype.hasOwnProperty.call(n.entries, x) && (w = n.entries[x]);
+		Object.prototype.hasOwnProperty.call(n.entries, C) && (E = n.entries[C]);
 	}
-	if (w === void 0) {
+	if (E === void 0) {
 		try {
-			w = await extractExif(x, y, b);
+			E = await extractExif(C, x, S);
 		} catch (n) {
-			console.warn(`[photosuite] Failed to get EXIF for ${x}:`, n);
+			console.warn(`[photosuite] Failed to get EXIF for ${C}:`, n);
 			return;
 		}
-		if (C) {
+		if (T) {
 			let n = await loadCache();
-			n.entries[x] = w, cacheDirty = !0;
+			n.entries[C] = E, cacheDirty = !0;
 		}
 	}
-	w && renderExifNode(n, w, b);
+	E && renderExifNode(n, E, S);
+}
+function shouldProcessFile(n, x) {
+	let S = n?.data?.astro?.frontmatter || n?.data?.frontmatter || {};
+	if (S.exif === !1 || S.photosuite === !1 || S.photosuite && typeof S.photosuite == "object" && S.photosuite.exif === !1) return !1;
+	let w = n?.path || n?.history?.[0] || "";
+	if (!w) return !0;
+	let T = path.relative(process.cwd(), w).replace(/\\/g, "/");
+	return !(x.exclude.length > 0 && x.exclude.some((n) => n.test(T)) || x.include && !x.include.some((n) => n.test(T)));
 }
 function exiftoolVendored(n = {}) {
-	let y = resolveExifOptions(n);
-	return async (n, b) => {
-		let x = [], S = (n) => {
-			n.type === "element" && n.tagName === "img" && x.push(processNode(n, b, y)), n.children && n.children.forEach(S);
+	let x = resolveExifOptions(n);
+	return async (n, S) => {
+		if (!shouldProcessFile(S, x)) return;
+		let C = [], w = (n) => {
+			n.type === "element" && n.tagName === "img" && C.push(processNode(n, S, x)), n.children && n.children.forEach(w);
 		};
-		S(n), x.length > 0 && await Promise.all(x), y.cache && await flushCache();
+		w(n), C.length > 0 && await Promise.all(C), x.cache && await flushCache();
 	};
 }
 function astroPhotosuite(n) {
 	return {
 		name: "photosuite",
-		hooks: { "astro:config:setup": ({ injectScript: y, updateConfig: b }) => {
-			y("page", `
+		hooks: { "astro:config:setup": ({ injectScript: x, updateConfig: S }) => {
+			x("page", `
                     import { photosuite } from 'photosuite/client';
                     const __opts = ${JSON.stringify(n)};
                     const __run = () => photosuite(__opts);
                     __run();
                     document.addEventListener('astro:page-load', __run);
                     `);
-			let x = [], S = [];
-			S.push([imageUrl, n]), n.exif !== !1 && x.push([exiftoolVendored, n]);
-			let C = { markdown: {} };
-			x.length > 0 && (C.markdown.rehypePlugins = x), S.length > 0 && (C.markdown.remarkPlugins = S), Object.keys(C.markdown).length > 0 && b(C);
+			let C = [], w = [];
+			w.push([imageUrl, n]), n.exif !== !1 && C.push([exiftoolVendored, n]);
+			let T = { markdown: {} };
+			C.length > 0 && (T.markdown.rehypePlugins = C), w.length > 0 && (T.markdown.remarkPlugins = w), Object.keys(T.markdown).length > 0 && S(T);
 		} }
 	};
 }

package/dist/types.d.ts

@@ -145,4 +145,18 @@ export interface PhotosuiteExifOptions {
      * 大幅减少传输量。设为 0 则下载完整文件。
      */
     headerBytes?: number;
+    /**
+     * 仅对匹配的 Markdown 文件启用 EXIF 注入
+     * @example ["src/content/posts/**\/*.md"]
+     * @description 相对于项目根目录的 glob 模式数组。未配置时对所有 Markdown 生效。
+     * 支持 `*`（匹配单段）、`**`（跨段匹配）、`?`（匹配单字符）。
+     */
+    include?: string[];
+    /**
+     * 跳过匹配的 Markdown 文件，不进行 EXIF 注入
+     * @example ["src/content/pages/**\/*.md"]
+     * @description 相对于项目根目录的 glob 模式数组。优先级高于 include。
+     * 也可在单个页面的 frontmatter 中设置 `exif: false` 或 `photosuite: false` 跳过该页。
+     */
+    exclude?: string[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "photosuite",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "一款零配置的 Astro 图片增强集成，支持灯箱、自动拼图、EXIF 信息及路径解析。",
   "keywords": [
     "astro-integration",