@usertour/helpers 0.0.1

package/dist/chunk-ZNFXGN3M.js

@@ -0,0 +1,25 @@
+// src/is-url.ts
+var protocolAndDomainRE = /^(?:\w+:)?\/\/(\S+)$/;
+var localhostDomainRE = /^localhost[\:?\d]*(?:[^\:?\d]\S*)?$/;
+var nonLocalhostDomainRE = /^[^\s\.]+\.\S{2,}$/;
+function isUrl(string) {
+  if (typeof string !== "string") {
+    return false;
+  }
+  const match = string.match(protocolAndDomainRE);
+  if (!match) {
+    return false;
+  }
+  const everythingAfterProtocol = match[1];
+  if (!everythingAfterProtocol) {
+    return false;
+  }
+  if (localhostDomainRE.test(everythingAfterProtocol) || nonLocalhostDomainRE.test(everythingAfterProtocol)) {
+    return true;
+  }
+  return false;
+}
+
+export {
+  isUrl
+};

package/dist/color.cjs

@@ -0,0 +1,84 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/color.ts
+var color_exports = {};
+__export(color_exports, {
+  generateAutoStateColors: () => generateAutoStateColors,
+  hexToHSLString: () => hexToHSLString,
+  hexToRGBStr: () => hexToRGBStr
+});
+module.exports = __toCommonJS(color_exports);
+var import_chroma_js = __toESM(require("chroma-js"), 1);
+function hexToHSLString(hexColor) {
+  try {
+    const color = (0, import_chroma_js.default)(hexColor);
+    const [h, s, l] = color.hsl();
+    const hDeg = Math.round(h || 0);
+    const sPct = Math.round(s * 100);
+    const lPct = Math.round(l * 100);
+    return `${hDeg} ${sPct}% ${lPct}%`;
+  } catch (error) {
+    console.warn(`Failed to convert ${hexColor} to HSL string:`, error);
+    return "0 0% 0%";
+  }
+}
+var hexToRGBStr = (hex) => {
+  try {
+    const color = (0, import_chroma_js.default)(hex);
+    const [r, g, b] = color.rgb();
+    return `${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)}`;
+  } catch (error) {
+    console.warn(`Failed to convert ${hex} to RGB string:`, error);
+    return "0, 0, 0";
+  }
+};
+function generateAutoStateColors(baseColor, brandColor, hoverRatio = 0.12, activeRatio = 0.24) {
+  const isBaseLight = (0, import_chroma_js.default)(baseColor).luminance() > 0.8;
+  const isBaseBrand = import_chroma_js.default.distance(baseColor, brandColor) < 10;
+  let hover;
+  let active;
+  if (isBaseBrand) {
+    hover = import_chroma_js.default.mix(baseColor, "#fff", hoverRatio, "rgb").hex();
+    active = import_chroma_js.default.mix(baseColor, "#fff", activeRatio, "rgb").hex();
+  } else if (isBaseLight) {
+    hover = import_chroma_js.default.mix(baseColor, brandColor, hoverRatio, "rgb").hex();
+    active = import_chroma_js.default.mix(baseColor, brandColor, activeRatio, "rgb").hex();
+  } else {
+    hover = import_chroma_js.default.mix(baseColor, brandColor, hoverRatio, "rgb").hex();
+    active = import_chroma_js.default.mix(baseColor, brandColor, activeRatio, "rgb").hex();
+  }
+  return { hover, active };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateAutoStateColors,
+  hexToHSLString,
+  hexToRGBStr
+});

package/dist/color.d.cts

@@ -0,0 +1,29 @@
+/**
+ * Convert hex color to HSL string format for Tailwind CSS
+ * @param hexColor - Hex color string (e.g., "#FFFFFF")
+ * @returns HSL string format (e.g., "0 0% 100%")
+ */
+declare function hexToHSLString(hexColor: string): string;
+/**
+ * Convert hex color to RGB string format (e.g., "255, 255, 255")
+ * @param hex - Hex color string (e.g., "#FFFFFF")
+ * @returns RGB string format without alpha
+ */
+declare const hexToRGBStr: (hex: string) => string;
+/**
+ * Automatically generate hover and active colors based on baseColor and brandColor.
+ * If baseColor is similar to brandColor, hover is mixed with white (LAB), active is darkened.
+ * If baseColor is light (e.g., white), hover/active are mixed with brandColor (LAB).
+ * Otherwise, hover is mixed with brandColor (LAB), active is darkened.
+ * @param baseColor - The base color (e.g., button or content background)
+ * @param brandColor - The brand color
+ * @param hoverRatio - Mix ratio for hover state (default 0.15)
+ * @param activeDarken - Darken factor for active state (default 0.12)
+ * @returns An object with hover and active color hex strings
+ */
+declare function generateAutoStateColors(baseColor: string, brandColor: string, hoverRatio?: number, activeRatio?: number): {
+    hover: string;
+    active: string;
+};
+
+export { generateAutoStateColors, hexToHSLString, hexToRGBStr };

package/dist/color.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Convert hex color to HSL string format for Tailwind CSS
+ * @param hexColor - Hex color string (e.g., "#FFFFFF")
+ * @returns HSL string format (e.g., "0 0% 100%")
+ */
+declare function hexToHSLString(hexColor: string): string;
+/**
+ * Convert hex color to RGB string format (e.g., "255, 255, 255")
+ * @param hex - Hex color string (e.g., "#FFFFFF")
+ * @returns RGB string format without alpha
+ */
+declare const hexToRGBStr: (hex: string) => string;
+/**
+ * Automatically generate hover and active colors based on baseColor and brandColor.
+ * If baseColor is similar to brandColor, hover is mixed with white (LAB), active is darkened.
+ * If baseColor is light (e.g., white), hover/active are mixed with brandColor (LAB).
+ * Otherwise, hover is mixed with brandColor (LAB), active is darkened.
+ * @param baseColor - The base color (e.g., button or content background)
+ * @param brandColor - The brand color
+ * @param hoverRatio - Mix ratio for hover state (default 0.15)
+ * @param activeDarken - Darken factor for active state (default 0.12)
+ * @returns An object with hover and active color hex strings
+ */
+declare function generateAutoStateColors(baseColor: string, brandColor: string, hoverRatio?: number, activeRatio?: number): {
+    hover: string;
+    active: string;
+};
+
+export { generateAutoStateColors, hexToHSLString, hexToRGBStr };

package/dist/color.js

@@ -0,0 +1,11 @@
+import {
+  generateAutoStateColors,
+  hexToHSLString,
+  hexToRGBStr
+} from "./chunk-VT24VOAZ.js";
+import "./chunk-XEO3YXBM.js";
+export {
+  generateAutoStateColors,
+  hexToHSLString,
+  hexToRGBStr
+};

package/dist/condition.cjs

@@ -0,0 +1,157 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/condition.ts
+var condition_exports = {};
+__export(condition_exports, {
+  conditionsIsSame: () => conditionsIsSame,
+  isEqual: () => import_fast_deep_equal.default,
+  isMatchUrlPattern: () => isMatchUrlPattern
+});
+module.exports = __toCommonJS(condition_exports);
+var import_fast_deep_equal = __toESM(require("fast-deep-equal"), 1);
+var parseUrl = (url) => {
+  const urlPatterns = url.match(/^(([a-z\d]+):\/\/)?([^/?#]+)?(\/[^?#]*)?(\?([^#]*))?(#.*)?$/i);
+  if (!urlPatterns) {
+    return null;
+  }
+  const [, , scheme = "", domain = "", path = "", , query = "", fragment = ""] = urlPatterns;
+  return { scheme, domain, path, query, fragment };
+};
+var replaceWildcard = (input, s1, s2) => {
+  const withSpecialWords = replaceSpecialWords(input);
+  const withWildcard = withSpecialWords.replace(/\\\*/g, `${s1}*`);
+  if (!s2) {
+    return withWildcard;
+  }
+  return withWildcard.replace(/:[a-z0-9_]+/g, `[^${s2}]+`);
+};
+var replaceSpecialWords = (str) => {
+  return str.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
+};
+var parsePattern = (pattern) => {
+  if (!pattern || !pattern.trim()) {
+    return null;
+  }
+  const _pattern = parseUrl(pattern);
+  if (!_pattern) {
+    console.error("Invalid URL pattern:", pattern);
+    return null;
+  }
+  const { scheme, domain, path, query, fragment } = _pattern;
+  const _scheme = scheme ? replaceSpecialWords(scheme) : "[a-z\\d]+";
+  const _domain = domain ? replaceWildcard(domain, "[^/]", ".") : "[^/]*";
+  const _fragment = fragment ? replaceWildcard(fragment, ".", "/") : "(#.*)?";
+  const _path = path ? replaceWildcard(path, "[^?#]", "/") : "/[^?#]*";
+  let _query = "(\\?[^#]*)?";
+  if (query) {
+    new URLSearchParams(query).forEach((value, key) => {
+      const _str = value === "" ? "=?" : value === "*" ? "(=[^&#]*)?" : `=${replaceWildcard(value, "[^#]")}`;
+      _query += `(?=.*[?&]${replaceSpecialWords(key)}${_str}([&#]|$))`;
+    });
+    _query += "\\?[^#]*";
+  }
+  return new RegExp(`^${_scheme}://${_domain}(:\\d+)?${_path}${_query}${_fragment}$`);
+};
+var isMatchUrlPattern = (_url, includes, excludes) => {
+  const isMatchIncludesConditions = includes.length > 0 ? includes.some((_include) => {
+    const reg = parsePattern(_include);
+    if (reg) {
+      return reg.test(_url);
+    }
+    return false;
+  }) : true;
+  const isMatchExcludesConditions = excludes.length > 0 ? excludes.some((_exclude) => {
+    const reg = parsePattern(_exclude);
+    if (reg) {
+      return reg.test(_url);
+    }
+    return false;
+  }) : false;
+  return isMatchIncludesConditions && !isMatchExcludesConditions;
+};
+var compareConditionsItem = (item1, item2) => {
+  const { data = {}, ...others1 } = item1;
+  const { data: data2 = {}, ...others2 } = item2;
+  if (!(0, import_fast_deep_equal.default)(others2, others1)) {
+    return false;
+  }
+  for (const key in data) {
+    if (!(0, import_fast_deep_equal.default)(data[key], data2[key])) {
+      return false;
+    }
+  }
+  return true;
+};
+var conditionsIsSame = (rr1, rr2) => {
+  const r1 = [...rr1];
+  const r2 = [...rr2];
+  if (r1.length === 0 && r2.length === 0) {
+    return true;
+  }
+  if (r1.length !== r2.length) {
+    return false;
+  }
+  const group1 = r1.filter((item) => item.type === "group");
+  const group2 = r2.filter((item) => item.type === "group");
+  if (group1.length !== group2.length) {
+    return false;
+  }
+  for (let index = 0; index < r1.length; index++) {
+    const item1 = r1[index];
+    const item2 = r2[index];
+    if (!item1 || !item2) {
+      return false;
+    }
+    if (item1.type === "group") {
+      if (!item2.conditions) {
+        return false;
+      }
+      const c1 = item1.conditions;
+      const c2 = item2.conditions;
+      if (item1.operators !== item2.operators) {
+        return false;
+      }
+      if (!conditionsIsSame(c1, c2)) {
+        return false;
+      }
+    } else {
+      if (!compareConditionsItem(item1, item2)) {
+        return false;
+      }
+    }
+  }
+  return true;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  conditionsIsSame,
+  isEqual,
+  isMatchUrlPattern
+});

package/dist/condition.d.cts

@@ -0,0 +1,7 @@
+import { RulesCondition } from '@usertour/types';
+export { default as isEqual } from 'fast-deep-equal';
+
+declare const isMatchUrlPattern: (_url: string, includes: string[], excludes: string[]) => boolean;
+declare const conditionsIsSame: (rr1: RulesCondition[], rr2: RulesCondition[]) => boolean;
+
+export { conditionsIsSame, isMatchUrlPattern };

package/dist/condition.d.ts

@@ -0,0 +1,7 @@
+import { RulesCondition } from '@usertour/types';
+export { default as isEqual } from 'fast-deep-equal';
+
+declare const isMatchUrlPattern: (_url: string, includes: string[], excludes: string[]) => boolean;
+declare const conditionsIsSame: (rr1: RulesCondition[], rr2: RulesCondition[]) => boolean;
+
+export { conditionsIsSame, isMatchUrlPattern };

package/dist/condition.js

@@ -0,0 +1,11 @@
+import {
+  conditionsIsSame,
+  isEqual,
+  isMatchUrlPattern
+} from "./chunk-FNQIIEWK.js";
+import "./chunk-XEO3YXBM.js";
+export {
+  conditionsIsSame,
+  isEqual,
+  isMatchUrlPattern
+};

package/dist/content-settings.cjs

@@ -0,0 +1,76 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/content-settings.ts
+var content_settings_exports = {};
+__export(content_settings_exports, {
+  autoStartConditions: () => autoStartConditions,
+  buildConfig: () => buildConfig,
+  defaultContentConfig: () => defaultContentConfig
+});
+module.exports = __toCommonJS(content_settings_exports);
+var import_types = require("@usertour/types");
+var import_deepmerge_ts = require("deepmerge-ts");
+var rulesSetting = {
+  // frequency: {
+  //   frequency: Frequency.ONCE,
+  //   every: { duration: 0, times: 1, unit: FrequencyUnits.MINUTES },
+  //   atLeast: { duration: 0, unit: FrequencyUnits.MINUTES },
+  // },
+  startIfNotComplete: false,
+  priority: import_types.ContentPriority.MEDIUM,
+  wait: 0
+};
+var hideRulesSetting = {};
+var defaultContentConfig = {
+  enabledAutoStartRules: false,
+  enabledHideRules: false,
+  autoStartRules: [],
+  hideRules: [],
+  autoStartRulesSetting: rulesSetting,
+  hideRulesSetting
+};
+var autoStartConditions = {
+  ...defaultContentConfig,
+  enabledAutoStartRules: true,
+  autoStartRules: [
+    {
+      data: { excludes: [], includes: ["/*"] },
+      type: "current-page",
+      operators: "and"
+    }
+  ]
+};
+var buildConfig = (config) => {
+  return {
+    ...defaultContentConfig,
+    ...config,
+    autoStartRulesSetting: (0, import_deepmerge_ts.deepmerge)(
+      defaultContentConfig.autoStartRulesSetting,
+      (config == null ? void 0 : config.autoStartRulesSetting) || {}
+    ),
+    hideRulesSetting: (config == null ? void 0 : config.hideRulesSetting) || {}
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  autoStartConditions,
+  buildConfig,
+  defaultContentConfig
+});

package/dist/content-settings.d.cts

@@ -0,0 +1,7 @@
+import { ContentConfigObject } from '@usertour/types';
+
+declare const defaultContentConfig: ContentConfigObject;
+declare const autoStartConditions: ContentConfigObject;
+declare const buildConfig: (config: ContentConfigObject | undefined) => ContentConfigObject;
+
+export { autoStartConditions, buildConfig, defaultContentConfig };

package/dist/content-settings.d.ts

@@ -0,0 +1,7 @@
+import { ContentConfigObject } from '@usertour/types';
+
+declare const defaultContentConfig: ContentConfigObject;
+declare const autoStartConditions: ContentConfigObject;
+declare const buildConfig: (config: ContentConfigObject | undefined) => ContentConfigObject;
+
+export { autoStartConditions, buildConfig, defaultContentConfig };

package/dist/content-settings.js

@@ -0,0 +1,11 @@
+import {
+  autoStartConditions,
+  buildConfig,
+  defaultContentConfig
+} from "./chunk-64BFWPHJ.js";
+import "./chunk-XEO3YXBM.js";
+export {
+  autoStartConditions,
+  buildConfig,
+  defaultContentConfig
+};

package/dist/content.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/content.ts
+var content_exports = {};
+__export(content_exports, {
+  isPublishedAtLeastOneEnvironment: () => isPublishedAtLeastOneEnvironment,
+  isPublishedInAllEnvironments: () => isPublishedInAllEnvironments
+});
+module.exports = __toCommonJS(content_exports);
+var isPublishedInAllEnvironments = (content, environmentList, version) => {
+  const isPublishedInAllEnvironments2 = environmentList == null ? void 0 : environmentList.every(
+    (env) => {
+      var _a;
+      return (_a = content == null ? void 0 : content.contentOnEnvironments) == null ? void 0 : _a.find(
+        (item) => item.published && item.publishedVersionId === (version == null ? void 0 : version.id) && item.environment.id === env.id
+      );
+    }
+  );
+  const isPublishedInOneEnvironment = (content == null ? void 0 : content.published) && (content == null ? void 0 : content.publishedVersionId) === (version == null ? void 0 : version.id) && environmentList && (environmentList == null ? void 0 : environmentList.length) === 1;
+  return (content == null ? void 0 : content.contentOnEnvironments) && (content == null ? void 0 : content.contentOnEnvironments.length) > 0 ? Boolean(isPublishedInAllEnvironments2) : Boolean(isPublishedInOneEnvironment);
+};
+var isPublishedAtLeastOneEnvironment = (content) => {
+  var _a;
+  if ((content == null ? void 0 : content.contentOnEnvironments) && ((_a = content == null ? void 0 : content.contentOnEnvironments) == null ? void 0 : _a.length) > 0) {
+    return true;
+  }
+  if ((content == null ? void 0 : content.published) && (content == null ? void 0 : content.publishedVersionId)) {
+    return true;
+  }
+  return false;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isPublishedAtLeastOneEnvironment,
+  isPublishedInAllEnvironments
+});

package/dist/content.d.cts

@@ -0,0 +1,6 @@
+import { Content, Environment, ContentVersion } from '@usertour/types';
+
+declare const isPublishedInAllEnvironments: (content: Content | null, environmentList: Environment[] | null, version: ContentVersion | null) => boolean;
+declare const isPublishedAtLeastOneEnvironment: (content: Content | null) => boolean;
+
+export { isPublishedAtLeastOneEnvironment, isPublishedInAllEnvironments };

package/dist/content.d.ts

@@ -0,0 +1,6 @@
+import { Content, Environment, ContentVersion } from '@usertour/types';
+
+declare const isPublishedInAllEnvironments: (content: Content | null, environmentList: Environment[] | null, version: ContentVersion | null) => boolean;
+declare const isPublishedAtLeastOneEnvironment: (content: Content | null) => boolean;
+
+export { isPublishedAtLeastOneEnvironment, isPublishedInAllEnvironments };

package/dist/content.js

@@ -0,0 +1,9 @@
+import {
+  isPublishedAtLeastOneEnvironment,
+  isPublishedInAllEnvironments
+} from "./chunk-BBPZYUJR.js";
+import "./chunk-XEO3YXBM.js";
+export {
+  isPublishedAtLeastOneEnvironment,
+  isPublishedInAllEnvironments
+};