@visualli/core 0.1.7 → 0.2.1

package/dist/designSystem-D49xVfr8.d.ts

@@ -0,0 +1,150 @@
+/** Version of the design system these modules were generated from. */
+declare const DESIGN_SYSTEM_VERSION: "0.2.1";
+declare const THEME_NAMES: readonly ["light", "dark", "focus-light", "focus-dark", "colorsafe-light", "colorsafe-dark", "contrast-light", "contrast-dark"];
+type ThemeName = (typeof THEME_NAMES)[number];
+/** Every token for every theme (each theme already merged over "light"). Keys match the CSS custom properties. */
+declare const TOKENS: Readonly<Record<ThemeName, Readonly<Record<string, string>>>>;
+/** Topic palette names (token pairs `topic-<name>` / `topic-<name>-ring`). */
+declare const TOPICS: readonly ["teal", "harbor", "iris", "berry", "coral", "amber", "sun", "stone"];
+type TopicName = (typeof TOPICS)[number];
+/** Numeric tokens (px / ms stripped), camel-cased: nodeWidth, nodeStroke, edgeWidth, edgeGap, durationBase, zoomMin ... */
+declare const METRICS: {
+    readonly space1: 4;
+    readonly space2: 8;
+    readonly space3: 12;
+    readonly space4: 16;
+    readonly space7: 48;
+    readonly radiusSm: 10;
+    readonly radiusMd: 16;
+    readonly radiusLg: 24;
+    readonly radiusPill: 999;
+    readonly nodeWidth: 200;
+    readonly nodeHeight: 148;
+    readonly nodeStroke: 3;
+    readonly edgeWidth: 2.5;
+    readonly edgeGap: 15;
+    readonly edgeArcMax: 45;
+    readonly immersionAlpha: 0.15;
+    readonly zoomMin: 0.3;
+    readonly zoomMax: 5;
+    readonly durationInstant: 100;
+    readonly durationQuick: 160;
+    readonly durationBase: 240;
+    readonly durationZoom: 500;
+    readonly durationReveal: 420;
+    readonly staggerReveal: 70;
+    readonly zChrome: 10;
+    readonly zCard: 20;
+    readonly zMenu: 40;
+};
+/** Overrides applied when motion is reduced. */
+declare const METRICS_REDUCED_MOTION: {
+    readonly durationInstant: 120;
+    readonly durationQuick: 0;
+    readonly durationBase: 0;
+    readonly durationZoom: 0;
+    readonly durationReveal: 0;
+    readonly staggerReveal: 0;
+};
+/** Canvas type styles (family is a token name: font-hand, font-note, font-ui ...). */
+declare const TYPE_STYLES: {
+    readonly heading: {
+        readonly family: "font-ui";
+        readonly size: 17;
+        readonly lineHeight: 24;
+        readonly weight: 700;
+    };
+    readonly body: {
+        readonly family: "font-ui";
+        readonly size: 15;
+        readonly lineHeight: 22;
+        readonly weight: 400;
+    };
+    readonly "body-sm": {
+        readonly family: "font-ui";
+        readonly size: 13;
+        readonly lineHeight: 18;
+        readonly weight: 400;
+    };
+    readonly label: {
+        readonly family: "font-ui";
+        readonly size: 13;
+        readonly lineHeight: 16;
+        readonly weight: 600;
+        readonly letterSpacing: 0.01;
+    };
+    readonly caption: {
+        readonly family: "font-ui";
+        readonly size: 12;
+        readonly lineHeight: 16;
+        readonly weight: 400;
+    };
+    readonly "node-root": {
+        readonly family: "font-hand";
+        readonly size: 30;
+        readonly lineHeight: 34;
+        readonly weight: 700;
+    };
+    readonly "node-label": {
+        readonly family: "font-hand";
+        readonly size: 22;
+        readonly lineHeight: 26;
+        readonly weight: 700;
+    };
+    readonly "edge-label": {
+        readonly family: "font-note";
+        readonly size: 18;
+        readonly lineHeight: 20;
+        readonly weight: 500;
+    };
+    readonly annotation: {
+        readonly family: "font-note";
+        readonly size: 24;
+        readonly lineHeight: 26;
+        readonly weight: 600;
+    };
+};
+/** Canvas styling extracted from css/spec.css (node labels, hover, shadows, connector dashes, group frames). */
+declare const CANVAS_STYLE: {
+    readonly node: {
+        readonly selectedStrokeWidth: 4;
+        readonly hoverRingsRotate: -2;
+        readonly hoverRingsScale: 1.015;
+        readonly hoverLift: -2;
+        readonly dimmedOpacity: 1;
+        readonly dimmedOpacityFocus: 0.4;
+        readonly dimmedOpacityTouch: 0.6;
+        readonly dimmedOpacityFocusTouch: 0.4;
+        readonly shadowLight: "0 6px 14px rgba(24, 33, 64, .10)";
+        readonly shadowDark: "0 0 22px rgba(255, 255, 255, .10)";
+    };
+    readonly edge: {
+        readonly dash: readonly [7, 7];
+        readonly labelWeight: 500;
+        readonly labelSize: 18;
+        readonly readableLabelSize: 14;
+        readonly readableLabelWeight: 600;
+        readonly labelHaloWidth: 5;
+    };
+    readonly group: {
+        readonly strokeWidth: 1.5;
+        readonly dash: readonly [10, 6];
+        readonly labelWeight: 700;
+        readonly labelLineHeight: 1.1;
+        readonly labelSize: 26;
+        readonly labelPadding: {
+            readonly top: 6;
+            readonly x: 22;
+            readonly bottom: 8;
+        };
+        readonly labelMaxWidth: 420;
+        readonly labelBorderWidth: 1.5;
+        readonly labelFill: "topic-stone";
+        readonly labelBorder: "topic-stone-ring";
+        readonly labelInk: "node-ink";
+        readonly contrastLabelBorderWidth: 2;
+        readonly contrastLabelBorder: "line-strong";
+    };
+};
+
+export { CANVAS_STYLE as C, DESIGN_SYSTEM_VERSION as D, METRICS as M, type TopicName as T, type ThemeName as a, METRICS_REDUCED_MOTION as b, THEME_NAMES as c, TOKENS as d, TOPICS as e, TYPE_STYLES as f };

package/dist/document-BFBwn93X.d.ts

@@ -0,0 +1,26 @@
+import { Meta } from '@visualli/bindings';
+import { V as VisualliLayer } from './layer-B2A3Ki48.js';
+
+/** Alias to schema Meta type for SDK consistency */
+type VisualliMeta = Meta;
+
+/** Parsed .visualli document structure. */
+interface VisualliDocument {
+    meta: VisualliMeta;
+    /** Keyed by layer ID */
+    layers: Map<string, VisualliLayer>;
+    /** Quick lookup by level */
+    layersByLevel: Map<number, VisualliLayer[]>;
+    /** The level-0 layer */
+    rootLayer: VisualliLayer | null;
+    /** Extension payloads by extension id (e.g. 'semantic-anchors'). */
+    extensions?: Record<string, unknown[]>;
+}
+/** A term with a definition (the `semantic-anchors` extension). */
+interface SemanticAnchor {
+    word: string;
+    description: string;
+    knowMoreUrl?: string | null;
+}
+
+export type { SemanticAnchor as S, VisualliDocument as V, VisualliMeta as a };

package/dist/document-MEJEfxl3.d.cts

@@ -0,0 +1,26 @@
+import { Meta } from '@visualli/bindings';
+import { V as VisualliLayer } from './layer-B2A3Ki48.cjs';
+
+/** Alias to schema Meta type for SDK consistency */
+type VisualliMeta = Meta;
+
+/** Parsed .visualli document structure. */
+interface VisualliDocument {
+    meta: VisualliMeta;
+    /** Keyed by layer ID */
+    layers: Map<string, VisualliLayer>;
+    /** Quick lookup by level */
+    layersByLevel: Map<number, VisualliLayer[]>;
+    /** The level-0 layer */
+    rootLayer: VisualliLayer | null;
+    /** Extension payloads by extension id (e.g. 'semantic-anchors'). */
+    extensions?: Record<string, unknown[]>;
+}
+/** A term with a definition (the `semantic-anchors` extension). */
+interface SemanticAnchor {
+    word: string;
+    description: string;
+    knowMoreUrl?: string | null;
+}
+
+export type { SemanticAnchor as S, VisualliDocument as V, VisualliMeta as a };

package/dist/ideaSize-BTJu6thN.d.cts

@@ -0,0 +1,11 @@
+import { I as IdeaKind } from './mindmap-BO3YD5qu.cjs';
+import { V as VisualliLayer } from './layer-B2A3Ki48.cjs';
+
+/** Width in px of `text` in the idea label's face at `px` (the label's weight; readable type adds its tracking). */
+type IdeaMeasure = (text: string, px: number) => number;
+/** Measurement without a font engine (server, tests): half an em per character. Renderers pass the real face. */
+declare const approximateMeasure: IdeaMeasure;
+/** The size kind of the `index`-th idea of a layer: the centre of the root radial layer is the root, the rest ideas. */
+declare const ideaKindOf: (layer: Pick<VisualliLayer, "level" | "layout">, index: number) => IdeaKind;
+
+export { type IdeaMeasure as I, approximateMeasure as a, ideaKindOf as i };

package/dist/ideaSize-RKbms8K6.d.ts

@@ -0,0 +1,11 @@
+import { I as IdeaKind } from './mindmap-D0Of0jaZ.js';
+import { V as VisualliLayer } from './layer-B2A3Ki48.js';
+
+/** Width in px of `text` in the idea label's face at `px` (the label's weight; readable type adds its tracking). */
+type IdeaMeasure = (text: string, px: number) => number;
+/** Measurement without a font engine (server, tests): half an em per character. Renderers pass the real face. */
+declare const approximateMeasure: IdeaMeasure;
+/** The size kind of the `index`-th idea of a layer: the centre of the root radial layer is the root, the rest ideas. */
+declare const ideaKindOf: (layer: Pick<VisualliLayer, "level" | "layout">, index: number) => IdeaKind;
+
+export { type IdeaMeasure as I, approximateMeasure as a, ideaKindOf as i };

package/dist/index-CcF0Jvmb.d.ts

@@ -0,0 +1,99 @@
+import { T as TopicName$1, M as METRICS, a as ThemeName } from './designSystem-D49xVfr8.js';
+
+/** The eight topics, in the order missing colors cycle through. */
+declare const TOPIC_ORDER: readonly ["teal", "harbor", "iris", "berry", "coral", "amber", "sun", "stone"];
+type TopicName = (typeof TOPIC_ORDER)[number];
+/** The topic a color names, or null. */
+declare function topicFromName(color: string | null | undefined): TopicName | null;
+/** The topic for an idea: its named topic; with no color, the next topic in sibling order; null for any other color. */
+declare function topicFor(color: string | null | undefined, siblingIndex: number): TopicName | null;
+/** A custom (non-topic) color: drawn as given, with a darker ring. */
+declare const CUSTOM: {
+    readonly ringShade: 0.78;
+};
+/** Fill and ring for a custom color. `ring` is null when the color isn't a 6-digit hex (use the `edge` token then). */
+declare function customColor(color: string): {
+    fill: string;
+    ring: string | null;
+};
+
+/** Theme families: each resolves to its light or dark member. */
+type ThemeFamily = 'standard' | 'focus' | 'colorsafe' | 'contrast';
+/**
+ * Anything a consumer may pass as `theme`:
+ *  - one of the 8 design-system themes ('light', 'dark', 'focus-light', ...)
+ *  - a family name ('focus' | 'colorsafe' | 'contrast') -> light/dark per the reader's scheme
+ *  - 'auto' -> light/dark per prefers-color-scheme (contrast under forced-colors)
+ *
+ * 'light' | 'dark' | 'auto' are the pre-0.2 values, kept as aliases for one release.
+ */
+type ThemeInput = ThemeName | 'auto' | 'focus' | 'colorsafe' | 'contrast';
+interface ThemeEnv {
+    /** prefers-color-scheme: dark */
+    prefersDark?: boolean;
+    /** forced-colors: active (Windows high contrast etc.) */
+    forcedColors?: boolean;
+}
+declare function isThemeName(v: unknown): v is ThemeName;
+/** Resolve any accepted `theme` value to one concrete design-system theme. */
+declare function resolveTheme(input: ThemeInput | undefined, env?: ThemeEnv): ThemeName;
+declare const isDarkTheme: (name: ThemeName) => boolean;
+declare const isContrastTheme: (name: ThemeName) => boolean;
+declare const isFocusTheme: (name: ThemeName) => boolean;
+/** All tokens of a theme (already merged over the light defaults). */
+declare const getTokens: (name: ThemeName) => Readonly<Record<string, string>>;
+/** One token of a theme. Throws on an unknown key so typos fail loudly in tests. */
+declare function token(name: ThemeName, key: string): string;
+interface Comfort {
+    /** Atkinson Hyperlegible for map labels instead of the handwritten faces (`data-type="readable"`). */
+    readableType?: boolean;
+    /** Larger UI and label text (`data-scale="lg"`). */
+    largerText?: boolean;
+    /** Skip transitions and reveal animations (`data-motion="reduced"`). 'system' follows prefers-reduced-motion. */
+    reducedMotion?: boolean | 'system';
+}
+interface ResolvedComfort {
+    readableType: boolean;
+    largerText: boolean;
+    reducedMotion: boolean;
+}
+declare function resolveComfort(c: Comfort | undefined, env?: {
+    prefersReducedMotion?: boolean;
+}): ResolvedComfort;
+/** Numeric design-system tokens (px / ms stripped). */
+type Metrics = {
+    readonly [K in keyof typeof METRICS]: number;
+};
+/** Numeric tokens with the reduced-motion overrides applied when requested. */
+declare function metricsFor(comfort: ResolvedComfort): Metrics;
+/** Multiplier the spec applies to label sizes under `data-scale="lg"` (`--vi-label-scale`). */
+declare const labelScale: (c: ResolvedComfort) => number;
+interface TopicStyle {
+    topic: TopicName$1;
+    fill: string;
+    ring: string;
+}
+/** Fill + ring colour of a topic in a theme. */
+declare function topicStyle(theme: ThemeName, topic: TopicName$1): TopicStyle;
+/** An idea's colour by the design system's colour rule (geometry/color.ts, verbatim): a topic name → that topic; no
+ *  colour → the topics in sibling order; any other colour → custom, drawn as given (customColor: the colour as the fill,
+ *  the fill darkened by CUSTOM.ringShade as the ring). A custom colour doesn't follow themes. */
+interface IdeaColor {
+    topic: TopicName$1 | null;
+    custom: {
+        fill: string;
+        ring: string | null;
+    } | null;
+}
+declare function ideaColor(color: string | null | undefined, siblingIndex: number): IdeaColor;
+/** Fill + ring an idea is drawn with in a theme: its topic's, or its custom colour (ring: the `edge` token when the
+ *  colour has no darker shade, i.e. isn't a 6-digit hex). */
+declare function ideaStyle(theme: ThemeName, c: {
+    topic?: TopicName$1 | null;
+    custom?: IdeaColor['custom'];
+}): {
+    fill: string;
+    ring: string;
+};
+
+export { CUSTOM as C, type IdeaColor as I, type Metrics as M, type ResolvedComfort as R, TOPIC_ORDER as T, type Comfort as a, type ThemeEnv as b, type ThemeFamily as c, type ThemeInput as d, type TopicStyle as e, customColor as f, getTokens as g, ideaStyle as h, ideaColor as i, isContrastTheme as j, isDarkTheme as k, isFocusTheme as l, isThemeName as m, labelScale as n, metricsFor as o, resolveTheme as p, topicFor as q, resolveComfort as r, topicFromName as s, token as t, topicStyle as u };

package/dist/index-Dt--T2l8.d.cts

@@ -0,0 +1,99 @@
+import { T as TopicName$1, M as METRICS, a as ThemeName } from './designSystem-D49xVfr8.cjs';
+
+/** The eight topics, in the order missing colors cycle through. */
+declare const TOPIC_ORDER: readonly ["teal", "harbor", "iris", "berry", "coral", "amber", "sun", "stone"];
+type TopicName = (typeof TOPIC_ORDER)[number];
+/** The topic a color names, or null. */
+declare function topicFromName(color: string | null | undefined): TopicName | null;
+/** The topic for an idea: its named topic; with no color, the next topic in sibling order; null for any other color. */
+declare function topicFor(color: string | null | undefined, siblingIndex: number): TopicName | null;
+/** A custom (non-topic) color: drawn as given, with a darker ring. */
+declare const CUSTOM: {
+    readonly ringShade: 0.78;
+};
+/** Fill and ring for a custom color. `ring` is null when the color isn't a 6-digit hex (use the `edge` token then). */
+declare function customColor(color: string): {
+    fill: string;
+    ring: string | null;
+};
+
+/** Theme families: each resolves to its light or dark member. */
+type ThemeFamily = 'standard' | 'focus' | 'colorsafe' | 'contrast';
+/**
+ * Anything a consumer may pass as `theme`:
+ *  - one of the 8 design-system themes ('light', 'dark', 'focus-light', ...)
+ *  - a family name ('focus' | 'colorsafe' | 'contrast') -> light/dark per the reader's scheme
+ *  - 'auto' -> light/dark per prefers-color-scheme (contrast under forced-colors)
+ *
+ * 'light' | 'dark' | 'auto' are the pre-0.2 values, kept as aliases for one release.
+ */
+type ThemeInput = ThemeName | 'auto' | 'focus' | 'colorsafe' | 'contrast';
+interface ThemeEnv {
+    /** prefers-color-scheme: dark */
+    prefersDark?: boolean;
+    /** forced-colors: active (Windows high contrast etc.) */
+    forcedColors?: boolean;
+}
+declare function isThemeName(v: unknown): v is ThemeName;
+/** Resolve any accepted `theme` value to one concrete design-system theme. */
+declare function resolveTheme(input: ThemeInput | undefined, env?: ThemeEnv): ThemeName;
+declare const isDarkTheme: (name: ThemeName) => boolean;
+declare const isContrastTheme: (name: ThemeName) => boolean;
+declare const isFocusTheme: (name: ThemeName) => boolean;
+/** All tokens of a theme (already merged over the light defaults). */
+declare const getTokens: (name: ThemeName) => Readonly<Record<string, string>>;
+/** One token of a theme. Throws on an unknown key so typos fail loudly in tests. */
+declare function token(name: ThemeName, key: string): string;
+interface Comfort {
+    /** Atkinson Hyperlegible for map labels instead of the handwritten faces (`data-type="readable"`). */
+    readableType?: boolean;
+    /** Larger UI and label text (`data-scale="lg"`). */
+    largerText?: boolean;
+    /** Skip transitions and reveal animations (`data-motion="reduced"`). 'system' follows prefers-reduced-motion. */
+    reducedMotion?: boolean | 'system';
+}
+interface ResolvedComfort {
+    readableType: boolean;
+    largerText: boolean;
+    reducedMotion: boolean;
+}
+declare function resolveComfort(c: Comfort | undefined, env?: {
+    prefersReducedMotion?: boolean;
+}): ResolvedComfort;
+/** Numeric design-system tokens (px / ms stripped). */
+type Metrics = {
+    readonly [K in keyof typeof METRICS]: number;
+};
+/** Numeric tokens with the reduced-motion overrides applied when requested. */
+declare function metricsFor(comfort: ResolvedComfort): Metrics;
+/** Multiplier the spec applies to label sizes under `data-scale="lg"` (`--vi-label-scale`). */
+declare const labelScale: (c: ResolvedComfort) => number;
+interface TopicStyle {
+    topic: TopicName$1;
+    fill: string;
+    ring: string;
+}
+/** Fill + ring colour of a topic in a theme. */
+declare function topicStyle(theme: ThemeName, topic: TopicName$1): TopicStyle;
+/** An idea's colour by the design system's colour rule (geometry/color.ts, verbatim): a topic name → that topic; no
+ *  colour → the topics in sibling order; any other colour → custom, drawn as given (customColor: the colour as the fill,
+ *  the fill darkened by CUSTOM.ringShade as the ring). A custom colour doesn't follow themes. */
+interface IdeaColor {
+    topic: TopicName$1 | null;
+    custom: {
+        fill: string;
+        ring: string | null;
+    } | null;
+}
+declare function ideaColor(color: string | null | undefined, siblingIndex: number): IdeaColor;
+/** Fill + ring an idea is drawn with in a theme: its topic's, or its custom colour (ring: the `edge` token when the
+ *  colour has no darker shade, i.e. isn't a 6-digit hex). */
+declare function ideaStyle(theme: ThemeName, c: {
+    topic?: TopicName$1 | null;
+    custom?: IdeaColor['custom'];
+}): {
+    fill: string;
+    ring: string;
+};
+
+export { CUSTOM as C, type IdeaColor as I, type Metrics as M, type ResolvedComfort as R, TOPIC_ORDER as T, type Comfort as a, type ThemeEnv as b, type ThemeFamily as c, type ThemeInput as d, type TopicStyle as e, customColor as f, getTokens as g, ideaStyle as h, ideaColor as i, isContrastTheme as j, isDarkTheme as k, isFocusTheme as l, isThemeName as m, labelScale as n, metricsFor as o, resolveTheme as p, topicFor as q, resolveComfort as r, topicFromName as s, token as t, topicStyle as u };