@tienne/gestalt 0.99.0 → 0.101.0

package/dist/src/research/target-view.d.ts

@@ -0,0 +1,33 @@
+import type { BasisKind, EvidenceRef } from './evidence.js';
+import type { Research } from './schema.js';
+import { type Target } from './target.js';
+/** HTML과 Figma가 같은 칸을 그리도록 목표치 블록을 표 모양으로 펴 둔다 */
+export interface TargetCell {
+    text: string;
+    basis?: BasisKind;
+    evidence?: EvidenceRef[];
+    note?: string;
+    /** 칸 아래 작은 글씨 */
+    sub?: string;
+}
+export interface TargetView {
+    rows: [string, TargetCell][];
+    steps: {
+        label: string;
+        value: TargetCell;
+        method: string;
+    }[];
+    coverage?: string;
+    /** 가설을 다 성공해도 못 닿을 때 사용자와 고른 대응 */
+    shortfall?: string;
+    /** 가설, 기대 효과, 군당 표본, 걸리는 일수 칸과 기대 효과의 근거 칸 */
+    power: {
+        cells: string[];
+        liftBasis: TargetCell;
+    }[];
+    tracking: string[][];
+}
+export declare const TARGET_STEP_METHOD_LABEL: Record<Target['steps'][number]['method'], string>;
+export declare const TRACKING_STATUS_LABEL: Record<Target['trackingPlan'][number]['status'], string>;
+export declare function targetView(research: Research, shared: boolean): TargetView | undefined;
+//# sourceMappingURL=target-view.d.ts.map

package/dist/src/research/target-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-view.d.ts","sourceRoot":"","sources":["../../../src/research/target-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AAErB,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;IAC7B,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IACpD,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,CAOtF,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,CAI1F,CAAC;AAUF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CA+GtF"}

package/dist/src/research/target-view.js

@@ -0,0 +1,133 @@
+import { hypothesisPower, LIFT_METHOD_LABEL, liftCoverage, SHORTFALL_DECISION_LABEL, } from './target.js';
+export const TARGET_STEP_METHOD_LABEL = {
+    internal: '우리 데이터',
+    proxy: '비슷한 퍼널',
+    business: '사업 계획',
+    market: '시장 자료',
+    case: '타사 사례',
+    assumption: '가정',
+};
+export const TRACKING_STATUS_LABEL = {
+    exists: '있음',
+    missing: '없음',
+    planned: '심기로 함',
+};
+const DATA_SOURCE_LABEL = {
+    amplitude: 'Amplitude',
+    export: '내보낸 숫자',
+};
+const pp = (x) => `${x > 0 ? '+' : ''}${x}%p`;
+const people = (n) => `${n.toLocaleString('ko-KR')}명`;
+export function targetView(research, shared) {
+    const t = research.target;
+    if (!t)
+        return undefined;
+    const b = t.baseline;
+    const rows = [
+        ['목표 지표', { text: `${t.metric.name}: ${t.metric.denominator} 대비 ${t.metric.numerator}` }],
+        ['화면', { text: t.mode === 'new' ? '새로 만드는 화면' : '있는 화면 개선' }],
+        [
+            '기준값',
+            {
+                text: b.valuePct === undefined ? `못 구함 (${b.period})` : `${b.valuePct}% (${b.period})`,
+                basis: b.basis,
+                evidence: b.evidence,
+                ...(b.note ? { note: b.note } : {}),
+                ...(b.proxyOf ? { sub: `대신 쓴 퍼널: ${b.proxyOf}` } : {}),
+            },
+        ],
+    ];
+    const d = t.dailyEntrants;
+    if (d) {
+        rows.push([
+            '하루 진입 수',
+            {
+                text: people(d.value),
+                basis: d.basis,
+                evidence: d.evidence,
+                ...(d.note ? { note: d.note } : {}),
+                ...(d.derivation ? { sub: d.derivation } : {}),
+            },
+        ]);
+    }
+    if (t.weeklySpreadPp !== undefined) {
+        rows.push(['주별 변동', { text: `±${t.weeklySpreadPp}%p` }]);
+    }
+    if (t.trendPp !== undefined)
+        rows.push(['자연 추세', { text: pp(t.trendPp) }]);
+    if (t.range) {
+        const r = t.range;
+        rows.push([
+            '목표 범위',
+            { text: `보수 ${r.conservativePct}%, 기대 ${r.expectedPct}%, 도전 ${r.stretchPct}%` },
+        ]);
+    }
+    const ds = t.dataSource;
+    if (ds) {
+        const events = ds.events.map((x) => `${x.step}: ${x.event}`).join(', ');
+        const chart = ds.chartUrl && !shared ? ` ${ds.chartUrl}` : '';
+        rows.push([
+            '데이터 출처',
+            {
+                text: `${DATA_SOURCE_LABEL[ds.kind]} ${ds.project}, ${ds.from}부터 ${ds.to}까지${chart}`,
+                ...(events ? { sub: events } : {}),
+            },
+        ]);
+    }
+    const coverage = liftCoverage(research);
+    const power = hypothesisPower(research).map((p) => {
+        const lb = research.verification[p.index]?.liftBasis;
+        return {
+            cells: [
+                `가설 ${p.index + 1}`,
+                pp(p.liftPp),
+                Number.isFinite(p.nPerArm) ? people(p.nPerArm) : '계산 못함',
+                p.days === undefined ? '하루 진입 수 없음' : `${p.days}일`,
+            ],
+            liftBasis: lb
+                ? {
+                    text: LIFT_METHOD_LABEL[lb.method],
+                    basis: lb.basis,
+                    evidence: lb.evidence,
+                    ...(lb.note ? { note: lb.note } : {}),
+                }
+                : { text: '근거 없음', basis: 'absent' },
+        };
+    });
+    const sf = t.shortfall;
+    const shortfall = sf
+        ? [
+            `가설 합이 기대 목표에 모자라서 고른 대응은 '${SHORTFALL_DECISION_LABEL[sf.decision]}'이다.`,
+            sf.originalExpectedPct === undefined
+                ? ''
+                : `처음 기대 목표는 ${sf.originalExpectedPct}%였다.`,
+            sf.note,
+        ]
+            .filter(Boolean)
+            .join(' ')
+        : undefined;
+    return {
+        rows,
+        steps: t.steps.map((s) => ({
+            label: s.label,
+            value: {
+                text: s.value,
+                basis: s.basis,
+                evidence: s.evidence,
+                ...(s.note ? { note: s.note } : {}),
+            },
+            method: TARGET_STEP_METHOD_LABEL[s.method],
+        })),
+        ...(coverage
+            ? {
+                coverage: `가설을 다 성공하면 ${coverage.reachPct}%까지 간다. 기대 목표까지 시안으로 올려야 하는 몫은 ${coverage.neededPp}%p이고 가설 기대 효과의 합은 ${coverage.plannedPp}%p다. 효과가 겹칠 수 있어서 합은 많이 잡은 값이다.`,
+            }
+            : {}),
+        ...(shortfall ? { shortfall } : {}),
+        power,
+        tracking: t.trackingPlan
+            .filter((x) => x.status !== 'exists')
+            .map((x) => [x.event, x.step, TRACKING_STATUS_LABEL[x.status], x.note ?? '']),
+    };
+}
+//# sourceMappingURL=target-view.js.map

package/dist/src/research/target-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-view.js","sourceRoot":"","sources":["../../../src/research/target-view.ts"],"names":[],"mappings":"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"}