@lapis-notes/workspace 0.1.0 → 0.2.1

package/dist/plugin-management/community-presentation/model-adapter.js

@@ -0,0 +1,90 @@
+import { resolveRegistryMedia, } from "@lapis-notes/api";
+export function imageReference(media) {
+    return { ...resolveRegistryMedia(media), alt: media.alt };
+}
+function mediaItem(media) {
+    return {
+        ...media,
+        images: {
+            preview: resolveRegistryMedia(media, "preview"),
+            full: resolveRegistryMedia(media, "full"),
+            light: resolveRegistryMedia(media, "light"),
+            dark: resolveRegistryMedia(media, "dark"),
+        },
+    };
+}
+export function communityDetail(entry, detail) {
+    return {
+        entry,
+        detail: {
+            ...detail,
+            status: detail.status ?? entry.status ?? "active",
+            appearance: detail.appearance
+                ? {
+                    ...detail.appearance,
+                    logo: detail.appearance.logo
+                        ? imageReference(detail.appearance.logo)
+                        : undefined,
+                }
+                : undefined,
+            media: detail.media
+                ? {
+                    banner: detail.media.banner
+                        ? mediaItem(detail.media.banner)
+                        : undefined,
+                    overview: detail.media.overview
+                        ? mediaItem(detail.media.overview)
+                        : undefined,
+                }
+                : undefined,
+            gallery: detail.gallery?.map((item) => ({
+                ...mediaItem(item),
+                id: item.id,
+            })),
+            versions: Object.fromEntries(Object.entries(detail.versions).map(([version, release]) => [
+                version,
+                {
+                    ...release,
+                    bundle: {
+                        ...release.bundle,
+                        size: release.bundle.size ?? 0,
+                        pending: "pending" in release.bundle && release.bundle.pending === true,
+                    },
+                },
+            ])),
+        },
+    };
+}
+const statusLabels = {
+    active: "Available",
+    pending: "Coming soon",
+    deprecated: "Deprecated",
+    disabled: "Unavailable",
+    revoked: "Revoked",
+};
+export function registryStatusLabel(status = "active") {
+    return statusLabels[status] ?? titleCaseRegistryValue(status);
+}
+export function titleCaseRegistryValue(value) {
+    return value
+        .split("-")
+        .map((part) => part.toLocaleLowerCase() === "ai"
+        ? "AI"
+        : `${part.charAt(0).toLocaleUpperCase()}${part.slice(1)}`)
+        .join(" ");
+}
+export function formatRegistryBytes(size) {
+    if (!Number.isFinite(size) || size < 0)
+        return "Unknown size";
+    if (size < 1024)
+        return `${size} B`;
+    const units = ["KB", "MB", "GB"];
+    let value = size / 1024;
+    for (const unit of units) {
+        if (value < 1024 || unit === units.at(-1)) {
+            return `${value >= 10 ? value.toFixed(0) : value.toFixed(1)} ${unit}`;
+        }
+        value /= 1024;
+    }
+    return `${size} B`;
+}

package/dist/plugin-management/community-presentation/model.d.ts

@@ -0,0 +1,9 @@
+export declare const COMMUNITY_CHIP_VARIANTS: readonly ["outline", "muted", "solid", "subtle"];
+export type CommunityChipVariant = (typeof COMMUNITY_CHIP_VARIANTS)[number];
+export declare const COMMUNITY_CHIP_TONES: readonly ["neutral", "accent", "success", "warning", "danger"];
+export type CommunityChipTone = (typeof COMMUNITY_CHIP_TONES)[number];
+export declare const COMMUNITY_CHIP_SIZES: readonly ["indicator", "inline", "compact", "default"];
+export type CommunityChipSize = (typeof COMMUNITY_CHIP_SIZES)[number];
+export declare const COMMUNITY_CHIP_SHAPES: readonly ["pill", "square"];
+export type CommunityChipShape = (typeof COMMUNITY_CHIP_SHAPES)[number];
+export declare function communityChipToneForState(state: string): CommunityChipTone;

package/dist/plugin-management/community-presentation/model.js

@@ -0,0 +1,40 @@
+export const COMMUNITY_CHIP_VARIANTS = [
+    "outline",
+    "muted",
+    "solid",
+    "subtle",
+];
+export const COMMUNITY_CHIP_TONES = [
+    "neutral",
+    "accent",
+    "success",
+    "warning",
+    "danger",
+];
+export const COMMUNITY_CHIP_SIZES = [
+    "indicator",
+    "inline",
+    "compact",
+    "default",
+];
+export const COMMUNITY_CHIP_SHAPES = ["pill", "square"];
+const successfulStates = new Set(["active", "approved", "available", "signed"]);
+const warningStates = new Set(["inspecting", "partial", "pending"]);
+const dangerousStates = new Set([
+    "disabled",
+    "invalid",
+    "rejected",
+    "revoked",
+    "unavailable",
+    "untrusted",
+    "withdrawn",
+]);
+export function communityChipToneForState(state) {
+    if (successfulStates.has(state))
+        return "success";
+    if (warningStates.has(state))
+        return "warning";
+    if (dangerousStates.has(state))
+        return "danger";
+    return "neutral";
+}

package/dist/plugin-management/community-presentation/props.d.ts

@@ -0,0 +1,21 @@
+import type { Snippet } from "svelte";
+import type { HTMLAnchorAttributes, HTMLButtonAttributes } from "svelte/elements";
+import type { CommunityChipShape, CommunityChipSize, CommunityChipTone, CommunityChipVariant } from "./model.js";
+export type CommunityChipProps = {
+    children: Snippet;
+    leading?: Snippet;
+    variant?: CommunityChipVariant;
+    tone?: CommunityChipTone;
+    size?: CommunityChipSize;
+    shape?: CommunityChipShape;
+    href?: string;
+    onclick?: (event: MouseEvent) => void;
+    buttonProps?: HTMLButtonAttributes;
+    linkProps?: HTMLAnchorAttributes;
+    disabled?: boolean;
+    pressed?: boolean;
+    ariaLabel?: string;
+    ariaHidden?: boolean;
+    title?: string;
+    class?: string;
+};

package/dist/plugin-management/community-presentation/props.js

@@ -0,0 +1 @@
+export {};

package/dist/plugin-management/community-presentation/registry-filter-icons.d.ts

@@ -0,0 +1,3 @@
+import type { Component } from "svelte";
+export declare const registryFilterIcons: Record<string, Component>;
+export declare function registryFilterIcon(value: string): Component;

package/dist/plugin-management/community-presentation/registry-filter-icons.js

@@ -0,0 +1,70 @@
+import RefreshCwIcon from "@lucide/svelte/icons/refresh-cw";
+import BotIcon from "@lucide/svelte/icons/bot";
+import Clock3Icon from "@lucide/svelte/icons/clock-3";
+import CloudUploadIcon from "@lucide/svelte/icons/cloud-upload";
+import CompassIcon from "@lucide/svelte/icons/compass";
+import FileCode2Icon from "@lucide/svelte/icons/file-code-2";
+import HistoryIcon from "@lucide/svelte/icons/history";
+import SmartphoneIcon from "@lucide/svelte/icons/smartphone";
+import BadgeCheckIcon from "@lucide/svelte/icons/badge-check";
+import BlocksIcon from "@lucide/svelte/icons/blocks";
+import CircleOffIcon from "@lucide/svelte/icons/circle-off";
+import DatabaseIcon from "@lucide/svelte/icons/database";
+import FileTextIcon from "@lucide/svelte/icons/file-text";
+import GlobeIcon from "@lucide/svelte/icons/globe";
+import LayoutDashboardIcon from "@lucide/svelte/icons/layout-dashboard";
+import MonitorIcon from "@lucide/svelte/icons/monitor";
+import NetworkIcon from "@lucide/svelte/icons/network";
+import NotebookTabsIcon from "@lucide/svelte/icons/notebook-tabs";
+import PackageIcon from "@lucide/svelte/icons/package";
+import PencilIcon from "@lucide/svelte/icons/pencil";
+import PresentationIcon from "@lucide/svelte/icons/presentation";
+import SearchIcon from "@lucide/svelte/icons/search";
+import ShieldCheckIcon from "@lucide/svelte/icons/shield-check";
+import SlidersHorizontalIcon from "@lucide/svelte/icons/sliders-horizontal";
+import SquareDashedMousePointerIcon from "@lucide/svelte/icons/square-dashed-mouse-pointer";
+import TriangleAlertIcon from "@lucide/svelte/icons/triangle-alert";
+import WrenchIcon from "@lucide/svelte/icons/wrench";
+import ZapIcon from "@lucide/svelte/icons/zap";
+export const registryFilterIcons = {
+    ai: BotIcon,
+    updates: RefreshCwIcon,
+    active: BadgeCheckIcon,
+    all: SlidersHorizontalIcon,
+    automation: ZapIcon,
+    backup: CloudUploadIcon,
+    canvas: SquareDashedMousePointerIcon,
+    data: DatabaseIcon,
+    database: DatabaseIcon,
+    deprecated: TriangleAlertIcon,
+    desktop: MonitorIcon,
+    "developer-tools": WrenchIcon,
+    diagnostics: SlidersHorizontalIcon,
+    disabled: CircleOffIcon,
+    documents: FileTextIcon,
+    editor: PencilIcon,
+    export: FileTextIcon,
+    graph: NetworkIcon,
+    history: HistoryIcon,
+    knowledge: NetworkIcon,
+    markdown: FileCode2Icon,
+    mobile: SmartphoneIcon,
+    navigation: CompassIcon,
+    notebook: NotebookTabsIcon,
+    official: ShieldCheckIcon,
+    organization: LayoutDashboardIcon,
+    package: PackageIcon,
+    pending: Clock3Icon,
+    presentation: PresentationIcon,
+    productivity: ZapIcon,
+    revoked: ShieldCheckIcon,
+    search: SearchIcon,
+    themes: BlocksIcon,
+    verified: BadgeCheckIcon,
+    viewer: FileTextIcon,
+    visualization: NetworkIcon,
+    web: GlobeIcon,
+};
+export function registryFilterIcon(value) {
+    return registryFilterIcons[value.toLocaleLowerCase()] ?? PackageIcon;
+}

package/dist/plugin-management/community-presentation/registry-markdown.d.ts

@@ -0,0 +1 @@
+export declare function renderRegistryMarkdown(markdown: string): string;

package/dist/plugin-management/community-presentation/registry-markdown.js

@@ -0,0 +1,57 @@
+function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+function renderInline(value) {
+    return escapeHtml(value)
+        .replace(/`([^`]+)`/gu, "<code>$1</code>")
+        .replace(/\*\*([^*]+)\*\*/gu, "<strong>$1</strong>")
+        .replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/gu, (_match, label, url) => `<a href="${url}" target="_blank" rel="noopener noreferrer">${label}</a>`);
+}
+export function renderRegistryMarkdown(markdown) {
+    const output = [];
+    const paragraphs = [];
+    const listItems = [];
+    const flushParagraph = () => {
+        if (paragraphs.length === 0)
+            return;
+        output.push(`<p>${renderInline(paragraphs.join(" "))}</p>`);
+        paragraphs.length = 0;
+    };
+    const flushList = () => {
+        if (listItems.length === 0)
+            return;
+        output.push(`<ul>${listItems.map((item) => `<li>${renderInline(item)}</li>`).join("")}</ul>`);
+        listItems.length = 0;
+    };
+    for (const line of markdown.replaceAll("\r\n", "\n").split("\n")) {
+        const heading = /^(#{1,3})\s+(.+)$/u.exec(line);
+        if (heading) {
+            flushParagraph();
+            flushList();
+            const level = heading[1].length;
+            output.push(`<h${level}>${renderInline(heading[2])}</h${level}>`);
+            continue;
+        }
+        if (line.startsWith("- ")) {
+            flushParagraph();
+            listItems.push(line.slice(2));
+            continue;
+        }
+        if (line.trim() === "") {
+            flushParagraph();
+            flushList();
+        }
+        else {
+            flushList();
+            paragraphs.push(line.trim());
+        }
+    }
+    flushParagraph();
+    flushList();
+    return output.join("\n");
+}

package/dist/plugin-management/community-presentation/registry-plugin-icons.d.ts

@@ -0,0 +1,2 @@
+import type { Component } from "svelte";
+export declare function registryPluginIcon(value: string | undefined): Component;

package/dist/plugin-management/community-presentation/registry-plugin-icons.js

@@ -0,0 +1,31 @@
+import BookmarkIcon from "@lucide/svelte/icons/bookmark";
+import FileCodeIcon from "@lucide/svelte/icons/file-code-2";
+import FileTextIcon from "@lucide/svelte/icons/file-text";
+import HistoryIcon from "@lucide/svelte/icons/history";
+import ListChecksIcon from "@lucide/svelte/icons/list-checks";
+import NetworkIcon from "@lucide/svelte/icons/network";
+import PackageIcon from "@lucide/svelte/icons/package";
+import PresentationIcon from "@lucide/svelte/icons/presentation";
+import SearchIcon from "@lucide/svelte/icons/search";
+import SparklesIcon from "@lucide/svelte/icons/sparkles";
+import SpellCheckIcon from "@lucide/svelte/icons/spell-check-2";
+import TableIcon from "@lucide/svelte/icons/table-2";
+import WholeWordIcon from "@lucide/svelte/icons/whole-word";
+const registryPluginIcons = {
+    bookmark: BookmarkIcon,
+    "file-code-2": FileCodeIcon,
+    "file-text": FileTextIcon,
+    history: HistoryIcon,
+    "list-checks": ListChecksIcon,
+    network: NetworkIcon,
+    package: PackageIcon,
+    presentation: PresentationIcon,
+    search: SearchIcon,
+    sparkles: SparklesIcon,
+    "spell-check-2": SpellCheckIcon,
+    "table-2": TableIcon,
+    "whole-word": WholeWordIcon,
+};
+export function registryPluginIcon(value) {
+    return registryPluginIcons[value?.toLocaleLowerCase() ?? ""] ?? PackageIcon;
+}

package/dist/plugin-management/plugin-browser-model.d.ts

@@ -0,0 +1,44 @@
+import type { PluginCatalogEntry } from "@lapis-notes/api";
+export type PluginBrowserRoute = {
+    page: "landing" | "directory";
+} | {
+    page: "plugin";
+    pluginId: string;
+    version?: string;
+};
+export interface PluginDirectoryState {
+    query: string;
+    categories: string[];
+    platforms: string[];
+    statuses: string[];
+    officialOnly: boolean;
+    updatesOnly: boolean;
+    installation: "all" | "installed" | "available";
+    sort: string;
+    view: "grid" | "list";
+}
+export declare const defaultDirectoryState: () => PluginDirectoryState;
+import { titleCaseRegistryValue as titleCase } from "./community-presentation/model-adapter";
+export { titleCase };
+export declare function categoriesFor(plugins: readonly PluginCatalogEntry[]): {
+    id: string;
+    count: number;
+    label: string;
+}[];
+/** Community's existing landing selection rules; no separate popularity data. */
+export declare function landingSections(plugins: readonly PluginCatalogEntry[], updateIds?: ReadonlySet<string>): {
+    featured: PluginCatalogEntry[];
+    newlyReleased: PluginCatalogEntry[];
+    recentlyUpdated: PluginCatalogEntry[];
+    updates: PluginCatalogEntry[];
+    categories: {
+        id: string;
+        count: number;
+        label: string;
+    }[];
+};
+export declare function filterPlugins(plugins: readonly PluginCatalogEntry[], state: PluginDirectoryState, installed: Set<string>, downloads?: (id: string) => number, updateIds?: ReadonlySet<string>): PluginCatalogEntry[];
+export declare function restoreBrowserState(value: Record<string, unknown>): {
+    route: PluginBrowserRoute;
+    directory: PluginDirectoryState;
+};

package/dist/plugin-management/plugin-browser-model.js

@@ -0,0 +1,104 @@
+export const defaultDirectoryState = () => ({
+    query: "",
+    categories: [],
+    platforms: [],
+    statuses: [],
+    officialOnly: false,
+    updatesOnly: false,
+    installation: "all",
+    sort: "name",
+    view: "grid",
+});
+import { titleCaseRegistryValue as titleCase } from "./community-presentation/model-adapter";
+export { titleCase };
+const compareName = (a, b) => a.name.localeCompare(b.name) || a.id.localeCompare(b.id);
+const compareDate = (a, b) => (b.latestRelease?.releasedAt ?? "").localeCompare(a.latestRelease?.releasedAt ?? "") || compareName(a, b);
+export function categoriesFor(plugins) {
+    const counts = new Map();
+    for (const plugin of plugins)
+        for (const category of plugin.categories)
+            counts.set(category, (counts.get(category) ?? 0) + 1);
+    return [...counts]
+        .map(([id, count]) => ({ id, count, label: titleCase(id) }))
+        .sort((a, b) => a.label.localeCompare(b.label) || a.id.localeCompare(b.id));
+}
+/** Community's existing landing selection rules; no separate popularity data. */
+export function landingSections(plugins, updateIds = new Set()) {
+    return {
+        featured: plugins
+            .filter((p) => (p.status ?? "active") === "active")
+            .sort(compareName)
+            .slice(0, 5),
+        newlyReleased: [...plugins].sort(compareDate).slice(0, 5),
+        recentlyUpdated: [...plugins].sort(compareDate).slice(0, 5),
+        updates: plugins
+            .filter((plugin) => updateIds.has(plugin.id))
+            .sort(compareName),
+        categories: categoriesFor(plugins).slice(0, 8),
+    };
+}
+export function filterPlugins(plugins, state, installed, downloads = () => 0, updateIds = new Set()) {
+    const text = state.query.trim().toLowerCase();
+    return plugins
+        .filter((p) => (!text ||
+        `${p.name} ${p.id} ${p.description} ${p.author}`
+            .toLowerCase()
+            .includes(text)) &&
+        (!state.categories.length ||
+            p.categories.some((c) => state.categories.includes(c))) &&
+        (!state.platforms.length ||
+            p.platforms.some((v) => state.platforms.includes(v))) &&
+        (!state.statuses.length ||
+            state.statuses.includes(p.status ?? "active")) &&
+        (!state.officialOnly || p.channel === "official") &&
+        (!state.updatesOnly || updateIds.has(p.id)) &&
+        (state.installation === "all" ||
+            installed.has(p.id) === (state.installation === "installed")))
+        .sort(state.sort === "downloads"
+        ? (a, b) => downloads(b.id) - downloads(a.id) || compareName(a, b)
+        : ["new", "updated"].includes(state.sort)
+            ? compareDate
+            : state.sort === "status"
+                ? (a, b) => (a.status ?? "active").localeCompare(b.status ?? "active") ||
+                    compareName(a, b)
+                : compareName);
+}
+export function restoreBrowserState(value) {
+    const routeValue = value.route;
+    const route = routeValue?.page === "plugin" &&
+        typeof routeValue.pluginId === "string" &&
+        routeValue.pluginId.length > 0 &&
+        (routeValue.version === undefined ||
+            (typeof routeValue.version === "string" &&
+                /^[A-Za-z0-9][A-Za-z0-9.+-]{0,127}$/u.test(routeValue.version)))
+        ? {
+            page: "plugin",
+            pluginId: routeValue.pluginId,
+            ...(routeValue.version !== undefined
+                ? { version: routeValue.version }
+                : {}),
+        }
+        : { page: routeValue?.page === "directory" ? "directory" : "landing" };
+    const directory = defaultDirectoryState();
+    const input = value.directory;
+    if (input && typeof input === "object") {
+        if (typeof input.query === "string")
+            directory.query = input.query;
+        for (const key of ["categories", "platforms", "statuses"])
+            if (Array.isArray(input[key]) &&
+                input[key].every((v) => typeof v === "string"))
+                directory[key] = [...input[key]];
+        if (typeof input.officialOnly === "boolean")
+            directory.officialOnly = input.officialOnly;
+        if (typeof input.updatesOnly === "boolean")
+            directory.updatesOnly = input.updatesOnly;
+        if (["all", "installed", "available"].includes(String(input.installation)))
+            directory.installation =
+                input.installation;
+        if (["name", "new", "updated", "status", "downloads"].includes(String(input.sort)))
+            directory.sort = String(input.sort);
+        if (input.view === "list")
+            directory.view = "list";
+    }
+    return { route, directory };
+}

package/dist/plugin-management/plugin-browser-navigation.d.ts

@@ -0,0 +1,3 @@
+import type { App } from "@lapis-notes/api";
+/** Reveal the registered singleton browser, preserving its workspace placement. */
+export declare function openPluginBrowser(app: App, pluginId?: string, isActive?: () => boolean, version?: string): Promise<void>;

package/dist/plugin-management/plugin-browser-navigation.js

@@ -0,0 +1,38 @@
+import { PluginsView } from "./plugins-view.svelte";
+const pending = new WeakMap();
+/** Reveal the registered singleton browser, preserving its workspace placement. */
+export function openPluginBrowser(app, pluginId, isActive = () => true, version) {
+    const previous = pending.get(app) ?? Promise.resolve();
+    const next = previous
+        .catch(() => { })
+        .then(async () => {
+        if (!isActive())
+            return;
+        const leaf = app.workspace.getLeavesOfType("plugins")[0] ??
+            app.workspace.getLeaf(true);
+        if (leaf.view.getViewType() !== "plugins")
+            await leaf.setViewState({
+                type: "plugins",
+                state: { route: { page: "landing" } },
+            });
+        if (!isActive())
+            return;
+        if (!(leaf.view instanceof PluginsView))
+            throw new Error("The Plugins view is not registered in this workspace.");
+        if (pluginId && version !== undefined)
+            leaf.view.showPlugin(pluginId, version);
+        else if (pluginId)
+            leaf.view.showPlugin(pluginId);
+        else
+            leaf.view.home();
+        await app.workspace.revealLeaf(leaf);
+        if (isActive())
+            app.workspace.activateLeaf(leaf);
+    })
+        .finally(() => {
+        if (pending.get(app) === next)
+            pending.delete(app);
+    });
+    pending.set(app, next);
+    return next;
+}

package/dist/plugin-management/plugin-download-stats.d.ts

@@ -0,0 +1 @@
+export declare function formatApproximateDownloadCount(value: number): string;

package/dist/plugin-management/plugin-download-stats.js

@@ -0,0 +1,15 @@
+export function formatApproximateDownloadCount(value) {
+    if (value < 1_000)
+        return String(value);
+    for (const [threshold, suffix] of [
+        [1_000_000_000, "B"],
+        [1_000_000, "M"],
+        [1_000, "K"],
+    ]) {
+        if (value >= threshold) {
+            const scaled = value / threshold;
+            return `${scaled >= 10 ? Math.round(scaled) : scaled.toFixed(1).replace(/\.0$/, "")}${suffix}`;
+        }
+    }
+    return String(value);
+}