Merge remote-tracking branch 'origin/main' into docs/README-add-toss-logo

# Conflicts:
#	README.md

Author: sukvvon

.changeset/config.json

@@ -7,5 +7,5 @@
   "access": "public",
   "baseBranch": "main",
   "updateInternalDependencies": "patch",
-  "ignore": []
+  "ignore": ["with-vite", "with-nextjs", "@examples/shared"]
 }

.github/CODEOWNERS

@@ -1 +1 @@
-* @kimyouknow
+* @kimyouknow @zztnrudzz13

.github/CONTRIBUTING.md

@@ -1 +1,45 @@
-# CONTRIBUTING
+# Contributing to react-simplikit
+
+Welcome! We appreciate your interest in contributing to react-simplikit. This document provides an overview of how to contribute. For detailed guidelines, please refer to the package-specific contributing guides linked below.
+
+## Contributing Guide
+
+Each contribution requires:
+
+- **Implementation** — following our [Design Principles](https://react-simplikit.slash.page/core/design-principles.html)
+- **Test Code** — 100% coverage required
+- **JSDoc** — documentation is auto-generated from JSDoc, so no separate docs needed
+
+For detailed instructions, see the package-specific guides:
+
+- [Core Package Contributing Guide](../docs/core/contributing.md)
+- [Mobile Package Contributing Guide](../docs/mobile/contributing.md)
+
+## Scaffolding
+
+Use the scaffold command to create a basic structure for new implementations:
+
+```bash
+yarn run scaffold <name> --type <type>
+```
+
+- `type`: `component`, `hook`, or `util` (shortcuts: `c`, `h`, `u`)
+- `name`: Name of the implementation
+
+## Creating a Changeset
+
+When your changes affect a package, create a changeset:
+
+```bash
+yarn changeset
+```
+
+Select the version bump type (`patch`, `minor`, or `major`).
+
+> **Note:** Both packages are currently in the `0.0.x` stage. During this phase, most changes should use `patch`. If you're unsure about the version type, please discuss with the maintainers.
+
+## Useful Links
+
+- [Documentation Site](https://react-simplikit.slash.page)
+- [Design Principles](https://react-simplikit.slash.page/core/design-principles.html)
+- [Discord](https://discord.gg/vGXbVjP2nY)

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: 'github-actions'
+    directory: '/'
+    schedule:
+      interval: 'weekly'
+    groups:
+      github-actions:
+        patterns:
+          - '*'

.github/workflows/compressed-size.yml

@@ -7,19 +7,20 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Enable Corepack
         run: corepack enable
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
           cache: 'yarn'
 
       - name: Check bundle size
-        uses: preactjs/compressed-size-action@v2
+        uses: preactjs/compressed-size-action@8518045ed95e94e971b83333085e1cb99aa18aa8 # v2.9.0
         with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
           build-script: 'prepack'
           pattern: './{dist,esm}/**/*.{js,cjs}'

.github/workflows/integration.yml

@@ -17,13 +17,13 @@ jobs:
         command: ['format', 'lint', 'type', 'spec']
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Enable Corepack
         run: corepack enable
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
           cache: 'yarn'
@@ -41,20 +41,20 @@ jobs:
       changed_files: ${{ steps.filter.outputs.changed_files }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Enable Corepack
         run: corepack enable
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
           cache: 'yarn'
 
       - name: Check for changes in .ts and .tsx files
         id: filter
-        uses: dorny/paths-filter@v3
+        uses: dorny/paths-filter@de90cc6fb38fc0963ad72b210f1f284cd68cea36 # v3.0.2
         with:
           list-files: shell
           filters: |
@@ -73,13 +73,13 @@ jobs:
     if: ${{ needs.check-changes.outputs.changed == 'true' }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Enable Corepack
         run: corepack enable
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
           cache: 'yarn'
@@ -91,7 +91,7 @@ jobs:
         run: yarn run test:coverage
 
       - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5.5.2
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
 
@@ -156,7 +156,7 @@ jobs:
     if: ${{ needs.check-changes.outputs.changed == 'true' }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check for JSDoc comments
         run: |
@@ -196,13 +196,13 @@ jobs:
     if: ${{ needs.check-changes.outputs.changed == 'true' }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Enable Corepack
         run: corepack enable
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
           cache: 'yarn'
@@ -265,7 +265,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check exports
         run: |

.github/workflows/release.yml

@@ -15,35 +15,44 @@ jobs:
       id-token: write
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Enable Corepack
         run: corepack enable
 
       - name: Install Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
           cache: 'yarn'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Update npm for OIDC trusted publishing
+        run: npm install -g npm@latest
 
       - name: Install Dependencies
         run: yarn install
 
       - name: Build
-        run: yarn prepack
+        run: yarn run prepack
 
       - name: Type Check
-        run: yarn test:type
+        run: yarn run test:type
 
-      - name: Create Release Pull Request or Publish to npm
-        uses: changesets/action@v1
+      - name: Create Release Pull Request
+        id: changesets
+        uses: changesets/action@6a0a831ff30acef54f2c6aa1cbbc1096b066edaf # v1.7.0
         with:
           title: 'chore: version packages'
           commit: 'chore: version packages'
-          version: yarn changeset:version
-          publish: yarn changeset:publish
+          version: yarn run changeset:version
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to npm
+        if: steps.changesets.outputs.hasChangesets == 'false'
+        run: yarn run changeset:publish
+        env:
           NPM_CONFIG_PROVENANCE: true
 
   get-diffs:
@@ -52,7 +61,7 @@ jobs:
       result: ${{ steps.diffs.outputs.result }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 0
 
@@ -71,13 +80,13 @@ jobs:
     if: ${{ needs.get-diffs.outputs.result != '' }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Enable Corepack
         run: corepack enable
 
       - name: Set up Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
           cache: 'yarn'
@@ -93,12 +102,12 @@ jobs:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
 
       - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           branch: new-docgen-branch-${{ github.run_id }}
           title: 'docs(${{ needs.get-diffs.outputs.result }}): auto-generated docs'
           body: 'This PR includes documentation updates for: ${{ needs.get-diffs.outputs.result }}'
           author: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
-          reviewers: kimyouknow
+          reviewers: kimyouknow,zztnrudzz13
           commit-message: 'Generate docs for ${{ needs.get-diffs.outputs.result }}'

.gitignore

@@ -7,6 +7,10 @@
 !.yarn/sdks
 !.yarn/versions
 
+# large yarn cache files (exceed GitHub 100MB limit)
+.yarn/cache/@next-swc-*.zip
+.yarn/cache/next-npm-*.zip
+
 # build
 dist
 esm
@@ -24,6 +28,21 @@ coverage
 .vitepress/cache
 .vitepress/dist
 
+# next
+.next
+
 .env
 
 .DS_Store
+
+# Claude Code - public files are committed (.claude/skills/, .claude/agents/, CLAUDE.md)
+# Private/personal files:
+.claude/settings.local.json
+.claude/memory/
+.claude/plans/
+.claude/skills/project-decisions/
+# Session notes (contain internal references)
+.claude/*.md
+
+# context files (session notes, etc.)
+context/

.npmrc

@@ -0,0 +1 @@
+registry=https://registry.npmjs.org/

.nvmrc

@@ -1,5 +1 @@
-lts/iron
-
-# 'iron' is the 20.x node release line
-# ESLint requires Node.js >=18.18.0, >=20.9.0, or >=21.1.0 — ensure 20.9.0+ if using iron
-# See: https://eslint.org/docs/latest/use/getting-started#prerequisites
+v22.18.0