@pcampus/reward-widget 0.1.0 → 0.2.0

package/README.md

@@ -18,12 +18,13 @@ secrets, coupon codes, or authoritative server logic.
 
 ## Status
 
-Initial public scaffold. Component exports and registry publishing will be added
-in the next implementation phase.
+Public UI catalog for `spin`, `scratch`, `pick-card`, `mystery-box`, and `quiz`.
+Presentation matches the Merchant Portal preview package. This package is still
+UI-only: no draw, claims, or campaign APIs.
 
 ## Public support matrix
 
-The UI catalog targets `spin`, `scratch`, `pick-card`, `mystery-box`, `slot`,
+The UI catalog targets `spin`, `scratch`, `pick-card`, `mystery-box`,
 and `quiz`. This package exports presentation primitives, theme configuration,
 and public types only. Reward service APIs, server-side authority, claims,
 webhooks, secrets, and coupon data remain outside the package.
@@ -49,7 +50,29 @@ const html = renderRewardWidgetMarkup({
 });
 ```
 
-### Client DOM Mount
+### Interactive widgets (player chrome)
+
+```typescript
+import { mountInteractiveWidget } from '@pcampus/reward-widget';
+
+const root = document.getElementById('widget-root');
+mountInteractiveWidget(root, {
+  widgetType: 'pick-card',
+  rewards: [
+    { name: 'ส่วนลด 100 บาท', weight: 40 },
+    { name: 'Lucky Bonus', weight: 30 },
+    { name: '100 Points', weight: 20 },
+  ],
+  theme: { brandPrimaryColor: '#4b7fd4' },
+});
+```
+
+SSR equivalent: `renderInteractiveWidgetMarkup({ widgetType, rewards, theme })`.
+Per-type helpers: `renderSpinWheelMarkup` / `mountSpinWheel`, and the same pattern for scratch, pick-card, mystery-box, and quiz.
+
+Open `examples/interactive-catalog.html` via a local static server to view all five types.
+
+### Client DOM Mount (chrome shell)
 
 ```typescript
 import { mountRewardWidget } from '@pcampus/reward-widget';

package/dist/index.d.ts

@@ -8,9 +8,13 @@ export type RewardWidgetTheme = {
     pageBackgroundColor?: string;
     wheelBorderColor?: string;
     sliceColors?: readonly string[];
+    hubBackgroundColor?: string;
+    textColor?: string;
+    promptColor?: string;
+    buttonTextColor?: string;
 };
 export { mountRewardWidget, renderRewardWidgetMarkup } from "./components.js";
 export type { RewardWidgetProps, RewardWidgetState } from "./components.js";
-export { createRewardWidgetTheme, defaultRewardWidgetTheme, rewardWidgetThemeCss, } from "./theme.js";
+export { createRewardWidgetTheme, defaultRewardWidgetTheme, pcampusStudioDarkTheme, rewardWidgetThemeCss, pcampusStudioThemeCss, } from "./theme.js";
 export type { RewardWidgetThemeTokens } from "./theme.js";
 export * from "./widgets/index.js";

package/dist/index.js

@@ -6,5 +6,5 @@ export const WIDGET_TYPES = [
     "quiz",
 ];
 export { mountRewardWidget, renderRewardWidgetMarkup } from "./components.js";
-export { createRewardWidgetTheme, defaultRewardWidgetTheme, rewardWidgetThemeCss, } from "./theme.js";
+export { createRewardWidgetTheme, defaultRewardWidgetTheme, pcampusStudioDarkTheme, rewardWidgetThemeCss, pcampusStudioThemeCss, } from "./theme.js";
 export * from "./widgets/index.js";

package/dist/theme.d.ts

@@ -13,6 +13,11 @@ export type RewardWidgetThemeTokens = {
     spacing: string;
     motion: string;
 };
+/** Default Pcampus Studio Light Theme Tokens */
 export declare const defaultRewardWidgetTheme: RewardWidgetThemeTokens;
+/** Official @pcampus-studio/ui Dark Theme Tokens */
+export declare const pcampusStudioDarkTheme: RewardWidgetThemeTokens;
 export declare function createRewardWidgetTheme(overrides?: Partial<RewardWidgetThemeTokens>): RewardWidgetThemeTokens;
 export declare function rewardWidgetThemeCss(overrides?: Partial<RewardWidgetThemeTokens>): string;
+/** Generates CSS custom properties matching @pcampus-studio/ui design system */
+export declare function pcampusStudioThemeCss(mode?: "light" | "dark"): string;

package/dist/theme.js

@@ -1,3 +1,4 @@
+/** Default Pcampus Studio Light Theme Tokens */
 export const defaultRewardWidgetTheme = {
     primary: "#2952a3",
     primaryHover: "#1e3a8a",
@@ -13,6 +14,22 @@ export const defaultRewardWidgetTheme = {
     spacing: "1rem",
     motion: "160ms",
 };
+/** Official @pcampus-studio/ui Dark Theme Tokens */
+export const pcampusStudioDarkTheme = {
+    primary: "#4b7fd4",
+    primaryHover: "#6b9fe4",
+    surface: "#1c1c1b",
+    background: "#1a1a19",
+    border: "rgba(240, 239, 237, 0.14)",
+    focus: "#e8a96a",
+    disabled: "#6a6a67",
+    warning: "#d4884d",
+    blocked: "#e74c3c",
+    success: "#3dab6a",
+    radius: "1rem",
+    spacing: "1rem",
+    motion: "160ms",
+};
 export function createRewardWidgetTheme(overrides = {}) {
     return { ...defaultRewardWidgetTheme, ...overrides };
 }
@@ -20,3 +37,10 @@ export function rewardWidgetThemeCss(overrides = {}) {
     const theme = createRewardWidgetTheme(overrides);
     return `:root{--pcampus-widget-primary:${theme.primary};--pcampus-widget-primary-hover:${theme.primaryHover};--pcampus-widget-surface:${theme.surface};--pcampus-widget-background:${theme.background};--pcampus-widget-border:${theme.border};--pcampus-widget-focus:${theme.focus};--pcampus-widget-disabled:${theme.disabled};--pcampus-widget-warning:${theme.warning};--pcampus-widget-blocked:${theme.blocked};--pcampus-widget-success:${theme.success};--pcampus-widget-radius:${theme.radius};--pcampus-widget-spacing:${theme.spacing};--pcampus-widget-motion:${theme.motion}}`;
 }
+/** Generates CSS custom properties matching @pcampus-studio/ui design system */
+export function pcampusStudioThemeCss(mode = "dark") {
+    if (mode === "dark") {
+        return `:root{--pcampus-color-primary:#4b7fd4;--pcampus-color-primary-hover:#6b9fe4;--pcampus-color-accent:#d4884d;--pcampus-color-accent-light:#e8a96a;--pcampus-color-success:#3dab6a;--pcampus-color-error:#e74c3c;--pcampus-color-neutral:#6b7a9e;--pcampus-color-surface:#0f0f0e;--pcampus-color-surface-subtle:#1a1a19;--pcampus-color-surface-card:#1c1c1b;--pcampus-color-text:#f0efed;--pcampus-color-text-secondary:#a8a8a5;--pcampus-color-border:rgba(240,239,237,0.08);--pcampus-color-border-strong:rgba(240,239,237,0.16);--pcampus-font-sans:-apple-system,BlinkMacSystemFont,"Inter",sans-serif;}`;
+    }
+    return `:root{--pcampus-color-primary:#2952a3;--pcampus-color-primary-hover:#4b7fd4;--pcampus-color-accent:#c87533;--pcampus-color-accent-light:#e8a96a;--pcampus-color-success:#2a7a4b;--pcampus-color-error:#c0392b;--pcampus-color-neutral:#8f9bb3;--pcampus-color-surface:#f9f8f6;--pcampus-color-surface-subtle:#f3f2ef;--pcampus-color-surface-card:#ffffff;--pcampus-color-text:#0d0d0c;--pcampus-color-text-secondary:#4a4a48;--pcampus-color-border:rgba(13,13,12,0.08);--pcampus-color-border-strong:rgba(13,13,12,0.16);--pcampus-font-sans:-apple-system,BlinkMacSystemFont,"Inter",sans-serif;}`;
+}

package/dist/widgets/chrome.d.ts

@@ -0,0 +1,13 @@
+import type { RewardWidgetTheme } from "../index.js";
+export declare const DEFAULT_WIDGET_PRIMARY = "#4b7fd4";
+export declare const DEFAULT_WIDGET_SURFACE = "#1c1c1b";
+export declare const DEFAULT_WIDGET_BORDER = "rgba(240, 239, 237, 0.14)";
+/** Shared merchant chrome: Primary / page background / widget border. */
+export declare function resolveWidgetChrome(theme?: RewardWidgetTheme): {
+    primary: string;
+    surface: string;
+    border: string;
+};
+export declare function mixPrimary(primary: string, percent: number): string;
+export declare function parseHexRgb(hex: string): [number, number, number] | null;
+export declare function scaleRgb(rgb: [number, number, number], factor: number): string;

package/dist/widgets/chrome.js

@@ -0,0 +1,25 @@
+export const DEFAULT_WIDGET_PRIMARY = "#4b7fd4";
+export const DEFAULT_WIDGET_SURFACE = "#1c1c1b";
+export const DEFAULT_WIDGET_BORDER = "rgba(240, 239, 237, 0.14)";
+/** Shared merchant chrome: Primary / page background / widget border. */
+export function resolveWidgetChrome(theme) {
+    const primary = theme?.brandPrimaryColor?.trim() || DEFAULT_WIDGET_PRIMARY;
+    const surface = theme?.pageBackgroundColor?.trim() || DEFAULT_WIDGET_SURFACE;
+    const explicitBorder = theme?.wheelBorderColor?.trim();
+    const border = explicitBorder ||
+        (theme?.brandPrimaryColor?.trim() ? primary : DEFAULT_WIDGET_BORDER);
+    return { primary, surface, border };
+}
+export function mixPrimary(primary, percent) {
+    return `color-mix(in srgb, ${primary} ${percent}%, transparent)`;
+}
+export function parseHexRgb(hex) {
+    const match = hex.trim().replace("#", "").match(/^([0-9a-f]{6})$/i);
+    if (!match)
+        return null;
+    const value = Number.parseInt(match[1], 16);
+    return [(value >> 16) & 255, (value >> 8) & 255, value & 255];
+}
+export function scaleRgb(rgb, factor) {
+    return `rgb(${rgb.map((channel) => Math.max(0, Math.min(255, Math.round(channel * factor)))).join(",")})`;
+}

package/dist/widgets/coupon-success.d.ts

@@ -0,0 +1,13 @@
+export type CouponSuccessPayload = {
+    rewardName: string;
+    couponCode?: string | null;
+};
+/**
+ * Locked G-042 style: D (left stub + big prize) + A (transparent tear cutouts via mask).
+ */
+export declare function couponSuccessCss(): string;
+export declare function couponSuccessCardHtml(payload: CouponSuccessPayload): string;
+/**
+ * Show shared coupon-shaped success overlay with puff. Dismiss via OK/close only.
+ */
+export declare function showCouponSuccess(payload: CouponSuccessPayload): void;

package/dist/widgets/coupon-success.js

@@ -0,0 +1,256 @@
+import { textEscape } from "./types.js";
+/** SVG mask: ticket rect with true transparent scallop / bite cutouts (evenodd). */
+const COUPON_TEAR_MASK = encodeURIComponent(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 160" preserveAspectRatio="none">` +
+    `<path fill="white" fill-rule="evenodd" d="` +
+    `M0 0H400V160H0Z` +
+    /* center bites — full circles on left/right edges */
+    `M0 80m-13 0a13 13 0 1 0 26 0a13 13 0 1 0-26 0` +
+    `M400 80m-13 0a13 13 0 1 0 26 0a13 13 0 1 0-26 0` +
+    /* left scallops */
+    `M0 18m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    `M0 42m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    `M0 118m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    `M0 142m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    /* right scallops */
+    `M400 18m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    `M400 42m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    `M400 118m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    `M400 142m-7.5 0a7.5 7.5 0 1 0 15 0a7.5 7.5 0 1 0-15 0` +
+    `"/></svg>`);
+/**
+ * Locked G-042 style: D (left stub + big prize) + A (transparent tear cutouts via mask).
+ */
+export function couponSuccessCss() {
+    return `
+.pcampus-coupon-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 100000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 1.25rem;
+  background: rgba(13, 13, 12, 0.62);
+  box-sizing: border-box;
+}
+.pcampus-coupon-shell {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 1rem;
+  width: min(100%, 26rem);
+  animation: pcampus-coupon-puff 0.55s cubic-bezier(0.175, 0.885, 0.32, 1.275) both;
+}
+@keyframes pcampus-coupon-puff {
+  0% { transform: scale(0.72) rotate(-1.5deg); opacity: 0; filter: blur(2px); }
+  55% { transform: scale(1.05) rotate(0.4deg); opacity: 1; filter: blur(0); }
+  100% { transform: scale(1) rotate(0deg); opacity: 1; filter: blur(0); }
+}
+@media (prefers-reduced-motion: reduce) {
+  .pcampus-coupon-shell {
+    animation: pcampus-coupon-fade 0.2s ease both;
+  }
+  @keyframes pcampus-coupon-fade {
+    from { opacity: 0; }
+    to { opacity: 1; }
+  }
+}
+.pcampus-coupon-ticket {
+  position: relative;
+  display: flex;
+  width: 100%;
+  min-height: 9.75rem;
+  background: #fff;
+  filter: drop-shadow(0 18px 28px rgba(15, 23, 42, 0.4));
+  -webkit-mask-image: url("data:image/svg+xml,${COUPON_TEAR_MASK}");
+  mask-image: url("data:image/svg+xml,${COUPON_TEAR_MASK}");
+  -webkit-mask-size: 100% 100%;
+  mask-size: 100% 100%;
+  -webkit-mask-repeat: no-repeat;
+  mask-repeat: no-repeat;
+  -webkit-mask-position: center;
+  mask-position: center;
+}
+.pcampus-coupon-stub {
+  flex: 0 0 3.35rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: linear-gradient(180deg, #1e40af 0%, #1e3a8a 100%);
+  color: #eff6ff;
+}
+.pcampus-coupon-stub-label {
+  writing-mode: vertical-rl;
+  transform: rotate(180deg);
+  font-size: 0.7rem;
+  font-weight: 800;
+  letter-spacing: 0.18em;
+  text-transform: uppercase;
+}
+.pcampus-coupon-perforation {
+  flex: 0 0 12px;
+  background:
+    repeating-linear-gradient(
+      180deg,
+      transparent 0 6px,
+      #93c5fd 6px 8px
+    ),
+    #fff;
+  border-left: 1px dashed #60a5fa;
+  border-right: 1px dashed #60a5fa;
+}
+.pcampus-coupon-body {
+  position: relative;
+  flex: 1 1 auto;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  gap: 0.3rem;
+  padding: 1rem 1.15rem 0.9rem 1rem;
+  background: #fff;
+  border: 2px dotted #60a5fa;
+  border-left: none;
+  margin: 0.45rem 0.55rem 0.45rem 0;
+  border-radius: 0 10px 10px 0;
+  box-sizing: border-box;
+}
+.pcampus-coupon-pill {
+  display: inline-flex;
+  align-self: flex-start;
+  background: #1e3a8a;
+  color: #fff;
+  font-size: 0.62rem;
+  font-weight: 800;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  padding: 0.22rem 0.55rem;
+  border-radius: 9999px;
+}
+.pcampus-coupon-prize {
+  font-size: 1.55rem;
+  font-weight: 900;
+  color: #1d4ed8;
+  line-height: 1.15;
+  word-break: break-word;
+}
+.pcampus-coupon-sub {
+  font-size: 0.82rem;
+  font-weight: 700;
+  color: #1e3a8a;
+}
+.pcampus-coupon-code-wrap {
+  margin-top: 0.2rem;
+}
+.pcampus-coupon-code-label {
+  font-size: 0.62rem;
+  font-weight: 700;
+  color: #64748b;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+.pcampus-coupon-code {
+  margin-top: 0.15rem;
+  display: inline-block;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  font-size: 0.98rem;
+  font-weight: 800;
+  letter-spacing: 0.12em;
+  color: #1e3a8a;
+  background: #eff6ff;
+  border: 1px dashed #60a5fa;
+  padding: 0.25rem 0.5rem;
+  border-radius: 6px;
+  word-break: break-all;
+}
+.pcampus-coupon-footer {
+  font-size: 0.68rem;
+  color: #64748b;
+  font-weight: 500;
+  margin-top: 0.15rem;
+}
+.pcampus-coupon-close {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 7.5rem;
+  padding: 0.6rem 1.35rem;
+  font-size: 0.92rem;
+  font-weight: 700;
+  color: #fff;
+  background: #1e3a8a;
+  border: none;
+  border-radius: 9999px;
+  cursor: pointer;
+  box-shadow: 0 8px 20px rgba(0, 0, 0, 0.28);
+}
+.pcampus-coupon-close:hover {
+  background: #1e40af;
+}
+.pcampus-coupon-close:focus-visible {
+  outline: 2px solid #93c5fd;
+  outline-offset: 2px;
+}
+`.trim();
+}
+export function couponSuccessCardHtml(payload) {
+    const name = textEscape(payload.rewardName);
+    const code = payload.couponCode?.trim();
+    const codeBlock = code
+        ? `<div class="pcampus-coupon-code-wrap">
+        <div class="pcampus-coupon-code-label">รหัสคูปอง</div>
+        <div class="pcampus-coupon-code">${textEscape(code)}</div>
+      </div>`
+        : "";
+    return `
+    <div class="pcampus-coupon-shell">
+      <div class="pcampus-coupon-ticket" role="dialog" aria-modal="true" aria-label="คูปองรางวัล">
+        <div class="pcampus-coupon-stub">
+          <span class="pcampus-coupon-stub-label">COUPON</span>
+        </div>
+        <div class="pcampus-coupon-perforation" aria-hidden="true"></div>
+        <div class="pcampus-coupon-body">
+          <span class="pcampus-coupon-pill">Reward Coupon</span>
+          <div class="pcampus-coupon-prize">${name}</div>
+          <div class="pcampus-coupon-sub">คุณได้รับรางวัลนี้</div>
+          ${codeBlock}
+          <div class="pcampus-coupon-footer">เก็บไว้ใช้ตามเงื่อนไขของร้านค้า</div>
+        </div>
+      </div>
+      <button type="button" class="pcampus-coupon-close">ปิด</button>
+    </div>
+  `.trim();
+}
+function ensureCouponStyles() {
+    if (typeof document === "undefined")
+        return;
+    const id = "pcampus-coupon-success-css-v4";
+    for (const old of [
+        "pcampus-coupon-success-css",
+        "pcampus-coupon-success-css-v2",
+        "pcampus-coupon-success-css-v3",
+    ]) {
+        document.getElementById(old)?.remove();
+    }
+    let style = document.getElementById(id);
+    if (!style) {
+        style = document.createElement("style");
+        style.id = id;
+        document.head.appendChild(style);
+    }
+    style.textContent = couponSuccessCss();
+}
+/**
+ * Show shared coupon-shaped success overlay with puff. Dismiss via OK/close only.
+ */
+export function showCouponSuccess(payload) {
+    if (typeof document === "undefined" || !payload.rewardName.trim())
+        return;
+    ensureCouponStyles();
+    document.querySelector(".pcampus-coupon-overlay")?.remove();
+    const overlay = document.createElement("div");
+    overlay.className = "pcampus-coupon-overlay";
+    overlay.innerHTML = couponSuccessCardHtml(payload);
+    const close = () => overlay.remove();
+    overlay.querySelector(".pcampus-coupon-close")?.addEventListener("click", close);
+    document.body.appendChild(overlay);
+}

package/dist/widgets/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./types.js";
+export * from "./coupon-success.js";
 export * from "./spin.js";
 export * from "./scratch.js";
 export * from "./pick-card.js";

package/dist/widgets/index.js

@@ -1,4 +1,5 @@
 export * from "./types.js";
+export * from "./coupon-success.js";
 export * from "./spin.js";
 export * from "./scratch.js";
 export * from "./pick-card.js";
@@ -10,7 +11,7 @@ import { renderPickCardMarkup, mountPickCard } from "./pick-card.js";
 import { renderMysteryBoxMarkup, mountMysteryBox } from "./mystery-box.js";
 import { renderQuizMarkup, mountQuiz } from "./quiz.js";
 export function renderInteractiveWidgetMarkup(options) {
-    const { widgetType, rewards = [], theme } = options;
+    const { widgetType, rewards = [], theme, quiz } = options;
     switch (widgetType) {
         case "spin":
             return renderSpinWheelMarkup(rewards, theme);
@@ -21,13 +22,13 @@ export function renderInteractiveWidgetMarkup(options) {
         case "mystery-box":
             return renderMysteryBoxMarkup(rewards, theme);
         case "quiz":
-            return renderQuizMarkup(rewards, theme);
+            return renderQuizMarkup(rewards, theme, quiz);
         default:
             return `<div class="pcampus-unknown-widget">Unsupported widget type: ${widgetType}</div>`;
     }
 }
 export function mountInteractiveWidget(target, options) {
-    const { widgetType, rewards = [], theme, onAction } = options;
+    const { widgetType, rewards = [], theme, quiz, onAction, onQuizComplete } = options;
     switch (widgetType) {
         case "spin":
             mountSpinWheel(target, rewards, theme, onAction);
@@ -42,7 +43,7 @@ export function mountInteractiveWidget(target, options) {
             mountMysteryBox(target, rewards, theme, onAction);
             break;
         case "quiz":
-            mountQuiz(target, rewards, theme, onAction);
+            mountQuiz(target, rewards, theme, onAction, quiz, onQuizComplete);
             break;
         default:
             target.innerHTML = `<div class="pcampus-unknown-widget">Unsupported widget type: ${widgetType}</div>`;