@dataengineeringformachinelearning/viking-ui 1.0.2 → 3.0.0-alpha.2

package/src/web/card/viking-card-wc.ts

@@ -0,0 +1,66 @@
+import {
+  defineCustomElement,
+  defineCustomElementAlias,
+  HTMLElementBase,
+} from "../core/dom";
+
+/**
+ * Framework-agnostic Viking card Web Component (light DOM — inherits global viking-card CSS).
+ * Tag: `viking-card` (legacy alias: `viking-card-wc`)
+ *
+ * Uses light DOM so slotted content inherits `viking-card`, `viking-card-header`, and related
+ * classes from the synced static CSS bundle.
+ *
+ * @attr compact - Applies `viking-card-compact` padding
+ * @attr interactive - Hover lift for clickable cards
+ * @attr title - Accessible name when the card is a landmark region
+ *
+ * @example
+ * <viking-card-wc compact title="Event throughput">
+ *   <div class="viking-card-header">
+ *     <h3 class="viking-heading viking-heading-sm">Event throughput</h3>
+ *   </div>
+ *   <p class="viking-text-muted">8.2K events/sec</p>
+ * </viking-card-wc>
+ */
+export class VikingCardWc extends HTMLElementBase {
+  static readonly tag = "viking-card";
+  static readonly legacyTag = "viking-card-wc";
+
+  static get observedAttributes(): string[] {
+    return ["compact", "interactive", "title"];
+  }
+
+  connectedCallback(): void {
+    this.syncClasses();
+  }
+
+  attributeChangedCallback(): void {
+    if (this.isConnected) {
+      this.syncClasses();
+    }
+  }
+
+  private syncClasses(): void {
+    this.classList.add("viking-card");
+    this.classList.toggle("viking-card-compact", this.hasAttribute("compact"));
+    this.classList.toggle(
+      "viking-card-interactive",
+      this.hasAttribute("interactive"),
+    );
+
+    const title = this.getAttribute("title");
+    if (title) {
+      this.setAttribute("role", "region");
+      this.setAttribute("aria-label", title);
+    } else {
+      this.removeAttribute("role");
+      this.removeAttribute("aria-label");
+    }
+  }
+}
+
+export const registerVikingCardWc = (): void => {
+  defineCustomElement(VikingCardWc.tag, VikingCardWc);
+  defineCustomElementAlias(VikingCardWc.legacyTag, VikingCardWc);
+};

package/src/web/core/base.ts

@@ -0,0 +1,56 @@
+/** Attaches constructable stylesheet to a shadow root (with fallback). */
+export const attachShadowStyles = (shadow: ShadowRoot, css: string): void => {
+  if (
+    "adoptedStyleSheets" in Document.prototype &&
+    "replaceSync" in CSSStyleSheet.prototype
+  ) {
+    const sheet = new CSSStyleSheet();
+    sheet.replaceSync(css);
+    shadow.adoptedStyleSheets = [sheet];
+    return;
+  }
+
+  const style = document.createElement("style");
+  style.textContent = css;
+  shadow.append(style);
+};
+
+/** Reads a boolean attribute presence/value. */
+export const readBoolAttr = (el: HTMLElement, name: string): boolean =>
+  el.hasAttribute(name) && el.getAttribute(name) !== "false";
+
+/** Safely sets form value when ElementInternals is fully supported (e.g. not in jsdom). */
+export const setFormValue = (
+  internals: ElementInternals | null,
+  value: string,
+): void => {
+  if (internals && typeof internals.setFormValue === "function") {
+    internals.setFormValue(value);
+  }
+};
+
+/** Attaches ElementInternals where available without breaking older WebKit or test DOMs. */
+export const attachElementInternals = (
+  el: HTMLElement,
+): ElementInternals | null => {
+  const attachInternals = (
+    el as HTMLElement & { attachInternals?: () => ElementInternals }
+  ).attachInternals;
+  return typeof attachInternals === "function"
+    ? attachInternals.call(el)
+    : null;
+};
+
+/** Opens a native dialog when showModal is available. */
+export const showModalDialog = (dialog: HTMLDialogElement | null): void => {
+  if (dialog && typeof dialog.showModal === "function" && !dialog.open) {
+    dialog.showModal();
+  }
+};
+
+/** Closes a native dialog when close is available. */
+export const closeModalDialog = (dialog: HTMLDialogElement | null): void => {
+  if (dialog && typeof dialog.close === "function" && dialog.open) {
+    dialog.close();
+  }
+};

package/src/web/core/dom.ts

@@ -0,0 +1,53 @@
+export const HTMLElementBase: typeof HTMLElement =
+  typeof HTMLElement === "undefined"
+    ? (class {} as unknown as typeof HTMLElement)
+    : HTMLElement;
+
+/** Stable unique id for associating labels and controls. */
+export const vikingWcUid = (prefix: string): string =>
+  `${prefix}-${Math.random().toString(36).slice(2, 9)}`;
+
+/** Escape text for safe innerHTML insertion. */
+export const escapeHtml = (value: string): string => {
+  const entities: Record<string, string> = {
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+  };
+
+  return value.replace(
+    /[&<>"']/g,
+    (character) => entities[character] ?? character,
+  );
+};
+
+/** Platform modifier label for keyboard shortcut hints. */
+export const modKeyLabel = (): string =>
+  typeof navigator !== "undefined" &&
+  /Mac|iPhone|iPad/i.test(navigator.platform)
+    ? "⌘"
+    : "Ctrl";
+
+/** Register a custom element when the runtime supports it (skip during SSR/prerender). */
+export const defineCustomElement = (
+  tag: string,
+  ctor: CustomElementConstructor,
+): void => {
+  if (typeof customElements === "undefined" || customElements.get(tag)) {
+    return;
+  }
+  customElements.define(tag, ctor);
+};
+
+/** Register an alias tag with a fresh subclass; customElements disallows reusing constructors. */
+export const defineCustomElementAlias = <T extends CustomElementConstructor>(
+  tag: string,
+  ctor: T,
+): void => {
+  if (typeof customElements === "undefined" || customElements.get(tag)) {
+    return;
+  }
+  customElements.define(tag, class extends ctor {});
+};

package/src/web/core/icons-inline.ts

@@ -0,0 +1,44 @@
+import {
+  resolveVikingIcon,
+  VIKING_FILLED_ICON_NAMES,
+  VIKING_ICON_FILLED_PATHS,
+  VIKING_ICON_PATHS,
+  type VikingIconName,
+} from "../../lib/core/icons";
+
+const FILLED_ICON_SET = new Set<string>(VIKING_FILLED_ICON_NAMES);
+
+/**
+ * Renders a zero-dependency inline SVG icon for Web Components.
+ * Uses the same registry as `viking-icon` in Angular.
+ */
+export const renderInlineIcon = (
+  name: string,
+  size = 16,
+  className = "viking-wc-icon",
+): string => {
+  const resolved = resolveVikingIcon(name);
+  const filled = FILLED_ICON_SET.has(resolved);
+  const paths = filled
+    ? (VIKING_ICON_FILLED_PATHS[resolved as VikingIconName] ??
+      VIKING_ICON_PATHS[resolved])
+    : VIKING_ICON_PATHS[resolved];
+
+  if (filled) {
+    return `<svg class="${className}" width="${size}" height="${size}" viewBox="0 0 24 24" fill="currentColor" fill-rule="evenodd" aria-hidden="true">${paths}</svg>`;
+  }
+
+  return `<svg class="${className}" width="${size}" height="${size}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${paths}</svg>`;
+};
+
+/** Default tone → icon mapping shared by callout and badge surfaces. */
+export const TONE_ICON_NAMES: Record<string, string> = {
+  accent: "info",
+  secondary: "info",
+  success: "check-circle",
+  warning: "alert-triangle",
+  danger: "alert-circle",
+  info: "info",
+  muted: "info",
+  subtle: "info",
+};