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

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@ $ 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 42ms
+Bundled 15 modules in 48ms
 
   ./OnboardingMiniApp.js                            45.50 KB  (entry point)
   ./index.js                                        50.35 KB  (entry point)
@@ -22,7 +22,7 @@ Bundled 15 modules in 42ms
   ./example.js                                      0.95 KB   (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=15 noBundle=false
-Bundled 15 modules in 45ms
+Bundled 15 modules in 62ms
 
   ./OnboardingMiniApp.js                            45.44 KB  (entry point)
   ./index.js                                        50.28 KB  (entry point)
@@ -41,7 +41,7 @@ Bundled 15 modules in 45ms
   ./example.js                                      0.94 KB   (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=15 noBundle=false
-Bundled 15 modules in 32ms
+Bundled 15 modules in 29ms
 
   ./OnboardingMiniApp.js                            45.44 KB  (entry point)
   ./index.js                                        50.28 KB  (entry point)

package/AGENTS.md

@@ -1,33 +1,59 @@
-# AI Agent Guide -- `@contractspec/example.learning-journey-ui-onboarding`
+# AI Agent Guide — `@contractspec/example.learning-journey-ui-onboarding`
 
 Scope: `packages/examples/learning-journey-ui-onboarding/*`
 
-Developer onboarding UI with checklists, journey maps, and step-by-step progress views.
+Developer onboarding UI with checklists and journey maps.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.ui-kit-core`, `lib.contracts-spec`, `lib.design-system`, `lib.ui-kit-web`, `module.learning-journey`, `example.learning-journey-ui-shared`, `example.learning-journey-studio-onboarding`, `example.learning-journey-platform-tour`
-
-## What This Demonstrates
-
-- React-based onboarding mini-app with checklist and journey map components
-- Multi-view layout (Overview, Progress, Steps, Timeline)
-- Shared UI component reuse across learning journey examples
-- DocBlock-driven documentation pattern
-
-## Public Exports
-
-- `.` -- root barrel
-- `./components` -- CodeSnippet, JourneyMap, StepChecklist
-- `./views` -- Overview, Progress, Steps, Timeline
-- `./OnboardingMiniApp` -- top-level mini-app component
-- `./docs` -- DocBlock documentation
-- `./example` -- runnable example entry
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/example.learning-journey-platform-tour`, `@contractspec/example.learning-journey-studio-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-core`, ...
+
+## 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/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-ui-onboarding.feature.ts` defines a feature entrypoint.
+- `src/OnboardingMiniApp.tsx` is part of the package's public or composition surface.
+- `src/views/` contains view-level composition.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./components` resolves through `./src/components/index.ts`.
+- Export `./components/CodeSnippet` resolves through `./src/components/CodeSnippet.tsx`.
+- Export `./components/JourneyMap` resolves through `./src/components/JourneyMap.tsx`.
+- Export `./components/StepChecklist` resolves through `./src/components/StepChecklist.tsx`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/learning-journey-ui-onboarding.docblock` resolves through `./src/docs/learning-journey-ui-onboarding.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-ui-onboarding.feature` resolves through `./src/learning-journey-ui-onboarding.feature.ts`.
+- Export `./OnboardingMiniApp` resolves through `./src/OnboardingMiniApp.tsx`.
+- 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-platform-tour`, `@contractspec/example.learning-journey-studio-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-core`, ....
+- Changes here can affect downstream packages such as `@contractspec/example.learning-journey-platform-tour`, `@contractspec/example.learning-journey-studio-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-core`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test --pass-with-no-tests`
-- 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,35 @@
 # @contractspec/example.learning-journey-ui-onboarding
 
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/example.learning-journey-studio-onboarding@3.7.10
+  - @contractspec/example.learning-journey-platform-tour@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-core@3.7.8
+  - @contractspec/lib.ui-kit-web@3.9.2
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/example.learning-journey-studio-onboarding@3.7.9
+  - @contractspec/example.learning-journey-platform-tour@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
+  - @contractspec/lib.ui-kit-core@3.7.7
+
 ## 3.7.6
 
 ### Patch Changes
@@ -589,6 +619,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.
@@ -1092,14 +1123,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,35 +1,75 @@
 # @contractspec/example.learning-journey-ui-onboarding
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Developer onboarding UI with checklists and journey maps.**
 
-Developer onboarding UI with checklists and journey maps.
+## What This Demonstrates
 
-## Features
+- React-based onboarding mini-app with checklist and journey map components.
+- Multi-view layout (Overview, Progress, Steps, Timeline).
+- Shared UI component reuse across learning journey examples.
+- DocBlock-driven documentation pattern.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-- **Overview**: Welcome banner with progress summary and "Get Started" CTA
-- **Steps**: Accordion-style checklist with expandable instructions
-- **Progress**: Circular progress indicator, XP bar, and step breakdown
-- **Timeline**: Journey map with surface icons and detailed step timeline
+## Running Locally
+
+From `packages/examples/learning-journey-ui-onboarding`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
 ## Usage
 
-```tsx
-import { OnboardingMiniApp } from '@contractspec/example.learning-journey-ui-onboarding';
-import { studioGettingStartedTrack } from '@contractspec/example.learning-journey-studio-onboarding/track';
-
-function MyApp() {
-  return (
-    <OnboardingMiniApp
-      track={studioGettingStartedTrack}
-      initialView="overview"
-    />
-  );
-}
-```
-
-## Components
-
-- **StepChecklist** - Expandable accordion step with completion action
-- **CodeSnippet** - Inline code display with copy button
-- **JourneyMap** - Horizontal connected node journey visualization
+Use `@contractspec/example.learning-journey-ui-onboarding` 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/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-ui-onboarding.feature.ts` defines a feature entrypoint.
+- `src/OnboardingMiniApp.tsx` is part of the package's public or composition surface.
+- `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/CodeSnippet` resolves through `./src/components/CodeSnippet.tsx`.
+- Export `./components/JourneyMap` resolves through `./src/components/JourneyMap.tsx`.
+- Export `./components/StepChecklist` resolves through `./src/components/StepChecklist.tsx`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/learning-journey-ui-onboarding.docblock` resolves through `./src/docs/learning-journey-ui-onboarding.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-ui-onboarding.feature` resolves through `./src/learning-journey-ui-onboarding.feature.ts`.
+- Export `./OnboardingMiniApp` resolves through `./src/OnboardingMiniApp.tsx`.
+- 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
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/example.learning-journey-platform-tour`, `@contractspec/example.learning-journey-studio-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, ...