@hagicode/hagilight-core 0.7.1-dev.80.1.bc52dbd → 0.7.1-dev.81.1.e4c95c7

package/README.md

@@ -35,6 +35,10 @@ import { resolveSiteLinks } from '@hagicode/hagilight-core/links';
 const links = resolveSiteLinks('en-US');
 ```
 
+## Promotion platforms
+
+The shared banner (`PromotoBanner`, `loadActivePromotions`) displays only promotions whose `platforms` array in Index's `/promote.json` includes `web`, in addition to being enabled, inside their activation window, and matched with `/promote_content.json`. This follows the `platforms` flag documented in the Index README. An entry whose `platforms` is missing, empty, or not an array of strings is not displayed, other values such as `hagicode` are ignored, and matching is exact (`Web` does not match). When no promotion remains, the banner shows its site fallback or stays hidden, as before.
+
 ## Google Analytics click events
 
 `GoogleAnalytics` also reports clicks on the key links and download buttons that the shared components render. There is nothing to configure: events follow the same rules as page views, so they are sent only on production pages where Google Analytics is enabled, never on the Starlight 404 page, and silently skipped when `gtag` is missing (development builds, blocked scripts).

package/dist/promotions.d.ts

@@ -19,6 +19,7 @@ interface PromotionFlag {
     on: boolean;
     startTime?: string;
     endTime?: string;
+    platforms: string[];
 }
 interface PromotionContent {
     id: string;

package/dist/promotions.js

@@ -2,6 +2,7 @@ const INDEX_ORIGIN = 'https://index.hagicode.com';
 const CATALOG_URL = `${INDEX_ORIGIN}/index-catalog.json`;
 const FLAGS_URL = `${INDEX_ORIGIN}/promote.json`;
 const CONTENT_URL = `${INDEX_ORIGIN}/promote_content.json`;
+const DISPLAY_PLATFORM = 'web';
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -65,6 +66,9 @@ function isSafeLink(value) {
         return false;
     }
 }
+function parsePlatforms(value) {
+    return Array.isArray(value) && value.every((platform) => typeof platform === 'string') ? value : [];
+}
 export function parsePromotionFlags(payload) {
     if (!isRecord(payload) || !Array.isArray(payload.promotes))
         return [];
@@ -76,6 +80,7 @@ export function parsePromotionFlags(payload) {
                 on: item.on,
                 startTime: nonEmptyString(item.startTime) ? item.startTime.trim() : undefined,
                 endTime: nonEmptyString(item.endTime) ? item.endTime.trim() : undefined,
+                platforms: parsePlatforms(item.platforms),
             }];
     });
 }
@@ -147,7 +152,7 @@ export function normalizeActivePromotions(flags, content, locale, now = Date.now
     const contentById = new Map(content.map((item) => [item.id, item]));
     return flags.flatMap((flag) => {
         const item = contentById.get(flag.id);
-        if (!isActive(flag, now) || !item)
+        if (!isActive(flag, now) || !flag.platforms?.includes(DISPLAY_PLATFORM) || !item)
             return [];
         const title = localized(item.title, locale);
         const description = localized(item.description, locale);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/hagilight-core",
-  "version": "0.7.1-dev.80.1.bc52dbd",
+  "version": "0.7.1-dev.81.1.e4c95c7",
   "type": "module",
   "description": "Shared TypeScript utilities, components, and assets for HagiCode Astro and Starlight sites",
   "repository": {