nirs4all-ui 0.1.4 → 0.1.6

package/dist/brand/index.js

@@ -0,0 +1,194 @@
+/**
+ * Shared NIRS4ALL brand definitions and deterministic SVG generators.
+ *
+ * This module is pure TypeScript: no DOM, no React, no filesystem access.
+ * Hosts can use the asset paths for packaged files or generate inline SVG
+ * strings when they need app-local marks.
+ */
+const SHARED_TEAL_PALETTE = {
+    primary: "#0d9488",
+    secondary: "#06b6d4",
+    accent: "#10b981",
+    dark: "#0f172a",
+    surface: "#ffffff",
+};
+export const NIRS4ALL_BRANDS = [
+    {
+        id: "nirs4all",
+        name: "NIRS4ALL",
+        shortName: "n4a",
+        packageName: "nirs4all",
+        role: "Ecosystem umbrella",
+        description: "Shared identity for NIRS4ALL applications, docs, releases, and custom hosts.",
+        palette: SHARED_TEAL_PALETTE,
+        assets: {
+            icon: "assets/brands/nirs4all/icon.svg",
+            horizontal: "assets/brands/nirs4all/horizontal.svg",
+            stacked: "assets/brands/nirs4all/stacked.svg",
+        },
+        tags: ["ecosystem", "docs", "custom-host"],
+    },
+    {
+        id: "nirs4all-core",
+        name: "nirs4all-core",
+        shortName: "core",
+        packageName: "nirs4all",
+        role: "Portable aggregate runtime",
+        description: "Low-level aggregate used by native, Python, R, WASM, Rust, MATLAB, and custom hosts.",
+        palette: {
+            primary: "#0d9488",
+            secondary: "#0891b2",
+            accent: "#4f46e5",
+            dark: "#10233a",
+            surface: "#ffffff",
+        },
+        assets: {
+            icon: "assets/brands/nirs4all-core/icon.svg",
+            horizontal: "assets/brands/nirs4all-core/horizontal.svg",
+            stacked: "assets/brands/nirs4all-core/stacked.svg",
+        },
+        tags: ["core", "runtime", "bindings"],
+    },
+    {
+        id: "nirs4all-ui",
+        name: "nirs4all-ui",
+        shortName: "ui",
+        packageName: "nirs4all-ui",
+        role: "Reusable visual system",
+        description: "Shared React components, visual tokens, brand assets, and app-host UI contracts.",
+        palette: {
+            primary: "#2563eb",
+            secondary: "#06b6d4",
+            accent: "#e9362d",
+            dark: "#172554",
+            surface: "#ffffff",
+        },
+        assets: {
+            icon: "assets/brands/nirs4all-ui/icon.svg",
+            horizontal: "assets/brands/nirs4all-ui/horizontal.svg",
+            stacked: "assets/brands/nirs4all-ui/stacked.svg",
+        },
+        tags: ["ui", "studio", "web"],
+    },
+    {
+        id: "nirs4all-providers",
+        name: "nirs4all-providers",
+        shortName: "providers",
+        packageName: "nirs4all-providers",
+        role: "Soft-import provider bridge",
+        description: "Optional provider clients for datasets, repositories, archives, and publication surfaces.",
+        palette: {
+            primary: "#7c3aed",
+            secondary: "#0d9488",
+            accent: "#f59e0b",
+            dark: "#2e1065",
+            surface: "#ffffff",
+        },
+        assets: {
+            icon: "assets/brands/nirs4all-providers/icon.svg",
+            horizontal: "assets/brands/nirs4all-providers/horizontal.svg",
+            stacked: "assets/brands/nirs4all-providers/stacked.svg",
+        },
+        tags: ["providers", "datasets", "repository"],
+    },
+];
+const BRAND_ID_SET = new Set(NIRS4ALL_BRANDS.map((brand) => brand.id));
+export function isNirs4allBrandId(value) {
+    return BRAND_ID_SET.has(value);
+}
+export function getNirs4allBrandDefinition(id) {
+    const brand = NIRS4ALL_BRANDS.find((candidate) => candidate.id === id);
+    if (!brand) {
+        throw new Error(`Unknown NIRS4ALL brand: ${id}`);
+    }
+    return brand;
+}
+export function listNirs4allBrands() {
+    return NIRS4ALL_BRANDS;
+}
+export function getNirs4allBrandAssetPath(brand, variant) {
+    return resolveBrand(brand).assets[variant];
+}
+export function generateNirs4allBrandSvg(brand, options = {}) {
+    const resolved = resolveBrand(brand);
+    const variant = options.variant ?? "horizontal";
+    if (variant === "icon") {
+        return buildIconSvg(resolved, options);
+    }
+    if (variant === "stacked") {
+        return buildStackedSvg(resolved, options);
+    }
+    return buildHorizontalSvg(resolved, options);
+}
+function resolveBrand(brand) {
+    return typeof brand === "string" ? getNirs4allBrandDefinition(brand) : brand;
+}
+function buildIconSvg(brand, options) {
+    const title = escapeXml(options.title ?? brand.name);
+    const titleId = `${brand.id}-icon-title`;
+    const textColor = options.dark ? "#ffffff" : brand.palette.dark;
+    const surface = options.dark ? brand.palette.dark : brand.palette.surface;
+    const animation = options.animated ? waveAnimation("icon-wave") : "";
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-labelledby="${titleId}">
+  <title id="${titleId}">${title}</title>
+  <rect width="128" height="128" rx="24" fill="${surface}"/>
+  <path d="M20 78C31 45 44 44 58 70s26 25 50-20" fill="none" stroke="${brand.palette.primary}" stroke-width="9" stroke-linecap="round"/>
+  <path id="icon-wave" d="M20 90C36 74 48 74 64 89s29 17 44-4" fill="none" stroke="${brand.palette.secondary}" stroke-width="5" stroke-linecap="round" opacity=".82"/>
+  ${animation}
+  <circle cx="98" cy="39" r="10" fill="${brand.palette.accent}"/>
+  <text x="64" y="112" fill="${textColor}" font-family="Inter, Arial, sans-serif" font-size="18" font-weight="800" text-anchor="middle">${escapeXml(brand.shortName)}</text>
+</svg>`;
+}
+function buildHorizontalSvg(brand, options) {
+    const title = escapeXml(options.title ?? brand.name);
+    const titleId = `${brand.id}-horizontal-title`;
+    const textColor = options.dark ? "#ffffff" : brand.palette.dark;
+    const mutedColor = options.dark ? "#cbd5e1" : "#475569";
+    const surface = options.dark ? brand.palette.dark : brand.palette.surface;
+    const animation = options.animated ? waveAnimation("horizontal-wave") : "";
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 520 132" role="img" aria-labelledby="${titleId}">
+  <title id="${titleId}">${title}</title>
+  <rect width="520" height="132" rx="22" fill="${surface}"/>
+  <g transform="translate(24 18)">
+    <rect width="96" height="96" rx="20" fill="${brand.palette.primary}" opacity=".12"/>
+    <path d="M14 58C25 28 37 28 49 54s24 26 40-15" fill="none" stroke="${brand.palette.primary}" stroke-width="8" stroke-linecap="round"/>
+    <path id="horizontal-wave" d="M14 72C29 58 39 59 53 72s25 14 37-2" fill="none" stroke="${brand.palette.secondary}" stroke-width="5" stroke-linecap="round"/>
+    ${animation}
+    <circle cx="78" cy="28" r="8" fill="${brand.palette.accent}"/>
+  </g>
+  <text x="146" y="61" fill="${textColor}" font-family="Inter, Arial, sans-serif" font-size="34" font-weight="800">${escapeXml(brand.name)}</text>
+  <text x="146" y="92" fill="${mutedColor}" font-family="Inter, Arial, sans-serif" font-size="16" font-weight="600">${escapeXml(brand.role)}</text>
+</svg>`;
+}
+function buildStackedSvg(brand, options) {
+    const title = escapeXml(options.title ?? brand.name);
+    const titleId = `${brand.id}-stacked-title`;
+    const textColor = options.dark ? "#ffffff" : brand.palette.dark;
+    const mutedColor = options.dark ? "#cbd5e1" : "#475569";
+    const surface = options.dark ? brand.palette.dark : brand.palette.surface;
+    const animation = options.animated ? waveAnimation("stacked-wave") : "";
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 280 236" role="img" aria-labelledby="${titleId}">
+  <title id="${titleId}">${title}</title>
+  <rect width="280" height="236" rx="24" fill="${surface}"/>
+  <g transform="translate(80 26)">
+    <rect width="120" height="120" rx="28" fill="${brand.palette.primary}" opacity=".12"/>
+    <path d="M18 73C32 36 47 35 64 68s32 33 56-18" fill="none" stroke="${brand.palette.primary}" stroke-width="10" stroke-linecap="round"/>
+    <path id="stacked-wave" d="M18 91C37 72 51 74 68 91s35 18 52-3" fill="none" stroke="${brand.palette.secondary}" stroke-width="6" stroke-linecap="round"/>
+    ${animation}
+    <circle cx="96" cy="38" r="10" fill="${brand.palette.accent}"/>
+  </g>
+  <text x="140" y="178" fill="${textColor}" font-family="Inter, Arial, sans-serif" font-size="28" font-weight="800" text-anchor="middle">${escapeXml(brand.name)}</text>
+  <text x="140" y="205" fill="${mutedColor}" font-family="Inter, Arial, sans-serif" font-size="14" font-weight="600" text-anchor="middle">${escapeXml(brand.role)}</text>
+</svg>`;
+}
+function waveAnimation(targetId) {
+    return `<animate href="#${targetId}" attributeName="stroke-dashoffset" values="0;-80" dur="9s" repeatCount="indefinite"/>`;
+}
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+//# sourceMappingURL=index.js.map

package/dist/brand/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brand/index.ts"],"names":[],"mappings":"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"}

package/dist/components/DatasetPreviewCard.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from "react";
+import { type DatasetPreviewBadge, type DatasetPreviewInput, type DatasetPreviewStat, type DatasetPreviewView } from "../dataset/index.js";
+export interface DatasetPreviewCardProps {
+    dataset?: DatasetPreviewInput | null;
+    view?: DatasetPreviewView | null;
+    className?: string;
+    headerClassName?: string;
+    titleClassName?: string;
+    descriptionClassName?: string;
+    badgeListClassName?: string;
+    badgeClassName?: string | ((badge: DatasetPreviewBadge) => string | undefined);
+    statListClassName?: string;
+    statClassName?: string | ((stat: DatasetPreviewStat) => string | undefined);
+    statLabelClassName?: string;
+    statValueClassName?: string;
+    statDetailClassName?: string;
+    empty?: ReactNode;
+    renderBadge?: (badge: DatasetPreviewBadge) => ReactNode;
+    renderStat?: (stat: DatasetPreviewStat) => ReactNode;
+}
+export declare function DatasetPreviewCard({ dataset, view, className, headerClassName, titleClassName, descriptionClassName, badgeListClassName, badgeClassName, statListClassName, statClassName, statLabelClassName, statValueClassName, statDetailClassName, empty, renderBadge, renderStat, }: DatasetPreviewCardProps): import("react").JSX.Element | null;
+//# sourceMappingURL=DatasetPreviewCard.d.ts.map

package/dist/components/DatasetPreviewCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatasetPreviewCard.d.ts","sourceRoot":"","sources":["../../src/components/DatasetPreviewCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,mBAAmB,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,SAAS,CAAC;IACxD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,SAAS,CAAC;CACtD;AAwBD,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,IAAI,EACJ,SAAS,EACT,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,EACL,WAAW,EACX,UAAU,GACX,EAAE,uBAAuB,sCAoCzB"}

package/dist/components/DatasetPreviewCard.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { buildDatasetPreview, } from "../dataset/index.js";
+function resolveClassName(className, item) {
+    return typeof className === "function" ? className(item) : className;
+}
+function defaultStatNode(stat, labelClassName, valueClassName, detailClassName) {
+    return (_jsxs(_Fragment, { children: [_jsx("dt", { className: labelClassName, children: stat.label }), _jsx("dd", { className: valueClassName, children: stat.value }), stat.detail ? _jsx("span", { className: detailClassName, children: stat.detail }) : null] }));
+}
+export function DatasetPreviewCard({ dataset, view, className, headerClassName, titleClassName, descriptionClassName, badgeListClassName, badgeClassName, statListClassName, statClassName, statLabelClassName, statValueClassName, statDetailClassName, empty, renderBadge, renderStat, }) {
+    const preview = view ?? buildDatasetPreview(dataset);
+    if (!preview)
+        return empty == null ? null : _jsx(_Fragment, { children: empty });
+    return (_jsxs("article", { className: className, "data-dataset-id": preview.id ?? undefined, children: [_jsxs("header", { className: headerClassName, children: [_jsx("strong", { className: titleClassName, children: preview.title }), preview.description ? (_jsx("p", { className: descriptionClassName, children: preview.description })) : null] }), preview.badges.length > 0 ? (_jsx("div", { className: badgeListClassName, children: preview.badges.map((badge) => (_jsx("span", { className: resolveClassName(badgeClassName, badge), children: renderBadge ? renderBadge(badge) : badge.label }, badge.id))) })) : null, preview.stats.length > 0 ? (_jsx("dl", { className: statListClassName, children: preview.stats.map((stat) => (_jsx("div", { className: resolveClassName(statClassName, stat), children: renderStat
+                        ? renderStat(stat)
+                        : defaultStatNode(stat, statLabelClassName, statValueClassName, statDetailClassName) }, stat.id))) })) : null] }));
+}
+//# sourceMappingURL=DatasetPreviewCard.js.map

package/dist/components/DatasetPreviewCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatasetPreviewCard.js","sourceRoot":"","sources":["../../src/components/DatasetPreviewCard.tsx"],"names":[],"mappings":";AAEA,OAAO,EACL,mBAAmB,GAKpB,MAAM,qBAAqB,CAAC;AAqB7B,SAAS,gBAAgB,CACvB,SAAiE,EACjE,IAAO;IAEP,OAAO,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,SAAS,eAAe,CACtB,IAAwB,EACxB,cAAkC,EAClC,cAAkC,EAClC,eAAmC;IAEnC,OAAO,CACL,8BACE,aAAI,SAAS,EAAE,cAAc,YAAG,IAAI,CAAC,KAAK,GAAM,EAChD,aAAI,SAAS,EAAE,cAAc,YAAG,IAAI,CAAC,KAAK,GAAM,EAC/C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAM,SAAS,EAAE,eAAe,YAAG,IAAI,CAAC,MAAM,GAAQ,CAAC,CAAC,CAAC,IAAI,IAC3E,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,IAAI,EACJ,SAAS,EACT,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,EACL,WAAW,EACX,UAAU,GACc;IACxB,MAAM,OAAO,GAAG,IAAI,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,4BAAG,KAAK,GAAI,CAAC;IAEzD,OAAO,CACL,mBAAS,SAAS,EAAE,SAAS,qBAAmB,OAAO,CAAC,EAAE,IAAI,SAAS,aACrE,kBAAQ,SAAS,EAAE,eAAe,aAChC,iBAAQ,SAAS,EAAE,cAAc,YAAG,OAAO,CAAC,KAAK,GAAU,EAC1D,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CACrB,YAAG,SAAS,EAAE,oBAAoB,YAAG,OAAO,CAAC,WAAW,GAAK,CAC9D,CAAC,CAAC,CAAC,IAAI,IACD,EAER,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAC3B,cAAK,SAAS,EAAE,kBAAkB,YAC/B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC7B,eAAM,SAAS,EAAE,gBAAgB,CAAC,cAAc,EAAE,KAAK,CAAC,YACrD,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IADc,KAAK,CAAC,EAAE,CAEhE,CACR,CAAC,GACE,CACP,CAAC,CAAC,CAAC,IAAI,EAEP,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAC1B,aAAI,SAAS,EAAE,iBAAiB,YAC7B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAC3B,cAAK,SAAS,EAAE,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,YAClD,UAAU;wBACT,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;wBAClB,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,IAH5B,IAAI,CAAC,EAAE,CAI7D,CACP,CAAC,GACC,CACN,CAAC,CAAC,CAAC,IAAI,IACA,CACX,CAAC;AACJ,CAAC"}

package/dist/components/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./DatasetPreviewCard.js";
 export * from "./MetricValueBadge.js";
 export * from "./RuntimeDiagnosticList.js";
 export * from "./RuntimeEngineBadge.js";

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC"}

package/dist/components/index.js

@@ -1,3 +1,4 @@
+export * from "./DatasetPreviewCard.js";
 export * from "./MetricValueBadge.js";
 export * from "./RuntimeDiagnosticList.js";
 export * from "./RuntimeEngineBadge.js";

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC"}

package/dist/dataset/datasetPreview.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Pure dataset preview view-model helpers.
+ *
+ * Hosts keep ownership of dataset loading and schema adapters; this module only
+ * turns small, package-level display contracts into reusable labels, stats, and
+ * badges for Studio/Web dataset cards.
+ */
+export type DatasetPreviewTaskKind = "regression" | "classification" | "mixed" | "unknown";
+export type DatasetPreviewTone = "default" | "muted" | "warning";
+export type DatasetPreviewCount = number | string | null | undefined;
+export interface DatasetSplitCountInput {
+    id?: string | null;
+    key?: string | null;
+    label?: string | null;
+    count?: DatasetPreviewCount;
+}
+export type DatasetSplitCountsInput = readonly DatasetSplitCountInput[] | Record<string, DatasetPreviewCount>;
+export interface DatasetSpectralRangeInput {
+    start?: DatasetPreviewCount;
+    end?: DatasetPreviewCount;
+    min?: DatasetPreviewCount;
+    max?: DatasetPreviewCount;
+    unit?: string | null;
+}
+export interface DatasetPreviewInput {
+    id?: string | null;
+    name?: string | null;
+    title?: string | null;
+    description?: string | null;
+    taskType?: string | null;
+    sampleCount?: DatasetPreviewCount;
+    spectrumCount?: DatasetPreviewCount;
+    rowCount?: DatasetPreviewCount;
+    featureCount?: DatasetPreviewCount;
+    wavelengthCount?: DatasetPreviewCount;
+    targetCount?: DatasetPreviewCount;
+    classCount?: DatasetPreviewCount;
+    splitCounts?: DatasetSplitCountsInput | null;
+    splits?: DatasetSplitCountsInput | null;
+    spectralRange?: DatasetSpectralRangeInput | readonly [DatasetPreviewCount, DatasetPreviewCount] | null;
+    tags?: readonly (string | null | undefined)[] | null;
+}
+export interface DatasetSplitCountView {
+    id: string;
+    label: string;
+    count: number;
+    countLabel: string;
+    percentage: number | null;
+    percentageLabel: string | null;
+}
+export interface DatasetPreviewBadge {
+    id: string;
+    label: string;
+    tone: DatasetPreviewTone;
+}
+export interface DatasetPreviewStat {
+    id: "samples" | "features" | "targets" | "classes" | "splits" | "range";
+    label: string;
+    value: string;
+    detail: string | null;
+    tone: DatasetPreviewTone;
+}
+export interface DatasetPreviewView {
+    id: string | null;
+    title: string;
+    description: string | null;
+    taskKind: DatasetPreviewTaskKind;
+    taskLabel: string;
+    sampleCount: number | null;
+    sampleCountLabel: string | null;
+    featureCount: number | null;
+    featureCountLabel: string | null;
+    targetCount: number | null;
+    targetCountLabel: string | null;
+    classCount: number | null;
+    classCountLabel: string | null;
+    spectralRangeLabel: string | null;
+    splitCounts: DatasetSplitCountView[];
+    splitSummaryLabel: string | null;
+    tags: string[];
+    badges: DatasetPreviewBadge[];
+    stats: DatasetPreviewStat[];
+}
+export declare function parseDatasetCount(value: DatasetPreviewCount): number | null;
+export declare function formatDatasetCount(value: DatasetPreviewCount, singular: string, plural?: string): string | null;
+export declare function resolveDatasetTaskKind(taskType: string | null | undefined): DatasetPreviewTaskKind;
+export declare function formatDatasetTaskLabel(taskType: string | null | undefined): string;
+export declare function formatDatasetTokenLabel(value: string | null | undefined): string;
+export declare function normalizeDatasetSplitCounts(input: DatasetSplitCountsInput | null | undefined, sampleCount?: DatasetPreviewCount): DatasetSplitCountView[];
+export declare function formatDatasetSpectralRange(range: DatasetPreviewInput["spectralRange"]): string | null;
+export declare function buildDatasetPreview(input: DatasetPreviewInput | null | undefined): DatasetPreviewView | null;
+//# sourceMappingURL=datasetPreview.d.ts.map

package/dist/dataset/datasetPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasetPreview.d.ts","sourceRoot":"","sources":["../../src/dataset/datasetPreview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3F,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,MAAM,uBAAuB,GAC/B,SAAS,sBAAsB,EAAE,GACjC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAExC,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,WAAW,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC7C,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,GAAG,IAAI,CAAC;IACvG,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAiBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAG3E;AAkBD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAiB,GACtB,MAAM,GAAG,IAAI,CAIf;AAUD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAOlG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASlF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkBhF;AAuBD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,EACjD,WAAW,CAAC,EAAE,mBAAmB,GAChC,qBAAqB,EAAE,CA4BzB;AAyBD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,mBAAmB,CAAC,eAAe,CAAC,GAC1C,MAAM,GAAG,IAAI,CAcf;AAuHD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAC5C,kBAAkB,GAAG,IAAI,CA2C3B"}