@galaxy-io/dls 1.4.9 → 1.4.11

package/dist/styles.css

@@ -24,28 +24,27 @@
 .c1hcga6s{position:relative;display:var(--c1hcga6s-0);-webkit-flex-direction:var(--c1hcga6s-1);-ms-flex-direction:var(--c1hcga6s-1);flex-direction:var(--c1hcga6s-1);-webkit-align-items:var(--c1hcga6s-2);-webkit-box-align:var(--c1hcga6s-2);-ms-flex-align:var(--c1hcga6s-2);align-items:var(--c1hcga6s-2);-webkit-box-pack:var(--c1hcga6s-3);-ms-flex-pack:var(--c1hcga6s-3);-webkit-justify-content:var(--c1hcga6s-3);justify-content:var(--c1hcga6s-3);width:var(--c1hcga6s-4);min-width:0;height:var(--c1hcga6s-5);min-height:0;}
 .c1fvbgkp{position:relative;width:var(--c1fvbgkp-0);min-width:0;aspect-ratio:var(--c1fvbgkp-1);height:var(--c1fvbgkp-2);-webkit-flex:var(--c1fvbgkp-3);-ms-flex:var(--c1fvbgkp-3);flex:var(--c1fvbgkp-3);min-height:var(--c1fvbgkp-4);}
 .c10uj5yt{display:block;overflow:visible;}
-.cyuty3o[data-active="true"] rect,.cyuty3o[data-active="true"] path,.cyuty3o[data-active="true"] circle{transition-delay:0ms;}
-.c1ob2op2{opacity:1;-webkit-transition:opacity 100ms ease-in-out 200ms;transition:opacity 100ms ease-in-out 200ms;}.c1ob2op2[data-state="muted"]{opacity:0.1;}@media (prefers-reduced-motion: reduce){.c1ob2op2{-webkit-transition:none;transition:none;}}
-.c8c506o{fill:none;stroke-linecap:round;stroke-linejoin:round;pointer-events:none;opacity:1;-webkit-transition:opacity 100ms ease-in-out 200ms;transition:opacity 100ms ease-in-out 200ms;}.c8c506o[data-state="muted"]{opacity:0.1;}@media (prefers-reduced-motion: reduce){.c8c506o{-webkit-transition:none;transition:none;}}
-.ceqlpek{stroke:none;pointer-events:none;opacity:1;-webkit-transition:opacity 100ms ease-in-out 200ms;transition:opacity 100ms ease-in-out 200ms;}.ceqlpek[data-state="muted"]{opacity:0.1;}@media (prefers-reduced-motion: reduce){.ceqlpek{-webkit-transition:none;transition:none;}}
-.c1fcbddl{pointer-events:none;opacity:1;-webkit-transition:opacity 100ms ease-in-out 200ms;transition:opacity 100ms ease-in-out 200ms;}.c1fcbddl[data-state="muted"]{opacity:0.1;}@media (prefers-reduced-motion: reduce){.c1fcbddl{-webkit-transition:none;transition:none;}}
-.cpcxr59{opacity:1;-webkit-transition:opacity 100ms ease-in-out 200ms;transition:opacity 100ms ease-in-out 200ms;}.cpcxr59[data-state="muted"]{opacity:0.1;}@media (prefers-reduced-motion: reduce){.cpcxr59{-webkit-transition:none;transition:none;}}
+.cyuty3o{opacity:1;}.cyuty3o[data-state="muted"]{opacity:0.1;}
+.c1ob2op2{fill:none;stroke-linecap:round;stroke-linejoin:round;pointer-events:none;opacity:1;}.c1ob2op2[data-state="muted"]{opacity:0.1;}
+.c8c506o{stroke:none;pointer-events:none;opacity:1;}.c8c506o[data-state="muted"]{opacity:0.1;}
+.ceqlpek{pointer-events:none;opacity:1;}.ceqlpek[data-state="muted"]{opacity:0.1;}
+.c1fcbddl{opacity:1;}.c1fcbddl[data-state="muted"]{opacity:0.1;}
+.cpcxr59{fill:transparent;outline:none;}
 .c1wvzvu4{fill:transparent;outline:none;}
-.c17guewt{fill:transparent;outline:none;}
-.cblgiyf{stroke:var(--cblgiyf-0);shape-rendering:crispEdges;}
-.c1lr03cc{stroke:var(--c1lr03cc-0);pointer-events:none;}
-.cizy1s8{overflow:visible;pointer-events:none;}
-.c1ukq11d{position:absolute;z-index:10;pointer-events:none;left:var(--c1ukq11d-0);top:var(--c1ukq11d-1);min-width:168px;max-width:320px;padding:10px 12px;border:0.5px solid var(--c1ukq11d-2);border-radius:6px;background-color:var(--c1ukq11d-3);opacity:var(--c1ukq11d-4);-webkit-transition:opacity 100ms ease-in-out,left 100ms ease-out,top 100ms ease-out;transition:opacity 100ms ease-in-out,left 100ms ease-out,top 100ms ease-out;}@media (prefers-reduced-motion: reduce){.c1ukq11d{-webkit-transition:none;transition:none;}}
-.cwcko2m{display:-ms-grid;display:grid;-ms-grid-columns:minmax(0, 1fr) auto;grid-template-columns:minmax(0, 1fr) auto;-webkit-column-gap:16px;column-gap:16px;row-gap:6px;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;width:100%;}
-.cqwhvyz{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:6px;min-width:0;}
-.c1iaray{text-align:right;white-space:nowrap;}
-.cz6jod1{position:absolute;left:var(--cz6jod1-0);top:var(--cz6jod1-1);width:var(--cz6jod1-2);height:var(--cz6jod1-2);-webkit-transform:translate(-50%, -50%);-moz-transform:translate(-50%, -50%);-ms-transform:translate(-50%, -50%);transform:translate(-50%, -50%);pointer-events:none;text-align:center;}
-.c1de5mqk{position:absolute;top:38%;left:50%;-webkit-transform:translate(-50%, -50%);-moz-transform:translate(-50%, -50%);-ms-transform:translate(-50%, -50%);transform:translate(-50%, -50%);max-width:60%;padding:6px 8px;border:0.5px solid var(--c1de5mqk-0);border-radius:6px;background-color:var(--c1de5mqk-1);pointer-events:none;text-align:center;}
-.cjirv6a{position:relative;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:var(--cjirv6a-0);-ms-flex-direction:var(--cjirv6a-0);flex-direction:var(--cjirv6a-0);-webkit-box-flex-wrap:nowrap;-webkit-flex-wrap:nowrap;-ms-flex-wrap:nowrap;flex-wrap:nowrap;-webkit-align-items:var(--cjirv6a-1);-webkit-box-align:var(--cjirv6a-1);-ms-flex-align:var(--cjirv6a-1);align-items:var(--cjirv6a-1);-webkit-box-pack:var(--cjirv6a-2);-ms-flex-pack:var(--cjirv6a-2);-webkit-justify-content:var(--cjirv6a-2);justify-content:var(--cjirv6a-2);gap:var(--cjirv6a-3);width:var(--cjirv6a-4);min-width:var(--cjirv6a-5);height:var(--cjirv6a-6);-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;padding-top:var(--cjirv6a-7);padding-left:var(--cjirv6a-8);}.cjirv6a[data-active="true"] [data-state]{transition-delay:0ms;}
-.c1armna5{position:absolute;visibility:hidden;pointer-events:none;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:var(--c1armna5-0);-ms-flex-direction:var(--c1armna5-0);flex-direction:var(--c1armna5-0);-webkit-box-flex-wrap:nowrap;-webkit-flex-wrap:nowrap;-ms-flex-wrap:nowrap;flex-wrap:nowrap;-webkit-align-items:var(--c1armna5-1);-webkit-box-align:var(--c1armna5-1);-ms-flex-align:var(--c1armna5-1);align-items:var(--c1armna5-1);gap:var(--c1armna5-2);width:-webkit-max-content;width:-moz-max-content;width:max-content;height:-webkit-max-content;height:-moz-max-content;height:max-content;white-space:nowrap;}
-.cgd77rv{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:column;-ms-flex-direction:column;flex-direction:column;-webkit-align-items:flex-start;-webkit-box-align:flex-start;-ms-flex-align:flex-start;align-items:flex-start;gap:8px;max-height:208px;overflow-y:auto;}.cgd77rv[data-active="true"] [data-state]{transition-delay:0ms;}
-.cutidpi{display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:6px;-webkit-appearance:none;-moz-appearance:none;-ms-appearance:none;appearance:none;background:none;border:0;padding:0;margin:0;font:inherit;color:inherit;cursor:default;border-radius:2px;opacity:1;-webkit-transition:opacity 100ms ease-in-out 200ms;transition:opacity 100ms ease-in-out 200ms;}.cutidpi[data-state="muted"]{opacity:0.1;}@media (prefers-reduced-motion: reduce){.cutidpi{-webkit-transition:none;transition:none;}}.cutidpi:focus-visible{outline:1.5px solid currentColor;outline-offset:2px;}
-.ccpczg{display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:6px;opacity:1;-webkit-transition:opacity 100ms ease-in-out 200ms;transition:opacity 100ms ease-in-out 200ms;}.ccpczg[data-state="muted"]{opacity:0.1;}@media (prefers-reduced-motion: reduce){.ccpczg{-webkit-transition:none;transition:none;}}
+.c17guewt{stroke:var(--c17guewt-0);shape-rendering:crispEdges;}
+.cblgiyf{stroke:var(--cblgiyf-0);pointer-events:none;}
+.c1lr03cc{overflow:visible;pointer-events:none;}
+.cizy1s8{position:absolute;z-index:10;pointer-events:none;left:var(--cizy1s8-0);top:var(--cizy1s8-1);min-width:168px;max-width:320px;padding:10px 12px;border:0.5px solid var(--cizy1s8-2);border-radius:6px;background-color:var(--cizy1s8-3);opacity:var(--cizy1s8-4);-webkit-transition:opacity 100ms ease-in-out,left 100ms ease-out,top 100ms ease-out;transition:opacity 100ms ease-in-out,left 100ms ease-out,top 100ms ease-out;}@media (prefers-reduced-motion: reduce){.cizy1s8{-webkit-transition:none;transition:none;}}
+.c1ukq11d{display:-ms-grid;display:grid;-ms-grid-columns:minmax(0, 1fr) auto;grid-template-columns:minmax(0, 1fr) auto;-webkit-column-gap:16px;column-gap:16px;row-gap:6px;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;width:100%;}
+.cwcko2m{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:6px;min-width:0;}
+.cqwhvyz{text-align:right;white-space:nowrap;}
+.c1iaray{position:absolute;left:var(--c1iaray-0);top:var(--c1iaray-1);width:var(--c1iaray-2);height:var(--c1iaray-2);-webkit-transform:translate(-50%, -50%);-moz-transform:translate(-50%, -50%);-ms-transform:translate(-50%, -50%);transform:translate(-50%, -50%);pointer-events:none;text-align:center;}
+.cz6jod1{position:absolute;top:38%;left:50%;-webkit-transform:translate(-50%, -50%);-moz-transform:translate(-50%, -50%);-ms-transform:translate(-50%, -50%);transform:translate(-50%, -50%);max-width:60%;padding:6px 8px;border:0.5px solid var(--cz6jod1-0);border-radius:6px;background-color:var(--cz6jod1-1);pointer-events:none;text-align:center;}
+.c1de5mqk{position:relative;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:var(--c1de5mqk-0);-ms-flex-direction:var(--c1de5mqk-0);flex-direction:var(--c1de5mqk-0);-webkit-box-flex-wrap:nowrap;-webkit-flex-wrap:nowrap;-ms-flex-wrap:nowrap;flex-wrap:nowrap;-webkit-align-items:var(--c1de5mqk-1);-webkit-box-align:var(--c1de5mqk-1);-ms-flex-align:var(--c1de5mqk-1);align-items:var(--c1de5mqk-1);-webkit-box-pack:var(--c1de5mqk-2);-ms-flex-pack:var(--c1de5mqk-2);-webkit-justify-content:var(--c1de5mqk-2);justify-content:var(--c1de5mqk-2);gap:var(--c1de5mqk-3);width:var(--c1de5mqk-4);min-width:var(--c1de5mqk-5);height:var(--c1de5mqk-6);-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;padding-top:var(--c1de5mqk-7);padding-left:var(--c1de5mqk-8);}
+.cjirv6a{position:absolute;visibility:hidden;pointer-events:none;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:var(--cjirv6a-0);-ms-flex-direction:var(--cjirv6a-0);flex-direction:var(--cjirv6a-0);-webkit-box-flex-wrap:nowrap;-webkit-flex-wrap:nowrap;-ms-flex-wrap:nowrap;flex-wrap:nowrap;-webkit-align-items:var(--cjirv6a-1);-webkit-box-align:var(--cjirv6a-1);-ms-flex-align:var(--cjirv6a-1);align-items:var(--cjirv6a-1);gap:var(--cjirv6a-2);width:-webkit-max-content;width:-moz-max-content;width:max-content;height:-webkit-max-content;height:-moz-max-content;height:max-content;white-space:nowrap;}
+.c1armna5{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:column;-ms-flex-direction:column;flex-direction:column;-webkit-align-items:flex-start;-webkit-box-align:flex-start;-ms-flex-align:flex-start;align-items:flex-start;gap:8px;max-height:208px;overflow-y:auto;}
+.cgd77rv{display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:6px;-webkit-appearance:none;-moz-appearance:none;-ms-appearance:none;appearance:none;background:none;border:0;padding:0;margin:0;font:inherit;color:inherit;cursor:default;border-radius:2px;opacity:1;}.cgd77rv[data-state="muted"]{opacity:0.1;}.cgd77rv:focus-visible{outline:1.5px solid currentColor;outline-offset:2px;}
+.cutidpi{display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:6px;opacity:1;}.cutidpi[data-state="muted"]{opacity:0.1;}
 .cmbdg2q{width:var(--cmbdg2q-0);height:var(--cmbdg2q-0);border-radius:50%;background-color:var(--cmbdg2q-1);}
 .tbnx4ok{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;}
 .tjda4tq{display:inline-block;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content;max-width:-webkit-max-content;max-width:-moz-max-content;max-width:max-content;padding:var(--tjda4tq-0);background-color:var(--tjda4tq-1);border:var(--tjda4tq-2);border-radius:5px;}

package/dist/table/InfiniteSpreadsheet.d.ts

@@ -2,5 +2,12 @@ import { type InfiniteSpreadsheetProps } from "./types";
 export { ColumnAlign, ColumnPin, ColumnResizeMode, TableDensity, TableVariant } from "./types";
 export type { ColumnSizingState, EditingCell, InfiniteSpreadsheetProps, Row, SpreadsheetColumnAction, SpreadsheetColumnDef, SpreadsheetHeaderAction, SpreadsheetRowAction, SpreadsheetRowsContext, } from "./types";
 export { CellEnrichmentStatus, SpreadsheetCellType } from "./types";
+/**
+ * An editable grid — cell-level editing, keyboard navigation between cells, and
+ * per-row actions, over the same infinite-scroll machinery as `InfiniteTable`.
+ *
+ * Reach for this when cells are inputs. When the data is read-only, the tables
+ * are lighter.
+ */
 declare function InfiniteSpreadsheet<TData>(props: InfiniteSpreadsheetProps<TData>): import("react").JSX.Element;
 export default InfiniteSpreadsheet;

package/dist/table/InfiniteSpreadsheet.js

@@ -18,6 +18,13 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { PlusIcon } from "@phosphor-icons/react";
 import { useVirtualizer } from "@tanstack/react-virtual";
 //#region src/table/InfiniteSpreadsheet.tsx
+/**
+* An editable grid — cell-level editing, keyboard navigation between cells, and
+* per-row actions, over the same infinite-scroll machinery as `InfiniteTable`.
+*
+* Reach for this when cells are inputs. When the data is read-only, the tables
+* are lighter.
+*/
 function InfiniteSpreadsheet(props) {
 	const { columns, totalRowCount, getRowData, getRowId, height, width, fillWidth, fillHeight, density = TableDensity.MEDIUM, variant = TableVariant.PRIMARY, estimateRowHeight, overscan = 25, hasNextPage, isFetchingNextPage, fetchNextPage, isLoading = false, isError = false, error, loadingRowCount = 5, contentWhenEmpty, contentWhenError, noHeader = false, noLastRowBorder = false, noLastRowPadding = false, enableColumnResizing = true, columnSizing, defaultColumnSizing, onColumnSizingChange, columnResizeMode = ColumnResizeMode.ON_CHANGE, ariaLabel, ariaLabelledBy, onAddColumn, addColumnAriaLabel = "Add column", rowActions, getRowActionsAriaLabel, editingCell: controlledEditingCell, onEditingCellChange, enableRowFocus = true } = props;
 	const scrollContainerRef = useRef(null);

package/dist/table/InfiniteTable.d.ts

@@ -4,6 +4,14 @@ import { type InfiniteTableProps } from "./types";
 export { ColumnAlign, ColumnPin, ColumnResizeMode, TableDensity, TableVariant } from "./types";
 export type { ColumnDef, ColumnSizingState, EstimateColumnWidthOptions, InfiniteTableProps, Row, } from "./types";
 export { estimateColumnWidth } from "./utils";
+/**
+ * A data table with infinite scroll, sorting, row selection, expandable rows and
+ * resizable columns. Define the shape with `ColumnDef[]`; `TData` is inferred
+ * from your row type.
+ *
+ * Renders every loaded row. Past a few thousand rows reach for
+ * `VirtualizedInfiniteTable`, which shares the same column and row API.
+ */
 declare function InfiniteTable<TData>(props: InfiniteTableProps<TData>): React.JSX.Element;
 export default InfiniteTable;
 export type { TanstackTable as Table };

package/dist/table/InfiniteTable.js

@@ -18,6 +18,14 @@ import React, { useCallback, useEffect, useId, useMemo, useRef } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { flexRender, getCoreRowModel, getExpandedRowModel, getSortedRowModel, useReactTable } from "@tanstack/react-table";
 //#region src/table/InfiniteTable.tsx
+/**
+* A data table with infinite scroll, sorting, row selection, expandable rows and
+* resizable columns. Define the shape with `ColumnDef[]`; `TData` is inferred
+* from your row type.
+*
+* Renders every loaded row. Past a few thousand rows reach for
+* `VirtualizedInfiniteTable`, which shares the same column and row API.
+*/
 function InfiniteTable(props) {
 	const { columns, data, getRowId, height, width, fillWidth, fillHeight, density = TableDensity.MEDIUM, variant = TableVariant.PRIMARY, hasNextPage, isFetchingNextPage, fetchNextPage, enableRowSelection, enableMultiRowSelection = true, rowSelection, defaultRowSelection, onRowSelectionChange, onSelectedRowsChange, showSelectionColumn = false, selectionColumnPin = ColumnPin.LEFT, enableSelectAll, enableSelectionRange = true, selectAllAriaLabel = "Select all rows", getRowSelectAriaLabel, enableSorting = false, enableMultiSort = false, sorting, onSortingChange, manualSorting = false, isLoading = false, isError = false, error, loadingRowCount = 5, contentWhenEmpty, contentWhenError, noHeader = false, noLastRowBorder = false, noLastRowPadding = false, onRowClick, onRowDoubleClick, onRowActivate, onRowExpand, expandedRowIds, defaultExpandedRowIds, onExpandedChange, getRowCanExpand, enableMultiRowExpansion = true, showExpandColumn = true, expandColumnPin = ColumnPin.LEFT, enableColumnResizing = false, columnSizing, defaultColumnSizing, onColumnSizingChange, columnResizeMode = ColumnResizeMode.ON_CHANGE, ariaLabel, ariaLabelledBy, getRowAriaLabel, enableRowFocus, onTableReady } = props;
 	const instanceId = useId();

package/dist/table/VirtualizedInfiniteTable.d.ts

@@ -8,5 +8,12 @@ export type { ColumnDef, ColumnSizingState, Row, VirtualizedInfiniteTableProps }
  * resolves.
  */
 export type InfiniteTableProps<TData> = VirtualizedInfiniteTableProps<TData>;
+/**
+ * `InfiniteTable` with row virtualization — only the visible window is in the
+ * DOM, so it stays responsive at tens of thousands of rows.
+ *
+ * The trade is a fixed row height and no natural content sizing. Prefer plain
+ * `InfiniteTable` until row count actually becomes the problem.
+ */
 declare function VirtualizedInfiniteTable<TData>(props: VirtualizedInfiniteTableProps<TData>): React.JSX.Element;
 export default VirtualizedInfiniteTable;

package/dist/table/VirtualizedInfiniteTable.js

@@ -42,6 +42,13 @@ function VirtualizedRowInner({ rowData, rowIndex, translateY, rowHeight, density
 	});
 }
 var VirtualizedRow = React.memo(VirtualizedRowInner);
+/**
+* `InfiniteTable` with row virtualization — only the visible window is in the
+* DOM, so it stays responsive at tens of thousands of rows.
+*
+* The trade is a fixed row height and no natural content sizing. Prefer plain
+* `InfiniteTable` until row count actually becomes the problem.
+*/
 function VirtualizedInfiniteTable(props) {
 	const { columns, totalRowCount, getRowData, getRowId, height, width, fillWidth, fillHeight, density = TableDensity.MEDIUM, variant = TableVariant.PRIMARY, estimateRowHeight, overscan = 25, hasNextPage, isFetchingNextPage, fetchNextPage, isLoading = false, isError = false, error, loadingRowCount = 5, contentWhenEmpty, contentWhenError, noHeader = false, noLastRowBorder = false, noLastRowPadding = false, enableColumnResizing = false, columnSizing, defaultColumnSizing, onColumnSizingChange, columnResizeMode = ColumnResizeMode.ON_CHANGE, ariaLabel, ariaLabelledBy, onRowClick } = props;
 	const scrollContainerRef = useRef(null);

package/dist/text/Bold.d.ts

@@ -1,3 +1,7 @@
 import type { PropsWithChildren } from "react";
+/**
+ * Bumps its children to the medium weight. Nest it inside a `Text` to emphasize
+ * part of a string — DLS has only two weights, so this is as bold as type gets.
+ */
 declare const Bold: ({ children }: PropsWithChildren) => import("react").JSX.Element;
 export default Bold;

package/dist/text/Bold.js

@@ -10,6 +10,10 @@ var StyledBoldText = withTheme(/*#__PURE__*/ styled("span")({
 	propsAsIs: false,
 	vars: { "s10i74tu-0": [_exp()] }
 }));
+/**
+* Bumps its children to the medium weight. Nest it inside a `Text` to emphasize
+* part of a string — DLS has only two weights, so this is as bold as type gets.
+*/
 var Bold = ({ children }) => {
 	return /* @__PURE__ */ jsx(StyledBoldText, { children });
 };

package/dist/text/Code.d.ts

@@ -1,3 +1,7 @@
 import type { PropsWithChildren } from "react";
+/**
+ * Inline code — mono family on a tinted, hairline-bordered chip. Nest it inside
+ * a `Text` for identifiers and literals in prose.
+ */
 declare const Code: ({ children }: PropsWithChildren) => import("react").JSX.Element;
 export default Code;

package/dist/text/Code.js

@@ -20,6 +20,10 @@ var StyledCodeText = withTheme(/*#__PURE__*/ styled("span")({
 		"sdpyy92-4": [_exp5()]
 	}
 }));
+/**
+* Inline code — mono family on a tinted, hairline-bordered chip. Nest it inside
+* a `Text` for identifiers and literals in prose.
+*/
 var Code = ({ children }) => {
 	return /* @__PURE__ */ jsx(StyledCodeText, { children });
 };

package/dist/text/EditableText.d.ts

@@ -1,7 +1,16 @@
 import { type TextProps } from "./Text";
-type EditableTextProps = TextProps & {
+export type EditableTextProps = TextProps & {
+    /** Current text. Also the value the field resets to on cancel. */
     label: string;
+    /** Called with the new text when the edit is committed. */
     onSave: (text: string) => void;
 };
+/**
+ * Click-to-edit text. Renders as `Text` until clicked, then swaps to an inline
+ * input. Accepts every `TextProps` styling prop on top of its own.
+ *
+ * Holds the draft internally and only calls `onSave` on commit, so it works as
+ * an uncontrolled field — `label` is the starting value, not a bound one.
+ */
 declare const EditableText: ({ label, onSave, size, variant, weight, align, isMonospace, ...textProps }: EditableTextProps) => import("react").JSX.Element;
 export default EditableText;

package/dist/text/EditableText.js

@@ -50,6 +50,13 @@ var EditableTextText = withTheme(/*#__PURE__*/ styled("span")({
 	propsAsIs: false,
 	vars: { "e1j2x5d3-0": [_exp9()] }
 }));
+/**
+* Click-to-edit text. Renders as `Text` until clicked, then swaps to an inline
+* input. Accepts every `TextProps` styling prop on top of its own.
+*
+* Holds the draft internally and only calls `onSave` on commit, so it works as
+* an uncontrolled field — `label` is the starting value, not a bound one.
+*/
 var EditableText = ({ label, onSave, size = TextSize.BODY_MD, variant = TextVariant.PRIMARY, weight = TextWeight.REGULAR, align = "left", isMonospace = false, ...textProps }) => {
 	const [state, setState] = useState(() => ({
 		localLabel: label,

package/dist/text/Ellipsis.d.ts

@@ -1,10 +1,12 @@
 export interface EllipsisProps {
+    /** Animate the dots. Static when false. */
     isPulse?: boolean;
-    /**
-     * The speed of the pulse animation in seconds.
-     * @default 1.4
-     */
+    /** Duration of one pulse cycle in seconds. @default 1 */
     speed?: number;
 }
+/**
+ * Three dots that pulse in sequence — the "…thinking" affordance. Renders the
+ * literal characters, so it aligns with adjacent text rather than a spinner.
+ */
 declare const Ellipsis: ({ isPulse, speed }: EllipsisProps) => import("react").JSX.Element;
 export default Ellipsis;

package/dist/text/Ellipsis.js

@@ -13,6 +13,10 @@ var StyledEllipsis = /*#__PURE__*/ styled("span")({
 		"szfsuud-1": [_exp2()]
 	}
 });
+/**
+* Three dots that pulse in sequence — the "…thinking" affordance. Renders the
+* literal characters, so it aligns with adjacent text rather than a spinner.
+*/
 var Ellipsis = ({ isPulse = false, speed = 1 }) => {
 	return /* @__PURE__ */ jsxs(StyledEllipsis, {
 		$isPulse: isPulse,

package/dist/text/HotKeys.d.ts

@@ -1,3 +1,4 @@
+/** Key-cap contrast. Step it down when the shortcut is secondary to its label. */
 export declare enum HotKeysVariant {
     BASE = "BASE",
     PRIMARY = "PRIMARY",
@@ -5,16 +6,25 @@ export declare enum HotKeysVariant {
     TERTIARY = "TERTIARY",
     DISABLED = "DISABLED"
 }
+/** Key-cap size — 14 / 16 / 18px minimum width. Match the adjacent text. */
 export declare enum HotKeysSize {
     SMALL = "SMALL",
     MEDIUM = "MEDIUM",
     LARGE = "LARGE"
 }
 export interface HotKeysProps {
+    /** One cap per entry, in press order — e.g. `["⌘", "K"]`. Rendered verbatim. */
     hotKeys: string[];
+    /** @default HotKeysVariant.BASE */
     variant?: HotKeysVariant;
+    /** @default HotKeysSize.MEDIUM */
     size?: HotKeysSize;
+    /** Render caps in the mono family. */
     isMonospace?: boolean;
 }
+/**
+ * Renders a keyboard shortcut as a row of key caps. Display only — it does not
+ * bind anything; wire the actual handler yourself.
+ */
 declare const HotKeys: ({ hotKeys, variant, size, isMonospace, }: HotKeysProps) => import("react").JSX.Element;
 export default HotKeys;

package/dist/text/HotKeys.js

@@ -4,6 +4,7 @@ import { styled } from "@linaria/react";
 import { match } from "ts-pattern";
 import { jsx } from "react/jsx-runtime";
 //#region src/text/HotKeys.tsx
+/** Key-cap contrast. Step it down when the shortcut is secondary to its label. */
 var HotKeysVariant = /* @__PURE__ */ function(HotKeysVariant) {
 	HotKeysVariant["BASE"] = "BASE";
 	HotKeysVariant["PRIMARY"] = "PRIMARY";
@@ -12,6 +13,7 @@ var HotKeysVariant = /* @__PURE__ */ function(HotKeysVariant) {
 	HotKeysVariant["DISABLED"] = "DISABLED";
 	return HotKeysVariant;
 }({});
+/** Key-cap size — 14 / 16 / 18px minimum width. Match the adjacent text. */
 var HotKeysSize = /* @__PURE__ */ function(HotKeysSize) {
 	HotKeysSize["SMALL"] = "SMALL";
 	HotKeysSize["MEDIUM"] = "MEDIUM";
@@ -56,6 +58,10 @@ var StyledHotKey = withTheme(/*#__PURE__*/ styled("div")({
 		"sl247mt-7": [_exp9()]
 	}
 }));
+/**
+* Renders a keyboard shortcut as a row of key caps. Display only — it does not
+* bind anything; wire the actual handler yourself.
+*/
 var HotKeys = ({ hotKeys, variant, size = "MEDIUM", isMonospace = false }) => {
 	return /* @__PURE__ */ jsx(HotKeysWrapper, { children: hotKeys.map((hotKey) => /* @__PURE__ */ jsx(StyledHotKey, {
 		$variant: variant,

package/dist/text/MarkdownText.d.ts

@@ -1,7 +1,15 @@
 import { type Components } from "react-markdown";
-interface MarkdownTextProps {
+export interface MarkdownTextProps {
+    /** Markdown source. GitHub-flavored, and raw HTML is allowed through. */
     content: string;
+    /** Replace the renderer for specific tags. Merged over the DLS defaults. */
     componentOverrides?: Partial<Components>;
 }
+/**
+ * Renders Markdown using DLS components — headings, lists, tables and code all
+ * come out on theme tokens rather than browser defaults.
+ *
+ * Raw HTML in `content` is rendered, not escaped. Don't pass untrusted input.
+ */
 declare const MarkdownText: ({ content, componentOverrides }: MarkdownTextProps) => import("react").JSX.Element;
 export default MarkdownText;

package/dist/text/MarkdownText.js

@@ -297,6 +297,12 @@ var markdownComponents = {
 		children
 	})
 };
+/**
+* Renders Markdown using DLS components — headings, lists, tables and code all
+* come out on theme tokens rather than browser defaults.
+*
+* Raw HTML in `content` is rendered, not escaped. Don't pass untrusted input.
+*/
 var MarkdownText = ({ content, componentOverrides }) => {
 	const components = componentOverrides ? {
 		...markdownComponents,

package/dist/text/Paragraph.d.ts

@@ -1,16 +1,33 @@
 import type { CSSProperties, PropsWithChildren } from "react";
 import { TextSize, TextVariant, TextWeight } from "./Text";
 export interface ParagraphProps {
+    /** Color role. @default TextVariant.PRIMARY */
     variant?: TextVariant;
+    /** Type scale step. @default TextSize.BODY_MD */
     size?: TextSize;
+    /** @default TextWeight.REGULAR */
     weight?: TextWeight;
+    /** @default "left" */
     align?: CSSProperties["textAlign"];
+    /** Cursor over the text. Inherits from the parent when unset. */
     cursor?: CSSProperties["cursor"];
+    /** Raw color that bypasses `variant`. Escape hatch — prefer `variant`. */
     hex?: string;
+    /** Render in the mono family (Berkeley Mono) instead of sans. */
     isMonospace?: boolean;
+    /** Let the user select the text. Off by default so UI chrome isn't selectable. */
     isSelectable?: boolean;
+    /** Truncate after this many lines with an ellipsis. Omit to let it run. */
     lineClamp?: number;
+    /** Reserve height so clamped copy doesn't shift layout. Defaults to `lineClamp` em. */
     minHeight?: string;
 }
+/**
+ * Multi-line body copy. Same tokens as `Text`, but with a 1.25× line height for
+ * readability and `lineClamp` instead of single-line ellipsis.
+ *
+ * Use `Text` for labels and single-line UI strings; reach for this when the copy
+ * is a real paragraph.
+ */
 declare const Paragraph: ({ children, size, variant, weight, align, cursor, isMonospace, isSelectable, lineClamp, minHeight, hex, }: PropsWithChildren<ParagraphProps>) => import("react").JSX.Element;
 export default Paragraph;

package/dist/text/Paragraph.js

@@ -57,6 +57,13 @@ var StyledParagraph = withTheme(/*#__PURE__*/ styled("span")({
 		"sts1mtj-14": [_exp16()]
 	}
 }));
+/**
+* Multi-line body copy. Same tokens as `Text`, but with a 1.25× line height for
+* readability and `lineClamp` instead of single-line ellipsis.
+*
+* Use `Text` for labels and single-line UI strings; reach for this when the copy
+* is a real paragraph.
+*/
 var Paragraph = ({ children, size = TextSize.BODY_MD, variant = TextVariant.PRIMARY, weight = TextWeight.REGULAR, align = "left", cursor, isMonospace = false, isSelectable = false, lineClamp, minHeight, hex }) => {
 	return /* @__PURE__ */ jsx(StyledParagraph, {
 		$size: size,

package/dist/text/RequiredMarker.d.ts

@@ -1,6 +1,8 @@
 import { TextSize } from "./Text";
-interface RequiredMarkerProps {
+export interface RequiredMarkerProps {
+    /** Match the size of the label it sits beside. @default TextSize.BODY_MD */
     size?: TextSize;
 }
+/** The red asterisk marking a required field. Inputs render it from `isRequired`. */
 declare const RequiredMarker: ({ size }: RequiredMarkerProps) => import("react").JSX.Element;
 export default RequiredMarker;

package/dist/text/RequiredMarker.js

@@ -34,6 +34,7 @@ var StyledRequiredMarker = withTheme(/*#__PURE__*/ styled("span")({
 		"s1i18c6k-5": [_exp6()]
 	}
 }));
+/** The red asterisk marking a required field. Inputs render it from `isRequired`. */
 var RequiredMarker = ({ size = TextSize.BODY_MD }) => {
 	return /* @__PURE__ */ jsx(StyledRequiredMarker, {
 		$size: size,

package/dist/text/Selectable.d.ts

@@ -1,3 +1,7 @@
 import type { PropsWithChildren } from "react";
+/**
+ * Makes its children selectable. DLS text is `user-select: none` by default so
+ * UI chrome doesn't highlight — wrap the parts a user should be able to copy.
+ */
 declare const Selectable: ({ children }: PropsWithChildren) => import("react").JSX.Element;
 export default Selectable;

package/dist/text/Selectable.js

@@ -8,6 +8,10 @@ var StyledSelectable = withTheme(/*#__PURE__*/ styled("span")({
 	class: "sfziwh",
 	propsAsIs: false
 }));
+/**
+* Makes its children selectable. DLS text is `user-select: none` by default so
+* UI chrome doesn't highlight — wrap the parts a user should be able to copy.
+*/
 var Selectable = ({ children }) => {
 	return /* @__PURE__ */ jsx(StyledSelectable, { children });
 };

package/dist/text/Text.d.ts

@@ -1,4 +1,5 @@
 import type { CSSProperties, PropsWithChildren } from "react";
+/** Text color role. Resolves to a `theme.color.text.*` token in both themes. */
 export declare enum TextVariant {
     PRIMARY = "PRIMARY",
     PRIMARY_ALT = "PRIMARY_ALT",
@@ -18,6 +19,7 @@ export declare enum TextVariant {
     PURPLE = "PURPLE",
     DISABLED = "DISABLED"
 }
+/** Type scale step. Sets font-size, line-height and letter-spacing together. */
 export declare enum TextSize {
     CAPTION = "CAPTION",
     BODY_SM = "BODY_SM",
@@ -27,21 +29,38 @@ export declare enum TextSize {
     HEADING_MD = "HEADING_MD",
     HEADING_LG = "HEADING_LG"
 }
+/** Font weight. Two steps by design — hierarchy comes from size, not weight. */
 export declare enum TextWeight {
     REGULAR = "REGULAR",
     MEDIUM = "MEDIUM"
 }
 export interface TextProps {
+    /** Color role. @default TextVariant.PRIMARY */
     variant?: TextVariant;
+    /** Type scale step. @default TextSize.BODY_MD */
     size?: TextSize;
+    /** @default TextWeight.REGULAR */
     weight?: TextWeight;
+    /** @default "left" */
     align?: CSSProperties["textAlign"];
+    /** Cursor over the text. Inherits from the parent when unset. */
     cursor?: CSSProperties["cursor"];
+    /** Raw color that bypasses `variant`. Escape hatch — prefer `variant`. */
     hex?: string;
+    /** Render in the mono family (Berkeley Mono) instead of sans. */
     isMonospace?: boolean;
+    /** Let the user select the text. Off by default so UI chrome isn't selectable. */
     isSelectable?: boolean;
     isUnderlined?: boolean;
+    /** Truncate to one line with an ellipsis. Needs a width-bounded parent. */
     isEllipsis?: boolean;
 }
+/**
+ * The text primitive. Every string in a Galaxy UI renders through it, so color,
+ * size and weight always resolve from theme tokens rather than raw CSS.
+ *
+ * Renders a `<p>`. For inline treatments nest `Bold`, `Code`, `Selectable` or
+ * `HotKeys` inside it rather than reaching for a raw tag.
+ */
 declare const Text: ({ children, size, variant, weight, align, cursor, isMonospace, isSelectable, isUnderlined, isEllipsis, hex, }: PropsWithChildren<TextProps>) => import("react").JSX.Element;
 export default Text;

package/dist/text/Text.js

@@ -4,6 +4,7 @@ import { styled } from "@linaria/react";
 import { match } from "ts-pattern";
 import { jsx } from "react/jsx-runtime";
 //#region src/text/Text.tsx
+/** Text color role. Resolves to a `theme.color.text.*` token in both themes. */
 var TextVariant = /* @__PURE__ */ function(TextVariant) {
 	TextVariant["PRIMARY"] = "PRIMARY";
 	TextVariant["PRIMARY_ALT"] = "PRIMARY_ALT";
@@ -24,6 +25,7 @@ var TextVariant = /* @__PURE__ */ function(TextVariant) {
 	TextVariant["DISABLED"] = "DISABLED";
 	return TextVariant;
 }({});
+/** Type scale step. Sets font-size, line-height and letter-spacing together. */
 var TextSize = /* @__PURE__ */ function(TextSize) {
 	TextSize["CAPTION"] = "CAPTION";
 	TextSize["BODY_SM"] = "BODY_SM";
@@ -34,6 +36,7 @@ var TextSize = /* @__PURE__ */ function(TextSize) {
 	TextSize["HEADING_LG"] = "HEADING_LG";
 	return TextSize;
 }({});
+/** Font weight. Two steps by design — hierarchy comes from size, not weight. */
 var TextWeight = /* @__PURE__ */ function(TextWeight) {
 	TextWeight["REGULAR"] = "REGULAR";
 	TextWeight["MEDIUM"] = "MEDIUM";
@@ -85,6 +88,13 @@ var StyledText = withTheme(/*#__PURE__*/ styled("p")({
 		"shbcgkd-13": [_exp15()]
 	}
 }));
+/**
+* The text primitive. Every string in a Galaxy UI renders through it, so color,
+* size and weight always resolve from theme tokens rather than raw CSS.
+*
+* Renders a `<p>`. For inline treatments nest `Bold`, `Code`, `Selectable` or
+* `HotKeys` inside it rather than reaching for a raw tag.
+*/
 var Text = ({ children, size = "BODY_MD", variant = "PRIMARY", weight = "REGULAR", align = "left", cursor, isMonospace = false, isSelectable = false, isUnderlined = false, isEllipsis = false, hex }) => {
 	return /* @__PURE__ */ jsx(StyledText, {
 		$size: size,

package/dist/text/TextShimmer.d.ts

@@ -1,7 +1,14 @@
 export interface TextShimmerProps {
+    /** A number is px. Match the line height of the text being stood in for. */
     height: number | string;
+    /** A number is px. */
     width: number | string;
+    /** Render square corners instead of the default 4px radius. */
     noBorderRadius?: boolean;
 }
+/**
+ * A shimmering placeholder bar for text that hasn't loaded. Size it to the copy
+ * it replaces so the layout doesn't jump when the real text arrives.
+ */
 declare const TextShimmer: ({ height, width, noBorderRadius }: TextShimmerProps) => import("react").JSX.Element;
 export default TextShimmer;

package/dist/text/TextShimmer.js

@@ -19,6 +19,10 @@ var StyledTextShimmer = withTheme(/*#__PURE__*/ styled("span")({
 		"s1p67zkf-3": [_exp6()]
 	}
 }));
+/**
+* A shimmering placeholder bar for text that hasn't loaded. Size it to the copy
+* it replaces so the layout doesn't jump when the real text arrives.
+*/
 var TextShimmer = ({ height, width, noBorderRadius }) => {
 	return /* @__PURE__ */ jsx(StyledTextShimmer, {
 		$height: height,