@funnelsgrove/cli 0.1.14 → 0.1.18

package/template_scaffold/docs/funnelsgrove/steps/value_prop_story.md

@@ -0,0 +1,110 @@
+# `value_prop_story`
+
+## Use when / do not use when
+
+Use for benefit, explanation, motivation, or narrative value. Do not use for testimonials, answer collection, loading, or an offer.
+
+## Exact metadata contract
+
+<!-- funnelsgrove:generated:start contract-v3/step/value_prop_story -->
+### Generated contract facts — do not edit
+
+- Step contract version: `3`
+- Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf`
+- Type: `value_prop_story`
+- Family: `content`
+- Description: Benefit, explanation, motivation, or narrative value screen.
+- Action owner: `shared-shell`
+- Analytics role: _none_
+- Terminal: `false`
+- Required kind: _none_
+- Allowed kinds: _None_
+- Allowed semantic events: _None_
+- Forbidden capabilities: `choice-write`, `email-capture`, `checkout`, `subscription-management`, `subscription-handoff`, `hardcoded-navigation`, `provider-direct-analytics`, `browser-registration-completed`
+
+#### Choice contract
+
+_Not a choice type._
+
+#### Automatic lifecycle events
+
+`first_step_clicked`, `first_step_viewed`, `funnel_started`, `step_completed`, `step_exited`, `step_started`
+
+#### Approved capability owners
+
+_No special capability is allowed._
+
+#### Reserved identities
+
+_No reserved identity for this type._
+
+#### Golden fixture source
+
+```ts
+import type { FunnelManifestStep, FunnelStepMeta } from '@funnelsgrove/runtime';
+
+const manifestStep = {
+  id: 'your-plan',
+  name: 'your-plan',
+  path: '/your-plan',
+  filePath: 'src/steps/step-your-plan.tsx',
+  componentKey: 'stepYourPlan',
+  type: 'value_prop_story',
+  title: 'Your plan',
+} as const satisfies FunnelManifestStep;
+
+const componentMeta = {
+  id: 'your-plan',
+  name: 'your-plan',
+  type: 'value_prop_story',
+  figmaNodeId: 'golden:value-prop-story',
+  title: 'Your plan',
+  description: 'Narrative explanation of the product value.',
+} as const satisfies FunnelStepMeta;
+
+export const goldenFixture = {
+  stepType: 'value_prop_story',
+  manifestStep,
+  componentMeta,
+  actionOwner: 'shared-shell',
+} as const;
+```
+<!-- funnelsgrove:generated:end contract-v3/step/value_prop_story -->
+
+## Interaction and persisted answer shape
+
+This is a content screen and normally persists no answer. The shared shell owns standard progression.
+
+## Automatic lifecycle events
+
+The flow controller owns lifecycle events and suppresses them in preview.
+
+## Required semantic conversions
+
+None.
+
+## Approved shared helpers
+
+Use shared content and action-bar primitives. Use manifest routing for progression.
+
+## MUST rules
+
+- Keep one clear narrative purpose.
+- Keep manifest and component metadata in parity.
+
+## NEVER rules
+
+- Never classify a reveal or calculation screen as a value story.
+- Never send provider analytics directly.
+
+## Golden template or fixture
+
+See the [embedded canonical fixture](#golden-fixture-source) generated from `value_prop_story.fixture.ts`.
+
+## Validation command
+
+Run `fgrove validate`.
+
+## Manual QA and completion criteria
+
+Confirm content renders at all supported breakpoints and the shared action advances to the manifest-resolved target.

package/template_scaffold/docs/references/funnel-sdk-user-answers.md

@@ -0,0 +1,5 @@
+# Compatibility: funnel SDK user answers
+
+Use the canonical [content and answers contract](../funnelsgrove/contracts/content-answers.md).
+
+This compatibility page intentionally contains no copied answer-key or choice-shape rules.

package/template_scaffold/eslint.config.mjs

@@ -0,0 +1,16 @@
+import { defineConfig, globalIgnores } from 'eslint/config';
+import nextVitals from 'eslint-config-next/core-web-vitals';
+import nextTs from 'eslint-config-next/typescript';
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  globalIgnores(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']),
+  {
+    rules: {
+      // The shared flow controller syncs runtime state machines inside
+      // effects by design; react-hooks >= 7 escalates this to an error.
+      'react-hooks/set-state-in-effect': 'warn',
+    },
+  },
+]);