@flickfyi/flkr 0.0.182 → 0.0.185

package/node_modules/@flickfyi/core/dist-types/kowalski/feature-schema.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod/v4';
+/** A feature's store name; without one it is Kowalski<ExportName>. */
+export declare const kowalskiFeatureId: z.ZodOptional<z.ZodString>;
+export declare const kowalskiScope: z.ZodDefault<z.ZodEnum<{
+    private: "private";
+    public: "public";
+}>>;
+export declare const featureFields: {
+    id: z.ZodOptional<z.ZodString>;
+    revision: z.ZodDefault<z.ZodNumber>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>>;
+};
+export declare function store<Shape extends z.ZodRawShape>(shape: Shape): z.ZodObject<{
+    configuration: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    configurationRevision: z.ZodDefault<z.ZodNumber>;
+} & Shape extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$strip>;
+export declare const kowalskiComponentSchema: z.ZodEnum<{
+    event: "event";
+    checklist: "checklist";
+    timer: "timer";
+    habit: "habit";
+    goal: "goal";
+    poll: "poll";
+    reminder: "reminder";
+    trip: "trip";
+    countdown: "countdown";
+    timeZone: "timeZone";
+    colorPalette: "colorPalette";
+    billSplit: "billSplit";
+    expense: "expense";
+    unitConverter: "unitConverter";
+    calculator: "calculator";
+    randomPicker: "randomPicker";
+    contact: "contact";
+    bookmark: "bookmark";
+    note: "note";
+    budget: "budget";
+    scoreboard: "scoreboard";
+    taskBoard: "taskBoard";
+    recipe: "recipe";
+    rotation: "rotation";
+    shoppingList: "shoppingList";
+    rating: "rating";
+    ledger: "ledger";
+    timeSince: "timeSince";
+    fortune: "fortune";
+    lesson: "lesson";
+}>;
+export type KowalskiComponent = z.infer<typeof kowalskiComponentSchema>;
+/**
+ * Per-item state as top-level `<prefix><id>` fields, which Quantum patches independently.
+ * The template-literal record types them by prefix, so they never collide with the named
+ * fields; any other key is rejected.
+ */
+export declare function entries<Prefix extends string, Value extends z.ZodType, Shape extends z.ZodRawShape>(prefix: Prefix, value: Value, shape: Shape): z.ZodIntersection<z.ZodObject<{
+    configuration: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    configurationRevision: z.ZodDefault<z.ZodNumber>;
+} & Shape extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$loose>, z.ZodRecord<z.ZodTemplateLiteral<[Prefix] extends infer T_1 ? T_1 extends [Prefix] ? T_1 extends z.core.$ZodTemplateLiteralPart[] ? `${z.core.$PartsToTemplateLiteral<T_1>}${string}` : never : never : never>, Value>>;
+/** Catalog fields are whole-value replacements, not collaborative text insertions. */
+export declare function replacement<Schema extends z.ZodType>(schema: Schema): z.ZodDefault<z.ZodObject<{
+    value: Schema;
+}, z.core.$strip>>;

package/node_modules/@flickfyi/core/dist-types/kowalski/format.d.ts

@@ -2,3 +2,7 @@
 export declare const format: import('@formatjs/intl').IntlShape<string>;
 /** Validate the UI's English decimal/currency grammar before removing its fixed affixes. */
 export declare function parseNumberInput(text: string, currency?: string): number;
+/** Content arrives unvalidated, so an unknown currency code falls back instead of throwing. */
+export declare function resolveCurrency(value: string | undefined): string | undefined;
+/** Content arrives unvalidated, so an unknown time zone falls back instead of throwing. */
+export declare function resolveTimeZone(value: string | undefined, fallback?: string): string;

package/node_modules/@flickfyi/core/dist-types/kowalski/fortune.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod/v4';
+import * as stylex from '@stylexjs/stylex';
+export declare const FortuneData: z.ZodObject<{
+    action: z.ZodString;
+    answers: z.ZodArray<z.ZodString>;
+    prompt: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>;
+export type FortuneData = z.input<typeof FortuneData>;
+export declare const FortuneProps: z.ZodObject<{
+    data: z.ZodObject<{
+        action: z.ZodString;
+        answers: z.ZodArray<z.ZodString>;
+        prompt: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type FortuneProps = z.input<typeof FortuneProps> & {
+    style?: stylex.StyleXArray<stylex.StyleXStyles>;
+};
+export declare function Fortune({ data, style }: FortuneProps): import('@flickfyi/photon/jsx-runtime').JSX.Element;

package/node_modules/@flickfyi/core/dist-types/kowalski/frame.d.ts

@@ -1,16 +1,17 @@
 import { PropsWithChildren, ReactNode } from 'react';
-import { KowalskiComponent } from './catalog.js';
+import { KowalskiComponent } from './feature-schema.js';
 import * as stylex from '@stylexjs/stylex';
 /**
  * Every feature is one tray: the theme's tray color, radius and edge, content at p-4.
  * One painted top-level surface is also what the native renderer turns into the card.
  */
-export declare function FeatureFrame({ children, component, detail, header, notice, onRetry, title, trailing, }: PropsWithChildren<{
+export declare function FeatureFrame({ children, component, detail, header, notice, onRetry, style, title, trailing, }: PropsWithChildren<{
     component: KowalskiComponent;
     detail?: string;
     header?: ReactNode;
     notice?: string;
     onRetry?: () => void;
+    style?: stylex.StyleXArray<stylex.StyleXStyles>;
     title: string;
     trailing?: ReactNode;
 }>): import('@flickfyi/photon/jsx-runtime').JSX.Element;
@@ -50,11 +51,10 @@ export declare function FeatureProgress({ value, }: {
     component: KowalskiComponent;
     value: number;
 }): import('@flickfyi/photon/jsx-runtime').JSX.Element;
-export declare function FeatureNumber({ component, integer, label, max, min, onChange, ready, saving, value, }: {
+export declare function FeatureNumber({ component, integer, label, min, onChange, ready, saving, value, }: {
     component: KowalskiComponent;
     integer?: boolean;
     label: string;
-    max?: number;
     min?: number;
     onChange: (value: number, onSaved: () => void) => void;
     ready: boolean;

package/node_modules/@flickfyi/core/dist-types/kowalski/index.d.cts

@@ -1,8 +1,32 @@
-export type { KowalskiInput, KowalskiProps } from './catalog.js';
-export { Countdown, Timer, TimeZone } from './clocks.js';
-export { Bookmark, Contact, Event, Note, Reminder, Trip } from './details.js';
-export { Budget, Ledger, Rating, Rotation, Scoreboard, ShoppingList, TaskBoard, } from './everyday.js';
+export type { CreateSchemas, CreateSchemasInput } from './create-schemas.js';
+export { Fortune, type FortuneData, FortuneProps } from './fortune.js';
 export { KowalskiStack } from './frame.js';
-export { Checklist, Goal, Habit, Poll } from './productivity.js';
-export { Recipe } from './recipe.js';
-export { BillSplit, Calculator, ColorPalette, Expense, RandomPicker, UnitConverter, } from './tools.js';
+export { Lesson, type LessonData, LessonProps } from './lesson.js';
+export { Recipe, RecipeProps } from './recipe.js';
+export { TimeSince, type TimeSinceData, TimeSinceProps } from './time-since.js';
+export { BillSplit, BillSplitProps } from './components/bill-split.js';
+export { Bookmark, BookmarkProps } from './components/bookmark.js';
+export { Budget, BudgetProps } from './components/budget.js';
+export { Calculator, CalculatorProps } from './components/calculator.js';
+export { Checklist, ChecklistProps } from './components/checklist.js';
+export { ColorPalette, ColorPaletteProps } from './components/color-palette.js';
+export { Contact, ContactProps } from './components/contact.js';
+export { Countdown, CountdownProps } from './components/countdown.js';
+export { Event, EventProps } from './components/event.js';
+export { Expense, ExpenseProps } from './components/expense.js';
+export { Goal, GoalProps } from './components/goal.js';
+export { Habit, HabitProps } from './components/habit.js';
+export { Ledger, LedgerProps } from './components/ledger.js';
+export { Note, NoteProps } from './components/note.js';
+export { Poll, PollProps } from './components/poll.js';
+export { RandomPicker, RandomPickerProps } from './components/random-picker.js';
+export { Rating, RatingProps } from './components/rating.js';
+export { Reminder, ReminderProps } from './components/reminder.js';
+export { Rotation, RotationProps } from './components/rotation.js';
+export { Scoreboard, ScoreboardProps } from './components/scoreboard.js';
+export { ShoppingList, ShoppingListProps } from './components/shopping-list.js';
+export { TaskBoard, TaskBoardProps } from './components/task-board.js';
+export { TimeZone, TimeZoneProps } from './components/time-zone.js';
+export { Timer, TimerProps } from './components/timer.js';
+export { Trip, TripProps } from './components/trip.js';
+export { UnitConverter, UnitConverterProps } from './components/unit-converter.js';

package/node_modules/@flickfyi/core/dist-types/kowalski/index.d.ts

@@ -1,8 +1,32 @@
-export type { KowalskiInput, KowalskiProps } from './catalog.js';
-export { Countdown, Timer, TimeZone } from './clocks.js';
-export { Bookmark, Contact, Event, Note, Reminder, Trip } from './details.js';
-export { Budget, Ledger, Rating, Rotation, Scoreboard, ShoppingList, TaskBoard, } from './everyday.js';
+export type { CreateSchemas, CreateSchemasInput } from './create-schemas.js';
+export { Fortune, type FortuneData, FortuneProps } from './fortune.js';
 export { KowalskiStack } from './frame.js';
-export { Checklist, Goal, Habit, Poll } from './productivity.js';
-export { Recipe } from './recipe.js';
-export { BillSplit, Calculator, ColorPalette, Expense, RandomPicker, UnitConverter, } from './tools.js';
+export { Lesson, type LessonData, LessonProps } from './lesson.js';
+export { Recipe, RecipeProps } from './recipe.js';
+export { TimeSince, type TimeSinceData, TimeSinceProps } from './time-since.js';
+export { BillSplit, BillSplitProps } from './components/bill-split.js';
+export { Bookmark, BookmarkProps } from './components/bookmark.js';
+export { Budget, BudgetProps } from './components/budget.js';
+export { Calculator, CalculatorProps } from './components/calculator.js';
+export { Checklist, ChecklistProps } from './components/checklist.js';
+export { ColorPalette, ColorPaletteProps } from './components/color-palette.js';
+export { Contact, ContactProps } from './components/contact.js';
+export { Countdown, CountdownProps } from './components/countdown.js';
+export { Event, EventProps } from './components/event.js';
+export { Expense, ExpenseProps } from './components/expense.js';
+export { Goal, GoalProps } from './components/goal.js';
+export { Habit, HabitProps } from './components/habit.js';
+export { Ledger, LedgerProps } from './components/ledger.js';
+export { Note, NoteProps } from './components/note.js';
+export { Poll, PollProps } from './components/poll.js';
+export { RandomPicker, RandomPickerProps } from './components/random-picker.js';
+export { Rating, RatingProps } from './components/rating.js';
+export { Reminder, ReminderProps } from './components/reminder.js';
+export { Rotation, RotationProps } from './components/rotation.js';
+export { Scoreboard, ScoreboardProps } from './components/scoreboard.js';
+export { ShoppingList, ShoppingListProps } from './components/shopping-list.js';
+export { TaskBoard, TaskBoardProps } from './components/task-board.js';
+export { TimeZone, TimeZoneProps } from './components/time-zone.js';
+export { Timer, TimerProps } from './components/timer.js';
+export { Trip, TripProps } from './components/trip.js';
+export { UnitConverter, UnitConverterProps } from './components/unit-converter.js';

package/node_modules/@flickfyi/core/dist-types/kowalski/lesson.d.ts

@@ -0,0 +1,89 @@
+import { Lesson as LessonEntity } from '@flickfyi/schemas/lesson';
+import { z } from 'zod/v4';
+import { CreateSchemas } from './create-schemas.js';
+import * as stylex from '@stylexjs/stylex';
+export declare const LessonData: z.ZodObject<{
+    hasPart: z.ZodArray<z.ZodObject<{
+        acceptedAnswer: z.ZodArray<z.ZodObject<{
+            answerExplanation: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+        assesses: z.ZodString;
+        eduQuestionType: z.ZodEnum<{
+            Checkbox: "Checkbox";
+            Flashcard: "Flashcard";
+            "Multiple choice": "Multiple choice";
+        }>;
+        id: z.ZodString;
+        suggestedAnswer: z.ZodArray<z.ZodObject<{
+            comment: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+    teaches: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        examples: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strict>>;
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+    title: z.ZodString;
+}, z.core.$strict>;
+export type LessonData = LessonEntity;
+export declare const LessonProps: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    revision: z.ZodDefault<z.ZodNumber>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>>;
+    data: z.ZodObject<{
+        hasPart: z.ZodArray<z.ZodObject<{
+            acceptedAnswer: z.ZodArray<z.ZodObject<{
+                answerExplanation: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            assesses: z.ZodString;
+            eduQuestionType: z.ZodEnum<{
+                Checkbox: "Checkbox";
+                Flashcard: "Flashcard";
+                "Multiple choice": "Multiple choice";
+            }>;
+            id: z.ZodString;
+            suggestedAnswer: z.ZodArray<z.ZodObject<{
+                comment: z.ZodOptional<z.ZodString>;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+        teaches: z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            examples: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strict>>;
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        title: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type LessonProps = z.input<typeof LessonProps> & {
+    style?: stylex.StyleXArray<stylex.StyleXStyles>;
+};
+/** `result_<question id>` is "first" when right on the first try, "retry" after a miss, null when unanswered. */
+export declare const lessonStoreSchema: z.ZodIntersection<z.ZodObject<{
+    configuration: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    configurationRevision: z.ZodDefault<z.ZodNumber>;
+    missed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    seen: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    started: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$loose>, z.ZodRecord<z.ZodTemplateLiteral<`result_${string}`>, z.ZodNullable<z.ZodEnum<{
+    first: "first";
+    retry: "retry";
+}>>>>;
+export declare const createSchemas: CreateSchemas;
+export declare function Lesson({ data, id, revision, scope, style, }: LessonProps): import('@flickfyi/photon/jsx-runtime').JSX.Element;

package/node_modules/@flickfyi/core/dist-types/kowalski/recipe.d.ts

@@ -1,8 +1,129 @@
-import { KowalskiInput } from './catalog.js';
-/**
- * Cooks an RGF recipe in two modes. The overview is for reading: ingredients, servings, and
- * Start cooking at the bottom. Cooking fits one screen with the current step and its action at
- * the bottom, or the next timer to go off when nothing is ready; above it, in falling order of
- * attention, the other running timers, the next few steps (greyed until ready), and what's done.
- */
-export declare function Recipe(input: KowalskiInput<'recipe'>): import('@flickfyi/photon/jsx-runtime').JSX.Element;
+import { Recipe as RecipeEntity } from '@flickfyi/schemas/recipe';
+import { z } from 'zod/v4';
+import { CreateSchemas } from './create-schemas.js';
+import * as stylex from '@stylexjs/stylex';
+export declare const RecipeData: z.ZodObject<{
+    ingredients: z.ZodArray<z.ZodObject<{
+        amount: z.ZodOptional<z.ZodNumber>;
+        id: z.ZodString;
+        label: z.ZodString;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        unit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    servings: z.ZodOptional<z.ZodNumber>;
+    steps: z.ZodArray<z.ZodObject<{
+        after: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        attention: z.ZodOptional<z.ZodEnum<{
+            active: "active";
+            passive: "passive";
+        }>>;
+        doneness: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodObject<{
+            maxMinutes: z.ZodOptional<z.ZodNumber>;
+            minMinutes: z.ZodOptional<z.ZodNumber>;
+            raw: z.ZodString;
+        }, z.core.$strict>>;
+        equipment: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        id: z.ZodString;
+        instruction: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<{
+            serve: "serve";
+            setup: "setup";
+            transform: "transform";
+            wait: "wait";
+        }>>;
+        label: z.ZodOptional<z.ZodString>;
+        outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        temperature: z.ZodOptional<z.ZodString>;
+        uses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            portion: z.ZodOptional<z.ZodString>;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                ingredientId: z.ZodString;
+                kind: z.ZodLiteral<"ingredient">;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"output">;
+                outputId: z.ZodString;
+            }, z.core.$strict>], "kind">;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    title: z.ZodString;
+    yield: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type RecipeData = RecipeEntity;
+export declare const RecipeProps: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>>>;
+    id: z.ZodOptional<z.ZodString>;
+    revision: z.ZodDefault<z.ZodNumber>;
+    data: z.ZodObject<{
+        ingredients: z.ZodArray<z.ZodObject<{
+            amount: z.ZodOptional<z.ZodNumber>;
+            id: z.ZodString;
+            label: z.ZodString;
+            notes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            unit: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        servings: z.ZodOptional<z.ZodNumber>;
+        steps: z.ZodArray<z.ZodObject<{
+            after: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            attention: z.ZodOptional<z.ZodEnum<{
+                active: "active";
+                passive: "passive";
+            }>>;
+            doneness: z.ZodOptional<z.ZodString>;
+            duration: z.ZodOptional<z.ZodObject<{
+                maxMinutes: z.ZodOptional<z.ZodNumber>;
+                minMinutes: z.ZodOptional<z.ZodNumber>;
+                raw: z.ZodString;
+            }, z.core.$strict>>;
+            equipment: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            id: z.ZodString;
+            instruction: z.ZodString;
+            kind: z.ZodOptional<z.ZodEnum<{
+                serve: "serve";
+                setup: "setup";
+                transform: "transform";
+                wait: "wait";
+            }>>;
+            label: z.ZodOptional<z.ZodString>;
+            outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            temperature: z.ZodOptional<z.ZodString>;
+            uses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                portion: z.ZodOptional<z.ZodString>;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    ingredientId: z.ZodString;
+                    kind: z.ZodLiteral<"ingredient">;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"output">;
+                    outputId: z.ZodString;
+                }, z.core.$strict>], "kind">;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        title: z.ZodString;
+        yield: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type RecipeProps = z.input<typeof RecipeProps> & {
+    style?: stylex.StyleXArray<stylex.StyleXStyles>;
+};
+export declare const recipeStoreSchema: z.ZodIntersection<z.ZodObject<{
+    configuration: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    configurationRevision: z.ZodDefault<z.ZodNumber>;
+    cooking: z.ZodDefault<z.ZodBoolean>;
+    servings: z.ZodDefault<z.ZodNumber>;
+}, z.core.$loose>, z.ZodRecord<z.ZodTemplateLiteral<`step_${string}`>, z.ZodObject<{
+    done: z.ZodBoolean;
+    endsAt: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>>>;
+export declare const createSchemas: CreateSchemas;
+export declare function Recipe({ data, id, revision, scope, style, }: RecipeProps): import('@flickfyi/photon/jsx-runtime').JSX.Element;

package/node_modules/@flickfyi/core/dist-types/kowalski/schemas.d.cts

@@ -0,0 +1,4 @@
+import { CreateSchemasInput } from './create-schemas.js';
+export declare const schemaComponents: string[];
+export { kowalskiFeatureId, kowalskiScope } from './feature-schema.js';
+export declare function componentSchemas(name: string, input?: CreateSchemasInput): Record<string, import('zod').ZodType<unknown, unknown, import('zod/v4/core').$ZodTypeInternals<unknown, unknown>>>;

package/node_modules/@flickfyi/core/dist-types/kowalski/schemas.d.ts

@@ -0,0 +1,4 @@
+import { CreateSchemasInput } from './create-schemas.js';
+export declare const schemaComponents: string[];
+export { kowalskiFeatureId, kowalskiScope } from './feature-schema.js';
+export declare function componentSchemas(name: string, input?: CreateSchemasInput): Record<string, import('zod').ZodType<unknown, unknown, import('zod/v4/core').$ZodTypeInternals<unknown, unknown>>>;

package/node_modules/@flickfyi/core/dist-types/kowalski/time-since.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod/v4';
+import { CreateSchemas } from './create-schemas.js';
+import * as stylex from '@stylexjs/stylex';
+export declare const TimeSinceData: z.ZodObject<{
+    action: z.ZodString;
+    label: z.ZodString;
+    subject: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>;
+export type TimeSinceData = z.input<typeof TimeSinceData>;
+export declare const TimeSinceProps: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>>>;
+    id: z.ZodOptional<z.ZodString>;
+    revision: z.ZodDefault<z.ZodNumber>;
+    data: z.ZodObject<{
+        action: z.ZodString;
+        label: z.ZodString;
+        subject: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type TimeSinceProps = z.input<typeof TimeSinceProps> & {
+    style?: stylex.StyleXArray<stylex.StyleXStyles>;
+};
+export declare const timeSinceStoreSchema: z.ZodObject<{
+    configuration: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    configurationRevision: z.ZodDefault<z.ZodNumber>;
+    lastAt: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const createSchemas: CreateSchemas;
+export declare function TimeSince({ data, id, revision, scope, style, }: TimeSinceProps): import('@flickfyi/photon/jsx-runtime').JSX.Element;

package/node_modules/@flickfyi/core/examples/example-metadata.ts

@@ -1,4 +1,21 @@
-export type ExampleMetadata = {
-	name: string
+import type { StoryObj } from '@storybook/react-vite'
+import mapValues from 'lodash/mapValues.js'
+import type { z } from 'zod/v4'
+
+/** What agents see about a canonical example. Catalog edits these story args and saves them to the story file. */
+export type ExampleArgs = {
+	/** What the example does and when it fits, in plain words. Agents read this to decide whether to use it. */
 	description: string
+	/** Offer this example to agents. The example stays visible and interactive in Catalog either way. */
+	enabled: boolean
+	/** The example's name as agents see it, e.g. "Time since". */
+	name: string
+}
+
+/** A canonical example story; its args are what agents see about the example. */
+export type ExampleStory<Meta> = StoryObj<Meta> & { args: ExampleArgs }
+
+/** Preserve schema descriptions while Storybook infers controls from the args. */
+export function schemaArgTypes(schema: z.ZodObject) {
+	return mapValues(schema.shape, field => ({ description: field.description }))
 }

package/node_modules/@flickfyi/core/examples/kowalski/bill-split/bill-split.stories.tsx

@@ -1,15 +1,34 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { BillSplitData } 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 BillSplitExample from './bill-split'
 import exampleSource from './bill-split.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = BillSplitData.strip().transform(data => ({ data }))
 const meta = {
-	component: BillSplitExample,
+	argTypes: schemaArgTypes(BillSplitData),
+	args: {
+		currency: 'USD',
+		people: 3,
+		tipPercent: 20,
+		title: 'Split the bill',
+		total: 86.5,
+	},
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
-	title: 'Kowalski/BillSplit',
-} satisfies Meta<typeof BillSplitExample>
+	render: args => <BillSplitExample {...storyProps.parse(args)} />,
+	title: 'Kowalski/Bill split',
+} 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 BillSplit from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Bill split',
+	},
 }

package/node_modules/@flickfyi/core/examples/kowalski/bill-split/bill-split.tsx

@@ -1,17 +1,11 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { BillSplit } from '@flickfyi/core/kowalski'
+import { BillSplit, type BillSplitProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function BillSplitExample() {
+export default function BillSplitExample({
+	data,
+	style,
+}: Pick<BillSplitProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return <BillSplit people={3} tipPercent={20} total={86.5} />
+	return <BillSplit data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable BillSplit from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'BillSplit',
-} satisfies ExampleMetadata

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

@@ -1,15 +1,32 @@
-import type { Meta, StoryObj } from '@storybook/react-vite'
+import { BookmarkData } 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 BookmarkExample from './bookmark'
 import exampleSource from './bookmark.tsx?raw'
 
+// Keep catalog metadata outside the component's content.
+const storyProps = BookmarkData.strip().transform(data => ({ data }))
 const meta = {
-	component: BookmarkExample,
+	argTypes: schemaArgTypes(BookmarkData),
+	args: {
+		note: 'Small details make an interface feel considered.',
+		title: 'The Shape of Software',
+		url: 'https://emilkowal.ski/',
+	},
 	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	render: args => <BookmarkExample {...storyProps.parse(args)} />,
 	title: 'Kowalski/Bookmark',
-} satisfies Meta<typeof BookmarkExample>
+} 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 Bookmark from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+		enabled: false,
+		name: 'Bookmark',
+	},
 }

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

@@ -1,23 +1,11 @@
 import { useTheme } from '@flickfyi/core'
 import { theme } from '@flickfyi/core/examples/kowalski/theme'
-import { Bookmark } from '@flickfyi/core/kowalski'
+import { Bookmark, type BookmarkProps } from '@flickfyi/core/kowalski'
 
-import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
-
-export default function BookmarkExample() {
+export default function BookmarkExample({
+	data,
+	style,
+}: Pick<BookmarkProps, 'data' | 'style'>) {
 	useTheme(theme)
-
-	return (
-		<Bookmark
-			note="Small details make an interface feel considered."
-			title="The Shape of Software"
-			url="https://emilkowal.ski/"
-		/>
-	)
+	return <Bookmark data={data} style={style} />
 }
-
-export const exampleMetadata = {
-	description:
-		'An instantiatable Bookmark from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
-	name: 'Bookmark',
-} satisfies ExampleMetadata