feat(DEVONthink): add DEVONthink URL scheme support

Co-Authored-By: Codex <267193182+codex@users.noreply.github.com>

Author: zhensherlock

.changeset/mighty-stars-watch.md

@@ -0,0 +1,5 @@
+---
+'protocol-launcher': minor
+---
+
+feat(DEVONthink): add DEVONthink URL scheme support

apps/docs/.vitepress/config.ts

@@ -48,6 +48,7 @@ export default defineConfig({
     'en/apps/cursor.md': 'apps/cursor.md',
     'en/apps/2do.md': 'apps/2do.md',
     'en/apps/day-one.md': 'apps/day-one.md',
+    'en/apps/devonthink.md': 'apps/devonthink.md',
     'en/apps/dict-cc.md': 'apps/dict-cc.md',
     'en/apps/drafts.md': 'apps/drafts.md',
     'en/apps/editorial.md': 'apps/editorial.md',
@@ -207,6 +208,7 @@ export default defineConfig({
           { text: 'Cursor', link: '/apps/cursor' },
           { text: '2Do', link: '/apps/2do' },
           { text: 'Day One', link: '/apps/day-one' },
+          { text: 'DEVONthink', link: '/apps/devonthink' },
           { text: 'dict.cc', link: '/apps/dict-cc' },
           { text: 'Drafts', link: '/apps/drafts' },
           { text: 'Editorial', link: '/apps/editorial' },
@@ -372,6 +374,7 @@ export default defineConfig({
               { text: 'Cursor', link: '/apps/cursor' },
               { text: '2Do', link: '/apps/2do' },
               { text: 'Day One', link: '/apps/day-one' },
+              { text: 'DEVONthink', link: '/apps/devonthink' },
               { text: 'dict.cc', link: '/apps/dict-cc' },
               { text: 'Drafts', link: '/apps/drafts' },
               { text: 'Editorial', link: '/apps/editorial' },
@@ -502,6 +505,7 @@ export default defineConfig({
               { text: 'Cursor', link: '/zh/apps/cursor' },
               { text: '2Do', link: '/zh/apps/2do' },
               { text: 'Day One', link: '/zh/apps/day-one' },
+              { text: 'DEVONthink', link: '/zh/apps/devonthink' },
               { text: 'dict.cc', link: '/zh/apps/dict-cc' },
               { text: 'Drafts', link: '/zh/apps/drafts' },
               { text: 'Editorial', link: '/zh/apps/editorial' },

apps/docs/.vitepress/constants/devonthink.ts

@@ -0,0 +1,3 @@
+export const searchParams = {
+  query: 'invoice',
+}

apps/docs/en/apps/devonthink.md

@@ -0,0 +1,229 @@
+---
+layout: doc
+---
+
+<script setup lang="ts">
+import { ref, computed } from 'vue';
+import VPLink from 'vitepress/dist/client/theme-default/components/VPLink.vue';
+import { clip, note, search } from 'protocol-launcher/devonthink';
+import { SelectInstallationMethod } from '../../.vitepress/components';
+import { searchParams } from '../../.vitepress/constants/devonthink';
+
+const currentMethod = ref('On-Demand');
+const importPath = computed(() => currentMethod.value === 'On-Demand' ? 'protocol-launcher/devonthink' : 'protocol-launcher');
+</script>
+
+# DEVONthink
+
+[DEVONthink](https://www.devontechnologies.com/apps/devonthink) is a document and information manager for macOS. **Protocol Launcher** generates both DEVONthink URL commands (`x-devonthink://`) and DEVONthink item links (`x-devonthink-item://`) from the official DEVONthink Help references.
+
+## Usage
+
+There are two ways to use this library:
+
+- On-Demand import from subpaths enables tree-shaking and keeps bundles small.
+- Full Import from the root package is convenient but includes all app modules.
+
+Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.
+
+<SelectInstallationMethod v-model="currentMethod" />
+
+## URL Commands
+
+DEVONthink URL commands use the `x-devonthink://<command>` scheme. They are commands, not x-callback-url links.
+
+### Create Formatted Note
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createFormattedNote' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createFormattedNote({
+  title: 'New Note',
+  source: '<p>Hello</p>',
+})
+```
+
+### Create HTML
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createHTML' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createHTML({
+  title: 'Page',
+  source: '<h1>Hello</h1>',
+})
+```
+
+### Create Markdown
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createMarkdown' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createMarkdown({
+  title: 'Readme',
+  text: '# Hello',
+})
+```
+
+### Create PDF
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createPDF' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createPDF({
+  location: 'https://www.devontechnologies.com',
+  width: 800,
+  paginated: 1,
+})
+```
+
+### Create RTF
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createRTF' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createRTF({
+  title: 'New bookmark',
+  location: 'http://www.devontechnologies.com',
+  noselector: 1,
+})
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createRTF({
+  title: 'Selection',
+  selection: 'Selected text',
+})
+```
+
+### Create Web Archive
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createWebArchive' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createWebArchive({
+  title: 'DEVONtechnologies',
+  location: 'https://www.devontechnologies.com',
+})
+```
+
+### Create Bookmark
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createBookmark' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createBookmark({
+  title: 'DEVONtechnologies',
+  location: 'https://www.devontechnologies.com',
+})
+```
+
+### Create Group
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createGroup' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createGroup({
+  title: 'Inbox',
+  destination: 'F8E2A5A6-0000-0000-0000-000000000000',
+})
+```
+
+### Create Text
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'createText' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}createText({
+  title: 'Plain Note',
+  text: 'Hello World',
+})
+```
+
+### Clip
+
+Open the Clip to DEVONthink panel.
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'clip' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}clip()
+```
+
+<div class="flex justify-center">
+  <VPLink :href="clip()" target="_self">
+    Open Clip to DEVONthink
+  </VPLink>
+</div>
+
+### Note
+
+Open the Take Note panel.
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'note' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}note()
+```
+
+<div class="flex justify-center">
+  <VPLink :href="note()" target="_self">
+    Open Take Note
+  </VPLink>
+</div>
+
+### Search
+
+Initiate a search in open DEVONthink databases.
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'search' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}search({
+  query: 'invoice',
+})
+```
+
+<div class="flex justify-center">
+  <VPLink :href="search(searchParams)" target="_self">
+    Search in DEVONthink
+  </VPLink>
+</div>
+
+## Item Links
+
+DEVONthink item links use the `x-devonthink-item://<uuid>` scheme. They point to existing DEVONthink databases, groups, documents, or specific locations inside supported documents.
+
+### Item Link
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'itemLink' : 'devonthink' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}itemLink({
+  uuid: '929D101B-35AC-474C-801C-D8818C48DB80',
+  reveal: 1,
+})
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}itemLink({
+  uuid: 'PDF-ID',
+  page: 5,
+})
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}itemLink({
+  uuid: 'TEXT-FILE-ID',
+  search: 'iPad Pro',
+})
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}itemLink({
+  uuid: 'MOVIE-ID',
+  time: 43.5,
+})
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'devonthink.'}}itemLink({
+  uuid: '929D101B-35AC-474C-801C-D8818C48DB80',
+  line: 125,
+})
+```
+
+## Official References
+
+- [DEVONthink URL Commands](https://download.devontechnologies.com/download/devonthink/3.8.2/DEVONthink.help/Contents/Resources/pgs/automation-urlcommands.html)
+- [DEVONthink Item Links](https://download.devontechnologies.com/download/devonthink/3.8.2/DEVONthink.help/Contents/Resources/pgs/automation-itemlinks.html)

apps/docs/en/guide/getting-started.md

@@ -147,6 +147,7 @@ For detailed usage instructions for each application, please refer to their resp
 - [Cursor](../apps/cursor.md)
 - [2Do](../apps/2do.md)
 - [Day One](../apps/day-one.md)
+- [DEVONthink](../apps/devonthink.md)
 - [dict.cc](../apps/dict-cc.md)
 - [Drafts](../apps/drafts.md)
 - [Editorial](../apps/editorial.md)

apps/docs/en/guide/what-is-it.md

@@ -50,6 +50,7 @@ Currently, we support the following applications:
 - [Cursor](../apps/cursor.md)
 - [2Do](../apps/2do.md)
 - [Day One](../apps/day-one.md)
+- [DEVONthink](../apps/devonthink.md)
 - [dict.cc](../apps/dict-cc.md)
 - [Drafts](../apps/drafts.md)
 - [Editorial](../apps/editorial.md)