@syware/jlib 0.0.0-stage → 0.1.0

package/dist/types/jl-table.types.d.ts

@@ -0,0 +1,30 @@
+import type { Tone } from './options.types';
+/** How a cell shows its value: as it is, a localised number or date, a badge, or code. */
+export type TableCellFormat = 'text' | 'number' | 'date' | 'badge' | 'code';
+export type TableAlign = 'left' | 'center' | 'right';
+/** The order of a sorted column; `none` keeps the rows as they came. */
+export type TableSortDirection = 'asc' | 'desc' | 'none';
+export type TableColumn = {
+    /** The row's field shown in this column. */
+    key: string;
+    label: string;
+    /** Numbers are right-aligned when absent; the rest left. */
+    align?: TableAlign;
+    sortable?: boolean;
+    /** A CSS width: `120px`, `20%`; a number is pixels. */
+    width?: string | number;
+    format?: TableCellFormat;
+    /** For badges: the tone of each value (`{ "Active": "ok" }`); neutral otherwise. */
+    tones?: Record<string, Tone>;
+};
+export type TableRow = Record<string, unknown>;
+/** A row's identity, the value of its `row-key` field. */
+export type TableRowKey = string | number;
+export type TableSort = {
+    key: string;
+    direction: TableSortDirection;
+};
+/** Draws a cell of a column in place of its formatted value. */
+export type TableCellRenderer = (row: TableRow) => Node;
+/** What the select-all box shows: no row selected, some, or all of them. */
+export type TableSelectionState = 'none' | 'some' | 'all';

package/dist/types/jl-tabs.types.d.ts

@@ -0,0 +1,2 @@
+/** How the tabs mark the open one: an underline under a row of labels, or a soft pill behind the label. */
+export type TabsVariant = 'line' | 'pill';

package/dist/types/jl-timeline.types.d.ts

@@ -0,0 +1,10 @@
+import type { Tone } from './options.types';
+export type TimelineItem = {
+    title: string;
+    /** When it happened, as text: `2 min ago`, `09:41`, `Mar 3`. */
+    time?: string;
+    description?: string;
+    tone?: Tone;
+    /** An icon in a circle instead of the dot. */
+    icon?: string;
+};

package/dist/types/jl-toast.types.d.ts

@@ -0,0 +1,2 @@
+/** The colour of a notification: neutral ink, or a semantic colour. */
+export type ToastTone = 'neutral' | 'ok' | 'warn' | 'danger' | 'info';

package/dist/types/jl-toaster.types.d.ts

@@ -0,0 +1,23 @@
+import type { ToastTone } from './jl-toast.types';
+/** The corner or edge of the window where the toaster stacks its notifications. */
+export type ToasterPlacement = 'top-right' | 'top-center' | 'bottom-right' | 'bottom-center' | 'bottom-left';
+/** What `toast()` and `JlToaster.notify()` show. */
+export type ToastOptions = {
+    heading?: string;
+    text?: string;
+    tone?: ToastTone;
+    /** An icon name; the tone's icon when absent. */
+    icon?: string;
+    /** How long it stays, in milliseconds; 0 keeps it until closed. */
+    duration?: number;
+    /** Shows a close button; on by default. */
+    closable?: boolean;
+    /** The text of a button in the toast, such as "Undo". */
+    actionLabel?: string;
+    /** Called when that button is pressed; the toast then closes. */
+    onAction?: () => void;
+};
+/** What `toast()` returns: a way to close the notification before its time. */
+export type ToastHandle = {
+    dismiss(): void;
+};

package/dist/types/jl-tree.types.d.ts

@@ -0,0 +1,26 @@
+export type TreeItem = {
+    id: string;
+    label: string;
+    /** An icon name; folders get a folder and the rest a file when absent. */
+    icon?: string;
+    /** Present, even empty, the item is a folder that opens. */
+    children?: TreeItem[];
+};
+/** An item as listed: its depth from 1 at the roots, and its parent's id. */
+export type VisibleTreeItem = {
+    item: TreeItem;
+    level: number;
+    parent: string | null;
+};
+/** What a key does in the tree: move the focus, open or close a folder, or select an item. */
+export type TreeAction = {
+    kind: 'focus';
+    id: string;
+} | {
+    kind: 'toggle';
+    id: string;
+    open: boolean;
+} | {
+    kind: 'select';
+    id: string;
+};

package/dist/types/key-shortcut.types.d.ts

@@ -0,0 +1,9 @@
+/** A keyboard shortcut read from text such as "/" or "mod+k": `mod` is ⌘ on a Mac and Ctrl elsewhere. */
+export type KeyShortcut = {
+    key: string;
+    mod: boolean;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+    shift: boolean;
+};

package/dist/types/keycaps.types.d.ts

@@ -0,0 +1,7 @@
+/** How a platform writes modifier keys: Apple's symbols (⌘ ⇧ ⌥) or the names of other systems (Ctrl, Shift). */
+export type KeyPlatform = 'apple' | 'other';
+/** One key as a keycap draws it (`label`: ⌘) and as a screen reader says it (`name`: Command). */
+export type Keycap = {
+    label: string;
+    name: string;
+};

package/dist/types/option-filter.types.d.ts

@@ -0,0 +1,10 @@
+/** Where a search was found in a text: from `start` (included) to `end` (excluded), in UTF-16 indexes. */
+export type TextMatch = {
+    start: number;
+    end: number;
+};
+/** A piece of a text, matched by the search or not: the text drawn with its match highlighted. */
+export type TextMatchPart = {
+    text: string;
+    matched: boolean;
+};

package/dist/types/options.types.d.ts

@@ -0,0 +1,4 @@
+/** The colour of a status: neutral ink, the accent blue, or a semantic colour. */
+export type Tone = 'neutral' | 'accent' | 'ok' | 'warn' | 'danger' | 'info';
+/** The three heights of controls: sm in dense panels, md by default, lg where a thumb presses it. */
+export type ControlSize = 'sm' | 'md' | 'lg';

package/dist/types/pagination.types.d.ts

@@ -0,0 +1,8 @@
+/** One entry of a pagination's list: a page to go to, or a gap standing for the pages left out. */
+export type PageItem = {
+    type: 'page';
+    page: number;
+} | {
+    type: 'gap';
+    side: 'start' | 'end';
+};

package/dist/types/roving-index.types.d.ts

@@ -0,0 +1,2 @@
+/** Where the arrow keys of a list or a radio group move the focus: forward, backward, or to an end. */
+export type RovingMove = 'next' | 'previous' | 'first' | 'last';

package/dist/types/sparkline.types.d.ts

@@ -0,0 +1,11 @@
+/** A point of a sparkline, in the coordinates of its SVG `viewBox`. */
+export type SparkPoint = {
+    x: number;
+    y: number;
+};
+/** The drawing box of a sparkline: its `viewBox` size, and the room kept on each side for the stroke. */
+export type SparkBox = {
+    width: number;
+    height: number;
+    inset: number;
+};

package/package.json

@@ -1,6 +1,98 @@
 {
   "name": "@syware/jlib",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A tree-shakeable component library on Jadis and native Web Components, organised in atomic design",
+  "keywords": [
+    "web-components",
+    "custom-elements",
+    "jadis",
+    "components",
+    "design-system",
+    "ui",
+    "atomic-design",
+    "tree-shakeable"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "author": "SyWare",
+  "homepage": "https://bioleyl.github.io/jlib/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bioleyl/jlib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bioleyl/jlib/issues"
+  },
+  "files": ["dist"],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./all": {
+      "types": "./dist/all.d.ts",
+      "import": "./dist/all.js"
+    },
+    "./atoms/*": {
+      "types": "./dist/atoms/*.d.ts",
+      "import": "./dist/atoms/*.js"
+    },
+    "./molecules/*": {
+      "types": "./dist/molecules/*.d.ts",
+      "import": "./dist/molecules/*.js"
+    },
+    "./organisms/*": {
+      "types": "./dist/organisms/*.d.ts",
+      "import": "./dist/organisms/*.js"
+    },
+    "./templates/*": {
+      "types": "./dist/templates/*.d.ts",
+      "import": "./dist/templates/*.js"
+    },
+    "./tokens.css": "./dist/tokens.css",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": ["./dist/all.js", "./dist/*.css", "./src/all.ts"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite --config site/vite.config.ts",
+    "build": "npm run build:lib && npm run size:report && npm run build:site",
+    "build:lib": "node scripts/build-lib.mjs",
+    "build:site": "vite build --config site/vite.config.ts",
+    "preview": "vite preview --config site/vite.config.ts",
+    "generate": "node scripts/generate-index.mjs",
+    "size": "npm run build:lib && npm run size:report",
+    "size:report": "node scripts/size-report.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "npm run build:site && vitest run --config vitest.e2e.config.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "check": "npm run generate -- --check && npm run lint && npm run typecheck && npm run test",
+    "prepack": "npm run build:lib",
+    "prepublishOnly": "npm run check"
+  },
+  "peerDependencies": {
+    "@jadis/core": "^1.3.0"
+  },
+  "dependencies": {
+    "lucide": "^1.61.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.6.3",
+    "@fontsource-variable/jetbrains-mono": "^5.3.0",
+    "@fontsource-variable/manrope": "^5.3.0",
+    "@jadis/core": "^1.3.0",
+    "@types/node": "^24.13.3",
+    "playwright-core": "^1.64.1",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
+    "vitest": "^5.0.5"
+  }
+}