feat: new snippets for last modified

docs/.vitepress/config.ts

@@ -68,7 +68,8 @@ export default defineConfig({
           { text: 'Code Highlighting', link: 'code-highlighting' },
           { text: 'Integration with Next.js', link: 'with-nextjs' },
           { text: 'Custom Loader', link: 'custom-loader' },
-          { text: 'Custom Schema', link: 'custom-schema' }
+          { text: 'Custom Schema', link: 'custom-schema' },
+          { text: 'Last Modified', link: 'last-modified' }
           // { text: 'Fast Refresh', link: 'fast-refresh' }
         ]
       },

docs/guide/last-modified.md

@@ -0,0 +1,58 @@
+# Last Modified Schema
+
+We provide a last modified timestamp schema based on file stat and git timestamp.
+
+## Based on file stat
+
+create a timestamp schema based on file stat.
+
+```ts
+const timestamp = () =>
+  s.custom<string | undefined>(i => i === undefined || typeof i === 'string').transform<string>(async (value, { meta, addIssue }) => {
+    if (value != null) {
+      addIssue({ fatal: false, code: 'custom', message: '`s.timestamp()` schema will resolve the file modified timestamp' })
+    }
+
+    const stats = await stat(meta.path)
+    return stats.mtime.toISOString()
+  })
+```
+
+use it in your schema
+
+```ts
+const posts = defineCollection({
+  // ...
+  schema: {
+    // ...
+    lastModified: timestamp()
+  }
+})
+```
+
+## Based on git timestamp
+
+```ts
+const execAsync = promisify(exec)
+
+const timestamp = () =>
+  s.custom<string | undefined>(i => i === undefined || typeof i === 'string').transform<string>(async (value, { meta, addIssue }) => {
+    if (value != null) {
+      addIssue({ fatal: false, code: 'custom', message: '`s.timestamp()` schema will resolve the value from `git log -1 --format=%cd`' })
+    }
+    const { stdout } = await execAsync(`git log -1 --format=%cd ${meta.path}`)
+    return new Date(stdout).toISOString()
+  })
+```
+
+use it in your schema
+
+```ts
+const posts = defineCollection({
+  // ...
+  schema: {
+    // ...
+    lastModified: timestamp()
+  }
+})
+```

docs/other/snippets.md

@@ -1,6 +1,55 @@
 # Snippets
 
-#### Remote Image with BlurDataURL Schema
+## Last Modified Schema
+
+### Based on file stat
+
+```ts
+const timestamp = () =>
+  s.custom<string | undefined>(i => i === undefined || typeof i === 'string').transform<string>(async (value, { meta, addIssue }) => {
+    if (value != null) {
+      addIssue({ fatal: false, code: 'custom', message: '`s.timestamp()` schema will resolve the file modified timestamp' })
+    }
+
+    const stats = await stat(meta.path)
+    return stats.mtime.toISOString()
+  })
+
+// use it in your schema
+const posts = defineCollection({
+  // ...
+  schema: {
+    // ...
+    lastModified: timestamp()
+  }
+})
+```
+
+### Based on git timestamp
+
+```ts
+const execAsync = promisify(exec)
+
+const timestamp = () =>
+  s.custom<string | undefined>(i => i === undefined || typeof i === 'string').transform<string>(async (value, { meta, addIssue }) => {
+    if (value != null) {
+      addIssue({ fatal: false, code: 'custom', message: '`s.timestamp()` schema will resolve the value from `git log -1 --format=%cd`' })
+    }
+    const { stdout } = await execAsync(`git log -1 --format=%cd ${meta.path}`)
+    return new Date(stdout).toISOString()
+  })
+
+// use it in your schema
+const posts = defineCollection({
+  // ...
+  schema: {
+    // ...
+    lastModified: timestamp()
+  }
+})
+```
+
+## Remote Image with BlurDataURL Schema
 
 ```ts
 import { getImageMetadata, s } from 'velite'