| name | adapter-framework |
| description | Use when creating, modifying, reviewing, or debugging components that extend `Adapter` or `AdapterMixin`, especially when class CSS, instance CSS, inheritance, or `.define(...)` behavior matters. |
Adapter Framework
Adapter is a small, fast styling runtime for Web Components with isolated styles
and natural class-based inheritance.
It helps you build components with predictable, scoped CSS using plain
JavaScript classes and objects. Keep answers focused on package consumers, not
contribution workflow.
Install
Prefer the documented npm compatibility flow:
- npm / bundlers:
npx jsr add @devcapsule/adapter
- JSR / Deno:
import { Adapter } from "jsr:@devcapsule/adapter";
- browser ESM via CDN:
import { Adapter } from "https://cdn.jsdelivr.net/npm/@devcapsule/adapter/+esm";
Runtime guidance
Explain the package with these defaults:
- import
Adapter or AdapterMixin
- define shared component CSS with
Class.css = ... or
static { this.css = ... }
- register elements with
.define(tagName)
- use
element.css only for per-instance overrides
- use
configure(...) for class-level config such as cssProcessor
Keep these guardrails:
- Prefer
.define(tagName) as the normal registration API.
- Do not describe
static css = ... class fields as a supported pattern.
- Treat
cssProcessor as class-level only, not instance-level.
- Treat class-level CSS as the main API and instance CSS as the exception path.
References
Use this skill as the default guide for normal Adapter answers.
If deeper examples or expanded docs context are needed, repo-local references
are available under:
src/agent-skills/adapter-framework/references/
What to read next
src/agent-skills/adapter-framework/references/index.mdsrc/agent-skills/adapter-framework/references/usage/getting-started.mdsrc/agent-skills/adapter-framework/references/usage/core-concepts.mdsrc/agent-skills/adapter-framework/references/usage/patterns-and-recipes.mdsrc/agent-skills/adapter-framework/references/usage/css-processor.mdsrc/agent-skills/adapter-framework/references/usage/framework-integration.mdsrc/agent-skills/adapter-framework/references/usage/caveats-and-constraints.mdsrc/agent-skills/adapter-framework/references/usage/ai-skill.md
