feat(core): add passage display model

[cameronapak]

Summary

• add a high-level getPassageDisplay API for transformed Bible HTML, current attribution, stylesheet descriptors, and required container attributes
• preserve a declarative core boundary with no DOM mutation, resource injection, or attribution caching
• document the contract and decision, expose tree-shakable helpers, and add a core minor changeset

Behavior

• always returns transformed HTML
• fetches passage and version metadata concurrently when filters permit
• prefers copyright attribution, falls back to promotional content, and fails closed when neither exists
• provides the versioned Bible CSS and Fonts API stylesheet for permanent Untitled Serif font ID 1

Verification

• pnpm lint
• YVP_API_HOST=api.youversion.com pnpm --filter @youversion/platform-core test (22 files, 442 tests)
• pnpm check:tree-shaking
• pnpm --filter @youversion/platform-core build

Greptile Summary

Adds a declarative core passage-display API for transformed Bible HTML, current attribution, stylesheet descriptors, and required container attributes.

• Fetches and schema-validates passage and version data while respecting configured version filters.
• Exposes focused display-resource helpers and package entry points with tree-shaking checks.
• Adds documentation, tests, CDN CSS-major validation, and a core minor changeset.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
packages/core/src/bible-passage-display.ts	Introduces the display-model orchestration, version-filter handling, attribution selection, and declarative resource assembly.
packages/core/src/bible-passage.ts	Extracts validated passage fetching and adds schema validation at the API response boundary.
packages/core/src/bible-display-resources.ts	Defines stable Bible CSS and configured Fonts API stylesheet descriptors without DOM side effects.
packages/core/src/schemas/passage-display.ts	Defines schema-first input and output contracts for the new public display model.
packages/core/src/tests/bible-passage-display.test.ts	Covers display output, attribution behavior, filters, concurrency, validation, and explicit per-test HTTP setup; the previous hidden-handler concern is resolved.
scripts/check-cdn-css-major.mjs	Adds a lint-time consistency guard between the core stylesheet URL and the UI CDN compatibility major.
scripts/check-tree-shaking.mjs	Extends consumer-bundle checks to verify that the focused stylesheet helper remains isolated from display orchestration.

Sequence Diagram

sequenceDiagram
    participant App as Consumer
    participant Display as getPassageDisplay
    participant API as Platform API
    participant Transform as HTML Transformer
    App->>Display: versionId, passageId, options
    par When filters permit concurrency
        Display->>API: Fetch passage HTML
        Display->>API: Fetch version metadata
    end
    API-->>Display: Passage and version
    Display->>Transform: Transform passage HTML
    Transform-->>Display: Display-ready HTML
    Display->>Display: Select current attribution
    Display-->>App: HTML, attribution, stylesheets, container attributes

Loading

_{Reviews (4): Last reviewed commit: "fix(core): simplify passage display boun..." | Re-trigger Greptile}

Context used (4)

• Knowledge Base — Core platform SDK
• Knowledge Base — Core API clients and data contracts
• Knowledge Base — Bible content services
• Knowledge Base — Monorepo build, validation, and release

[changeset-bot]

🦋 Changeset detected

Latest commit: 4e7793c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@youversion/platform-core	Minor
@youversion/platform-react-hooks	Minor
@youversion/platform-react-ui	Minor
vite-react	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR