deck-plugin-sdk 1.15.1 → 1.15.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deck-plugin-sdk",
-  "version": "1.15.1",
+  "version": "1.15.2",
   "description": "Build a plugin for Deck, outside the Deck repository.",
   "type": "module",
   "license": "MIT",

package/template/plugin.json

@@ -5,6 +5,6 @@
   "icon": "Sparkles",
   "color": "#a78bfa",
   "version": "0.1.0",
-  "minDeck": "1.15.1",
+  "minDeck": "1.15.2",
   "permissions": []
 }

package/types/components/ActivityBar.d.ts

@@ -11,7 +11,7 @@ export interface ActivityView<Id extends string> {
     onClick?: (el: HTMLElement) => void;
 }
 export default ActivityBar;
-export declare function ActivityBar<Id extends string>({ views, active, onSelect, trailing, grouped, }: {
+export declare function ActivityBar<Id extends string>({ views, active, onSelect, trailing, grouped, flat, }: {
     views: readonly ActivityView<Id>[];
     active: Id;
     onSelect: (id: Id) => void;
@@ -19,4 +19,6 @@ export declare function ActivityBar<Id extends string>({ views, active, onSelect
     trailing?: React.ReactNode;
     /** The icons together in one rounded group, smaller, rather than loose pills. */
     grouped?: boolean;
+    /** Plain icons, the selected one brighter and underlined, as in VS Code. */
+    flat?: boolean;
 }): import("react").JSX.Element;

package/types/core/editor/editorsettings.d.ts

@@ -9,6 +9,8 @@ export interface LanguageOverride {
 export interface EditorSettings {
     fontSize: number;
     fontFamily: string;
+    /** "normal", "500", "600" or "bold", as VS Code's editor.fontWeight. */
+    fontWeight: string;
     lineHeight: number;
     letterSpacing: number;
     fontLigatures: boolean;
@@ -68,6 +70,10 @@ export interface EditorSettings {
     treeFollowActive: boolean;
     /** The folders above what is in view stay pinned at the top of the tree while it scrolls. */
     treeStickyScroll: boolean;
+    /** A file tree row's height in px: 22 is VS Code's, 28 Deck's roomier default. */
+    treeRowHeight: number;
+    /** The sidebar's view icons (Explorer, Search, …) in a rounded group; off, plain icons as in VS Code. */
+    sidebarPills: boolean;
     /** Per-language overrides, keyed by Monaco language id ("python", "typescript"). */
     languageOverrides: Record<string, LanguageOverride>;
     formatLineLength: number;
@@ -95,6 +101,10 @@ export interface EditorSettings {
     /** The git graph's commit list, in px. Its own setting rather than `fontSize`: that is a
      *  monospace code font, and the size someone wants for code is not the one for a commit list. */
     graphFontSize: number;
+    /** The user's syntax colours: for "all" languages or one language's id, by kind (syntaxcolors.ts SYNTAX_KINDS), "#rrggbb". */
+    syntaxColors: Record<string, Record<string, string>>;
+    /** A language's control keywords, in place of its definition's list (keywordtokens.ts). */
+    controlKeywords: Record<string, string[]>;
 }
 /** The sizes the git graph offers — the Settings list and the Ctrl+wheel steps are the same. */
 export declare const GRAPH_FONT_SIZES: number[];

package/types/core/editor/keywordtokens.d.ts

@@ -0,0 +1,28 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+type Groups = Record<string, string[]>;
+type Monarch = {
+    tokenizer: Record<string, unknown[]>;
+    tokenPostfix?: string;
+} & Record<string, unknown>;
+/**
+ * The tokenizer with a case per group ahead of every keyword case ("@keywords", or a named list
+ * such as PHP's "@phpKeywords"), so a listed word takes its group's token and every other keyword
+ * stays as it was. Exported for the check.
+ */
+export declare function retag(lang: Monarch, groups: Groups): Monarch;
+/** Called when a language's tokenizer or its keyword split changes (the theme's rules follow them). */
+export declare function onGrammarChange(f: () => void): void;
+/** What a language's tokens end in (".ts", ".dart"; PHP's name them ".php" themselves). */
+export declare function grammarSuffix(languageId: string): string | undefined;
+/** A language's control keywords: the user's, else its definition's, else none. */
+export declare function controlWords(languageId: string): {
+    words: string[];
+    own: boolean;
+};
+/** Whether a language's keywords are split, so its other keywords are "Declaration keywords". */
+export declare const isSplit: (languageId: string) => boolean;
+/** The languages with a tokenizer of Monaco's, which can have their keywords split. */
+export declare const grammarLanguages: () => string[];
+/** Note a language as its definition is registered, with its keywordTokens when it lists any. */
+export declare function applyKeywordTokens(languageId: string, groups: unknown): Promise<void>;
+export {};

package/types/core/editor/lsp.d.ts

@@ -1,5 +1,6 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import { monaco } from "./monaco";
+import "./syntaxcolors";
 /** How to launch the server — passed straight to Rust, which implements the strategies. */
 interface ServerSpec {
     /** "path" | "node-module" | "exe-search" — see resolve_server() in lsp.rs. */

package/types/core/editor/lsproot.d.ts

@@ -0,0 +1,15 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/**
+ * The root found for `path` by findRoot, for the calls after a document is open (a change, a
+ * close). Before findRoot has run for its folder, the workspace, as before.
+ */
+export declare function rootForFile(path: string, workspace: string, marker: string): string;
+/**
+ * Walk up from the file's folder to the nearest one holding `marker`, stopping at the workspace.
+ * A file outside the workspace (one opened from another folder) is walked up as far as it goes:
+ * the workspace says nothing about where its project is, and starting the server there gave a PHP
+ * file in another project a server that had never seen its classes.
+ */
+export declare function findRoot(path: string, workspace: string, marker: string): Promise<string>;
+/** Whether a server's root is the workspace or a project inside it. */
+export declare const rootInside: (root: string, workspace: string) => boolean;

package/types/core/editor/monaco.d.ts

@@ -5,6 +5,12 @@ type TokenColor = {
     foreground?: string;
     fontStyle?: string;
 };
+/** Set what the user's colours are (or, with none, just rebuild the theme with them). */
+export declare function setUserTokenRules(fn?: () => TokenColor[]): void;
+/** The token names the languages added colours for. */
+export declare const extraTokenNames: () => string[];
+/** The colour the theme or a language gives `token`, before the user's: "rrggbb", or undefined. */
+export declare function tokenForeground(token: string): string | undefined;
 /**
  * Repaint the editor for a new background preset. Called by applyTheme().
  *

package/types/core/editor/semanticscope.d.ts

@@ -0,0 +1,17 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import { monaco } from "./monaco";
+export interface Legend {
+    tokenTypes: string[];
+    tokenModifiers: string[];
+}
+/** The indexes of the modifiers to keep: readonly and any a rule names after its first segment. */
+export declare function keptModifiers(legend: Legend, ruleTokens: string[]): number[];
+/** The legend Monaco is given: the server's types, the kept modifiers, then the language's id. */
+export declare function scopedLegend(legend: Legend, languageId: string, keep: number[]): Legend;
+/** The server's tokens with their modifiers renumbered to the kept ones and the language's bit set. */
+export declare function scopedData(data: Uint32Array, keep: number[]): Uint32Array;
+/** Register a language's semantic tokens with Monaco, tagged with the language. */
+export declare function registerScopedSemanticTokens(languageId: string, legend: Legend, fetch: (model: monaco.editor.ITextModel) => Promise<{
+    data?: number[];
+    resultId?: string;
+} | null>): void;

package/types/core/editor/syntaxcolors.d.ts

@@ -0,0 +1,18 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/** All languages, in the settings' map: the defaults a language's own colours override. */
+export declare const ALL = "all";
+export interface SyntaxKind {
+    key: string;
+    label: string;
+    /** Grammar tokens (they take the language's suffix) and semantic ones (they take its id). */
+    grammar: string[];
+    semantic: string[];
+}
+export declare const SYNTAX_KINDS: SyntaxKind[];
+/** The theme tokens a kind colours, for all languages or one. */
+export declare function kindTokens(kind: SyntaxKind, lang: string): string[];
+/** Where a kind's colour comes from, for a language or for all: "lang", "all" or "theme". */
+export declare function colorOf(kind: SyntaxKind, lang: string): {
+    hex: string;
+    from: "lang" | "all" | "theme";
+};