@astra-kit/ui 0.0.0-stage → 0.0.0

package/dist/lib/horizontal-swipe.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pure classification of a pointer drag into a horizontal swipe. Kept apart
+ * from the DOM so thresholds are unit-testable and shared by any pager.
+ */
+export declare const HORIZONTAL_SWIPE_DIRECTION: {
+    readonly next: "next";
+    readonly previous: "previous";
+};
+export type HorizontalSwipeDirection = (typeof HORIZONTAL_SWIPE_DIRECTION)[keyof typeof HORIZONTAL_SWIPE_DIRECTION];
+export type HorizontalSwipeGesture = {
+    deltaX: number;
+    deltaY: number;
+    durationMs: number;
+};
+/**
+ * Decides whether a drag is a deliberate horizontal swipe. A leftward swipe
+ * moves to the next page and a rightward one to the previous page, like
+ * turning a calendar page.
+ *
+ * @param gesture - Pointer travel and duration.
+ * @returns The swipe direction, or null when the drag is not a swipe.
+ */
+export declare function resolveHorizontalSwipe(gesture: HorizontalSwipeGesture): HorizontalSwipeDirection | null;

package/dist/lib/horizontal-swipe.js

@@ -0,0 +1,29 @@
+/**
+* Pure classification of a pointer drag into a horizontal swipe. Kept apart
+* from the DOM so thresholds are unit-testable and shared by any pager.
+*/
+export const HORIZONTAL_SWIPE_DIRECTION = {
+	next: "next",
+	previous: "previous"
+};
+/** Minimum horizontal travel, in CSS pixels, to count as a swipe. */
+const SWIPE_MIN_DISTANCE_PX = 60;
+/** Horizontal travel must dominate vertical travel by this ratio. */
+const SWIPE_HORIZONTAL_DOMINANCE_RATIO = 1.5;
+/** Slower drags read as reading/scrolling, not as a page flip. */
+const SWIPE_MAX_DURATION_MS = 800;
+/**
+* Decides whether a drag is a deliberate horizontal swipe. A leftward swipe
+* moves to the next page and a rightward one to the previous page, like
+* turning a calendar page.
+*
+* @param gesture - Pointer travel and duration.
+* @returns The swipe direction, or null when the drag is not a swipe.
+*/
+export function resolveHorizontalSwipe(gesture) {
+	const horizontalDistance = Math.abs(gesture.deltaX);
+	if (horizontalDistance < SWIPE_MIN_DISTANCE_PX || horizontalDistance < Math.abs(gesture.deltaY) * SWIPE_HORIZONTAL_DOMINANCE_RATIO || gesture.durationMs > SWIPE_MAX_DURATION_MS) {
+		return null;
+	}
+	return gesture.deltaX < 0 ? HORIZONTAL_SWIPE_DIRECTION.next : HORIZONTAL_SWIPE_DIRECTION.previous;
+}

package/dist/lib/image-dimensions.d.ts

@@ -0,0 +1,2 @@
+/** Converts native image dimensions into a positive numeric value. */
+export declare function imageDimension(value: string | number | undefined): number;

package/dist/lib/image-dimensions.js

@@ -0,0 +1,7 @@
+/** Supplies intrinsic dimensions required by responsive and optimized image adapters. */
+const DEFAULT_IMAGE_DIMENSION_PX = 40;
+/** Converts native image dimensions into a positive numeric value. */
+export function imageDimension(value) {
+	const parsed = Number(value);
+	return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_IMAGE_DIMENSION_PX;
+}

package/dist/lib/name-initials.d.ts

@@ -0,0 +1,7 @@
+/** Builds avatar initials from display names, shared by account and member avatars. */
+/**
+ * Builds up to two uppercase initials from a display name, ignoring repeated spaces.
+ * @param name - Display name, possibly blank.
+ * @returns The initials, or an empty string for a blank name.
+ */
+export declare function getNameInitials(name: string): string;

package/dist/lib/name-initials.js

@@ -0,0 +1,11 @@
+/** Builds avatar initials from display names, shared by account and member avatars. */
+const NAME_PART_SEPARATOR = /\s+/;
+const MAX_INITIALS = 2;
+/**
+* Builds up to two uppercase initials from a display name, ignoring repeated spaces.
+* @param name - Display name, possibly blank.
+* @returns The initials, or an empty string for a blank name.
+*/
+export function getNameInitials(name) {
+	return name.trim().split(NAME_PART_SEPARATOR).filter(Boolean).slice(0, MAX_INITIALS).map((namePart) => namePart.charAt(0).toUpperCase()).join("");
+}

package/dist/lib/rich-text/link-markdown-constants.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Shared constants for the rich-text link layer.
+ *
+ * These values back both the read-only renderer (`RichTextContent`) and the
+ * rich link editor (`RichLinkEditor` / `useRichLinkEditor`). They are framework
+ * safe and free of business rules, so they live under `lib` and can be reused by
+ * any feature that needs autolinking plus `[text](url)` markdown support.
+ */
+/** URL protocols accepted when normalizing a markdown link target. */
+export declare const LINK_MARKDOWN_ALLOWED_PROTOCOL: {
+    readonly http: "http:";
+    readonly https: "https:";
+};
+/** Protocol prepended to bare domains that lack an explicit scheme. */
+export declare const LINK_PROTOCOL_PREFIX: {
+    readonly default: "https://";
+};
+/** Tokens used to assemble and recognize `[text](url)` markdown links. */
+export declare const LINK_MARKDOWN_FORMAT: {
+    readonly closeLabel: "]";
+    readonly closeUrl: ")";
+    readonly openLabel: "[";
+    readonly openUrl: "](";
+    readonly suppressedUrl: "#";
+};
+/**
+ * Parentheses that the `[text](url)` markdown URL group cannot represent
+ * unescaped, paired with their percent-encoded equivalents. The URL group only
+ * accepts balanced single-level `(...)` pairs, so any other paren must be
+ * encoded when serializing a link target; browsers decode `%28`/`%29` back to
+ * the literal character when the link is opened.
+ */
+export declare const LINK_MARKDOWN_URL_PAREN: {
+    readonly close: ")";
+    readonly encodedClose: "%29";
+    readonly encodedOpen: "%28";
+    readonly open: "(";
+};
+/** Patterns matching characters that must be escaped inside link label text. */
+export declare const LINK_MARKDOWN_ESCAPE_PATTERN: {
+    readonly backslash: RegExp;
+    readonly closeLabel: RegExp;
+    readonly lineBreak: RegExp;
+    readonly openLabel: RegExp;
+};
+/** Escape sequences paired with `LINK_MARKDOWN_ESCAPE_PATTERN`. */
+export declare const LINK_MARKDOWN_ESCAPE_VALUE: {
+    readonly backslash: "\\";
+    readonly escapedBackslash: "\\\\";
+    readonly escapedCloseLabel: "\\]";
+    readonly escapedLineBreak: "\\n";
+    readonly escapedOpenLabel: "\\[";
+    readonly lineBreakToken: "n";
+};
+/** Discriminant for the parsed rich-text segments (plain text vs. link). */
+export declare const RICH_TEXT_SEGMENT_TYPE: {
+    readonly link: "link";
+    readonly text: "text";
+};
+/** Whether an editor link is explicit (`[text](url)`) or a suppressed autolink. */
+export declare const RICH_LINK_KIND: {
+    readonly explicit: "explicit";
+    readonly suppressed: "suppressed";
+};
+/** Origin of a preview link segment: auto-detected URL vs. explicit link. */
+export declare const RICH_PREVIEW_LINK_SOURCE: {
+    readonly automatic: "automatic";
+    readonly explicit: "explicit";
+};
+/** Editing modes of the link popover. */
+export declare const RICH_LINK_POPOVER_MODE: {
+    readonly actions: "actions";
+    readonly edit: "edit";
+};
+/**
+ * Regular expressions used to detect links in plain text.
+ *
+ * The URL character classes exclude both `)` and `]` so a URL wrapped in
+ * brackets or parentheses (`[https://example.com/path]`) stops at the closing
+ * delimiter instead of swallowing it into the link target. Balanced `(...)`
+ * inside the URL is still matched through the dedicated paren-balancing group.
+ */
+export declare const LINK_PATTERN: {
+    readonly bareDomain: RegExp;
+    readonly containsWhitespace: RegExp;
+    readonly bareUrl: RegExp;
+    readonly hostBoundary: RegExp;
+    readonly markdown: RegExp;
+    readonly protocolPrefix: RegExp;
+    readonly trailingPunctuation: RegExp;
+    readonly whitespace: RegExp;
+};
+/**
+ * Public top-level domains recognized when auto-linking a scheme-less bare
+ * domain found in prose. `new URL()` accepts any syntactically valid hostname,
+ * so without this allowlist Spanish abbreviations like `EE.UU.` or
+ * end-of-sentence transitions like `China.Por` would resolve to bogus hosts and
+ * become clickable links. It covers the common gTLDs plus every assigned
+ * two-letter ccTLD; unknown suffixes such as `uu` or `por` are intentionally
+ * absent. This gates only the automatic detection path: explicit `http(s)://`
+ * URLs and links the user pastes deliberately bypass it and stay permissive.
+ */
+export declare const KNOWN_TOP_LEVEL_DOMAINS: Set<string>;
+/** Capture group indexes of `LINK_PATTERN.markdown`. */
+export declare const LINK_MARKDOWN_MATCH_GROUP: {
+    readonly text: 1;
+    readonly url: 2;
+};
+/** Sentinel returned by the text diff when no change is found. */
+export declare const TEXT_DIFF_FALLBACK_INDEX: {
+    readonly notFound: -1;
+};
+/** Separator used to build a stable key for preview link segments. */
+export declare const PREVIEW_LINK_KEY_SEPARATOR: {
+    readonly value: ":";
+};
+/** Clipboard data type read on paste inside the editor. */
+export declare const RICH_TEXT_CLIPBOARD_DATA_TYPE: {
+    readonly plainText: "text/plain";
+};
+/** `InputEvent.inputType` values handled by the editor's `beforeInput`. */
+export declare const RICH_TEXT_EDITOR_INPUT_TYPE: {
+    readonly deleteContentBackward: "deleteContentBackward";
+    readonly deleteContentForward: "deleteContentForward";
+    readonly insertLineBreak: "insertLineBreak";
+    readonly insertParagraph: "insertParagraph";
+    readonly insertText: "insertText";
+};
+/** Keyboard keys handled by the editor's `keydown`. */
+export declare const RICH_TEXT_EDITOR_KEY: {
+    readonly backspace: "Backspace";
+    readonly delete: "Delete";
+    readonly enter: "Enter";
+};
+/** Direction of a word-wise deletion. */
+export declare const RICH_TEXT_EDITOR_WORD_DIRECTION: {
+    readonly backward: "backward";
+    readonly forward: "forward";
+};
+/** Length of a single editable character. */
+export declare const RICH_TEXT_EDITOR_KEY_LENGTH: {
+    readonly character: 1;
+};
+/** Literal text tokens used by the editor. */
+export declare const RICH_TEXT_EDITOR_TEXT: {
+    readonly lineBreak: "\n";
+};

package/dist/lib/rich-text/link-markdown-constants.js

@@ -0,0 +1,458 @@
+/**
+* Shared constants for the rich-text link layer.
+*
+* These values back both the read-only renderer (`RichTextContent`) and the
+* rich link editor (`RichLinkEditor` / `useRichLinkEditor`). They are framework
+* safe and free of business rules, so they live under `lib` and can be reused by
+* any feature that needs autolinking plus `[text](url)` markdown support.
+*/
+/** URL protocols accepted when normalizing a markdown link target. */
+export const LINK_MARKDOWN_ALLOWED_PROTOCOL = {
+	http: "http:",
+	https: "https:"
+};
+/** Protocol prepended to bare domains that lack an explicit scheme. */
+export const LINK_PROTOCOL_PREFIX = { default: "https://" };
+/** Tokens used to assemble and recognize `[text](url)` markdown links. */
+export const LINK_MARKDOWN_FORMAT = {
+	closeLabel: "]",
+	closeUrl: ")",
+	openLabel: "[",
+	openUrl: "](",
+	suppressedUrl: "#"
+};
+/**
+* Parentheses that the `[text](url)` markdown URL group cannot represent
+* unescaped, paired with their percent-encoded equivalents. The URL group only
+* accepts balanced single-level `(...)` pairs, so any other paren must be
+* encoded when serializing a link target; browsers decode `%28`/`%29` back to
+* the literal character when the link is opened.
+*/
+export const LINK_MARKDOWN_URL_PAREN = {
+	close: ")",
+	encodedClose: "%29",
+	encodedOpen: "%28",
+	open: "("
+};
+/** Patterns matching characters that must be escaped inside link label text. */
+export const LINK_MARKDOWN_ESCAPE_PATTERN = {
+	backslash: /\\/g,
+	closeLabel: /\]/g,
+	lineBreak: /\n/g,
+	openLabel: /\[/g
+};
+/** Escape sequences paired with `LINK_MARKDOWN_ESCAPE_PATTERN`. */
+export const LINK_MARKDOWN_ESCAPE_VALUE = {
+	backslash: "\\",
+	escapedBackslash: "\\\\",
+	escapedCloseLabel: "\\]",
+	escapedLineBreak: "\\n",
+	escapedOpenLabel: "\\[",
+	lineBreakToken: "n"
+};
+/** Discriminant for the parsed rich-text segments (plain text vs. link). */
+export const RICH_TEXT_SEGMENT_TYPE = {
+	link: "link",
+	text: "text"
+};
+/** Whether an editor link is explicit (`[text](url)`) or a suppressed autolink. */
+export const RICH_LINK_KIND = {
+	explicit: "explicit",
+	suppressed: "suppressed"
+};
+/** Origin of a preview link segment: auto-detected URL vs. explicit link. */
+export const RICH_PREVIEW_LINK_SOURCE = {
+	automatic: "automatic",
+	explicit: "explicit"
+};
+/** Editing modes of the link popover. */
+export const RICH_LINK_POPOVER_MODE = {
+	actions: "actions",
+	edit: "edit"
+};
+/**
+* Regular expressions used to detect links in plain text.
+*
+* The URL character classes exclude both `)` and `]` so a URL wrapped in
+* brackets or parentheses (`[https://example.com/path]`) stops at the closing
+* delimiter instead of swallowing it into the link target. Balanced `(...)`
+* inside the URL is still matched through the dedicated paren-balancing group.
+*/
+export const LINK_PATTERN = {
+	bareDomain: /^(?:[a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}[^\s<>)\]]*$/,
+	containsWhitespace: /\s/,
+	bareUrl: /(?:https?:\/\/[^\s<>)\]]*(?:\([^\s<>()]*\)[^\s<>)\]]*)*|(?:[a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}[^\s<>)\]]*(?:\([^\s<>()]*\)[^\s<>)\]]*)*)/g,
+	hostBoundary: /[/?#:]/,
+	markdown: /\[((?:\\[\s\S]|[^\]\\])+)\]\(((?:[^()\s]+|\([^()\s]*\))+)\)/g,
+	protocolPrefix: /^https?:\/\//i,
+	trailingPunctuation: /[.,!?;:]+$/,
+	whitespace: /^\s+$/
+};
+/**
+* Public top-level domains recognized when auto-linking a scheme-less bare
+* domain found in prose. `new URL()` accepts any syntactically valid hostname,
+* so without this allowlist Spanish abbreviations like `EE.UU.` or
+* end-of-sentence transitions like `China.Por` would resolve to bogus hosts and
+* become clickable links. It covers the common gTLDs plus every assigned
+* two-letter ccTLD; unknown suffixes such as `uu` or `por` are intentionally
+* absent. This gates only the automatic detection path: explicit `http(s)://`
+* URLs and links the user pastes deliberately bypass it and stay permissive.
+*/
+export const KNOWN_TOP_LEVEL_DOMAINS = new Set([
+	"com",
+	"net",
+	"org",
+	"info",
+	"biz",
+	"name",
+	"pro",
+	"int",
+	"edu",
+	"gov",
+	"mil",
+	"app",
+	"dev",
+	"io",
+	"co",
+	"ai",
+	"xyz",
+	"online",
+	"site",
+	"tech",
+	"store",
+	"shop",
+	"blog",
+	"me",
+	"tv",
+	"cc",
+	"live",
+	"life",
+	"world",
+	"fun",
+	"space",
+	"website",
+	"page",
+	"web",
+	"link",
+	"click",
+	"news",
+	"media",
+	"studio",
+	"design",
+	"art",
+	"email",
+	"cloud",
+	"digital",
+	"network",
+	"agency",
+	"company",
+	"group",
+	"team",
+	"work",
+	"works",
+	"today",
+	"ltd",
+	"inc",
+	"llc",
+	"academy",
+	"school",
+	"courses",
+	"education",
+	"events",
+	"social",
+	"chat",
+	"video",
+	"photo",
+	"photos",
+	"games",
+	"game",
+	"finance",
+	"money",
+	"health",
+	"fit",
+	"run",
+	"travel",
+	"tours",
+	"global",
+	"international",
+	"solutions",
+	"systems",
+	"consulting",
+	"marketing",
+	"software",
+	"host",
+	"hosting",
+	"wiki",
+	"ac",
+	"ad",
+	"ae",
+	"af",
+	"ag",
+	"al",
+	"am",
+	"ao",
+	"aq",
+	"ar",
+	"as",
+	"at",
+	"au",
+	"aw",
+	"ax",
+	"az",
+	"ba",
+	"bb",
+	"bd",
+	"be",
+	"bf",
+	"bg",
+	"bh",
+	"bi",
+	"bj",
+	"bm",
+	"bn",
+	"bo",
+	"br",
+	"bs",
+	"bt",
+	"bw",
+	"by",
+	"bz",
+	"ca",
+	"cd",
+	"cf",
+	"cg",
+	"ch",
+	"ci",
+	"ck",
+	"cl",
+	"cm",
+	"cn",
+	"cr",
+	"cu",
+	"cv",
+	"cw",
+	"cx",
+	"cy",
+	"cz",
+	"de",
+	"dj",
+	"dk",
+	"dm",
+	"do",
+	"dz",
+	"ec",
+	"ee",
+	"eg",
+	"er",
+	"es",
+	"et",
+	"eu",
+	"fi",
+	"fj",
+	"fk",
+	"fm",
+	"fo",
+	"fr",
+	"ga",
+	"gd",
+	"ge",
+	"gf",
+	"gg",
+	"gh",
+	"gi",
+	"gl",
+	"gm",
+	"gn",
+	"gp",
+	"gq",
+	"gr",
+	"gs",
+	"gt",
+	"gu",
+	"gw",
+	"gy",
+	"hk",
+	"hm",
+	"hn",
+	"hr",
+	"ht",
+	"hu",
+	"id",
+	"ie",
+	"il",
+	"im",
+	"in",
+	"iq",
+	"ir",
+	"is",
+	"it",
+	"je",
+	"jm",
+	"jo",
+	"jp",
+	"ke",
+	"kg",
+	"kh",
+	"ki",
+	"km",
+	"kn",
+	"kp",
+	"kr",
+	"kw",
+	"ky",
+	"kz",
+	"la",
+	"lb",
+	"lc",
+	"li",
+	"lk",
+	"lr",
+	"ls",
+	"lt",
+	"lu",
+	"lv",
+	"ly",
+	"ma",
+	"mc",
+	"md",
+	"mg",
+	"mh",
+	"mk",
+	"ml",
+	"mm",
+	"mn",
+	"mo",
+	"mp",
+	"mq",
+	"mr",
+	"ms",
+	"mt",
+	"mu",
+	"mv",
+	"mw",
+	"mx",
+	"my",
+	"mz",
+	"na",
+	"nc",
+	"ne",
+	"nf",
+	"ng",
+	"ni",
+	"nl",
+	"no",
+	"np",
+	"nr",
+	"nu",
+	"nz",
+	"om",
+	"pa",
+	"pe",
+	"pf",
+	"pg",
+	"ph",
+	"pk",
+	"pl",
+	"pm",
+	"pn",
+	"pr",
+	"ps",
+	"pt",
+	"pw",
+	"py",
+	"qa",
+	"re",
+	"ro",
+	"rs",
+	"ru",
+	"rw",
+	"sa",
+	"sb",
+	"sc",
+	"sd",
+	"se",
+	"sg",
+	"sh",
+	"si",
+	"sk",
+	"sl",
+	"sm",
+	"sn",
+	"so",
+	"sr",
+	"ss",
+	"st",
+	"sv",
+	"sx",
+	"sy",
+	"sz",
+	"tc",
+	"td",
+	"tf",
+	"tg",
+	"th",
+	"tj",
+	"tk",
+	"tl",
+	"tm",
+	"tn",
+	"to",
+	"tr",
+	"tt",
+	"tw",
+	"tz",
+	"ua",
+	"ug",
+	"uk",
+	"us",
+	"uy",
+	"uz",
+	"va",
+	"vc",
+	"ve",
+	"vg",
+	"vi",
+	"vn",
+	"vu",
+	"wf",
+	"ws",
+	"ye",
+	"yt",
+	"za",
+	"zm",
+	"zw"
+]);
+/** Capture group indexes of `LINK_PATTERN.markdown`. */
+export const LINK_MARKDOWN_MATCH_GROUP = {
+	text: 1,
+	url: 2
+};
+/** Sentinel returned by the text diff when no change is found. */
+export const TEXT_DIFF_FALLBACK_INDEX = { notFound: -1 };
+/** Separator used to build a stable key for preview link segments. */
+export const PREVIEW_LINK_KEY_SEPARATOR = { value: ":" };
+/** Clipboard data type read on paste inside the editor. */
+export const RICH_TEXT_CLIPBOARD_DATA_TYPE = { plainText: "text/plain" };
+/** `InputEvent.inputType` values handled by the editor's `beforeInput`. */
+export const RICH_TEXT_EDITOR_INPUT_TYPE = {
+	deleteContentBackward: "deleteContentBackward",
+	deleteContentForward: "deleteContentForward",
+	insertLineBreak: "insertLineBreak",
+	insertParagraph: "insertParagraph",
+	insertText: "insertText"
+};
+/** Keyboard keys handled by the editor's `keydown`. */
+export const RICH_TEXT_EDITOR_KEY = {
+	backspace: "Backspace",
+	delete: "Delete",
+	enter: "Enter"
+};
+/** Direction of a word-wise deletion. */
+export const RICH_TEXT_EDITOR_WORD_DIRECTION = {
+	backward: "backward",
+	forward: "forward"
+};
+/** Length of a single editable character. */
+export const RICH_TEXT_EDITOR_KEY_LENGTH = { character: 1 };
+/** Literal text tokens used by the editor. */
+export const RICH_TEXT_EDITOR_TEXT = { lineBreak: "\n" };