@m4l/gclick 0.28.0 → 0.29.0

package/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/gclick/src/helpers/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC;AAMpC,cAAc,uBAAuB,CAAC"}

package/helpers/resolveDeviceIcon/constants.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Prefix of the device icon id the devices endpoint publishes
+ * (`i_common_devices_type_sedan`). What follows it is the vehicle type.
+ */
+export declare const DEVICE_BACKEND_ICON_PREFIX = "i_common_devices_type_";
+/**
+ * Prefix of the 3D device illustrations in the `@m4l/icons` SVG registry
+ * (`device_sedan_3d_white`), shared by every vehicle type.
+ */
+export declare const DEVICE_ICON_ID_PREFIX = "device_";
+/**
+ * Variant of the 3D device illustration painted on the web. Together with
+ * `DEVICE_ICON_ID_PREFIX` it turns a vehicle type into the registry id of its
+ * artwork. The registry is read as it ships: web resolution does not go through
+ * the `_3d_white` entries of `backendIconAliases.json`.
+ */
+export declare const DEVICE_ICON_VARIANT_SUFFIX = "_3d_white";
+/**
+ * Used for devices that arrive with no icon id, and for vehicle types without a
+ * 3D illustration the web paints. One artwork covers every such device, and it
+ * renders through the same `Image` as the rest of the fleet. The illustration
+ * itself is `DEVICE_FALLBACK_ICON_COMPONENT`.
+ */
+export declare const DEVICE_FALLBACK_ICON_ID = "i_common_devices_type_heavy_truck";
+/**
+ * Side of the square the artwork is painted in. Every device surface uses the
+ * same size, so it lives with the contract instead of being redeclared by each
+ * component.
+ */
+export declare const DEVICE_ICON_SIZE = 31;
+//# sourceMappingURL=constants.d.ts.map

package/helpers/resolveDeviceIcon/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/helpers/resolveDeviceIcon/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,cAAc,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sCAAsC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAC"}

package/helpers/resolveDeviceIcon/constants.js

@@ -0,0 +1,8 @@
+const _ = "i_common_devices_type_", I = "device_", E = "_3d_white", C = "i_common_devices_type_heavy_truck", c = 31;
+export {
+  _ as DEVICE_BACKEND_ICON_PREFIX,
+  C as DEVICE_FALLBACK_ICON_ID,
+  I as DEVICE_ICON_ID_PREFIX,
+  c as DEVICE_ICON_SIZE,
+  E as DEVICE_ICON_VARIANT_SUFFIX
+};

package/helpers/resolveDeviceIcon/deviceIconComponents.d.ts

@@ -0,0 +1,19 @@
+import { DeviceSedan3dWhite } from '@m4l/icons';
+/**
+ * Component type of the 3D device illustrations exported by `@m4l/icons`.
+ */
+export type DeviceIconComponent = typeof DeviceSedan3dWhite;
+/**
+ * Illustration painted for a device with no icon id, or whose vehicle type has
+ * no illustration the web paints. It is the artwork `DEVICE_FALLBACK_ICON_ID`
+ * names: the heavy truck.
+ */
+export declare const DEVICE_FALLBACK_ICON_COMPONENT: DeviceIconComponent;
+/**
+ * Web counterpart of the registry's `getIconComponentByName` for the 3D device
+ * illustrations: resolves the React component of a registry icon name without
+ * going through the registry's asset urls, or `undefined` when that name is not
+ * a device illustration the web paints.
+ */
+export declare function getDeviceIconComponentByName(name: string): DeviceIconComponent | undefined;
+//# sourceMappingURL=deviceIconComponents.d.ts.map

package/helpers/resolveDeviceIcon/deviceIconComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceIconComponents.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/helpers/resolveDeviceIcon/deviceIconComponents.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,kBAAkB,EAInB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,kBAAkB,CAAC;AAuB5D;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,mBACpB,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX,mBAAmB,GAAG,SAAS,CAIjC"}

package/helpers/resolveDeviceIcon/deviceIconComponents.js

@@ -0,0 +1,19 @@
+import { DeviceHeavyTruck3dWhite as e, DeviceVan3dWhite as c, DeviceTruckTractor3dWhite as t, DeviceTaxi3dWhite as o, DeviceSedan3dWhite as r, DeviceMotorcycle3dWhite as v, DeviceLightTruck3dWhite as D, DeviceBackhoe3dWhite as h, DeviceAvatar3dWhite as d } from "@m4l/icons";
+const n = {
+  DeviceAvatar3dWhite: d,
+  DeviceBackhoe3dWhite: h,
+  DeviceHeavyTruck3dWhite: e,
+  DeviceLightTruck3dWhite: D,
+  DeviceMotorcycle3dWhite: v,
+  DeviceSedan3dWhite: r,
+  DeviceTaxi3dWhite: o,
+  DeviceTruckTractor3dWhite: t,
+  DeviceVan3dWhite: c
+}, W = e;
+function C(i) {
+  return n[i];
+}
+export {
+  W as DEVICE_FALLBACK_ICON_COMPONENT,
+  C as getDeviceIconComponentByName
+};

package/helpers/resolveDeviceIcon/index.d.ts

@@ -0,0 +1,3 @@
+export { resolveDeviceIcon, resolveDeviceIconSrc } from './resolveDeviceIcon';
+export { DEVICE_FALLBACK_ICON_ID, DEVICE_ICON_SIZE, DEVICE_ICON_VARIANT_SUFFIX, } from './constants';
+//# sourceMappingURL=index.d.ts.map

package/helpers/resolveDeviceIcon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/helpers/resolveDeviceIcon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/helpers/resolveDeviceIcon/resolveDeviceIcon.d.ts

@@ -0,0 +1,28 @@
+import { ReactElement } from 'react';
+/**
+ * Resolve the source of a device artwork as an inline `data:` svg url, using
+ * the backend id published in `deviceIcon.iconId`.
+ *
+ * Meant for surfaces that need a text source, such as a datagrid image column.
+ * Surfaces that paint the artwork use `resolveDeviceIcon` instead.
+ *
+ * The illustration component is serialized to markup, so no file is emitted for
+ * it and the bundle carries no `new URL(asset, import.meta.url)` for device
+ * artwork.
+ */
+export declare function resolveDeviceIconSrc(iconId?: string | null): string;
+/**
+ * Resolve the artwork of a device, ready to render.
+ *
+ * This is the single place that owns the device-icon contract: the illustration
+ * set, the fallback and the size the artwork is painted in. Every surface that
+ * paints a device — pickers, cards, lists, map markers — must resolve through
+ * here, so a change to the contract is one edit and never a hunt across
+ * components.
+ *
+ * A vehicle type shows its own artwork once its `device_<type>_3d_white`
+ * component is listed in `deviceIconComponents.ts`; until then it paints the
+ * device fallback.
+ */
+export declare function resolveDeviceIcon(iconId?: string | null, size?: number): ReactElement;
+//# sourceMappingURL=resolveDeviceIcon.d.ts.map

package/helpers/resolveDeviceIcon/resolveDeviceIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDeviceIcon.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/helpers/resolveDeviceIcon/resolveDeviceIcon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,OAAO,CAAC;AAgEpD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAenE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,IAAI,GAAE,MAAyB,GAC9B,YAAY,CASd"}

package/helpers/resolveDeviceIcon/resolveDeviceIcon.js

@@ -0,0 +1,42 @@
+import { createElement as s } from "react";
+import { s as i } from "../../_virtual/server.browser.js";
+import { getIconNameById as m } from "@m4l/icons/svg-registry";
+import { Image as I } from "@m4l/components";
+import { DEVICE_ICON_SIZE as C, DEVICE_BACKEND_ICON_PREFIX as n, DEVICE_ICON_ID_PREFIX as a, DEVICE_ICON_VARIANT_SUFFIX as E } from "./constants.js";
+import { DEVICE_FALLBACK_ICON_COMPONENT as p, getDeviceIconComponentByName as _ } from "./deviceIconComponents.js";
+const c = /* @__PURE__ */ new WeakMap();
+function f(t) {
+  const e = t.startsWith(n) ? t.slice(n.length) : t;
+  return _(
+    m(
+      `${a}${e}${E}`
+    )
+  );
+}
+function l(t) {
+  const e = t?.trim();
+  return (e ? f(e) : void 0) ?? p;
+}
+function u(t) {
+  const e = l(t), r = c.get(e);
+  if (r)
+    return r;
+  const o = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(
+    i.renderToStaticMarkup(s(e))
+  )}`;
+  return c.set(e, o), o;
+}
+function d(t, e = C) {
+  return s(I, {
+    src: u(t),
+    width: e,
+    height: e,
+    // The row is virtualized and only mounts while visible, so deferring the
+    // request again would leave the slot blank on every scroll.
+    enableIntersectionObserver: !1
+  });
+}
+export {
+  d as resolveDeviceIcon,
+  u as resolveDeviceIconSrc
+};

package/helpers/resolveDeviceLabels/index.d.ts

@@ -0,0 +1,3 @@
+export { resolveDeviceTitle, resolveDeviceSubtitle } from './resolveDeviceLabels';
+export type { DeviceLabelsSource } from './types';
+//# sourceMappingURL=index.d.ts.map

package/helpers/resolveDeviceLabels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/helpers/resolveDeviceLabels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAClF,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/helpers/resolveDeviceLabels/resolveDeviceLabels.d.ts

@@ -0,0 +1,22 @@
+import { DeviceLabelsSource } from './types';
+/**
+ * Resolve the first line of a device: the alias, or the name when the device
+ * carries no alias.
+ *
+ * This is the single place that owns the device label contract. The alias is
+ * what identifies a vehicle for the people using the platform, so it always
+ * wins the prominent line; the name takes it only when there is no alias, and
+ * moves to the description line otherwise.
+ *
+ * Every surface that paints a device — picker cards, panel rows, selected
+ * lists, filter chips — must resolve through here, so the same device never
+ * reads one way in a module and another way in a shared component.
+ */
+export declare function resolveDeviceTitle(device?: DeviceLabelsSource | null): string;
+/**
+ * Resolve the second line of a device: the name, once the alias took the first
+ * line. Empty when there is no alias, because the name is already on top and
+ * repeating it would paint the same text twice.
+ */
+export declare function resolveDeviceSubtitle(device?: DeviceLabelsSource | null): string;
+//# sourceMappingURL=resolveDeviceLabels.d.ts.map

package/helpers/resolveDeviceLabels/resolveDeviceLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDeviceLabels.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/helpers/resolveDeviceLabels/resolveDeviceLabels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAEhF"}

package/helpers/resolveDeviceLabels/resolveDeviceLabels.js

@@ -0,0 +1,10 @@
+function e(t) {
+  return t?.alias?.trim() || t?.name?.trim() || "";
+}
+function r(t) {
+  return t?.alias?.trim() ? t?.name?.trim() ?? "" : "";
+}
+export {
+  r as resolveDeviceSubtitle,
+  e as resolveDeviceTitle
+};

package/helpers/resolveDeviceLabels/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Minimal shape the device label contract needs from a device.
+ *
+ * Declared here instead of imported from a component so any surface that paints
+ * a device — pickers, cards, lists, map markers, filter chips — can resolve its
+ * labels without depending on the picker.
+ */
+export interface DeviceLabelsSource {
+    /**
+     * Plate or hardware code the device was registered with, as published by
+     * the backend.
+     */
+    name?: string | null;
+    /**
+     * Label the fleet gave the device. When present it owns the first line.
+     */
+    alias?: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/helpers/resolveDeviceLabels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/helpers/resolveDeviceLabels/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from './components';
 export * from './formatters';
+export * from './helpers';
 export * from './reports';
 export * from './utils';
 export * from './@types/types.d';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/gclick/src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AAExB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/gclick/src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AAExB,cAAc,kBAAkB,CAAC"}