@flickfyi/flkr 0.0.141 → 0.0.153

package/node_modules/@flickfyi/core/examples/kowalski/theme.ts

@@ -0,0 +1,3 @@
+import { createTheme } from '@flickfyi/core/themes/default'
+
+export const theme = createTheme({ hue: 286 })

package/node_modules/@flickfyi/core/examples/kowalski/time-zone/time-zone.stories.tsx

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+
+import TimeZoneExample from './time-zone'
+import exampleSource from './time-zone.tsx?raw'
+
+const meta = {
+	component: TimeZoneExample,
+	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	title: 'Kowalski/TimeZone',
+} satisfies Meta<typeof TimeZoneExample>
+
+export default meta
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: false },
+}

package/node_modules/@flickfyi/core/examples/kowalski/time-zone/time-zone.tsx

@@ -0,0 +1,22 @@
+import { useTheme } from '@flickfyi/core'
+import { theme } from '@flickfyi/core/examples/kowalski/theme'
+import { TimeZone } from '@flickfyi/core/kowalski'
+
+import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
+
+export default function TimeZoneExample() {
+	useTheme(theme)
+
+	return (
+		<TimeZone
+			title="A good time to call"
+			zones={['America/Los_Angeles', 'America/Chicago', 'America/New_York']}
+		/>
+	)
+}
+
+export const exampleMetadata = {
+	description:
+		'An instantiatable TimeZone from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+	name: 'TimeZone',
+} satisfies ExampleMetadata

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

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+
+import TimerExample from './timer'
+import exampleSource from './timer.tsx?raw'
+
+const meta = {
+	component: TimerExample,
+	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	title: 'Kowalski/Timer',
+} satisfies Meta<typeof TimerExample>
+
+export default meta
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: false },
+}

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

@@ -0,0 +1,23 @@
+import { useTheme } from '@flickfyi/core'
+import { theme } from '@flickfyi/core/examples/kowalski/theme'
+import { Timer } from '@flickfyi/core/kowalski'
+
+import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
+
+export default function TimerExample() {
+	useTheme(theme)
+
+	return (
+		<Timer
+			durationSeconds={1500}
+			mode="focus"
+			title="A little focus"
+		/>
+	)
+}
+
+export const exampleMetadata = {
+	description:
+		'An instantiatable Timer from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+	name: 'Timer',
+} satisfies ExampleMetadata

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

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+
+import TripExample from './trip'
+import exampleSource from './trip.tsx?raw'
+
+const meta = {
+	component: TripExample,
+	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	title: 'Kowalski/Trip',
+} satisfies Meta<typeof TripExample>
+
+export default meta
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: false },
+}

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

@@ -0,0 +1,26 @@
+import { useTheme } from '@flickfyi/core'
+import { theme } from '@flickfyi/core/examples/kowalski/theme'
+import { Trip } from '@flickfyi/core/kowalski'
+
+import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
+
+export default function TripExample() {
+	useTheme(theme)
+
+	return (
+		<Trip
+			destination="Monterey"
+			endDate="2026-11-08"
+			origin="San Francisco"
+			startDate="2026-11-07"
+			title="A weekend away"
+			transport="car"
+		/>
+	)
+}
+
+export const exampleMetadata = {
+	description:
+		'An instantiatable Trip from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+	name: 'Trip',
+} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/kowalski/unit-converter/unit-converter.stories.tsx

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+
+import UnitConverterExample from './unit-converter'
+import exampleSource from './unit-converter.tsx?raw'
+
+const meta = {
+	component: UnitConverterExample,
+	parameters: { docs: { source: { code: exampleSource, language: 'tsx' } } },
+	title: 'Kowalski/UnitConverter',
+} satisfies Meta<typeof UnitConverterExample>
+
+export default meta
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: false },
+}

package/node_modules/@flickfyi/core/examples/kowalski/unit-converter/unit-converter.tsx

@@ -0,0 +1,24 @@
+import { useTheme } from '@flickfyi/core'
+import { theme } from '@flickfyi/core/examples/kowalski/theme'
+import { UnitConverter } from '@flickfyi/core/kowalski'
+
+import type { ExampleMetadata } from '@flickfyi/core/examples/metadata'
+
+export default function UnitConverterExample() {
+	useTheme(theme)
+
+	return (
+		<UnitConverter
+			from="km"
+			title="Miles from home"
+			to="mi"
+			value={10}
+		/>
+	)
+}
+
+export const exampleMetadata = {
+	description:
+		'An instantiatable UnitConverter from Core. Authored UI and standard Quantum persistence; the model supplies typed content only.',
+	name: 'UnitConverter',
+} satisfies ExampleMetadata

package/node_modules/@flickfyi/core/examples/parrott/calculator/calculator.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof Calculator>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/checklist/checklist.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof Checklist>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/countdown/countdown.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof Countdown>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/counter/counter.stories.tsx

@@ -14,6 +14,7 @@ export default meta
 type Story = StoryObj<typeof meta>
 
 export const Default: Story = {
+	args: { enabledForAgents: true },
 	async play({ canvasElement }) {
 		const canvas = within(canvasElement)
 		const increment = await canvas.findByRole('button', { name: 'Increase count' })

package/node_modules/@flickfyi/core/examples/parrott/fortune/fortune.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof Fortune>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/grid/grid.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof Grid>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/kale-smoothie/kale-smoothie.stories.tsx

@@ -13,6 +13,7 @@ const meta = {
 
 export default meta
 export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
 	async play({ canvasElement }) {
 		const canvas = within(canvasElement)
 		const buttons = await canvas.findAllByRole('button', {

package/node_modules/@flickfyi/core/examples/parrott/list/list.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof List>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/log/log.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof Log>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/timed-task/timed-task.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof TimedTask>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/examples/parrott/timer/timer.stories.tsx

@@ -10,4 +10,6 @@ const meta = {
 } satisfies Meta<typeof Timer>
 
 export default meta
-export const Example: StoryObj<typeof meta> = {}
+export const Example: StoryObj<typeof meta> = {
+	args: { enabledForAgents: true },
+}

package/node_modules/@flickfyi/core/fixtures/native/host/project.yml

@@ -42,6 +42,7 @@ targets:
     type: bundle.unit-test
     platform: iOS
     sources:
+      - swift/crayon-core/Tests/CrayonCoreTests/CatalogFeatureTests.swift
       - swift/crayon-core/Tests/CrayonCoreTests/CatalogNativeTests.swift
       - swift/crayon-core/Tests/CrayonCoreTests/CatalogScaleTests.swift
       - swift/crayon-core/Tests/CrayonCoreTests/CatalogThemeTests.swift
@@ -57,6 +58,8 @@ targets:
       - swift/photon/Tests/PhotonTests/PhotonTestSupport.swift
       - swift/swiftui-flex/Tests/SwiftUIFlexTests/FlexRichTextTests.swift
       - swift/swiftui-flex/Tests/SwiftUIFlexTests/FlexTextFontTests.swift
+      - path: swift/crayon-core/Tests/CrayonCoreTests/Resources/catalog-features.js
+        buildPhase: resources
       - path: swift/crayon-core/Tests/CrayonCoreTests/Resources/catalog-native.js
         buildPhase: resources
       - path: swift/crayon-core/Tests/CrayonCoreTests/Resources/catalog-scale.js

package/node_modules/@flickfyi/core/fixtures/native/src/catalog-features.tsx

@@ -0,0 +1,88 @@
+import { Flex, Text, useTheme } from '@flickfyi/core'
+import { Checklist, Goal, KowalskiStack } from '@flickfyi/core/kowalski'
+import themes from '@flickfyi/core/themes'
+import { z } from '@flickfyi/core/zod'
+
+const configured = {
+	athletic: themes.athletic({ hue: 286, mode: 'light' }),
+	compact: themes.compact({ hue: 286, mode: 'light' }),
+	kids: themes.kids({ hue: 286, mode: 'light' }),
+}
+
+// Only this test fixture substitutes the native storage boundary with session memory.
+// Native Quantum tests separately cover SQLite acknowledgements and failures.
+const stores = new Map<string, ReturnType<typeof sessionStore>>()
+Reflect.set(globalThis, 'Quantum', {
+	async openStore({
+		initialState,
+		name,
+		scope,
+		version,
+	}: Parameters<typeof Quantum.openStore>[0]) {
+		const key = `${scope}:${name}`
+		let store = stores.get(key)
+		if (!store) {
+			store = sessionStore(initialState, version)
+			stores.set(key, store)
+		}
+		return store
+	},
+})
+
+/** Runs production feature views, store hooks, atoms and the native theme cascade unchanged. */
+export default function CatalogFeatures({
+	initialTheme = 'compact',
+	showFeatures = true,
+}: {
+	initialTheme?: keyof typeof configured
+	showFeatures?: boolean
+} = {}) {
+	useTheme(configured[initialTheme])
+	return (
+		<Flex>
+			<Text>{`Catalog features · ${initialTheme}`}</Text>
+			{showFeatures ? (
+				<KowalskiStack>
+					<Checklist
+						id="NativeFeatureFirstChecklist"
+						items={[{ id: 'packed', label: 'Pack charger' }]}
+						title="First packing list"
+					/>
+					<Checklist
+						id="NativeFeatureSecondChecklist"
+						items={[{ id: 'packed', label: 'Pack notebook' }]}
+						title="Second packing list"
+					/>
+					<Goal id="NativeFeatureGoal" target={10} title="Reading goal" unit="books" />
+				</KowalskiStack>
+			) : (
+				<Text>Features unmounted</Text>
+			)}
+		</Flex>
+	)
+}
+
+function sessionStore(initialState: unknown, version: number) {
+	const schema = z.record(z.string(), z.unknown())
+	let value = schema.parse(initialState)
+	const listeners = new Set<(raw: { rawValue: unknown; version: number }) => void>()
+	const set = (patch: unknown) => {
+		value = { ...value, ...schema.parse(patch) }
+		for (const listener of listeners) {
+			listener({ rawValue: value, version })
+		}
+	}
+	return {
+		canWrite: true,
+		set,
+		async setAsync(patch: unknown) {
+			set(patch)
+			return { rawValue: value, version }
+		},
+		subscribe(listener: (raw: { rawValue: unknown; version: number }) => void) {
+			listeners.add(listener)
+			listener({ rawValue: value, version })
+			return () => listeners.delete(listener)
+		},
+	}
+}

package/node_modules/@flickfyi/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flickfyi/core",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "description": "Core type definitions and runtime environment for JavaScriptCore",
   "type": "module",
   "main": "./dist/index.js",
@@ -149,7 +149,30 @@
     "./examples/use-theme": "./examples/use-theme/use-theme.tsx",
     "./source/*": "./src/*",
     "./examples/*": "./examples/*",
-    "./examples/parrott/*.tsx": "./examples/parrott/*.tsx"
+    "./examples/parrott/*.tsx": "./examples/parrott/*.tsx",
+    "./kowalski": {
+      "import": {
+        "types": "./dist/kowalski/index.d.ts",
+        "default": "./dist/kowalski/index.js"
+      },
+      "require": {
+        "types": "./dist/kowalski/index.d.cts",
+        "default": "./dist/kowalski/index.cjs"
+      }
+    },
+    "./kowalski/catalog": {
+      "import": {
+        "types": "./dist/kowalski/catalog.d.ts",
+        "default": "./dist/kowalski/catalog.js"
+      },
+      "require": {
+        "types": "./dist/kowalski/catalog.d.cts",
+        "default": "./dist/kowalski/catalog.cjs"
+      }
+    },
+    "./examples/kowalski/theme": "./examples/kowalski/theme.ts",
+    "./examples/kowalski/*": "./examples/kowalski/*/*.tsx",
+    "./examples/kowalski/*.tsx": "./examples/kowalski/*.tsx"
   },
   "files": [
     "dist",
@@ -215,7 +238,9 @@
     "@storybook/react-vite": "10.6.1",
     "storybook": "10.6.1",
     "@types/node": "24.13.5",
-    "tsrs": "0.18.0-ts7.1.0-dev.20260929"
+    "tsrs": "0.18.0-ts7.1.0-dev.20260929",
+    "@types/luxon": "3.7.5",
+    "@types/validator": "13.15.10"
   },
   "license": "MIT",
   "publishConfig": {
@@ -225,6 +250,7 @@
   "dependencies": {
     "@flickfyi/lens": "workspace:*",
     "@flickfyi/photon": "workspace:*",
+    "@formatjs/intl": "6.1.3",
     "@react-spring/core": "10.1.2",
     "@react-spring/shared": "10.1.2",
     "@sindresorhus/is": "8.1.0",
@@ -232,15 +258,19 @@
     "@types/lodash-es": "4.17.12",
     "@use-gesture/core": "10.3.1",
     "@use-gesture/react": "10.3.1",
+    "colorjs.io": "0.7.1",
+    "decimal.js": "10.6.0",
     "effect": "4.0.0-rc.112",
+    "format-quantity": "3.2.0",
     "lodash": "4.18.1",
+    "luxon": "3.7.2",
     "microdiff": "1.6.0",
     "pluralize": "8.0.0",
     "react": "19.2.8",
     "react-timeago": "8.3.0",
     "rxjs": "7.8.2",
     "type-fest": "5.10.0",
-    "zod": "4.6.7",
-    "colorjs.io": "0.7.1"
+    "validator": "13.15.35",
+    "zod": "4.6.7"
   }
 }

package/node_modules/@flickfyi/core/package.tsgo.json

@@ -76,6 +76,18 @@
         "modules": [
           "@flickfyi/lens"
         ]
+      },
+      {
+        "name": "kowalski",
+        "dependencies": [
+          "core",
+          "ui",
+          "lens"
+        ],
+        "modules": [
+          "@flickfyi/core/kowalski",
+          "@flickfyi/core/kowalski/catalog"
+        ]
       }
     ]
   },
@@ -113,6 +125,12 @@
     "react-timeago": "8.3.0",
     "rxjs": "7.8.2",
     "type-fest": "5.10.0",
-    "zod": "4.6.7"
+    "zod": "4.6.7",
+    "@formatjs/intl": "6.1.3",
+    "decimal.js": "10.6.0",
+    "luxon": "3.7.2",
+    "validator": "13.15.35",
+    "@types/luxon": "3.7.5",
+    "@types/validator": "13.15.10"
   }
 }

package/node_modules/@flickfyi/core/scripts/vite-globals.d.ts

@@ -12,7 +12,9 @@ declare const Quantum: {
 		scope: 'private' | 'public'
 		version: number
 	}) => Promise<{
+		canWrite?: boolean
 		set: (value: unknown) => void
+		setAsync?: (value: unknown) => Promise<{ rawValue: unknown; version: number }>
 		subscribe: (
 			callback: (state: { rawValue: unknown; version: number }) => void
 		) => () => void

package/node_modules/@flickfyi/core/src/generated-types.d.ts

@@ -199,6 +199,7 @@ export interface ButtonProps {
   accessibilityLabel?: string;
   accessibilityValue?: string;
   disabled?: boolean;
+  href?: string;
   indeterminate?: boolean;
   key?: string | number;
   loading?: boolean;

package/node_modules/@flickfyi/core/src/kowalski/README.md

@@ -0,0 +1,9 @@
+# Kowalski design
+
+1. Put the UI at the bottom.
+2. As state progresses, move things up, away from the bottom.
+3. Have a focal action: break out the up-next item, at the bottom, not the top.
+4. Don't show everything, just the next few, so less is visible at any given time.
+5. Minimize the setup interface once the activity has begun.
+6. Items waiting on something else stay grey, deferred until it completes.
+7. Ideally it should fit on the screen, but don't be excessively dogmatic.

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

@@ -0,0 +1,106 @@
+import { Decimal } from 'decimal.js'
+
+import { type PickerDomain, unitDefinitions } from './catalog'
+import { format } from './format'
+
+const Money = Decimal.clone({ precision: 40, rounding: Decimal.ROUND_HALF_UP })
+
+export function elapsedSeconds(
+	state: { elapsedSeconds: number; startedAt: number | null },
+	now: number
+) {
+	return (
+		state.elapsedSeconds +
+		(state.startedAt === null ? 0 : Math.max(0, now - state.startedAt) / 1000)
+	)
+}
+
+export function billShares(
+	total: number,
+	people: number,
+	tipPercent: number,
+	currency: string
+) {
+	const digits =
+		format.formatters
+			.getNumberFormat(format.locale, { currency, style: 'currency' })
+			.resolvedOptions().maximumFractionDigits ?? 2
+	const scale = 10 ** digits
+	const minor = new Money(total)
+		.times(new Money(tipPercent).div(100).plus(1))
+		.times(scale)
+		.toDecimalPlaces(0)
+	const share = minor.dividedToIntegerBy(people)
+	return {
+		perPerson: share.div(scale).toNumber(),
+		remainder: minor.minus(share.times(people)).div(scale).toNumber(),
+		total: minor.div(scale).toNumber(),
+	}
+}
+
+export function convertUnit(
+	value: number,
+	from: keyof typeof unitDefinitions,
+	to: keyof typeof unitDefinitions
+) {
+	const source = unitDefinitions[from]
+	const target = unitDefinitions[to]
+	if (source.dimension !== target.dimension) {
+		throw new Error('Incompatible units')
+	}
+	if (from === to) {
+		return value
+	}
+	return ((value + source.offset) * source.factor) / target.factor - target.offset
+}
+
+export function localDate(now: number, timeZone: string) {
+	const parts = format.formatDateToParts(now, {
+		day: '2-digit',
+		month: '2-digit',
+		timeZone,
+		year: 'numeric',
+	})
+	return ['year', 'month', 'day']
+		.map(type => parts.find(part => part.type === type)?.value)
+		.join('-')
+}
+
+/** Recurrence is an explicit 24-hour / 7-day interval from the supplied instant. */
+export function nextReminder(
+	dueAt: string | null,
+	recurrence: 'none' | 'daily' | 'weekly',
+	now: number
+) {
+	if (!dueAt || recurrence === 'none') {
+		return null
+	}
+	const interval = (recurrence === 'daily' ? 1 : 7) * 86_400_000
+	const due = Date.parse(dueAt)
+	return new Date(
+		due + Math.max(1, Math.floor((now - due) / interval) + 1) * interval
+	).toISOString()
+}
+
+export function pickResult(domain: PickerDomain, sample: number) {
+	if (!(sample >= 0 && sample < 1)) {
+		throw new Error('Random sample must be in [0, 1)')
+	}
+	if (domain.mode === 'coin') {
+		return sample < 0.5 ? 'Heads' : 'Tails'
+	}
+	if (domain.mode === 'list') {
+		return domain.options[Math.floor(sample * domain.options.length)]
+	}
+	const [min, max] = domain.mode === 'dice' ? [1, 6] : [domain.minimum, domain.maximum]
+	return min + Math.floor(sample * (max - min + 1))
+}
+
+/** Currency padding and grouping stay identical in the saved card and its editor. */
+export function formatCurrency(value: number, currency: string) {
+	return format.formatNumber(value, {
+		currency,
+		format: 'decimal',
+		style: 'currency',
+	})
+}