feathersjs · fratzinger · Mar 10, 2026 · Mar 6, 2026 · Mar 10, 2026 · Mar 10, 2026
diff --git a/.claude/settings.json b/.claude/settings.json
@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx tsc --noEmit)",
+      "Bash(npx vitest run*)",
+      "Bash(npx vitest typecheck *)",
+      "Bash(npx vitepress *)",
+      "Bash(npx prettier *)",
+      "Bash(pnpm test)"
+    ]
+  }
+}
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -35,10 +35,22 @@
     ['meta', { name: 'twitter:image', content: ogImage }],
     ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
   ],
+  transformPageData(pageData) {
+    const utility = utilities.find(
+      (u) => `${u.category}/${u.slug}.md` === pageData.relativePath,
+    )
+    if (utility) {
+      pageData.lastUpdated = utility.lastModified.getTime()
+      pageData.filePath = utility.docsUrl
+        .replace(`https://github.com/${repository}/blob/${mainBranch}/`, '')
+    } else {
+      pageData.filePath = `docs/${pageData.relativePath}`
+    }
+  },
   themeConfig: {
     siteTitle: name,
     editLink: {
-      pattern: `https://github.com/${repository}/edit/${mainBranch}/docs/:path`,
+      pattern: `https://github.com/${repository}/edit/${mainBranch}/:path`,
     },
     lastUpdatedText: 'Last Updated',
     socialLinks: [
@@ -55,13 +67,21 @@
     sidebar: [
       { text: 'Overview', link: '/overview' },
       { text: 'Why moving from feathers-hooks-common', link: '/why' },
-      { text: 'Migrating', link: '/migrating-from-feathers-hooks-common' },
+      {
+        text: 'Migrating',
+        collapsed: false,
+        items: [
+          { text: 'from feathers-hooks-common', link: '/migrating-from-feathers-hooks-common' },
+          { text: 'from @feathersjs/schema', link: '/migrating-from-feathers-schema' },
+          { text: 'from feathers-fletching', link: '/migrating-from-feathers-fletching' },
+        ],
+      },
       {
         text: 'Hooks',
         link: '/hooks',
         collapsed: false,
         items: utilities
-          .filter((x) => x.category === 'hooks')
+          .filter((x) => x.category === 'hooks' || x.hook)
           .map((x) => ({
             text: x.title,
             link: x.path,
@@ -78,6 +98,36 @@
             link: x.path,
           })),
       },
+      {
+        text: 'Resolvers',
+        link: '/resolvers',
+        collapsed: false,
+        items: [
+          ...utilities
+            .filter(
+              (x) =>
+                x.category === 'resolvers' && x.frontmatter.kind !== 'helper',
+            )
+            .map((x) => ({
+              text: x.title,
+              link: x.path,
+            })),
+          {
+            text: 'Helpers',
+            collapsed: false,
+            items: utilities
+              .filter(
+                (x) =>
+                  x.category === 'resolvers' &&
+                  x.frontmatter.kind === 'helper',
+              )
+              .map((x) => ({
+                text: x.title,
+                link: x.path,
+              })),
+          },
+        ],
+      },
       {
         text: 'Predicates',
         link: '/predicates',
@@ -119,6 +169,7 @@
         items: [
           { text: 'Hooks', link: '/hooks' },
           { text: 'Utilities', link: '/utils' },
+          { text: 'Resolvers', link: '/resolvers' },
           { text: 'Predicates', link: '/predicates' },
           { text: 'Transformers', link: '/transformers' },
           { text: 'Type Guards', link: '/guards' },

diff --git a/docs/.vitepress/plugins/markdownTransform.ts b/docs/.vitepress/plugins/markdownTransform.ts
@@ -29,7 +29,7 @@ export function MarkdownTransform(options: MarkdownTransformOptions): Plugin {
         return null
       }
 
-      const result = md(utility)
+      const result = md(utility, utilitiesList)
 
       return result
     },

diff --git a/docs/.vitepress/plugins/utility.ts b/docs/.vitepress/plugins/utility.ts
@@ -14,7 +14,7 @@ const arr = (value: any[]) => {
   return `[${val}]`
 }
 
-export default (utility: Utility) => {
+export default (utility: Utility, utilities: Utility[]) => {
   const code = [
     `# ${utility.title}`,
     `<Chip label="${utility.category}" class="mt-2 mr-2" /> [Source Code](${utility.sourceUrl}) | [Documentation](${utility.docsUrl})`,
@@ -26,7 +26,11 @@ export default (utility: Utility) => {
 
     if (see.length > 0) {
       const seeAlso = `_See also_: ${see
-        .map((x) => {
+        .map((x: string) => {
+          const found = utilities.find((u) => u.name === x)
+          if (found) {
+            return `[\`${x}\`](${found.path})`
+          }
           const parts = x.split('/')
           return `[\`${x}\`](/${parts.map(kebabCase).join('/')}${parts.length === 1 ? '/' : '.html'})`
         })

diff --git a/docs/.vitepress/theme/components/Chip.vue b/docs/.vitepress/theme/components/Chip.vue
@@ -7,6 +7,7 @@
       'bg-emerald-600 text-white': label === 'predicates',
       'bg-amber-600 text-white': label === 'guards',
       'bg-pink-600 text-white': label === 'transformers',
+      'bg-violet-600 text-white': label === 'resolvers',
     }"
   >
     {{ label }}

diff --git a/docs/.vitepress/theme/components/ConditionsTable.vue b/docs/.vitepress/theme/components/ConditionsTable.vue
@@ -0,0 +1,50 @@
+<template>
+  <table class="conditions-table">
+    <thead>
+      <tr>
+        <th class="text-left">Condition</th>
+        <th class="text-left">Description</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr v-for="condition in conditions" :ref="condition.name">
+        <td>
+          <a :href="condition.path">
+            <code>{{ condition.name }}</code>
+          </a>
+        </td>
+        <td v-html="md.render(condition.description)"></td>
+      </tr>
+    </tbody>
+  </table>
+</template>
+
+<script setup lang="ts">
+import Markdown from "markdown-it";
+import { data as resolvers } from "../resolvers.data";
+import { computed } from "vue";
+
+const conditions = computed(() => {
+  return resolvers.filter((r) => r.frontmatter.kind === 'condition');
+});
+
+const md = new Markdown();
+</script>
+
+<style lang="scss">
+table.conditions-table {
+  p {
+    margin-top: 0;
+    margin-bottom: 0;
+  }
+
+  ul {
+    margin-top: 8px;
+    margin-bottom: 8px;
+  }
+
+  li + li {
+    margin-top: 0;
+  }
+}
+</style>
diff --git a/docs/.vitepress/theme/components/ResolversTable.vue b/docs/.vitepress/theme/components/ResolversTable.vue
@@ -0,0 +1,63 @@
+<template>
+  <table class="resolvers-table">
+    <thead>
+      <tr>
+        <th class="text-left">Resolver</th>
+        <th class="text-left">Description</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr v-for="resolver in filteredResolvers" :ref="resolver.name">
+        <td>
+          <a :href="resolver.path">
+            <code>{{ resolver.name }}</code>
+          </a>
+        </td>
+        <td v-html="md.render(resolver.description)"></td>
+      </tr>
+    </tbody>
+  </table>
+</template>
+
+<script setup lang="ts">
+import Markdown from "markdown-it";
+import { data as resolvers } from "../resolvers.data";
+import { computed } from "vue";
+
+const props = withDefaults(
+  defineProps<{
+    filter: (resolver: (typeof resolvers)[number]) => boolean;
+  }>(),
+  {
+    filter: undefined,
+  },
+);
+
+const filteredResolvers = computed(() => {
+  if (!props.filter) {
+    return resolvers;
+  }
+
+  return resolvers.filter(props.filter);
+});
+
+const md = new Markdown();
+</script>
+
+<style lang="scss">
+table.resolvers-table {
+  p {
+    margin-top: 0;
+    margin-bottom: 0;
+  }
+
+  ul {
+    margin-top: 8px;
+    margin-bottom: 8px;
+  }
+
+  li + li {
+    margin-top: 0;
+  }
+}
+</style>
diff --git a/docs/.vitepress/theme/hooks.data.ts b/docs/.vitepress/theme/hooks.data.ts
@@ -4,8 +4,8 @@ import { discoverUtilities } from '../utilities'
 export default defineLoader({
   async load() {
     return (await discoverUtilities()).filter(
-      (utility) => utility.category === 'hooks',
+      (utility) => utility.category === 'hooks' || utility.hook,
     )
   },
-  watch: ['src/hooks/**/*.md'],
+  watch: ['src/hooks/**/*.md', 'src/resolvers/**/*.md'],
 })
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
@@ -10,6 +10,8 @@ import TransformersTable from './components/TransformersTable.vue'
 import GuardsTable from './components/GuardsTable.vue'
 import HooksTable from './components/HooksTable.vue'
 import UtilsTable from './components/UtilsTable.vue'
+import ResolversTable from './components/ResolversTable.vue'
+import ConditionsTable from './components/ConditionsTable.vue'
 import Chip from './components/Chip.vue'
 
 import '../style/main.css'
@@ -27,6 +29,8 @@ export default {
     app.component('GuardsTable', GuardsTable)
     app.component('HooksTable', HooksTable)
     app.component('UtilsTable', UtilsTable)
+    app.component('ResolversTable', ResolversTable)
+    app.component('ConditionsTable', ConditionsTable)
 
     app.component('Chip', Chip)
   },

diff --git a/docs/.vitepress/theme/resolvers.data.ts b/docs/.vitepress/theme/resolvers.data.ts
@@ -0,0 +1,11 @@
+import { defineLoader } from 'vitepress'
+import { discoverUtilities } from '../utilities'
+
+export default defineLoader({
+  async load() {
+    return (await discoverUtilities()).filter(
+      (utility) => utility.category === 'resolvers',
+    )
+  },
+  watch: ['src/resolvers/**/*.md'],
+})