{"id":"@lssm-tech/example.learning-journey-ui-shared","slug":"example.learning-journey-ui-shared","name":"@lssm-tech/example.learning-journey-ui-shared","version":"6.0.5","path":"examples/learning-journey-ui-shared","manifestPath":"examples/learning-journey-ui-shared/package.json","manifestBlobSha":"c0d866dc8ca027cb5aed0a3c139ffff3cc508d2a","layer":"examples","physicalArea":null,"primaryArea":"examples-and-patterns","classification":{"privateDeclared":null,"catalogFamily":"ui","catalogKind":"example","catalogStatus":"active","adoptionMode":"reference-only","stability":"stable"},"description":"Shared UI components and hooks for learning journey mini-apps.","descriptionOrigin":"package.json","catalog":{"family":"ui","kind":"example","status":"active","adoptionMode":"reference-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./components","./components/BadgeDisplay","./components/StreakCounter","./components/ViewTabs","./components/XpBar","./docs","./docs/learning-journey-ui-shared.docblock","./example","./hooks","./hooks/useLearningProgress","./learning-journey-ui-shared.feature","./types"],"documentation":[{"title":"Example Learning Journey Ui Shared documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.learning-journey-ui-shared","kind":"readme"}],"examples":[],"replacements":[],"nonAdoptableRationale":"This example is published for reference and learning, not as a reusable library dependency.","visualTesting":{"status":"deferred","owner":"@contractspec-core","targetWave":"wave-3-react-packages","rationale":"Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates."}},"canonicalImports":[],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","dev":"contractspec-bun-build dev","clean":"rimraf dist .turbo","lint":"bun lint:fix","lint:fix":"node ../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../scripts/biome.cjs check --write .","lint:check":"node ../../scripts/biome.cjs check .","test":"bun test --pass-with-no-tests","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-spec":"workspace:^","@lssm-tech/module.learning-journey":"workspace:^","@lssm-tech/lib.design-system":"workspace:^","@lssm-tech/lib.ui-kit-web":"workspace:^","react":"catalog:"},"devDependencies":{"@lssm-tech/tool.typescript":"workspace:*","@types/react":"catalog:types","typescript":"catalog:","@lssm-tech/tool.bun":"workspace:*"},"peerDependencies":{"react":"catalog:"},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./components":"./src/components/index.ts","./components/BadgeDisplay":"./src/components/BadgeDisplay.tsx","./components/StreakCounter":"./src/components/StreakCounter.tsx","./components/ViewTabs":"./src/components/ViewTabs.tsx","./components/XpBar":"./src/components/XpBar.tsx","./docs":"./src/docs/index.ts","./docs/learning-journey-ui-shared.docblock":"./src/docs/index.ts","./example":"./src/example.ts","./hooks":"./src/hooks/index.ts","./hooks/useLearningProgress":"./src/hooks/useLearningProgress.ts","./learning-journey-ui-shared.feature":"./src/learning-journey-ui-shared.feature.ts","./types":"./src/types.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./components":{"types":"./dist/components/index.d.ts","browser":"./dist/browser/components/index.js","bun":"./dist/components/index.js","node":"./dist/node/components/index.js","default":"./dist/components/index.js"},"./components/BadgeDisplay":{"types":"./dist/components/BadgeDisplay.d.ts","browser":"./dist/browser/components/BadgeDisplay.js","bun":"./dist/components/BadgeDisplay.js","node":"./dist/node/components/BadgeDisplay.js","default":"./dist/components/BadgeDisplay.js"},"./components/StreakCounter":{"types":"./dist/components/StreakCounter.d.ts","browser":"./dist/browser/components/StreakCounter.js","bun":"./dist/components/StreakCounter.js","node":"./dist/node/components/StreakCounter.js","default":"./dist/components/StreakCounter.js"},"./components/ViewTabs":{"types":"./dist/components/ViewTabs.d.ts","browser":"./dist/browser/components/ViewTabs.js","bun":"./dist/components/ViewTabs.js","node":"./dist/node/components/ViewTabs.js","default":"./dist/components/ViewTabs.js"},"./components/XpBar":{"types":"./dist/components/XpBar.d.ts","browser":"./dist/browser/components/XpBar.js","bun":"./dist/components/XpBar.js","node":"./dist/node/components/XpBar.js","default":"./dist/components/XpBar.js"},"./docs":{"types":"./dist/docs/index.d.ts","browser":"./dist/browser/docs/index.js","bun":"./dist/docs/index.js","node":"./dist/node/docs/index.js","default":"./dist/docs/index.js"},"./docs/learning-journey-ui-shared.docblock":{"types":"./dist/docs/index.d.ts","browser":"./dist/browser/docs/index.js","bun":"./dist/docs/index.js","node":"./dist/node/docs/index.js","default":"./dist/docs/index.js"},"./example":{"types":"./dist/example.d.ts","browser":"./dist/browser/example.js","bun":"./dist/example.js","node":"./dist/node/example.js","default":"./dist/example.js"},"./hooks":{"types":"./dist/hooks/index.d.ts","browser":"./dist/browser/hooks/index.js","bun":"./dist/hooks/index.js","node":"./dist/node/hooks/index.js","default":"./dist/hooks/index.js"},"./hooks/useLearningProgress":{"types":"./dist/hooks/useLearningProgress.d.ts","browser":"./dist/browser/hooks/useLearningProgress.js","bun":"./dist/hooks/useLearningProgress.js","node":"./dist/node/hooks/useLearningProgress.js","default":"./dist/hooks/useLearningProgress.js"},"./learning-journey-ui-shared.feature":{"types":"./dist/learning-journey-ui-shared.feature.d.ts","browser":"./dist/browser/learning-journey-ui-shared.feature.js","bun":"./dist/learning-journey-ui-shared.feature.js","node":"./dist/node/learning-journey-ui-shared.feature.js","default":"./dist/learning-journey-ui-shared.feature.js"},"./types":{"types":"./dist/types.d.ts","browser":"./dist/browser/types.js","bun":"./dist/types.js","node":"./dist/node/types.js","default":"./dist/types.js"}},"types":"./dist/index.d.ts","files":["LICENSE","README.md","dist","!**/*.test.*","!**/*.spec.*","!**/*.tsbuildinfo"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/example.learning-journey-ui-shared","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"examples/learning-journey-ui-shared/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./components","importPath":"@lssm-tech/example.learning-journey-ui-shared/components","target":"./src/components/index.ts","targets":[{"conditions":[],"target":"./src/components/index.ts","sourcePath":"examples/learning-journey-ui-shared/src/components/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/components/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./components/BadgeDisplay","importPath":"@lssm-tech/example.learning-journey-ui-shared/components/BadgeDisplay","target":"./src/components/BadgeDisplay.tsx","targets":[{"conditions":[],"target":"./src/components/BadgeDisplay.tsx","sourcePath":"examples/learning-journey-ui-shared/src/components/BadgeDisplay.tsx","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/components/BadgeDisplay.tsx","sourceStatus":"verified source file"}]},{"subpath":"./components/StreakCounter","importPath":"@lssm-tech/example.learning-journey-ui-shared/components/StreakCounter","target":"./src/components/StreakCounter.tsx","targets":[{"conditions":[],"target":"./src/components/StreakCounter.tsx","sourcePath":"examples/learning-journey-ui-shared/src/components/StreakCounter.tsx","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/components/StreakCounter.tsx","sourceStatus":"verified source file"}]},{"subpath":"./components/ViewTabs","importPath":"@lssm-tech/example.learning-journey-ui-shared/components/ViewTabs","target":"./src/components/ViewTabs.tsx","targets":[{"conditions":[],"target":"./src/components/ViewTabs.tsx","sourcePath":"examples/learning-journey-ui-shared/src/components/ViewTabs.tsx","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/components/ViewTabs.tsx","sourceStatus":"verified source file"}]},{"subpath":"./components/XpBar","importPath":"@lssm-tech/example.learning-journey-ui-shared/components/XpBar","target":"./src/components/XpBar.tsx","targets":[{"conditions":[],"target":"./src/components/XpBar.tsx","sourcePath":"examples/learning-journey-ui-shared/src/components/XpBar.tsx","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/components/XpBar.tsx","sourceStatus":"verified source file"}]},{"subpath":"./docs","importPath":"@lssm-tech/example.learning-journey-ui-shared/docs","target":"./src/docs/index.ts","targets":[{"conditions":[],"target":"./src/docs/index.ts","sourcePath":"examples/learning-journey-ui-shared/src/docs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/docs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./docs/learning-journey-ui-shared.docblock","importPath":"@lssm-tech/example.learning-journey-ui-shared/docs/learning-journey-ui-shared.docblock","target":"./src/docs/index.ts","targets":[{"conditions":[],"target":"./src/docs/index.ts","sourcePath":"examples/learning-journey-ui-shared/src/docs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/docs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./example","importPath":"@lssm-tech/example.learning-journey-ui-shared/example","target":"./src/example.ts","targets":[{"conditions":[],"target":"./src/example.ts","sourcePath":"examples/learning-journey-ui-shared/src/example.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/example.ts","sourceStatus":"verified source file"}]},{"subpath":"./hooks","importPath":"@lssm-tech/example.learning-journey-ui-shared/hooks","target":"./src/hooks/index.ts","targets":[{"conditions":[],"target":"./src/hooks/index.ts","sourcePath":"examples/learning-journey-ui-shared/src/hooks/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/hooks/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./hooks/useLearningProgress","importPath":"@lssm-tech/example.learning-journey-ui-shared/hooks/useLearningProgress","target":"./src/hooks/useLearningProgress.ts","targets":[{"conditions":[],"target":"./src/hooks/useLearningProgress.ts","sourcePath":"examples/learning-journey-ui-shared/src/hooks/useLearningProgress.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/hooks/useLearningProgress.ts","sourceStatus":"verified source file"}]},{"subpath":"./learning-journey-ui-shared.feature","importPath":"@lssm-tech/example.learning-journey-ui-shared/learning-journey-ui-shared.feature","target":"./src/learning-journey-ui-shared.feature.ts","targets":[{"conditions":[],"target":"./src/learning-journey-ui-shared.feature.ts","sourcePath":"examples/learning-journey-ui-shared/src/learning-journey-ui-shared.feature.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/learning-journey-ui-shared.feature.ts","sourceStatus":"verified source file"}]},{"subpath":"./types","importPath":"@lssm-tech/example.learning-journey-ui-shared/types","target":"./src/types.ts","targets":[{"conditions":[],"target":"./src/types.ts","sourcePath":"examples/learning-journey-ui-shared/src/types.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/src/types.ts","sourceStatus":"verified source file"}]}],"entryCount":13,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Example Learning Journey Ui Shared documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.learning-journey-ui-shared","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.learning-journey-ui-shared.txt"},"readme":{"status":"available","body":"# @lssm-tech/example.learning-journey-ui-shared\n\nWebsite: https://contractspec.io\n\n**Shared UI components and hooks for learning journey mini-apps.**\n\n## What This Demonstrates\n\n- Reusable gamification components (XpBar, StreakCounter, BadgeDisplay, ViewTabs).\n- Custom hook pattern (`useLearningProgress`) for shared state.\n- Shared types for cross-mini-app consistency.\n- `src/docs/` contains docblocks and documentation-facing exports.\n- `src/docs/` contains docblocks and documentation-facing exports.\n\n## Running Locally\n\nFrom `examples/learning-journey-ui-shared`:\n- `bun run dev`\n- `bun run build`\n- `bun run test`\n- `bun run typecheck`\n\n## Usage\n\nUse `@lssm-tech/example.learning-journey-ui-shared` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.\n\n## Architecture\n\n- `src/components/` contains reusable UI components and view composition.\n- `src/docs/` contains docblocks and documentation-facing exports.\n- `src/example.ts` is the runnable example entrypoint.\n- `src/hooks/` contains custom hooks for host applications.\n- `src/index.ts` is the root public barrel and package entrypoint.\n- `src/learning-journey-ui-shared.feature.ts` defines a feature entrypoint.\n- `src/types.ts` is shared public type definitions.\n\n## Public Entry Points\n\n- Export `.` resolves through `./src/index.ts`.\n- Export `./components` resolves through `./src/components/index.ts`.\n- Export `./components/BadgeDisplay` resolves through `./src/components/BadgeDisplay.tsx`.\n- Export `./components/StreakCounter` resolves through `./src/components/StreakCounter.tsx`.\n- Export `./components/ViewTabs` resolves through `./src/components/ViewTabs.tsx`.\n- Export `./components/XpBar` resolves through `./src/components/XpBar.tsx`.\n- Export `./docs` resolves through `./src/docs/index.ts`.\n- Export `./docs/learning-journey-ui-shared.docblock` is an alias of `./docs` and resolves through `./src/docs/index.ts`.\n- Export `./example` resolves through `./src/example.ts`.\n- Export `./hooks` resolves through `./src/hooks/index.ts`.\n- The package publishes 13 total export subpaths; keep docs aligned with `package.json`.\n\n## Local Commands\n\n- `bun run dev` — contractspec-bun-build dev\n- `bun run build` — contractspec-bun-build build\n- `bun run test` — bun test --pass-with-no-tests\n- `bun run lint` — bun lint:fix\n- `bun run lint:check` — biome check .\n- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .\n- `bun run typecheck` — tsgo --noEmit\n- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose\n- `bun run publish:pkg:canary` — bun publish:pkg --tag canary\n- `bun run clean` — rimraf dist .turbo\n- `bun run build:bundle` — contractspec-bun-build transpile\n- `bun run build:types` — contractspec-bun-build types\n- `bun run prebuild` — contractspec-bun-build prebuild\n\n## Recent Updates\n\n- Replace eslint+prettier by biomejs to optimize speed.\n- Missing contract layers.\n\n## Notes\n\n- Works alongside `@lssm-tech/lib.contracts-spec`, `@lssm-tech/lib.design-system`, `@lssm-tech/lib.ui-kit-web`, `@lssm-tech/module.learning-journey`, `@lssm-tech/tool.bun`, ...\n","sourcePath":"examples/learning-journey-ui-shared/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/learning-journey-ui-shared/README.md","blobSha":"fdd8b7e75678974be8f5ebfdf2659588ac71fddc","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"examples-and-patterns","areaTitle":"Examples and implementation patterns","displayName":"example.learning-journey-ui-shared","runtimes":["node"],"platforms":["server"],"kind":"example","scope":"Package manifest","canonicalRoute":"/docs/packages/example.learning-journey-ui-shared/","contextUrl":"/docs/packages/example.learning-journey-ui-shared.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}