@datalayer/core 1.1.59 → 1.1.66

package/lib/client/index.js

@@ -20,6 +20,7 @@
  */
 import { DatalayerClientBase, } from './base.js';
 import { IAMMixin } from './mixins/IAMMixin.js';
+import { ContentsMixin } from './mixins/ContentsMixin.js';
 /**
  * Helper function to compose mixins in a more readable way.
  * Applies mixins in the order provided.
@@ -33,7 +34,7 @@ function composeMixins(...mixins) {
 // Apply the IAM mixin to the base class. Runtime and content (Spacer) features
 // live in @datalayer/agent-runtimes, which composes AgentRuntimesClient on top
 // of this core client.
-const DatalayerCoreClientWithMixins = composeMixins(IAMMixin);
+const DatalayerCoreClientWithMixins = composeMixins(IAMMixin, ContentsMixin);
 /**
  * Core Datalayer Client providing access to identity, plans and account
  * services (IAM). Runtime and workspace/content features are provided by
@@ -68,7 +69,6 @@ export { UserDTO as User } from './../models/UserDTO.js';
 export { CreditsDTO as Credits } from '../models/CreditsDTO.js';
 export { HealthCheck } from '../models/HealthCheck.js';
 export { SecretDTO as Secret } from './../models/Secret.js';
-export { DatasourceDTO as Datasource } from './../models/Datasource.js';
 // Export auth types
 export { AuthenticationManager } from './auth/AuthenticationManager.js';
 // Constants

package/lib/client/mixins/ContentsMixin.d.ts

@@ -0,0 +1,71 @@
+/** Contents mixin providing the typed source catalog API. */
+import { type ConditionalCatalogSource, type AttachmentCreate, type AttachmentList, type ContentAttachment, type ContentAttachmentManifest, type DatasetRevision, type DatasetRevisionCreate, type DatasetRevisionList, type DatasetPublication, type DatasetPublicationCreate, type DatasetPublicationList, type ContentSourceCreate, type ContentSourceUpdate, type EffectivePermissions, type ContentObject, type DownloadedObject, type ObjectList, type OperationView, type RestoreRequest, type Sharing, type SourceList, type TransferCreate, type TransferList, type TransferView, type UploadProgress, type HomeFolderObjectListOptions, type HomeFolderQuota, type VersionList } from '../../api/contents';
+import type { Constructor } from '../utils/mixins';
+export declare function ContentsMixin<TBase extends Constructor>(Base: TBase): {
+    new (...args: any[]): {
+        contentsRequestContext(): {
+            token: string;
+            baseUrl: string;
+        };
+        listContentSources(options?: {
+            kind?: string;
+            spaceUid?: string;
+            cursor?: string;
+            limit?: number;
+        }): Promise<SourceList>;
+        createContentAttachment(request: AttachmentCreate, idempotencyKey: string): Promise<ContentAttachment>;
+        createDatasetRevision(sourceUid: string, request: DatasetRevisionCreate, idempotencyKey: string): Promise<DatasetRevision>;
+        listDatasetRevisions(sourceUid: string): Promise<DatasetRevisionList>;
+        getDatasetRevision(sourceUid: string, revisionUid: string): Promise<DatasetRevision>;
+        createDatasetPublication(sourceUid: string, request: DatasetPublicationCreate, idempotencyKey: string): Promise<DatasetPublication>;
+        listDatasetPublications(sourceUid: string): Promise<DatasetPublicationList>;
+        unpublishDataset(sourceUid: string, publicationUid: string): Promise<DatasetPublication>;
+        listContentAttachments(options?: {
+            sandboxUid?: string;
+            sourceUid?: string;
+            active?: boolean;
+        }): Promise<AttachmentList>;
+        getContentAttachmentManifest(sandboxUid: string): Promise<ContentAttachmentManifest>;
+        revokeContentAttachment(attachmentUid: string): Promise<ContentAttachment>;
+        createContentSource(source: ContentSourceCreate, idempotencyKey: string): Promise<ConditionalCatalogSource>;
+        getContentSource(sourceUid: string): Promise<ConditionalCatalogSource>;
+        getHomeFolder(): Promise<ConditionalCatalogSource>;
+        listHomeFolderObjects(options?: HomeFolderObjectListOptions): Promise<ObjectList>;
+        getHomeFolderQuota(): Promise<HomeFolderQuota>;
+        statHomeFolderObject(path: string): Promise<ContentObject>;
+        listHomeFolderObjectVersions(objectUid: string, options?: {
+            cursor?: string;
+            limit?: number;
+        }): Promise<VersionList>;
+        deleteHomeFolderObject(objectUid: string, idempotencyKey: string): Promise<ContentObject>;
+        restoreHomeFolderObject(objectUid: string, request: RestoreRequest, idempotencyKey: string): Promise<ContentObject>;
+        createContentTransfer(request: TransferCreate, idempotencyKey: string): Promise<TransferView>;
+        getContentTransfer(transferUid: string): Promise<TransferView>;
+        listContentTransfers(options?: {
+            active?: boolean;
+            cursor?: string;
+            limit?: number;
+        }): Promise<TransferList>;
+        uploadContentTransferPart(transferUid: string, partNumber: number, content: Uint8Array, checksum: string): Promise<TransferView>;
+        completeContentTransfer(transferUid: string): Promise<TransferView>;
+        cancelContentTransfer(transferUid: string): Promise<TransferView>;
+        uploadHomeFolderFile(path: string, content: Blob | Uint8Array | ArrayBuffer, options: {
+            idempotencyKey: string;
+            mediaType?: string;
+            overwrite?: "reject" | "replace" | "new-version";
+            chunkSize?: number;
+            onProgress?: (progress: UploadProgress) => void;
+        }): Promise<TransferView>;
+        downloadHomeFolderObject(objectUid: string, options?: {
+            versionUid?: string;
+            range?: string;
+        }): Promise<DownloadedObject>;
+        updateContentSource(sourceUid: string, update: ContentSourceUpdate, etag: string): Promise<ConditionalCatalogSource>;
+        archiveContentSource(sourceUid: string, etag: string): Promise<ConditionalCatalogSource>;
+        getContentSourcePermissions(sourceUid: string): Promise<EffectivePermissions>;
+        getContentSourceSharing(sourceUid: string): Promise<Sharing>;
+        replaceContentSourceSharing(sourceUid: string, sharing: Sharing, etag: string): Promise<ConditionalCatalogSource>;
+        getContentOperation(operationUid: string): Promise<OperationView>;
+        cancelContentOperation(operationUid: string): Promise<OperationView>;
+    };
+} & TBase;

package/lib/client/mixins/ContentsMixin.js

@@ -0,0 +1,157 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/** Contents mixin providing the typed source catalog API. */
+import { createAttachment, createDatasetRevision, createDatasetPublication, archiveSource, cancelOperation, cancelTransfer, completeTransfer, createSource, createTransfer, downloadHomeFolderObject, getSource, getHomeFolderQuota, getHomeFolder, getAttachmentManifest, getDatasetRevision, getOperation, getTransfer, getSourcePermissions, getSourceSharing, listHomeFolderObjects, listHomeFolderObjectVersions, listSources, listTransfers, listAttachments, listDatasetRevisions, listDatasetPublications, deleteHomeFolderObject, replaceSourceSharing, restoreHomeFolderObject, revokeAttachment, unpublishDataset, statHomeFolderObject, uploadTransferPart, uploadHomeFolderFile, updateSource, } from '../../api/contents/index.js';
+export function ContentsMixin(Base) {
+    return class extends Base {
+        contentsRequestContext() {
+            const client = this;
+            return {
+                token: client.getToken() ?? '',
+                baseUrl: client.getContentsUrl(),
+            };
+        }
+        async listContentSources(options = {}) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return listSources(token, options, baseUrl);
+        }
+        async createContentAttachment(request, idempotencyKey) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return createAttachment(token, request, idempotencyKey, baseUrl);
+        }
+        async createDatasetRevision(sourceUid, request, idempotencyKey) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return createDatasetRevision(token, sourceUid, request, idempotencyKey, baseUrl);
+        }
+        async listDatasetRevisions(sourceUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return listDatasetRevisions(token, sourceUid, baseUrl);
+        }
+        async getDatasetRevision(sourceUid, revisionUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getDatasetRevision(token, sourceUid, revisionUid, baseUrl);
+        }
+        async createDatasetPublication(sourceUid, request, idempotencyKey) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return createDatasetPublication(token, sourceUid, request, idempotencyKey, baseUrl);
+        }
+        async listDatasetPublications(sourceUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return listDatasetPublications(token, sourceUid, baseUrl);
+        }
+        async unpublishDataset(sourceUid, publicationUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return unpublishDataset(token, sourceUid, publicationUid, baseUrl);
+        }
+        async listContentAttachments(options = {}) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return listAttachments(token, options, baseUrl);
+        }
+        async getContentAttachmentManifest(sandboxUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getAttachmentManifest(token, sandboxUid, baseUrl);
+        }
+        async revokeContentAttachment(attachmentUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return revokeAttachment(token, attachmentUid, baseUrl);
+        }
+        async createContentSource(source, idempotencyKey) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return createSource(token, source, idempotencyKey, baseUrl);
+        }
+        async getContentSource(sourceUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getSource(token, sourceUid, baseUrl);
+        }
+        async getHomeFolder() {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getHomeFolder(token, baseUrl);
+        }
+        async listHomeFolderObjects(options = {}) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return listHomeFolderObjects(token, options, baseUrl);
+        }
+        async getHomeFolderQuota() {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getHomeFolderQuota(token, baseUrl);
+        }
+        async statHomeFolderObject(path) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return statHomeFolderObject(token, path, baseUrl);
+        }
+        async listHomeFolderObjectVersions(objectUid, options = {}) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return listHomeFolderObjectVersions(token, objectUid, options, baseUrl);
+        }
+        async deleteHomeFolderObject(objectUid, idempotencyKey) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return deleteHomeFolderObject(token, objectUid, idempotencyKey, baseUrl);
+        }
+        async restoreHomeFolderObject(objectUid, request, idempotencyKey) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return restoreHomeFolderObject(token, objectUid, request, idempotencyKey, baseUrl);
+        }
+        async createContentTransfer(request, idempotencyKey) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return createTransfer(token, request, idempotencyKey, baseUrl);
+        }
+        async getContentTransfer(transferUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getTransfer(token, transferUid, baseUrl);
+        }
+        async listContentTransfers(options = {}) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return listTransfers(token, options, baseUrl);
+        }
+        async uploadContentTransferPart(transferUid, partNumber, content, checksum) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return uploadTransferPart(token, transferUid, partNumber, content, checksum, baseUrl);
+        }
+        async completeContentTransfer(transferUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return completeTransfer(token, transferUid, baseUrl);
+        }
+        async cancelContentTransfer(transferUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return cancelTransfer(token, transferUid, baseUrl);
+        }
+        async uploadHomeFolderFile(path, content, options) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return uploadHomeFolderFile(token, path, content, options, baseUrl);
+        }
+        async downloadHomeFolderObject(objectUid, options = {}) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return downloadHomeFolderObject(token, objectUid, options, baseUrl);
+        }
+        async updateContentSource(sourceUid, update, etag) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return updateSource(token, sourceUid, update, etag, baseUrl);
+        }
+        async archiveContentSource(sourceUid, etag) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return archiveSource(token, sourceUid, etag, baseUrl);
+        }
+        async getContentSourcePermissions(sourceUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getSourcePermissions(token, sourceUid, baseUrl);
+        }
+        async getContentSourceSharing(sourceUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getSourceSharing(token, sourceUid, baseUrl);
+        }
+        async replaceContentSourceSharing(sourceUid, sharing, etag) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return replaceSourceSharing(token, sourceUid, sharing, etag, baseUrl);
+        }
+        async getContentOperation(operationUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return getOperation(token, operationUid, baseUrl);
+        }
+        async cancelContentOperation(operationUid) {
+            const { token, baseUrl } = this.contentsRequestContext();
+            return cancelOperation(token, operationUid, baseUrl);
+        }
+    };
+}

package/lib/client/mixins/IAMMixin.d.ts

@@ -4,8 +4,6 @@ import { CreditsDTO } from '../../models/CreditsDTO';
 import { HealthCheck } from '../../models/HealthCheck';
 import { SecretDTO } from '../../models/Secret';
 import type { CreateSecretRequest, UpdateSecretRequest } from '../../models/Secret';
-import { DatasourceDTO } from '../../models/Datasource';
-import type { CreateDatasourceRequest, UpdateDatasourceRequest } from '../../models/Datasource';
 /** IAM mixin providing authentication and user management. */
 export declare function IAMMixin<TBase extends Constructor>(Base: TBase): {
     new (...args: any[]): {
@@ -83,34 +81,5 @@ export declare function IAMMixin<TBase extends Constructor>(Base: TBase): {
          * @param secretId - Secret unique identifier
          */
         deleteSecret(secretId: string): Promise<void>;
-        /**
-         * Create a new datasource.
-         * @param data - Datasource configuration
-         * @returns Created datasource instance
-         */
-        createDatasource(data: CreateDatasourceRequest): Promise<DatasourceDTO>;
-        /**
-         * List all datasources.
-         * @returns Array of datasource instances
-         */
-        listDatasources(): Promise<DatasourceDTO[]>;
-        /**
-         * Get a specific datasource by ID.
-         * @param datasourceId - Datasource unique identifier
-         * @returns Datasource instance
-         */
-        getDatasource(datasourceId: string): Promise<DatasourceDTO>;
-        /**
-         * Update a datasource.
-         * @param datasourceId - Datasource unique identifier
-         * @param updates - Fields to update
-         * @returns Updated datasource instance
-         */
-        updateDatasource(datasourceId: string, updates: UpdateDatasourceRequest): Promise<DatasourceDTO>;
-        /**
-         * Delete a datasource.
-         * @param datasourceId - Datasource unique identifier
-         */
-        deleteDatasource(datasourceId: string): Promise<void>;
     };
 } & TBase;

package/lib/client/mixins/IAMMixin.js

@@ -10,12 +10,10 @@ import * as authentication from '../../api/iam/authentication.js';
 import * as profile from '../../api/iam/profile.js';
 import * as usage from '../../api/iam/usage.js';
 import * as secrets from '../../api/iam/secrets.js';
-import * as datasources from '../../api/iam/datasources.js';
 import { UserDTO } from '../../models/UserDTO.js';
 import { CreditsDTO } from '../../models/CreditsDTO.js';
 import { HealthCheck } from '../../models/HealthCheck.js';
 import { SecretDTO } from '../../models/Secret.js';
-import { DatasourceDTO } from '../../models/Datasource.js';
 /** IAM mixin providing authentication and user management. */
 export function IAMMixin(Base) {
     return class extends Base {
@@ -237,61 +235,5 @@ export function IAMMixin(Base) {
             const iamUrl = this.getIamUrl();
             await secrets.deleteSecret(token, secretId, iamUrl);
         }
-        // ========================================================================
-        // Datasources Management
-        // ========================================================================
-        /**
-         * Create a new datasource.
-         * @param data - Datasource configuration
-         * @returns Created datasource instance
-         */
-        async createDatasource(data) {
-            const token = this.getToken();
-            const iamUrl = this.getIamUrl();
-            const response = await datasources.createDatasource(token, data, iamUrl);
-            return new DatasourceDTO(response.datasource, this);
-        }
-        /**
-         * List all datasources.
-         * @returns Array of datasource instances
-         */
-        async listDatasources() {
-            const token = this.getToken();
-            const iamUrl = this.getIamUrl();
-            const response = await datasources.listDatasources(token, iamUrl);
-            return response.datasources.map(d => new DatasourceDTO(d, this));
-        }
-        /**
-         * Get a specific datasource by ID.
-         * @param datasourceId - Datasource unique identifier
-         * @returns Datasource instance
-         */
-        async getDatasource(datasourceId) {
-            const token = this.getToken();
-            const iamUrl = this.getIamUrl();
-            const response = await datasources.getDatasource(token, datasourceId, iamUrl);
-            return new DatasourceDTO(response.datasource, this);
-        }
-        /**
-         * Update a datasource.
-         * @param datasourceId - Datasource unique identifier
-         * @param updates - Fields to update
-         * @returns Updated datasource instance
-         */
-        async updateDatasource(datasourceId, updates) {
-            const token = this.getToken();
-            const iamUrl = this.getIamUrl();
-            const response = await datasources.updateDatasource(token, datasourceId, updates, iamUrl);
-            return new DatasourceDTO(response.datasource, this);
-        }
-        /**
-         * Delete a datasource.
-         * @param datasourceId - Datasource unique identifier
-         */
-        async deleteDatasource(datasourceId) {
-            const token = this.getToken();
-            const iamUrl = this.getIamUrl();
-            await datasources.deleteDatasource(token, datasourceId, iamUrl);
-        }
     };
 }

package/lib/components/animation/AnimatedText.d.ts

@@ -1,3 +1,4 @@
+import type { JSX } from 'react';
 /**
  * One piece of an animated line.
  *

package/lib/components/animation/AnimatedText.js

@@ -1,8 +1,4 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
 import { useEffect, useMemo, useState } from 'react';
 /** The Primer foreground tokens, which carry the theme with them. */
 const THEME_COLORS = {

package/lib/components/auth/SigInAPIKey.d.ts

@@ -1,3 +1,4 @@
+import type { JSX } from 'react';
 export interface ISigninAPIKeyProps {
     /**
      * Home page route to navigate to after successful login

package/lib/components/auth/SigInAPIKey.js

@@ -1,10 +1,4 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- *
- * Datalayer License
- */
 import { useState } from 'react';
 import { Button, FormControl, TextInput } from '@primer/react';
 import { Box } from '@datalayer/primer-addons';

package/lib/components/auth/SignIn.d.ts

@@ -1,3 +1,4 @@
+import type { JSX } from 'react';
 export interface ISigninProps {
     /**
      * Page heading

package/lib/components/auth/SignIn.js

@@ -1,8 +1,4 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
 import { useEffect, useState } from 'react';
 import { PageConfig, URLExt } from '@jupyterlab/coreutils';
 import { EyeIcon, EyeClosedIcon, MarkGithubIcon } from '@primer/octicons-react';

package/lib/components/auth/SignIn.stories.d.ts

@@ -9,7 +9,7 @@ import type { StoryObj } from '@storybook/react-vite';
  */
 declare const meta: {
     title: string;
-    component: (props: import("./SignIn").ISigninProps) => JSX.Element;
+    component: (props: import("./SignIn").ISigninProps) => import("react").JSX.Element;
     parameters: {
         layout: string;
     };
@@ -24,7 +24,7 @@ declare const meta: {
         showGitHubLogin?: boolean | undefined;
         showGoogleLogin?: boolean | undefined;
         showTokenLogin?: boolean | undefined;
-    }>) => import("react/jsx-runtime").JSX.Element)[];
+    }>) => import("react").JSX.Element)[];
     tags: string[];
 };
 export default meta;

package/lib/components/avatars/BoringAvatar.d.ts

@@ -8,5 +8,5 @@ type IBoringAvatarProps = {
     /** Custom color palette passed to boring-avatars. When omitted the default Datalayer palette is used. */
     colors?: string[];
 };
-export declare const BoringAvatar: ({ displayName, variant, size, square, style, colors, }: IBoringAvatarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const BoringAvatar: ({ displayName, variant, size, square, style, colors, }: IBoringAvatarProps) => import("react").JSX.Element;
 export default BoringAvatar;

package/lib/components/avatars/BoringAvatar.stories.d.ts

@@ -8,7 +8,7 @@ declare const meta: {
         square?: boolean;
         style?: object;
         colors?: string[];
-    }) => import("react/jsx-runtime").JSX.Element;
+    }) => import("react").JSX.Element;
     tags: string[];
     parameters: {
         layout: string;

package/lib/components/avatars/DLAvatar.d.ts

@@ -20,5 +20,5 @@ export type DLAvatarProps = Omit<AvatarProps, 'src'> & {
  *    `lh3.googleusercontent.com` (Google), LinkedIn media, etc. do not
  *    deny the request based on the `Referer` header.
  */
-export declare const DLAvatar: ({ src, ...rest }: DLAvatarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DLAvatar: ({ src, ...rest }: DLAvatarProps) => import("react").JSX.Element;
 export default DLAvatar;

package/lib/components/avatars/DLAvatar.js

@@ -3,10 +3,6 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-/*
- * Copyright (c) 2023-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
 import { Avatar } from '@primer/react';
 import { getAvatarURL } from '../../utils/index.js';
 /**

package/lib/components/avatars/UserAvatar.d.ts

@@ -1,3 +1,12 @@
+/**
+ * UserAvatar – Single source of truth for rendering a user's avatar.
+ *
+ * When a real (non-Gravatar) avatar URL is available it renders a
+ * {@link DLAvatar}. Otherwise it falls back to a themed, colormoded
+ * {@link AlienIcon} placeholder so every consumer (profile, sidebar,
+ * principal overlay, …) shares the same default look.
+ */
+import type { JSX } from 'react';
 /**
  * Returns `true` when the given URL points to a real user avatar (i.e. not a
  * Gravatar default placeholder).
@@ -16,7 +25,15 @@ export type UserAvatarProps = {
     fallbackBackground?: string;
     /** Optional icon foreground color override for the default avatar. */
     fallbackForeground?: string;
+    /**
+     * Whether a ring is drawn around the avatar.
+     *
+     * Off by default: an avatar sits on its own in most places, and a ring
+     * there is one more line for nothing. On, it gives the avatar an edge of
+     * its own against a background of the same colour — a profile page, a card.
+     */
+    ring?: boolean;
     className?: string;
 };
-export declare const UserAvatar: ({ avatarUrl, avatarIcon, size, square, iconSize, fallbackBackground, fallbackForeground, className, }: UserAvatarProps) => JSX.Element;
+export declare const UserAvatar: ({ avatarUrl, avatarIcon, size, square, iconSize, fallbackBackground, fallbackForeground, ring, className, }: UserAvatarProps) => JSX.Element;
 export default UserAvatar;

package/lib/components/avatars/UserAvatar.js

@@ -1,16 +1,4 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * UserAvatar – Single source of truth for rendering a user's avatar.
- *
- * When a real (non-Gravatar) avatar URL is available it renders a
- * {@link DLAvatar}. Otherwise it falls back to a themed, colormoded
- * {@link AlienIcon} placeholder so every consumer (profile, sidebar,
- * principal overlay, …) shares the same default look.
- */
 import { AlienIcon } from '@datalayer/icons-react';
 import { Box, useColorPalette } from '@datalayer/primer-addons';
 import { DLAvatar } from './DLAvatar.js';
@@ -28,8 +16,18 @@ export function hasRealAvatar(url) {
     }
     return true;
 }
-export const UserAvatar = ({ avatarUrl, avatarIcon, size = 100, square = true, iconSize, fallbackBackground, fallbackForeground, className, }) => {
+export const UserAvatar = ({ avatarUrl, avatarIcon, size = 100, square = true, iconSize, fallbackBackground, fallbackForeground, ring = false, className, }) => {
     const palette = useColorPalette();
+    /*
+     * The ring, as a shadow rather than a border.
+     *
+     * A border would take from the size asked for — the avatar is laid out
+     * against others of the same measure — so it is drawn just outside the
+     * edge instead, following whatever shape the avatar has.
+     */
+    const ringSx = ring
+        ? { boxShadow: '0 0 0 1px var(--borderColor-default, currentColor)' }
+        : undefined;
     const SelectedIcon = getPrincipalAvatarIcon(avatarIcon);
     if (SelectedIcon) {
         return (_jsx(Box, { className: className, sx: {
@@ -42,10 +40,11 @@ export const UserAvatar = ({ avatarUrl, avatarIcon, size = 100, square = true, i
                 justifyContent: 'center',
                 bg: fallbackBackground || 'accent.subtle',
                 '--datalayer-icon-fg': fallbackForeground || palette.primary,
+                ...ringSx,
             }, children: _jsx(SelectedIcon, { size: iconSize ?? Math.round(size * 0.62), themed: true, colormode: true }) }));
     }
     if (hasRealAvatar(avatarUrl)) {
-        return _jsx(DLAvatar, { className: className, square: square, src: avatarUrl, size: size });
+        return (_jsx(DLAvatar, { className: className, square: square, src: avatarUrl, size: size, sx: ringSx }));
     }
     const resolvedIconSize = iconSize ?? Math.round(size * 0.48);
     return (_jsx(Box, { className: className, sx: {
@@ -57,6 +56,7 @@ export const UserAvatar = ({ avatarUrl, avatarIcon, size = 100, square = true, i
             alignItems: 'center',
             justifyContent: 'center',
             '--datalayer-icon-fg': fallbackForeground || palette.primary,
+            ...ringSx,
         }, children: _jsx(AlienIcon, { size: resolvedIconSize, themed: true, colormode: true }) }));
 };
 export default UserAvatar;

package/lib/components/avatars/UserProfileAvatar.d.ts

@@ -4,5 +4,5 @@ type IUserProfileAvatarProps = {
     size?: number;
     onClick?: React.MouseEventHandler<any>;
 };
-export declare const UserProfileAvatar: ({ onClick, user, size, }: IUserProfileAvatarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const UserProfileAvatar: ({ onClick, user, size, }: IUserProfileAvatarProps) => import("react").JSX.Element;
 export default UserProfileAvatar;

package/lib/components/banners/NoAutomationBanner.d.ts

@@ -1,2 +1,2 @@
-export declare const NoAutomationBanner: () => import("react/jsx-runtime").JSX.Element;
+export declare const NoAutomationBanner: () => import("react").JSX.Element;
 export default NoAutomationBanner;

package/lib/components/billing/BillingEntitySelect.d.ts

@@ -1,3 +1,13 @@
+/**
+ * BillingEntitySelect — self-contained dropdown that lets the user pick a
+ * billing entity (personal, organization, or eligible team) for runs that
+ * consume wallet credits.
+ *
+ * Encapsulates eligibility merge logic and account-detail fetching. Callers
+ * only need to provide a value/onChange pair and optionally observe the full
+ * resolved account via `onSelectedAccountChange`.
+ */
+import type { JSX } from 'react';
 export type BillingEntityType = 'user' | 'organization' | 'team';
 export type BillingEntity = {
     accountUid: string;

package/lib/components/billing/BillingEntitySelect.js

@@ -1,21 +1,4 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/*
- * Copyright (c) 2023-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * BillingEntitySelect — self-contained dropdown that lets the user pick a
- * billing entity (personal, organization, or eligible team) for runs that
- * consume wallet credits.
- *
- * Encapsulates eligibility merge logic and account-detail fetching. Callers
- * only need to provide a value/onChange pair and optionally observe the full
- * resolved account via `onSelectedAccountChange`.
- */
 import { useCallback, useEffect, useMemo, useRef, Fragment } from 'react';
 import { ActionList, ActionMenu, Button, FormControl, Label, Spinner, Text, } from '@primer/react';
 import { OrganizationIcon, PeopleIcon, PersonIcon, } from '@primer/octicons-react';

package/lib/components/billing/index.js

@@ -2,8 +2,4 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-/*
- * Copyright (c) 2023-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
 export * from './BillingEntitySelect.js';

package/lib/components/buttons/DownloadCSVButton.d.ts

@@ -4,5 +4,5 @@ type IDownloadCSVButtonProps = {
     fileName: string;
     variant?: VariantType;
 };
-export declare const DownloadCSVButton: ({ data, fileName, variant, }: IDownloadCSVButtonProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DownloadCSVButton: ({ data, fileName, variant, }: IDownloadCSVButtonProps) => import("react").JSX.Element;
 export default DownloadCSVButton;

package/lib/components/buttons/DownloadJsonButton.d.ts

@@ -5,5 +5,5 @@ type IDownloadJsonButtonProps = {
     extension?: string;
     variant?: VariantType;
 };
-export declare const DownloadJsonButton: ({ data, fileName, variant, extension, }: IDownloadJsonButtonProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DownloadJsonButton: ({ data, fileName, variant, extension, }: IDownloadJsonButtonProps) => import("react").JSX.Element;
 export default DownloadJsonButton;

package/lib/components/buttons/LongActionButton.d.ts

@@ -1,3 +1,4 @@
+import type { JSX } from 'react';
 import { type ElementType } from 'react';
 type ILongActionButtonProps = {
     /**