npm - @wu529778790/floating-ad - Versions diffs - 0.0.0-stage → 0.1.2 - Mend

@wu529778790/floating-ad 0.0.0-stage → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/index.esm.js ADDED Viewed

@@ -0,0 +1,208 @@
+// src/FloatingAd.ts
+var DEFAULT_THEME = {
+  bg: "rgba(255, 255, 255, 0.96)",
+  accent: "#333",
+  radius: "12px",
+  border: "rgba(0, 0, 0, 0.1)"
+};
+var STORAGE_KEY = "floating-ad:closed";
+var MOBILE_QUERY = "(max-width: 767px)";
+function isMobile() {
+  var _a, _b, _c;
+  if (typeof window === "undefined") return false;
+  return (_c = (_b = (_a = window.matchMedia) == null ? void 0 : _a.call(window, MOBILE_QUERY)) == null ? void 0 : _b.matches) != null ? _c : false;
+}
+function hasCloseMark() {
+  if (typeof localStorage === "undefined") return false;
+  try {
+    return localStorage.getItem(STORAGE_KEY) === "1";
+  } catch {
+    return false;
+  }
+}
+function setCloseMark() {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(STORAGE_KEY, "1");
+  } catch {
+  }
+}
+function isRenderableAd(ad) {
+  var _a;
+  return Boolean(ad && typeof ad === "object" && ((_a = ad.src) == null ? void 0 : _a.trim()));
+}
+function resolveOptions(options) {
+  var _a, _b, _c, _d, _e, _f;
+  const raw = Array.isArray(options.ads) ? options.ads : [];
+  return {
+    ads: raw.filter(isRenderableAd),
+    // 移动端缺省落在左下角（不挡右侧阅读区/返回顶部按钮）
+    position: (_a = options.position) != null ? _a : isMobile() ? "left-bottom" : "left-center",
+    closePersistence: (_b = options.closePersistence) != null ? _b : false,
+    hideOnMobile: (_c = options.hideOnMobile) != null ? _c : false,
+    zIndex: (_d = options.zIndex) != null ? _d : 9999,
+    adLabel: options.adLabel === void 0 ? false : options.adLabel,
+    imageFit: options.imageFit === "contain" ? "contain" : "cover",
+    sizeOverrides: {
+      width: Number.isFinite(options.width) ? Math.max(80, Number(options.width)) : void 0,
+      offset: Number.isFinite(options.offset) ? Math.max(0, Number(options.offset)) : void 0,
+      imageSize: Number.isFinite(options.imageSize) ? Math.max(40, Number(options.imageSize)) : void 0
+    },
+    theme: { ...DEFAULT_THEME, ...(_e = options.theme) != null ? _e : {} },
+    themeOverrides: (_f = options.theme) != null ? _f : {},
+    onClick: options.onClick
+  };
+}
+var FloatingAd = class {
+  constructor(options = {}, container = document.body) {
+    this.el = null;
+    this.closeBtn = null;
+    /** 本次渲染的广告列表（与 DOM 上的 data-index 一一对应） */
+    this.rendered = [];
+    this.handleClose = () => {
+      this.close();
+    };
+    this.handleImageError = (event) => {
+      const img = event.target;
+      if (!img || img.tagName !== "IMG" || !img.classList.contains("fa-img")) return;
+      const media = img.closest(".fa-media");
+      if (!media) return;
+      media.classList.add("fa-media--failed");
+      const item = media.closest(".fa-item");
+      if (item && !item.querySelector(".fa-body")) item.classList.add("fa-item--failed");
+    };
+    this.handleItemClick = (event) => {
+      var _a;
+      if (!this.opts.onClick) return;
+      const target = event.target;
+      const item = (_a = target == null ? void 0 : target.closest) == null ? void 0 : _a.call(target, ".fa-item");
+      if (!item) return;
+      const index = Number(item.dataset.index);
+      const ad = this.rendered[index];
+      if (!ad) return;
+      this.opts.onClick(ad, event);
+    };
+    this.opts = resolveOptions(options);
+    this.container = container;
+    if (this.opts.hideOnMobile && isMobile()) return;
+    if (this.opts.closePersistence && hasCloseMark()) return;
+    this.render();
+  }
+  /** 是否已挂载到页面 */
+  isMounted() {
+    return this.el !== null && this.el.isConnected;
+  }
+  /** 打开（已关闭后再次显示，忽略 localStorage 关闭标记） */
+  open() {
+    if (this.isMounted()) return;
+    this.render();
+  }
+  /** 关闭浮窗（完全移除）。默认不记住状态，刷新后重新出现 */
+  close() {
+    if (this.opts.closePersistence) {
+      setCloseMark();
+    }
+    this.destroy();
+  }
+  /** 从页面移除并解绑 */
+  destroy() {
+    var _a, _b, _c, _d;
+    (_a = this.closeBtn) == null ? void 0 : _a.removeEventListener("click", this.handleClose);
+    this.closeBtn = null;
+    (_b = this.el) == null ? void 0 : _b.removeEventListener("click", this.handleItemClick);
+    (_c = this.el) == null ? void 0 : _c.removeEventListener("error", this.handleImageError, true);
+    (_d = this.el) == null ? void 0 : _d.remove();
+    this.el = null;
+    this.rendered = [];
+  }
+  /** 用新配置重渲染（保留原容器） */
+  update(options) {
+    this.destroy();
+    this.opts = resolveOptions(options);
+    if (this.opts.hideOnMobile && isMobile()) return;
+    if (this.opts.closePersistence && hasCloseMark()) return;
+    this.render();
+  }
+  render() {
+    var _a;
+    const { ads, position, zIndex, themeOverrides, adLabel, imageFit, sizeOverrides } = this.opts;
+    if (ads.length === 0) return;
+    const root = document.createElement("div");
+    root.className = "fa-widget";
+    root.dataset.position = position;
+    root.style.zIndex = String(zIndex);
+    root.style.setProperty("--fa-img-fit", imageFit);
+    if (sizeOverrides.width !== void 0) {
+      root.style.setProperty("--fa-width", `${sizeOverrides.width}px`);
+    }
+    if (sizeOverrides.offset !== void 0) {
+      root.style.setProperty("--fa-offset", `${sizeOverrides.offset}px`);
+    }
+    if (sizeOverrides.imageSize !== void 0) {
+      root.style.setProperty("--fa-img-size", `${sizeOverrides.imageSize}px`);
+    }
+    const overrides = [
+      ["--fa-bg", themeOverrides.bg],
+      ["--fa-accent", themeOverrides.accent],
+      ["--fa-radius", themeOverrides.radius],
+      ["--fa-border", themeOverrides.border]
+    ];
+    for (const [key, value] of overrides) {
+      if (value !== void 0) root.style.setProperty(key, value);
+    }
+    const label = adLabel ? escapeHtml(String(adLabel)) : "";
+    root.innerHTML = `
+      <button class="fa-close" type="button" aria-label="\u5173\u95ED\u5E7F\u544A">${CLOSE_SVG}</button>
+      ${ads.map((ad, index) => this.renderItem(ad, index, index === 0 ? label : "")).join('<div class="fa-divider" role="separator"></div>')}
+    `;
+    this.closeBtn = root.querySelector(".fa-close");
+    (_a = this.closeBtn) == null ? void 0 : _a.addEventListener("click", this.handleClose);
+    root.addEventListener("click", this.handleItemClick);
+    root.addEventListener("error", this.handleImageError, true);
+    this.rendered = ads;
+    this.container.appendChild(root);
+    this.el = root;
+  }
+  renderItem(ad, index, label) {
+    var _a, _b;
+    const media = `<span class="fa-media">
+        <img class="fa-img" src="${escapeAttr(ad.src)}" alt="${escapeAttr((_b = (_a = ad.alt) != null ? _a : ad.title) != null ? _b : "")}" loading="lazy" decoding="async" />
+        ${ad.badge ? `<span class="fa-tag">${escapeHtml(ad.badge)}</span>` : ""}
+        ${label ? `<span class="fa-label">${label}</span>` : ""}
+      </span>`;
+    const body = ad.title || ad.desc ? `<span class="fa-body">
+            ${ad.title ? `<span class="fa-title">${escapeHtml(ad.title)}</span>` : ""}
+            ${ad.desc ? `<span class="fa-desc">${escapeHtml(ad.desc)}</span>` : ""}
+          </span>` : "";
+    const inner = `${media}${body}`;
+    const href = ad.href ? safeHref(ad.href) : null;
+    if (href) {
+      const target = ad.target === "_self" ? "_self" : "_blank";
+      const rel = target === "_blank" ? ' rel="noopener noreferrer nofollow sponsored"' : ' rel="nofollow sponsored"';
+      return `<a class="fa-item" href="${escapeAttr(href)}" target="${target}"${rel} data-index="${index}">${inner}</a>`;
+    }
+    return `<div class="fa-item" data-index="${index}">${inner}</div>`;
+  }
+};
+var CLOSE_SVG = '<svg viewBox="0 0 24 24" width="14" height="14" aria-hidden="true" focusable="false"><path d="M6 6l12 12M18 6L6 18" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>';
+function safeHref(href) {
+  const trimmed = href.trim();
+  if (!trimmed) return null;
+  const compact = trimmed.replace(/[\s\u0000-\u001f]/g, "").toLowerCase();
+  if (/^(javascript|data|vbscript|file):/.test(compact)) return null;
+  return trimmed;
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function escapeAttr(value) {
+  return escapeHtml(value);
+}
+// src/index.ts
+var index_default = FloatingAd;
+export {
+  FloatingAd,
+  index_default as default
+};
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/FloatingAd.ts","../src/index.ts"],"sourcesContent":["export type Position =\n | 'right-bottom'\n | 'right-top'\n | 'right-center'\n | 'left-bottom'\n | 'left-top'\n | 'left-center'\n\n/** 单条广告 */\nexport interface FloatingAdItem {\n /** 广告图片地址（必填；没有图片的条目不会渲染） */\n src: string\n /** 标题 */\n title?: string\n /** 副文案 / 卖点 */\n desc?: string\n /** 点击跳转链接（可选，不传则不可点击） */\n href?: string\n /** 跳转方式，默认 `_blank`（仅在传了 href 时生效） */\n target?: '_blank' | '_self'\n /** 图片 alt，缺省使用标题 */\n alt?: string\n /** 图片右上角角标文案，如「限时」 */\n badge?: string\n}\n\nexport interface FloatingAdTheme {\n /** 浮窗背景色 */\n bg?: string\n /** 强调色（标题、角标） */\n accent?: string\n /** 圆角大小 */\n radius?: string\n /** 边框颜色 */\n border?: string\n}\n\nexport interface FloatingAdOptions {\n /** 广告列表（按数组顺序自上而下排列；为空时不渲染浮窗） */\n ads?: FloatingAdItem[]\n /** 浮窗位置，缺省：桌面 left-center / 移动端（<768px）left-bottom */\n position?: Position\n /** 关闭后是否记住状态（写入 localStorage），默认 false —— false 时刷新页面必然重新出现 */\n closePersistence?: boolean\n /** 移动端（<768px）是否隐藏，默认 false（移动端展示更小一号的浮窗） */\n hideOnMobile?: boolean\n /** 浮窗 z-index，默认 9999 */\n zIndex?: number\n /** 「广告」标识文案（压在首图左上角），默认 false 不显示；传字符串则显示该文案 */\n adLabel?: string | false\n /** 浮窗宽度（px），缺省：桌面 150 / 移动端 140 */\n width?: number\n /** 浮窗距视口边缘距离（px），缺省：桌面 16 / 移动端 12 */\n offset?: number\n /** 图片填充方式，默认 cover */\n imageFit?: 'cover' | 'contain'\n /** 广告图片边长（px，正方形），缺省：桌面 120 / 移动端 112 */\n imageSize?: number\n /** 主题（映射为 CSS 变量，也可直接覆盖 --fa-* 变量） */\n theme?: FloatingAdTheme\n /** 点击广告回调（不影响默认跳转行为） */\n onClick?: (ad: FloatingAdItem, event: MouseEvent) => void\n}\n\ninterface ResolvedOptions {\n ads: FloatingAdItem[]\n position: Position\n closePersistence: boolean\n hideOnMobile: boolean\n zIndex: number\n adLabel: string | false\n imageFit: 'cover' | 'contain'\n /** 用户显式传入的尺寸子集（未配置时不写 inline，交给 CSS 按桌面/移动端默认值走） */\n sizeOverrides: {\n width?: number\n offset?: number\n imageSize?: number\n }\n theme: Required<FloatingAdTheme>\n /** 用户显式传入的主题子集（未配置的 key 交给 CSS 默认值，可随系统深浅色变化） */\n themeOverrides: FloatingAdTheme\n onClick?: (ad: FloatingAdItem, event: MouseEvent) => void\n}\n\nconst DEFAULT_THEME: Required<FloatingAdTheme> = {\n bg: 'rgba(255, 255, 255, 0.96)',\n accent: '#333',\n radius: '12px',\n border: 'rgba(0, 0, 0, 0.1)'\n}\n\nconst STORAGE_KEY = 'floating-ad:closed'\nconst MOBILE_QUERY = '(max-width: 767px)'\n\nfunction isMobile(): boolean {\n if (typeof window === 'undefined') return false\n return window.matchMedia?.(MOBILE_QUERY)?.matches ?? false\n}\n\nfunction hasCloseMark(): boolean {\n if (typeof localStorage === 'undefined') return false\n try {\n return localStorage.getItem(STORAGE_KEY) === '1'\n } catch {\n return false\n }\n}\n\nfunction setCloseMark(): void {\n if (typeof localStorage === 'undefined') return\n try {\n localStorage.setItem(STORAGE_KEY, '1')\n } catch {\n /* ignore quota / privacy mode */\n }\n}\n\n/** 只有带图片的条目才会渲染（本组件只承载图片广告） */\nfunction isRenderableAd(ad: FloatingAdItem | null | undefined): ad is FloatingAdItem {\n return Boolean(ad && typeof ad === 'object' && ad.src?.trim())\n}\n\nfunction resolveOptions(options: FloatingAdOptions): ResolvedOptions {\n const raw = Array.isArray(options.ads) ? options.ads : []\n return {\n ads: raw.filter(isRenderableAd),\n // 移动端缺省落在左下角（不挡右侧阅读区/返回顶部按钮）\n position: options.position ?? (isMobile() ? 'left-bottom' : 'left-center'),\n closePersistence: options.closePersistence ?? false,\n hideOnMobile: options.hideOnMobile ?? false,\n zIndex: options.zIndex ?? 9999,\n adLabel: options.adLabel === undefined ? false : options.adLabel,\n imageFit: options.imageFit === 'contain' ? 'contain' : 'cover',\n sizeOverrides: {\n width: Number.isFinite(options.width) ? Math.max(80, Number(options.width)) : undefined,\n offset: Number.isFinite(options.offset) ? Math.max(0, Number(options.offset)) : undefined,\n imageSize: Number.isFinite(options.imageSize)\n ? Math.max(40, Number(options.imageSize))\n : undefined\n },\n theme: { ...DEFAULT_THEME, ...(options.theme ?? {}) },\n themeOverrides: options.theme ?? {},\n onClick: options.onClick\n }\n}\n\n/**\n * A minimal floating ad slot that pins image / text ads to the left (or right) edge.\n * Zero dependencies. Framework-agnostic. Styleable via --fa-* CSS variables.\n *\n * 没有广告数据时不渲染任何节点（不会留下空白卡片）。\n *\n * @param container 渲染容器，默认 document.body；Web Component 场景传入 shadow root\n */\nexport class FloatingAd {\n private opts: ResolvedOptions\n private readonly container: HTMLElement | ShadowRoot\n private el: HTMLElement | null = null\n private closeBtn: HTMLButtonElement | null = null\n /** 本次渲染的广告列表（与 DOM 上的 data-index 一一对应） */\n private rendered: FloatingAdItem[] = []\n\n constructor(\n options: FloatingAdOptions = {},\n container: HTMLElement | ShadowRoot = document.body\n ) {\n this.opts = resolveOptions(options)\n this.container = container\n\n if (this.opts.hideOnMobile && isMobile()) return\n if (this.opts.closePersistence && hasCloseMark()) return\n\n this.render()\n }\n\n /** 是否已挂载到页面 */\n isMounted(): boolean {\n return this.el !== null && this.el.isConnected\n }\n\n /** 打开（已关闭后再次显示，忽略 localStorage 关闭标记） */\n open(): void {\n if (this.isMounted()) return\n this.render()\n }\n\n /** 关闭浮窗（完全移除）。默认不记住状态，刷新后重新出现 */\n close(): void {\n if (this.opts.closePersistence) {\n setCloseMark()\n }\n this.destroy()\n }\n\n /** 从页面移除并解绑 */\n destroy(): void {\n this.closeBtn?.removeEventListener('click', this.handleClose)\n this.closeBtn = null\n this.el?.removeEventListener('click', this.handleItemClick)\n this.el?.removeEventListener('error', this.handleImageError, true)\n this.el?.remove()\n this.el = null\n this.rendered = []\n }\n\n /** 用新配置重渲染（保留原容器） */\n update(options: FloatingAdOptions): void {\n this.destroy()\n this.opts = resolveOptions(options)\n\n if (this.opts.hideOnMobile && isMobile()) return\n if (this.opts.closePersistence && hasCloseMark()) return\n\n this.render()\n }\n\n private render(): void {\n const { ads, position, zIndex, themeOverrides, adLabel, imageFit, sizeOverrides } = this.opts\n\n if (ads.length === 0) return\n\n const root = document.createElement('div')\n root.className = 'fa-widget'\n root.dataset.position = position\n root.style.zIndex = String(zIndex)\n root.style.setProperty('--fa-img-fit', imageFit)\n // 尺寸只在用户显式配置时写 inline，其余交给 CSS（桌面 / 移动端各一套默认值）\n if (sizeOverrides.width !== undefined) {\n root.style.setProperty('--fa-width', `${sizeOverrides.width}px`)\n }\n if (sizeOverrides.offset !== undefined) {\n root.style.setProperty('--fa-offset', `${sizeOverrides.offset}px`)\n }\n if (sizeOverrides.imageSize !== undefined) {\n root.style.setProperty('--fa-img-size', `${sizeOverrides.imageSize}px`)\n }\n\n // 仅把用户显式设置的主题写为 inline（用户优先）；\n // 未设置的 key 交给 CSS 变量默认值，以便跟随系统深浅色（prefers-color-scheme）\n const overrides = [\n ['--fa-bg', themeOverrides.bg],\n ['--fa-accent', themeOverrides.accent],\n ['--fa-radius', themeOverrides.radius],\n ['--fa-border', themeOverrides.border]\n ] as const\n for (const [key, value] of overrides) {\n if (value !== undefined) root.style.setProperty(key, value)\n }\n\n // 「广告」标识不单独占行：压在首图左上角\n const label = adLabel ? escapeHtml(String(adLabel)) : ''\n\n root.innerHTML = `\n <button class=\"fa-close\" type=\"button\" aria-label=\"关闭广告\">${CLOSE_SVG}</button>\n ${ads\n .map((ad, index) => this.renderItem(ad, index, index === 0 ? label : ''))\n .join('<div class=\"fa-divider\" role=\"separator\"></div>')}\n `\n\n this.closeBtn = root.querySelector<HTMLButtonElement>('.fa-close')\n this.closeBtn?.addEventListener('click', this.handleClose)\n root.addEventListener('click', this.handleItemClick)\n // 图片加载失败时降级：隐藏空图框，仅保留文字；连文字都没有就整条隐藏\n root.addEventListener('error', this.handleImageError, true)\n\n this.rendered = ads\n this.container.appendChild(root)\n this.el = root\n }\n\n private renderItem(ad: FloatingAdItem, index: number, label: string): string {\n const media = `<span class=\"fa-media\">\n <img class=\"fa-img\" src=\"${escapeAttr(ad.src)}\" alt=\"${escapeAttr(ad.alt ?? ad.title ?? '')}\" loading=\"lazy\" decoding=\"async\" />\n ${ad.badge ? `<span class=\"fa-tag\">${escapeHtml(ad.badge)}</span>` : ''}\n ${label ? `<span class=\"fa-label\">${label}</span>` : ''}\n </span>`\n\n const body =\n ad.title || ad.desc\n ? `<span class=\"fa-body\">\n ${ad.title ? `<span class=\"fa-title\">${escapeHtml(ad.title)}</span>` : ''}\n ${ad.desc ? `<span class=\"fa-desc\">${escapeHtml(ad.desc)}</span>` : ''}\n </span>`\n : ''\n\n const inner = `${media}${body}`\n\n const href = ad.href ? safeHref(ad.href) : null\n if (href) {\n const target = ad.target === '_self' ? '_self' : '_blank'\n const rel =\n target === '_blank'\n ? ' rel=\"noopener noreferrer nofollow sponsored\"'\n : ' rel=\"nofollow sponsored\"'\n return `<a class=\"fa-item\" href=\"${escapeAttr(href)}\" target=\"${target}\"${rel} data-index=\"${index}\">${inner}</a>`\n }\n\n return `<div class=\"fa-item\" data-index=\"${index}\">${inner}</div>`\n }\n\n private readonly handleClose = (): void => {\n this.close()\n }\n\n private readonly handleImageError = (event: Event): void => {\n const img = event.target as HTMLElement | null\n if (!img || img.tagName !== 'IMG' || !img.classList.contains('fa-img')) return\n const media = img.closest('.fa-media')\n if (!media) return\n media.classList.add('fa-media--failed')\n const item = media.closest('.fa-item')\n if (item && !item.querySelector('.fa-body')) item.classList.add('fa-item--failed')\n }\n\n private readonly handleItemClick = (event: Event): void => {\n if (!this.opts.onClick) return\n const target = event.target as Element | null\n const item = target?.closest?.('.fa-item') as HTMLElement | null\n if (!item) return\n const index = Number(item.dataset.index)\n const ad = this.rendered[index]\n if (!ad) return\n this.opts.onClick(ad, event as MouseEvent)\n }\n}\n\nconst CLOSE_SVG =\n '<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" focusable=\"false\"><path d=\"M6 6l12 12M18 6L6 18\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"/></svg>'\n\n/** 过滤危险协议（javascript: / data: / vbscript: 等），返回可用链接或 null */\nfunction safeHref(href: string): string | null {\n const trimmed = href.trim()\n if (!trimmed) return null\n const compact = trimmed.replace(/[\\s\\u0000-\\u001f]/g, '').toLowerCase()\n if (/^(javascript|data|vbscript|file):/.test(compact)) return null\n return trimmed\n}\n\nfunction escapeHtml(value: string): string {\n return value\n .replace(/&/g, '&')\n .replace(/</g, '<')\n .replace(/>/g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''')\n}\n\nfunction escapeAttr(value: string): string {\n return escapeHtml(value)\n}\n","import { FloatingAd } from './FloatingAd'\n\nexport { FloatingAd }\nexport default FloatingAd\nexport type { FloatingAdOptions, FloatingAdItem, FloatingAdTheme, Position } from './FloatingAd'\n"],"mappings":"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","names":[]}

package/dist/index.umd.cjs ADDED Viewed

@@ -0,0 +1,235 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FloatingAd: () => FloatingAd,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+// src/FloatingAd.ts
+var DEFAULT_THEME = {
+  bg: "rgba(255, 255, 255, 0.96)",
+  accent: "#333",
+  radius: "12px",
+  border: "rgba(0, 0, 0, 0.1)"
+};
+var STORAGE_KEY = "floating-ad:closed";
+var MOBILE_QUERY = "(max-width: 767px)";
+function isMobile() {
+  var _a, _b, _c;
+  if (typeof window === "undefined") return false;
+  return (_c = (_b = (_a = window.matchMedia) == null ? void 0 : _a.call(window, MOBILE_QUERY)) == null ? void 0 : _b.matches) != null ? _c : false;
+}
+function hasCloseMark() {
+  if (typeof localStorage === "undefined") return false;
+  try {
+    return localStorage.getItem(STORAGE_KEY) === "1";
+  } catch {
+    return false;
+  }
+}
+function setCloseMark() {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(STORAGE_KEY, "1");
+  } catch {
+  }
+}
+function isRenderableAd(ad) {
+  var _a;
+  return Boolean(ad && typeof ad === "object" && ((_a = ad.src) == null ? void 0 : _a.trim()));
+}
+function resolveOptions(options) {
+  var _a, _b, _c, _d, _e, _f;
+  const raw = Array.isArray(options.ads) ? options.ads : [];
+  return {
+    ads: raw.filter(isRenderableAd),
+    // 移动端缺省落在左下角（不挡右侧阅读区/返回顶部按钮）
+    position: (_a = options.position) != null ? _a : isMobile() ? "left-bottom" : "left-center",
+    closePersistence: (_b = options.closePersistence) != null ? _b : false,
+    hideOnMobile: (_c = options.hideOnMobile) != null ? _c : false,
+    zIndex: (_d = options.zIndex) != null ? _d : 9999,
+    adLabel: options.adLabel === void 0 ? false : options.adLabel,
+    imageFit: options.imageFit === "contain" ? "contain" : "cover",
+    sizeOverrides: {
+      width: Number.isFinite(options.width) ? Math.max(80, Number(options.width)) : void 0,
+      offset: Number.isFinite(options.offset) ? Math.max(0, Number(options.offset)) : void 0,
+      imageSize: Number.isFinite(options.imageSize) ? Math.max(40, Number(options.imageSize)) : void 0
+    },
+    theme: { ...DEFAULT_THEME, ...(_e = options.theme) != null ? _e : {} },
+    themeOverrides: (_f = options.theme) != null ? _f : {},
+    onClick: options.onClick
+  };
+}
+var FloatingAd = class {
+  constructor(options = {}, container = document.body) {
+    this.el = null;
+    this.closeBtn = null;
+    /** 本次渲染的广告列表（与 DOM 上的 data-index 一一对应） */
+    this.rendered = [];
+    this.handleClose = () => {
+      this.close();
+    };
+    this.handleImageError = (event) => {
+      const img = event.target;
+      if (!img || img.tagName !== "IMG" || !img.classList.contains("fa-img")) return;
+      const media = img.closest(".fa-media");
+      if (!media) return;
+      media.classList.add("fa-media--failed");
+      const item = media.closest(".fa-item");
+      if (item && !item.querySelector(".fa-body")) item.classList.add("fa-item--failed");
+    };
+    this.handleItemClick = (event) => {
+      var _a;
+      if (!this.opts.onClick) return;
+      const target = event.target;
+      const item = (_a = target == null ? void 0 : target.closest) == null ? void 0 : _a.call(target, ".fa-item");
+      if (!item) return;
+      const index = Number(item.dataset.index);
+      const ad = this.rendered[index];
+      if (!ad) return;
+      this.opts.onClick(ad, event);
+    };
+    this.opts = resolveOptions(options);
+    this.container = container;
+    if (this.opts.hideOnMobile && isMobile()) return;
+    if (this.opts.closePersistence && hasCloseMark()) return;
+    this.render();
+  }
+  /** 是否已挂载到页面 */
+  isMounted() {
+    return this.el !== null && this.el.isConnected;
+  }
+  /** 打开（已关闭后再次显示，忽略 localStorage 关闭标记） */
+  open() {
+    if (this.isMounted()) return;
+    this.render();
+  }
+  /** 关闭浮窗（完全移除）。默认不记住状态，刷新后重新出现 */
+  close() {
+    if (this.opts.closePersistence) {
+      setCloseMark();
+    }
+    this.destroy();
+  }
+  /** 从页面移除并解绑 */
+  destroy() {
+    var _a, _b, _c, _d;
+    (_a = this.closeBtn) == null ? void 0 : _a.removeEventListener("click", this.handleClose);
+    this.closeBtn = null;
+    (_b = this.el) == null ? void 0 : _b.removeEventListener("click", this.handleItemClick);
+    (_c = this.el) == null ? void 0 : _c.removeEventListener("error", this.handleImageError, true);
+    (_d = this.el) == null ? void 0 : _d.remove();
+    this.el = null;
+    this.rendered = [];
+  }
+  /** 用新配置重渲染（保留原容器） */
+  update(options) {
+    this.destroy();
+    this.opts = resolveOptions(options);
+    if (this.opts.hideOnMobile && isMobile()) return;
+    if (this.opts.closePersistence && hasCloseMark()) return;
+    this.render();
+  }
+  render() {
+    var _a;
+    const { ads, position, zIndex, themeOverrides, adLabel, imageFit, sizeOverrides } = this.opts;
+    if (ads.length === 0) return;
+    const root = document.createElement("div");
+    root.className = "fa-widget";
+    root.dataset.position = position;
+    root.style.zIndex = String(zIndex);
+    root.style.setProperty("--fa-img-fit", imageFit);
+    if (sizeOverrides.width !== void 0) {
+      root.style.setProperty("--fa-width", `${sizeOverrides.width}px`);
+    }
+    if (sizeOverrides.offset !== void 0) {
+      root.style.setProperty("--fa-offset", `${sizeOverrides.offset}px`);
+    }
+    if (sizeOverrides.imageSize !== void 0) {
+      root.style.setProperty("--fa-img-size", `${sizeOverrides.imageSize}px`);
+    }
+    const overrides = [
+      ["--fa-bg", themeOverrides.bg],
+      ["--fa-accent", themeOverrides.accent],
+      ["--fa-radius", themeOverrides.radius],
+      ["--fa-border", themeOverrides.border]
+    ];
+    for (const [key, value] of overrides) {
+      if (value !== void 0) root.style.setProperty(key, value);
+    }
+    const label = adLabel ? escapeHtml(String(adLabel)) : "";
+    root.innerHTML = `
+      <button class="fa-close" type="button" aria-label="\u5173\u95ED\u5E7F\u544A">${CLOSE_SVG}</button>
+      ${ads.map((ad, index) => this.renderItem(ad, index, index === 0 ? label : "")).join('<div class="fa-divider" role="separator"></div>')}
+    `;
+    this.closeBtn = root.querySelector(".fa-close");
+    (_a = this.closeBtn) == null ? void 0 : _a.addEventListener("click", this.handleClose);
+    root.addEventListener("click", this.handleItemClick);
+    root.addEventListener("error", this.handleImageError, true);
+    this.rendered = ads;
+    this.container.appendChild(root);
+    this.el = root;
+  }
+  renderItem(ad, index, label) {
+    var _a, _b;
+    const media = `<span class="fa-media">
+        <img class="fa-img" src="${escapeAttr(ad.src)}" alt="${escapeAttr((_b = (_a = ad.alt) != null ? _a : ad.title) != null ? _b : "")}" loading="lazy" decoding="async" />
+        ${ad.badge ? `<span class="fa-tag">${escapeHtml(ad.badge)}</span>` : ""}
+        ${label ? `<span class="fa-label">${label}</span>` : ""}
+      </span>`;
+    const body = ad.title || ad.desc ? `<span class="fa-body">
+            ${ad.title ? `<span class="fa-title">${escapeHtml(ad.title)}</span>` : ""}
+            ${ad.desc ? `<span class="fa-desc">${escapeHtml(ad.desc)}</span>` : ""}
+          </span>` : "";
+    const inner = `${media}${body}`;
+    const href = ad.href ? safeHref(ad.href) : null;
+    if (href) {
+      const target = ad.target === "_self" ? "_self" : "_blank";
+      const rel = target === "_blank" ? ' rel="noopener noreferrer nofollow sponsored"' : ' rel="nofollow sponsored"';
+      return `<a class="fa-item" href="${escapeAttr(href)}" target="${target}"${rel} data-index="${index}">${inner}</a>`;
+    }
+    return `<div class="fa-item" data-index="${index}">${inner}</div>`;
+  }
+};
+var CLOSE_SVG = '<svg viewBox="0 0 24 24" width="14" height="14" aria-hidden="true" focusable="false"><path d="M6 6l12 12M18 6L6 18" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>';
+function safeHref(href) {
+  const trimmed = href.trim();
+  if (!trimmed) return null;
+  const compact = trimmed.replace(/[\s\u0000-\u001f]/g, "").toLowerCase();
+  if (/^(javascript|data|vbscript|file):/.test(compact)) return null;
+  return trimmed;
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function escapeAttr(value) {
+  return escapeHtml(value);
+}
+// src/index.ts
+var index_default = FloatingAd;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FloatingAd
+});
+//# sourceMappingURL=index.umd.cjs.map

package/dist/index.umd.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/index.ts","../src/FloatingAd.ts"],"sourcesContent":["import { FloatingAd } from './FloatingAd'\n\nexport { FloatingAd }\nexport default FloatingAd\nexport type { FloatingAdOptions, FloatingAdItem, FloatingAdTheme, Position } from './FloatingAd'\n","export type Position =\n | 'right-bottom'\n | 'right-top'\n | 'right-center'\n | 'left-bottom'\n | 'left-top'\n | 'left-center'\n\n/** 单条广告 */\nexport interface FloatingAdItem {\n /** 广告图片地址（必填；没有图片的条目不会渲染） */\n src: string\n /** 标题 */\n title?: string\n /** 副文案 / 卖点 */\n desc?: string\n /** 点击跳转链接（可选，不传则不可点击） */\n href?: string\n /** 跳转方式，默认 `_blank`（仅在传了 href 时生效） */\n target?: '_blank' | '_self'\n /** 图片 alt，缺省使用标题 */\n alt?: string\n /** 图片右上角角标文案，如「限时」 */\n badge?: string\n}\n\nexport interface FloatingAdTheme {\n /** 浮窗背景色 */\n bg?: string\n /** 强调色（标题、角标） */\n accent?: string\n /** 圆角大小 */\n radius?: string\n /** 边框颜色 */\n border?: string\n}\n\nexport interface FloatingAdOptions {\n /** 广告列表（按数组顺序自上而下排列；为空时不渲染浮窗） */\n ads?: FloatingAdItem[]\n /** 浮窗位置，缺省：桌面 left-center / 移动端（<768px）left-bottom */\n position?: Position\n /** 关闭后是否记住状态（写入 localStorage），默认 false —— false 时刷新页面必然重新出现 */\n closePersistence?: boolean\n /** 移动端（<768px）是否隐藏，默认 false（移动端展示更小一号的浮窗） */\n hideOnMobile?: boolean\n /** 浮窗 z-index，默认 9999 */\n zIndex?: number\n /** 「广告」标识文案（压在首图左上角），默认 false 不显示；传字符串则显示该文案 */\n adLabel?: string | false\n /** 浮窗宽度（px），缺省：桌面 150 / 移动端 140 */\n width?: number\n /** 浮窗距视口边缘距离（px），缺省：桌面 16 / 移动端 12 */\n offset?: number\n /** 图片填充方式，默认 cover */\n imageFit?: 'cover' | 'contain'\n /** 广告图片边长（px，正方形），缺省：桌面 120 / 移动端 112 */\n imageSize?: number\n /** 主题（映射为 CSS 变量，也可直接覆盖 --fa-* 变量） */\n theme?: FloatingAdTheme\n /** 点击广告回调（不影响默认跳转行为） */\n onClick?: (ad: FloatingAdItem, event: MouseEvent) => void\n}\n\ninterface ResolvedOptions {\n ads: FloatingAdItem[]\n position: Position\n closePersistence: boolean\n hideOnMobile: boolean\n zIndex: number\n adLabel: string | false\n imageFit: 'cover' | 'contain'\n /** 用户显式传入的尺寸子集（未配置时不写 inline，交给 CSS 按桌面/移动端默认值走） */\n sizeOverrides: {\n width?: number\n offset?: number\n imageSize?: number\n }\n theme: Required<FloatingAdTheme>\n /** 用户显式传入的主题子集（未配置的 key 交给 CSS 默认值，可随系统深浅色变化） */\n themeOverrides: FloatingAdTheme\n onClick?: (ad: FloatingAdItem, event: MouseEvent) => void\n}\n\nconst DEFAULT_THEME: Required<FloatingAdTheme> = {\n bg: 'rgba(255, 255, 255, 0.96)',\n accent: '#333',\n radius: '12px',\n border: 'rgba(0, 0, 0, 0.1)'\n}\n\nconst STORAGE_KEY = 'floating-ad:closed'\nconst MOBILE_QUERY = '(max-width: 767px)'\n\nfunction isMobile(): boolean {\n if (typeof window === 'undefined') return false\n return window.matchMedia?.(MOBILE_QUERY)?.matches ?? false\n}\n\nfunction hasCloseMark(): boolean {\n if (typeof localStorage === 'undefined') return false\n try {\n return localStorage.getItem(STORAGE_KEY) === '1'\n } catch {\n return false\n }\n}\n\nfunction setCloseMark(): void {\n if (typeof localStorage === 'undefined') return\n try {\n localStorage.setItem(STORAGE_KEY, '1')\n } catch {\n /* ignore quota / privacy mode */\n }\n}\n\n/** 只有带图片的条目才会渲染（本组件只承载图片广告） */\nfunction isRenderableAd(ad: FloatingAdItem | null | undefined): ad is FloatingAdItem {\n return Boolean(ad && typeof ad === 'object' && ad.src?.trim())\n}\n\nfunction resolveOptions(options: FloatingAdOptions): ResolvedOptions {\n const raw = Array.isArray(options.ads) ? options.ads : []\n return {\n ads: raw.filter(isRenderableAd),\n // 移动端缺省落在左下角（不挡右侧阅读区/返回顶部按钮）\n position: options.position ?? (isMobile() ? 'left-bottom' : 'left-center'),\n closePersistence: options.closePersistence ?? false,\n hideOnMobile: options.hideOnMobile ?? false,\n zIndex: options.zIndex ?? 9999,\n adLabel: options.adLabel === undefined ? false : options.adLabel,\n imageFit: options.imageFit === 'contain' ? 'contain' : 'cover',\n sizeOverrides: {\n width: Number.isFinite(options.width) ? Math.max(80, Number(options.width)) : undefined,\n offset: Number.isFinite(options.offset) ? Math.max(0, Number(options.offset)) : undefined,\n imageSize: Number.isFinite(options.imageSize)\n ? Math.max(40, Number(options.imageSize))\n : undefined\n },\n theme: { ...DEFAULT_THEME, ...(options.theme ?? {}) },\n themeOverrides: options.theme ?? {},\n onClick: options.onClick\n }\n}\n\n/**\n * A minimal floating ad slot that pins image / text ads to the left (or right) edge.\n * Zero dependencies. Framework-agnostic. Styleable via --fa-* CSS variables.\n *\n * 没有广告数据时不渲染任何节点（不会留下空白卡片）。\n *\n * @param container 渲染容器，默认 document.body；Web Component 场景传入 shadow root\n */\nexport class FloatingAd {\n private opts: ResolvedOptions\n private readonly container: HTMLElement | ShadowRoot\n private el: HTMLElement | null = null\n private closeBtn: HTMLButtonElement | null = null\n /** 本次渲染的广告列表（与 DOM 上的 data-index 一一对应） */\n private rendered: FloatingAdItem[] = []\n\n constructor(\n options: FloatingAdOptions = {},\n container: HTMLElement | ShadowRoot = document.body\n ) {\n this.opts = resolveOptions(options)\n this.container = container\n\n if (this.opts.hideOnMobile && isMobile()) return\n if (this.opts.closePersistence && hasCloseMark()) return\n\n this.render()\n }\n\n /** 是否已挂载到页面 */\n isMounted(): boolean {\n return this.el !== null && this.el.isConnected\n }\n\n /** 打开（已关闭后再次显示，忽略 localStorage 关闭标记） */\n open(): void {\n if (this.isMounted()) return\n this.render()\n }\n\n /** 关闭浮窗（完全移除）。默认不记住状态，刷新后重新出现 */\n close(): void {\n if (this.opts.closePersistence) {\n setCloseMark()\n }\n this.destroy()\n }\n\n /** 从页面移除并解绑 */\n destroy(): void {\n this.closeBtn?.removeEventListener('click', this.handleClose)\n this.closeBtn = null\n this.el?.removeEventListener('click', this.handleItemClick)\n this.el?.removeEventListener('error', this.handleImageError, true)\n this.el?.remove()\n this.el = null\n this.rendered = []\n }\n\n /** 用新配置重渲染（保留原容器） */\n update(options: FloatingAdOptions): void {\n this.destroy()\n this.opts = resolveOptions(options)\n\n if (this.opts.hideOnMobile && isMobile()) return\n if (this.opts.closePersistence && hasCloseMark()) return\n\n this.render()\n }\n\n private render(): void {\n const { ads, position, zIndex, themeOverrides, adLabel, imageFit, sizeOverrides } = this.opts\n\n if (ads.length === 0) return\n\n const root = document.createElement('div')\n root.className = 'fa-widget'\n root.dataset.position = position\n root.style.zIndex = String(zIndex)\n root.style.setProperty('--fa-img-fit', imageFit)\n // 尺寸只在用户显式配置时写 inline，其余交给 CSS（桌面 / 移动端各一套默认值）\n if (sizeOverrides.width !== undefined) {\n root.style.setProperty('--fa-width', `${sizeOverrides.width}px`)\n }\n if (sizeOverrides.offset !== undefined) {\n root.style.setProperty('--fa-offset', `${sizeOverrides.offset}px`)\n }\n if (sizeOverrides.imageSize !== undefined) {\n root.style.setProperty('--fa-img-size', `${sizeOverrides.imageSize}px`)\n }\n\n // 仅把用户显式设置的主题写为 inline（用户优先）；\n // 未设置的 key 交给 CSS 变量默认值，以便跟随系统深浅色（prefers-color-scheme）\n const overrides = [\n ['--fa-bg', themeOverrides.bg],\n ['--fa-accent', themeOverrides.accent],\n ['--fa-radius', themeOverrides.radius],\n ['--fa-border', themeOverrides.border]\n ] as const\n for (const [key, value] of overrides) {\n if (value !== undefined) root.style.setProperty(key, value)\n }\n\n // 「广告」标识不单独占行：压在首图左上角\n const label = adLabel ? escapeHtml(String(adLabel)) : ''\n\n root.innerHTML = `\n <button class=\"fa-close\" type=\"button\" aria-label=\"关闭广告\">${CLOSE_SVG}</button>\n ${ads\n .map((ad, index) => this.renderItem(ad, index, index === 0 ? label : ''))\n .join('<div class=\"fa-divider\" role=\"separator\"></div>')}\n `\n\n this.closeBtn = root.querySelector<HTMLButtonElement>('.fa-close')\n this.closeBtn?.addEventListener('click', this.handleClose)\n root.addEventListener('click', this.handleItemClick)\n // 图片加载失败时降级：隐藏空图框，仅保留文字；连文字都没有就整条隐藏\n root.addEventListener('error', this.handleImageError, true)\n\n this.rendered = ads\n this.container.appendChild(root)\n this.el = root\n }\n\n private renderItem(ad: FloatingAdItem, index: number, label: string): string {\n const media = `<span class=\"fa-media\">\n <img class=\"fa-img\" src=\"${escapeAttr(ad.src)}\" alt=\"${escapeAttr(ad.alt ?? ad.title ?? '')}\" loading=\"lazy\" decoding=\"async\" />\n ${ad.badge ? `<span class=\"fa-tag\">${escapeHtml(ad.badge)}</span>` : ''}\n ${label ? `<span class=\"fa-label\">${label}</span>` : ''}\n </span>`\n\n const body =\n ad.title || ad.desc\n ? `<span class=\"fa-body\">\n ${ad.title ? `<span class=\"fa-title\">${escapeHtml(ad.title)}</span>` : ''}\n ${ad.desc ? `<span class=\"fa-desc\">${escapeHtml(ad.desc)}</span>` : ''}\n </span>`\n : ''\n\n const inner = `${media}${body}`\n\n const href = ad.href ? safeHref(ad.href) : null\n if (href) {\n const target = ad.target === '_self' ? '_self' : '_blank'\n const rel =\n target === '_blank'\n ? ' rel=\"noopener noreferrer nofollow sponsored\"'\n : ' rel=\"nofollow sponsored\"'\n return `<a class=\"fa-item\" href=\"${escapeAttr(href)}\" target=\"${target}\"${rel} data-index=\"${index}\">${inner}</a>`\n }\n\n return `<div class=\"fa-item\" data-index=\"${index}\">${inner}</div>`\n }\n\n private readonly handleClose = (): void => {\n this.close()\n }\n\n private readonly handleImageError = (event: Event): void => {\n const img = event.target as HTMLElement | null\n if (!img || img.tagName !== 'IMG' || !img.classList.contains('fa-img')) return\n const media = img.closest('.fa-media')\n if (!media) return\n media.classList.add('fa-media--failed')\n const item = media.closest('.fa-item')\n if (item && !item.querySelector('.fa-body')) item.classList.add('fa-item--failed')\n }\n\n private readonly handleItemClick = (event: Event): void => {\n if (!this.opts.onClick) return\n const target = event.target as Element | null\n const item = target?.closest?.('.fa-item') as HTMLElement | null\n if (!item) return\n const index = Number(item.dataset.index)\n const ad = this.rendered[index]\n if (!ad) return\n this.opts.onClick(ad, event as MouseEvent)\n }\n}\n\nconst CLOSE_SVG =\n '<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" focusable=\"false\"><path d=\"M6 6l12 12M18 6L6 18\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"/></svg>'\n\n/** 过滤危险协议（javascript: / data: / vbscript: 等），返回可用链接或 null */\nfunction safeHref(href: string): string | null {\n const trimmed = href.trim()\n if (!trimmed) return null\n const compact = trimmed.replace(/[\\s\\u0000-\\u001f]/g, '').toLowerCase()\n if (/^(javascript|data|vbscript|file):/.test(compact)) return null\n return trimmed\n}\n\nfunction escapeHtml(value: string): string {\n return value\n .replace(/&/g, '&')\n .replace(/</g, '<')\n .replace(/>/g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''')\n}\n\nfunction escapeAttr(value: string): string {\n return escapeHtml(value)\n}\n"],"mappings":"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","names":[]}