@glimstone/vue 0.0.0-stage → 4.0.0

package/dist/info.d.ts

@@ -0,0 +1,71 @@
+import type { Component } from "vue";
+import type { OpenUrl, UpdateCheck, VersionRow } from "@glimstone/core";
+export interface InfoVersionCardProps {
+    text: {
+        title: string;
+        /** The card's "(i)", such as what a click on a number opens. */
+        hint?: string;
+        unreleased: (version: string) => string;
+        /** "Release notes". Only drawn with `onReleaseNotes` and without the `whats-new` slot. */
+        releaseNotes?: string;
+    };
+    /** The app first, then the design language, then every component it ships. */
+    rows: VersionRow[];
+    updateCheck?: UpdateCheck;
+    /** Opens the app's window on the running version's release notes, for an app that marks no changes. */
+    onReleaseNotes?: () => void;
+    openUrl?: OpenUrl;
+    hueIndex?: number;
+}
+export interface InfoHelpCardProps {
+    text: {
+        title?: string;
+        hint?: string;
+        report: string;
+        repoButton: string;
+        mailButton: string;
+        mailSubject: string;
+        bugReport?: string;
+        bugReportSub?: string;
+        manual?: string;
+        manualSub?: string;
+    };
+    repoUrl: string;
+    repoGlyph?: Component;
+    /** The workshop's own mailbox. Omit it and the card offers no mail route. */
+    mailAddress?: string;
+    /** The envelope, `MAIL_SVG` from appMarks.ts, which opens under the pointer. */
+    mailGlyph?: Component;
+    /** The app's handbook. The README is not a manual. */
+    manualUrl?: string;
+    manualGlyph?: Component;
+    /** Downloads the instance's logs and settings as one file, without passwords, keys or credentials. */
+    onBugReport?: () => void;
+    bugGlyph?: Component;
+    openUrl?: OpenUrl;
+    hueIndex?: number;
+}
+export interface InfoAboutCardProps {
+    text: {
+        title: string;
+        body: string;
+        coffee: string;
+        /** The coffee button's accessible name; its artwork carries the words. */
+        coffeeButton: string;
+        /** Only drawn together with `onPaypal`. */
+        paypalButton?: string;
+        /** Only drawn together with `onCrypto`. */
+        cryptoButton?: string;
+    };
+    /** Opens the coffee window, which stays inside the app. */
+    onCoffee: () => void;
+    /** Buy Me a Coffee's own button artwork, `COFFEE_BUTTON_SVG` from appMarks.ts. */
+    coffeeArt: Component;
+    onPaypal?: () => void;
+    /** Passed rather than resolved by label key, because a rule keyed on
+     *  "crypto" would put a currency's symbol on unrelated settings. */
+    paypalGlyph?: Component;
+    onCrypto?: () => void;
+    cryptoGlyph?: Component;
+    hueIndex?: number;
+}

package/dist/selectParts.d.ts

@@ -0,0 +1,25 @@
+import { type Component, type Ref } from "vue";
+import { type SelectChoice, type SelectEntry as Entry, type SelectRun, type SelectSubmenu as Submenu } from "@glimstone/core";
+export type SelectOption<T extends string = string> = SelectChoice<T, Component>;
+export type SelectSubmenu<T extends string = string> = Submenu<T, Component>;
+export type SelectEntry<T extends string = string> = Entry<T, Component>;
+export type SelectGroup<T extends string = string> = SelectRun<T, Component>;
+/**
+ * The trigger's rainbow position, for a list portalled out of the card that
+ * sets it. `.glim-hue` travels with the properties, never alone.
+ */
+export declare function usePortalHue(open: () => boolean, trigger: Ref<HTMLElement | null>): {
+    style: import("vue").ComputedRef<Record<string, string> | undefined>;
+    className: import("vue").ComputedRef<"" | "glim-hue">;
+};
+/**
+ * The wheel steps through every option in list order while the closed trigger
+ * has focus (rule 14), and each bump of `count` shakes it once.
+ */
+export declare function useTriggerMotion<T extends string>(trigger: Ref<HTMLElement | null>, o: {
+    all: () => SelectOption<T>[];
+    value: () => T | null;
+    inert: () => boolean;
+    onChange: (value: T) => void;
+    shakeCount: () => number;
+}): void;

package/dist/selectorItem.d.ts

@@ -0,0 +1,19 @@
+import type { Component } from "vue";
+export interface SelectorItem {
+    /** Stable id, handed back through v-model. */
+    id: string;
+    label: string;
+    /** Shown before the label; in a tab strip it is tinted with its tab's hue. */
+    glyph?: Component;
+    disabled?: boolean;
+    /** Why the segment is in its state, shown in the bubble a keyboard reaches. */
+    title?: string;
+    /** The fuller version of a terse label, shown in the bubble. */
+    tip?: string;
+    /** Shows the glyph alone in every mode but text; the label stays the name. */
+    iconOnly?: boolean;
+    /** Tiles only: the page's own address, so a tile can open in a new tab. */
+    href?: string;
+    /** Tiles only: a page with nothing on it yet, dimmed rather than hidden. */
+    dim?: boolean;
+}

package/dist/tipBubble.d.ts

@@ -0,0 +1,16 @@
+import { type ComputedRef, type Ref } from "vue";
+export interface TipBubble {
+    /** The trigger the bubble is placed against. */
+    trigger: Ref<HTMLElement | null>;
+    bubble: Ref<HTMLElement | null>;
+    id: string;
+    text: ComputedRef<string | undefined>;
+    shown: ComputedRef<boolean>;
+    /** `aria-describedby` while open, so the bubble is announced as the trigger's description. */
+    describedBy: ComputedRef<string | undefined>;
+    show: () => void;
+    hide: () => void;
+    /** Focus opens the bubble only when the keyboard was used last; a mouse user gets focus as a side effect. */
+    showOnFocus: () => void;
+}
+export declare function useTipBubble(tip: () => string | undefined, disabled?: () => boolean): TipBubble;

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@glimstone/vue",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "4.0.0",
+  "description": "GlimStone's components for Vue",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/junkerderprovinz/glimstone.git",
+    "directory": "packages/vue"
+  },
+  "homepage": "https://junkerderprovinz.github.io/glimstone/",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./Select": {
+      "types": "./dist/entries/select.d.ts",
+      "default": "./dist/Select.js"
+    },
+    "./Combobox": {
+      "types": "./dist/entries/combobox.d.ts",
+      "default": "./dist/Combobox.js"
+    },
+    "./Slider": {
+      "types": "./dist/entries/slider.d.ts",
+      "default": "./dist/Slider.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build && vue-tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@glimstone/core": "4.0.0"
+  },
+  "peerDependencies": {
+    "@zag-js/combobox": "^1.46.0",
+    "@zag-js/menu": "^1.46.0",
+    "@zag-js/select": "^1.46.0",
+    "@zag-js/slider": "^1.46.0",
+    "@zag-js/vue": "^1.46.0",
+    "vue": "^3.5.0"
+  }
+}