{"id":"@lssm-tech/example.form-showcase","slug":"example.form-showcase","name":"@lssm-tech/example.form-showcase","version":"3.0.5","path":"examples/form-showcase","manifestPath":"examples/form-showcase/package.json","manifestBlobSha":"4ee44b647848c41700a109590cf87d7c2ca0fc1d","layer":"examples","physicalArea":null,"primaryArea":"examples-and-patterns","classification":{"privateDeclared":null,"catalogFamily":"solutions","catalogKind":"example","catalogStatus":"active","adoptionMode":"reference-only","stability":"stable"},"description":"Focused ContractSpec form example and template covering field kinds, conditional rules, and layout flows.","descriptionOrigin":"package.json","catalog":{"family":"solutions","kind":"example","status":"active","adoptionMode":"reference-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./docs","./example","./forms","./forms/all-fields.form","./forms/entity-projections.form","./forms/form-showcase.docs","./forms/progressive-steps.form","./proof-config","./ui","./ui/FormShowcasePreview"],"documentation":[{"title":"Example Form Showcase documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.form-showcase","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":{"build":"contractspec-bun-build build","typecheck":"tsgo --noEmit","test":"bun test","smoke":"bun test src/example.smoke.test.ts","preflight":"bun run build && bun run typecheck && bun run test && bun run smoke","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-spec":"workspace:^","@lssm-tech/lib.design-system":"workspace:^","@lssm-tech/lib.schema":"workspace:^","react":"catalog:","react-dom":"catalog:","zod":"catalog:"},"devDependencies":{"@types/react":"catalog:types","@types/react-dom":"catalog:types","@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:","@lssm-tech/tool.bun":"workspace:*"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./docs":"./src/docs/index.ts","./example":"./src/example.ts","./forms":"./src/forms/index.ts","./forms/all-fields.form":"./src/forms/all-fields.form.ts","./forms/entity-projections.form":"./src/forms/entity-projections.form.ts","./forms/form-showcase.docs":"./src/forms/form-showcase.docs.ts","./forms/progressive-steps.form":"./src/forms/progressive-steps.form.ts","./proof-config":"./src/proof-config.ts","./ui":"./src/ui/index.ts","./ui/FormShowcasePreview":"./src/ui/FormShowcasePreview.tsx"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.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"},"./example":{"types":"./dist/example.d.ts","browser":"./dist/browser/example.js","bun":"./dist/example.js","node":"./dist/node/example.js","default":"./dist/example.js"},"./forms":{"types":"./dist/forms/index.d.ts","browser":"./dist/browser/forms/index.js","bun":"./dist/forms/index.js","node":"./dist/node/forms/index.js","default":"./dist/forms/index.js"},"./forms/all-fields.form":{"types":"./dist/forms/all-fields.form.d.ts","browser":"./dist/browser/forms/all-fields.form.js","bun":"./dist/forms/all-fields.form.js","node":"./dist/node/forms/all-fields.form.js","default":"./dist/forms/all-fields.form.js"},"./forms/entity-projections.form":{"types":"./dist/forms/entity-projections.form.d.ts","browser":"./dist/browser/forms/entity-projections.form.js","bun":"./dist/forms/entity-projections.form.js","node":"./dist/node/forms/entity-projections.form.js","default":"./dist/forms/entity-projections.form.js"},"./forms/form-showcase.docs":{"types":"./dist/forms/form-showcase.docs.d.ts","browser":"./dist/browser/forms/form-showcase.docs.js","bun":"./dist/forms/form-showcase.docs.js","node":"./dist/node/forms/form-showcase.docs.js","default":"./dist/forms/form-showcase.docs.js"},"./forms/progressive-steps.form":{"types":"./dist/forms/progressive-steps.form.d.ts","browser":"./dist/browser/forms/progressive-steps.form.js","bun":"./dist/forms/progressive-steps.form.js","node":"./dist/node/forms/progressive-steps.form.js","default":"./dist/forms/progressive-steps.form.js"},"./proof-config":{"types":"./dist/proof-config.d.ts","browser":"./dist/browser/proof-config.js","bun":"./dist/proof-config.js","node":"./dist/node/proof-config.js","default":"./dist/proof-config.js"},"./ui":{"types":"./dist/ui/index.d.ts","browser":"./dist/browser/ui/index.js","bun":"./dist/ui/index.js","node":"./dist/node/ui/index.js","default":"./dist/ui/index.js"},"./ui/FormShowcasePreview":{"types":"./dist/ui/FormShowcasePreview.d.ts","browser":"./dist/browser/ui/FormShowcasePreview.js","bun":"./dist/ui/FormShowcasePreview.js","node":"./dist/node/ui/FormShowcasePreview.js","default":"./dist/ui/FormShowcasePreview.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.form-showcase","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"examples/form-showcase/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./docs","importPath":"@lssm-tech/example.form-showcase/docs","target":"./src/docs/index.ts","targets":[{"conditions":[],"target":"./src/docs/index.ts","sourcePath":"examples/form-showcase/src/docs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/docs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./example","importPath":"@lssm-tech/example.form-showcase/example","target":"./src/example.ts","targets":[{"conditions":[],"target":"./src/example.ts","sourcePath":"examples/form-showcase/src/example.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/example.ts","sourceStatus":"verified source file"}]},{"subpath":"./forms","importPath":"@lssm-tech/example.form-showcase/forms","target":"./src/forms/index.ts","targets":[{"conditions":[],"target":"./src/forms/index.ts","sourcePath":"examples/form-showcase/src/forms/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/forms/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./forms/all-fields.form","importPath":"@lssm-tech/example.form-showcase/forms/all-fields.form","target":"./src/forms/all-fields.form.ts","targets":[{"conditions":[],"target":"./src/forms/all-fields.form.ts","sourcePath":"examples/form-showcase/src/forms/all-fields.form.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/forms/all-fields.form.ts","sourceStatus":"verified source file"}]},{"subpath":"./forms/entity-projections.form","importPath":"@lssm-tech/example.form-showcase/forms/entity-projections.form","target":"./src/forms/entity-projections.form.ts","targets":[{"conditions":[],"target":"./src/forms/entity-projections.form.ts","sourcePath":"examples/form-showcase/src/forms/entity-projections.form.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/forms/entity-projections.form.ts","sourceStatus":"verified source file"}]},{"subpath":"./forms/form-showcase.docs","importPath":"@lssm-tech/example.form-showcase/forms/form-showcase.docs","target":"./src/forms/form-showcase.docs.ts","targets":[{"conditions":[],"target":"./src/forms/form-showcase.docs.ts","sourcePath":"examples/form-showcase/src/forms/form-showcase.docs.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/forms/form-showcase.docs.ts","sourceStatus":"verified source file"}]},{"subpath":"./forms/progressive-steps.form","importPath":"@lssm-tech/example.form-showcase/forms/progressive-steps.form","target":"./src/forms/progressive-steps.form.ts","targets":[{"conditions":[],"target":"./src/forms/progressive-steps.form.ts","sourcePath":"examples/form-showcase/src/forms/progressive-steps.form.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/forms/progressive-steps.form.ts","sourceStatus":"verified source file"}]},{"subpath":"./proof-config","importPath":"@lssm-tech/example.form-showcase/proof-config","target":"./src/proof-config.ts","targets":[{"conditions":[],"target":"./src/proof-config.ts","sourcePath":"examples/form-showcase/src/proof-config.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/proof-config.ts","sourceStatus":"verified source file"}]},{"subpath":"./ui","importPath":"@lssm-tech/example.form-showcase/ui","target":"./src/ui/index.ts","targets":[{"conditions":[],"target":"./src/ui/index.ts","sourcePath":"examples/form-showcase/src/ui/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/ui/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./ui/FormShowcasePreview","importPath":"@lssm-tech/example.form-showcase/ui/FormShowcasePreview","target":"./src/ui/FormShowcasePreview.tsx","targets":[{"conditions":[],"target":"./src/ui/FormShowcasePreview.tsx","sourcePath":"examples/form-showcase/src/ui/FormShowcasePreview.tsx","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/src/ui/FormShowcasePreview.tsx","sourceStatus":"verified source file"}]}],"entryCount":11,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Example Form Showcase documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.form-showcase","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.form-showcase.txt"},"readme":{"status":"available","body":"# @lssm-tech/example.form-showcase\n\nFocused ContractSpec form example and template covering field kinds, conditional rules, and layout flows.\n\n## What This Demonstrates\n\n- Schema-backed `defineFormSpec` authoring with `fromZod`.\n- Every current form field kind: text, email, textarea, select, checkbox, radio, switch, autocomplete, address, phone, date, time, datetime, group, and array.\n- Layout variants including responsive columns, full-width spans, section flows, step flows, nested groups, horizontal/responsive orientation, and repeated group arrays.\n- Form metadata for input groups, password fields, read-only/computed hints, conditional visibility/enabled/required rules, custom constraints, PII hints, and submit actions.\n- A `FormRegistry` that downstream apps can import and filter, including entity projection form metadata.\n- A `FormShowcasePreview` UI that demonstrates the specs with real form controls across field kinds, sections, arrays, groups, and step layouts.\n\n## Running Locally\n\nFrom `examples/form-showcase`:\n\n- `bun run build`\n- `bun run typecheck`\n- `bun run test`\n- `bun run smoke`\n- `bun run preflight`\n\n## Usage\n\nImport the registry or individual form specs:\n\n```ts\nimport {\n\tFormShowcaseRegistry,\n\tFormShowcaseAllFieldsForm,\n\tFormShowcaseProgressiveStepsForm,\n} from \"@lssm-tech/example.form-showcase/forms\";\n```\n\nUse this package as a form-only template when you want a compact reference for ContractSpec form authoring without a larger business app around it. Import `@lssm-tech/example.form-showcase/proof-config` when tooling needs the stable docs, sandbox, templates, forms, and UI entrypoint map without reaching into private preview helpers.\n\n## Proof map and boundaries\n\nThe public proof map is intentionally stable and package-local:\n\n- Docs routes: `/docs/examples/form-showcase`, `/docs/examples/form-showcase/usage`, and `/docs/examples/form-showcase/proof-config`.\n- Sandbox route: `/sandbox?template=form-showcase`.\n- Template route: `/templates?tag=forms`.\n- Public entrypoints: the package barrel, `./example`, `./forms`, `./docs`, `./proof-config`, and `./ui`.\n\nPrivate proof helpers under `src/ui/proof/*` and preview data/model files stay implementation details. Tooling should read `@lssm-tech/example.form-showcase/proof-config` instead of deep-importing those helpers.\n\nWhen a form-configuration panel is needed, reuse the design-system `FormConfigShell`, `FormConfigMenuBar`, and `FormConfigPanel` exports from `@lssm-tech/lib.design-system/forms`. The showcase proof should not fork a local configuration shell.\n\nNo persistence, backend, auth, provider, credential custody, or production form-storage guarantee is implied by this example. Capture/readiness proof state is deterministic fixture state only.\n\n## Public Entry Points\n\n- `@lssm-tech/example.form-showcase`\n- `@lssm-tech/example.form-showcase/example`\n- `@lssm-tech/example.form-showcase/forms`\n- `@lssm-tech/example.form-showcase/forms/all-fields.form`\n- `@lssm-tech/example.form-showcase/forms/entity-projections.form`\n- `@lssm-tech/example.form-showcase/forms/form-showcase.docs`\n- `@lssm-tech/example.form-showcase/forms/progressive-steps.form`\n- `@lssm-tech/example.form-showcase/proof-config`\n- `@lssm-tech/example.form-showcase/docs`\n- `@lssm-tech/example.form-showcase/ui`\n- `@lssm-tech/example.form-showcase/ui/FormShowcasePreview`\n\nPrivate proof/state helpers under `src/ui/proof/*`, any screen-model internals under `src/ui/screens/*`, and non-existent deep proof shortcuts such as `@lssm-tech/example.form-showcase/proof` are intentionally not package exports. Use `@lssm-tech/example.form-showcase/proof-config` for the stable proof map instead of deep imports.\n\n## Notes\n\n- This package intentionally does not ship a production custom renderer. Its preview uses real controls and the same sample data to demonstrate the contract capabilities, while host apps can map `FieldSpec` objects to their own design-system components for fully interactive forms.\n- The example is available in the templates catalog through `surfaces.templates: true`.\n- The proof/config preview is deterministic and in-memory only: it does not require persistence, backend routes, authentication, credentials, or network access.\n\nDeclaration builds use `build:types` through the shared Bun tool; `build` runs\nbundle and declaration generation. Declared exports are preserved. Generated\nartifacts exclude test-only files; tests/typecheck remain separate gates.\n","sourcePath":"examples/form-showcase/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/form-showcase/README.md","blobSha":"82a7004be6193fc5bf1adf27016afcf3a9279729","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.form-showcase","runtimes":["node"],"platforms":["server"],"kind":"example","scope":"Package manifest","canonicalRoute":"/docs/packages/example.form-showcase/","contextUrl":"/docs/packages/example.form-showcase.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}