@contractspec/example.learning-journey-ui-gamified 3.7.6 → 3.7.10

package/.turbo/turbo-build.log

@@ -3,12 +3,12 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=15 noBundle=false
-Bundled 15 modules in 29ms
+Bundled 15 modules in 52ms
 
   ./GamifiedMiniApp.js                            43.40 KB  (entry point)
   ./index.js                                      45.81 KB  (entry point)
   ./learning-journey-ui-gamified.feature.js       0.64 KB   (entry point)
-  views/index.js                                  40.69 KB  (entry point)
+  views/index.js                                  40.68 KB  (entry point)
   views/Overview.js                               10.46 KB  (entry point)
   views/Progress.js                               11.97 KB  (entry point)
   views/Steps.js                                  6.49 KB   (entry point)
@@ -22,7 +22,7 @@ Bundled 15 modules in 29ms
   ./example.js                                    0.93 KB   (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=15 noBundle=false
-Bundled 15 modules in 43ms
+Bundled 15 modules in 82ms
 
   ./GamifiedMiniApp.js                            43.37 KB  (entry point)
   ./index.js                                      45.78 KB  (entry point)
@@ -32,7 +32,7 @@ Bundled 15 modules in 43ms
   views/Progress.js                               11.96 KB  (entry point)
   views/Steps.js                                  6.48 KB   (entry point)
   views/Timeline.js                               11.51 KB  (entry point)
-  components/index.js                             8.93 KB   (entry point)
+  components/index.js                             8.94 KB   (entry point)
   components/DayCalendar.js                       1.91 KB   (entry point)
   components/FlashCard.js                         4.39 KB   (entry point)
   components/MasteryRing.js                       2.60 KB   (entry point)
@@ -51,7 +51,7 @@ Bundled 15 modules in 49ms
   views/Progress.js                               11.96 KB  (entry point)
   views/Steps.js                                  6.48 KB   (entry point)
   views/Timeline.js                               11.51 KB  (entry point)
-  components/index.js                             8.93 KB   (entry point)
+  components/index.js                             8.94 KB   (entry point)
   components/DayCalendar.js                       1.91 KB   (entry point)
   components/FlashCard.js                         4.39 KB   (entry point)
   components/MasteryRing.js                       2.60 KB   (entry point)

package/AGENTS.md

@@ -1,34 +1,59 @@
-# AI Agent Guide -- `@contractspec/example.learning-journey-ui-gamified`
+# AI Agent Guide — `@contractspec/example.learning-journey-ui-gamified`
 
 Scope: `packages/examples/learning-journey-ui-gamified/*`
 
-Demonstrates a Duolingo-style gamified learning UI with drills, quests, flash cards, and mastery rings.
+Duolingo-style gamified learning UI for drills and quests.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `module.learning-journey`, `lib.contracts-spec`, `lib.design-system`, `lib.ui-kit-web`, `example.learning-journey-ui-shared`, `example.learning-journey-duo-drills`, `example.learning-journey-quest-challenges`
-
-## What This Demonstrates
-
-- GamifiedMiniApp as a self-contained React application
-- FlashCard, DayCalendar, and MasteryRing components
-- Multi-view layout (Overview, Progress, Steps, Timeline)
-- Integration with duo-drills and quest-challenges tracks
-- Design system and UI kit usage patterns
-
-## Public Exports
-
-- `.` -- root barrel
-- `./GamifiedMiniApp` -- main mini-app component
-- `./components` -- FlashCard, DayCalendar, MasteryRing
-- `./views` -- Overview, Progress, Steps, Timeline views
-- `./docs` -- DocBlock documentation
-- `./example` -- runnable example entry point
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/example.learning-journey-duo-drills`, `@contractspec/example.learning-journey-quest-challenges`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-web`, ...
+
+## Architecture
+
+- `src/components/` contains reusable UI components and view composition.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/GamifiedMiniApp.tsx` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-ui-gamified.feature.ts` defines a feature entrypoint.
+- `src/views/` contains view-level composition.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./components` resolves through `./src/components/index.ts`.
+- Export `./components/DayCalendar` resolves through `./src/components/DayCalendar.tsx`.
+- Export `./components/FlashCard` resolves through `./src/components/FlashCard.tsx`.
+- Export `./components/MasteryRing` resolves through `./src/components/MasteryRing.tsx`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/learning-journey-ui-gamified.docblock` resolves through `./src/docs/learning-journey-ui-gamified.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./GamifiedMiniApp` resolves through `./src/GamifiedMiniApp.tsx`.
+- Export `./learning-journey-ui-gamified.feature` resolves through `./src/learning-journey-ui-gamified.feature.ts`.
+- The package publishes 15 total export subpaths; keep docs aligned with `package.json`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/example.learning-journey-duo-drills`, `@contractspec/example.learning-journey-quest-challenges`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-web`, ....
+- Changes here can affect downstream packages such as `@contractspec/example.learning-journey-duo-drills`, `@contractspec/example.learning-journey-quest-challenges`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-web`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @contractspec/example.learning-journey-ui-gamified
 
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/example.learning-journey-quest-challenges@3.7.10
+  - @contractspec/example.learning-journey-duo-drills@3.7.10
+  - @contractspec/example.learning-journey-ui-shared@3.7.10
+  - @contractspec/module.learning-journey@3.7.10
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.design-system@3.8.3
+  - @contractspec/lib.ui-kit-web@3.9.2
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/example.learning-journey-quest-challenges@3.7.9
+  - @contractspec/example.learning-journey-duo-drills@3.7.9
+  - @contractspec/example.learning-journey-ui-shared@3.7.9
+  - @contractspec/module.learning-journey@3.7.9
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.design-system@3.8.2
+  - @contractspec/lib.ui-kit-web@3.9.1
+
 ## 3.7.6
 
 ### Patch Changes
@@ -558,6 +586,7 @@
 - 7f3203a: fix: make workspace test runs resilient when packages have no tests
 
   Updates package test scripts to pass cleanly when no matching test files exist:
+
   - Uses `bun test --pass-with-no-tests` in Bun-based packages that currently ship without test files.
   - Uses `jest --passWithNoTests` for the UI kit web package.
   - Adds `.vscode-test.mjs` for `vscode-contractspec` so VS Code extension test runs have an explicit config and stop failing on missing default configuration.
@@ -1034,14 +1063,17 @@
   feat: Contract layers support (features, examples, app-configs)
 
   ### New CLI Commands
+
   - `contractspec list layers` - List all contract layers with filtering
 
   ### Enhanced Commands
+
   - `contractspec ci` - New `layers` check category validates features/examples/config
   - `contractspec doctor` - New `layers` health checks
   - `contractspec integrity` - Now shows layer statistics
 
   ### New APIs
+
   - `discoverLayers()` - Scan workspace for all layer files
   - `scanExampleSource()` - Parse ExampleSpec from source code
   - `isExampleFile()` - Check if file is an example spec

package/README.md

@@ -1,32 +1,75 @@
 # @contractspec/example.learning-journey-ui-gamified
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Duolingo-style gamified learning UI for drills and quests.**
 
-Duolingo-style gamified learning UI for drills and quests.
+## What This Demonstrates
 
-## Features
+- GamifiedMiniApp as a self-contained React application.
+- FlashCard, DayCalendar, and MasteryRing components.
+- Multi-view layout (Overview, Progress, Steps, Timeline).
+- Integration with duo-drills and quest-challenges tracks.
+- Design system and UI kit usage patterns.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-- **Overview**: Hero card with XP, streak, and next challenge preview
-- **Steps**: Interactive flashcard-style step cards
-- **Progress**: Mastery rings, XP bar, and badge display
-- **Timeline**: Day calendar for quests, step timeline for drills
+## Running Locally
+
+From `packages/examples/learning-journey-ui-gamified`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
 ## Usage
 
-```tsx
-import { GamifiedMiniApp } from '@contractspec/example.learning-journey-ui-gamified';
-import { drillsLanguageBasicsTrack } from '@contractspec/example.learning-journey-duo-drills/track';
+Use `@contractspec/example.learning-journey-ui-gamified` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
+
+## Architecture
+
+- `src/components/` contains reusable UI components and view composition.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/GamifiedMiniApp.tsx` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-ui-gamified.feature.ts` defines a feature entrypoint.
+- `src/views/` contains view-level composition.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./components` resolves through `./src/components/index.ts`.
+- Export `./components/DayCalendar` resolves through `./src/components/DayCalendar.tsx`.
+- Export `./components/FlashCard` resolves through `./src/components/FlashCard.tsx`.
+- Export `./components/MasteryRing` resolves through `./src/components/MasteryRing.tsx`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/learning-journey-ui-gamified.docblock` resolves through `./src/docs/learning-journey-ui-gamified.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./GamifiedMiniApp` resolves through `./src/GamifiedMiniApp.tsx`.
+- Export `./learning-journey-ui-gamified.feature` resolves through `./src/learning-journey-ui-gamified.feature.ts`.
+- The package publishes 15 total export subpaths; keep docs aligned with `package.json`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
 
-function MyApp() {
-  return (
-    <GamifiedMiniApp track={drillsLanguageBasicsTrack} initialView="overview" />
-  );
-}
-```
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
 
-## Components
+## Notes
 
-- **FlashCard** - Tappable card that reveals action on flip
-- **MasteryRing** - Circular progress indicator
-- **DayCalendar** - 7-day grid for quest progress
+- Works alongside `@contractspec/example.learning-journey-duo-drills`, `@contractspec/example.learning-journey-quest-challenges`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, ...