Add Interactive Surface data hook support

[Foscat]

Add data-surface-variant aliases and standalone surface-level defaults for bridge-generated and runtime-assigned markup.

Update docs, demo coverage, release notes, and package metadata for the 1.3.0 API contract.

Summary

Describe the change and why it is needed.

Scope

• bug fix
• feature
• docs
• tests
• release/chore

Validation

List commands you ran and results.

npm run lint:css
npm run test:install
npm test
npm run pack:dry

API and Behavior Impact

• no public API changes
• class API changed
• token contract changed
• accessibility behavior changed
• motion behavior changed
• browser behavior changed

Documentation

• README updated (if needed)
• wiki updated (if needed)
• CHANGELOG updated (if needed)

Notes

Anything reviewers should focus on.

[Copilot]

Pull request overview

This PR updates Interactive Surface CSS to support runtime-assigned “surface intent” via data attributes, adds standalone depth defaults for data-surface-level, and refreshes docs/demo/release metadata for the 1.3.0 contract.

Changes:

• Add data-surface-variant="…" selectors as aliases for existing .variant-* classes.
• Add per-level defaults for data-surface-level="1|2|3" (depth + state-layer opacity hooks) and expand Playwright coverage.
• Update docs/demo/release notes and bump package version to 1.3.0.

Reviewed changes

Copilot reviewed 14 out of 15 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
wiki/Token-Reference.md	Documents UI Style Kit 2.x bridge expectations and new per-level token hooks.
wiki/Testing-and-Quality.md	Updates stated Playwright coverage to include data-hook parity and level defaults.
wiki/Installation-and-Usage.md	Adds data-attribute usage examples and clarifies bridge + standalone hook behavior.
wiki/Home.md	Updates displayed current version/tag to 1.3.0 and adds data-hook example.
wiki/Getting-Started.md	Adds runtime-assigned surface intent example using data attributes.
wiki/API-Reference.md	Documents data attribute API for variants and introduces surface level documentation.
tests/interactive-surface.spec.ts	Adds tests for data-variant parity and surface-level default depth/state values.
tests/example.spec.ts	Adds test ensuring token editor modal semantics exist only while open.
README.md	Adds data attribute API docs and ecosystem integration section; updates release checklist example tag.
package.json	Bumps package version to 1.3.0.
package-lock.json	Updates lockfile package version entries to 1.3.0.
interactive-surface.css	Implements data-surface-variant aliases and adds standalone per-level defaults for data-surface-level.
index.html	Updates demo markup to use data hooks, refines token editor modal semantics, and refreshes embedded docs snippets.
docs/superpowers/specs/2026-07-08-interactive-surface-data-hooks.md	Adds a spec/follow-up doc describing the new public hooks and verification targets.
CHANGELOG.md	Adds 1.3.0 release notes for the new data hooks, level defaults, and coverage/docs updates.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.