Skip to content

Kineto v0.11.0

Choose a tag to compare

@github-actions github-actions released this 19 Sep 06:55
· 231 commits to main since this release
7c9d9b0

Kineto v0.11.0

English

  • Add Kineto.observe(root?, { scan, attributes }), the 29th Core API: a MutationObserver-based live-DOM mode that scans the root once, attaches modules to data-kt-* elements added later (batched per microtask), releases the instances of elements that leave the DOM, optionally reacts to data-kt-* attribute changes, stays idempotent per root, returns an inert handle during SSR, and is disconnected by a global destroy(). Covered by tests/observe.mjs and typed in types/index.d.ts.
  • Add the integration map kineto.integrations.json (+ JSON schema): twelve ecosystems (vanilla, shadcn/ui, Tailwind, Bootstrap 5, MUI, Mantine, Chakra UI, Ant Design, daisyUI, Nuxt UI, PrimeVue, Vuetify) with attach patterns, what each library already provides and the combinations to avoid; thirty design intents (hero headline, section entrance, card hover, KPI number, image loading, dialog enter/exit, toast, marquee, page transition …) with contract-validated recipes, English/Korean keywords and Figma layer-name patterns; and a Figma MCP workflow. npm run integrations:build generates docs/integrations/*.md, the agent rules ai/kineto.rules.md, the Cursor rule ai/cursor/kineto.mdc, site/llms.txt and site/ai/kineto.rules.md; tests/integrations-contract.mjs checks every recipe, attribute and snippet against the feature contract and fails when a generated file is stale.
  • Publish a shadcn registry from the demo site (registry/ → site/r/registry.json + site/r/<name>.json, namespace @kineto → https://kineto.dongri.me/r/{name}.json): typed React wrappers provider (mounts Kineto.observe()), reveal, text-reveal, counter, image, marquee, tilt-card, magnetic-button, presence, page-reveal, the shared utils lib and an ai-rules item that installs the Cursor rule and Markdown rules into a project. scripts/build-registry.mjs validates the sources (kebab names, 'use client', URL-form registry dependencies, scoped package imports) and npm run build regenerates the site copies.
  • Prove the map against the real libraries in a new locked fixture tests/integrations/ (test:integrations): MUI, Mantine, Chakra UI and Ant Design components forward data-kt-* props (server render → jsdom → Kineto.scan()), a React client render is attached and released by Kineto.observe(), Vuetify and PrimeVue let attrs fall through under SSR, every registry component type-checks under strict TypeScript with the real React types, and the shadcn CLI installs the items into a fresh project both by URL and through the @kineto namespace.
  • Add a Bootstrap 5 coexistence example (examples/bootstrap/index.html: sticky navbar with a Kineto reading-progress bar, textSplit hero, modal trigger with ripple + magnetic, Bootstrap-only tooltip, staggered KPI counters, tilt/glow cards with lazy images, a Bootstrap carousel and accordion left to Bootstrap, a marquee, dynamic cards and toasts) and drive it in Chromium (tests/integrations/bootstrap-qa.mjs): the pinned CDN files must match the installed bootstrap package byte for byte (SRI verified offline), Bootstrap keeps owning modal focus, tooltip, accordion and carousel while Kineto instances live on the same elements, observe() attaches to and releases dynamic cards/toasts, destroy() leaves Bootstrap intact, and no library logs an error.
  • Add the Kineto MCP server package packages/kineto-mcp (@dong-gri/kineto-mcp, stdio only, not yet published): kineto_suggest, kineto_figma_layers, kineto_snippet, kineto_validate_options (with "did you mean" hints), kineto_module, kineto_list_modules, kineto_ecosystem; resources kineto://rules|integrations|features|meta; prompt kineto_apply_motion. It answers from contract copies synced by scripts/build-mcp.mjs (checked by the contract test), validates every input with bounded schemas, and is exercised end to end over stdio by npm run test:mcp in CI.
  • Scope the Pages deploy concurrency group to real deploys (demo-site-main for main pushes and manual dispatch, a run-scoped group otherwise): a Dependabot-branch CI completion previously entered the shared demo-site group as a skipped workflow_run and cancelled the in-flight v0.10.0 deploy, leaving kineto.dongri.me on the previous build. Locked by tests/release-automation.mjs; RELEASING documents the re-deploy path.
  • Extend the repository gates to the new packages: audited lockfiles, Dependabot, lockfile-boundary (publishable package kind) and supply-chain floors (picomatch is now checked per major line — the shadcn CLI still needs the patched 2.3.2 line via micromatch), test:observe/test:integrations/test:mcp in test:node and both workflows, ESLint over the fixture and the MCP package, and README (all seven languages), docs index, getting started and the AI prompt guide now cover observe(), the integration guides, the registry and the MCP server. The React/Vue/jQuery example READMEs install the scoped @dong-gri/kineto package instead of the unscoped name.
  • Record the verified v0.10.0 release: successful CI and Release runs, byte-identical npm/GitHub tarballs with matching provenance subject and release commit, and the cancelled canonical Pages deploy with its cause and fix.
  • Give the MCP server its own release path: scripts/release-targets.mjs maps tag prefixes to packages (v* → @dong-gri/kineto, mcp-v* → @dong-gri/kineto-mcp), npm run release:ship routes through it, scripts/check-mcp-release.mjs validates tag ↔ version, byte-identical contract copies, the package changelog and the bilingual note, and .github/workflows/release-mcp.yml verifies the tagged source, packs one digest-checked tarball and publishes it with provenance from a least-privilege job before creating the GitHub Release; release:prepare now also tracks the linked root version in tests/integrations/package-lock.json.

한국어

  • 29번째 Core API Kineto.observe(root?, { scan, attributes })를 추가했습니다. MutationObserver 기반 라이브 DOM 모드로, root를 한 번 스캔한 뒤 나중에 추가되는 data-kt-* 요소를 마이크로태스크 단위로 묶어 붙이고, DOM에서 빠진 요소의 인스턴스를 정리하며, 선택적으로 data-kt-* 속성 변경에 반응합니다. root당 한 번만 유지되고 SSR에서는 비활성 핸들을 돌려주며 전역 destroy()가 함께 해제합니다. tests/observe.mjs로 검증하고 types/index.d.ts에 타입을 추가했습니다.
  • 연동 지도 kineto.integrations.json(+ JSON 스키마)을 추가했습니다. 12개 생태계(vanilla, shadcn/ui, Tailwind, Bootstrap 5, MUI, Mantine, Chakra UI, Ant Design, daisyUI, Nuxt UI, PrimeVue, Vuetify)의 붙이는 방식·라이브러리가 이미 제공하는 것·피해야 할 조합, 30개 디자인 의도(히어로 헤드라인, 섹션 등장, 카드 호버, KPI 숫자, 이미지 로딩, 다이얼로그 진입/퇴장, 토스트, 마퀴, 페이지 전환 …)의 계약 검증 레시피와 영/한 키워드·Figma 레이어 이름 패턴, Figma MCP 워크플로우를 담습니다. npm run integrations:build가 docs/integrations/*.md, 에이전트 규칙 ai/kineto.rules.md, Cursor 규칙 ai/cursor/kineto.mdc, site/llms.txt, site/ai/kineto.rules.md를 생성하고, tests/integrations-contract.mjs가 모든 레시피·속성·스니펫을 기능 계약과 대조하며 생성물이 오래되면 실패합니다.
  • 데모 사이트에서 shadcn 레지스트리를 제공합니다(registry/ → site/r/registry.json + site/r/<name>.json, 네임스페이스 @kineto → https://kineto.dongri.me/r/{name}.json). 타입 지원 React 래퍼 provider(Kineto.observe() 마운트), reveal, text-reveal, counter, image, marquee, tilt-card, magnetic-button, presence, page-reveal, 공용 utils, 그리고 Cursor 규칙과 Markdown 규칙을 프로젝트에 설치하는 ai-rules 항목입니다. scripts/build-registry.mjs가 원본을 검증하고(kebab 이름, 'use client', URL 형식 registry 의존성, scoped 패키지 import) npm run build가 사이트 사본을 재생성합니다.
  • 새 잠금 fixture tests/integrations/(test:integrations)에서 지도를 실제 라이브러리로 증명합니다. MUI·Mantine·Chakra UI·Ant Design 컴포넌트가 data-kt-* prop을 DOM으로 전달하고(서버 렌더 → jsdom → Kineto.scan()), React 클라이언트 렌더를 Kineto.observe()가 붙이고 해제하며, Vuetify·PrimeVue가 SSR에서 attrs를 통과시키고, 모든 레지스트리 컴포넌트가 실제 React 타입으로 strict TypeScript를 통과하고, shadcn CLI가 URL과 @kineto 네임스페이스 두 방식으로 새 프로젝트에 항목을 설치합니다.
  • Bootstrap 5 공존 예제(examples/bootstrap/index.html: Kineto 읽기 진행 막대를 단 sticky 내비게이션, textSplit 히어로, ripple+magnetic 모달 트리거, Bootstrap 전용 툴팁, stagger KPI 카운터, lazy 이미지를 넣은 tilt/glow 카드, Bootstrap에 맡긴 캐러셀·아코디언, 마퀴, 동적 카드·토스트)를 추가하고 Chromium에서 구동합니다(tests/integrations/bootstrap-qa.mjs). 고정한 CDN 파일이 설치된 bootstrap 패키지와 바이트 단위로 일치해야 하고(SRI를 오프라인에서 검증), 모달 포커스·툴팁·아코디언·캐러셀은 Bootstrap이 계속 소유하면서 같은 요소에 Kineto 인스턴스가 살아 있고, observe()가 동적 카드·토스트를 붙이고 해제하며, destroy() 뒤에도 Bootstrap이 온전하고, 두 라이브러리 모두 오류를 남기지 않아야 합니다.
  • Kineto MCP 서버 패키지 packages/kineto-mcp(@dong-gri/kineto-mcp, stdio 전용, 아직 미게시)를 추가했습니다. kineto_suggest, kineto_figma_layers, kineto_snippet, kineto_validate_options(“혹시 이 옵션?” 힌트 포함), kineto_module, kineto_list_modules, kineto_ecosystem 도구와 kineto://rules|integrations|features|meta 리소스, kineto_apply_motion 프롬프트를 제공합니다. scripts/build-mcp.mjs가 동기화하는 계약 사본(계약 테스트가 검사)에서만 답하고, 모든 입력을 상한이 있는 스키마로 검증하며, CI의 npm run test:mcp가 stdio로 끝까지 실행합니다.
  • Pages 배포 concurrency 그룹을 실제 배포에만 적용합니다(main push·수동 dispatch는 demo-site-main, 그 외는 실행별 그룹). 이전에는 Dependabot 브랜치 CI 완료가 skip된 workflow_run으로 공용 demo-site 그룹에 들어와 진행 중이던 v0.10.0 배포를 취소했고, kineto.dongri.me는 이전 빌드에 머물렀습니다. tests/release-automation.mjs로 고정하고 RELEASING에 재배포 경로를 적었습니다.
  • 저장소 게이트를 새 패키지까지 넓혔습니다. 감사 대상 lockfile, Dependabot, lockfile 경계(게시용 패키지 종류), 공급망 하한(picomatch를 메이저 라인별로 검사 — shadcn CLI는 micromatch를 통해 패치된 2.3.2 라인이 여전히 필요), test:node와 두 워크플로우의 test:observe/test:integrations/test:mcp, fixture·MCP 패키지까지 ESLint, 그리고 README(7개 언어)·문서 인덱스·Getting Started·AI 프롬프트 가이드에 observe()·연동 가이드·레지스트리·MCP 서버를 반영했습니다. React/Vue/jQuery 예제 README는 unscoped 이름 대신 @dong-gri/kineto를 설치합니다.
  • 검증된 v0.10.0 릴리스를 기록했습니다: 성공한 CI·Release 실행, provenance subject·릴리스 커밋이 일치하는 동일 바이트 npm/GitHub tarball, 그리고 취소된 canonical Pages 배포의 원인과 수정.
  • MCP 서버에 독립 릴리스 경로를 만들었습니다. scripts/release-targets.mjs가 태그 접두사를 패키지에 매핑하고(v* → @dong-gri/kineto, mcp-v* → @dong-gri/kineto-mcp), npm run release:ship이 이를 거치며, scripts/check-mcp-release.mjs가 태그 ↔ 버전, 바이트 동일한 계약 사본, 패키지 changelog, 이중언어 노트를 검증하고, .github/workflows/release-mcp.yml이 태그 소스를 검증한 뒤 digest를 확인한 tarball 하나를 최소 권한 job에서 provenance와 함께 게시하고 GitHub Release를 만듭니다. release:prepare는 tests/integrations/package-lock.json의 링크된 root 버전도 함께 올립니다.