@flanksource/clicky-ui 0.2.14 → 0.2.15

package/dist/data/cells/tag-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-utils.cjs","sources":["../../../src/data/cells/tag-utils.ts"],"sourcesContent":["import { createContext, useContext, useMemo } from \"react\";\nimport type { FilterMode } from \"../FilterPill\";\n\nexport type TagInput = string | { key: string; value: string } | { name: string; value: string };\n\nexport type NormalizedTag = {\n  key?: string;\n  value: string;\n  display: string;\n  token: string;\n};\n\nexport type TagsValue =\n  | TagInput[]\n  | Record<string, string | number | boolean | null>\n  | null\n  | undefined;\n\nexport type TagsOptions = {\n  /** Number of tags to show inline before using the `+N` overflow popover. */\n  maxVisible?: number;\n  /** Separator between tag keys and values. Defaults to `=`. */\n  separator?: string;\n};\n\nexport function normalizeTags(value: TagsValue, separator = \"=\"): NormalizedTag[] {\n  if (value == null) return [];\n\n  if (Array.isArray(value)) {\n    return value.map((entry) => normalizeOne(entry, separator)).filter((tag) => tag.value !== \"\");\n  }\n\n  if (typeof value === \"object\") {\n    return Object.entries(value)\n      .map(([key, raw]): NormalizedTag | null => {\n        if (raw == null) return null;\n        const valueStr = String(raw).trim();\n        if (!valueStr) return null;\n        return {\n          key,\n          value: valueStr,\n          display: `${key}${separator}${valueStr}`,\n          token: `${key}${separator}${valueStr}`,\n        } satisfies NormalizedTag;\n      })\n      .filter((tag): tag is NormalizedTag => tag !== null);\n  }\n\n  return [];\n}\n\nfunction normalizeOne(entry: TagInput, separator: string): NormalizedTag {\n  if (typeof entry === \"string\") {\n    const trimmed = entry.trim();\n    const eq = trimmed.indexOf(\"=\");\n    const colon = trimmed.indexOf(\":\");\n    const splitAt =\n      eq >= 0 && (colon < 0 || eq < colon)\n        ? eq\n        : colon >= 0 && colon < trimmed.length - 1\n          ? colon\n          : -1;\n\n    if (splitAt > 0) {\n      const key = trimmed.slice(0, splitAt);\n      const value = trimmed.slice(splitAt + 1);\n      return {\n        key,\n        value,\n        display: `${key}${separator}${value}`,\n        token: `${key}${separator}${value}`,\n      };\n    }\n\n    return { value: trimmed, display: trimmed, token: trimmed };\n  }\n\n  const key =\n    \"key\" in entry && typeof entry.key === \"string\"\n      ? entry.key\n      : \"name\" in entry && typeof entry.name === \"string\"\n        ? entry.name\n        : undefined;\n  const value = String(entry.value ?? \"\").trim();\n\n  if (key) {\n    return {\n      key,\n      value,\n      display: `${key}${separator}${value}`,\n      token: `${key}${separator}${value}`,\n    };\n  }\n  return { value, display: value, token: value };\n}\n\nexport function tagFilterTokens(value: TagsValue, separator = \"=\"): string[] {\n  return normalizeTags(value, separator).map((tag) => tag.token);\n}\n\n/**\n * Splits a token previously produced by `normalizeTags`/`tagFilterTokens`\n * back into its key and value parts using the same separator. Tokens\n * without a separator (bare tags) return `{ key: \"\", value: token }`.\n */\nexport function splitTagToken(token: string, separator = \"=\"): { key: string; value: string } {\n  const idx = token.indexOf(separator);\n  if (idx <= 0) return { key: \"\", value: token };\n  return {\n    key: token.slice(0, idx),\n    value: token.slice(idx + separator.length),\n  };\n}\n\n// Filter mode mapping (re-using FilterPill's tri-state vocabulary so the wire\n// shape matches DataTable's existing multiFilters state).\nexport type TagFilterMode = Extract<FilterMode, \"include\" | \"exclude\">;\n\nexport type TagActionsContextValue = {\n  /** Returns the current mode for a token; \"neutral\" if the user hasn't acted on it. */\n  getMode: (token: string) => FilterMode;\n  /** Toggle include for this token (off → include → off). */\n  toggleInclude: (token: string) => void;\n  /** Toggle exclude for this token (off → exclude → off). */\n  toggleExclude: (token: string) => void;\n};\n\nconst noop: TagActionsContextValue = {\n  getMode: () => \"neutral\",\n  toggleInclude: () => {},\n  toggleExclude: () => {},\n};\n\nexport const TagActionsContext = createContext<TagActionsContextValue>(noop);\n\nexport function useTagActions(): TagActionsContextValue {\n  return useContext(TagActionsContext);\n}\n\n/**\n * Builds a TagActionsContextValue from a flat record-of-modes (the same\n * shape used by FilterBar's multi/nested-multi filters). Useful when\n * connecting DataTable's multiFilters state to the in-cell + / − buttons.\n */\nexport function tagActionsFromRecord(\n  value: Record<string, TagFilterMode>,\n  onChange: (next: Record<string, TagFilterMode>) => void,\n): TagActionsContextValue {\n  return {\n    getMode: (token) => value[token] ?? \"neutral\",\n    toggleInclude: (token) => {\n      const next = { ...value };\n      if (next[token] === \"include\") delete next[token];\n      else next[token] = \"include\";\n      onChange(next);\n    },\n    toggleExclude: (token) => {\n      const next = { ...value };\n      if (next[token] === \"exclude\") delete next[token];\n      else next[token] = \"exclude\";\n      onChange(next);\n    },\n  };\n}\n\n// Memoizing the context value avoids re-rendering every TagList cell on\n// unrelated state changes.\nexport function useTagActionsValue(\n  value: Record<string, TagFilterMode>,\n  onChange: (next: Record<string, TagFilterMode>) => void,\n): TagActionsContextValue {\n  return useMemo(() => tagActionsFromRecord(value, onChange), [value, onChange]);\n}\n"],"names":["key","value","createContext","useContext","useMemo"],"mappings":";;;AAyBO,SAAS,cAAc,OAAkB,YAAY,KAAsB;AAChF,MAAI,SAAS,KAAM,QAAO,CAAA;AAE1B,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,UAAU,aAAa,OAAO,SAAS,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,UAAU,EAAE;AAAA,EAC9F;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,QAAQ,KAAK,EACxB,IAAI,CAAC,CAAC,KAAK,GAAG,MAA4B;AACzC,UAAI,OAAO,KAAM,QAAO;AACxB,YAAM,WAAW,OAAO,GAAG,EAAE,KAAA;AAC7B,UAAI,CAAC,SAAU,QAAO;AACtB,aAAO;AAAA,QACL;AAAA,QACA,OAAO;AAAA,QACP,SAAS,GAAG,GAAG,GAAG,SAAS,GAAG,QAAQ;AAAA,QACtC,OAAO,GAAG,GAAG,GAAG,SAAS,GAAG,QAAQ;AAAA,MAAA;AAAA,IAExC,CAAC,EACA,OAAO,CAAC,QAA8B,QAAQ,IAAI;AAAA,EACvD;AAEA,SAAO,CAAA;AACT;AAEA,SAAS,aAAa,OAAiB,WAAkC;AACvE,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAA;AACtB,UAAM,KAAK,QAAQ,QAAQ,GAAG;AAC9B,UAAM,QAAQ,QAAQ,QAAQ,GAAG;AACjC,UAAM,UACJ,MAAM,MAAM,QAAQ,KAAK,KAAK,SAC1B,KACA,SAAS,KAAK,QAAQ,QAAQ,SAAS,IACrC,QACA;AAER,QAAI,UAAU,GAAG;AACf,YAAMA,OAAM,QAAQ,MAAM,GAAG,OAAO;AACpC,YAAMC,SAAQ,QAAQ,MAAM,UAAU,CAAC;AACvC,aAAO;AAAA,QACL,KAAAD;AAAAA,QACA,OAAAC;AAAAA,QACA,SAAS,GAAGD,IAAG,GAAG,SAAS,GAAGC,MAAK;AAAA,QACnC,OAAO,GAAGD,IAAG,GAAG,SAAS,GAAGC,MAAK;AAAA,MAAA;AAAA,IAErC;AAEA,WAAO,EAAE,OAAO,SAAS,SAAS,SAAS,OAAO,QAAA;AAAA,EACpD;AAEA,QAAM,MACJ,SAAS,SAAS,OAAO,MAAM,QAAQ,WACnC,MAAM,MACN,UAAU,SAAS,OAAO,MAAM,SAAS,WACvC,MAAM,OACN;AACR,QAAM,QAAQ,OAAO,MAAM,SAAS,EAAE,EAAE,KAAA;AAExC,MAAI,KAAK;AACP,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,SAAS,GAAG,GAAG,GAAG,SAAS,GAAG,KAAK;AAAA,MACnC,OAAO,GAAG,GAAG,GAAG,SAAS,GAAG,KAAK;AAAA,IAAA;AAAA,EAErC;AACA,SAAO,EAAE,OAAO,SAAS,OAAO,OAAO,MAAA;AACzC;AAEO,SAAS,gBAAgB,OAAkB,YAAY,KAAe;AAC3E,SAAO,cAAc,OAAO,SAAS,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;AAC/D;AAOO,SAAS,cAAc,OAAe,YAAY,KAAqC;AAC5F,QAAM,MAAM,MAAM,QAAQ,SAAS;AACnC,MAAI,OAAO,EAAG,QAAO,EAAE,KAAK,IAAI,OAAO,MAAA;AACvC,SAAO;AAAA,IACL,KAAK,MAAM,MAAM,GAAG,GAAG;AAAA,IACvB,OAAO,MAAM,MAAM,MAAM,UAAU,MAAM;AAAA,EAAA;AAE7C;AAeA,MAAM,OAA+B;AAAA,EACnC,SAAS,MAAM;AAAA,EACf,eAAe,MAAM;AAAA,EAAC;AAAA,EACtB,eAAe,MAAM;AAAA,EAAC;AACxB;AAEO,MAAM,oBAAoBC,MAAAA,cAAsC,IAAI;AAEpE,SAAS,gBAAwC;AACtD,SAAOC,MAAAA,WAAW,iBAAiB;AACrC;AAOO,SAAS,qBACd,OACA,UACwB;AACxB,SAAO;AAAA,IACL,SAAS,CAAC,UAAU,MAAM,KAAK,KAAK;AAAA,IACpC,eAAe,CAAC,UAAU;AACxB,YAAM,OAAO,EAAE,GAAG,MAAA;AAClB,UAAI,KAAK,KAAK,MAAM,UAAW,QAAO,KAAK,KAAK;AAAA,UAC3C,MAAK,KAAK,IAAI;AACnB,eAAS,IAAI;AAAA,IACf;AAAA,IACA,eAAe,CAAC,UAAU;AACxB,YAAM,OAAO,EAAE,GAAG,MAAA;AAClB,UAAI,KAAK,KAAK,MAAM,UAAW,QAAO,KAAK,KAAK;AAAA,UAC3C,MAAK,KAAK,IAAI;AACnB,eAAS,IAAI;AAAA,IACf;AAAA,EAAA;AAEJ;AAIO,SAAS,mBACd,OACA,UACwB;AACxB,SAAOC,MAAAA,QAAQ,MAAM,qBAAqB,OAAO,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC;AAC/E;;;;;;;;"}

package/dist/data/cells/tag-utils.d.ts

@@ -0,0 +1,51 @@
+import { FilterMode } from '../FilterPill';
+export type TagInput = string | {
+    key: string;
+    value: string;
+} | {
+    name: string;
+    value: string;
+};
+export type NormalizedTag = {
+    key?: string;
+    value: string;
+    display: string;
+    token: string;
+};
+export type TagsValue = TagInput[] | Record<string, string | number | boolean | null> | null | undefined;
+export type TagsOptions = {
+    /** Number of tags to show inline before using the `+N` overflow popover. */
+    maxVisible?: number;
+    /** Separator between tag keys and values. Defaults to `=`. */
+    separator?: string;
+};
+export declare function normalizeTags(value: TagsValue, separator?: string): NormalizedTag[];
+export declare function tagFilterTokens(value: TagsValue, separator?: string): string[];
+/**
+ * Splits a token previously produced by `normalizeTags`/`tagFilterTokens`
+ * back into its key and value parts using the same separator. Tokens
+ * without a separator (bare tags) return `{ key: "", value: token }`.
+ */
+export declare function splitTagToken(token: string, separator?: string): {
+    key: string;
+    value: string;
+};
+export type TagFilterMode = Extract<FilterMode, "include" | "exclude">;
+export type TagActionsContextValue = {
+    /** Returns the current mode for a token; "neutral" if the user hasn't acted on it. */
+    getMode: (token: string) => FilterMode;
+    /** Toggle include for this token (off → include → off). */
+    toggleInclude: (token: string) => void;
+    /** Toggle exclude for this token (off → exclude → off). */
+    toggleExclude: (token: string) => void;
+};
+export declare const TagActionsContext: import('react').Context<TagActionsContextValue>;
+export declare function useTagActions(): TagActionsContextValue;
+/**
+ * Builds a TagActionsContextValue from a flat record-of-modes (the same
+ * shape used by FilterBar's multi/nested-multi filters). Useful when
+ * connecting DataTable's multiFilters state to the in-cell + / − buttons.
+ */
+export declare function tagActionsFromRecord(value: Record<string, TagFilterMode>, onChange: (next: Record<string, TagFilterMode>) => void): TagActionsContextValue;
+export declare function useTagActionsValue(value: Record<string, TagFilterMode>, onChange: (next: Record<string, TagFilterMode>) => void): TagActionsContextValue;
+//# sourceMappingURL=tag-utils.d.ts.map

package/dist/data/cells/tag-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-utils.d.ts","sourceRoot":"","sources":["../../../src/data/cells/tag-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB,QAAQ,EAAE,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,GAChD,IAAI,GACJ,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG;IACxB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,SAAM,GAAG,aAAa,EAAE,CAwBhF;AA+CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,SAAM,GAAG,MAAM,EAAE,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAO5F;AAID,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAEvE,MAAM,MAAM,sBAAsB,GAAG;IACnC,sFAAsF;IACtF,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;IACvC,2DAA2D;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,2DAA2D;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAQF,eAAO,MAAM,iBAAiB,iDAA8C,CAAC;AAE7E,wBAAgB,aAAa,IAAI,sBAAsB,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,IAAI,GACtD,sBAAsB,CAgBxB;AAID,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,IAAI,GACtD,sBAAsB,CAExB"}

package/dist/data/cells/tag-utils.js

@@ -0,0 +1,103 @@
+import { useContext, useMemo, createContext } from "react";
+function normalizeTags(value, separator = "=") {
+  if (value == null) return [];
+  if (Array.isArray(value)) {
+    return value.map((entry) => normalizeOne(entry, separator)).filter((tag) => tag.value !== "");
+  }
+  if (typeof value === "object") {
+    return Object.entries(value).map(([key, raw]) => {
+      if (raw == null) return null;
+      const valueStr = String(raw).trim();
+      if (!valueStr) return null;
+      return {
+        key,
+        value: valueStr,
+        display: `${key}${separator}${valueStr}`,
+        token: `${key}${separator}${valueStr}`
+      };
+    }).filter((tag) => tag !== null);
+  }
+  return [];
+}
+function normalizeOne(entry, separator) {
+  if (typeof entry === "string") {
+    const trimmed = entry.trim();
+    const eq = trimmed.indexOf("=");
+    const colon = trimmed.indexOf(":");
+    const splitAt = eq >= 0 && (colon < 0 || eq < colon) ? eq : colon >= 0 && colon < trimmed.length - 1 ? colon : -1;
+    if (splitAt > 0) {
+      const key2 = trimmed.slice(0, splitAt);
+      const value2 = trimmed.slice(splitAt + 1);
+      return {
+        key: key2,
+        value: value2,
+        display: `${key2}${separator}${value2}`,
+        token: `${key2}${separator}${value2}`
+      };
+    }
+    return { value: trimmed, display: trimmed, token: trimmed };
+  }
+  const key = "key" in entry && typeof entry.key === "string" ? entry.key : "name" in entry && typeof entry.name === "string" ? entry.name : void 0;
+  const value = String(entry.value ?? "").trim();
+  if (key) {
+    return {
+      key,
+      value,
+      display: `${key}${separator}${value}`,
+      token: `${key}${separator}${value}`
+    };
+  }
+  return { value, display: value, token: value };
+}
+function tagFilterTokens(value, separator = "=") {
+  return normalizeTags(value, separator).map((tag) => tag.token);
+}
+function splitTagToken(token, separator = "=") {
+  const idx = token.indexOf(separator);
+  if (idx <= 0) return { key: "", value: token };
+  return {
+    key: token.slice(0, idx),
+    value: token.slice(idx + separator.length)
+  };
+}
+const noop = {
+  getMode: () => "neutral",
+  toggleInclude: () => {
+  },
+  toggleExclude: () => {
+  }
+};
+const TagActionsContext = createContext(noop);
+function useTagActions() {
+  return useContext(TagActionsContext);
+}
+function tagActionsFromRecord(value, onChange) {
+  return {
+    getMode: (token) => value[token] ?? "neutral",
+    toggleInclude: (token) => {
+      const next = { ...value };
+      if (next[token] === "include") delete next[token];
+      else next[token] = "include";
+      onChange(next);
+    },
+    toggleExclude: (token) => {
+      const next = { ...value };
+      if (next[token] === "exclude") delete next[token];
+      else next[token] = "exclude";
+      onChange(next);
+    }
+  };
+}
+function useTagActionsValue(value, onChange) {
+  return useMemo(() => tagActionsFromRecord(value, onChange), [value, onChange]);
+}
+export {
+  TagActionsContext,
+  normalizeTags,
+  splitTagToken,
+  tagActionsFromRecord,
+  tagFilterTokens,
+  useTagActions,
+  useTagActionsValue
+};
+//# sourceMappingURL=tag-utils.js.map

package/dist/data/cells/tag-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-utils.js","sources":["../../../src/data/cells/tag-utils.ts"],"sourcesContent":["import { createContext, useContext, useMemo } from \"react\";\nimport type { FilterMode } from \"../FilterPill\";\n\nexport type TagInput = string | { key: string; value: string } | { name: string; value: string };\n\nexport type NormalizedTag = {\n  key?: string;\n  value: string;\n  display: string;\n  token: string;\n};\n\nexport type TagsValue =\n  | TagInput[]\n  | Record<string, string | number | boolean | null>\n  | null\n  | undefined;\n\nexport type TagsOptions = {\n  /** Number of tags to show inline before using the `+N` overflow popover. */\n  maxVisible?: number;\n  /** Separator between tag keys and values. Defaults to `=`. */\n  separator?: string;\n};\n\nexport function normalizeTags(value: TagsValue, separator = \"=\"): NormalizedTag[] {\n  if (value == null) return [];\n\n  if (Array.isArray(value)) {\n    return value.map((entry) => normalizeOne(entry, separator)).filter((tag) => tag.value !== \"\");\n  }\n\n  if (typeof value === \"object\") {\n    return Object.entries(value)\n      .map(([key, raw]): NormalizedTag | null => {\n        if (raw == null) return null;\n        const valueStr = String(raw).trim();\n        if (!valueStr) return null;\n        return {\n          key,\n          value: valueStr,\n          display: `${key}${separator}${valueStr}`,\n          token: `${key}${separator}${valueStr}`,\n        } satisfies NormalizedTag;\n      })\n      .filter((tag): tag is NormalizedTag => tag !== null);\n  }\n\n  return [];\n}\n\nfunction normalizeOne(entry: TagInput, separator: string): NormalizedTag {\n  if (typeof entry === \"string\") {\n    const trimmed = entry.trim();\n    const eq = trimmed.indexOf(\"=\");\n    const colon = trimmed.indexOf(\":\");\n    const splitAt =\n      eq >= 0 && (colon < 0 || eq < colon)\n        ? eq\n        : colon >= 0 && colon < trimmed.length - 1\n          ? colon\n          : -1;\n\n    if (splitAt > 0) {\n      const key = trimmed.slice(0, splitAt);\n      const value = trimmed.slice(splitAt + 1);\n      return {\n        key,\n        value,\n        display: `${key}${separator}${value}`,\n        token: `${key}${separator}${value}`,\n      };\n    }\n\n    return { value: trimmed, display: trimmed, token: trimmed };\n  }\n\n  const key =\n    \"key\" in entry && typeof entry.key === \"string\"\n      ? entry.key\n      : \"name\" in entry && typeof entry.name === \"string\"\n        ? entry.name\n        : undefined;\n  const value = String(entry.value ?? \"\").trim();\n\n  if (key) {\n    return {\n      key,\n      value,\n      display: `${key}${separator}${value}`,\n      token: `${key}${separator}${value}`,\n    };\n  }\n  return { value, display: value, token: value };\n}\n\nexport function tagFilterTokens(value: TagsValue, separator = \"=\"): string[] {\n  return normalizeTags(value, separator).map((tag) => tag.token);\n}\n\n/**\n * Splits a token previously produced by `normalizeTags`/`tagFilterTokens`\n * back into its key and value parts using the same separator. Tokens\n * without a separator (bare tags) return `{ key: \"\", value: token }`.\n */\nexport function splitTagToken(token: string, separator = \"=\"): { key: string; value: string } {\n  const idx = token.indexOf(separator);\n  if (idx <= 0) return { key: \"\", value: token };\n  return {\n    key: token.slice(0, idx),\n    value: token.slice(idx + separator.length),\n  };\n}\n\n// Filter mode mapping (re-using FilterPill's tri-state vocabulary so the wire\n// shape matches DataTable's existing multiFilters state).\nexport type TagFilterMode = Extract<FilterMode, \"include\" | \"exclude\">;\n\nexport type TagActionsContextValue = {\n  /** Returns the current mode for a token; \"neutral\" if the user hasn't acted on it. */\n  getMode: (token: string) => FilterMode;\n  /** Toggle include for this token (off → include → off). */\n  toggleInclude: (token: string) => void;\n  /** Toggle exclude for this token (off → exclude → off). */\n  toggleExclude: (token: string) => void;\n};\n\nconst noop: TagActionsContextValue = {\n  getMode: () => \"neutral\",\n  toggleInclude: () => {},\n  toggleExclude: () => {},\n};\n\nexport const TagActionsContext = createContext<TagActionsContextValue>(noop);\n\nexport function useTagActions(): TagActionsContextValue {\n  return useContext(TagActionsContext);\n}\n\n/**\n * Builds a TagActionsContextValue from a flat record-of-modes (the same\n * shape used by FilterBar's multi/nested-multi filters). Useful when\n * connecting DataTable's multiFilters state to the in-cell + / − buttons.\n */\nexport function tagActionsFromRecord(\n  value: Record<string, TagFilterMode>,\n  onChange: (next: Record<string, TagFilterMode>) => void,\n): TagActionsContextValue {\n  return {\n    getMode: (token) => value[token] ?? \"neutral\",\n    toggleInclude: (token) => {\n      const next = { ...value };\n      if (next[token] === \"include\") delete next[token];\n      else next[token] = \"include\";\n      onChange(next);\n    },\n    toggleExclude: (token) => {\n      const next = { ...value };\n      if (next[token] === \"exclude\") delete next[token];\n      else next[token] = \"exclude\";\n      onChange(next);\n    },\n  };\n}\n\n// Memoizing the context value avoids re-rendering every TagList cell on\n// unrelated state changes.\nexport function useTagActionsValue(\n  value: Record<string, TagFilterMode>,\n  onChange: (next: Record<string, TagFilterMode>) => void,\n): TagActionsContextValue {\n  return useMemo(() => tagActionsFromRecord(value, onChange), [value, onChange]);\n}\n"],"names":["key","value"],"mappings":"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"}

package/dist/data/cells/timestamp-format.cjs

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function parseTimestamp(value) {
+  if (value == null) return null;
+  if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value;
+  if (typeof value === "number") {
+    const ms = value < 1e12 ? value * 1e3 : value;
+    const d = new Date(ms);
+    return Number.isNaN(d.getTime()) ? null : d;
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed) return null;
+    const d = new Date(trimmed);
+    return Number.isNaN(d.getTime()) ? null : d;
+  }
+  return null;
+}
+const UNIT_MS = {
+  s: 1e3,
+  m: 6e4,
+  h: 36e5,
+  d: 864e5,
+  w: 6048e5
+};
+const RELATIVE_PATTERN = /^now\s*([+-])\s*(\d+)\s*([smhdwMqy])$/;
+const ANCHORED_PATTERN = /^now\/([wMqy])(?:\s*([+-])\s*(\d+)\s*([wMqy]))?$/;
+function resolveDateMath(value, now = /* @__PURE__ */ new Date()) {
+  if (value == null) return null;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed) return null;
+    if (trimmed.toLowerCase() === "now") return new Date(now.getTime());
+    const anchoredMatch = trimmed.match(ANCHORED_PATTERN);
+    if (anchoredMatch) {
+      const [, anchor, sign, amount, unit] = anchoredMatch;
+      let anchored = startOfPeriod(now, anchor);
+      if (sign && amount && unit) {
+        anchored = addPeriod(anchored, unit, Number(amount) * (sign === "-" ? -1 : 1));
+      }
+      return anchored;
+    }
+    const match = trimmed.match(RELATIVE_PATTERN);
+    if (match) {
+      const [, sign, amount, unit] = match;
+      const calendarUnit = unit;
+      if (isCalendarUnit(calendarUnit)) {
+        return addPeriod(now, calendarUnit, Number(amount) * (sign === "-" ? -1 : 1));
+      }
+      const unitMs = UNIT_MS[calendarUnit.toLowerCase()];
+      if (!unitMs) return null;
+      const delta = Number(amount) * unitMs * (sign === "-" ? -1 : 1);
+      return new Date(now.getTime() + delta);
+    }
+  }
+  return parseTimestamp(value);
+}
+function isCalendarUnit(unit) {
+  return unit === "M" || unit === "q" || unit === "y";
+}
+function startOfPeriod(date, unit) {
+  const year = date.getUTCFullYear();
+  const month = date.getUTCMonth();
+  const day = date.getUTCDate();
+  if (unit === "w") {
+    const start = new Date(Date.UTC(year, month, day));
+    const dayOfWeek = start.getUTCDay();
+    const daysSinceMonday = (dayOfWeek + 6) % 7;
+    start.setUTCDate(start.getUTCDate() - daysSinceMonday);
+    return start;
+  }
+  if (unit === "M") return new Date(Date.UTC(year, month, 1));
+  if (unit === "q") return new Date(Date.UTC(year, Math.floor(month / 3) * 3, 1));
+  if (unit === "y") return new Date(Date.UTC(year, 0, 1));
+  return new Date(date.getTime());
+}
+function addPeriod(date, unit, amount) {
+  const next = new Date(date.getTime());
+  if (unit === "w") {
+    next.setUTCDate(next.getUTCDate() + amount * 7);
+  } else if (unit === "M") {
+    next.setUTCMonth(next.getUTCMonth() + amount);
+  } else if (unit === "q") {
+    next.setUTCMonth(next.getUTCMonth() + amount * 3);
+  } else if (unit === "y") {
+    next.setUTCFullYear(next.getUTCFullYear() + amount);
+  } else {
+    const unitMs = UNIT_MS[unit.toLowerCase()];
+    if (unitMs) next.setTime(next.getTime() + amount * unitMs);
+  }
+  return next;
+}
+const MS_PER_MINUTE = 6e4;
+const MS_PER_DAY = 864e5;
+function chooseTimestampFormat(values) {
+  if (values.length === 0) return "iso";
+  let min = Infinity;
+  let max = -Infinity;
+  for (const d of values) {
+    const t = d.getTime();
+    if (t < min) min = t;
+    if (t > max) max = t;
+  }
+  const span = max - min;
+  if (span <= MS_PER_MINUTE) return "relative";
+  const minDate = new Date(min);
+  const maxDate = new Date(max);
+  if (minDate.getFullYear() === maxDate.getFullYear() && minDate.getMonth() === maxDate.getMonth() && minDate.getDate() === maxDate.getDate()) {
+    return "time";
+  }
+  if (minDate.getFullYear() === maxDate.getFullYear() && span <= MS_PER_DAY * 365) {
+    return "short";
+  }
+  return "iso";
+}
+function formatTimestamp(date, format, now = /* @__PURE__ */ new Date()) {
+  switch (format) {
+    case "relative":
+      return formatRelativeTime(date, now);
+    case "time":
+      return date.toLocaleTimeString(void 0, {
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit"
+      });
+    case "short":
+      return date.toLocaleString(void 0, {
+        month: "short",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit"
+      });
+    case "iso":
+    default:
+      return formatIso(date);
+  }
+}
+function formatIso(date) {
+  const yyyy = date.getFullYear();
+  const mm = String(date.getMonth() + 1).padStart(2, "0");
+  const dd = String(date.getDate()).padStart(2, "0");
+  const hh = String(date.getHours()).padStart(2, "0");
+  const min = String(date.getMinutes()).padStart(2, "0");
+  return `${yyyy}-${mm}-${dd} ${hh}:${min}`;
+}
+function formatRelativeTime(date, now = /* @__PURE__ */ new Date()) {
+  const diffMs = now.getTime() - date.getTime();
+  const future = diffMs < 0;
+  const abs = Math.abs(diffMs);
+  const sec = Math.round(abs / 1e3);
+  let value;
+  if (sec < 1) value = "just now";
+  else if (sec < 60) value = `${sec}s`;
+  else if (sec < 3600) value = `${Math.round(sec / 60)}m`;
+  else if (sec < 86400) value = `${Math.round(sec / 3600)}h`;
+  else value = `${Math.round(sec / 86400)}d`;
+  if (value === "just now") return value;
+  return future ? `in ${value}` : `${value} ago`;
+}
+function formatDateTimeRelative(value, now = /* @__PURE__ */ new Date()) {
+  const parsed = parseTimestamp(value);
+  if (!parsed) return typeof value === "string" ? value : "";
+  const absolute = parsed.toLocaleString(void 0, {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+  const relative = formatRelativeTime(parsed, now);
+  return relative === "just now" ? absolute : `${absolute} (${relative})`;
+}
+function modeToFormat(mode, dataFormat) {
+  switch (mode) {
+    case "absolute":
+      return "iso";
+    case "relative":
+      return "relative";
+    case "time":
+      return "time";
+    case "auto":
+    default:
+      return dataFormat;
+  }
+}
+exports.chooseTimestampFormat = chooseTimestampFormat;
+exports.formatDateTimeRelative = formatDateTimeRelative;
+exports.formatRelativeTime = formatRelativeTime;
+exports.formatTimestamp = formatTimestamp;
+exports.modeToFormat = modeToFormat;
+exports.parseTimestamp = parseTimestamp;
+exports.resolveDateMath = resolveDateMath;
+//# sourceMappingURL=timestamp-format.cjs.map

package/dist/data/cells/timestamp-format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-format.cjs","sources":["../../../src/data/cells/timestamp-format.ts"],"sourcesContent":["import type { TimeRangePresetGroup } from \"../../components/TimeRange\";\n\nexport type TimestampMode = \"auto\" | \"absolute\" | \"relative\" | \"time\";\n\nexport type TimestampFormat = \"relative\" | \"time\" | \"short\" | \"iso\";\n\nexport type TimestampOptions = {\n  /** Rendering mode for timestamp cells. */\n  mode?: TimestampMode;\n  /** Show the full timestamp in a tooltip even for absolute/ISO formats. */\n  alwaysShowFullOnHover?: boolean;\n  /**\n   * When the column is on a DataTable with `autoFilter`, DataTable mounts a\n   * \"Time range\" picker (matching the trace UI) and filters rows whose\n   * timestamp falls outside the selected range. Set `false` to suppress.\n   */\n  autoRangeFilter?: boolean;\n  /** Override the trace-style preset list (\"Last 15 minutes\", etc.). */\n  rangePresets?: Array<{ label: string; from: string; to: string } | TimeRangePresetGroup>;\n  /** Enable absolute date+time input and timezone selection for range filters. */\n  timeEnabled?: boolean;\n  /** Default timezone used when encoding absolute date+time range values. */\n  timeZone?: string;\n  /** Selectable timezones shown when `timeEnabled` is true. */\n  timeZones?: string[];\n  /**\n   * Default range applied on first render. Either side may use date-math\n   * (`now-24h`, `now`) or any value parseable by `parseTimestamp`.\n   */\n  defaultRange?: { from?: string; to?: string };\n};\n\nexport function parseTimestamp(value: unknown): Date | null {\n  if (value == null) return null;\n  if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value;\n\n  if (typeof value === \"number\") {\n    const ms = value < 1e12 ? value * 1000 : value;\n    const d = new Date(ms);\n    return Number.isNaN(d.getTime()) ? null : d;\n  }\n\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (!trimmed) return null;\n    const d = new Date(trimmed);\n    return Number.isNaN(d.getTime()) ? null : d;\n  }\n\n  return null;\n}\n\nconst UNIT_MS: Record<string, number> = {\n  s: 1_000,\n  m: 60_000,\n  h: 3_600_000,\n  d: 86_400_000,\n  w: 604_800_000,\n};\n\nconst RELATIVE_PATTERN = /^now\\s*([+-])\\s*(\\d+)\\s*([smhdwMqy])$/;\nconst ANCHORED_PATTERN = /^now\\/([wMqy])(?:\\s*([+-])\\s*(\\d+)\\s*([wMqy]))?$/;\n\n/**\n * Resolves date-math strings to an absolute Date. Recognised forms:\n *   - \"now\"\n *   - \"now-15m\", \"now-1h\", \"now+30s\", \"now-7d\", \"now-2w\" (units: s/m/h/d/w/M/q/y)\n *   - \"now/w\", \"now/M\", \"now/q\", \"now/y\" with optional calendar offsets\n *   - any value parseable by `parseTimestamp` (ISO, epoch ms/s, Date)\n * Returns null for unparseable input.\n */\nexport function resolveDateMath(value: unknown, now: Date = new Date()): Date | null {\n  if (value == null) return null;\n\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (!trimmed) return null;\n\n    if (trimmed.toLowerCase() === \"now\") return new Date(now.getTime());\n\n    const anchoredMatch = trimmed.match(ANCHORED_PATTERN);\n    if (anchoredMatch) {\n      const [, anchor, sign, amount, unit] = anchoredMatch;\n      let anchored = startOfPeriod(now, anchor!);\n      if (sign && amount && unit) {\n        anchored = addPeriod(anchored, unit, Number(amount) * (sign === \"-\" ? -1 : 1));\n      }\n      return anchored;\n    }\n\n    const match = trimmed.match(RELATIVE_PATTERN);\n    if (match) {\n      const [, sign, amount, unit] = match;\n      const calendarUnit = unit!;\n      if (isCalendarUnit(calendarUnit)) {\n        return addPeriod(now, calendarUnit, Number(amount) * (sign === \"-\" ? -1 : 1));\n      }\n      const unitMs = UNIT_MS[calendarUnit.toLowerCase()];\n      if (!unitMs) return null;\n      const delta = Number(amount) * unitMs * (sign === \"-\" ? -1 : 1);\n      return new Date(now.getTime() + delta);\n    }\n  }\n\n  return parseTimestamp(value);\n}\n\nfunction isCalendarUnit(unit: string) {\n  return unit === \"M\" || unit === \"q\" || unit === \"y\";\n}\n\nfunction startOfPeriod(date: Date, unit: string) {\n  const year = date.getUTCFullYear();\n  const month = date.getUTCMonth();\n  const day = date.getUTCDate();\n\n  if (unit === \"w\") {\n    const start = new Date(Date.UTC(year, month, day));\n    const dayOfWeek = start.getUTCDay();\n    const daysSinceMonday = (dayOfWeek + 6) % 7;\n    start.setUTCDate(start.getUTCDate() - daysSinceMonday);\n    return start;\n  }\n  if (unit === \"M\") return new Date(Date.UTC(year, month, 1));\n  if (unit === \"q\") return new Date(Date.UTC(year, Math.floor(month / 3) * 3, 1));\n  if (unit === \"y\") return new Date(Date.UTC(year, 0, 1));\n  return new Date(date.getTime());\n}\n\nfunction addPeriod(date: Date, unit: string, amount: number) {\n  const next = new Date(date.getTime());\n  if (unit === \"w\") {\n    next.setUTCDate(next.getUTCDate() + amount * 7);\n  } else if (unit === \"M\") {\n    next.setUTCMonth(next.getUTCMonth() + amount);\n  } else if (unit === \"q\") {\n    next.setUTCMonth(next.getUTCMonth() + amount * 3);\n  } else if (unit === \"y\") {\n    next.setUTCFullYear(next.getUTCFullYear() + amount);\n  } else {\n    const unitMs = UNIT_MS[unit.toLowerCase()];\n    if (unitMs) next.setTime(next.getTime() + amount * unitMs);\n  }\n  return next;\n}\n\nconst MS_PER_MINUTE = 60_000;\nconst MS_PER_DAY = 86_400_000;\n\nexport function chooseTimestampFormat(values: Date[]): TimestampFormat {\n  if (values.length === 0) return \"iso\";\n\n  let min = Infinity;\n  let max = -Infinity;\n  for (const d of values) {\n    const t = d.getTime();\n    if (t < min) min = t;\n    if (t > max) max = t;\n  }\n  const span = max - min;\n\n  if (span <= MS_PER_MINUTE) return \"relative\";\n\n  const minDate = new Date(min);\n  const maxDate = new Date(max);\n\n  if (\n    minDate.getFullYear() === maxDate.getFullYear() &&\n    minDate.getMonth() === maxDate.getMonth() &&\n    minDate.getDate() === maxDate.getDate()\n  ) {\n    return \"time\";\n  }\n\n  if (minDate.getFullYear() === maxDate.getFullYear() && span <= MS_PER_DAY * 365) {\n    return \"short\";\n  }\n\n  return \"iso\";\n}\n\nexport function formatTimestamp(\n  date: Date,\n  format: TimestampFormat,\n  now: Date = new Date(),\n): string {\n  switch (format) {\n    case \"relative\":\n      return formatRelativeTime(date, now);\n    case \"time\":\n      return date.toLocaleTimeString(undefined, {\n        hour: \"2-digit\",\n        minute: \"2-digit\",\n        second: \"2-digit\",\n      });\n    case \"short\":\n      return date.toLocaleString(undefined, {\n        month: \"short\",\n        day: \"numeric\",\n        hour: \"2-digit\",\n        minute: \"2-digit\",\n      });\n    case \"iso\":\n    default:\n      return formatIso(date);\n  }\n}\n\nfunction formatIso(date: Date): string {\n  const yyyy = date.getFullYear();\n  const mm = String(date.getMonth() + 1).padStart(2, \"0\");\n  const dd = String(date.getDate()).padStart(2, \"0\");\n  const hh = String(date.getHours()).padStart(2, \"0\");\n  const min = String(date.getMinutes()).padStart(2, \"0\");\n  return `${yyyy}-${mm}-${dd} ${hh}:${min}`;\n}\n\n// formatRelativeTime renders a compact \"30s ago\" / \"in 5m\" / \"just now\" string.\nexport function formatRelativeTime(date: Date, now: Date = new Date()): string {\n  const diffMs = now.getTime() - date.getTime();\n  const future = diffMs < 0;\n  const abs = Math.abs(diffMs);\n  const sec = Math.round(abs / 1000);\n\n  let value: string;\n  if (sec < 1) value = \"just now\";\n  else if (sec < 60) value = `${sec}s`;\n  else if (sec < 3600) value = `${Math.round(sec / 60)}m`;\n  else if (sec < 86400) value = `${Math.round(sec / 3600)}h`;\n  else value = `${Math.round(sec / 86400)}d`;\n\n  if (value === \"just now\") return value;\n  return future ? `in ${value}` : `${value} ago`;\n}\n\n// formatDateTimeRelative renders a value as an absolute locale date+time plus a\n// parenthesised relative hint, e.g. \"Apr 15, 2026, 12:00 PM (2h ago)\". It is the\n// shared \"locale + relative\" presentation used for date-typed values across the\n// form, filter, and combobox surfaces. Unparseable strings pass through\n// unchanged (so a template token or freeform value is preserved); nullish input\n// yields an empty string. The hint is dropped when the value reads \"just now\".\nexport function formatDateTimeRelative(value: unknown, now: Date = new Date()): string {\n  const parsed = parseTimestamp(value);\n  if (!parsed) return typeof value === \"string\" ? value : \"\";\n  const absolute = parsed.toLocaleString(undefined, {\n    year: \"numeric\",\n    month: \"short\",\n    day: \"numeric\",\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n  });\n  const relative = formatRelativeTime(parsed, now);\n  return relative === \"just now\" ? absolute : `${absolute} (${relative})`;\n}\n\nexport function modeToFormat(mode: TimestampMode, dataFormat: TimestampFormat): TimestampFormat {\n  switch (mode) {\n    case \"absolute\":\n      return \"iso\";\n    case \"relative\":\n      return \"relative\";\n    case \"time\":\n      return \"time\";\n    case \"auto\":\n    default:\n      return dataFormat;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/data/cells/timestamp-format.d.ts

@@ -0,0 +1,51 @@
+import { TimeRangePresetGroup } from '../../components/TimeRange';
+export type TimestampMode = "auto" | "absolute" | "relative" | "time";
+export type TimestampFormat = "relative" | "time" | "short" | "iso";
+export type TimestampOptions = {
+    /** Rendering mode for timestamp cells. */
+    mode?: TimestampMode;
+    /** Show the full timestamp in a tooltip even for absolute/ISO formats. */
+    alwaysShowFullOnHover?: boolean;
+    /**
+     * When the column is on a DataTable with `autoFilter`, DataTable mounts a
+     * "Time range" picker (matching the trace UI) and filters rows whose
+     * timestamp falls outside the selected range. Set `false` to suppress.
+     */
+    autoRangeFilter?: boolean;
+    /** Override the trace-style preset list ("Last 15 minutes", etc.). */
+    rangePresets?: Array<{
+        label: string;
+        from: string;
+        to: string;
+    } | TimeRangePresetGroup>;
+    /** Enable absolute date+time input and timezone selection for range filters. */
+    timeEnabled?: boolean;
+    /** Default timezone used when encoding absolute date+time range values. */
+    timeZone?: string;
+    /** Selectable timezones shown when `timeEnabled` is true. */
+    timeZones?: string[];
+    /**
+     * Default range applied on first render. Either side may use date-math
+     * (`now-24h`, `now`) or any value parseable by `parseTimestamp`.
+     */
+    defaultRange?: {
+        from?: string;
+        to?: string;
+    };
+};
+export declare function parseTimestamp(value: unknown): Date | null;
+/**
+ * Resolves date-math strings to an absolute Date. Recognised forms:
+ *   - "now"
+ *   - "now-15m", "now-1h", "now+30s", "now-7d", "now-2w" (units: s/m/h/d/w/M/q/y)
+ *   - "now/w", "now/M", "now/q", "now/y" with optional calendar offsets
+ *   - any value parseable by `parseTimestamp` (ISO, epoch ms/s, Date)
+ * Returns null for unparseable input.
+ */
+export declare function resolveDateMath(value: unknown, now?: Date): Date | null;
+export declare function chooseTimestampFormat(values: Date[]): TimestampFormat;
+export declare function formatTimestamp(date: Date, format: TimestampFormat, now?: Date): string;
+export declare function formatRelativeTime(date: Date, now?: Date): string;
+export declare function formatDateTimeRelative(value: unknown, now?: Date): string;
+export declare function modeToFormat(mode: TimestampMode, dataFormat: TimestampFormat): TimestampFormat;
+//# sourceMappingURL=timestamp-format.d.ts.map

package/dist/data/cells/timestamp-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-format.d.ts","sourceRoot":"","sources":["../../../src/data/cells/timestamp-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,oBAAoB,CAAC,CAAC;IACzF,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAkB1D;AAaD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,GAAG,IAAI,CAkCnF;AA4CD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,eAAe,CA8BrE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,eAAe,EACvB,GAAG,GAAE,IAAiB,GACrB,MAAM,CAqBR;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAe7E;AAQD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAYrF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,GAAG,eAAe,CAY9F"}