@astryx-vue/core 0.3.0 → 0.4.1

package/dist/index-Bo-ofFyg.d.ts

@@ -0,0 +1,166 @@
+import { c as ThemeProps, i as MediaThemeProps, n as DefineThemeInput, o as ThemeDefinition, s as ThemeMode } from "./types-CsqwQkf1.js";
+import { ComputedRef } from "vue";
+//#region src/Theme/dataTokens.d.ts
+/**
+ * Data-visualization color defaults, by upstream name.
+ *
+ * The CSS lives in `@astryx-vue/themes/data.css`, which every theme entry
+ * imports; this is the same group for code that paints outside CSS, such as
+ * a canvas chart, and for checking a theme's `--color-data-*` overrides.
+ * `data.test.ts` keeps the two in sync.
+ */
+declare const DATA_TOKEN_DEFAULTS: {
+  readonly '--color-data-categorical-blue': "light-dark(#0171E3, #0171E3)";
+  readonly '--color-data-categorical-orange': "light-dark(#EB6E00, #EB6E00)";
+  readonly '--color-data-categorical-purple': "light-dark(#6B1EFD, #6B1EFD)";
+  readonly '--color-data-categorical-green': "light-dark(#0B991F, #0B991F)";
+  readonly '--color-data-categorical-pink': "light-dark(#F351C0, #F351C0)";
+  readonly '--color-data-categorical-cyan': "light-dark(#0171A4, #0171A4)";
+  readonly '--color-data-categorical-red': "light-dark(#F5394F, #F5394F)";
+  readonly '--color-data-categorical-teal': "light-dark(#08A3A3, #08A3A3)";
+  readonly '--color-data-categorical-brown': "light-dark(#965E03, #965E03)";
+  readonly '--color-data-categorical-indigo': "light-dark(#6F8AFF, #6F8AFF)";
+  readonly '--color-data-neutral': "light-dark(#8494A3, #8C939B)";
+  readonly '--color-data-blue-5': "light-dark(#02165E, #02165E)";
+  readonly '--color-data-blue-4': "light-dark(#004CBC, #004CBC)";
+  readonly '--color-data-blue-3': "light-dark(#2694FE, #2694FE)";
+  readonly '--color-data-blue-2': "light-dark(#78BEFF, #78BEFF)";
+  readonly '--color-data-blue-1': "light-dark(#DBECFF, #DBECFF)";
+  readonly '--color-data-shamrock-5': "light-dark(#0B603D, #0B603D)";
+  readonly '--color-data-shamrock-4': "light-dark(#138546, #138546)";
+  readonly '--color-data-shamrock-3': "light-dark(#24BB5E, #24BB5E)";
+  readonly '--color-data-shamrock-2': "light-dark(#8EF7AA, #8EF7AA)";
+  readonly '--color-data-shamrock-1': "light-dark(#D6FEE4, #D6FEE4)";
+  readonly '--color-data-orange-5': "light-dark(#A13F04, #A13F04)";
+  readonly '--color-data-orange-4': "light-dark(#D66100, #D66100)";
+  readonly '--color-data-orange-3': "light-dark(#FD9537, #FD9537)";
+  readonly '--color-data-orange-2': "light-dark(#FDB876, #FDB876)";
+  readonly '--color-data-orange-1': "light-dark(#FFE6CF, #FFE6CF)";
+  readonly '--color-data-pink-5': "light-dark(#8E1073, #8E1073)";
+  readonly '--color-data-pink-4': "light-dark(#D123A1, #D123A1)";
+  readonly '--color-data-pink-3': "light-dark(#F989D3, #F989D3)";
+  readonly '--color-data-pink-2': "light-dark(#FEADE3, #FEADE3)";
+  readonly '--color-data-pink-1': "light-dark(#FCE3F4, #FCE3F4)";
+  readonly '--color-data-purple-5': "light-dark(#3E0697, #3E0697)";
+  readonly '--color-data-purple-4': "light-dark(#6B1EFD, #6B1EFD)";
+  readonly '--color-data-purple-3': "light-dark(#9081FF, #9081FF)";
+  readonly '--color-data-purple-2': "light-dark(#B3B0FE, #B3B0FE)";
+  readonly '--color-data-purple-1': "light-dark(#E8E8FB, #E8E8FB)";
+  readonly '--color-data-red-5': "light-dark(#9D0519, #9D0519)";
+  readonly '--color-data-red-4': "light-dark(#D31130, #D31130)";
+  readonly '--color-data-red-3': "light-dark(#FB7D87, #FB7D87)";
+  readonly '--color-data-red-2': "light-dark(#FFB2B8, #FFB2B8)";
+  readonly '--color-data-red-1': "light-dark(#FEE4E6, #FEE4E6)";
+  readonly '--color-data-teal-5': "light-dark(#08767D, #08767D)";
+  readonly '--color-data-teal-4': "light-dark(#0C9293, #0C9293)";
+  readonly '--color-data-teal-3': "light-dark(#0DB7AF, #0DB7AF)";
+  readonly '--color-data-teal-2': "light-dark(#6CE6D8, #6CE6D8)";
+  readonly '--color-data-teal-1': "light-dark(#D7FCF8, #D7FCF8)";
+  readonly '--color-data-yellow-5': "light-dark(#8A5001, #8A5001)";
+  readonly '--color-data-yellow-4': "light-dark(#D69804, #D69804)";
+  readonly '--color-data-yellow-3': "light-dark(#FBCE03, #FBCE03)";
+  readonly '--color-data-yellow-2': "light-dark(#FCEC85, #FCEC85)";
+  readonly '--color-data-yellow-1': "light-dark(#FDF6BA, #FDF6BA)";
+  readonly '--color-data-gray-5': "light-dark(#25363F, #333338)";
+  readonly '--color-data-gray-4': "light-dark(#5D6C7B, #666A72)";
+  readonly '--color-data-gray-3': "light-dark(#AFB9C4, #B2B8BE)";
+  readonly '--color-data-gray-2': "light-dark(#CCD3DB, #D0D3D6)";
+  readonly '--color-data-gray-1': "light-dark(#F1F4F7, #F2F4F6)";
+};
+type DataTokenName = keyof typeof DATA_TOKEN_DEFAULTS;
+//#endregion
+//#region src/Theme/tokenName.d.ts
+/** Accept `--color-accent`, `--astryx-color-accent`, or `color-accent`. */
+declare function normalizeTokenName(name: string): string;
+//#endregion
+//#region src/Theme/defineTheme.d.ts
+declare function isDefinedTheme(value: unknown): value is ThemeDefinition;
+/**
+ * Create a theme object that `Theme` can apply to a subtree.
+ *
+ * Token names are the upstream names (`--color-accent`) or this package's
+ * prefixed names (`--astryx-color-accent`). A `[light, dark]` tuple becomes
+ * `light-dark()`. `color`, `typography`, `radius`, and `motion` generate
+ * tokens; an explicit `tokens` entry wins for that name.
+ *
+ * `extends` starts from everything the base theme resolved to: tokens,
+ * local tokens, component styles, surfaces, adaptations, icons, indicators.
+ * This theme's own values win, and the result is self-contained.
+ */
+declare function defineTheme(input: DefineThemeInput): ThemeDefinition;
+/** Neutral, with no token overrides. Colors come from `@astryx-vue/themes/neutral.css`. */
+declare const neutralTheme: ThemeDefinition;
+//#endregion
+//#region src/Theme/MediaTheme.vue.d.ts
+declare var __VLS_1: {};
+type __VLS_Slots$1 = {} & {
+  default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base$1: import("vue").DefineComponent<MediaThemeProps, {
+  element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MediaThemeProps> & Readonly<{}>, {
+  fallback: "dark" | "light";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
+declare const _default$1: typeof __VLS_export$1;
+type __VLS_WithSlots$1<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/Theme/Theme.vue.d.ts
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+  default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<ThemeProps, {
+  element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ThemeProps> & Readonly<{}>, {
+  mode: ThemeMode;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/Theme/useMediaTheme.d.ts
+interface UseMediaThemeReturn {
+  /** Resolved surface. `off` means the children keep the surrounding theme. */
+  mode: ComputedRef<'dark' | 'light' | 'off'>;
+}
+/** Read the nearest MediaTheme. Outside one, the mode is `off`. */
+declare function useMediaTheme(): UseMediaThemeReturn;
+//#endregion
+//#region src/Theme/colorMode.d.ts
+type ResolvedColorMode = 'light' | 'dark';
+//#endregion
+//#region src/Theme/useTheme.d.ts
+interface UseThemeReturn {
+  /** Name of the nearest theme, or `neutral` when no theme is present. */
+  name: ComputedRef<string>;
+  /** Effective light or dark mode. `system` is resolved. */
+  mode: ComputedRef<ResolvedColorMode>;
+  /** Resolve one token for the effective mode. */
+  token: (name: string) => string;
+  /** Tokens declared by the nearest theme, resolved for the effective mode. */
+  tokens: ComputedRef<Record<string, string>>;
+}
+/**
+ * Read the nearest theme. Outside a `Theme`, the name is `neutral` and tokens
+ * are read from the document's custom properties.
+ *
+ * Values are the theme's root values. An adaptation rule that changes a token
+ * on narrow or touch screens applies through CSS only, so `token()` and
+ * `tokens` stay the same across environments.
+ *
+ * The returned object and `token` are created once per component. `name`,
+ * `mode`, and `tokens` update only when the theme or the effective mode
+ * changes, so watching them does not trigger on unrelated renders.
+ */
+declare function useTheme(): UseThemeReturn;
+//#endregion
+export { _default as a, isDefinedTheme as c, DATA_TOKEN_DEFAULTS as d, DataTokenName as f, useMediaTheme as i, neutralTheme as l, useTheme as n, _default$1 as o, UseMediaThemeReturn as r, defineTheme as s, UseThemeReturn as t, normalizeTokenName as u };

package/dist/{index-B1WJxt-n.d.ts → index-C-tFz2Yx.d.ts}

@@ -1,3 +1,4 @@
+import { k as MarkdownAstDataValue, l as MarkdownPluginEntry, t as MarkdownExtensionNode } from "./protocol-DwUmpC5G.js";
 import { Component, PropType, VNode, VNodeChild } from "vue";
 //#region src/Markdown/ast.d.ts
 interface MdPoint {
@@ -36,8 +37,15 @@ interface MdNode {
   name?: string;
   /** `block` extension nodes are rendered as their own block. */
   display?: 'inline' | 'block';
-  /** Extra fields a plugin wants the renderer to read. Keep values plain. */
-  data?: Readonly<Record<string, string | number | boolean | null>>;
+  /** Matched source text on an extension node. */
+  source?: string;
+  /** Citation id, set when a parser turns `[id]` into a citation node. */
+  sourceId?: string;
+  /**
+   * Extra fields a plugin wants the renderer to read.
+   * Nested objects and arrays are allowed so document metadata can live here.
+   */
+  data?: MarkdownAstDataValue;
 }
 declare function isMarkdownExtensionNode(node: MdNode, plugin?: string, name?: string): node is MdNode & {
   type: 'extension';
@@ -184,10 +192,12 @@ interface MarkdownProps {
    */
   onLinkClick?: (href: string, event: MouseEvent) => void | false;
   /**
-   * Document plugins. Each one may replace the parsed tree and draw the
-   * extension nodes it owns. An empty list leaves the document unchanged.
+   * Document plugins. A `MarkdownPlugin` may replace the parsed tree and draw
+   * the extension nodes it owns. A `MarkdownPluginEntry` from
+   * `createMarkdownPlugin` runs syntax and transforms, including
+   * `markdownSourceLinesPlugin`. An empty list leaves the document unchanged.
    */
-  plugins?: readonly MarkdownPlugin[];
+  plugins?: readonly (MarkdownPlugin | MarkdownPluginEntry)[];
   /**
    * Patterns matched against text nodes, in order. The first match at a
    * position wins. Inline code and fenced code are left alone.
@@ -332,15 +342,15 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     default: undefined;
   };
 }>> & Readonly<{}>, {
+  plugins: readonly (MarkdownPluginEntry<MarkdownExtensionNode<string, string, MarkdownAstDataValue, "inline" | "block">> | MarkdownPlugin)[] | undefined;
   density: MarkdownDensity | undefined;
   display: MarkdownDisplay | undefined;
   content: string;
   contentWidth: string | number | undefined;
-  contentAlign: MarkdownAlign | undefined;
   components: MarkdownComponents | undefined;
+  contentAlign: MarkdownAlign | undefined;
   headingLevelStart: MarkdownHeadingLevel | undefined;
   onLinkClick: ((href: string, event: MouseEvent) => void | false) | undefined;
-  plugins: readonly MarkdownPlugin[] | undefined;
   inlinePlugins: readonly MarkdownInlinePlugin[] | undefined;
   autolink: "gfm" | undefined;
   citationStyle: MarkdownCitationStyle | undefined;

package/dist/{index-DWh2WC8W.d.ts → index-C4Cjz6OK.d.ts}

@@ -1,7 +1,7 @@
 import { n as SpacingStep } from "./types-BTk0WZ0b.js";
 import { o as SizeValue } from "./types-uFMH9NaM.js";
-import { r as ResizableProps } from "./useResizable-DDwPpPe6.js";
-import { ComputedRef, InjectionKey, VNodeChild } from "vue";
+import { r as ResizableProps } from "./useResizable-1MHPNaRD.js";
+import { ComputedRef, VNodeChild } from "vue";
 //#region src/Layout/context.d.ts
 type LayoutArea = 'header' | 'start' | 'content' | 'end' | 'footer';
 type LayoutHeight = 'fill' | 'auto';

package/dist/{index-CqE4Bf3Q.d.ts → index-C732aNMY.d.ts}

@@ -41,19 +41,30 @@ interface DialogProps {
   /** 内边距。未设置时使用主题默认值。 */
   padding?: DialogPadding;
 }
+/**
+ * 末尾槽位补偿哪几条边。
+ * `inline` 只补偿逻辑上的行末，`block` 补偿上下两边，`all` 两边都补。
+ * 不传时，有关闭按钮就按 `all`，没有就不补。
+ */
+type DialogHeaderEdgeCompensation = 'inline' | 'block' | 'all';
 interface DialogHeaderProps {
   /** 对话框标题。它会命名父级对话框，并在对话框打开时获得默认焦点。 */
   title: string;
-  /** 标题下方的副标题。为空字符串时不渲染。 */
+  /** 标题下方的副标题。为空字符串时不渲染。富文本用 `subtitle` 插槽。 */
   subtitle?: string;
   /** 是否显示关闭按钮。点击时发出 `openChange(false)`。 */
   hasCloseButton?: boolean;
+  /**
+   * 末尾槽位（尾部内容和关闭按钮）往外补多少边。
+   * 不传时，有关闭按钮就补上下和行末，用来抵消按钮自己的内边距。
+   */
+  endContentEdgeCompensation?: DialogHeaderEdgeCompensation;
   /**
    * 底部是否画一条分隔线。
    * @default false
    */
   hasDivider?: boolean;
-  /** 关闭按钮的无障碍名称。 */
+  /** 关闭按钮的无障碍名称。不传时跟界面语言走。 */
   closeButtonLabel?: string;
 }
 //#endregion
@@ -69,9 +80,9 @@ declare const __VLS_base$1: import("vue").DefineComponent<DialogProps, {}, {}, {
 }, string, import("vue").PublicProps, Readonly<DialogProps> & Readonly<{
   onOpenChange?: ((isOpen: boolean) => any) | undefined;
 }>, {
-  variant: DialogVariant;
-  width: string | number;
   padding: DialogPadding;
+  width: string | number;
+  variant: DialogVariant;
   isInline: boolean;
   position: DialogPosition;
   purpose: DialogPurpose;
@@ -87,6 +98,8 @@ type __VLS_WithSlots$1<T, S> = T & {
 //#endregion
 //#region src/Dialog/DialogHeader.vue.d.ts
 type __VLS_Slots = {
+  title?: () => unknown;
+  subtitle?: () => unknown;
   startContent?: () => unknown;
   endContent?: () => unknown;
 };
@@ -99,6 +112,7 @@ declare const __VLS_base: import("vue").DefineComponent<DialogHeaderProps, {}, {
   hasCloseButton: boolean;
   closeButtonLabel: string;
   subtitle: string;
+  endContentEdgeCompensation: DialogHeaderEdgeCompensation;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/{index-B7yhzGUT.d.ts → index-C7sam-SB.d.ts}

@@ -52,13 +52,13 @@ interface TooltipProps {
 }
 //#endregion
 //#region src/Tooltip/Tooltip.vue.d.ts
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_11: {};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_17: {};
 type __VLS_Slots = {} & {
   default?: (props: typeof __VLS_1) => any;
 } & {
   default?: (props: typeof __VLS_3) => any;
 } & {
-  content?: (props: typeof __VLS_11) => any;
+  content?: (props: typeof __VLS_17) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<TooltipProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   openChange: (isOpen: boolean) => any;

package/dist/{index-BrJzFA5X.d.ts → index-C90l2rH1.d.ts}

@@ -1,4 +1,4 @@
-import { ComputedRef, InjectionKey, VNodeChild } from "vue";
+import { ComputedRef, VNodeChild } from "vue";
 //#region src/FormLayout/context.d.ts
 type FormLayoutDirection = 'vertical' | 'horizontal' | 'horizontal-labels';
 type FormOptionality = 'optional' | 'required';

package/dist/{index-vP0EtrJJ.d.ts → index-C9gAlDt_.d.ts}

@@ -1,4 +1,4 @@
-import { i as IconProps, n as IconColor, o as IconSlots, r as IconName } from "./types-CwyibrRB.js";
+import { c as NamespacedIconName, i as IconProps, n as IconColor, r as IconName, s as IconSlots } from "./types-C5GQ2KCK.js";
 import { ComputedRef, MaybeRefOrGetter } from "vue";
 //#region src/Icon/glyphs.d.ts
 /**
@@ -6,12 +6,15 @@ import { ComputedRef, MaybeRefOrGetter } from "vue";
  * components use, or a namespaced key such as `owner:key` that a component
  * owns.
  */
-type IconGlyphName = IconName | `${string}:${string}`;
+type IconGlyphName = IconName | NamespacedIconName;
 /**
  * The artwork kept for the components' own chrome. Applications bring their own
  * icons; this list only has to cover what astryx-vue draws itself.
+ *
+ * The shared names come first. Namespaced keys after them belong to one
+ * component each; a theme overrides them by key through `defineTheme({ icons })`.
  */
-declare const ICON_GLYPHS: readonly ["close", "chevronDown", "chevronLeft", "chevronRight", "chevronsLeft", "chevronsRight", "check", "success", "error", "warning", "info", "calendar", "clock", "externalLink", "menu", "moreHorizontal", "search", "upload", "arrowUp", "arrowDown", "arrowsUpDown", "funnel", "eyeSlash", "viewColumns", "copy", "checkDouble", "wrench", "stop", "microphone", "image"];
+declare const ICON_GLYPHS: readonly ["close", "chevronDown", "chevronLeft", "chevronRight", "chevronsLeft", "chevronsRight", "check", "success", "error", "warning", "info", "calendar", "clock", "externalLink", "menu", "moreHorizontal", "search", "upload", "arrowUp", "arrowDown", "arrowsUpDown", "funnel", "eyeSlash", "viewColumns", "copy", "checkDouble", "wrench", "stop", "microphone", "image", "numberInput:stepperDown"];
 declare function isIconGlyph(value: string): value is IconGlyphName;
 /** The CSS-safe form of a name, used as the `astryx-icon--<slug>` class. */
 declare function iconGlyphSlug(name: IconGlyphName): string;