@flickfyi/flkr 0.0.182 → 0.0.185

package/node_modules/@flickfyi/core/examples/kowalski/goal/goal.stories.tsx

@@ -1,15 +1,28 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { GoalData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+import type { z } from 'zod/v4'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
 
 import GoalExample from './goal'
 import exampleSource from './goal.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = GoalData.strip().transform(data => ({ data }))
 const meta = {
-	component: GoalExample,
+	argTypes: schemaArgTypes(GoalData),
+	args: { progress: 3, step: 1, target: 12, title: 'Make room to read', unit: 'books' },
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <GoalExample {...storyProps.parse(args)} />,
 	title: 'Kowalski/Goal',
-} satisfies Meta<typeof GoalExample>
+} satisfies Meta<z.input<typeof storyProps>>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {
-	args: { enabledForAgents: false },
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'An instantiatable Goal from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Goal',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/goal/goal.tsx

@@ -1,24 +1,8 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { Goal } from '@flickfyi/core/kowalski'
+import { Goal, type GoalProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function GoalExample() {
+export default function GoalExample({ data, style }: Pick<GoalProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<Goal
-			progress={3}
-			target={12}
-			title="Make room to read"
-			unit="books"
-		/>
-	)
+	return <Goal data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable Goal from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'Goal',
-} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/kowalski/habit/habit.stories.tsx

@@ -1,15 +1,32 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { HabitData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+import type { z } from 'zod/v4'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
 
 import HabitExample from './habit'
 import exampleSource from './habit.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = HabitData.strip().transform(data => ({ data }))
 const meta = {
-	component: HabitExample,
+	argTypes: schemaArgTypes(HabitData),
+	args: {
+		timeZone: 'America/Los_Angeles',
+		title: 'Read a few pages',
+		weekdays: ['monday', 'tuesday', 'wednesday', 'thursday', 'friday'],
+	},
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <HabitExample {...storyProps.parse(args)} />,
 	title: 'Kowalski/Habit',
-} satisfies Meta<typeof HabitExample>
+} satisfies Meta<z.input<typeof storyProps>>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {
-	args: { enabledForAgents: false },
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'An instantiatable Habit from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Habit',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/habit/habit.tsx

@@ -1,23 +1,11 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { Habit } from '@flickfyi/core/kowalski'
+import { Habit, type HabitProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function HabitExample() {
+export default function HabitExample({
+	data,
+	style,
+}: Pick<HabitProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<Habit
-			timeZone="America/Los_Angeles"
-			title="Read a few pages"
-			weekdays={['monday', 'tuesday', 'wednesday', 'thursday', 'friday']}
-		/>
-	)
+	return <Habit data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable Habit from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'Habit',
-} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/kowalski/ledger/ledger.stories.tsx

@@ -1,15 +1,35 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { LedgerData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+import type { z } from 'zod/v4'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
 
 import LedgerExample from './ledger'
 import exampleSource from './ledger.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = LedgerData.strip().transform(data => ({ data }))
 const meta = {
-	component: LedgerExample,
+	argTypes: schemaArgTypes(LedgerData),
+	args: {
+		currency: 'USD',
+		people: [
+			{ id: 'sam', label: 'Sam' },
+			{ id: 'riley', label: 'Riley' },
+		],
+		title: 'Apartment tab',
+	},
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <LedgerExample {...storyProps.parse(args)} />,
 	title: 'Kowalski/Ledger',
-} satisfies Meta<typeof LedgerExample>
+} satisfies Meta<z.input<typeof storyProps>>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {
-	args: { enabledForAgents: false },
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'An instantiatable Ledger from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Ledger',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/ledger/ledger.tsx

@@ -1,25 +1,11 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { Ledger } from '@flickfyi/core/kowalski'
+import { Ledger, type LedgerProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function LedgerExample() {
+export default function LedgerExample({
+	data,
+	style,
+}: Pick<LedgerProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<Ledger
-			people={[
-				{ id: 'sam', label: 'Sam' },
-				{ id: 'riley', label: 'Riley' },
-			]}
-			title="Apartment tab"
-		/>
-	)
+	return <Ledger data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable Ledger from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'Ledger',
-} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/kowalski/lesson/lesson.stories.tsx

@@ -0,0 +1,99 @@
+import { LessonData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
+
+import LessonExample from './lesson'
+import exampleSource from './lesson.tsx?raw'
+
+const storyProps = LessonData.strip().transform(data => ({ data }))
+const meta = {
+	argTypes: schemaArgTypes(LessonData),
+	args: {
+		hasPart: [
+			{
+				acceptedAnswer: [
+					{
+						answerExplanation:
+							'It’s before noon, so “buenos días” is the right greeting.',
+						text: 'Buenos días',
+					},
+				],
+				assesses: 'time-of-day',
+				eduQuestionType: 'Multiple choice',
+				id: 'morning',
+				suggestedAnswer: [
+					{ comment: '“Buenas noches” is for after dark.', text: 'Buenas noches' },
+					{ comment: '“Buenas tardes” starts around noon.', text: 'Buenas tardes' },
+				],
+				text: 'It’s 9 AM. How do you greet your neighbor?',
+			},
+			{
+				acceptedAnswer: [
+					{
+						answerExplanation:
+							'After dark, “buenas noches” works as both “good evening” and “good night.”',
+						text: 'Buenas noches',
+					},
+				],
+				assesses: 'time-of-day',
+				eduQuestionType: 'Flashcard',
+				id: 'night',
+				suggestedAnswer: [],
+				text: 'What do you say arriving at a dinner party at 10 PM?',
+			},
+			{
+				acceptedAnswer: [
+					{
+						answerExplanation:
+							'A new teacher is someone you show respect to, so use “usted.”',
+						text: 'Your new teacher',
+					},
+					{
+						answerExplanation:
+							'Use “usted” with strangers, like someone you ask for directions.',
+						text: 'A stranger on the street',
+					},
+				],
+				assesses: 'tu-usted',
+				eduQuestionType: 'Checkbox',
+				id: 'usted',
+				suggestedAnswer: [
+					{ comment: 'Use “tú” with family.', text: 'Your little sister' },
+					{ comment: 'Use “tú” with friends.', text: 'Your best friend' },
+				],
+				text: 'Who would you call “usted”?',
+			},
+		],
+		teaches: [
+			{
+				description:
+					'Spanish greetings change with the time of day. Use “buenos días” until about noon, “buenas tardes” until dark, and “buenas noches” after dark, as both hello and good night.',
+				examples: [{ name: 'Buenos días', value: 'Morning, until about noon' }, { name: 'Buenas tardes', value: 'Afternoon, until dark' }, { name: 'Buenas noches', value: 'Evening and night' }],
+				id: 'time-of-day',
+				name: 'Greetings by time of day',
+			},
+			{
+				description:
+					'Spanish has two words for “you.” Use “tú” with friends, family, and children. Use “usted” with people you don’t know well or want to show respect to.',
+				examples: [{ name: '¿Cómo estás?', value: 'To a friend' }, { name: '¿Cómo está usted?', value: 'To a teacher' }],
+				id: 'tu-usted',
+				name: 'Tú or usted',
+			},
+		],
+		title: 'Spanish greetings',
+	},
+	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <LessonExample {...storyProps.parse(args)} />,
+	title: 'Kowalski/Lesson',
+} satisfies Meta<LessonData>
+
+export default meta
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'A short Duolingo-style lesson that teaches a few ideas one at a time, each followed by multiple-choice, select-all, or flashcard questions on it. Checks each answer with an explanation and feedback on the wrong choice, reviews missed questions at the end with the idea retaught, shows progress per idea, and saves progress. For language practice, rules of a game or sport, study topics, trivia, and any "teach me" or "quiz me" request. The model writes the teaching and questions; the component does not generate new questions at runtime.',
+		enabled: true,
+		name: 'Lesson',
+	},
+}

package/node_modules/@flickfyi/core/examples/kowalski/lesson/lesson.tsx

@@ -0,0 +1,11 @@
+import { useTheme } from '@flickfyi/core'
+import { theme } from '@flickfyi/core/examples/kowalski/theme'
+import { Lesson, type LessonProps } from '@flickfyi/core/kowalski'
+
+export default function LessonExample({
+	data,
+	style,
+}: Pick<LessonProps, 'data' | 'style'>) {
+	useTheme(theme)
+	return <Lesson data={data} style={style} />
+}

package/node_modules/@flickfyi/core/examples/kowalski/note/note.stories.tsx

@@ -1,15 +1,31 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { NoteData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+import type { z } from 'zod/v4'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
 
 import NoteExample from './note'
 import exampleSource from './note.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = NoteData.strip().transform(data => ({ data }))
 const meta = {
-	component: NoteExample,
+	argTypes: schemaArgTypes(NoteData),
+	args: {
+		body: 'Make the next step obvious.\n\nLeave enough room for the thing that matters.',
+		title: 'A thought worth keeping',
+	},
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <NoteExample {...storyProps.parse(args)} />,
 	title: 'Kowalski/Note',
-} satisfies Meta<typeof NoteExample>
+} satisfies Meta<z.input<typeof storyProps>>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {
-	args: { enabledForAgents: false },
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'An instantiatable Note from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Note',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/note/note.tsx

@@ -1,22 +1,8 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { Note } from '@flickfyi/core/kowalski'
+import { Note, type NoteProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function NoteExample() {
+export default function NoteExample({ data, style }: Pick<NoteProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<Note
-			body={'Make the next step obvious.\n\nLeave enough room for the thing that matters.'}
-			title="A thought worth keeping"
-		/>
-	)
+	return <Note data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable Note from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'Note',
-} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/kowalski/poll/poll.stories.tsx

@@ -1,15 +1,36 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { PollData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+import type { z } from 'zod/v4'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
 
 import PollExample from './poll'
 import exampleSource from './poll.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = PollData.strip().transform(data => ({ data }))
 const meta = {
-	component: PollExample,
+	argTypes: schemaArgTypes(PollData),
+	args: {
+		options: [
+			{ id: 'ramen', label: 'Ramen' },
+			{ id: 'tacos', label: 'Tacos' },
+			{ id: 'pizza', label: 'Pizza' },
+		],
+		question: 'Where should we eat?',
+		shared: false,
+	},
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <PollExample {...storyProps.parse(args)} />,
 	title: 'Kowalski/Poll',
-} satisfies Meta<typeof PollExample>
+} satisfies Meta<z.input<typeof storyProps>>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {
-	args: { enabledForAgents: false },
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'An instantiatable Poll from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Poll',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/poll/poll.tsx

@@ -1,26 +1,8 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { Poll } from '@flickfyi/core/kowalski'
+import { Poll, type PollProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function PollExample() {
+export default function PollExample({ data, style }: Pick<PollProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<Poll
-			options={[
-				{ id: 'ramen', label: 'Ramen' },
-				{ id: 'tacos', label: 'Tacos' },
-				{ id: 'pizza', label: 'Pizza' },
-			]}
-			question="Where should we eat?"
-		/>
-	)
+	return <Poll data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable Poll from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'Poll',
-} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/kowalski/random-picker/random-picker.stories.tsx

@@ -1,15 +1,46 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { RandomPickerData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+import type { AllUnionFields } from 'type-fest'
+import { z } from 'zod/v4'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
 
 import RandomPickerExample from './random-picker'
 import exampleSource from './random-picker.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = z
+	.discriminatedUnion('mode', [
+		RandomPickerData.options[0].strip(),
+		...RandomPickerData.options.slice(1).map(option => option.strip()),
+	])
+	.transform(data => ({ data }))
 const meta = {
-	component: RandomPickerExample,
+	argTypes: {
+		...Object.assign({}, ...RandomPickerData.options.map(schemaArgTypes)),
+		maximum: { control: 'number', if: { arg: 'mode', eq: 'range' } },
+		minimum: { control: 'number', if: { arg: 'mode', eq: 'range' } },
+		mode: { control: 'select', options: ['coin', 'dice', 'range', 'list'] },
+		options: { control: 'object', if: { arg: 'mode', eq: 'list' } },
+	},
+	args: {
+		maximum: 6,
+		minimum: 1,
+		mode: 'list',
+		options: ['Take a walk', 'Make some tea', 'Read a chapter'],
+		title: 'What should we do?',
+	},
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
-	title: 'Kowalski/RandomPicker',
-} satisfies Meta<typeof RandomPickerExample>
+	render: args => <RandomPickerExample {...storyProps.parse(args)} />,
+	title: 'Kowalski/Random picker',
+} satisfies Meta<AllUnionFields<z.input<typeof storyProps>>>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {
-	args: { enabledForAgents: false },
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'An instantiatable RandomPicker from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Random picker',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/random-picker/random-picker.tsx

@@ -1,23 +1,11 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { RandomPicker } from '@flickfyi/core/kowalski'
+import { RandomPicker, type RandomPickerProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function RandomPickerExample() {
+export default function RandomPickerExample({
+	data,
+	style,
+}: Pick<RandomPickerProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<RandomPicker
-			mode="list"
-			options={['Take a walk', 'Make some tea', 'Read a chapter']}
-			title="What should we do?"
-		/>
-	)
+	return <RandomPicker data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable RandomPicker from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'RandomPicker',
-} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/kowalski/rating/rating.stories.tsx

@@ -1,15 +1,28 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { RatingData } from '@flickfyi/core/kowalski/catalog'
+import type { Meta } from '@storybook/react-vite'
+import type { z } from 'zod/v4'
+
+import { type ExampleStory, schemaArgTypes } from '@flickfyi/core/examples/metadata'
 
 import RatingExample from './rating'
 import exampleSource from './rating.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = RatingData.strip().transform(data => ({ data }))
 const meta = {
-	component: RatingExample,
+	argTypes: schemaArgTypes(RatingData),
+	args: { subject: "Luigi's on 5th", title: 'Rate dinner' },
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <RatingExample {...storyProps.parse(args)} />,
 	title: 'Kowalski/Rating',
-} satisfies Meta<typeof RatingExample>
+} satisfies Meta<z.input<typeof storyProps>>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {
-	args: { enabledForAgents: false },
+export const Example: ExampleStory<typeof meta> = {
+	args: {
+		description:
+			'An instantiatable Rating from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Rating',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/rating/rating.tsx

@@ -1,19 +1,11 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { Rating } from '@flickfyi/core/kowalski'
+import { Rating, type RatingProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function RatingExample() {
+export default function RatingExample({
+	data,
+	style,
+}: Pick<RatingProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<Rating subject="Luigi's on 5th" title="Rate dinner" />
-	)
+	return <Rating data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable Rating from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'Rating',
-} satisfies ExampleMetadata