@stacksjs/defaults 0.75.41 → 0.75.43

package/ide/vscode/tests/pickier.test.ts

@@ -0,0 +1,202 @@
+/**
+ * Pickier support (src/pickier.ts), driven through a fake `vscode` API and a
+ * fake worker process: no editor, no Bun, no pickier.
+ */
+import type { PickierProcess } from '../src/pickier'
+import type { PickierRequest, PickierResult } from '../src/pickier-protocol'
+import { describe, expect, it } from 'bun:test'
+import { chooseBun, createPickierSupport, disableNextLineComment, isLintedFile, isPickierConfigPath } from '../src/pickier'
+import { CodeActionKind, document, fakeVscode, flush } from './fake-vscode'
+
+const ROOT = '/work/app'
+
+interface Worker {
+  answer?: (request: PickierRequest) => PickierResult
+  ready?: false
+  fixText?: boolean
+  exitOnStart?: boolean
+}
+
+function setup(options: { worker?: Worker, files?: string[], settings?: Record<string, unknown>, documents?: ReturnType<typeof document>[] } = {}) {
+  const files = new Set(options.files ?? [`${ROOT}/buddy`])
+  const fake = fakeVscode({ folders: [ROOT], settings: options.settings, documents: options.documents })
+  const spawned: Array<{ bun: string, script: string, cwd: string, requests: PickierRequest[] }> = []
+
+  const host = {
+    exists: (path: string) => files.has(path),
+    spawnBun(bun: string, script: string, cwd: string): PickierProcess {
+      const record = { bun, script, cwd, requests: [] as PickierRequest[] }
+      spawned.push(record)
+      const lineListeners: Array<(line: string) => void> = []
+      const exitListeners: Array<() => void> = []
+      const emit = (message: unknown) => queueMicrotask(() => lineListeners.forEach(listener => listener(JSON.stringify(message))))
+      const worker = options.worker ?? {}
+
+      queueMicrotask(() => {
+        if (worker.exitOnStart)
+          return exitListeners.forEach(listener => listener())
+        if (worker.ready === false)
+          return emit({ ready: false, error: 'Cannot find package \'pickier\'', missing: true })
+        emit({ ready: true, version: '0.1.66', fixText: worker.fixText ?? true })
+      })
+
+      return {
+        write(line) {
+          const request = JSON.parse(line) as PickierRequest
+          record.requests.push(request)
+          const result = worker.answer?.(request) ?? (request.op === 'lint' ? { op: 'lint', issues: [] } : { op: request.op, text: null })
+          emit({ id: request.id, ok: true, result })
+        },
+        onLine: listener => lineListeners.push(listener),
+        onExit: listener => exitListeners.push(listener),
+        kill: () => {},
+      }
+    },
+  }
+
+  const support = createPickierSupport(fake.api as any, host, { workerPath: '/ext/dist/pickier-worker.js', lintDelayMs: 1 })
+  support.activate(fake.context)
+  return { ...fake, spawned, support }
+}
+
+describe('helpers', () => {
+  it('runs pickier on the configured Bun, else the project\'s pinned Bun, else bun on the PATH', () => {
+    expect(chooseBun(' /opt/bun ', ROOT, () => true)).toBe('/opt/bun')
+    expect(chooseBun('', ROOT, path => path === `${ROOT}/pantry/.bin/bun`)).toBe(`${ROOT}/pantry/.bin/bun`)
+    expect(chooseBun('', ROOT, () => false)).toBe('bun')
+  })
+
+  it('lints exactly the files `buddy lint` does', () => {
+    expect(isLintedFile(ROOT, `${ROOT}/app/Actions/Hello.ts`)).toBeTrue()
+    expect(isLintedFile(ROOT, `${ROOT}/README.md`)).toBeTrue()
+    expect(isLintedFile(ROOT, `${ROOT}/node_modules/x/index.ts`)).toBeFalse()
+    expect(isLintedFile(ROOT, `${ROOT}/dist/index.js`)).toBeFalse()
+    expect(isLintedFile(ROOT, `${ROOT}/resources/views/index.stx`)).toBeFalse()
+    expect(isLintedFile(ROOT, '/elsewhere/a.ts')).toBeFalse()
+  })
+
+  it('recognises the files pickier reads its config from', () => {
+    expect(isPickierConfigPath(`${ROOT}/config/code-style.ts`)).toBeTrue()
+    expect(isPickierConfigPath(`${ROOT}/pickier.config.ts`)).toBeTrue()
+    expect(isPickierConfigPath(`${ROOT}/.config/pickier.ts`)).toBeTrue()
+    expect(isPickierConfigPath(`${ROOT}/config/app.ts`)).toBeFalse()
+  })
+
+  it('disables a rule for the next line at that line\'s indentation', () => {
+    expect(disableNextLineComment('    let x = 1', 'prefer-const', '//')).toBe('    // pickier-disable-next-line prefer-const\n')
+  })
+})
+
+describe('diagnostics', () => {
+  it('reports the project pickier\'s issues on an open file, in editor coordinates', async () => {
+    const file = document(`${ROOT}/app/x.ts`, 'import { a } from \'b\'\nlet x = 1\n')
+    const { diagnostics, spawned } = setup({
+      documents: [file],
+      worker: {
+        answer: () => ({ op: 'lint', issues: [{ line: 2, column: 5, ruleId: 'prefer-const', message: '\'x\' is never reassigned', severity: 'error', help: 'Use const' }] }),
+      },
+    })
+    await flush()
+
+    expect(spawned).toHaveLength(1)
+    expect(spawned[0]).toMatchObject({ bun: 'bun', script: '/ext/dist/pickier-worker.js', cwd: ROOT })
+    expect(spawned[0]!.requests[0]).toMatchObject({ op: 'lint', file: `${ROOT}/app/x.ts` })
+
+    const [diagnostic] = diagnostics.get(`file://${ROOT}/app/x.ts`)!
+    expect(diagnostic.source).toBe('pickier')
+    expect(diagnostic.code).toBe('prefer-const')
+    expect(diagnostic.severity).toBe(0)
+    expect(diagnostic.range.start).toMatchObject({ line: 1, character: 4 })
+    expect(diagnostic.range.end).toMatchObject({ line: 1, character: 5 })
+    expect(diagnostic.message).toBe('\'x\' is never reassigned\nUse const')
+  })
+
+  it('leaves folders that are not Stacks projects alone', async () => {
+    const { spawned } = setup({ files: [], documents: [document(`${ROOT}/x.ts`, 'let x = 1\n')] })
+    await flush()
+    expect(spawned).toHaveLength(0)
+  })
+
+  it('lints nothing when turned off', async () => {
+    const { spawned } = setup({ settings: { 'pickier.enable': false }, documents: [document(`${ROOT}/x.ts`, 'let x = 1\n')] })
+    await flush()
+    expect(spawned).toHaveLength(0)
+  })
+
+  it('stops asking a project with no pickier, and says why once', async () => {
+    const { spawned, events, output, diagnostics } = setup({ worker: { ready: false }, documents: [document(`${ROOT}/a.ts`, '')] })
+    await flush()
+    events.opened.fire(document(`${ROOT}/b.ts`, '') as any)
+    await flush()
+
+    expect(spawned).toHaveLength(1)
+    expect(diagnostics.size).toBe(0)
+    expect(output.filter(line => line.includes('not available'))).toHaveLength(1)
+  })
+
+  it('gives up on a worker that keeps exiting instead of respawning it on every keystroke', async () => {
+    const { spawned, events } = setup({ worker: { exitOnStart: true } })
+    for (let i = 0; i < 5; i++) {
+      events.opened.fire(document(`${ROOT}/x${i}.ts`, '') as any)
+      await flush()
+    }
+    expect(spawned).toHaveLength(3)
+  })
+})
+
+describe('fixing and formatting', () => {
+  const FIXED = 'const x = 1\n'
+
+  it('offers source.fixAll.pickier, the code action codeActionsOnSave asks for', async () => {
+    const file = document(`${ROOT}/x.ts`, 'let x = 1\n')
+    const { codeActionProviders, spawned } = setup({ worker: { answer: request => request.op === 'fix' ? { op: 'fix', text: FIXED } : { op: 'lint', issues: [] } } })
+
+    const only = CodeActionKind.SourceFixAll.append('pickier')
+    const [action] = await codeActionProviders[0].provideCodeActions(file, undefined, { only, diagnostics: [] })
+
+    expect(action.kind.value).toBe('source.fixAll.pickier')
+    expect(action.edit.edits[0].text).toBe(FIXED)
+    expect(spawned[0]!.requests.at(-1)!.op).toBe('fix')
+
+    // The generic `source.fixAll` includes it too.
+    const generic = await codeActionProviders[0].provideCodeActions(file, undefined, { only: CodeActionKind.SourceFixAll, diagnostics: [] })
+    expect(generic).toHaveLength(1)
+  })
+
+  it('offers nothing when there is nothing to fix, or the project\'s pickier cannot fix text', async () => {
+    const file = document(`${ROOT}/x.ts`, FIXED)
+    const unchanged = setup({ worker: { answer: request => ({ op: request.op as 'fix', text: FIXED }) } })
+    expect(await unchanged.codeActionProviders[0].provideCodeActions(file, undefined, { only: CodeActionKind.SourceFixAll, diagnostics: [] })).toEqual([])
+
+    const old = setup({ worker: { fixText: false } })
+    expect(await old.codeActionProviders[0].provideCodeActions(document(`${ROOT}/x.ts`, 'let x = 1\n'), undefined, { only: CodeActionKind.SourceFixAll, diagnostics: [] })).toEqual([])
+  })
+
+  it('offers quick fixes for its own diagnostics: fix all, and disable the rule for the line', async () => {
+    const file = document(`${ROOT}/x.ts`, 'function f() {\n  let x = 1\n}\n')
+    const { codeActionProviders } = setup({ worker: { answer: request => request.op === 'fix' ? { op: 'fix', text: 'function f() {\n  const x = 1\n}\n' } : { op: 'lint', issues: [] } } })
+    const diagnostic = { source: 'pickier', code: 'prefer-const', range: { start: { line: 1, character: 6 } } }
+
+    const actions = await codeActionProviders[0].provideCodeActions(file, undefined, { diagnostics: [diagnostic, { source: 'ts', code: 1 }] })
+
+    expect(actions.map((action: any) => action.title)).toEqual(['Fix all pickier problems', 'Disable prefer-const for this line'])
+    expect(actions[1].edit.edits[0]).toMatchObject({ position: { line: 1, character: 0 }, text: '  // pickier-disable-next-line prefer-const\n' })
+  })
+
+  it('formats with the project\'s pickier', async () => {
+    const file = document(`${ROOT}/x.ts`, 'const a = "x"\n')
+    const { formatters } = setup({ worker: { answer: request => request.op === 'format' ? { op: 'format', text: 'const a = \'x\'\n' } : { op: 'lint', issues: [] } } })
+
+    const [edit] = await formatters[0].provideDocumentFormattingEdits(file)
+    expect(edit.newText).toBe('const a = \'x\'\n')
+  })
+
+  it('applies the fixes to the active file from the command palette', async () => {
+    const file = document(`${ROOT}/x.ts`, 'let x = 1\n')
+    const fake = setup({ worker: { answer: request => request.op === 'fix' ? { op: 'fix', text: FIXED } : { op: 'lint', issues: [] } } })
+    fake.api.window.activeTextEditor = { document: file }
+
+    await fake.handlers.get('stacks.pickier.fixAll')!()
+    expect(fake.applied[0]!.edits[0]!.text).toBe(FIXED)
+  })
+})

package/ide/vscode/tsconfig.json

@@ -7,7 +7,7 @@
     "lib": ["es2022"],
     "module": "esnext",
     "moduleResolution": "bundler",
-    "types": ["bun"],
+    "types": ["bun", "vscode"],
     "strict": true,
     "noUncheckedIndexedAccess": true,
     "noEmit": true,
@@ -15,5 +15,5 @@
     "isolatedModules": true,
     "verbatimModuleSyntax": true
   },
-  "include": ["src/**/*.ts", "tests/**/*.ts"]
+  "include": ["src/**/*.ts", "scripts/**/*.ts", "tests/**/*.ts"]
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.41",
+  "version": "0.75.43",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -55,7 +55,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "^0.75.41",
+    "@stacksjs/mobile": "^0.75.43",
     "@stacksjs/sanitizer": "^0.2.348",
     "ts-qr-codes": "^0.1.8"
   }

package/resources/components/Dashboard/Content/FileManagerDashboard.stx

@@ -12,6 +12,8 @@ interface FileItem {
   mime_type?: string
   url?: string
   thumbnail?: string
+  preview?: string
+  previewText?: string
   starred: false
   shared: boolean
   items?: FileItem[]

package/resources/components/Dashboard/FileViewer/MediaCard.stx

@@ -7,6 +7,10 @@ interface FileItem {
   mime_type?: string
   url?: string
   thumbnail?: string
+  /** A generated preview image (stacksjs/stacks#308): a scaled photo, a waveform, a font specimen. */
+  preview?: string
+  /** The first lines of a text file, shown as text rather than an image. */
+  previewText?: string
 }
 
 const EMPTY_ITEM: FileItem = {
@@ -49,8 +53,14 @@ function kindOf(value: FileItem): string {
 
 const kind = derived(() => kindOf(currentItem()))
 const extension = derived(() => (currentItem().type || '').toUpperCase())
-const previewUrl = derived(() => currentItem().thumbnail || currentItem().url || '')
-const hasImage = derived(() => kind() === 'image' && Boolean(previewUrl()))
+// The generated preview wins over the original: it is a small PNG for any kind
+// that could be drawn, where the original may be a 40 MB photo or not an image
+// at all. Only an image falls back to the original, because only an image can
+// be shown by pointing an <img> at it.
+const previewUrl = derived(() => currentItem().preview || (kind() === 'image' ? currentItem().thumbnail || currentItem().url || '' : ''))
+const hasImage = derived(() => Boolean(previewUrl()))
+const hasText = derived(() => !hasImage() && Boolean(currentItem().previewText))
+const imageClass = derived(() => currentItem().preview && kind() !== 'image' ? 'object-contain h-full w-full' : 'object-cover h-full w-full')
 
 const backdropByKind: Record<string, string> = {
   image: 'bg-gradient-to-br from-sky-50 to-indigo-100 dark:from-neutral-800 dark:to-neutral-900',
@@ -79,7 +89,8 @@ const badgeClass = derived(() => kind() === 'video'
 
 <div class="flex flex-col">
   <div :class="previewClass()">
-    <img :if="hasImage()" :src="previewUrl()" :alt="currentItem().name" loading="lazy" class="object-cover h-full w-full" />
+    <img :if="hasImage()" :src="previewUrl()" :alt="currentItem().name" loading="lazy" :class="imageClass()" />
+    <pre :else-if="hasText()" class="absolute inset-0 overflow-hidden m-0 pb-2 pt-7 px-3 font-mono leading-[1.35] text-[9px] text-left text-stone-600 whitespace-pre dark:text-neutral-300 bg-white/80 dark:bg-neutral-900/60">{{ currentItem().previewText }}</pre>
     <div :else-if="kind() === 'video'" class="flex items-center justify-center h-12 w-12 bg-white/90 rounded-full shadow-md"><span class="ml-0.5 h-5 w-5 text-neutral-900 i-hugeicons-play"></span></div>
     <span :else :class="glyphClass()"></span>
     <span :if="currentItem().type !== 'folder' && extension()" :class="badgeClass()">{{ extension() }}</span>

package/routes/auth.ts

@@ -104,6 +104,10 @@ route.group({ middleware: 'auth' }, () => {
   route.get('/referrals', 'Actions/Auth/ReferralSummaryAction').rateLimit(60, 'minute')
   route.post('/referrals/code', 'Actions/Auth/CreateReferralCodeAction').rateLimit(10, 'minute')
   route.get('/me', 'Actions/Auth/AuthUserAction')
+  // The caller's own personal data as a JSON download (GDPR access and
+  // portability, stacksjs/stacks#365). Reads every table the user touches,
+  // so it is held to a few an hour; each one is recorded in gdpr_requests.
+  route.get('/me/data-export', 'Actions/Auth/DataExportAction').rateLimit(3, 'hour')
   route.post('/logout', 'Actions/Auth/LogoutAction')
   // Sign out everywhere: revoke every access/refresh token AND destroy
   // every session for the authenticated user (stacksjs/stacks#1957).

package/vcs/github/workflows/buddy-bot.yml

@@ -83,9 +83,9 @@ jobs:
           persist-credentials: true
 
       - name: Setup Pantry
-        uses: pantry-pm/pantry/packages/action@bc2f37441f1a7ed160c201bbe6e0552b81ca931e # v0.11.65
+        uses: pantry-pm/pantry/packages/action@00f7f8d0f4b166db35d2e1405fdcefd442acd775 # v0.11.68
         with:
-          version: '0.11.65'
+          version: '0.11.68'
           install: 'false'
 
       - name: Install Dependencies

package/vcs/github/workflows/ci.yml

@@ -30,7 +30,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Setup Pantry
-        uses: pantry-pm/pantry/packages/action@bc2f37441f1a7ed160c201bbe6e0552b81ca931e # v0.11.65
+        uses: pantry-pm/pantry/packages/action@00f7f8d0f4b166db35d2e1405fdcefd442acd775 # v0.11.68
         with:
           install: 'false'
 
@@ -63,7 +63,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Setup Pantry
-        uses: pantry-pm/pantry/packages/action@bc2f37441f1a7ed160c201bbe6e0552b81ca931e # v0.11.65
+        uses: pantry-pm/pantry/packages/action@00f7f8d0f4b166db35d2e1405fdcefd442acd775 # v0.11.68
         with:
           install: 'false'
 
@@ -99,7 +99,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Setup Pantry
-        uses: pantry-pm/pantry/packages/action@bc2f37441f1a7ed160c201bbe6e0552b81ca931e # v0.11.65
+        uses: pantry-pm/pantry/packages/action@00f7f8d0f4b166db35d2e1405fdcefd442acd775 # v0.11.68
         with:
           install: 'false'
 

package/vcs/github/workflows/release.yml

@@ -21,7 +21,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Pantry
-        uses: pantry-pm/pantry/packages/action@bc2f37441f1a7ed160c201bbe6e0552b81ca931e # v0.11.65
+        uses: pantry-pm/pantry/packages/action@00f7f8d0f4b166db35d2e1405fdcefd442acd775 # v0.11.68
         with:
           install: 'false'
 

package/ide/vscode/src/vscode.d.ts

@@ -1,181 +0,0 @@
-/**
- * The slice of the VS Code extension API this extension uses.
- *
- * `@types/vscode` is the complete declaration, but it would be the only
- * dependency of a package that otherwise has none, and the extension calls a
- * couple of dozen members. The names and signatures below are copied from
- * `@types/vscode` (engine ^1.93 for the terminal shell-integration API), so
- * swapping this file for the real package later is a deletion, not a rewrite.
- */
-declare module 'vscode' {
-  export interface Disposable {
-    dispose: () => unknown
-  }
-
-  export type Event<T> = (listener: (event: T) => unknown) => Disposable
-
-  export class Uri {
-    static parse(value: string): Uri
-    static file(path: string): Uri
-    readonly scheme: string
-    readonly authority: string
-    readonly path: string
-    readonly fsPath: string
-    toString(skipEncoding?: boolean): string
-  }
-
-  export enum ViewColumn {
-    Active = -1,
-    Beside = -2,
-    One = 1,
-  }
-
-  export enum StatusBarAlignment {
-    Left = 1,
-    Right = 2,
-  }
-
-  export interface ExtensionContext {
-    readonly subscriptions: Disposable[]
-  }
-
-  export interface WorkspaceFolder {
-    readonly uri: Uri
-    readonly name: string
-    readonly index: number
-  }
-
-  export interface WorkspaceConfiguration {
-    get: <T>(section: string, defaultValue: T) => T
-  }
-
-  export interface ConfigurationChangeEvent {
-    affectsConfiguration: (section: string) => boolean
-  }
-
-  export interface FileSystemWatcher extends Disposable {
-    readonly onDidCreate: Event<Uri>
-    readonly onDidChange: Event<Uri>
-    readonly onDidDelete: Event<Uri>
-  }
-
-  export interface TerminalOptions {
-    name?: string
-    cwd?: string | Uri
-    env?: Record<string, string | null | undefined>
-  }
-
-  export interface TerminalExitStatus {
-    readonly code: number | undefined
-  }
-
-  export interface TerminalShellExecution {
-    read: () => AsyncIterable<string>
-  }
-
-  export interface TerminalShellIntegration {
-    executeCommand: (commandLine: string) => TerminalShellExecution
-  }
-
-  export interface Terminal {
-    readonly name: string
-    readonly exitStatus: TerminalExitStatus | undefined
-    readonly shellIntegration: TerminalShellIntegration | undefined
-    show: (preserveFocus?: boolean) => void
-    sendText: (text: string, shouldExecute?: boolean) => void
-    dispose: () => void
-  }
-
-  export interface TerminalShellIntegrationChangeEvent {
-    readonly terminal: Terminal
-    readonly shellIntegration: TerminalShellIntegration
-  }
-
-  export interface TerminalShellExecutionEndEvent {
-    readonly terminal: Terminal
-    readonly execution: TerminalShellExecution
-    readonly exitCode: number | undefined
-  }
-
-  export interface StatusBarItem {
-    text: string
-    tooltip: string | undefined
-    command: string | undefined
-    name: string | undefined
-    show: () => void
-    hide: () => void
-    dispose: () => void
-  }
-
-  export interface QuickPickItem {
-    label: string
-    description?: string
-    detail?: string
-    alwaysShow?: boolean
-  }
-
-  export interface QuickPick<T extends QuickPickItem> extends Disposable {
-    value: string
-    title: string | undefined
-    placeholder: string | undefined
-    items: readonly T[]
-    readonly selectedItems: readonly T[]
-    busy: boolean
-    matchOnDescription: boolean
-    readonly onDidChangeValue: Event<string>
-    readonly onDidAccept: Event<void>
-    readonly onDidHide: Event<void>
-    show: () => void
-    hide: () => void
-  }
-
-  export interface InputBoxOptions {
-    title?: string
-    prompt?: string
-    placeHolder?: string
-    value?: string
-    ignoreFocusOut?: boolean
-    validateInput?: (value: string) => string | undefined | null
-  }
-
-  export interface TextDocument {
-    readonly uri: Uri
-  }
-
-  export interface TextEditor {
-    readonly document: TextDocument
-  }
-
-  export namespace window {
-    export const activeTextEditor: TextEditor | undefined
-    export const terminals: readonly Terminal[]
-    export const onDidCloseTerminal: Event<Terminal>
-    export const onDidChangeTerminalShellIntegration: Event<TerminalShellIntegrationChangeEvent>
-    export const onDidEndTerminalShellExecution: Event<TerminalShellExecutionEndEvent>
-    export function createTerminal(options: TerminalOptions): Terminal
-    export function createStatusBarItem(id: string, alignment?: StatusBarAlignment, priority?: number): StatusBarItem
-    export function createQuickPick<T extends QuickPickItem>(): QuickPick<T>
-    export function showInputBox(options?: InputBoxOptions): PromiseLike<string | undefined>
-    export function showInformationMessage<T extends string>(message: string, ...items: T[]): PromiseLike<T | undefined>
-    export function showWarningMessage<T extends string>(message: string, ...items: T[]): PromiseLike<T | undefined>
-    export function showErrorMessage<T extends string>(message: string, ...items: T[]): PromiseLike<T | undefined>
-  }
-
-  export namespace workspace {
-    export const workspaceFolders: readonly WorkspaceFolder[] | undefined
-    export const onDidChangeConfiguration: Event<ConfigurationChangeEvent>
-    export function getConfiguration(section?: string): WorkspaceConfiguration
-    export function getWorkspaceFolder(uri: Uri): WorkspaceFolder | undefined
-    export function createFileSystemWatcher(globPattern: string): FileSystemWatcher
-  }
-
-  export namespace commands {
-    export function registerCommand(command: string, callback: (...args: any[]) => any): Disposable
-    export function executeCommand<T = unknown>(command: string, ...rest: any[]): PromiseLike<T>
-  }
-
-  export namespace env {
-    export function asExternalUri(target: Uri): PromiseLike<Uri>
-    export function openExternal(target: Uri): PromiseLike<boolean>
-  }
-}