@inkbar/svelte 0.8.0 → 0.10.0

package/dist/components/InkPrintButton.svelte

@@ -0,0 +1,57 @@
+<script lang="ts" module>
+  import type { ChildSnippet } from './child-snippet.js'
+  import type { Snippet } from 'svelte'
+  import type { HTMLButtonAttributes } from 'svelte/elements'
+
+  export interface InkPrintButtonProps extends Omit<HTMLButtonAttributes, 'children'> {
+    children?: Snippet | undefined
+    /** Render your own button: spread `props` on it. */
+    child?: ChildSnippet | undefined
+  }
+</script>
+
+<script lang="ts">
+  /*
+   * Prints the open document's file with the browser's own PDF viewer (on iOS, in a new
+   * tab). Disabled until the document is ready. Today that is the file as it was opened,
+   * without this session's annotations.
+   */
+  import { printDocument } from '@inkbar/core/dom'
+  import { Printer } from '@inkbar/icons'
+  import { Toolbar } from 'bits-ui'
+
+  import { useInkContext } from '../context.js'
+
+  import { asBitsProps } from './child-snippet.js'
+  import InkIcon from './InkIcon.svelte'
+
+  let {
+    class: className,
+    children,
+    child,
+    disabled,
+    onclick,
+    ...rest
+  }: InkPrintButtonProps = $props()
+
+  const ctx = useInkContext('InkPrintButton')
+  const ready = $derived(ctx.document !== null && ctx.status.state === 'ready')
+</script>
+
+<Toolbar.Button
+  class={['ink-print', className]}
+  data-ink-print=""
+  aria-label="Print"
+  title="Print"
+  disabled={!ready || !!disabled}
+  {...child ? { child } : {}}
+  {...asBitsProps(rest)}
+  onclick={(e) => {
+    onclick?.(e)
+    const doc = ctx.document
+    if (e.defaultPrevented || !doc) return
+    void printDocument(doc).catch(() => undefined)
+  }}
+>
+  {#if children}{@render children()}{:else}<InkIcon icon={Printer} />{/if}
+</Toolbar.Button>

package/dist/components/InkPrintButton.svelte.d.ts

@@ -0,0 +1,12 @@
+import type { ChildSnippet } from './child-snippet.js';
+import type { Snippet } from 'svelte';
+import type { HTMLButtonAttributes } from 'svelte/elements';
+export interface InkPrintButtonProps extends Omit<HTMLButtonAttributes, 'children'> {
+    children?: Snippet | undefined;
+    /** Render your own button: spread `props` on it. */
+    child?: ChildSnippet | undefined;
+}
+declare const InkPrintButton: import("svelte").Component<InkPrintButtonProps, {}, "">;
+type InkPrintButton = ReturnType<typeof InkPrintButton>;
+export default InkPrintButton;
+//# sourceMappingURL=InkPrintButton.svelte.d.ts.map

package/dist/components/InkPrintButton.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkPrintButton.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkPrintButton.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE3D,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC;IACjF,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,oDAAoD;IACpD,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CACjC;AAsDH,QAAA,MAAM,cAAc,yDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/InkRecordList.svelte

@@ -0,0 +1,91 @@
+<script module lang="ts">
+  import type { RecordBase } from '@inkbar/core'
+  import type { CardSpec, RecordListSource } from '@inkbar/core/dom'
+  import type { Snippet } from 'svelte'
+  import type { HTMLAttributes } from 'svelte/elements'
+
+  export interface InkRecordListProps<
+    T extends RecordBase & { page: number } = RecordBase & { page: number },
+  > extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** The records to list, as `<plugin>.<name>`. */
+    records?: string | undefined
+    /**
+     * A host's own source, listed in place of `records` with the same controller and cards.
+     * `card`, `where` and `sort` do not apply to it.
+     */
+    source?: RecordListSource | undefined
+    /** The card each record shows. Default: its mark's card. */
+    card?: ((record: T) => CardSpec) | undefined
+    /** Which records to list. Default: those that have a mark. */
+    where?: ((record: T) => boolean) | undefined
+    /** The order. Default: reading order by the marks' rects. */
+    sort?: ((a: T, b: T) => number) | undefined
+    /** Bindable, read-only: the number listed, from once the list has mounted. */
+    count?: number | undefined
+    /** Replaces "Nothing here yet.". */
+    empty?: Snippet | undefined
+  }
+</script>
+
+<script
+  lang="ts"
+  generics="T extends RecordBase & { page: number } = RecordBase & { page: number }"
+>
+  /*
+   * The records a plugin keeps under `records` (`<plugin>.<name>`) as a list of cards, the same
+   * cards their marks open, with the same actions: `createRecordList` on core's record list
+   * controller. The list, the marks and `useRecordSelection` share one selection. `card`, `where`
+   * and `sort` replace the marks' card, filter and reading order; a new function rebuilds the
+   * list, so pass functions defined once rather than inline. `bind:count` gives the number
+   * listed whenever it changes; the `empty` snippet replaces "Nothing here yet.". It fills its
+   * parent's height. Inside `InkRoot`; it renders empty on the server.
+   *
+   * In place of `records`, `source` takes a host's own `RecordListSource` and lists it with the
+   * same controller and cards. Give one of the two: with both, `source` wins and a development
+   * build warns.
+   */
+  import { recordsSource, type RecordsSourceOptions } from '@inkbar/core/dom'
+  import { DEV } from 'esm-env'
+
+  import { useInkContext } from '../context.js'
+  import { toReadable } from '../to-readable.svelte.js'
+
+  import RecordCards from './RecordCards.svelte'
+
+  let {
+    records,
+    source,
+    card,
+    where,
+    sort,
+    // Written, never read: the list reports its count to the host.
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    count = $bindable(),
+    empty,
+    ...rest
+  }: InkRecordListProps<T> = $props()
+
+  const ctx = useInkContext('InkRecordList')
+  const viewport = toReadable(() => ctx.viewport)
+
+  if (DEV)
+    $effect(() => {
+      if (records !== undefined && source !== undefined)
+        console.warn(
+          '[inkbar] InkRecordList takes `records` or `source`, not both: it lists `source`.'
+        )
+    })
+
+  const listed = $derived.by((): RecordListSource | null => {
+    if (source) return source
+    const pluginHost = ctx.pluginHost
+    if (!pluginHost || records === undefined) return null
+    const opts: RecordsSourceOptions<T> = {}
+    if (card) opts.card = card
+    if (where) opts.where = where
+    if (sort) opts.sort = sort
+    return recordsSource<T>({ pluginHost, viewport }, records, opts)
+  })
+</script>
+
+<RecordCards {...rest} source={listed} {empty} oncount={(n) => (count = n)} />

package/dist/components/InkRecordList.svelte.d.ts

@@ -0,0 +1,72 @@
+import type { RecordBase } from '@inkbar/core';
+import type { CardSpec, RecordListSource } from '@inkbar/core/dom';
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+export interface InkRecordListProps<T extends RecordBase & {
+    page: number;
+} = RecordBase & {
+    page: number;
+}> extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** The records to list, as `<plugin>.<name>`. */
+    records?: string | undefined;
+    /**
+     * A host's own source, listed in place of `records` with the same controller and cards.
+     * `card`, `where` and `sort` do not apply to it.
+     */
+    source?: RecordListSource | undefined;
+    /** The card each record shows. Default: its mark's card. */
+    card?: ((record: T) => CardSpec) | undefined;
+    /** Which records to list. Default: those that have a mark. */
+    where?: ((record: T) => boolean) | undefined;
+    /** The order. Default: reading order by the marks' rects. */
+    sort?: ((a: T, b: T) => number) | undefined;
+    /** Bindable, read-only: the number listed, from once the list has mounted. */
+    count?: number | undefined;
+    /** Replaces "Nothing here yet.". */
+    empty?: Snippet | undefined;
+}
+declare function $$render<T extends RecordBase & {
+    page: number;
+} = RecordBase & {
+    page: number;
+}>(): {
+    props: InkRecordListProps<T>;
+    exports: {};
+    bindings: "count";
+    slots: {};
+    events: {};
+};
+declare class __sveltets_Render<T extends RecordBase & {
+    page: number;
+} = RecordBase & {
+    page: number;
+}> {
+    props(): ReturnType<typeof $$render<T>>['props'];
+    events(): ReturnType<typeof $$render<T>>['events'];
+    slots(): ReturnType<typeof $$render<T>>['slots'];
+    bindings(): "count";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <T extends RecordBase & {
+        page: number;
+    } = RecordBase & {
+        page: number;
+    }>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<T>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<T>['props']>, ReturnType<__sveltets_Render<T>['events']>, ReturnType<__sveltets_Render<T>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<T>['bindings']>;
+    } & ReturnType<__sveltets_Render<T>['exports']>;
+    <T extends RecordBase & {
+        page: number;
+    } = RecordBase & {
+        page: number;
+    }>(internal: unknown, props: ReturnType<__sveltets_Render<T>['props']> & {}): ReturnType<__sveltets_Render<T>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const InkRecordList: $$IsomorphicComponent;
+type InkRecordList<T extends RecordBase & {
+    page: number;
+} = RecordBase & {
+    page: number;
+}> = InstanceType<typeof InkRecordList<T>>;
+export default InkRecordList;
+//# sourceMappingURL=InkRecordList.svelte.d.ts.map

package/dist/components/InkRecordList.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkRecordList.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkRecordList.svelte.ts"],"names":[],"mappings":"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"}

package/dist/components/InkRoot.svelte

@@ -59,8 +59,13 @@
     tool?: ToolId | undefined
     onToolChange?: ((tool: ToolId) => void) | undefined
     /**
-     * Host tools, added to the built-ins; one with a built-in's id replaces it. Read when a
-     * document opens.
+     * The creation tools, such as `allTools()` or a pick of the tool factories. `select-text`
+     * and `select` are always present; a tool with either id replaces it. They are read when a
+     * document opens: a tool added later is usable from the next open, one removed stops at
+     * once. When the active tool goes, the viewer switches to `select-text` and calls
+     * `onToolChange`. A controlled `tool` naming a missing tool is reported back as
+     * `select-text` and is not applied again when the tool appears later. Each mounted control
+     * for a missing tool logs its own `UnknownTool`.
      */
     tools?: Tool[] | undefined
     /**
@@ -125,6 +130,7 @@
     writable,
   } from '@inkbar/core'
   import {
+    attachFileKeys,
     attachHistoryKeys,
     createPluginHost,
     createSearchController,
@@ -136,6 +142,7 @@
     pageSelectionText,
     SIGNATURE_FONTS,
     trackToolStyle,
+    unknownTool,
     viewerSearchOf,
   } from '@inkbar/core/dom'
   import { DEV } from 'esm-env'
@@ -143,6 +150,7 @@
   import { createAttachmentKey } from 'svelte/attachments'
 
   import { setInkContext, type InkContext, type InkHistory } from '../context.js'
+  import { registeredToolIds } from '../hooks/useRegisteredTool.svelte.js'
   import { useReadable } from '../use-readable.svelte.js'
 
   import type { PluginHistory } from '@inkbar/core'
@@ -400,6 +408,11 @@
   })
 
   function setTool(id: ToolId): void {
+    // As the tool controller does: a missing tool is logged and nothing changes.
+    if (!isRegistered(id)) {
+      logUnknownTool(id)
+      return
+    }
     // Picking the active tool again starts it afresh, as after a one-shot tool's use.
     if (currentTool === id && tools?.active.get() === id) tools.set(id)
     tool = id
@@ -452,9 +465,12 @@
     const stopFocus = keepHistoryFocus(el, () =>
       el.querySelector<HTMLElement>('[data-ink-scroll]')
     )
+    // Ctrl or Cmd+P prints and +S downloads, as InkPrintButton and InkDownloadButton do.
+    const stopFileKeys = attachFileKeys(el, () => document)
     return () => {
       stopKeys()
       stopFocus()
+      stopFileKeys()
     }
   })
 
@@ -526,6 +542,32 @@
     }
   })
 
+  /*
+   * The tools are known once the plugins are set up on mount. A tool id nobody registered is
+   * logged as `UnknownTool`; as the active tool, from a `tool` prop or because it left `tools`,
+   * it falls back to `select-text`, reported through `onToolChange`. A controlled `tool` that
+   * stays on the missing id is not applied again.
+   */
+  /** The ids of the tools the current viewer was built with; InkViewport sets them. */
+  let openedToolIds = $state.raw<readonly ToolId[] | null>(null)
+  const toolIds = $derived(registeredToolIds(hostTools, pluginHost, openedToolIds))
+  const isRegistered = (id: ToolId): boolean =>
+    pluginHost === null || toolIds.includes(id)
+  /** The tool the engine and the controls see: a missing one never reaches them. */
+  const effectiveTool = $derived<ToolId>(
+    isRegistered(currentTool) ? currentTool : 'select-text'
+  )
+  const logUnknownTool = (id: ToolId): void => console.error(unknownTool(id, toolIds))
+  $effect(() => {
+    const id = currentTool
+    if (isRegistered(id)) return
+    untrack(() => {
+      logUnknownTool(id)
+      tool = 'select-text'
+      onToolChange?.('select-text')
+    })
+  })
+
   /*
    * Ctrl/Cmd+F while focus is in the root and a find bar is mounted; else the browser's. A
    * native listener: the handler reads the event's `currentTarget`, which is the root here.
@@ -551,12 +593,12 @@
         history: { batch: (fn) => inkHistory.batch(fn) },
         // The plugins' tools too, so a plugin tool's style group applies.
         tools: [...(hostTools ?? []), ...(pluginHost?.tools ?? [])],
-        tool: currentTool,
+        tool: effectiveTool,
       })
     )
   })
   $effect(() => {
-    const id = currentTool
+    const id = effectiveTool
     styleTracker?.setTool(id)
   })
 
@@ -590,12 +632,18 @@
       return tools
     },
     get tool() {
-      return currentTool
+      return effectiveTool
     },
     setTool,
     get hostTools() {
       return hostTools
     },
+    get openedToolIds() {
+      return openedToolIds
+    },
+    setOpenedToolIds(ids) {
+      openedToolIds = ids
+    },
     get decorateAnnotation() {
       return decorateAnnotation
     },

package/dist/components/InkRoot.svelte.d.ts

@@ -35,8 +35,13 @@ export interface InkRootProps extends Omit<HTMLAttributes<HTMLDivElement>, 'chil
     tool?: ToolId | undefined;
     onToolChange?: ((tool: ToolId) => void) | undefined;
     /**
-     * Host tools, added to the built-ins; one with a built-in's id replaces it. Read when a
-     * document opens.
+     * The creation tools, such as `allTools()` or a pick of the tool factories. `select-text`
+     * and `select` are always present; a tool with either id replaces it. They are read when a
+     * document opens: a tool added later is usable from the next open, one removed stops at
+     * once. When the active tool goes, the viewer switches to `select-text` and calls
+     * `onToolChange`. A controlled `tool` naming a missing tool is reported back as
+     * `select-text` and is not applied again when the tool appears later. Each mounted control
+     * for a missing tool logs its own `UnknownTool`.
      */
     tools?: Tool[] | undefined;
     /**

package/dist/components/InkRoot.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkRoot.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkRoot.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"InkRoot.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkRoot.svelte.ts"],"names":[],"mappings":"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"}

package/dist/components/InkSearchResults.svelte

@@ -0,0 +1,72 @@
+<script module lang="ts">
+  import type { HTMLAttributes } from 'svelte/elements'
+
+  export interface InkSearchResultsProps extends Omit<
+    HTMLAttributes<HTMLDivElement>,
+    'children'
+  > {
+    /** Show the query field. Default true; turn it off when a find bar is on the page. */
+    field?: boolean | undefined
+  }
+</script>
+
+<script lang="ts">
+  /*
+   * The search hits as a list of cards, for a sidebar panel: `createSearchResults` on core's
+   * record list controller over the root's search. One card per hit, with its page and the text
+   * around it. Choosing a card makes its hit current, as the find bar's next and previous do, and
+   * the current hit is the selected card. Above the cards, a query field (`field={false}`
+   * leaves it out when a find bar is on the page); under them, the find bar's match count.
+   * Field and find bar share the search state, so they never disagree. It fills its parent's
+   * height. Inside `InkRoot`; it renders empty on the server.
+   */
+  import {
+    findCountText,
+    handleResultsFieldKey,
+    isBlankQuery,
+    searchSource,
+  } from '@inkbar/core/dom'
+  import { Search } from '@inkbar/icons'
+
+  import { useInkContext } from '../context.js'
+  import { useSearch } from '../hooks/useSearch.svelte.js'
+
+  import InkIcon from './InkIcon.svelte'
+  import RecordCards from './RecordCards.svelte'
+
+  let { field = true, class: className, ...rest }: InkSearchResultsProps = $props()
+
+  const ctx = useInkContext('InkSearchResults')
+  const search = useSearch()
+  const source = $derived(ctx.search ? searchSource(ctx.search) : null)
+  // Nothing found yet is the count's to say while a query is in: "No results", or a scan.
+  const blank = $derived(isBlankQuery(search.state.query))
+</script>
+
+<div {...rest} class={['ink-search-results', className]} data-ink-search-results="">
+  {#if field}
+    <div class="ink-search-results-bar" role="search">
+      <!-- The field is the search state's: a query typed in the find bar shows here. -->
+      <div class="ink-input-group">
+        <span class="ink-input-accessory"><InkIcon icon={Search} /></span>
+        <input
+          type="text"
+          aria-label="Find in document"
+          placeholder="Search for a word or phrase"
+          autocomplete="off"
+          spellcheck={false}
+          value={search.state.query}
+          oninput={(e) => search.setQuery(e.currentTarget.value)}
+          onkeydown={(e) => handleResultsFieldKey(e, search)}
+        />
+      </div>
+    </div>
+  {/if}
+  <RecordCards {source} emptyShown={blank}>
+    {#snippet empty()}Search to list every match.{/snippet}
+  </RecordCards>
+  <!-- A footer under the cards, hidden while empty. -->
+  <div class="ink-search-results-count" data-ink-search-results-count="">
+    {findCountText(search.state)}
+  </div>
+</div>

package/dist/components/InkSearchResults.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { HTMLAttributes } from 'svelte/elements';
+export interface InkSearchResultsProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Show the query field. Default true; turn it off when a find bar is on the page. */
+    field?: boolean | undefined;
+}
+declare const InkSearchResults: import("svelte").Component<InkSearchResultsProps, {}, "">;
+type InkSearchResults = ReturnType<typeof InkSearchResults>;
+export default InkSearchResults;
+//# sourceMappingURL=InkSearchResults.svelte.d.ts.map

package/dist/components/InkSearchResults.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkSearchResults.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkSearchResults.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC5B;AAqEH,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}