@flickfyi/flkr 0.0.182 → 0.0.185

package/node_modules/@flickfyi/core/src/kowalski/feature-schema.ts

@@ -0,0 +1,84 @@
+import { z } from 'zod/v4'
+
+/** A feature's store name; without one it is Kowalski<ExportName>. */
+export const kowalskiFeatureId = z
+	.string()
+	.regex(/^[A-Za-z][A-Za-z0-9]*$/)
+	.optional()
+export const kowalskiScope = z.enum(['private', 'public']).default('private')
+
+export const featureFields = {
+	id: kowalskiFeatureId,
+	revision: z.number().default(0),
+	scope: kowalskiScope,
+}
+
+export function store<Shape extends z.ZodRawShape>(shape: Shape) {
+	return z.object({
+		configuration: z.record(z.string(), z.unknown()).nullable().default(null),
+		configurationRevision: z.number().default(0),
+		...shape,
+	})
+}
+
+export const kowalskiComponentSchema = z.enum([
+	'checklist',
+	'timer',
+	'habit',
+	'goal',
+	'poll',
+	'event',
+	'reminder',
+	'trip',
+	'countdown',
+	'timeZone',
+	'colorPalette',
+	'billSplit',
+	'expense',
+	'unitConverter',
+	'calculator',
+	'randomPicker',
+	'contact',
+	'bookmark',
+	'note',
+	'budget',
+	'scoreboard',
+	'taskBoard',
+	'recipe',
+	'rotation',
+	'shoppingList',
+	'rating',
+	'ledger',
+	'timeSince',
+	'fortune',
+	'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 function entries<
+	Prefix extends string,
+	Value extends z.ZodType,
+	Shape extends z.ZodRawShape,
+>(prefix: Prefix, value: Value, shape: Shape) {
+	const named = store(shape)
+	const keys = new Set(Object.keys(named.shape))
+	return z
+		.intersection(
+			named.loose(),
+			z.looseRecord(z.templateLiteral([prefix, z.string()]), value)
+		)
+		.refine(
+			state => Object.keys(state).every(key => keys.has(key) || key.startsWith(prefix)),
+			`Item fields must start with ${prefix}.`
+		)
+}
+
+/** Catalog fields are whole-value replacements, not collaborative text insertions. */
+export function replacement<Schema extends z.ZodType>(schema: Schema) {
+	return z.object({ value: schema }).default(() => ({ value: schema.parse(undefined) }))
+}

package/node_modules/@flickfyi/core/src/kowalski/format.ts

@@ -28,10 +28,11 @@ export const format = createIntl(
 
 /** Validate the UI's English decimal/currency grammar before removing its fixed affixes. */
 export function parseNumberInput(text: string, currency?: string) {
-	const symbol = currency
+	const code = currency === undefined ? undefined : resolveCurrency(currency)
+	const symbol = code
 		? (format
-				.formatNumberToParts(0, { currency, style: 'currency' })
-				.find(part => part.type === 'currency')?.value ?? currency)
+				.formatNumberToParts(0, { currency: code, style: 'currency' })
+				.find(part => part.type === 'currency')?.value ?? code)
 		: ''
 	const normalized = text.replaceAll('\u200E', '').trim().replaceAll('\u00A0', ' ')
 	const amount = normalized.replace(symbol, '')
@@ -46,3 +47,28 @@ export function parseNumberInput(text: string, currency?: string) {
 	}
 	return Number(amount.replaceAll(',', '').trim())
 }
+
+/** Content arrives unvalidated, so an unknown currency code falls back instead of throwing. */
+export function resolveCurrency(value: string | undefined) {
+	try {
+		return new Intl.NumberFormat('en-US', {
+			currency: value ?? 'USD',
+			style: 'currency',
+		}).resolvedOptions().currency
+	} catch {
+		return 'USD'
+	}
+}
+
+/** Content arrives unvalidated, so an unknown time zone falls back instead of throwing. */
+export function resolveTimeZone(value: string | undefined, fallback = 'UTC') {
+	if (value === undefined) {
+		return fallback
+	}
+	try {
+		return new Intl.DateTimeFormat('en-US', { timeZone: value }).resolvedOptions()
+			.timeZone
+	} catch {
+		return fallback
+	}
+}

package/node_modules/@flickfyi/core/src/kowalski/fortune.tsx

@@ -0,0 +1,67 @@
+import { Text } from '@flickfyi/core'
+import * as stylex from '@stylexjs/stylex'
+import sample from 'lodash/sample.js'
+import { useState } from 'react'
+import { z } from 'zod/v4'
+
+import { space } from '~/themes/scale.stylex'
+import { roles } from '~/themes/shared'
+
+import { FeatureAction, FeatureFrame, FeatureWell } from './frame'
+
+export const FortuneData = /* @__PURE__ */ z
+	.strictObject({
+		action: z
+			.string()
+			.describe('A short button command, e.g. "Crack cookie" or "Ask the eight ball".'),
+		answers: z
+			.array(z.string())
+			.describe(
+				'The complete pool of short fortunes or answers to reveal, one at a time. Match the requested topic and tone.'
+			),
+		prompt: z
+			.string()
+			.describe(
+				'The short invitation shown before the first reveal, e.g. "Your fortune awaits" or "Think of a yes-or-no question".'
+			),
+		title: z.string().describe('The heading, e.g. "Fortune cookie" or "Magic 8 Ball".'),
+	})
+	.describe(
+		'Content for one existing Fortune React component. It already implements a button that randomly reveals one answer. Supply concise UI copy and a ready-to-use answer pool for a fortune cookie, magic eight ball, or themed oracle. Answers are supplied at generation time; the component does not generate new answers or interpret questions at runtime.'
+	)
+export type FortuneData = z.input<typeof FortuneData>
+
+export const FortuneProps = z.strictObject({ data: FortuneData })
+export type FortuneProps = z.input<typeof FortuneProps> & {
+	style?: stylex.StyleXArray<stylex.StyleXStyles>
+}
+
+export function Fortune({ data, style }: FortuneProps) {
+	const [result, setResult] = useState<string | null>(null)
+	const answer = result !== null && data.answers.includes(result) ? result : null
+	return (
+		<FeatureFrame component="fortune" title={data.title} style={style}>
+			<FeatureWell style={styles.reveal}>
+				<Text {...stylex.props(answer === null ? roles.muted : roles.h1, styles.answer)}>
+					{answer ?? data.prompt}
+				</Text>
+			</FeatureWell>
+			<FeatureAction
+				component="fortune"
+				onClick={() => {
+					const remaining = data.answers.filter(value => value !== answer)
+					setResult(sample(remaining.length > 0 ? remaining : data.answers) ?? null)
+				}}
+				size="lg"
+				variant="primary"
+			>
+				{data.action}
+			</FeatureAction>
+		</FeatureFrame>
+	)
+}
+
+const styles = /* @__PURE__ */ stylex.create({
+	answer: { textAlign: 'center' },
+	reveal: { justifyContent: 'center', minHeight: space[24] },
+})

package/node_modules/@flickfyi/core/src/kowalski/frame.tsx

@@ -15,7 +15,7 @@ import { space } from '~/themes/scale.stylex'
 import { appearance, button, roles } from '~/themes/shared'
 import { colors, shape } from '~/themes/tokens.stylex'
 
-import type { KowalskiComponent } from './catalog'
+import type { KowalskiComponent } from './feature-schema'
 import { format, parseNumberInput } from './format'
 
 /**
@@ -29,6 +29,7 @@ export function FeatureFrame({
 	header,
 	notice,
 	onRetry,
+	style,
 	title,
 	trailing,
 }: PropsWithChildren<{
@@ -37,11 +38,12 @@ export function FeatureFrame({
 	header?: ReactNode
 	notice?: string
 	onRetry?: () => void
+	style?: stylex.StyleXArray<stylex.StyleXStyles>
 	title: string
 	trailing?: ReactNode
 }>) {
 	return (
-		<Flex {...stylex.props(appearance.tray, layout.frame)}>
+		<Flex {...stylex.props(appearance.tray, layout.frame, style)}>
 			{header ?? (
 				<Flex {...stylex.props(layout.header)}>
 					<Flex {...stylex.props(layout.headerRow)}>
@@ -228,8 +230,7 @@ export function FeatureNumber({
 	component,
 	integer = false,
 	label,
-	max = 1e12,
-	min = -1e12,
+	min = Number.NEGATIVE_INFINITY,
 	onChange,
 	ready,
 	saving,
@@ -238,7 +239,6 @@ export function FeatureNumber({
 	component: KowalskiComponent
 	integer?: boolean
 	label: string
-	max?: number
 	min?: number
 	onChange: (value: number, onSaved: () => void) => void
 	ready: boolean
@@ -257,7 +257,6 @@ export function FeatureNumber({
 			validate={text =>
 				Number.isFinite(parseNumberInput(text)) &&
 				parseNumberInput(text) >= min &&
-				parseNumberInput(text) <= max &&
 				(!integer || Number.isInteger(parseNumberInput(text)))
 			}
 			onChange={(text, onSaved) => onChange(parseNumberInput(text), onSaved)}

package/node_modules/@flickfyi/core/src/kowalski/index.ts

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