@dataworkz/crystal 0.1.0-beta.0 → 0.1.0-beta.2

package/CHANGELOG.md

@@ -2,30 +2,58 @@
 
 All notable changes to this package. Versions follow [semver](https://semver.org); betas may still change the API.
 
+## 0.1.0-beta.2 — 2026-11-04
+
+### Fixed
+- Small selects get small options wherever their list is appended: `provideCrystalPrimeNG()` now adds
+  `dw-select-panel--sm` to the overlay of every `p-select` / `p-multiselect` with `size="small"`, through PrimeNG's
+  pass-through (`DW_PRIMENG_PT`, exported). Lists appended to `<body>` used to keep the 14px rows; screens no longer
+  set the class by hand. An app's own `pt` settings are merged over crystal's.
+- A selected `dw-icon-button` with `variant="danger"` stays danger red instead of switching to the accent (e.g. a
+  "not helpful" rating). Every other variant's selected state is unchanged.
+
+## 0.1.0-beta.1 — 2026-11-04
+
+The package is now product-neutral: no app type ids, app-only CSS or app validator messages ship in it. An app maps
+its own vocabulary onto crystal through two new provider hooks.
+
+### Breaking
+- Logo lookups are by icon key only. `getToolIconPath`, `resolveToolIconKey`, `getStorageIconPath`,
+  `resolveStorageIconKey`, `BUILT_IN_TOOL_ICON`, `AGENT_NODE_ICON` and `GENERIC_STORAGE_ICON_LEGACY` are removed; use
+  `toolIcon(key)` and `storageIcon(key, { set })`. Type-id → key maps belong to the app.
+- `dw-entity-icon` `kind="tool"` / `kind="storage"` read `type` as an icon key (`snowflake`, `s3`…), unless the app
+  provides a resolver (below).
+- The chat-message, chat-composer and citation-chip CSS is removed from `styles/` (it was app-specific).
+- `DW_FIELD_MESSAGES` holds Angular's built-in validators only (`required`, `requiredTrue`, `email`, `pattern`, `min`,
+  `max`, `minlength`, `maxlength`). Messages for an app's own validators come from `provideCrystalFieldMessages()`.
+
+### Added
+- `TOOL_ICON_KEYS`, `isToolIconKey()`, `toolIcon()`, `GENERIC_TOOL_ICON`, `storageIconKeys()`, `storageIcon()`, and the
+  `ToolIconKey` / `StorageIconKey` types (`@dataworkz/crystal/icons`).
+- `provideCrystalIconResolvers({ tool, storage })`: map an app's type ids to icon keys for `dw-entity-icon`.
+- `provideCrystalFieldMessages({ … })`: messages for an app's own validator keys (a per-field `messages` input still
+  wins).
+
+### Changed
+- Comments, examples and the raw `icons/svg/` files carry no internal references; shipped SVGs have no comments.
+- The package check fails a build that ships app vocabulary, source maps included.
+
 ## 0.1.0-beta.0 — 2026-11-04
 
-First release: the Dataworkz core UI, moved out of dataworkz-ui (`0b7c763c`) into its own package.
+First release.
 
 ### Added
 - 49 `dw-*` components and directives (buttons, menus, badges, tags, chips, cards, sections, tabs, nav list, dialogs,
-  drawers, popovers, tables, fields, file dropzone, toasts…), with the same selectors, inputs and outputs as dataworkz-ui.
+  drawers, popovers, tables, fields, file dropzone, toasts…).
 - `provideCrystal({ theme })` and `ThemeService` (light / dark on `data-theme`), `provideCrystalPrimeNG()` and `DwPreset`
   (`@dataworkz/crystal/primeng`).
 - Toasts: `DwToastService` owns the stack (`success / info / warning / error`, `dismiss`, `clear`, `toasts`), rendered by
-  `<dw-toast-host>` in today's look.
-- Icons: every Dataworkz icon is an `.svg` file, inlined (no asset URLs): glyphs via `dw-icon` / `dwi-<name>`, tool /
-  storage / file-type logos as data URIs (`@dataworkz/crystal/icons`, raw files under `icons/svg/`).
+  `<dw-toast-host>`.
+- Icons: every icon is an `.svg` file, inlined (no asset URLs): glyphs via `dw-icon` / `dwi-<name>`, tool / storage /
+  file-type logos as data URIs (`@dataworkz/crystal/icons`, raw files under `icons/svg/`).
   `provideCrystalIcons()` / `DwIconRegistry` register an app's own icons by name.
 - Theme CSS (`styles/crystal.css`, `crystal-no-fonts.css`) with Inter and IBM Plex Mono bundled (OFL); nothing is
   loaded from a font service or CDN.
 - `installCrystalHostTheme()` themes pages crystal doesn't own (federated custom elements).
 - Token helpers `dwVar`, `cssVar`, `chartPalette` (`@dataworkz/crystal/tokens`); `dw-code-block`, `dw-markdown`
   (`@dataworkz/crystal/markdown`, optional `ngx-markdown`).
-
-### Changed (compared with the copies in dataworkz-ui)
-- `DwMenuItem.privilege` is gone: hide items with `visible` (e.g. `visible: auth.hasPrivilege('x')`).
-- The icon lookups (`getToolIconPath`, `getStorageIconPath`, `fileIconByExtension`) return data URIs instead of asset paths.
-- `DW_ICON_NAMES` is alphabetical.
-- `installElementTheme()` / `DwElementThemeComponent` are replaced by `installCrystalHostTheme()`; element hosts take the
-  `dw-element` class for the theme font.
-- `dw-tile` keeps a real space between its count and unit (screen readers read "3 connections").

package/README.md

@@ -33,6 +33,12 @@ export const appConfig = {
 - **Toasts:** `inject(DwToastService).success('Saved')`, `.error('Failed', { sticky: true })`, `.dismiss(id)`, `.clear()`.
 - **Your own icons:** `provideCrystalIcons({ rocket: rocketSvg })` (markup strings, e.g. `import rocketSvg from './rocket.svg?raw'`;
   any name not starting with `dw`), then `<dw-icon name="rocket" />` or `icon="rocket"`.
+- **Logos:** `toolIcon('snowflake')`, `storageIcon('s3')`, `storageIcon('postgres', { set: 'sources' })` (data URIs;
+  `TOOL_ICON_KEYS` / `storageIconKeys()` list the keys). `<dw-entity-icon kind="tool" type="snowflake" />` reads `type`
+  as a key; to pass your own type ids instead, map them once:
+  `provideCrystalIconResolvers({ tool: (type) => myToolKeys[type], storage: (type) => myStorageKeys[type] })`.
+- **Field messages:** `dw-field` knows Angular's built-in validators. Add messages for your own validator keys with
+  `provideCrystalFieldMessages({ duplicate: 'This name already exists' })` (a field's `messages` input still wins).
 - **Federated custom elements on a page you don't own:** `provideCrystal({ theme: { apply: false } })`, call
   `installCrystalHostTheme()` in the element's bootstrap, and put the `dw-element` class on the element host.
   `installCrystalHostTheme({ fonts: false })` if the page already loads Inter / IBM Plex Mono.

package/fesm2022/dataworkz-crystal-icons.mjs

@@ -267,339 +267,49 @@ function icon(name, size = '1em', color = 'currentColor') {
     return DW_GLYPH_SVGS[name].replace('<svg', `<svg width="${size}" height="${size}"`).replace(/currentColor/g, color);
 }
 
-/** Shown when a typeId matches no known tool family. */
+/** Every tool icon key, from the files in `icons/svg/tools/`. */
+const TOOL_ICON_KEYS = Object.keys(DW_LOGO_URIS)
+    .filter((path) => path.startsWith('tools/') && path !== 'tools/generic')
+    .map((path) => path.slice('tools/'.length));
+/** Shown for a tool without its own artwork. */
 const GENERIC_TOOL_ICON = DW_LOGO_URIS['tools/generic'];
-/** Built-in Dataworkz tools, identified by a `dz-` tool id prefix. */
-const BUILT_IN_TOOL_ICON = DW_LOGO_URIS['tools/built-in'];
-/** Agent nodes inside dependency / reference trees. */
-const AGENT_NODE_ICON = DW_LOGO_URIS['tools/agent'];
-/**
- * Backend `typeId` / `subType` values (lowercased) -> canonical family.
- * Also accepts the UI filter keys (`dataset-query`, `built-in`, ...) so filter
- * rows and tool rows resolve through the same table.
- */
-const TYPE_ID_TO_KEY = {
-    'dw-data-api': 'dataset-read',
-    dataset: 'dataset-read',
-    'dataset-query': 'dataset-read',
-    'dw-data-write-api': 'dataset-write',
-    'dataset-write': 'dataset-write',
-    qna: 'rag-app',
-    'qna-search': 'rag-app',
-    'rag-app': 'rag-app',
-    'mongodb.query': 'mongodb',
-    mongodb: 'mongodb',
-    graphql: 'graphql',
-    snowflake: 'snowflake',
-    'rest-api': 'rest-api',
-    llm: 'llm',
-    'relational-db': 'relational-db',
-    jdbc: 'relational-db',
-    composite: 'workflow',
-    workflow: 'workflow',
-    'call-agent': 'call-agent',
-    'dw-docstore-finddocs-api': 'docstore',
-    'dw-docstore-getdoc-api': 'docstore',
-    'dw-docstore-fetchdoccon-api': 'docstore',
-    // Custom metric tools. Only built-in rows carry these types, so they share the built-in
-    // mark - also on surfaces that pass the typeId without the dz- tool id.
-    'dw-metric-write-api': 'built-in',
-    'dw-metric-read-api': 'built-in',
-    'dw-metric-list-api': 'built-in',
-    agent: 'agent',
-    'built-in': 'built-in',
-    // Closed-loop system tools call a REST endpoint through a stored connection, so they reuse the
-    // rest-api family. Both the saved typeId and the create-route segment resolve here. A branded
-    // system that gains its own artwork adds a ToolIconKey; until then one row each is enough.
-    'generic-close-loop-system': 'rest-api',
-    'generic-saas': 'rest-api',
-};
-/**
- * The canonical icon per tool family. Bare glyphs — see the framing note above.
- *
- * `docstore` and `built-in` deliberately share the Dataworkz document mark: the
- * docstore APIs *are* built-in tools, and the two were only ever distinguished
- * by which folder a surface happened to read from.
- */
-const TOOL_ICONS = {
-    'dataset-read': DW_LOGO_URIS['tools/dataset-read'],
-    'dataset-write': DW_LOGO_URIS['tools/dataset-write'],
-    'rag-app': DW_LOGO_URIS['tools/rag-app'],
-    mongodb: DW_LOGO_URIS['tools/mongodb'],
-    graphql: DW_LOGO_URIS['tools/graphql'],
-    snowflake: DW_LOGO_URIS['tools/snowflake'],
-    'rest-api': DW_LOGO_URIS['tools/rest-api'],
-    llm: DW_LOGO_URIS['tools/llm'],
-    'relational-db': DW_LOGO_URIS['tools/relational-db'],
-    workflow: DW_LOGO_URIS['tools/workflow'],
-    'call-agent': DW_LOGO_URIS['tools/call-agent'],
-    docstore: BUILT_IN_TOOL_ICON,
-    agent: AGENT_NODE_ICON,
-    'built-in': BUILT_IN_TOOL_ICON,
-};
-const has = (text, needle) => text.includes(needle);
-const isDocStore = (text) => has(text, 'docstore') || has(text, 'doc store');
+function isToolIconKey(key) {
+    return !!key && TOOL_ICON_KEYS.includes(key);
+}
 /**
- * Ordered loose rules for callers that only have free text (a tool name, a
- * label, several fields joined together) instead of a clean typeId. Order
- * matters: the first match wins.
+ * The tool icon (a data URI) for a key, e.g. `toolIcon('snowflake')`, or `fallback` for an unknown key.
+ * Keys are crystal's artwork names; map your own tool types to them (e.g. with `provideCrystalIconResolvers()`).
  */
-const FUZZY_RULES = [
-    {
-        key: 'dataset-write',
-        test: text => text === 'dw-data-write-api' ||
-            (has(text, 'dataset') && has(text, 'write')) ||
-            (isDocStore(text) && has(text, 'write')),
-    },
-    {
-        key: 'dataset-read',
-        test: text => text === 'dw-data-api' ||
-            (has(text, 'dataset') && (has(text, 'read') || has(text, 'query'))) ||
-            (isDocStore(text) && (has(text, 'read') || has(text, 'query'))),
-    },
-    { key: 'dataset-read', test: isDocStore },
-    {
-        key: 'rag-app',
-        test: text => text === 'qna' || text === 'qna-search' || text === 'rag-app' || has(text, 'rag'),
-    },
-    {
-        key: 'mongodb',
-        test: text => text === 'mongodb.query' || text === 'mongodb' || has(text, 'mongo'),
-    },
-    { key: 'graphql', test: text => text === 'graphql' || has(text, 'graph') },
-    { key: 'snowflake', test: text => has(text, 'snowflake') },
-    { key: 'rest-api', test: text => text === 'rest-api' || has(text, 'rest') },
-    { key: 'llm', test: text => has(text, 'llm') },
-    {
-        key: 'relational-db',
-        test: text => text === 'relational-db' || text === 'jdbc' || has(text, 'relational'),
-    },
-    {
-        key: 'workflow',
-        test: text => text === 'composite' || text === 'workflow' || has(text, 'workflow'),
-    },
-    { key: 'call-agent', test: text => text === 'call-agent' || has(text, 'call agent') },
-];
-/** Canonical family for a typeId / subType, or `null` when unknown. */
-function resolveToolIconKey(typeId, options = {}) {
-    const normalized = String(typeId ?? '')
-        .trim()
-        .toLowerCase();
-    if (!normalized)
-        return null;
-    if (options.fuzzy) {
-        return FUZZY_RULES.find(rule => rule.test(normalized))?.key ?? null;
-    }
-    return TYPE_ID_TO_KEY[normalized] ?? null;
-}
-/** Icon (a data URI) for a tool type. The only place a tool icon is decided. (The name is kept from when it returned an asset path.) */
-function getToolIconPath(typeId, options = {}) {
-    const toolId = String(options.toolId ?? '')
-        .trim()
-        .toLowerCase();
-    if (toolId.startsWith('dz-'))
-        return TOOL_ICONS['built-in'];
-    const key = resolveToolIconKey(typeId, options);
-    if (key)
-        return TOOL_ICONS[key];
-    return options.fallback ?? GENERIC_TOOL_ICON;
+function toolIcon(key, fallback = GENERIC_TOOL_ICON) {
+    return isToolIconKey(key) ? DW_LOGO_URIS[`tools/${key}`] : fallback;
 }
 
-/** Shown for a storage type the set has no artwork for. */
+/** Shown for a storage type the set has no artwork for (the `local` and `legacy` sets). */
 const GENERIC_STORAGE_ICON = DW_LOGO_URIS['storage/generic'];
-/** The legacy set's generic icon: the same artwork as {@link GENERIC_STORAGE_ICON} (they were twin files). */
-const GENERIC_STORAGE_ICON_LEGACY = DW_LOGO_URIS['storage/generic'];
-/** Fallback for collection rows, which read better as a generic datastore. */
+/** A generic datastore, e.g. for collection rows. */
 const GENERIC_COLLECTION_ICON = DW_LOGO_URIS['storage/collection'];
-/**
- * Raw `storageType` values (lowercased) -> canonical family. Closed-loop SaaS
- * connectors are listed explicitly rather than prefix-stripped, because
- * `google` (cloud storage) and `closedloop_google` (Sheets) are different logos.
- */
-const STORAGE_TYPE_TO_KEY = {
-    s3: 's3',
-    azure: 'azure',
-    google: 'google-cloud',
-    gcp: 'google-cloud',
-    gcs: 'google-cloud',
-    hdfs: 'hdfs',
-    snowflake: 'snowflake',
-    bigquery: 'bigquery',
-    databricks: 'databricks',
-    datastax: 'datastax',
-    relational_mysql: 'mysql',
-    relational_postgres: 'postgres',
-    relational_cockroach: 'cockroach',
-    relational_oracle: 'oracle',
-    graph_oracle: 'oracle',
-    relational_mariadb: 'mariadb',
-    relational_db2: 'db2',
-    relational_microsoft: 'sqlserver',
-    mongodb: 'mongodb',
-    elastic_search: 'elastic',
-    aerospike: 'aerospike',
-    redshift: 'redshift',
-    kafka: 'kafka',
-    pinecone: 'pinecone',
-    neo4j: 'neo4j',
-    opensearch: 'opensearch',
-    couchbase: 'couchbase',
-    salesforce: 'salesforce',
-    closedloop_salesforce: 'salesforce',
-    marketo: 'marketo',
-    closedloop_marketo: 'marketo',
-    hubspot: 'hubspot',
-    closedloop_hubspot: 'hubspot',
-    jira: 'jira',
-    closedloop_jira: 'jira',
-    zoom: 'zoom',
-    closedloop_zoom: 'zoom',
-    outreach: 'outreach',
-    closedloop_outreach: 'outreach',
-    pendo: 'pendo',
-    closedloop_pendo: 'pendo',
-    closedloop_google: 'google-sheets',
-    storagebridge: 'storagebridge',
-    closedloop_storagebridge: 'storagebridge',
-    onedrive: 'onedrive',
-    sharepoint: 'sharepoint',
-    googledrive: 'googledrive',
-    nas: 'nas',
-    upload: 'upload',
-    microsoftmail: 'microsoft-mail',
-    closedloop_microsoftmail: 'microsoft-mail',
-    filestream: 'filestream',
-    closedloop_filestream: 'filestream',
-    broadcomclarity: 'broadcom-clarity',
-    closedloop_broadcomclarity: 'broadcom-clarity',
-};
-/**
- * dataworkz-ui's own artwork. File sources (onedrive, sharepoint, nas, upload…),
- * cockroach and the closed-loop-only connectors have no local art — those fall
- * through to the generic icon, as they did before.
- */
-const LOCAL_ICONS = {
-    s3: DW_LOGO_URIS['storage/local/s3'],
-    azure: DW_LOGO_URIS['storage/local/azure'],
-    'google-cloud': DW_LOGO_URIS['storage/local/google-cloud'],
-    hdfs: DW_LOGO_URIS['storage/local/hdfs'],
-    snowflake: DW_LOGO_URIS['storage/local/snowflake'],
-    bigquery: DW_LOGO_URIS['storage/local/bigquery'],
-    databricks: DW_LOGO_URIS['storage/local/databricks'],
-    datastax: DW_LOGO_URIS['storage/local/datastax'],
-    mysql: DW_LOGO_URIS['storage/local/mysql'],
-    postgres: DW_LOGO_URIS['storage/local/postgres'],
-    oracle: DW_LOGO_URIS['storage/local/oracle'],
-    mariadb: DW_LOGO_URIS['storage/local/mariadb'],
-    db2: DW_LOGO_URIS['storage/local/db2'],
-    sqlserver: DW_LOGO_URIS['storage/local/sqlserver'],
-    mongodb: DW_LOGO_URIS['storage/local/mongodb'],
-    elastic: DW_LOGO_URIS['storage/local/elastic'],
-    aerospike: DW_LOGO_URIS['storage/local/aerospike'],
-    redshift: DW_LOGO_URIS['storage/local/redshift'],
-    kafka: DW_LOGO_URIS['storage/local/kafka'],
-    pinecone: DW_LOGO_URIS['storage/local/pinecone'],
-    neo4j: DW_LOGO_URIS['storage/local/neo4j'],
-    opensearch: DW_LOGO_URIS['storage/local/opensearch'],
-    couchbase: DW_LOGO_URIS['storage/local/couchbase'],
-    salesforce: DW_LOGO_URIS['storage/local/salesforce'],
-    marketo: DW_LOGO_URIS['storage/local/marketo'],
-    hubspot: DW_LOGO_URIS['storage/local/hubspot'],
-    jira: DW_LOGO_URIS['storage/local/jira'],
-    zoom: DW_LOGO_URIS['storage/local/zoom'],
-    outreach: DW_LOGO_URIS['storage/local/outreach'],
-    pendo: DW_LOGO_URIS['storage/local/pendo'],
-    'google-sheets': DW_LOGO_URIS['storage/local/google-sheets'],
-    'microsoft-mail': DW_LOGO_URIS['storage/local/microsoft-mail'],
-};
-/**
- * dataworkz-web's artwork — the widest set, and the only one carrying
- * file-source and closed-loop-only artwork. Some logos differ from `local`
- * (e.g. sqlserver, onedrive).
- */
-const LEGACY_ICONS = {
-    s3: DW_LOGO_URIS['storage/legacy/s3'],
-    azure: DW_LOGO_URIS['storage/legacy/azure'],
-    'google-cloud': DW_LOGO_URIS['storage/legacy/google-cloud'],
-    hdfs: DW_LOGO_URIS['storage/legacy/hdfs'],
-    snowflake: DW_LOGO_URIS['storage/legacy/snowflake'],
-    bigquery: DW_LOGO_URIS['storage/legacy/bigquery'],
-    databricks: DW_LOGO_URIS['storage/legacy/databricks'],
-    datastax: DW_LOGO_URIS['storage/legacy/datastax'],
-    mysql: DW_LOGO_URIS['storage/legacy/mysql'],
-    postgres: DW_LOGO_URIS['storage/legacy/postgres'],
-    cockroach: DW_LOGO_URIS['storage/legacy/cockroach'],
-    oracle: DW_LOGO_URIS['storage/legacy/oracle'],
-    mariadb: DW_LOGO_URIS['storage/legacy/mariadb'],
-    db2: DW_LOGO_URIS['storage/legacy/db2'],
-    sqlserver: DW_LOGO_URIS['storage/legacy/sqlserver'],
-    mongodb: DW_LOGO_URIS['storage/legacy/mongodb'],
-    elastic: DW_LOGO_URIS['storage/legacy/elastic'],
-    aerospike: DW_LOGO_URIS['storage/legacy/aerospike'],
-    redshift: DW_LOGO_URIS['storage/legacy/redshift'],
-    kafka: DW_LOGO_URIS['storage/legacy/kafka'],
-    pinecone: DW_LOGO_URIS['storage/legacy/pinecone'],
-    neo4j: DW_LOGO_URIS['storage/legacy/neo4j'],
-    opensearch: DW_LOGO_URIS['storage/legacy/opensearch'],
-    couchbase: DW_LOGO_URIS['storage/legacy/couchbase'],
-    salesforce: DW_LOGO_URIS['storage/legacy/salesforce'],
-    marketo: DW_LOGO_URIS['storage/legacy/marketo'],
-    hubspot: DW_LOGO_URIS['storage/legacy/hubspot'],
-    jira: DW_LOGO_URIS['storage/legacy/jira'],
-    zoom: DW_LOGO_URIS['storage/legacy/zoom'],
-    outreach: DW_LOGO_URIS['storage/legacy/outreach'],
-    pendo: DW_LOGO_URIS['storage/legacy/pendo'],
-    'google-sheets': DW_LOGO_URIS['storage/legacy/google-sheets'],
-    storagebridge: DW_LOGO_URIS['storage/legacy/storagebridge'],
-    onedrive: DW_LOGO_URIS['storage/legacy/onedrive'],
-    sharepoint: DW_LOGO_URIS['storage/legacy/sharepoint'],
-    googledrive: DW_LOGO_URIS['storage/legacy/googledrive'],
-    nas: DW_LOGO_URIS['storage/legacy/nas'],
-    upload: DW_LOGO_URIS['storage/legacy/upload'],
-    filestream: DW_LOGO_URIS['storage/legacy/filestream'],
-    'broadcom-clarity': DW_LOGO_URIS['storage/legacy/broadcom-clarity'],
-    // dataworkz-web has no artwork of its own for it: the same file as `local`.
-    'microsoft-mail': DW_LOGO_URIS['storage/legacy/microsoft-mail'],
-};
-/** File-source artwork for the data-collections drawers. */
-const SOURCES_ICONS = {
-    s3: DW_LOGO_URIS['storage/sources/s3'],
-    azure: DW_LOGO_URIS['storage/sources/azure'],
-    'google-cloud': DW_LOGO_URIS['storage/sources/google-cloud'],
-    sharepoint: DW_LOGO_URIS['storage/sources/sharepoint'],
-    onedrive: DW_LOGO_URIS['storage/sources/onedrive'],
-    googledrive: DW_LOGO_URIS['storage/sources/googledrive'],
-    nas: DW_LOGO_URIS['storage/sources/nas'],
-};
-const ICON_SETS = {
-    local: LOCAL_ICONS,
-    legacy: LEGACY_ICONS,
-    sources: SOURCES_ICONS,
-};
+/** What each set falls back to: the generic icon, or nothing for `sources` (its callers hide the icon slot). */
 const SET_FALLBACK = {
     local: GENERIC_STORAGE_ICON,
-    legacy: GENERIC_STORAGE_ICON_LEGACY,
-    // The drawers hide the icon slot entirely when a source has no artwork.
+    legacy: GENERIC_STORAGE_ICON,
     sources: '',
 };
-/** Canonical family for a `storageType`, or `null` when unknown. */
-function resolveStorageIconKey(storageType) {
-    const normalized = String(storageType ?? '')
-        .trim()
-        .toLowerCase();
-    if (!normalized)
-        return null;
-    return STORAGE_TYPE_TO_KEY[normalized] ?? null;
+/** The storage icon keys a set has artwork for. */
+function storageIconKeys(set = 'local') {
+    const prefix = `storage/${set}/`;
+    return Object.keys(DW_LOGO_URIS)
+        .filter((path) => path.startsWith(prefix))
+        .map((path) => path.slice(prefix.length));
 }
 /**
- * Icon (a data URI) for a storage / SaaS connector type. The only place a storage
- * icon is decided. (The name is kept from when it returned an asset path.)
+ * The storage icon (a data URI) for a key in a set, e.g. `storageIcon('s3')` or `storageIcon('upload', { set: 'legacy' })`,
+ * else the set's fallback. Keys are crystal's artwork names; map your own storage types to them (e.g. with
+ * `provideCrystalIconResolvers()`).
  */
-function getStorageIconPath(storageType, options = {}) {
+function storageIcon(key, options = {}) {
     const set = options.set ?? 'local';
-    const key = resolveStorageIconKey(storageType);
-    const icon = key ? ICON_SETS[set][key] : undefined;
-    return icon ?? options.fallback ?? SET_FALLBACK[set];
+    const uri = key ? DW_LOGO_URIS[`storage/${set}/${key}`] : undefined;
+    return uri ?? options.fallback ?? SET_FALLBACK[set];
 }
 
 const FILE_EXTENSION_GROUPS = {
@@ -821,13 +531,13 @@ function sourceTypeLabelByExtension(extension) {
 }
 
 /*
- * @dataworkz/crystal/icons — framework-free icon names and lookups (no Angular imports).
- * P2 moves the glyphs into .svg files and makes the lookups return data URIs (MIGRATION-PLAN §2.2).
+ * @dataworkz/crystal/icons — framework-free icon names, markup and logos (no Angular imports). Every icon is a file in
+ * icons/svg/, inlined: glyphs as markup, logos as data URIs.
  */
 
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { AGENT_NODE_ICON, BUILT_IN_TOOL_ICON, DW_ICON_NAMES, DW_ICON_PREFIX, DW_LOGO_URIS, GENERIC_COLLECTION_ICON, GENERIC_STORAGE_ICON, GENERIC_STORAGE_ICON_LEGACY, GENERIC_TOOL_ICON, dwIconName, fileIconByExtension, getStorageIconPath, getToolIconPath, icon, isGlyphName, resolveStorageIconKey, resolveToolIconKey };
+export { DW_ICON_NAMES, DW_ICON_PREFIX, DW_LOGO_URIS, GENERIC_COLLECTION_ICON, GENERIC_STORAGE_ICON, GENERIC_TOOL_ICON, TOOL_ICON_KEYS, dwIconName, fileIconByExtension, icon, isGlyphName, isToolIconKey, storageIcon, storageIconKeys, toolIcon };
 //# sourceMappingURL=dataworkz-crystal-icons.mjs.map