feat: add value getter to the store selctor for easy access to the selected slice of the state

[fredericbahr]

🎯 Changes

Added value-setter in the Lit TanstackStoreSelector for easy access to lifecycle-aware fine-grained reactivity.
This aligns with the react-hook which also returns the value directly: const count = useSelector(counterStore, (state) => state.count)

Additonally this helps using @tanstack/lit-table internally for the Subscribe function, which im currently trying to reimplement (TanStack/table#6267).

Added

• Added TanstackStoreSelctor.value getter for direct access to selected state

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

• New Features

  • Added a public value getter to access the currently selected store value directly.

• Documentation

  • Updated quick-start examples to demonstrate selector-driven rerenders and direct store value access patterns with clearer template output.

• Tests

  • Added a test verifying selector-driven updates reflect in rendered output.

• Chores

  • Updated release notes/changeset to document the minor version bump.

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR adds a public value getter to TanStackStoreSelector (exposes the last selected value), expands JSDoc with usage examples, adds a test verifying rendered updates when the selector value changes, updates the quick-start docs to demonstrate .value usage, and includes a changeset for a minor release.

Changes

TanStackStoreSelector value getter

Layer / File(s)	Summary
TanStackStoreSelector.value getter and JSDoc packages/lit-store/src/tan-stack-store-selector.ts	Added comprehensive JSDoc describing subscription and rerender semantics, and a public value getter that returns the last selected value or undefined.
Selector test suite and value getter test packages/lit-store/tests/selector.test.ts	Removed async modifier from the top-level describe and added a vitest test that verifies a component using TanStackStoreSelector updates its rendered output when the store state changes.
Quick-start documentation and examples docs/framework/lit/quick-start.md	Updated quick-start to explain two usage patterns: selector-driven rerenders and direct .value access. Revised AnimalDisplay example to render counter.value and also show store.state[animal].
Changeset entry .changeset/light-cobras-live.md	Added/updated changeset declaring a minor release and noting the added value getter on TanStackStoreSelector.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 A tiny getter, tucked away neat,
Watches selections and keeps them sweet,
Templates sip .value with delight,
Tests clap paws when the UI gets it right,
Docs tell the tale in lines concise and neat.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: adding a value getter to the store selector for easy access to the selected state slice.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description check	✅ Passed	The PR description follows the required template structure with all key sections completed: Changes section explaining the addition and motivation, completed checklist items, and correct Release Impact selection.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/framework/lit/quick-start.md`:
- Line 8: Update the opening line to be a complete sentence by expanding the
fragment to something like "The `TanStackStoreSelector` can be used in two
ways." Locate the line referencing `TanStackStoreSelector` in the quick-start
content and replace the fragment with the full sentence form so it reads
grammatically complete and clear.

In `@packages/lit-store/src/tan-stack-store-selector.ts`:
- Line 31: Update the JSDoc examples for TanStackStoreSelector to use correct,
copy-pastable symbols and remove stray formatting: replace the invalid reference
`TanStackStoreAtom` with the intended class/name (TanStackStoreSelector) and
remove backticks around instance property examples like `#name` so the snippet
shows valid JS/TS usage (e.g., const name = new TanStackStoreSelector(...); or
selector.name) in both example blocks that reference the selector; ensure the
example code compiles and matches the actual API surface of
TanStackStoreSelector.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 07a835dd-8b5b-4fd3-b7fd-c01ba7caebc6

📥 Commits

Reviewing files that changed from the base of the PR and between 09139b1 and e548931.

📒 Files selected for processing (3)

• docs/framework/lit/quick-start.md
• packages/lit-store/src/tan-stack-store-selector.ts
• packages/lit-store/tests/selector.test.ts