@zeyos/zx 2.3.0 → 4.0.0

package/src/zeyos/icons.js

@@ -55,6 +55,7 @@ export function moduleIcon(name, options = {}) {
  * @property {string|null} [label=null] Accessible label; null marks the chip decorative.
  * @property {boolean} [title=false] Adds the module's display name as a `title` tooltip.
  * @property {boolean} [standard=false] Use the stock Font Awesome fallback glyph.
+ * @property {string} [color] Override the module colour for a server-defined fork or weblet.
  * @property {string|string[]} [class] Extra class names.
  */
 
@@ -67,16 +68,20 @@ export function moduleIcon(name, options = {}) {
  * @returns {HTMLElement} A `<span class="zx-module-icon">` wrapping the glyph.
  */
 export function moduleChip(name, options = {}) {
-  const { size = 24, iconSize = '1em', label = null, title = false, standard = false } = options;
+  const {
+    size = 24, iconSize = '1em', label = null, title = false, standard = false,
+    color = null
+  } = options;
   const key = normalizeModuleName(name);
   const info = moduleInfo(name);
+  const background = color || info.color;
 
   const chip = h('span', {
     class: ['zx-module-icon', options.class].flat().filter(Boolean),
     dataset: { module: key },
     style: {
-      '--zx-module-color': info.color,
-      '--zx-module-glyph': moduleGlyphColor(info.color),
+      '--zx-module-color': background,
+      '--zx-module-glyph': moduleGlyphColor(background),
       '--zx-module-icon-size': typeof size === 'number' ? `${size}px` : String(size)
     },
     title: title ? info.label : null

package/src/zeyos/index.js

@@ -16,6 +16,12 @@ export {
   moduleGlyphColor, normalizeModuleName, registerModules
 } from './modules.js';
 export { ZEYOS_ICON_KIT, useZeyosIcons, moduleIcon, moduleChip } from './icons.js';
-export { zeyosSelect } from './select.js';
+export {
+  ZEYOS_LAUNCHER_APPLICATIONS, buildZeyosLauncherConfig, zeyosLauncher,
+  normalizeZeyosLauncherApplications, normalizeZeyosLauncherRecords, zeyosActiveIdentifier
+} from './launcher.js';
+export {
+  zeyosSelect, buildZeyosSelectConfig, zeyosEntitySelect, buildZeyosEntitySelectConfig
+} from './select.js';
 export { zeyosForm } from './form.js';
 export { zeyosTable } from './table.js';

package/src/zeyos/launcher.js

@@ -0,0 +1,338 @@
+import { Launcher } from '../components/launcher/launcher.js';
+import { moduleChip } from './icons.js';
+import { moduleInfo } from './modules.js';
+
+/** Static application identifiers present in the current ZeyOS shell prototype. */
+export const ZEYOS_LAUNCHER_APPLICATIONS = Object.freeze([
+  'accounts', 'actionsteps', 'admin', 'auth', 'billing', 'calendar', 'campaigns', 'collection',
+  'contacts', 'contracts', 'control', 'coupons', 'dev', 'documents', 'inventory', 'mailinglists',
+  'main', 'messages', 'links', 'notes', 'objects', 'opportunities', 'payments', 'pricelists',
+  'procurement', 'production', 'projects', 'tasks', 'tickets'
+]);
+
+/**
+ * @typedef {Object} ZeyosLauncherState
+ * @property {Record<string, string>|Array<string|Record<string, any>>} [modules={}] Permitted module catalogue.
+ * @property {Array<Array<any>|Record<string, any>>} [menuApps=[]] Forks/weblets and authoritative menu entries.
+ * @property {string[]} [pinned=[]] Application identifiers in pinned order.
+ * @property {Array<Array<any>|Record<string, any>>} [recent=[]] Recent records.
+ * @property {string|null} [activeIdentifier=null] Current module, `fork#…`, or `weblet#…` identifier.
+ * @property {(module: string) => boolean} [canUseModule] Permission predicate.
+ * @property {(query: string, context: {signal: AbortSignal}) => Promise<unknown>|unknown} [search] Record search loader.
+ * @property {(context: {signal: AbortSignal}) => Promise<unknown>|unknown} [loadRecent] Recent-record loader.
+ * @property {(app: unknown) => Record<string, any>|null} [resolveApplication] Maps an app to href/invoke/value metadata.
+ * @property {(record: unknown) => Record<string, any>|null} [resolveRecord] Maps a record to href/invoke/value metadata.
+ * @property {Record<string, any>} [labels] Localized applications/recent/results/entity labels and hints.
+ * @property {(app: unknown, normalized: Record<string, any>) => Node|null} [renderApplicationIcon] Host icon renderer for modules, forks, and weblets.
+ * @property {(record: unknown, normalized: Record<string, any>) => Node|null} [renderRecordIcon] Host record icon renderer.
+ * @property {(app: unknown, normalized: Record<string, any>) => Node|null} [renderWebletIcon] Legacy weblet-only icon renderer.
+ */
+
+/**
+ * @typedef {Object} ZeyosLauncherOptions
+ * @property {boolean} [standardIcons=false] Use stock icon fallbacks instead of the optional ZeyOS kit.
+ * @property {Array<Record<string, any>>} [items] Extra generic Launcher items.
+ * @property {Array<Record<string, any>>} [sources] Extra generic Launcher sources.
+ */
+
+/**
+ * Builds a generic Launcher configuration from explicitly injected ZeyOS shell state. It never
+ * reads PG/C globals and never resolves a route itself.
+ * @param {ZeyosLauncherState} [state={}] Application-owned shell state.
+ * @param {ZeyosLauncherOptions & Record<string, any>} [options={}] Adapter and Launcher options.
+ * @returns {Record<string, any>} Plain Launcher options.
+ */
+export function buildZeyosLauncherConfig(state = {}, options = {}) {
+  const {
+    standardIcons = false,
+    items: extraItems = [],
+    sources: extraSources = [],
+    ...launcherOptions
+  } = options;
+  const labels = launcherLabels(state.labels);
+  const iconOptions = {
+    standardIcons,
+    renderApplicationIcon: state.renderApplicationIcon,
+    renderWebletIcon: state.renderWebletIcon
+  };
+  const applications = normalizeZeyosLauncherApplications(state, iconOptions);
+  const recent = typeof state.loadRecent === 'function' ? []
+    : normalizeZeyosLauncherRecords(state.recent ?? [], {
+      query: '', labels, resolveRecord: state.resolveRecord,
+      renderRecordIcon: state.renderRecordIcon, standardIcons
+    });
+  const sources = [];
+  if (typeof state.loadRecent === 'function') {
+    sources.push({
+      id: 'zeyos-recent',
+      minQuery: 0,
+      when: 'empty',
+      order: 'source',
+      load: async (_query, context) => normalizeZeyosLauncherRecords(
+        await state.loadRecent(context),
+        {
+          query: '', labels, resolveRecord: state.resolveRecord,
+          renderRecordIcon: state.renderRecordIcon, standardIcons
+        }
+      )
+    });
+  }
+  if (typeof state.search === 'function') {
+    sources.push({
+      id: 'zeyos-records',
+      minQuery: 1,
+      when: 'query',
+      order: 'source',
+      load: async (query, context) => normalizeZeyosLauncherRecords(
+        await state.search(query, context),
+        {
+          query, labels, resolveRecord: state.resolveRecord,
+          renderRecordIcon: state.renderRecordIcon, standardIcons
+        }
+      )
+    });
+  }
+  sources.push(...extraSources);
+  return {
+    ...launcherOptions,
+    items: [...applications, ...recent, ...extraItems],
+    sources,
+    hints: options.hints ?? {
+      move: labels.move,
+      open: labels.open,
+      close: labels.close
+    }
+  };
+}
+
+/**
+ * Creates the ZeyOS-configured Launcher. State and route resolvers remain caller-owned inputs.
+ * @param {ZeyosLauncherState} [state={}] Injected shell state.
+ * @param {ZeyosLauncherOptions & Record<string, any>} [options={}] Adapter and Launcher options.
+ * @returns {Launcher}
+ */
+export function zeyosLauncher(state = {}, options = {}) {
+  return new Launcher(null, buildZeyosLauncherConfig(state, options));
+}
+
+/**
+ * Normalizes module, fork, and weblet applications while preserving menu authority and pin order.
+ * @param {ZeyosLauncherState} [state={}] Injected shell state.
+ * @param {{standardIcons?: boolean, renderApplicationIcon?: Function, renderWebletIcon?: Function}} [options={}] Icon options.
+ * @returns {Array<Record<string, any>>}
+ */
+export function normalizeZeyosLauncherApplications(state = {}, options = {}) {
+  const labels = launcherLabels(state.labels);
+  const pinned = Array.isArray(state.pinned) ? state.pinned.map(String) : [];
+  const seen = new Set();
+  const items = [];
+  const add = (raw, fallbackId = null, fallbackLabel = null) => {
+    const app = normalizeApplication(raw, fallbackId, fallbackLabel);
+    if (!app || seen.has(app.identifier)) return;
+    if (app.type === 'module' && typeof state.canUseModule === 'function'
+      && !state.canUseModule(app.module)) return;
+    seen.add(app.identifier);
+    const resolved = mergeDestination(app.raw, state.resolveApplication);
+    const pin = pinned.indexOf(app.identifier);
+    const icon = () => {
+      const custom = typeof options.renderApplicationIcon === 'function'
+        ? options.renderApplicationIcon(app.raw, app)
+        : app.type === 'weblet' && typeof options.renderWebletIcon === 'function'
+          ? options.renderWebletIcon(app.raw, app) : null;
+      return custom ?? moduleChip(app.module, {
+        size: 36,
+        standard: Boolean(options.standardIcons),
+        color: app.color
+      });
+    };
+    items.push({
+      id: app.identifier,
+      label: app.label,
+      keywords: [app.identifier, app.module],
+      group: labels.applications,
+      groupOrder: 0,
+      kind: 'application',
+      icon,
+      pinned: pin >= 0 ? pin : undefined,
+      current: app.identifier === state.activeIdentifier,
+      disabled: !resolved.href && typeof resolved.invoke !== 'function',
+      ...resolved,
+      _zeyos: app
+    });
+  };
+
+  for (const raw of Array.isArray(state.menuApps) ? state.menuApps : []) add(raw);
+  if (Array.isArray(state.modules)) {
+    for (const module of state.modules) {
+      if (typeof module === 'string') add([module, moduleInfo(module).label]);
+      else add(module, module?.id ?? module?.module, module?.label);
+    }
+  } else {
+    for (const [module, label] of Object.entries(state.modules ?? {})) add([module, label]);
+  }
+  return items;
+}
+
+/**
+ * Normalizes recent records or grouped search payloads without losing server/group order.
+ * @param {unknown} payload Recent/search payload.
+ * @param {{query?: string, labels?: Record<string, any>, resolveRecord?: Function, renderRecordIcon?: Function, standardIcons?: boolean}} [options={}] Mapping options.
+ * @returns {Array<Record<string, any>>}
+ */
+export function normalizeZeyosLauncherRecords(payload, options = {}) {
+  const query = String(options.query ?? '');
+  const labels = launcherLabels(options.labels);
+  const records = flattenRecords(payload, query);
+  const groupOrders = new Map();
+  return records.flatMap(({ raw, group }, itemOrder) => {
+    const record = normalizeRecord(raw, group, query);
+    if (!record) return [];
+    const groupName = query === '' ? labels.recent
+      : record.group === '' ? labels.results
+        : labels.entities[record.group] ?? record.group;
+    if (!groupOrders.has(groupName)) groupOrders.set(groupName, groupOrders.size + 1);
+    const resolved = mergeDestination(record.raw, options.resolveRecord);
+    return [{
+      id: `record:${record.entity}:${record.fork ?? ''}:${record.ID}`,
+      label: record.name,
+      description: record.sec,
+      keywords: [record.entity, record.ID, record.fork ?? ''],
+      group: groupName,
+      groupOrder: groupOrders.get(groupName),
+      itemOrder,
+      kind: 'record',
+      when: query === '' ? 'empty' : 'query',
+      icon: () => {
+        const custom = typeof options.renderRecordIcon === 'function'
+          ? options.renderRecordIcon(record.raw, record) : null;
+        return custom ?? moduleChip(record.entity, {
+          size: 28,
+          standard: Boolean(options.standardIcons)
+        });
+      },
+      disabled: !resolved.href && typeof resolved.invoke !== 'function',
+      ...resolved,
+      _zeyos: record
+    }];
+  });
+}
+
+/** @param {{module?: string, fork?: unknown, weblet?: unknown}} state @returns {string} */
+export function zeyosActiveIdentifier(state = {}) {
+  if (state.weblet != null && state.weblet !== '') return `weblet#${state.weblet}`;
+  if (state.fork != null && state.fork !== '') return `fork#${state.fork}`;
+  return String(state.module ?? '');
+}
+
+/** @param {unknown} raw @param {string|null} fallbackId @param {unknown} fallbackLabel @returns {Record<string, any>|null} */
+function normalizeApplication(raw, fallbackId, fallbackLabel) {
+  if (Array.isArray(raw)) {
+    if (raw.length < 2) return null;
+    if (raw.length === 2) {
+      const module = String(raw[0]);
+      return { raw, identifier: module, label: String(raw[1]), module, type: 'module', color: null };
+    }
+    if (raw.length === 4) {
+      const module = String(raw[2] || 'default');
+      return {
+        raw, identifier: `fork#${raw[0]}`, label: String(raw[1]), module, type: 'fork',
+        color: normalizeServerColor(raw[3])
+      };
+    }
+    return {
+      raw, identifier: `weblet#${raw[0]}`, label: String(raw[1]), module: 'weblets',
+      type: 'weblet', color: normalizeServerColor(raw[8])
+    };
+  }
+  if (!raw || typeof raw !== 'object') return null;
+  const identifier = String(raw.identifier ?? raw.id ?? fallbackId ?? '');
+  if (!identifier) return null;
+  const type = identifier.startsWith('fork#') ? 'fork'
+    : identifier.startsWith('weblet#') ? 'weblet' : 'module';
+  return {
+    raw,
+    identifier,
+    label: String(raw.label ?? fallbackLabel ?? moduleInfo(identifier).label),
+    module: String(raw.module ?? (type === 'module' ? identifier : type === 'fork' ? 'default' : 'weblets')),
+    type,
+    color: normalizeServerColor(raw.color)
+  };
+}
+
+/** @param {unknown} payload @param {string} query @returns {Array<{raw: unknown, group: string}>} */
+function flattenRecords(payload, query) {
+  if (Array.isArray(payload)) return payload.map((raw) => ({ raw, group: raw?.group ?? '' }));
+  if (!payload || typeof payload !== 'object') return [];
+  const result = [];
+  for (const [group, rows] of Object.entries(payload)) {
+    if (!Array.isArray(rows)) continue;
+    for (const row of rows) {
+      if (!Array.isArray(row)) {
+        result.push({ raw: row, group });
+        continue;
+      }
+      // Search payloads use [ID,fork,name,sec] under an entity key; top results carry entity last.
+      const raw = group === '' && row.length >= 5
+        ? { ID: row[0], fork: row[1], name: row[2], sec: row[3], entity: row[4], group }
+        : { ID: row[0], fork: row[1], name: row[2], sec: row[3], entity: group, group };
+      result.push({ raw, group });
+    }
+  }
+  return result;
+}
+
+/** @param {unknown} raw @param {string} group @param {string} query @returns {Record<string, any>|null} */
+function normalizeRecord(raw, group, query) {
+  if (Array.isArray(raw)) {
+    if (query === '' && raw.length >= 4) {
+      return {
+        raw, entity: String(raw[0]), ID: raw[1], fork: raw[2] ?? null,
+        name: String(raw[3]), sec: String(raw[4] ?? ''), group: ''
+      };
+    }
+    return null;
+  }
+  if (!raw || typeof raw !== 'object' || raw.ID == null || raw.name == null) return null;
+  return {
+    raw,
+    entity: String(raw.entity ?? group ?? 'records'),
+    ID: raw.ID,
+    fork: raw.fork ?? null,
+    name: String(raw.name),
+    sec: String(raw.sec ?? ''),
+    group: String(raw.group ?? group ?? '')
+  };
+}
+
+/** @param {unknown} raw @param {unknown} resolver @returns {Record<string, any>} */
+function mergeDestination(raw, resolver) {
+  const direct = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+  const resolved = typeof resolver === 'function' ? resolver(raw) : null;
+  const destination = resolved && typeof resolved === 'object' ? resolved : {};
+  return Object.fromEntries(['href', 'target', 'invoke', 'value'].flatMap((key) => {
+    const value = destination[key] ?? direct[key];
+    return value === undefined ? [] : [[key, value]];
+  }));
+}
+
+/** @param {unknown} value @returns {string|null} */
+function normalizeServerColor(value) {
+  const source = String(value ?? '').trim();
+  if (!source) return null;
+  const color = source.startsWith('#') ? source : `#${source}`;
+  return /^#[\da-f]{3}(?:[\da-f]{3})?$/i.test(color) ? color : null;
+}
+
+/** @param {unknown} input @returns {Record<string, any>} */
+function launcherLabels(input) {
+  const labels = input && typeof input === 'object' ? input : {};
+  return {
+    applications: String(labels.applications ?? 'Applications'),
+    recent: String(labels.recent ?? 'Recent'),
+    results: String(labels.results ?? 'Top results'),
+    entities: labels.entities && typeof labels.entities === 'object' ? labels.entities : {},
+    move: String(labels.move ?? 'Move'),
+    open: String(labels.open ?? 'Open'),
+    close: String(labels.close ?? 'Close')
+  };
+}

package/src/zeyos/modules.js

@@ -109,6 +109,7 @@ export const zeyosModules = Object.freeze({
  * @type {Readonly<Record<string, string>>}
  */
 export const moduleAliases = Object.freeze({
+  main: 'zeyos',
   addresses: 'contacts',
   clocking: 'actionsteps',
   comments: 'notes',

package/src/zeyos/select.js

@@ -1,5 +1,6 @@
-import { Select } from '../index.js';
+import { Select, h, icon } from '../index.js';
 import { connect } from './connect.js';
+import { moduleChip } from './icons.js';
 import { buildListQuery } from './query.js';
 
 /**
@@ -93,6 +94,105 @@ export function zeyosSelect(client, resource, opts = {}) {
   return select;
 }
 
+/**
+ * Builds the rich, resource-specific Entity-box preset over the generic injected Select binding.
+ * It adds module-colored icons, optional subtitles/groups, a fixed clear row, and an optional
+ * application-owned create command without changing the selected ID contract.
+ * @param {Record<string, any>} client Injected ZeyOS client instance.
+ * @param {string} resource Resource such as `projects` or `accounts`.
+ * @param {ZeyosSelectOptions & {
+ *   subtitleKey?: string|((item: Record<string, unknown>) => unknown)|null,
+ *   moduleKey?: string|((item: Record<string, unknown>) => unknown),
+ *   none?: boolean|string,
+ *   create?: boolean|{id?: string|number, label?: string, group?: string, icon?: string|Node, oninvoke?: Function},
+ *   renderIcon?: ((item: Record<string, unknown>, context: Record<string, unknown>) => Node|null)|null
+ * }} [opts={}] Entity presentation, query, and Select options.
+ * @returns {Record<string, any>} Plain Select options.
+ */
+export function buildZeyosEntitySelectConfig(client, resource, opts = {}) {
+  const {
+    fields,
+    labelKey = inferLabelKey(client, resource),
+    valueKey = 'ID',
+    searchFields = inferSearchFields(client, resource),
+    subtitleKey = null,
+    moduleKey = () => resource,
+    groupKey = null,
+    none = true,
+    create = false,
+    renderIcon = defaultEntityIcon,
+    renderItem,
+    renderValueAdornment,
+    ...rest
+  } = opts;
+  const projection = fields ?? defaultProjection(valueKey, labelKey, [
+    ...searchFields,
+    ...[subtitleKey, moduleKey, groupKey].filter((reader) => typeof reader === 'string')
+  ]);
+  const base = buildZeyosSelectConfig(client, resource, {
+    ...rest,
+    fields: projection,
+    labelKey,
+    valueKey,
+    searchFields,
+    groupKey,
+    clearable: none === false ? Boolean(rest.clearable) : true
+  });
+  const renderModuleIcon = (item, selected = false) => {
+    if (renderIcon === null) return null;
+    const module = readRecord(item, moduleKey) ?? resource;
+    return renderIcon(item, { resource, module: String(module), selected });
+  };
+  base.renderItem = renderItem ?? ((item) => {
+    const visual = renderModuleIcon(item);
+    return h('span', { class: 'zx-select__entity' },
+      visual ? h('span', {
+        class: 'zx-select__entity-icon',
+        ariaHidden: 'true'
+      }, visual) : null,
+      h('span', { class: 'zx-select__entity-copy' },
+        h('span', { class: 'zx-select__entity-label' }, String(readRecord(item, labelKey) ?? '')),
+        subtitleKey && readRecord(item, subtitleKey) != null
+          ? h('span', { class: 'zx-select__entity-subtitle' }, String(readRecord(item, subtitleKey)))
+          : null));
+  });
+  base.renderValueAdornment = renderValueAdornment ?? ((item) => renderModuleIcon(item, true));
+  if (none !== false) {
+    base.noneLabel = typeof none === 'string' ? none : rest.noneLabel ?? 'No selection';
+    base.renderNone = rest.renderNone ?? ((label) => h('span', { class: 'zx-select__entity-none' },
+      h('span', { class: 'zx-select__entity-none-icon', ariaHidden: 'true' }),
+      h('span', {}, label)));
+  }
+  if (create) {
+    const descriptor = create === true ? {} : create;
+    const invoke = typeof descriptor.oninvoke === 'function' ? descriptor.oninvoke : null;
+    base.actions = [...(Array.isArray(base.actions) ? base.actions : []), {
+      id: descriptor.id ?? 'create',
+      label: descriptor.label ?? 'Create new…',
+      group: descriptor.group ?? 'New',
+      icon: descriptor.icon ?? 'plus',
+      invoke: (detail) => invoke?.({ ...detail, resource })
+    }];
+  }
+  return base;
+}
+
+/**
+ * Creates a ZeyOS Entity-box preset. Await `select.ready` when a non-null initial ID must be
+ * hydrated before presentation.
+ * @param {Record<string, any>} client Injected ZeyOS client instance.
+ * @param {string} resource Resource name.
+ * @param {Record<string, any>} [opts={}] Entity Select options.
+ * @returns {Select & {ready: Promise<Select>}}
+ */
+export function zeyosEntitySelect(client, resource, opts = {}) {
+  const config = buildZeyosEntitySelectConfig(client, resource, opts);
+  const requestedValue = opts.value ?? null;
+  const select = /** @type {Select & {ready: Promise<Select>}} */ (new Select(null, config));
+  select.ready = hydrateInitialValue(select, client, resource, requestedValue);
+  return select;
+}
+
 /**
  * Normalizes list output without importing the client package. If the injected client exposes its
  * own `normalizeListResult`, that implementation wins; otherwise arrays and `.data` are handled
@@ -139,6 +239,20 @@ function normalizeRecord(result) {
   throw new TypeError('ZeyOS get operation did not return a record');
 }
 
+/** @param {Record<string, unknown>} item @param {unknown} reader @returns {unknown} */
+function readRecord(item, reader) {
+  if (typeof reader === 'function') return reader(item);
+  if (item && typeof item === 'object' && typeof reader === 'string') return item[reader];
+  return null;
+}
+
+/** Dependency-free module-color example; exact product glyphs remain host-injectable. @param {Record<string, unknown>} _item @param {{module?: unknown}} context @returns {Node} */
+function defaultEntityIcon(_item, context) {
+  const chip = moduleChip(String(context.module ?? 'default'), { size: 20 });
+  chip.replaceChildren(icon('square', { size: 10 }));
+  return chip;
+}
+
 /** @param {unknown} valueKey @param {unknown} labelKey @param {string[]} searchFields @returns {string[]|undefined} */
 function defaultProjection(valueKey, labelKey, searchFields) {
   const keys = [valueKey, labelKey, ...searchFields].filter((key) => typeof key === 'string' && key);

package/styles/tokens/dark.css

@@ -1,7 +1,6 @@
 /*
- * Tier-2 semantic tokens — dark theme, from the shadcn/ui preset `b2BVl11e4` (Zinc):
- * Zinc-950 page, Zinc-900 cards and popovers, Zinc-800 muted fills, translucent white borders
- * (10%) and inputs (15%), Zinc-400 muted text.
+ * Tier-2 semantic tokens — dark theme: a near-black page, raised neutral surfaces, muted fills,
+ * translucent white borders (10%) and inputs (15%), and restrained secondary text.
  *
  * The accent roles take the light end of the `--zx-accent-*` ramp (300/400/500) where the light
  * theme takes the dark end, so a preset that repoints the ramp lands correctly in both.

package/styles/tokens/global.css

@@ -1,15 +1,15 @@
 /*
  * Tier-1 palette and primitives.
  *
- * Derived from the shadcn/ui preset `b2BVl11e4` (style Nova · base colour Zinc · theme Zinc ·
- * chart colour Emerald · Inter · radius small). The neutral ramp is Tailwind Zinc; the accent
- * ramp is the preset's Emerald chart ramp, anchored at 400 to the ZeyOS brand green #21cc75.
+ * The neutral ramp uses Zinc-like values; the accent ramp uses an emerald progression anchored at
+ * 400 to the ZeyOS brand green #21cc75. Inter and a compact radius scale support dense business
+ * interfaces without coupling the token contract to another UI toolkit.
  *
  * Only tier-2 semantic tokens (tokens/semantic.css, tokens/dark.css) may reference these.
  * Component CSS must never use them directly — tests/lint-tokens.js enforces that.
  */
 :root {
-  /* Neutrals — Tailwind Zinc */
+  /* Neutrals */
   --zx-gray-0: #ffffff;
   --zx-gray-50: #fafafa;
   --zx-gray-100: #f4f4f5;
@@ -24,7 +24,7 @@
   --zx-gray-900: #18181b;
   --zx-gray-950: #09090b;
 
-  /* Accent — the preset's Emerald chart ramp, with the ZeyOS brand green at 400 */
+  /* Accent — an emerald ramp with the ZeyOS brand green at 400 */
   --zx-green-300: #5ee9b5;
   --zx-green-400: #21cc75;
   --zx-green-500: #009966;
@@ -63,7 +63,7 @@
   --zx-space-7: 32px;
   --zx-space-8: 40px;
 
-  /* Radius — the preset's `--radius: 0.45rem`, with shadcn's derived steps */
+  /* Radius — a 0.45rem base with compact derived steps */
   --zx-radius: 0.45rem;
   --zx-radius-sm: calc(var(--zx-radius) - 4px);
   --zx-radius-md: calc(var(--zx-radius) - 2px);

package/styles/tokens/modules.css

@@ -89,6 +89,7 @@
   --zx-module-linecoupon: var(--zx-module-line);
   --zx-module-logins: var(--zx-module-auth);
   --zx-module-mailservers: var(--zx-module-channels);
+  --zx-module-main: var(--zx-module-zeyos);
   --zx-module-notifications: var(--zx-module-messages);
   --zx-module-participants-campaigns: var(--zx-module-participants);
   --zx-module-participants-mailinglists: var(--zx-module-participants);

package/styles/tokens/semantic.css

@@ -1,9 +1,9 @@
 /*
  * Tier-2 semantic tokens — light theme (the default).
  *
- * The mapping follows the shadcn/ui preset `b2BVl11e4`: white surfaces, Zinc-100 hover/muted
- * fills, Zinc-200 borders and inputs, Zinc-500 muted text, Zinc-950 body text, and the Nova
- * control geometry (32px controls, `--radius` corners, a 3px translucent focus ring).
+ * The mapping uses white surfaces, restrained neutral hover/muted fills, quiet borders and inputs,
+ * strong body text, and compact control geometry (32px controls, `--radius` corners, a 3px
+ * translucent focus ring).
  *
  * The accent roles read `--zx-accent-*` rather than the green ramp directly, which is what lets
  * `tokens/themes.css` retheme them. Status colours keep their own ramps on purpose — see the note
@@ -48,6 +48,8 @@
   --zx-control-font-size: var(--zx-text-md);
   --zx-control-font-weight: 500;
   --zx-overlay-shadow: var(--zx-shadow-3);
+  /* Blur applied behind a backdrop that asked for it. Theme-independent, so light defines it once. */
+  --zx-overlay-blur: 8px;
   --zx-header-bg: var(--zx-gray-900);
   --zx-header-text: var(--zx-gray-50);
 }

package/styles/tokens/themes.css

@@ -17,7 +17,7 @@
  * against the dark page, which is what keeps `--zx-color-on-accent` correct in both polarities.
  */
 
-/* Zx — the ZeyOS brand green on the shadcn Emerald ramp. The default. */
+/* Zx — the ZeyOS brand green on Xenon's emerald ramp. The default. */
 [data-zx-preset="zx"] {
   --zx-accent-300: #5ee9b5;
   --zx-accent-400: #21cc75;

package/styles/zx.css

@@ -21,17 +21,25 @@
 @import url("../src/components/toolbar/toolbar.css");
 @import url("../src/components/toggle/toggle.css");
 @import url("../src/components/groupbox/groupbox.css");
+@import url("../src/components/card/card.css");
 @import url("../src/components/panel/panel.css");
 @import url("../src/components/master-panel/master-panel.css");
 @import url("../src/components/tabbox/tabbox.css");
 @import url("../src/components/navigation-bar/navigation-bar.css");
 @import url("../src/components/search/search.css");
+@import url("../src/components/launcher/launcher.css");
+@import url("../src/components/avatar/avatar.css");
+@import url("../src/components/account-menu/account-menu.css");
+@import url("../src/components/app-rail/app-rail.css");
+@import url("../src/components/app-sidebar/app-sidebar.css");
 @import url("../src/components/message/message.css");
 @import url("../src/components/modal/modal.css");
 @import url("../src/components/dialog/dialog.css");
+@import url("../src/components/sheet/sheet.css");
 @import url("../src/components/dropdown/dropdown.css");
 @import url("../src/components/tooltip/tooltip.css");
 @import url("../src/components/split-view/split-view.css");
+@import url("../src/components/dock/dock.css");
 @import url("../src/components/menu-button/menu-button.css");
 @import url("../src/components/context-menu/context-menu.css");
 @import url("../src/components/select/select.css");
@@ -40,7 +48,6 @@
 @import url("../src/components/number-field/number-field.css");
 @import url("../src/components/slider/slider.css");
 @import url("../src/components/rating/rating.css");
-@import url("../src/components/permission/permission.css");
 @import url("../src/components/date-picker/date-picker.css");
 @import url("../src/components/date-picker/time-picker.css");
 @import url("../src/components/datebox/datebox.css");
@@ -48,6 +55,8 @@
 @import url("../src/components/datebox/date-range-box.css");
 @import url("../src/components/timebox/timebox.css");
 @import url("../src/components/table/table.css");
+@import url("../src/components/grid/grid.css");
+@import url("../src/components/chart/chart.css");
 @import url("../src/components/tree/tree.css");
 @import url("../src/components/finder/finder.css");
 @import url("../src/components/data-filter/data-filter.css");
@@ -60,3 +69,4 @@
 @import url("../src/components/value-list/value-list.css");
 @import url("../src/components/multi-value-editor/multi-value-editor.css");
 @import url("../src/components/field-upload/field-upload.css");
+@import url("../src/components/questionnaire/questionnaire.css");