diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 00000000..5bd8abb1
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1,4 @@
+# Code owners are requested for review on every pull request.
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+* @MaksymStoianov
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index e0a7f3bf..d9688d9e 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -1,7 +1,7 @@
name: Bug Report
description: Report a bug report to help us improve.
title: "[Bug]: "
-labels: [ "bug" ]
+labels: [ "Kind/Bug" ]
body:
- type: textarea
id: description
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 1cb959ee..d73b7098 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,14 +1,14 @@
blank_issues_enabled: false
contact_links:
- name: Documentation
- url: https://github.com/MaksymStoianov/apps-script-utils#readme
+ url: https://github.com/bootgs/utils#readme
about: Read the official documentation.
- name: Roadmap
url: https://github.com/users/MaksymStoianov/projects/2/views/2
about: See what is planned, in progress and done.
- name: Discussions
- url: https://github.com/MaksymStoianov/apps-script-utils/discussions
+ url: https://github.com/bootgs/utils/discussions
about: Ask questions or discuss ideas.
- name: Contributing
- url: https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md
+ url: https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md
about: Learn how to contribute to this project.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
index 6e7bfe6e..4e33c552 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -1,7 +1,7 @@
name: Feature Request
description: Suggest an idea for this project.
title: "[Feature]: "
-labels: [ "enhancement" ]
+labels: [ "Kind/Feature" ]
body:
- type: textarea
id: feature-description
diff --git a/.github/ISSUE_TEMPLATE/update_docs.yml b/.github/ISSUE_TEMPLATE/update_docs.yml
index 88f13f1d..d3452b62 100644
--- a/.github/ISSUE_TEMPLATE/update_docs.yml
+++ b/.github/ISSUE_TEMPLATE/update_docs.yml
@@ -1,7 +1,7 @@
name: Documentation Update
description: Report a mistake or suggest an improvement for the documentation.
title: "[Docs]: "
-labels: [ "documentation" ]
+labels: [ "Kind/Documentation" ]
body:
- type: textarea
id: description
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 00000000..27d50b1b
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,28 @@
+# https://docs.github.com/en/code-security/dependabot/working-with-dependabot/dependabot-options-reference
+
+version: 2
+
+updates:
+ - package-ecosystem: npm
+ directory: /
+ target-branch: develop
+ schedule:
+ interval: weekly
+ open-pull-requests-limit: 10
+ commit-message:
+ prefix: "chore(deps)"
+ prefix-development: "chore(deps-dev)"
+ groups:
+ dev-dependencies:
+ dependency-type: development
+ update-types:
+ - minor
+ - patch
+
+ - package-ecosystem: github-actions
+ directory: /
+ target-branch: develop
+ schedule:
+ interval: weekly
+ commit-message:
+ prefix: "ci"
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 00000000..301cf83d
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,28 @@
+## Summary
+
+
+
+## Type of change
+
+- [ ] `fix` — bug fix (non-breaking)
+- [ ] `feat` — new feature (non-breaking)
+- [ ] Breaking change (`!` / `BREAKING CHANGE:` footer)
+- [ ] `docs` — documentation only
+- [ ] `refactor` / `perf` / `test` / `build` / `ci` / `chore`
+
+## Checklist
+
+- [ ] The PR title follows [Conventional Commits](https://www.conventionalcommits.org/).
+- [ ] Every commit is signed off (`git commit -s`) under the
+ [DCO](https://github.com/bootgs/utils/blob/develop/CONTRIBUTING.md#developer-certificate-of-origin).
+- [ ] Tests are added or updated and `npm test` passes.
+- [ ] `npm run type:check`, `npm run lint` and `npm run format` pass.
+- [ ] The generated documentation is up to date (`npm run docs:generate`, then `npm run docs:check` passes).
+- [ ] Public API changes are documented (JSDoc, docs, changelog notes in the commit body).
+- [ ] No secrets, credentials or personal data are included.
+- [ ] AI-assisted commits carry a `Co-Authored-By:` trailer and I have reviewed every line
+ ([Tools and AI Assistance](https://github.com/bootgs/utils/blob/develop/docs/tools-and-ai.md)).
+
+## Notes for reviewers
+
+
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 00000000..7dede198
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,86 @@
+# Pull request and branch checks: types, lint, formatting, tests with coverage, build,
+# generated documentation, production dependency audit and production licence allow-list.
+
+name: ci
+
+on:
+ pull_request:
+ push:
+ branches:
+ - main
+ - develop
+
+permissions:
+ contents: read
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+ cancel-in-progress: true
+
+jobs:
+ checks:
+ runs-on: ubuntu-latest
+ timeout-minutes: 15
+
+ steps:
+ - name: checkout
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ persist-credentials: false
+
+ - name: setup-node
+ uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
+ with:
+ node-version: 24
+ cache: npm
+
+ - name: install
+ run: npm ci
+
+ - name: type-check
+ run: npm run type:check
+
+ - name: lint
+ run: npm run lint
+
+ - name: format
+ run: npm run format
+
+ - name: test
+ run: npm run test:cov
+
+ - name: build
+ run: npm run build
+
+ # The reference pages are generated from src/; this fails when they are stale.
+ - name: docs
+ run: npm run docs:check
+
+ - name: readme-translations
+ run: npm run docs:check-i18n
+
+ - name: audit
+ run: npm audit --omit=dev --audit-level=high
+
+ # Production dependencies must use a permissive licence compatible with Apache-2.0.
+ - name: licences
+ run: >-
+ npx --yes license-checker-rseidelsohn@5.0.1
+ --production
+ --excludePrivatePackages
+ --summary
+ --onlyAllow "Apache-2.0;MIT;BSD-2-Clause;BSD-3-Clause;ISC;0BSD"
+
+ # Every file has copyright and licence information (REUSE.toml, LICENSES/).
+ reuse:
+ runs-on: ubuntu-latest
+ timeout-minutes: 5
+
+ steps:
+ - name: checkout
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ persist-credentials: false
+
+ - name: reuse-lint
+ uses: fsfe/reuse-action@676e2d560c9a403aa252096d99fcab3e1132b0f5 # v6.0.0
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
new file mode 100644
index 00000000..6ed63a41
--- /dev/null
+++ b/.github/workflows/codeql.yml
@@ -0,0 +1,51 @@
+# CodeQL code scanning on every push and pull request to main and develop.
+# Replaces GitHub's default setup, which only analyses pull requests to the default branch.
+
+name: codeql
+
+on:
+ push:
+ branches:
+ - main
+ - develop
+ pull_request:
+ branches:
+ - main
+ - develop
+ schedule:
+ - cron: "23 3 * * 2"
+
+permissions: {}
+
+jobs:
+ analyze:
+ if: github.server_url == 'https://github.com'
+ runs-on: ubuntu-latest
+ timeout-minutes: 20
+ permissions:
+ actions: read
+ contents: read
+ security-events: write
+ strategy:
+ fail-fast: false
+ matrix:
+ language:
+ - actions
+ - javascript-typescript
+
+ steps:
+ - name: checkout
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ persist-credentials: false
+
+ - name: init
+ uses: github/codeql-action/init@1fc58d04a4d4374f921bdac573c3811c240f9c26 # v4.39.2
+ with:
+ languages: ${{ matrix.language }}
+ build-mode: none
+
+ - name: analyze
+ uses: github/codeql-action/analyze@1fc58d04a4d4374f921bdac573c3811c240f9c26 # v4.39.2
+ with:
+ category: /language:${{ matrix.language }}
diff --git a/.github/workflows/dco.yml b/.github/workflows/dco.yml
new file mode 100644
index 00000000..88cd828b
--- /dev/null
+++ b/.github/workflows/dco.yml
@@ -0,0 +1,92 @@
+# Developer Certificate of Origin: every commit of a pull request must carry a
+# "Signed-off-by: Name " trailer that matches its author (git commit -s).
+# See CONTRIBUTING.md → Developer Certificate of Origin.
+
+name: dco
+
+on:
+ pull_request:
+
+permissions:
+ contents: read
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
+ cancel-in-progress: true
+
+jobs:
+ sign-off:
+ runs-on: ubuntu-latest
+ timeout-minutes: 5
+
+ steps:
+ - name: checkout
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ ref: ${{ github.event.pull_request.head.sha }}
+ fetch-depth: 0
+ persist-credentials: false
+
+ - name: check
+ env:
+ BASE_SHA: ${{ github.event.pull_request.base.sha }}
+ HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+ # Skips merge commits and bot authors (Dependabot, GitHub Actions, release-please).
+ shell: bash
+ run: |
+ set -euo pipefail
+
+ range="$(git merge-base "$BASE_SHA" "$HEAD_SHA")..$HEAD_SHA"
+
+ lower() { printf '%s' "$1" | tr '[:upper:]' '[:lower:]'; }
+
+ failed=0
+ checked=0
+
+ while IFS= read -r -d '' record; do
+ IFS=$'\x1f' read -r sha name email trailers <<<"$record"
+ [ -n "$sha" ] || continue
+
+ case "$email" in
+ *"[bot]@users.noreply.github.com" | "noreply@github.com" | *"dependabot"* | *"release-please"*)
+ echo "skip ${sha:0:12} ($name, bot)"
+ continue
+ ;;
+ esac
+ case "$name" in
+ "dependabot[bot]" | "github-actions[bot]" | "github-actions" | "release-please[bot]")
+ echo "skip ${sha:0:12} ($name, bot)"
+ continue
+ ;;
+ esac
+
+ checked=$((checked + 1))
+ expected="$name <$email>"
+ found=0
+ while IFS= read -r line; do
+ line="${line#"${line%%[![:space:]]*}"}"
+ line="${line%"${line##*[![:space:]]}"}"
+ [ -n "$line" ] || continue
+ if [ "$(lower "$line")" = "$(lower "$expected")" ]; then
+ found=1
+ break
+ fi
+ done <<<"${trailers//$'\x1e'/$'\n'}"
+
+ if [ "$found" -eq 1 ]; then
+ echo "ok ${sha:0:12} $expected"
+ else
+ echo "FAIL ${sha:0:12} missing \"Signed-off-by: $expected\""
+ failed=$((failed + 1))
+ fi
+ done < <(git log --no-merges -z \
+ --format="%H%x1f%an%x1f%ae%x1f%(trailers:key=Signed-off-by,valueonly,separator=%x1e)" "$range")
+
+ echo
+ if [ "$failed" -gt 0 ]; then
+ echo "$failed of $checked commit(s) lack a matching Signed-off-by trailer."
+ echo "Sign off with 'git commit -s'; fix existing commits with 'git rebase --signoff origin/develop'."
+ echo "See CONTRIBUTING.md → Developer Certificate of Origin."
+ exit 1
+ fi
+ echo "All $checked commit(s) are signed off."
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 16db0d2c..3f80b7f9 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -13,10 +13,16 @@ on:
pull_request:
paths:
- "docs/**"
+ # README translations live under docs/ but are not part of the site.
+ - "!docs/readme/**"
- "scripts/docs/**"
- ".github/workflows/docs.yml"
workflow_dispatch:
+# Read-only by default; only the deploy job is granted more.
+permissions:
+ contents: read
+
# Allow one concurrent deployment; queued runs supersede each other rather than
# racing to publish.
concurrency:
@@ -45,10 +51,12 @@ jobs:
steps:
- name: Checkout repository
- uses: actions/checkout@v4
+ uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+ with:
+ persist-credentials: false
- name: Set up Node.js
- uses: actions/setup-node@v4
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
with:
node-version: 22
cache: npm
@@ -89,17 +97,19 @@ jobs:
steps:
- name: Checkout repository
- uses: actions/checkout@v4
+ uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+ with:
+ persist-credentials: false
- name: Build docs using the Writerside Docker builder
- uses: JetBrains/writerside-github-action@v4
+ uses: JetBrains/writerside-github-action@738910d7cf197d67188300d0e0f84b2e708db3cf # v4
with:
location: ${{ env.LOCATION }}
instance: ${{ matrix.language.module }}/asu
docker-version: ${{ env.DOCKER_VERSION }}
- name: Upload build results
- uses: actions/upload-artifact@v4
+ uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
with:
name: docs-${{ matrix.language.code }}
path: |
@@ -124,13 +134,13 @@ jobs:
steps:
- name: Download build results
- uses: actions/download-artifact@v4
+ uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
with:
name: docs-${{ matrix.language.code }}
path: artifacts
- name: Check for broken links and other problems
- uses: JetBrains/writerside-checker-action@v1
+ uses: JetBrains/writerside-checker-action@79ff89902dcd3d5c5a3f26a79bc35830377f38c5 # v1
with:
instance: ${{ matrix.language.module }}/asu
@@ -146,10 +156,12 @@ jobs:
steps:
- name: Checkout repository
- uses: actions/checkout@v4
+ uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+ with:
+ persist-credentials: false
- name: Set up Node.js
- uses: actions/setup-node@v4
+ uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
with:
node-version: 22
cache: npm
@@ -158,7 +170,7 @@ jobs:
run: npm ci
- name: Download build results
- uses: actions/download-artifact@v4
+ uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
with:
pattern: docs-*
path: artifacts
@@ -205,6 +217,7 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 10
+ # contents: write pushes the archive of earlier versions to the docs-archive branch.
permissions:
contents: write
pages: write
@@ -216,10 +229,12 @@ jobs:
steps:
- name: Checkout repository
- uses: actions/checkout@v4
+ uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+ with:
+ persist-credentials: false
- name: Download build results
- uses: actions/download-artifact@v4
+ uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
with:
pattern: docs-*
path: artifacts
@@ -300,13 +315,13 @@ jobs:
run: node scripts/docs/write-help-versions.mjs dir "$(node -p "require('./package.json').version")"
- name: Setup Pages
- uses: actions/configure-pages@v4
+ uses: actions/configure-pages@1f0c5cde4bc74cd7e1254d0cb4de8d49e9068c7d # v4.0.0
- name: Upload Pages artifact
- uses: actions/upload-pages-artifact@v3
+ uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
with:
path: dir
- name: Deploy to GitHub Pages
id: deployment
- uses: actions/deploy-pages@v4
+ uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5
diff --git a/.github/workflows/release-please.yml b/.github/workflows/release-please.yml
index e348e377..d77b16bc 100644
--- a/.github/workflows/release-please.yml
+++ b/.github/workflows/release-please.yml
@@ -9,13 +9,11 @@ on:
workflow_dispatch:
inputs:
tag:
- description: "Release tag to publish to npm, e.g. apps-script-utils-v2.1.1"
+ description: "Release tag to publish to npm, e.g. apps-script-utils-v3.0.0"
required: true
-permissions:
- contents: write
- issues: write
- pull-requests: write
+# Every job declares only the permissions it needs.
+permissions: {}
name: release-please
@@ -24,6 +22,10 @@ jobs:
if: github.event_name == 'push' && github.server_url == 'https://github.com' && github.actor != 'github-actions[bot]'
runs-on: ubuntu-latest
timeout-minutes: 8
+ permissions:
+ contents: write
+ issues: write
+ pull-requests: write
outputs:
release_created: ${{ steps.release.outputs.release_created }}
tag_name: ${{ steps.release.outputs.tag_name }}
@@ -35,17 +37,15 @@ jobs:
# ever been released and proposed 1.0.0.
- name: release-please-action
id: release
- uses: googleapis/release-please-action@v4.4.0
+ uses: googleapis/release-please-action@5c625bfb5d1ff62eadeeb3772007f7f66fdcf071 # v4.4.1
with:
token: ${{ secrets.GITHUB_TOKEN }}
config-file: release-please-config.json
manifest-file: .release-please-manifest.json
-# versioning-strategy: auto
-# changelog-path: CHANGELOG.md
# npm trusted publishing (OIDC): no npm token is stored in GitHub. Needs a trusted publisher on
- # npmjs.com → apps-script-utils → Settings → Trusted publishing: GitHub Actions,
- # MaksymStoianov/apps-script-utils, workflow release-please.yml, environment npm, Publish allowed.
+ # npmjs.com → @bootgs/utils → Settings → Trusted publishing: GitHub Actions, bootgs/utils,
+ # workflow release-please.yml, environment npm.
publish:
needs: release-please
if: >-
@@ -61,12 +61,13 @@ jobs:
steps:
- name: checkout
- uses: actions/checkout@v7
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.event_name == 'workflow_dispatch' && inputs.tag || needs.release-please.outputs.tag_name }}
+ persist-credentials: false
- name: setup-node
- uses: actions/setup-node@v7
+ uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version: 24
registry-url: https://registry.npmjs.org
@@ -80,5 +81,73 @@ jobs:
- name: test
run: npm test
+ # The packed tarball is what goes to npm and, signed, to the GitHub release.
+ - name: pack
+ id: pack
+ run: echo "file=$(npm pack --silent | tail -n 1)" >> "$GITHUB_OUTPUT"
+
- name: publish
- run: npm publish --provenance --access public
+ env:
+ FILE: ${{ steps.pack.outputs.file }}
+ run: npm publish "./$FILE" --provenance --access public
+
+ - name: keep-package
+ uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+ with:
+ name: package
+ path: ${{ steps.pack.outputs.file }}
+ retention-days: 5
+
+ # Release assets: CycloneDX SBOM of the production dependency tree, the npm tarball and its
+ # signed build provenance (Sigstore bundle from actions/attest-build-provenance).
+ sbom:
+ needs: [release-please, publish]
+ if: >-
+ always() && needs.publish.result == 'success'
+ runs-on: ubuntu-latest
+ timeout-minutes: 5
+ permissions:
+ attestations: write
+ contents: write
+ id-token: write
+ env:
+ TAG: ${{ github.event_name == 'workflow_dispatch' && inputs.tag || needs.release-please.outputs.tag_name }}
+
+ steps:
+ - name: checkout
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ ref: ${{ env.TAG }}
+ persist-credentials: false
+
+ - name: setup-node
+ uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
+ with:
+ node-version: 24
+
+ - name: install
+ run: npm ci --ignore-scripts
+
+ - name: sbom
+ run: npm sbom --sbom-format cyclonedx --omit dev > sbom.cdx.json
+
+ - name: download-package
+ uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+ with:
+ name: package
+ path: package
+
+ - name: attest
+ id: attest
+ uses: actions/attest-build-provenance@4d101475d8b20a2381f78447822ac1eab6504dd8 # v4.2.2
+ with:
+ subject-path: package/*.tgz
+
+ - name: upload
+ env:
+ GH_TOKEN: ${{ github.token }}
+ BUNDLE: ${{ steps.attest.outputs.bundle-path }}
+ run: |
+ tgz=$(ls package/*.tgz)
+ cp "$BUNDLE" "$tgz.sigstore.json"
+ gh release upload "$TAG" sbom.cdx.json "$tgz" "$tgz.sigstore.json" --clobber --repo "$GITHUB_REPOSITORY"
diff --git a/.github/workflows/scorecard.yml b/.github/workflows/scorecard.yml
new file mode 100644
index 00000000..d32d11ef
--- /dev/null
+++ b/.github/workflows/scorecard.yml
@@ -0,0 +1,52 @@
+# OpenSSF Scorecard supply-chain security analysis.
+# https://github.com/ossf/scorecard-action
+
+name: scorecard
+
+on:
+ # For the Branch-Protection check; only the default branch is supported.
+ branch_protection_rule:
+ schedule:
+ - cron: "17 4 * * 1"
+ push:
+ branches:
+ - main
+ workflow_dispatch:
+
+permissions: read-all
+
+jobs:
+ analysis:
+ if: github.server_url == 'https://github.com'
+ runs-on: ubuntu-latest
+ timeout-minutes: 10
+ permissions:
+ # Upload the results to code scanning.
+ security-events: write
+ # Publish the results and get a badge (see publish_results below).
+ id-token: write
+
+ steps:
+ - name: checkout
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ with:
+ persist-credentials: false
+
+ - name: analysis
+ uses: ossf/scorecard-action@fa7117db83c52d787ae5a89f350999701505d78e # v2.5.0
+ with:
+ results_file: results.sarif
+ results_format: sarif
+ publish_results: true
+
+ - name: artifact
+ uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+ with:
+ name: SARIF file
+ path: results.sarif
+ retention-days: 5
+
+ - name: upload-sarif
+ uses: github/codeql-action/upload-sarif@1fc58d04a4d4374f921bdac573c3811c240f9c26 # v4.39.2
+ with:
+ sarif_file: results.sarif
diff --git a/AGENTS.md b/AGENTS.md
index 8579b31b..b53c2b17 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -22,12 +22,27 @@ reverted apart, and turn one conflict into three.
## 2. Every bug and every feature gets an issue, and a commit closes it
-1. **Issue first.** Before fixing a bug or building a feature, open one:
+1. **Issue first.** Before fixing a bug or building a feature, open one, and
+ open it complete — labelled, scheduled, owned and on the board:
```bash
- gh issue create --title "..." --body "..." --label bug # or --label enhancement
+ gh issue create --title "..." --body "..." \
+ --label Kind/Bug --label Priority/Medium \
+ --milestone v2.1.x --assignee MaksymStoianov
+ gh project item-add 2 --owner MaksymStoianov --url
```
+ - **Labels.** One `Kind/*` label — `Kind/Bug`, `Kind/Feature`,
+ `Kind/Enhancement` or `Kind/Documentation`, with `Kind/Security` added
+ when it applies — and one `Priority/*` label. GitHub's default `bug`,
+ `enhancement` and `documentation` labels do not exist in this repository.
+ - **Milestone.** A fix, a documentation change or build work goes to the
+ open patch line (`v2.1.x`); a new function or a behaviour change goes to
+ the next minor (`v2.2.x`). No issue is left without one.
+ - **Assignee.** The maintainer, `MaksymStoianov`, unless told otherwise.
+ - **Board.** The issue joins project 2 the moment it is filed, in `Todo`.
+ `Backlog` is not used for open work.
+
One issue per distinct bug or feature.
2. **Close it from the commit.** The commit that lands the work ends with the
@@ -51,6 +66,27 @@ reverted apart, and turn one conflict into three.
4. **Don't leave the trail one-sided.** An issue whose work has landed must be
closed; a change that landed without an issue gets one retroactively.
+5. **Move the card as the work moves.** The board is read as the state of the
+ work, so the agent doing the work keeps it current:
+
+ | When | Status |
+ | ------------------------------------- | ------------- |
+ | The issue is filed | `Todo` |
+ | The branch is created and work starts | `In progress` |
+ | The pull request is opened | `In review` |
+ | The issue closes | `Done` |
+
+ ```bash
+ gh project item-edit --project-id PVT_kwHOAmq0uM4BkEV2 --id \
+ --field-id PVTSSF_lAHOAmq0uM4BkEV2zhi2Un8 --single-select-option-id
+ # Todo a1e00ed2 · In progress 95d2f606 · In review b7de4a4a · Done 85dc5e33
+ ```
+
+ `` is what `gh project item-add` printed, or comes from
+ `gh project item-list 2 --owner MaksymStoianov --format json`. An issue
+ closed as superseded or not planned keeps the milestone of the release
+ cycle in which that was decided, so the milestone view stays complete.
+
Note that the issue closes when the commit reaches the **default branch**, which
is `main`. Merging a pull request into `develop` does not close anything — the
issues close when `develop` reaches `main` for a release.
@@ -287,7 +323,7 @@ means the repository is broken.
- `gh` fails with `tls: failed to verify certificate: x509: OSStatus -26276`.
Run it with the sandbox disabled, or ask the user to run `! gh ...`.
- `git fetch github` over SSH fails. Fetching the same refs over HTTPS works:
- `git fetch https://github.com/MaksymStoianov/apps-script-utils.git develop`.
+ `git fetch https://github.com/bootgs/utils.git develop`.
- Writes to `.git/config` are denied, so `npm run prepare` cannot register the
merge drivers from inside the sandbox. Run that one command outside it.
- `mktemp -t` resolves to a directory the sandbox cannot write to. Use `$TMPDIR`
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ead56c03..26dd911c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -35,7 +35,7 @@
### ⚠ BREAKING CHANGES
-* **slide:** getSlideIndex takes (slide, presentation?) rather than (presentation, slide). A call left in the other order returns null.
+* **slide:** getSlideIndex takes (slide, presentation?): the slide comes first, as in 1.x, and the presentation is now optional, defaulting to the active presentation. A call with the arguments the other way round returns null.
* **slide:** getSlideByIndex takes (index, presentation?) rather than (presentation, index). A call left in the old order returns null.
* **sheet:** a failed write throws the Error the Apps Script service raised rather than a string carrying its message. A caller matching on a string value has to match on `error.message` instead.
* **sheet:** updateFormulas no longer rejects a Range as its first argument; a call that relied on a Range throwing InvalidSheetException now rewrites it.
@@ -51,7 +51,6 @@
* **sheet:** appendColumn writes its values down one column instead of across one row, and rejects anything that is not a flat array.
* **sheet:** appendRow no longer rejects a Range as its first argument; a call that relied on a Range throwing InvalidSheetException now writes.
* **sheet:** appendRows no longer rejects a Range as its first argument; a call that relied on a Range throwing InvalidSheetException now writes.
-* **slide:** getSlideIndex now takes (presentation, slide) rather than (slide, presentation). A call left in the old order returns null instead of an index.
* **slide:** convertMarkdownToRichText no longer returns an empty array for `null`, `undefined`, a missing argument or a value of another type; it throws.
* **sheet:** appendColumns, and appendColumn with it, write one column further right than before — the column they used to overwrite is now left alone.
* **sheet:** isValidSheetName now rejects names containing \ / ? * [ ], names longer than 100 characters, and the reserved name History.
@@ -320,7 +319,6 @@
* **sheet:** write a column, not a row, in appendColumn ([f99fe17](https://github.com/MaksymStoianov/apps-script-utils/commit/f99fe17f3acfcec1241fea9fac1a35339ba1ce0b)), closes [#503](https://github.com/MaksymStoianov/apps-script-utils/issues/503)
* **slide:** reject absent or non-string input in convertMarkdownToRichText ([a80ae2f](https://github.com/MaksymStoianov/apps-script-utils/commit/a80ae2f37c2cd30dd5494a8b33b60536e4fea013)), closes [#451](https://github.com/MaksymStoianov/apps-script-utils/issues/451)
* **slide:** take the index first in getSlideByIndex, and default to the active presentation ([34b8f02](https://github.com/MaksymStoianov/apps-script-utils/commit/34b8f02ba4003619cd34245fe4b7444dd961fd4d)), closes [#449](https://github.com/MaksymStoianov/apps-script-utils/issues/449)
-* **slide:** take the presentation first in getSlideIndex ([4a0ae57](https://github.com/MaksymStoianov/apps-script-utils/commit/4a0ae57ccb86282ddcdbec9ae8ffa6f5899d3a7d)), closes [#470](https://github.com/MaksymStoianov/apps-script-utils/issues/470)
* **slide:** take the slide first in getSlideIndex, and default to the active presentation ([b3bed1e](https://github.com/MaksymStoianov/apps-script-utils/commit/b3bed1e66a34cb57e23f08dd5f7148d03d710090)), closes [#532](https://github.com/MaksymStoianov/apps-script-utils/issues/532)
## [1.10.0](https://github.com/MaksymStoianov/apps-script-utils/compare/v1.9.0...v1.10.0) (2026-08-19)
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index ae17d421..4fb1ee52 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -2,75 +2,131 @@
## Our Pledge
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, sex characteristics, gender identity and expression,
-level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-- Using welcoming and inclusive language
-- Being respectful of differing viewpoints and experiences
-- Gracefully accepting constructive criticism
-- Focusing on what is best for the community
-- Showing empathy towards other community members
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
-Examples of unacceptable behavior by participants include:
+## Our Standards
-- The use of sexualized language or imagery and unwelcome sexual attention or
- advances
-- Trolling, insulting/derogatory comments, and personal or political attacks
-- Public or private harassment
-- Publishing others' private information, such as a physical or electronic
- address, without explicit permission
-- Other conduct which could reasonably be considered inappropriate in a
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+ and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+ community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+ any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+ without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
professional setting
-## Our Responsibilities
+## Enforcement Responsibilities
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
## Scope
-This Code of Conduct applies within all project spaces, and it also applies when
-an individual is representing the project or its community in public spaces.
-Examples of representing a project or community include using an official
-project e-mail address, posting via an official social media account, or acting
-as an appointed representative at an online or offline event. Representation of
-a project may be further defined and clarified by project maintainers.
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
## Enforcement
Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at stoianov.maksym@gmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
+reported to the community leaders responsible for enforcement at
+stoianov.maksym@gmail.com.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
## Attribution
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-[homepage]: https://www.contributor-covenant.org
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
-For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d4139c34..714b694a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,12 +1,12 @@
-# Contributing to apps-script-utils
+# Contributing to @bootgs/utils
-Great that you are here and you want to contribute to **apps-script-utils**!
+Great that you are here and you want to contribute to **@bootgs/utils**!
## Contents
-- [Contributing to apps-script-utils](#contributing-to-apps-script-utils)
+- [Contributing to @bootgs/utils](#contributing-to-bootgsutils)
- [Contents](#contents)
- [Code of Conduct](#code-of-conduct)
- [Directory Structure](#directory-structure)
@@ -18,10 +18,12 @@ Great that you are here and you want to contribute to **apps-script-utils**!
- [Development Cycle](#development-cycle)
- [Basic Development Workflow](#basic-development-workflow)
- [Commit Message Guidelines](#commit-message-guidelines)
+ - [Developer Certificate of Origin](#developer-certificate-of-origin)
- [Community PR Guidelines](#community-pr-guidelines)
- [1. General Requirements](#1-general-requirements)
- [2. PR Specific Requirements](#2-pr-specific-requirements)
- [Test Suite](#test-suite)
+ - [README Translations](#readme-translations)
- [License](#license)
@@ -60,11 +62,11 @@ The project is organized as follows:
2. **Clone** your fork locally:
```bash
git clone https://github.com//apps-script-utils.git
- cd apps-script-utils
+ cd @bootgs/utils
```
3. **Add upstream remote**:
```bash
- git remote add upstream https://github.com/MaksymStoianov/apps-script-utils.git
+ git remote add upstream https://github.com/bootgs/utils.git
```
4. **Install dependencies**:
```bash
@@ -89,7 +91,8 @@ The project is organized as follows:
```bash
npm run test
```
-4. Commit your changes following the [Commit Message Guidelines](#commit-message-guidelines) and create a Pull Request.
+4. Commit your changes following the [Commit Message Guidelines](#commit-message-guidelines), sign them off
+ ([DCO](#developer-certificate-of-origin)) with `git commit -s` and create a Pull Request.
### Commit Message Guidelines
@@ -148,6 +151,73 @@ feat(core)!: drop support for legacy handler format
- `test: add unit tests for ResponseBuilder`
- `chore: update dependencies`
+### Developer Certificate of Origin
+
+All contributions are accepted under the [Developer Certificate of Origin 1.1](https://developercertificate.org/)
+(DCO). By signing off a commit you certify that you wrote the change or otherwise have the right to submit it under
+the project's licence:
+
+```text
+Developer Certificate of Origin
+Version 1.1
+
+Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+
+Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+(a) The contribution was created in whole or in part by me and I
+ have the right to submit it under the open source license
+ indicated in the file; or
+
+(b) The contribution is based upon previous work that, to the best
+ of my knowledge, is covered under an appropriate open source
+ license and I have the right under that license to submit that
+ work with modifications, whether created in whole or in part
+ by me, under the same open source license (unless I am
+ permitted to submit under a different license), as indicated
+ in the file; or
+
+(c) The contribution was provided directly to me by some other
+ person who certified (a), (b) or (c) and I have not modified
+ it.
+
+(d) I understand and agree that this project and the contribution
+ are public and that a record of the contribution (including all
+ personal information I submit with it, including my sign-off) is
+ maintained indefinitely and may be redistributed consistent with
+ this project or the open source license(s) involved.
+```
+
+Every commit in a pull request must carry a `Signed-off-by:` trailer with the name and email of the commit author.
+Git adds it for you with `-s`:
+
+```bash
+git commit -s -m "fix(sheet): handle an empty range"
+```
+
+This produces:
+
+```text
+Signed-off-by: Your Name
+```
+
+Use your real name (no anonymous contributions) and the same email as the commit author. A
+[DCO check](.github/workflows/dco.yml) runs on every pull request. To sign off commits you already made:
+
+```bash
+git rebase --signoff origin/develop
+git push --force-with-lease
+```
+
+Commits written with the help of AI assistants are signed off by the human author, who is responsible for them;
+see [Tools and AI Assistance](docs/tools-and-ai.md).
+
### Community PR Guidelines
#### 1. General Requirements
@@ -179,7 +249,38 @@ The project uses [Vitest](https://vitest.dev/) for testing.
npm run dev
```
+### README Translations
+
+`README.md` in the repository root is the authoritative version. The `docs/readme/README..md` files are
+AI-assisted translations of it into Ukrainian (`uk`), Russian (`ru`), German (`de`), French (`fr`), Spanish (`es`),
+Portuguese (`pt`), Italian (`it`), Dutch (`nl`), Polish (`pl`), Czech (`cs`), Turkish (`tr`), Arabic (`ar`),
+Indonesian (`id`), Vietnamese (`vi`), Japanese (`ja`), Korean (`ko`), Simplified Chinese (`zh`) and Traditional
+Chinese (`zh-TW`). Corrections from native speakers are welcome as ordinary pull requests.
+
+- **Keep the shape**: every README carries the same language switcher under the banner, and every translation has
+ the same `##`/`###` headings as `README.md`. Translate prose only; code blocks, function names, commands, package
+ names, URLs and badges stay as they are. Ukrainian, Russian, German and French link to their own documentation
+ under `//`; the other languages link to the English documentation.
+- **Links are relative to `docs/readme/`**: other translations are `README..md`, English is `../../README.md`,
+ repository-root files are `../../` (for example `../../CONTRIBUTING.md`) and paths under `docs/` drop the
+ prefix (for example `../writerside/`).
+- **Right-to-left languages**: the Arabic README wraps its prose in `
` … `
` blocks,
+ with a blank line inside each wrapper so GitHub still renders the Markdown. Code blocks, badges, the scripts table
+ and the switcher stay outside the wrappers, left to right; headings stay ordinary `##`/`###` lines.
+- **Sync translations with the source**: when a change to `README.md` is carried into the translations, update the
+ version in the note under each switcher to the current `version` in `package.json`.
+- **The note goes stale on release, by design**: release-please bumps `package.json` but does not touch the
+ translations, so after a release the note keeps naming the version the translations were last synced with. It is
+ updated only when the translations are synced, not on every release.
+- **Check by hand**: run the check before committing a translation sync. It is not part of CI or the Git hooks.
+ ```bash
+ npm run docs:check-i18n
+ ```
+ It fails when a translation is missing, lacks the switcher, has a relative link to a file that does not exist, has
+ a different number of `##`/`###` headings than `README.md`, or its note names a version other than the one in
+ `package.json`. It does not compare wording.
+
## License
-By contributing to **apps-script-utils**, you agree that your contributions will be licensed under
+By contributing to **@bootgs/utils**, you agree that your contributions will be licensed under
the [Apache-2.0 License](LICENSE).
diff --git a/GOVERNANCE.md b/GOVERNANCE.md
new file mode 100644
index 00000000..3fd97c99
--- /dev/null
+++ b/GOVERNANCE.md
@@ -0,0 +1,74 @@
+# Governance
+
+This document describes how **@bootgs/utils** is run: who makes decisions, how releases are made and how the
+project stays available if a maintainer is not.
+
+## Current Model
+
+@bootgs/utils has a **single lead maintainer** (see [MAINTAINERS.md](MAINTAINERS.md)). The lead maintainer:
+
+- sets the direction of the project;
+- reviews and merges pull requests;
+- cuts releases and manages the GitHub organisation and the npm package;
+- enforces the [Code of Conduct](CODE_OF_CONDUCT.md).
+
+The project is **looking for co-maintainers**. As the community grows, we intend to move to a small group of
+maintainers deciding by lazy consensus.
+
+## Decision Making
+
+- Every change goes through a public **issue** or **pull request** on GitHub, so the discussion and the decision
+ are on record.
+- Larger changes (new public API, breaking changes, new dependencies) start with an issue or a discussion before
+ code is written.
+- Anyone may comment and propose changes. The lead maintainer makes the final decision and explains it in the
+ issue or pull request.
+- Every pull request needs review and approval by a maintainer (enforced by [CODEOWNERS](.github/CODEOWNERS)) and
+ passing CI checks before it is merged.
+
+## Becoming a Maintainer
+
+Contributors who have shown sustained, high-quality involvement — merged pull requests, reviews, help in issues and
+discussions — may be invited to become maintainers. You can also ask: open a discussion or contact the lead
+maintainer. New maintainers are added to [MAINTAINERS.md](MAINTAINERS.md) through a pull request and receive
+access step by step (triage, then write, then release).
+
+Maintainers who are inactive for 12 months may be moved to emeritus status, with thanks.
+
+## Continuity
+
+To make sure the project is not lost if the lead maintainer becomes unavailable:
+
+- emergency access to the GitHub organisation and the npm package is held by a trusted backup person, with
+ credentials stored securely and two-factor authentication enabled on every account;
+- the backup person may act only to keep the project available: transfer administration to active maintainers,
+ rotate credentials, or archive the project with a notice; they do not take part in day-to-day decisions;
+- if no maintainer is active for 6 months, the backup person may hand the project over to a community member
+ willing to maintain it, announced publicly in advance;
+- the code is licensed under Apache-2.0, so anyone may fork it at any time.
+
+## Releases
+
+- Releases are automated with [release-please](https://github.com/googleapis/release-please-action): merged
+ [Conventional Commits](https://www.conventionalcommits.org/) on `main` produce a release pull request with the
+ version bump and `CHANGELOG.md`; merging it creates the tag and the GitHub release.
+- The release workflow builds, tests and publishes the package to npm with
+ [trusted publishing](https://docs.npmjs.com/trusted-publishers) (OIDC, no long-lived token) and
+ [provenance](https://docs.npmjs.com/generating-provenance-statements), so every published version can be traced
+ to the commit and workflow that built it.
+- A CycloneDX SBOM of the production dependencies is attached to each GitHub release.
+
+## Support
+
+The latest release line receives fixes; the previous major receives security fixes for 3 months after a new major;
+deprecations are announced at least one minor ahead and removed only in a major. Details: [SUPPORT.md](SUPPORT.md).
+Security issues: [SECURITY.md](SECURITY.md).
+
+## Tools and AI Assistance
+
+Development uses AI assistants; humans review and are responsible for every change. See
+[docs/tools-and-ai.md](docs/tools-and-ai.md).
+
+## Changes to This Document
+
+Changes to governance are made by pull request and stay open for comments for at least 7 days before merging.
diff --git a/LICENSES/Apache-2.0.txt b/LICENSES/Apache-2.0.txt
new file mode 100644
index 00000000..137069b8
--- /dev/null
+++ b/LICENSES/Apache-2.0.txt
@@ -0,0 +1,73 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+
+ (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/LICENSES/LicenseRef-Banner-Artwork.txt b/LICENSES/LicenseRef-Banner-Artwork.txt
new file mode 100644
index 00000000..7881a5b3
--- /dev/null
+++ b/LICENSES/LicenseRef-Banner-Artwork.txt
@@ -0,0 +1,12 @@
+Artwork licence (banner images in docs/assets/images and docs/writerside*/images)
+
+Copyright Daryna Mikhailenko (https://darynamikhailenko.com). All rights reserved
+except as stated below. These images are not covered by the Apache License 2.0.
+
+They may be reused on these terms:
+
+- unmodified - no crops, recolours, overlays or other alterations;
+- with the author credited by name;
+- with the credit linking to the author's portfolio.
+
+Anything beyond that needs the author's permission.
diff --git a/MAINTAINERS.md b/MAINTAINERS.md
new file mode 100644
index 00000000..5d1365bb
--- /dev/null
+++ b/MAINTAINERS.md
@@ -0,0 +1,7 @@
+# Maintainers
+
+| Name | GitHub | Role |
+| :-------------- | :--------------------------------------------------- | :-------------- |
+| Maksym Stoianov | [@MaksymStoianov](https://github.com/MaksymStoianov) | Lead maintainer |
+
+See [GOVERNANCE.md](GOVERNANCE.md) for how decisions are made and how to become a maintainer.
diff --git a/NOTICE b/NOTICE
new file mode 100644
index 00000000..33957829
--- /dev/null
+++ b/NOTICE
@@ -0,0 +1,31 @@
+@bootgs/utils
+Utilities for Google Apps Script(TM) projects
+Copyright 2025-2026 Maksym Stoianov
+
+This product is licensed under the Apache License, Version 2.0 (see LICENSE).
+
+This product includes software developed by Maksym Stoianov
+(https://maksymstoianov.com) and contributors to https://github.com/bootgs/utils.
+
+-------------------------------------------------------------------------------
+Third-party software
+-------------------------------------------------------------------------------
+
+The published npm package has no runtime dependencies and bundles no
+third-party code.
+
+-------------------------------------------------------------------------------
+Artwork
+-------------------------------------------------------------------------------
+
+The banner images in docs/assets/images (banner-*.jpg) are the work of
+Daryna Mikhailenko (https://darynamikhailenko.com), who holds the copyright
+in them. They are NOT covered by the Apache License 2.0 and are not part of
+the npm package. Terms of reuse: docs/assets/images/README.md.
+
+-------------------------------------------------------------------------------
+Trademarks
+-------------------------------------------------------------------------------
+
+Google Apps Script is a trademark of Google LLC. This project is not
+affiliated with, endorsed by or sponsored by Google LLC. See TRADEMARKS.md.
diff --git a/README.md b/README.md
index 51a027b1..290f5bde 100644
--- a/README.md
+++ b/README.md
@@ -8,27 +8,39 @@
-- [Utilities for Google Apps Script™ projects](#utilities-for-google-apps-script-projects)
+- [Utilities for Google Apps Script™ projects](#utilities-for-google-apps-script)
- [Overview](#overview)
- [Key Features](#key-features)
- [AI Agent Skills](#ai-agent-skills)
@@ -50,7 +62,7 @@
## Overview
-**apps-script-utils** is a TypeScript utility library purpose-built for **Google Apps Script**. It brings together the
+**@bootgs/utils** is a TypeScript utility library purpose-built for **Google Apps Script**. It brings together the
helpers every GAS project ends up writing by hand — spreadsheet and A1-notation manipulation, type/value validation
(`isX`/`nonX`/`requireX`), string and array transforms, typed exceptions, and more — in a single, well-documented, and
fully tested package.
@@ -72,7 +84,7 @@ fully tested package.
For teams using an AI coding agent (Claude Code, Gemini CLI, and others), the
[bootgs/skills](https://github.com/bootgs/skills) repository provides an
-[`apps-script-utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) Agent Skill documenting
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) Agent Skill documenting
this library for such agents, including the `isX`/`nonX`/`requireX` validation convention, A1-notation and sheet
helpers, string/number/array helpers, typed exceptions, and the HTML/JSON/path helpers.
@@ -101,23 +113,23 @@ Once installed, the agent applies the skill automatically when a task involves t
Install the package via npm:
```bash
-npm install apps-script-utils
+npm install @bootgs/utils
```
## Documentation
-The full documentation is published at **** — guides, per-module
+The full documentation is published at **** — guides, per-module
walkthroughs, and the complete function reference. Its source lives in [`docs/writerside/`](docs/writerside/) and is rebuilt on
every push to `main`.
A good order to read it in:
-- [Getting started](https://maksymstoianov.github.io/apps-script-utils/getting-started.html)
-- [Validation conventions](https://maksymstoianov.github.io/apps-script-utils/validation-conventions.html) — the
+- [Getting started](https://bootgs.github.io/utils/getting-started.html)
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — the
`isX`/`nonX`/`requireX`/`requireNonX` naming scheme
-- [Exception handling](https://maksymstoianov.github.io/apps-script-utils/exception-handling.html) — the class
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — the class
hierarchy and what raises each one
-- [The Apps Script runtime](https://maksymstoianov.github.io/apps-script-utils/apps-script-runtime.html) — which
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — which
helpers are bound to a Google service, and what that means for testing
## Usage Examples
@@ -127,7 +139,7 @@ A good order to read it in:
Append multiple rows of data efficiently:
```typescript
-import { appendRows } from "apps-script-utils";
+import { appendRows } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
@@ -143,7 +155,7 @@ appendRows(sheet, data);
Check if the current user has administrative privileges:
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
@@ -157,7 +169,7 @@ if (isAdmin()) {
Parse complex A1 notations into structured objects:
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
@@ -226,21 +238,21 @@ npm run dev
The full function reference has moved to the documentation site, which is built from
[`docs/writerside/`](docs/writerside/) and published on every push to `main`:
-****
+****
-| Section | Covers |
-| :-------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |
-| [Google Apps Script module](https://maksymstoianov.github.io/apps-script-utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, network requests, and the built-in UI classes |
-| [Base utilities](https://maksymstoianov.github.io/apps-script-utils/reference-base.html) | Type checking and validation, string, array, and object manipulation, JSON and HTML handling |
-| [Exceptions](https://maksymstoianov.github.io/apps-script-utils/reference-exception.html) | The typed exception classes and what raises each one |
-| [`path` module](https://maksymstoianov.github.io/apps-script-utils/reference-path.html) | File paths and URLs |
-| [Abstracts and interfaces](https://maksymstoianov.github.io/apps-script-utils/reference-abstracts.html) | Shared building blocks |
+| Section | Covers |
+| :------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, network requests, and the built-in UI classes |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Type checking and validation, string, array, and object manipulation, JSON and HTML handling |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | The typed exception classes and what raises each one |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | File paths and URLs |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Shared building blocks |
Alongside the reference, the site carries the guides that the tables could not:
-[validation conventions](https://maksymstoianov.github.io/apps-script-utils/validation-conventions.html) explains the
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) explains the
`isX`/`nonX`/`requireX`/`requireNonX` scheme in one place,
-[exception handling](https://maksymstoianov.github.io/apps-script-utils/exception-handling.html) sets out the class
-hierarchy, and [the Apps Script runtime](https://maksymstoianov.github.io/apps-script-utils/apps-script-runtime.html)
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) sets out the class
+hierarchy, and [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
covers which helpers are bound to a Google service, what that costs, and what it means for testing.
## Contributing
@@ -258,7 +270,7 @@ guidelines.
## Support
-- For bugs or feature requests, search or open an [issue](https://github.com/MaksymStoianov/apps-script-utils/issues)
+- For bugs or feature requests, search or open an [issue](https://github.com/bootgs/utils/issues)
on GitHub.
- For recent changes, see the [Changelog](CHANGELOG.md).
- To report a security vulnerability, follow the [Security Policy](SECURITY.md) instead of opening a public issue.
@@ -268,7 +280,7 @@ guidelines.
What is planned, in progress or done is on the [project board](https://github.com/users/MaksymStoianov/projects/2/views/2),
built from the issue tracker itself. There is no separate roadmap document to fall out of step with it: to propose
-something, open an [issue](https://github.com/MaksymStoianov/apps-script-utils/issues).
+something, open an [issue](https://github.com/bootgs/utils/issues).
## Changelog
diff --git a/REUSE.toml b/REUSE.toml
new file mode 100644
index 00000000..ff8e2974
--- /dev/null
+++ b/REUSE.toml
@@ -0,0 +1,18 @@
+# Copyright and licence information for every file (https://reuse.software).
+# Checked in CI with `reuse lint`.
+version = 1
+SPDX-PackageName = "@bootgs/utils"
+SPDX-PackageDownloadLocation = "https://github.com/bootgs/utils"
+
+[[annotations]]
+path = "**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2025-2026 Maksym Stoianov"
+SPDX-License-Identifier = "Apache-2.0"
+
+# Banner artwork: own terms, see NOTICE and docs/assets/images/README.md.
+[[annotations]]
+path = ["docs/assets/images/banner-*.jpg", "docs/writerside*/images/banner-*.jpg"]
+precedence = "override"
+SPDX-FileCopyrightText = "Daryna Mikhailenko"
+SPDX-License-Identifier = "LicenseRef-Banner-Artwork"
diff --git a/SECURITY.md b/SECURITY.md
index cc8ac284..0b209035 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -1,77 +1,79 @@
# Security Policy
-This document outlines how to report vulnerabilities in **apps-script-utils**. We appreciate the efforts of security researchers
-to help us keep the utility library secure.
+This document explains which versions of **@bootgs/utils** receive security fixes and how to report a
+vulnerability. We appreciate the work of security researchers who help keep the library and its users safe.
## Supported Versions
-We aim to provide security updates for the following versions of **apps-script-utils** on a best-effort basis:
-
-
-
-
-
Version
-
Supported
-
-
-
-
-
>= 2.0.0
-
:white_check_mark:
-
-
-
< 2.0.0
-
:x:
-
-
-
-
-We recommend using the latest stable version to benefit from any security improvements.
+| Version | Package | Supported |
+| :------ | :------------------ | :---------------------------------------------------------------- |
+| `3.x` | `@bootgs/utils` | :white_check_mark: once `3.0.0` is released |
+| `2.x` | `apps-script-utils` | :warning: security fixes only, until 3 months after `3.0.0` ships |
+| `< 2.0` | `apps-script-utils` | :x: |
+
+Version 3 is published under the new name `@bootgs/utils`; the `2.x` line was published as `apps-script-utils`.
+The latest release receives all fixes. Please upgrade to the latest release to stay protected; see
+[SUPPORT.md](SUPPORT.md) for the support policy.
## Reporting a Vulnerability
-**Please do not report security vulnerabilities through public GitHub issues.**
+**Please do not report security vulnerabilities through public issues, discussions or pull requests.**
-If you discover a potential security vulnerability, please report it privately.
+1. **Preferred:** use GitHub private vulnerability reporting — open the repository's
+ [**Security** tab → **Report a vulnerability**](https://github.com/bootgs/utils/security/advisories/new).
+2. **Alternative:** email [security@maksymstoianov.com](mailto:security@maksymstoianov.com).
-1. **Send an Email:** Send a report
- to [stoianov.maksym+apps-script-utils+security@gmail.com](mailto:stoianov.maksym+apps-script-utils+security@gmail.com).
-2. **Include Details:** To help us understand the issue, please include:
- - A descriptive title.
- - Type of issue.
- - Affected versions.
- - Step-by-step instructions to reproduce or a proof-of-concept.
-3. **Wait for Response:** We will try to acknowledge your report as soon as possible, depending on our availability.
+Please include:
-## Our Security Process
+- a short description and the type of issue (for example injection, prototype pollution, information disclosure);
+- the affected versions;
+- steps to reproduce or a proof of concept;
+- the impact as you understand it, and any suggested fix.
-When a vulnerability is reported, we will:
+## Response Timeline
-1. **Review:** Evaluate the report to determine if it is a valid security concern.
-2. **Development:** If confirmed, we will work on a fix as our resources and time permit.
-3. **Disclosure:** Once a fix is released, we may provide credit to the reporter (if they wish) and may publish a
- security advisory.
+| Step | Target |
+| :----------------------------------------- | :--------------------------- |
+| Acknowledgement of the report | within 5 business days |
+| Initial assessment (validity and severity) | within 14 days |
+| Fix released for critical or high severity | within 30 days of assessment |
+| Fix for medium or low severity | in a regular release |
-## Disclosure Policy
+We keep you informed of progress and may ask for more details. Severity is rated with
+[CVSS v3.1](https://www.first.org/cvss/v3.1/specification-document).
-- We follow the principle of coordinated vulnerability disclosure.
-- We ask that you give us a reasonable amount of time to resolve the issue before making any information public.
+## Coordinated Disclosure
-## Recognition
+- We follow coordinated vulnerability disclosure: please keep the details private until a fix is released or
+ 90 days have passed since your report, whichever comes first, unless we agree on another date together.
+- Fixes are published as a new release, and confirmed vulnerabilities get a
+ [GitHub Security Advisory](https://github.com/bootgs/utils/security/advisories) and, where applicable, a CVE.
+- If a report is out of scope or not a vulnerability, we tell you why.
-We value the work of security researchers and may credit those who report vulnerabilities in our release notes or
-security advisories at our discretion.
+## Credit
-## Security Best Practices for Users
+With your permission, we credit reporters by name or handle in the security advisory and release notes. Tell us
+in your report how you would like to be credited, or if you prefer to stay anonymous. We do not run a paid bug
+bounty programme.
+
+## Scope
-To help keep your applications secure, we recommend following these general best practices:
+In scope: the source code in this repository, the `@bootgs/utils` package published on npm and the `2.x` releases
+of `apps-script-utils` while they are supported.
+
+Out of scope: vulnerabilities in Google Apps Script itself or other Google services (report them to
+[Google](https://bughunters.google.com/)), in development dependencies or other third-party packages (report them
+upstream; we will update the dependency), and in scripts built with the library that are caused by their own code
+or configuration.
+
+## Security Best Practices for Users
-1. **Keep Dependencies Updated:** Regularly update your project dependencies.
-2. **Secret Management:** Never commit sensitive information (API keys, secrets) to your repository. Use environment
- variables.
-3. **Principle of Least Privilege:** Grant only necessary permissions in your `appsscript.json`.
-4. **Input Validation:** Always validate and sanitize user input.
+1. **Keep dependencies updated:** use the latest `@bootgs/utils` release and keep other packages current.
+2. **Secret management:** never commit API keys or secrets; use `PropertiesService` or another secret store.
+3. **Least privilege:** declare only the OAuth scopes you need in `appsscript.json`.
+4. **Input validation:** validate input from users, sheets and web requests before acting on it, for example with
+ the library's `require*` checks.
---
-_Thank you for helping us keep **apps-script-utils** secure!_
+_Thank you for helping us keep **@bootgs/utils** secure!_
diff --git a/SUPPORT.md b/SUPPORT.md
new file mode 100644
index 00000000..21525811
--- /dev/null
+++ b/SUPPORT.md
@@ -0,0 +1,52 @@
+# Support
+
+## Getting Help
+
+- **Questions and ideas:** [GitHub Discussions](https://github.com/bootgs/utils/discussions).
+- **Bugs and feature requests:** [GitHub Issues](https://github.com/bootgs/utils/issues) — please use the issue
+ templates and include the `@bootgs/utils` version and a minimal reproduction.
+- **Security vulnerabilities:** never in public — follow [SECURITY.md](SECURITY.md).
+
+Community support is provided on a best-effort basis by the maintainers and contributors.
+
+## Support Policy
+
+@bootgs/utils follows [Semantic Versioning](https://semver.org/).
+
+| Release line | What it receives |
+| :------------------------------------------- | :---------------------------------------------------------- |
+| `3.x` — `@bootgs/utils` (once `3.0.0` ships) | Bug fixes, security fixes and new features |
+| `2.x` — `apps-script-utils` | Security fixes only, for 3 months after `3.0.0` is released |
+| Older releases | No fixes — please upgrade |
+
+There is no separate LTS line at the moment; the policy above applies to every major version: the previous major
+receives security fixes for 3 months after the next major is released.
+
+### Moving from `apps-script-utils` 2.x
+
+Version 3 is published under a new name. If you use `apps-script-utils` 2.x, move to `@bootgs/utils` 3.x:
+
+```bash
+npm uninstall apps-script-utils
+npm install @bootgs/utils
+```
+
+and change your imports from `"apps-script-utils"` to `"@bootgs/utils"`. The breaking changes of 3.0.0 are listed
+in [CHANGELOG.md](CHANGELOG.md). The `apps-script-utils` package receives no new features.
+
+### Deprecations and Breaking Changes
+
+- A deprecation is announced in the changelog and in the API documentation (`@deprecated`) at least one minor
+ release before the feature is removed.
+- Deprecated features are removed only in a new major release.
+- Breaking changes are listed in the release notes and `CHANGELOG.md` under **BREAKING CHANGES**.
+
+### Runtime Requirements
+
+- Google Apps Script V8 runtime.
+- Node.js `>= 22.14.0` for development and building (see `engines` in `package.json`).
+
+## Commercial Support
+
+Consulting, custom development, priority fixes and support agreements are available from the maintainer:
+[maksymstoianov.com](https://maksymstoianov.com).
diff --git a/TRADEMARKS.md b/TRADEMARKS.md
new file mode 100644
index 00000000..b0cbce53
--- /dev/null
+++ b/TRADEMARKS.md
@@ -0,0 +1,36 @@
+# Trademarks
+
+## Third-party trademarks
+
+**Google Apps Script** is a trademark of Google LLC. Google, Google Sheets, Google Slides, Google Docs, Google Forms,
+Google Drive and related marks are trademarks of Google LLC.
+
+**@bootgs/utils** is an independent open-source library. It is **not** affiliated with, endorsed by or sponsored by
+Google LLC. References to Google products describe compatibility only.
+
+All other trademarks are the property of their respective owners.
+
+## The Boot.gs name
+
+The names **Boot.gs**, **bootgs** and **@bootgs/utils** identify this project, the
+[bootgs](https://github.com/bootgs) organisation and its official releases on [GitHub](https://github.com/bootgs/utils)
+and [npm](https://www.npmjs.com/package/@bootgs/utils).
+
+You may, without asking:
+
+- use the name to refer to the library, for example "built with @bootgs/utils";
+- use the name in articles, tutorials, talks and comparisons;
+- state that your fork is "based on @bootgs/utils".
+
+Please do not:
+
+- name a fork, product, package or service "Boot.gs", "bootgs" or "@bootgs/…", or a confusingly similar name;
+- use the name in a way that suggests endorsement by, or an official connection with, the project or its
+ maintainers when there is none;
+- publish modified builds under the `@bootgs` npm scope or the `@bootgs/utils` package name.
+
+The Apache-2.0 licence covers the code; it does not grant trademark rights (section 6 of the
+[licence](LICENSE)). For any other use, open an issue or contact the maintainer listed in
+[MAINTAINERS.md](MAINTAINERS.md).
+
+The banner artwork has its own terms: see [docs/assets/images/README.md](docs/assets/images/README.md).
diff --git a/config/tsconfig.docs.json b/config/tsconfig.docs.json
index 6246b36a..06db5d2b 100644
--- a/config/tsconfig.docs.json
+++ b/config/tsconfig.docs.json
@@ -22,7 +22,7 @@
"baseUrl": "..",
"paths": {
"@/*": ["src/*"],
- "apps-script-utils": ["src/index.ts"]
+ "@bootgs/utils": ["src/index.ts"]
}
},
diff --git a/docs/content/de/topics/apps-script-runtime.md b/docs/content/de/topics/apps-script-runtime.md
index adf309d8..1398da78 100644
--- a/docs/content/de/topics/apps-script-runtime.md
+++ b/docs/content/de/topics/apps-script-runtime.md
@@ -2,7 +2,7 @@
Welche Funktionen die Apps-Script-Laufzeit brauchen und welche überall laufen.
-Welche Teile von apps-script-utils von Google-Apps-Script-Diensten abhängen und welche in Node.js oder einer Testsuite laufen — und was das fürs Testen des eigenen Codes bedeutet.
+Welche Teile von @bootgs/utils von Google-Apps-Script-Diensten abhängen und welche in Node.js oder einer Testsuite laufen — und was das fürs Testen des eigenen Codes bedeutet.
Die Bibliothek ist ein Paket, aber ihre Funktionen laufen nicht alle an denselben Orten. Auf welcher Seite der Linie
eine Funktion steht, entscheidet, ob sie sich als Unit testen lässt und ob sie einen Dienstaufruf kostet.
@@ -17,19 +17,79 @@ Spaltenbuchstaben-Umrechnungen und die `GridRange`-Vergleiche.
**Dienstgebundene** Funktionen greifen selbst nach einem globalen Dienst. Sie funktionieren nur in einem Skript mit
den nötigen Berechtigungen und in Node gar nicht. Das ist derzeit die ganze Liste:
-| Funktion | Greift nach |
-| :---------------------- | :----------------------------------------------------------------------- |
-| `isAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` |
-| `checkMultipleAccount` | `Session.getEffectiveUser` |
-| `getSheetById` | `SpreadsheetApp.getActiveSpreadsheet`, wenn keine Tabelle übergeben wird |
-| `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, wenn keine Tabelle übergeben wird |
-| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` |
-| `convertRichTextToHtml` | `Utilities.formatString` |
+| Funktion | Greift nach | Benötigter Bereich |
+| :------------------------------------ | :------------------------------------------------------------------------ | :------------------------------------------------ |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` | `userinfo.email`, `admin.directory.user.readonly` |
+| `checkMultipleAccount` | `Session.getEffectiveUser` | `userinfo.email` |
+| `getSheetById`, `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, wenn keine Tabelle übergeben wird | `spreadsheets.currentonly` |
+| `getSlideByIndex`, `getSlideIndex` | `SlidesApp.getActivePresentation`, wenn keine Präsentation übergeben wird | `presentations.currentonly` |
+| `createFolder` | `DriveApp.getRootFolder`, wenn kein übergeordneter Ordner übergeben wird | `drive` |
+| `getTriggerById` | `ScriptApp.getProjectTriggers` | `script.scriptapp` |
+| `appendRows`, `prependRows` | `LockService.getDocumentLock` | keiner für die Sperre |
+| `appendRow`, `prependRow` | `LockService.getDocumentLock`, über die beiden Funktionen darüber | keiner für die Sperre |
+| `appendColumns`, `prependColumns` | `LockService.getDocumentLock` | keiner für die Sperre |
+| `appendColumn`, `prependColumn` | `LockService.getDocumentLock`, über die beiden Funktionen darüber | keiner für die Sperre |
+| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` | keiner für die Builder |
+| `insertSchema` | `SpreadsheetApp.newDataValidation` | keiner für den Builder |
+| `deleteRowsByConditional` | `SpreadsheetApp.Dimension` | keiner für die Aufzählung |
+| `deleteColumnsByConditional` | `SpreadsheetApp.Dimension` | keiner für die Aufzählung |
+| `convertRichTextToHtml` | `Utilities.formatString` | keiner |
+| `retry` | `Utilities.sleep`, wenn vorhanden | keiner |
+
+Die Bereiche stehen ohne das Präfix `https://www.googleapis.com/auth/`. „Keiner“ heißt, dass das globale Objekt
+selbst keine Autorisierung braucht; das Blatt, der Bereich oder der Ordner, den die Funktion erhält, braucht trotzdem
+den Bereich des Dienstes, aus dem er stammt — dazu der nächste Abschnitt.
Alles Übrige in `appsscript` nimmt das Dienstobjekt als Argument: `appendRows` schreibt in das `Sheet`, das Sie ihm
geben, und `requireSheet` betrachtet den übergebenen Wert, statt selbst einen zu holen. Solche Funktionen brauchen
ein lebendes Dienstobjekt, um nützlich zu sein, suchen aber keines — genau das macht sie im Test ersetzbar.
+## OAuth-Bereiche
+
+Apps Script entscheidet, welche Bereiche es anfordert, indem es den Code des ganzen Projekts durchsucht, die
+Bibliothek eingeschlossen. Ein Projekt, das die Bibliothek vollständig einbindet, kann den Nutzer daher um mehr bitten,
+als es tatsächlich verwendet. Tragen Sie die Bereiche deshalb selbst in `appsscript.json` ein: Sobald `oauthScopes`
+vorhanden ist, fordert Apps Script genau diese an und keine anderen.
+
+| Was Ihr Code aufruft | Engster Bereich | Breitere Alternative |
+| :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------ | :-------------------------------------------- |
+| Jede Funktion, die ein `Sheet`, `Range`, `Spreadsheet` oder `RichTextValue` aus der gebundenen Tabelle erhält | `spreadsheets.currentonly` | `spreadsheets`, für per ID geöffnete Tabellen |
+| `getSheetById`, `getSheetByIndex` ohne Tabelle | `spreadsheets.currentonly` | `spreadsheets` |
+| Jede Funktion, die eine `Slide` oder `Presentation` erhält, sowie `getSlideByIndex`, `getSlideIndex` ohne Präsentation | `presentations.currentonly` | `presentations` |
+| `createFolder` | `drive` | — |
+| `getTriggerById` | `script.scriptapp` | — |
+| `checkMultipleAccount` | `userinfo.email` | — |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `userinfo.email`, `admin.directory.user.readonly` | `admin.directory.user` |
+| Alles in `lang`, `net`, `json`, `html`, `time` und `exception` sowie die Helfer für A1-Notation, Spaltenbuchstaben und `GridRange` | keiner | — |
+
+Ein an eine Tabelle gebundenes Skript, das nur mit dieser Tabelle arbeitet, braucht nicht mehr als das:
+
+```json
+{
+ "timeZone": "Etc/UTC",
+ "runtimeVersion": "V8",
+ "oauthScopes": ["https://www.googleapis.com/auth/spreadsheets.currentonly"]
+}
+```
+
+Was Sie vor dem Einschränken wissen sollten:
+
+- **`*.currentonly`** deckt nur das Dokument ab, an das das Skript gebunden ist, oder das, in dem ein Add-on läuft.
+ Ein Skript, das andere Tabellen oder Präsentationen per ID oder URL öffnet, braucht `spreadsheets` oder
+ `presentations`.
+- **`createFolder`** sucht zuerst vorhandene Ordner nach Namen und legt erst dann einen neuen an. Mit `drive.file`
+ sieht ein Skript nur die Dateien und Ordner, die es selbst angelegt oder die der Nutzer damit geöffnet hat; die
+ Suche übersieht also Ordner, die jemand anderes angelegt hat, und es entstehen Duplikate. Verwenden Sie
+ `drive.file` nur, wenn das Skript den ganzen Baum selbst anlegt, sonst `drive`.
+- **Die Admin-SDK-Funktionen** brauchen außerdem den im Projekt aktivierten erweiterten Dienst Admin SDK Directory
+ (`dependencies.enabledAdvancedServices`, `serviceId` `admin`, `version` `directory_v1`) und einen Nutzer, der das
+ Verzeichnis lesen darf. Der Lesebereich `admin.directory.user.readonly` genügt: `isAdmin` liest den Nutzer nur.
+- **Ein fehlender Bereich** zeigt sich zur Laufzeit, als Autorisierungsfehler beim Dienstaufruf, nicht beim Speichern
+ des Projekts. Führen Sie nach jeder Änderung an `oauthScopes` jeden Codepfad einmal aus.
+
+Welchen Bereich eine Methode braucht, steht unter „Authorization“ auf ihrer Seite in der
+[Apps-Script-Referenz](https://developers.google.com/apps-script/reference).
+
## An der Grenze bündeln
Jeder Dienstaufruf ist ein Hin und Zurück, und Apps Script rechnet ihn gegen das Zeitlimit. Die Schreibhelfer gibt
@@ -50,7 +110,7 @@ Dieselbe Überlegung gilt für die Prüfung. Prüfen Sie die Form der Daten, bev
danach:
```typescript
-import { IllegalArgumentException, appendRows, isConsistent2DArray } from "apps-script-utils";
+import { IllegalArgumentException, appendRows, isConsistent2DArray } from "@bootgs/utils";
if (!isConsistent2DArray(rows)) {
throw new IllegalArgumentException("every row must have the same number of columns");
diff --git a/docs/content/de/topics/ecosystem.md b/docs/content/de/topics/ecosystem.md
index 443b31d1..5b8de199 100644
--- a/docs/content/de/topics/ecosystem.md
+++ b/docs/content/de/topics/ecosystem.md
@@ -2,7 +2,7 @@
Das Framework boot.gs, das auf dieser Bibliothek aufbaut, und die Agent Skills, die KI-Agenten den Umgang damit beibringen.
-Wie apps-script-utils mit dem boot.gs-Framework für Google Apps Script zusammenhängt und mit den Agent Skills, die Claude Code, Gemini CLI und Cursor den Umgang mit beidem beibringen.
+Wie @bootgs/utils mit dem boot.gs-Framework für Google Apps Script zusammenhängt und mit den Agent Skills, die Claude Code, Gemini CLI und Cursor den Umgang mit beidem beibringen.
Die Bibliothek ist für sich allein nützlich: installieren, eine Funktion importieren, fertig. Sie ist zugleich Teil
eines kleinen Ökosystems für die Entwicklung mit Google Apps Script, und zwei Nachbarn lohnen die Bekanntschaft.
@@ -29,7 +29,7 @@ export class SheetController {
}
```
-**Das Verhältnis zu dieser Bibliothek ist eine Abhängigkeit, keine Rivalität.** `bootgs` führt `apps-script-utils`
+**Das Verhältnis zu dieser Bibliothek ist eine Abhängigkeit, keine Rivalität.** `bootgs` führt `@bootgs/utils`
unter seinen Laufzeitabhängigkeiten, ein boot.gs-Projekt hat also jede hier beschriebene Funktion bereits an Bord,
ohne zweite Installation. Aus diesen Prüfungen sind seine Parametervalidierung und seine Dienstsuche gebaut.
@@ -37,7 +37,7 @@ Wozu man greift:
| Was gebraucht wird | Was man nimmt |
| :---------------------------------------------------------------------------- | :------------------------------------- |
-| Helfer in einem bestehenden Skript — ein paar Funktionen, keine neue Struktur | `apps-script-utils` allein |
+| Helfer in einem bestehenden Skript — ein paar Funktionen, keine neue Struktur | `@bootgs/utils` allein |
| Routing, Controller, Dependency Injection, eine Web-App mit echten Endpunkten | `bootgs`, die Bibliothek ist enthalten |
## Agent Skills — einem KI-Agenten diese Bibliothek beibringen
@@ -50,7 +50,7 @@ Der Katalog zerfällt in zwei Teile:
| Skill | Behandelt |
| :------------------------------ | :--------------------------------------------------------------------------------------------------- |
-| `apps-script-utils` | diese Bibliothek: die Konvention `isX`/`nonX`/`requireX`, die Prüfungen, die Helfer |
+| `@bootgs/utils` | diese Bibliothek: die Konvention `isX`/`nonX`/`requireX`, die Prüfungen, die Helfer |
| `apps-script-triggers` | einfache und installierbare Trigger, die Gestalt der Ereignisse, Kontingente |
| `apps-script-services` | kontingentschonende Nutzung von `SpreadsheetApp`, `PropertiesService`, `CacheService`, `LockService` |
| `apps-script-ui` | Menüs, Seitenleisten, Dialoge und die Fallstricke von `google.script.run` |
diff --git a/docs/content/de/topics/exception-handling.md b/docs/content/de/topics/exception-handling.md
index 7041865a..3d5f3316 100644
--- a/docs/content/de/topics/exception-handling.md
+++ b/docs/content/de/topics/exception-handling.md
@@ -2,7 +2,7 @@
Die Ausnahmehierarchie, wann welche Klasse geworfen wird und wie man sie fängt.
-Typisierte Ausnahmen in apps-script-utils: die Hierarchie unter Exception, welche Prüfung welche Klasse wirft und wie man sie in einem Google-Apps-Script-Projekt fängt.
+Typisierte Ausnahmen in @bootgs/utils: die Hierarchie unter Exception, welche Prüfung welche Klasse wirft und wie man sie in einem Google-Apps-Script-Projekt fängt.
Jeder Fehler, den diese Bibliothek auslöst, ist eine Instanz der Klasse `Exception` oder einer ihrer Ableitungen.
Ein einziges `catch` kann daher die Fehlschläge der Bibliothek von allem anderen unterscheiden, was die Laufzeit
@@ -40,7 +40,7 @@ sie — ein `catch` auf `RuntimeException` fängt also alles, was die Bibliothek
`Exception` bietet eine statische Typprüfung an; sie ist die empfohlene Abfrage, weil sie den Typ zugleich verengt:
```typescript
-import { Exception, requireString } from "apps-script-utils";
+import { Exception, requireString } from "@bootgs/utils";
try {
requireString(input);
@@ -56,7 +56,7 @@ try {
`instanceof` funktioniert ebenfalls und ist der Weg, einen einzelnen Fehlschlag zu fangen:
```typescript
-import { NullPointerException, requireNonNull } from "apps-script-utils";
+import { NullPointerException, requireNonNull } from "@bootgs/utils";
try {
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"));
diff --git a/docs/content/de/topics/getting-started.md b/docs/content/de/topics/getting-started.md
index 78e4f663..9b661495 100644
--- a/docs/content/de/topics/getting-started.md
+++ b/docs/content/de/topics/getting-started.md
@@ -2,7 +2,7 @@
Voraussetzungen, Installation und ein erstes lauffähiges Skript.
-apps-script-utils in einem Google-Apps-Script-Projekt installieren: npm-Paket, clasp-Einrichtung und ein erstes Skript, das mit der Bibliothek ein Blatt liest.
+@bootgs/utils in einem Google-Apps-Script-Projekt installieren: npm-Paket, clasp-Einrichtung und ein erstes Skript, das mit der Bibliothek ein Blatt liest.
## Voraussetzungen
@@ -12,13 +12,13 @@
## Installation
```bash
-npm install apps-script-utils
+npm install @bootgs/utils
```
Alles wird aus der Paketwurzel exportiert, ein einziger Importpfad deckt also die ganze Bibliothek ab:
```typescript
-import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script-utils";
+import { appendRows, isAdmin, parseA1Notation, requireString } from "@bootgs/utils";
```
## Erste Beispiele
@@ -28,7 +28,7 @@ import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script
Mehrere Datenzeilen in einem Zug anhängen:
```typescript
-import { appendRows } from "apps-script-utils";
+import { appendRows } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
@@ -44,7 +44,7 @@ appendRows(sheet, data);
Prüfen, ob der aktuelle Nutzer Administratorrechte hat:
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
@@ -58,7 +58,7 @@ if (isAdmin()) {
Eine zusammengesetzte A1-Notation in ein strukturiertes Objekt überführen:
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
@@ -73,7 +73,7 @@ Die meisten Funktionen der Bibliothek weisen falsche Eingaben zurück, statt sie
macht aus einem ungeprüften Wert einen typisierten — oder wirft:
```typescript
-import { requireString, requireNonEmptyString } from "apps-script-utils";
+import { requireString, requireNonEmptyString } from "@bootgs/utils";
function greet(name: unknown): string {
return `Hello, ${requireNonEmptyString(name)}!`;
diff --git a/docs/content/de/topics/module-appsscript.md b/docs/content/de/topics/module-appsscript.md
index 61f6b7c2..defc7775 100644
--- a/docs/content/de/topics/module-appsscript.md
+++ b/docs/content/de/topics/module-appsscript.md
@@ -2,7 +2,7 @@
Die Google-Apps-Script-Helfer: Tabellen, A1-Notation, Oberfläche, Drive und das Admin SDK.
-Das appsscript-Modul von apps-script-utils: Helfer für Tabellen und A1-Notation, Blattprüfungen, Oberfläche, Drive, Slides und Admin SDK für Google Apps Script.
+Das appsscript-Modul von @bootgs/utils: Helfer für Tabellen und A1-Notation, Blattprüfungen, Oberfläche, Drive, Slides und Admin SDK für Google Apps Script.
`appsscript` enthält alles, was einen Google-Dienst berührt. Es ist der Teil der Bibliothek, der nur innerhalb der
Apps-Script-Laufzeit läuft — was das beim Testen bedeutet, steht in [](apps-script-runtime.md).
@@ -26,7 +26,7 @@ halboffenen Grenzen, wie die Sheets-API sie führt, und nicht mit den einsbasier
nehmen:
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
parseA1Notation("Sheet1!A1:B10");
// {
@@ -47,7 +47,7 @@ Offene Notationen werden ebenfalls gelesen: `"5:15"` lässt die Spaltengrenzen o
`toA1Notation` ist die Umkehrung:
```typescript
-import { toA1Notation } from "apps-script-utils";
+import { toA1Notation } from "@bootgs/utils";
toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumnIndex: 2 });
// "A1:B10"
@@ -56,7 +56,7 @@ toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumn
`parseA1Notations` nimmt eine durch Kommas getrennte Liste und gibt je Eintrag einen `GridRange` zurück:
```typescript
-import { parseA1Notations } from "apps-script-utils";
+import { parseA1Notations } from "@bootgs/utils";
parseA1Notations("Sheet1!A1:B2, Sheet1!D1"); // zwei GridRange-Objekte
```
@@ -68,7 +68,7 @@ import {
extractRangeFromA1Notation,
extractSheetNameFromA1Notation,
updateSheetNameInA1Notation
-} from "apps-script-utils";
+} from "@bootgs/utils";
extractSheetNameFromA1Notation("'My Sheet'!A1"); // "My Sheet"
extractRangeFromA1Notation("'My Sheet'!A1:B2"); // "A1:B2"
@@ -85,7 +85,7 @@ import {
getColumnIndexByLetter,
getColumnLetterByIndex,
getColumnPositionByLetter
-} from "apps-script-utils";
+} from "@bootgs/utils";
getColumnIndexByLetter("A"); // 0
getColumnIndexByLetter("AZ"); // 51
@@ -104,7 +104,7 @@ import {
isCellGridRange,
isGridRangeContainedIn,
isGridRangeSameDimensions
-} from "apps-script-utils";
+} from "@bootgs/utils";
const header = { startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 5 };
const body = { startRowIndex: 1, endRowIndex: 100, startColumnIndex: 0, endColumnIndex: 5 };
@@ -116,7 +116,7 @@ isCellGridRange(header); // false — er umfasst fünf Spalten
## Zeilen und Spalten schreiben
```typescript
-import { appendRows, prependRows, appendColumns } from "apps-script-utils";
+import { appendRows, prependRows, appendColumns } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
@@ -136,7 +136,7 @@ je Zeile. Alle Zeilen müssen gleich lang sein; `isConsistent2DArray` aus [](mod
Dieselbe Konvention wie im Rest der Bibliothek, angewandt auf die Apps-Script-Klassen:
```typescript
-import { isSheet, isSpreadsheet, isRange, requireSheet } from "apps-script-utils";
+import { isSheet, isSpreadsheet, isRange, requireSheet } from "@bootgs/utils";
function rowCount(value: unknown): number {
return requireSheet(value).getLastRow();
@@ -149,7 +149,7 @@ function rowCount(value: unknown): number {
## Präsentationen
```typescript
-import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "apps-script-utils";
+import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "@bootgs/utils";
const presentation = SlidesApp.getActivePresentation();
@@ -167,7 +167,7 @@ der Wert keine Folie ist.
## Admin SDK
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
diff --git a/docs/content/de/topics/module-exception.md b/docs/content/de/topics/module-exception.md
index 70ebada3..1bc7d76b 100644
--- a/docs/content/de/topics/module-exception.md
+++ b/docs/content/de/topics/module-exception.md
@@ -2,7 +2,7 @@
Die Ausnahmeklassen und wie man sie erweitert.
-Das exception-Modul von apps-script-utils: die Basisklasse Exception, die davon abgeleiteten Klassen und wie man eine eigene in die Hierarchie einfügt.
+Das exception-Modul von @bootgs/utils: die Basisklasse Exception, die davon abgeleiteten Klassen und wie man eine eigene in die Hierarchie einfügt.
`exception` enthält die Fehlerklassen, die der Rest der Bibliothek wirft. Nichts darin hängt von der
Apps-Script-Laufzeit ab.
@@ -24,7 +24,7 @@ Ein Skript mit eigenen Fehlerfällen kann der Hierarchie beitreten, statt blanke
was zur Laufzeit entsteht, erweitern Sie `RuntimeException`:
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
export class QuotaExceededException extends RuntimeException {}
```
@@ -49,7 +49,7 @@ Jeder Konstruktor nimmt einen vorhandenen `Error` und übernimmt dessen Meldung
Typ ändert sich:
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
try {
UrlFetchApp.fetch(endpoint);
diff --git a/docs/content/de/topics/module-lang.md b/docs/content/de/topics/module-lang.md
index abc00849..371007c0 100644
--- a/docs/content/de/topics/module-lang.md
+++ b/docs/content/de/topics/module-lang.md
@@ -2,7 +2,7 @@
Die laufzeitunabhängigen Sprachwerkzeuge: Prüfungen, Arrays, Zahlen, Objekte, Zeichenketten.
-Das lang-Modul von apps-script-utils: Typprüfungen, Array- und Matrixhelfer, Zahleneinordnung, Objekt-Hashing und String-Umwandlung — alles unabhängig von der Laufzeit.
+Das lang-Modul von @bootgs/utils: Typprüfungen, Array- und Matrixhelfer, Zahleneinordnung, Objekt-Hashing und String-Umwandlung — alles unabhängig von der Laufzeit.
`lang` sind die sprachnahen Werkzeuge — der Teil der Bibliothek, der nichts von Google Apps Script weiß und überall
läuft, wo JavaScript läuft.
@@ -27,7 +27,7 @@ gemeinsam mit `lang` in [](reference-base.md).
zurück.
```typescript
-import { requireString, toKebabCase } from "apps-script-utils";
+import { requireString, toKebabCase } from "@bootgs/utils";
function slugify(input: unknown): string {
return toKebabCase(requireString(input));
@@ -37,7 +37,7 @@ function slugify(input: unknown): string {
## Arrays
```typescript
-import { chunk, transpose, is2DArray, isConsistent2DArray } from "apps-script-utils";
+import { chunk, transpose, is2DArray, isConsistent2DArray } from "@bootgs/utils";
chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
@@ -57,7 +57,7 @@ die die betroffene Zeile nicht nennt.
## Zahlen
```typescript
-import { isCountable, isFloat, isInteger, toInteger } from "apps-script-utils";
+import { isCountable, isFloat, isInteger, toInteger } from "@bootgs/utils";
isInteger(42); // true
isInteger(42.5); // false
@@ -74,7 +74,7 @@ Zeilen- und Spaltenargumente der Sheets-API sind Anzahlen, keine beliebigen Zahl
Schreibweisen:
```typescript
-import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "apps-script-utils";
+import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "@bootgs/utils";
toCamelCase("user name"); // "userName"
toKebabCase("User Name"); // "user-name"
@@ -85,7 +85,7 @@ toProperCase("user name"); // "User Name"
Prüfungen:
```typescript
-import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "apps-script-utils";
+import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "@bootgs/utils";
isEmail("ada@example.com"); // true
isValidSlug("my-post"); // true
@@ -97,7 +97,7 @@ requireValidEmail(formResponse); // gibt den Wert zurück oder wirft InvalidEmai
Versionsvergleich, für Skripte, die ihr Verhalten von einer Bibliotheksversion abhängig machen:
```typescript
-import { versionCompare, isVersionCompatible } from "apps-script-utils";
+import { versionCompare, isVersionCompatible } from "@bootgs/utils";
versionCompare("1.10.0", "1.9.0"); // 1
versionCompare("1.9.0", "1.10.0"); // -1
@@ -108,7 +108,7 @@ versionCompare("1.9.0", "1.9.0"); // 0
Suchbegriff aus einer Zelle oder einem Formular kommt:
```typescript
-import { escapeRegExp } from "apps-script-utils";
+import { escapeRegExp } from "@bootgs/utils";
const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
```
@@ -116,7 +116,7 @@ const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
## Objekte
```typescript
-import { hashCode, objectToString } from "apps-script-utils";
+import { hashCode, objectToString } from "@bootgs/utils";
objectToString([]); // "[object Array]"
objectToString(null); // "[object Null]"
diff --git a/docs/content/de/topics/module-net.md b/docs/content/de/topics/module-net.md
index 7340dc71..85b685d6 100644
--- a/docs/content/de/topics/module-net.md
+++ b/docs/content/de/topics/module-net.md
@@ -2,7 +2,7 @@
Helfer für URLs, Pfade und Domains.
-Das net-Modul von apps-script-utils: URL-Prüfung, Pfade zerlegen, zusammenfügen und normalisieren, Domain-Prüfungen — alles auch innerhalb von Google Apps Script.
+Das net-Modul von @bootgs/utils: URL-Prüfung, Pfade zerlegen, zusammenfügen und normalisieren, Domain-Prüfungen — alles auch innerhalb von Google Apps Script.
`net` behandelt Pfade, URLs und das, was darum herum liegt. Wie `lang` hängt es nicht von der Apps-Script-Laufzeit
ab.
@@ -21,7 +21,7 @@ Script gebunden ist — siehe [](module-appsscript.md).
## Pfade
```typescript
-import { join, normalize, parse, isAbsolute, isRelative } from "apps-script-utils";
+import { join, normalize, parse, isAbsolute, isRelative } from "@bootgs/utils";
join("/a", "b", "../c"); // "/a/c"
normalize("/a/b/../c"); // "/a/c"
@@ -39,7 +39,7 @@ Sie sind der Form von Nodes `path`-Modul nachgebildet, was sie für den Aufbau v
## Domains und URLs
```typescript
-import { isValidDomain, isUrl } from "apps-script-utils";
+import { isValidDomain, isUrl } from "@bootgs/utils";
isValidDomain("example.com"); // true
isValidDomain("not a domain"); // false
diff --git a/docs/content/de/topics/overview.md b/docs/content/de/topics/overview.md
index dea4bc46..59d91181 100644
--- a/docs/content/de/topics/overview.md
+++ b/docs/content/de/topics/overview.md
@@ -1,14 +1,14 @@
# Überblick
-Was apps-script-utils ist, was die Bibliothek abdeckt und wie diese Dokumentation aufgebaut ist.
+Was @bootgs/utils ist, was die Bibliothek abdeckt und wie diese Dokumentation aufgebaut ist.
-apps-script-utils ist eine TypeScript-Bibliothek für Google Apps Script: Tabellen- und A1-Notation-Helfer, isX/nonX/requireX-Validierung und typisierte Ausnahmen.
+@bootgs/utils ist eine TypeScript-Bibliothek für Google Apps Script: Tabellen- und A1-Notation-Helfer, isX/nonX/requireX-Validierung und typisierte Ausnahmen.

_Künstlerin: [Daryna Mikhailenko](https://darynamikhailenko.com/?utm_source=docs&utm_medium=overview&utm_campaign=apps-script-utils&utm_content=banner-artist-credit)_
-**apps-script-utils** ist eine TypeScript-Bibliothek, die eigens für **Google Apps Script** gebaut wurde. Sie
+**@bootgs/utils** ist eine TypeScript-Bibliothek, die eigens für **Google Apps Script** gebaut wurde. Sie
versammelt in einem getesteten Paket, was in jedem GAS-Projekt am Ende doch von Hand geschrieben wird: Arbeit mit
Tabellen und A1-Notation, Typ- und Wertprüfungen (`isX`/`nonX`/`requireX`), String- und Array-Transformationen,
typisierte Ausnahmen und mehr.
diff --git a/docs/content/de/topics/reference-abstracts.md b/docs/content/de/topics/reference-abstracts.md
index 30939e8c..b090a3c6 100644
--- a/docs/content/de/topics/reference-abstracts.md
+++ b/docs/content/de/topics/reference-abstracts.md
@@ -2,7 +2,7 @@
Die abstrakten Basisklassen, auf denen die Bibliothek aufbaut.
-Referenz der abstrakten Basisklassen von apps-script-utils und wofür sie erweitert werden.
+Referenz der abstrakten Basisklassen von @bootgs/utils und wofür sie erweitert werden.
Gemeinsame abstrakte Klassen und Schnittstellen, die die übrigen Module der Bibliothek als Bausteine verwenden.
diff --git a/docs/content/de/topics/reference-appsscript.md b/docs/content/de/topics/reference-appsscript.md
index 531fc420..fafe2ec2 100644
--- a/docs/content/de/topics/reference-appsscript.md
+++ b/docs/content/de/topics/reference-appsscript.md
@@ -2,7 +2,7 @@
Alle Google-Apps-Script-Funktionen der Bibliothek, nach Dienst gruppiert.
-Referenz aller Google-Apps-Script-Funktionen von apps-script-utils: Tabellen, A1-Notation, Oberfläche, Drive, Slides und Admin SDK — mit Rückgabetypen.
+Referenz aller Google-Apps-Script-Funktionen von @bootgs/utils: Tabellen, A1-Notation, Oberfläche, Drive, Slides und Admin SDK — mit Rückgabetypen.
Funktionen, die an bestimmte Google-Apps-Script-Dienste gebunden sind: Tabellen, Präsentationen, Admin SDK, Drive,
Dokumente, Formulare, Netzwerkanfragen und die eingebauten Oberflächenklassen.
@@ -28,11 +28,11 @@ Helfer für den [Admin-SDK-Directory-Dienst](https://developers.google.cn/apps-s
## Methoden für Google Docs {id="google-docs-methods"}
-Helfer für Google Docs. Noch nicht umgesetzt. Beiträge sind willkommen — siehe [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Helfer für Google Docs. Noch nicht umgesetzt. Beiträge sind willkommen — siehe [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Methoden für Google Forms {id="google-forms-methods"}
-Helfer für Google Forms. Noch nicht umgesetzt. Beiträge sind willkommen — siehe [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Helfer für Google Forms. Noch nicht umgesetzt. Beiträge sind willkommen — siehe [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Methoden für Google Tabellen {id="google-sheets-methods"}
diff --git a/docs/content/de/topics/reference-base.md b/docs/content/de/topics/reference-base.md
index 0cfd8a89..222d908a 100644
--- a/docs/content/de/topics/reference-base.md
+++ b/docs/content/de/topics/reference-base.md
@@ -2,7 +2,7 @@
Alle laufzeitunabhängigen Funktionen: Prüfungen, Arrays, Zahlen, Zeichenketten, Objekte, JSON und HTML.
-Referenz aller laufzeitunabhängigen Funktionen von apps-script-utils: isX/nonX/requireX-Prüfungen, Array-, Zahlen-, String-, Objekt-, JSON-, HTML- und Zeit-Helfer.
+Referenz aller laufzeitunabhängigen Funktionen von @bootgs/utils: isX/nonX/requireX-Prüfungen, Array-, Zahlen-, String-, Objekt-, JSON-, HTML- und Zeit-Helfer.
Funktionen ohne Bindung an ein Framework: Typ- und Wertprüfung (`isX`/`nonX`/`requireX`), Arbeit mit Zeichenketten,
Arrays und Objekten, JSON und HTML. Die Google-Apps-Script-Laufzeit brauchen sie nicht.
diff --git a/docs/content/de/topics/reference-exception.md b/docs/content/de/topics/reference-exception.md
index 08478228..8428728e 100644
--- a/docs/content/de/topics/reference-exception.md
+++ b/docs/content/de/topics/reference-exception.md
@@ -2,7 +2,7 @@
Alle Ausnahmeklassen, die die Bibliothek wirft.
-Referenz der Ausnahmeklassen von apps-script-utils: was jede bedeutet und welche Funktionen sie werfen.
+Referenz der Ausnahmeklassen von @bootgs/utils: was jede bedeutet und welche Funktionen sie werfen.
Typisierte Ausnahmeklassen, die in der ganzen Bibliothek verwendet werden. Dienstgebundene Ausnahmen (Tabellen,
Präsentationen, Admin SDK, Netzwerk) erben von der gemeinsamen Basisklasse `Exception` — für eine einheitliche
diff --git a/docs/content/de/topics/reference-path.md b/docs/content/de/topics/reference-path.md
index 2369f16f..323dc5ec 100644
--- a/docs/content/de/topics/reference-path.md
+++ b/docs/content/de/topics/reference-path.md
@@ -2,7 +2,7 @@
Alle Funktionen für Pfade und URLs.
-Referenz der Pfad- und URL-Funktionen von apps-script-utils: Zerlegen, Zusammenfügen, Normalisieren und Prüfen von Pfaden und Domains.
+Referenz der Pfad- und URL-Funktionen von @bootgs/utils: Zerlegen, Zusammenfügen, Normalisieren und Prüfen von Pfaden und Domains.
Funktionen für die Arbeit mit Dateipfaden und URLs.
diff --git a/docs/content/de/topics/validation-conventions.md b/docs/content/de/topics/validation-conventions.md
index 9a9d1e46..3ee142bc 100644
--- a/docs/content/de/topics/validation-conventions.md
+++ b/docs/content/de/topics/validation-conventions.md
@@ -2,7 +2,7 @@
Das Namensschema isX / nonX / requireX / requireNonX und was jedes Präfix zusichert.
-Das Namensschema der Prüfungen in apps-script-utils: isX und nonX beantworten eine Frage, requireX und requireNonX prüfen und geben den Wert zurück — jedes Präfix mit eigener Signatur.
+Das Namensschema der Prüfungen in @bootgs/utils: isX und nonX beantworten eine Frage, requireX und requireNonX prüfen und geben den Wert zurück — jedes Präfix mit eigener Signatur.
Der größte Teil dieser Bibliothek besteht aus Prüfungen, und fast alle folgen einem einzigen Namensschema. Lernen
Sie die vier Präfixe einmal, und der Name einer Funktion verrät ihre Signatur, ihren Rückgabewert und ob sie werfen
@@ -27,7 +27,7 @@ Die `isX`-Prüfungen sind als TypeScript-Typprädikate deklariert, der Compiler
Zweigs:
```typescript
-import { isString } from "apps-script-utils";
+import { isString } from "@bootgs/utils";
function describe(value: unknown): string {
if (isString(value)) {
@@ -41,7 +41,7 @@ function describe(value: unknown): string {
`nonX` verengt in die Gegenrichtung — es entfernt `X` aus dem Typ, statt ihn zu bestätigen:
```typescript
-import { nonString } from "apps-script-utils";
+import { nonString } from "@bootgs/utils";
function lengthOf(value: string | number): number {
if (nonString(value)) {
@@ -62,7 +62,7 @@ Wächterklausel sich wie ein Satz liest und nicht wie eine Verneinung — was do
verlangen:
```typescript
-import { requireNumber, requireString } from "apps-script-utils";
+import { requireNumber, requireString } from "@bootgs/utils";
function repeat(text: unknown, times: unknown): string {
return requireString(text).repeat(requireNumber(times));
@@ -109,7 +109,7 @@ Drei Namen decken die leeren Fälle ab, und die Unterscheidung ist genau:
zurück und wirft `NullPointerException`:
```typescript
-import { requireNonNull } from "apps-script-utils";
+import { requireNonNull } from "@bootgs/utils";
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"), "sheet 'Data' is missing");
```
diff --git a/docs/content/en/functions/compact.json b/docs/content/en/functions/compact.json
index b3505eb1..9652185e 100644
--- a/docs/content/en/functions/compact.json
+++ b/docs/content/en/functions/compact.json
@@ -23,7 +23,7 @@
},
{
"title": "When `nonNil` is the better filter",
- "body": "```typescript\nimport { nonNil } from \"apps-script-utils\";\n\nconst cells = [0, \"\", 5, null]; // a column read from a sheet\n\ncompact(cells); // => [5] — drops the legitimate 0 and the empty cell\ncells.filter(nonNil); // => [0, \"\", 5] — drops only the absent values\n```"
+ "body": "```typescript\nimport { nonNil } from \"@bootgs/utils\";\n\nconst cells = [0, \"\", 5, null]; // a column read from a sheet\n\ncompact(cells); // => [5] — drops the legitimate 0 and the empty cell\ncells.filter(nonNil); // => [0, \"\", 5] — drops only the absent values\n```"
}
],
"seeAlso": [
diff --git a/docs/content/en/functions/requireNoNilElements.json b/docs/content/en/functions/requireNoNilElements.json
index aa9eed97..2e6f9ef3 100644
--- a/docs/content/en/functions/requireNoNilElements.json
+++ b/docs/content/en/functions/requireNoNilElements.json
@@ -22,7 +22,7 @@
},
{
"title": "Narrowing the element type",
- "body": "```typescript\nimport { requireNoNilElements } from \"apps-script-utils\";\n\nconst values: Array = readColumn();\n\nconst names: string[] = requireNoNilElements(values, \"the column has empty cells\");\n```"
+ "body": "```typescript\nimport { requireNoNilElements } from \"@bootgs/utils\";\n\nconst values: Array = readColumn();\n\nconst names: string[] = requireNoNilElements(values, \"the column has empty cells\");\n```"
},
{
"title": "What passes and what throws",
diff --git a/docs/content/en/functions/unique.json b/docs/content/en/functions/unique.json
index e3736e4a..bc10c5a5 100644
--- a/docs/content/en/functions/unique.json
+++ b/docs/content/en/functions/unique.json
@@ -19,7 +19,7 @@
},
{
"title": "Deduplicating records by a key",
- "body": "```typescript\nimport { unique } from \"apps-script-utils\";\n\nconst rows = [\n { id: 1, name: \"first\" },\n { id: 1, name: \"second\" },\n { id: 2, name: \"third\" }\n];\n\nunique(rows, (row) => row.id); // => [{ id: 1, name: \"first\" }, { id: 2, name: \"third\" }]\n```"
+ "body": "```typescript\nimport { unique } from \"@bootgs/utils\";\n\nconst rows = [\n { id: 1, name: \"first\" },\n { id: 1, name: \"second\" },\n { id: 2, name: \"third\" }\n];\n\nunique(rows, (row) => row.id); // => [{ id: 1, name: \"first\" }, { id: 2, name: \"third\" }]\n```"
},
{
"title": "Collecting the distinct values of a column",
diff --git a/docs/content/en/functions/without.json b/docs/content/en/functions/without.json
index dc5d654e..ce191a7d 100644
--- a/docs/content/en/functions/without.json
+++ b/docs/content/en/functions/without.json
@@ -19,7 +19,7 @@
},
{
"title": "Dropping the blanks a column comes with",
- "body": "```typescript\nimport { without } from \"apps-script-utils\";\n\nconst names = sheet.getRange(\"A2:A\").getValues().flat();\n\nwithout(names, \"\", \"N/A\"); // the real entries, in sheet order\n```"
+ "body": "```typescript\nimport { without } from \"@bootgs/utils\";\n\nconst names = sheet.getRange(\"A2:A\").getValues().flat();\n\nwithout(names, \"\", \"N/A\"); // the real entries, in sheet order\n```"
},
{
"title": "Removing a column from a header row",
diff --git a/docs/content/fr/topics/apps-script-runtime.md b/docs/content/fr/topics/apps-script-runtime.md
index cff2d5e3..8ab83ebf 100644
--- a/docs/content/fr/topics/apps-script-runtime.md
+++ b/docs/content/fr/topics/apps-script-runtime.md
@@ -2,7 +2,7 @@
Quelles fonctions exigent l'environnement Apps Script et lesquelles s'exécutent partout.
-Quelles parties d'apps-script-utils dépendent des services Google Apps Script et lesquelles tournent dans Node.js ou une suite de tests — et ce que cela implique pour tester votre code.
+Quelles parties d'@bootgs/utils dépendent des services Google Apps Script et lesquelles tournent dans Node.js ou une suite de tests — et ce que cela implique pour tester votre code.
La bibliothèque est un seul paquet, mais ses fonctions ne s'exécutent pas toutes aux mêmes endroits. Le côté de la
ligne où se trouve une fonction décide si vous pouvez la tester unitairement et si elle coûte un appel de service.
@@ -17,20 +17,81 @@ simples : les analyseurs de notation A1, les conversions de lettres de colonne e
Les fonctions **liées à un service** vont chercher elles-mêmes un service global. Elles ne fonctionnent que dans un
script dont la portée est autorisée, et pas du tout dans Node. Voici la liste entière à ce jour :
-| Fonction | Globale utilisée |
-| :---------------------- | :------------------------------------------------------------------- |
-| `isAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` |
-| `checkMultipleAccount` | `Session.getEffectiveUser` |
-| `getSheetById` | `SpreadsheetApp.getActiveSpreadsheet`, si aucun classeur n'est passé |
-| `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, si aucun classeur n'est passé |
-| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` |
-| `convertRichTextToHtml` | `Utilities.formatString` |
+| Fonction | Globale utilisée | Portée nécessaire |
+| :------------------------------------ | :--------------------------------------------------------------------- | :------------------------------------------------ |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` | `userinfo.email`, `admin.directory.user.readonly` |
+| `checkMultipleAccount` | `Session.getEffectiveUser` | `userinfo.email` |
+| `getSheetById`, `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, si aucun classeur n'est passé | `spreadsheets.currentonly` |
+| `getSlideByIndex`, `getSlideIndex` | `SlidesApp.getActivePresentation`, si aucune présentation n'est passée | `presentations.currentonly` |
+| `createFolder` | `DriveApp.getRootFolder`, si aucun dossier parent n'est passé | `drive` |
+| `getTriggerById` | `ScriptApp.getProjectTriggers` | `script.scriptapp` |
+| `appendRows`, `prependRows` | `LockService.getDocumentLock` | aucune pour le verrou |
+| `appendRow`, `prependRow` | `LockService.getDocumentLock`, par les deux fonctions ci-dessus | aucune pour le verrou |
+| `appendColumns`, `prependColumns` | `LockService.getDocumentLock` | aucune pour le verrou |
+| `appendColumn`, `prependColumn` | `LockService.getDocumentLock`, par les deux fonctions ci-dessus | aucune pour le verrou |
+| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` | aucune pour les constructeurs |
+| `insertSchema` | `SpreadsheetApp.newDataValidation` | aucune pour le constructeur |
+| `deleteRowsByConditional` | `SpreadsheetApp.Dimension` | aucune pour l'énumération |
+| `deleteColumnsByConditional` | `SpreadsheetApp.Dimension` | aucune pour l'énumération |
+| `convertRichTextToHtml` | `Utilities.formatString` | aucune |
+| `retry` | `Utilities.sleep`, s'il existe | aucune |
+
+Les portées sont écrites sans le préfixe `https://www.googleapis.com/auth/`. « Aucune » signifie que la globale
+elle-même ne demande pas d'autorisation ; la feuille, la plage ou le dossier que reçoit la fonction a quand même
+besoin de la portée du service dont il provient, comme l'explique la section suivante.
Tout le reste d'`appsscript` reçoit en argument l'objet de service sur lequel il agit : `appendRows` écrit dans le
`Sheet` que vous lui donnez, `requireSheet` examine la valeur reçue au lieu d'en chercher une. Ces fonctions ont
besoin d'un objet de service vivant pour servir à quelque chose, mais elles n'en cherchent jamais — et c'est ce qui
les rend remplaçables dans un test.
+## Portées OAuth
+
+Apps Script choisit les portées à demander en parcourant le code de tout le projet, bibliothèque comprise. Un projet
+qui intègre la bibliothèque entière peut donc demander à l'utilisateur plus qu'il n'utilise réellement. Indiquez
+plutôt les portées vous-même dans `appsscript.json` : dès que `oauthScopes` est présent, Apps Script demande
+exactement celles-là et aucune autre.
+
+| Ce que votre code appelle | Portée la plus étroite | Alternative plus large |
+| :------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------ | :------------------------------------------------ |
+| Toute fonction qui reçoit un `Sheet`, un `Range`, un `Spreadsheet` ou une `RichTextValue` du classeur lié | `spreadsheets.currentonly` | `spreadsheets`, pour les classeurs ouverts par ID |
+| `getSheetById`, `getSheetByIndex` sans classeur | `spreadsheets.currentonly` | `spreadsheets` |
+| Toute fonction qui reçoit une `Slide` ou une `Presentation`, ainsi que `getSlideByIndex`, `getSlideIndex` sans présentation | `presentations.currentonly` | `presentations` |
+| `createFolder` | `drive` | — |
+| `getTriggerById` | `script.scriptapp` | — |
+| `checkMultipleAccount` | `userinfo.email` | — |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `userinfo.email`, `admin.directory.user.readonly` | `admin.directory.user` |
+| Tout `lang`, `net`, `json`, `html`, `time` et `exception`, ainsi que les utilitaires de notation A1, de lettres de colonne et de `GridRange` | aucune | — |
+
+Un script lié à un classeur qui ne travaille que sur ce classeur n'a besoin de rien de plus :
+
+```json
+{
+ "timeZone": "Etc/UTC",
+ "runtimeVersion": "V8",
+ "oauthScopes": ["https://www.googleapis.com/auth/spreadsheets.currentonly"]
+}
+```
+
+À savoir avant de restreindre :
+
+- **`*.currentonly`** ne couvre que le document auquel le script est lié, ou celui dans lequel tourne un module
+ complémentaire. Un script qui ouvre d'autres classeurs ou présentations par ID ou URL a besoin de `spreadsheets` ou
+ de `presentations`.
+- **`createFolder`** cherche d'abord les dossiers existants par leur nom avant d'en créer un. Avec `drive.file`, un
+ script ne voit que les fichiers et dossiers qu'il a créés ou que l'utilisateur a ouverts avec lui ; la recherche
+ manque donc les dossiers créés par d'autres et crée des doublons. N'utilisez `drive.file` que si le script crée
+ lui-même toute l'arborescence ; sinon, `drive`.
+- **Les fonctions Admin SDK** demandent aussi que le service avancé Admin SDK Directory soit activé dans le projet
+ (`dependencies.enabledAdvancedServices`, `serviceId` `admin`, `version` `directory_v1`), et un utilisateur autorisé
+ à lire l'annuaire. La portée en lecture seule `admin.directory.user.readonly` suffit : `isAdmin` ne fait que lire
+ l'utilisateur.
+- **Une portée manquante** se manifeste à l'exécution, par une erreur d'autorisation lors de l'appel au service, et
+ non à l'enregistrement du projet. Après avoir modifié `oauthScopes`, exécutez une fois chaque chemin du code.
+
+La portée nécessaire à chaque méthode figure sous « Authorization » sur sa page de la
+[référence Apps Script](https://developers.google.com/apps-script/reference).
+
## Grouper à la frontière
Chaque appel de service est un aller-retour, et Apps Script le décompte de la limite de temps d'exécution. Les aides
@@ -51,7 +112,7 @@ Le même raisonnement vaut pour la validation. Vérifiez la forme des données a
pas après :
```typescript
-import { IllegalArgumentException, appendRows, isConsistent2DArray } from "apps-script-utils";
+import { IllegalArgumentException, appendRows, isConsistent2DArray } from "@bootgs/utils";
if (!isConsistent2DArray(rows)) {
throw new IllegalArgumentException("every row must have the same number of columns");
diff --git a/docs/content/fr/topics/ecosystem.md b/docs/content/fr/topics/ecosystem.md
index 71b9f732..2ea5bc14 100644
--- a/docs/content/fr/topics/ecosystem.md
+++ b/docs/content/fr/topics/ecosystem.md
@@ -2,7 +2,7 @@
Le framework boot.gs, bâti sur cette bibliothèque, et les Agent Skills qui apprennent aux agents IA à s'en servir.
-Comment apps-script-utils s'articule avec le framework boot.gs pour Google Apps Script et avec les Agent Skills qui apprennent à Claude Code, Gemini CLI et Cursor à utiliser les deux.
+Comment @bootgs/utils s'articule avec le framework boot.gs pour Google Apps Script et avec les Agent Skills qui apprennent à Claude Code, Gemini CLI et Cursor à utiliser les deux.
La bibliothèque est utile à elle seule : on l'installe, on importe une fonction, c'est fait. Elle fait aussi partie
d'un petit écosystème pour le développement Google Apps Script, et deux voisins méritent d'être connus.
@@ -29,7 +29,7 @@ export class SheetController {
}
```
-**Le lien avec cette bibliothèque est une dépendance, pas une rivalité.** `bootgs` inscrit `apps-script-utils` parmi
+**Le lien avec cette bibliothèque est une dépendance, pas une rivalité.** `bootgs` inscrit `@bootgs/utils` parmi
ses dépendances d'exécution : un projet boot.gs dispose donc déjà de chaque fonction décrite ici, sans seconde
installation. C'est de ces gardes que sont faites sa validation de paramètres et sa résolution de services.
@@ -37,7 +37,7 @@ Que choisir :
| Ce dont vous avez besoin | Ce que vous prenez |
| :------------------------------------------------------------------------------------- | :------------------------------------ |
-| Des aides dans un script existant — quelques fonctions, sans nouvelle architecture | `apps-script-utils` seul |
+| Des aides dans un script existant — quelques fonctions, sans nouvelle architecture | `@bootgs/utils` seul |
| Routage, contrôleurs, injection de dépendances, une application web avec des endpoints | `bootgs`, la bibliothèque est incluse |
## Agent Skills — apprendre cette bibliothèque à un agent IA
@@ -51,7 +51,7 @@ Le catalogue se divise en deux :
| Skill | Couvre |
| :------------------------------ | :--------------------------------------------------------------------------------------------- |
-| `apps-script-utils` | cette bibliothèque : la convention `isX`/`nonX`/`requireX`, les gardes, les aides |
+| `@bootgs/utils` | cette bibliothèque : la convention `isX`/`nonX`/`requireX`, les gardes, les aides |
| `apps-script-triggers` | déclencheurs simples et installables, forme des événements, quotas |
| `apps-script-services` | usage économe en quota de `SpreadsheetApp`, `PropertiesService`, `CacheService`, `LockService` |
| `apps-script-ui` | menus, barres latérales, boîtes de dialogue et les pièges de `google.script.run` |
diff --git a/docs/content/fr/topics/exception-handling.md b/docs/content/fr/topics/exception-handling.md
index d690a780..edc9eae1 100644
--- a/docs/content/fr/topics/exception-handling.md
+++ b/docs/content/fr/topics/exception-handling.md
@@ -2,7 +2,7 @@
La hiérarchie des exceptions, quand chaque classe est levée et comment les intercepter.
-Exceptions typées d'apps-script-utils : la hiérarchie sous Exception, quelle garde lève quelle classe, et comment les intercepter dans un projet Google Apps Script.
+Exceptions typées d'@bootgs/utils : la hiérarchie sous Exception, quelle garde lève quelle classe, et comment les intercepter dans un projet Google Apps Script.
Toute erreur que lève cette bibliothèque est une instance de la classe `Exception` ou de l'une de ses dérivées. Un
seul `catch` suffit donc à distinguer les échecs de la bibliothèque de tout ce que lève l'environnement.
@@ -39,7 +39,7 @@ Deux niveaux portent du sens. `Exception` est la racine et marque une erreur com
`Exception` expose une garde de type statique, la vérification recommandée puisqu'elle restreint aussi le type :
```typescript
-import { Exception, requireString } from "apps-script-utils";
+import { Exception, requireString } from "@bootgs/utils";
try {
requireString(input);
@@ -55,7 +55,7 @@ try {
`instanceof` fonctionne également, et c'est la façon d'attraper un échec précis :
```typescript
-import { NullPointerException, requireNonNull } from "apps-script-utils";
+import { NullPointerException, requireNonNull } from "@bootgs/utils";
try {
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"));
diff --git a/docs/content/fr/topics/getting-started.md b/docs/content/fr/topics/getting-started.md
index 474230a8..e9b2f40a 100644
--- a/docs/content/fr/topics/getting-started.md
+++ b/docs/content/fr/topics/getting-started.md
@@ -2,7 +2,7 @@
Prérequis, installation et un premier script qui fonctionne.
-Installer apps-script-utils dans un projet Google Apps Script : paquet npm, configuration de clasp et un premier script qui lit une feuille avec la bibliothèque.
+Installer @bootgs/utils dans un projet Google Apps Script : paquet npm, configuration de clasp et un premier script qui lit une feuille avec la bibliothèque.
## Prérequis
@@ -12,13 +12,13 @@
## Installation
```bash
-npm install apps-script-utils
+npm install @bootgs/utils
```
Tout est exporté depuis la racine du paquet : un seul chemin d'import couvre donc toute la bibliothèque.
```typescript
-import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script-utils";
+import { appendRows, isAdmin, parseA1Notation, requireString } from "@bootgs/utils";
```
## Premiers exemples
@@ -28,7 +28,7 @@ import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script
Ajouter plusieurs lignes de données en une fois :
```typescript
-import { appendRows } from "apps-script-utils";
+import { appendRows } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
@@ -44,7 +44,7 @@ appendRows(sheet, data);
Vérifier si l'utilisateur courant dispose des droits d'administration :
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
@@ -58,7 +58,7 @@ if (isAdmin()) {
Transformer une notation A1 composée en objet structuré :
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
@@ -73,7 +73,7 @@ La plupart des fonctions de la bibliothèque rejettent une entrée invalide plut
`requireX` transforme une valeur non vérifiée en valeur typée — ou lève :
```typescript
-import { requireString, requireNonEmptyString } from "apps-script-utils";
+import { requireString, requireNonEmptyString } from "@bootgs/utils";
function greet(name: unknown): string {
return `Hello, ${requireNonEmptyString(name)}!`;
diff --git a/docs/content/fr/topics/module-appsscript.md b/docs/content/fr/topics/module-appsscript.md
index 586d1b8e..f966e3e9 100644
--- a/docs/content/fr/topics/module-appsscript.md
+++ b/docs/content/fr/topics/module-appsscript.md
@@ -2,7 +2,7 @@
Les aides Google Apps Script : feuilles de calcul, notation A1, interface, Drive et Admin SDK.
-Le module appsscript d'apps-script-utils : aides pour les feuilles et la notation A1, validation de feuille, interface, Drive, Slides et Admin SDK pour Google Apps Script.
+Le module appsscript d'@bootgs/utils : aides pour les feuilles et la notation A1, validation de feuille, interface, Drive, Slides et Admin SDK pour Google Apps Script.
`appsscript` rassemble tout ce qui touche à un service Google. C'est la partie de la bibliothèque qui ne s'exécute
qu'à l'intérieur de l'environnement Apps Script — voir [](apps-script-runtime.md) pour ce que cela implique lors des
@@ -26,7 +26,7 @@ tests.
demi-ouvertes, conformes à l'API Sheets plutôt qu'aux positions à base un qu'attendent les méthodes de `Range` :
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
parseA1Notation("Sheet1!A1:B10");
// {
@@ -47,7 +47,7 @@ Les notations ouvertes s'analysent aussi : `"5:15"` laisse les bornes de colonne
`toA1Notation` fait l'inverse :
```typescript
-import { toA1Notation } from "apps-script-utils";
+import { toA1Notation } from "@bootgs/utils";
toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumnIndex: 2 });
// "A1:B10"
@@ -56,7 +56,7 @@ toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumn
`parseA1Notations` prend une liste séparée par des virgules et renvoie un `GridRange` par entrée :
```typescript
-import { parseA1Notations } from "apps-script-utils";
+import { parseA1Notations } from "@bootgs/utils";
parseA1Notations("Sheet1!A1:B2, Sheet1!D1"); // deux objets GridRange
```
@@ -68,7 +68,7 @@ import {
extractRangeFromA1Notation,
extractSheetNameFromA1Notation,
updateSheetNameInA1Notation
-} from "apps-script-utils";
+} from "@bootgs/utils";
extractSheetNameFromA1Notation("'My Sheet'!A1"); // "My Sheet"
extractRangeFromA1Notation("'My Sheet'!A1:B2"); // "A1:B2"
@@ -85,7 +85,7 @@ import {
getColumnIndexByLetter,
getColumnLetterByIndex,
getColumnPositionByLetter
-} from "apps-script-utils";
+} from "@bootgs/utils";
getColumnIndexByLetter("A"); // 0
getColumnIndexByLetter("AZ"); // 51
@@ -104,7 +104,7 @@ import {
isCellGridRange,
isGridRangeContainedIn,
isGridRangeSameDimensions
-} from "apps-script-utils";
+} from "@bootgs/utils";
const header = { startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 5 };
const body = { startRowIndex: 1, endRowIndex: 100, startColumnIndex: 0, endColumnIndex: 5 };
@@ -116,7 +116,7 @@ isCellGridRange(header); // false — elle couvre cinq colonnes
## Écrire des lignes et des colonnes
```typescript
-import { appendRows, prependRows, appendColumns } from "apps-script-utils";
+import { appendRows, prependRows, appendColumns } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
@@ -137,7 +137,7 @@ service et un par ligne. Toutes les lignes doivent avoir la même longueur — `
La même convention que dans le reste de la bibliothèque, appliquée aux classes Apps Script :
```typescript
-import { isSheet, isSpreadsheet, isRange, requireSheet } from "apps-script-utils";
+import { isSheet, isSpreadsheet, isRange, requireSheet } from "@bootgs/utils";
function rowCount(value: unknown): number {
return requireSheet(value).getLastRow();
@@ -150,7 +150,7 @@ function rowCount(value: unknown): number {
## Slides
```typescript
-import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "apps-script-utils";
+import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "@bootgs/utils";
const presentation = SlidesApp.getActivePresentation();
@@ -168,7 +168,7 @@ findReplaceAllTextInSlide(slide, "{{name}}", "Ada Lovelace");
## Admin SDK
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
diff --git a/docs/content/fr/topics/module-exception.md b/docs/content/fr/topics/module-exception.md
index 85e1fa93..d9e83c3a 100644
--- a/docs/content/fr/topics/module-exception.md
+++ b/docs/content/fr/topics/module-exception.md
@@ -2,7 +2,7 @@
Les classes d'exception et comment les étendre.
-Le module exception d'apps-script-utils : la classe de base Exception, les classes qui en dérivent, et comment ajouter la vôtre à la hiérarchie.
+Le module exception d'@bootgs/utils : la classe de base Exception, les classes qui en dérivent, et comment ajouter la vôtre à la hiérarchie.
`exception` contient les classes d'erreur que lève le reste de la bibliothèque. Rien n'y dépend de l'environnement
Apps Script.
@@ -24,7 +24,7 @@ Un script qui a ses propres modes d'échec peut rejoindre la hiérarchie plutôt
tout ce qui survient pendant l'exécution, dérivez de `RuntimeException` :
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
export class QuotaExceededException extends RuntimeException {}
```
@@ -49,7 +49,7 @@ Tout constructeur accepte une `Error` existante et en reprend le message : le te
change.
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
try {
UrlFetchApp.fetch(endpoint);
diff --git a/docs/content/fr/topics/module-lang.md b/docs/content/fr/topics/module-lang.md
index 6fa825d6..dcd5a3c4 100644
--- a/docs/content/fr/topics/module-lang.md
+++ b/docs/content/fr/topics/module-lang.md
@@ -2,7 +2,7 @@
Les utilitaires de langage indépendants de l'environnement : gardes, tableaux, nombres, objets, chaînes.
-Le module lang d'apps-script-utils : gardes de type, aides pour tableaux et matrices, classification des nombres, condensé d'objets et conversion de chaînes — le tout indépendant de l'environnement.
+Le module lang d'@bootgs/utils : gardes de type, aides pour tableaux et matrices, classification des nombres, condensé d'objets et conversion de chaînes — le tout indépendant de l'environnement.
`lang` regroupe les utilitaires proches du langage — la partie de la bibliothèque qui ignore tout de Google Apps
Script et fonctionne partout où fonctionne JavaScript.
@@ -26,7 +26,7 @@ l'environnement et figurent avec `lang` dans [](reference-base.md).
[](validation-conventions.md) ; en bref : `isX` et `nonX` répondent à une question, `requireX` valide et renvoie.
```typescript
-import { requireString, toKebabCase } from "apps-script-utils";
+import { requireString, toKebabCase } from "@bootgs/utils";
function slugify(input: unknown): string {
return toKebabCase(requireString(input));
@@ -36,7 +36,7 @@ function slugify(input: unknown): string {
## Tableaux
```typescript
-import { chunk, transpose, is2DArray, isConsistent2DArray } from "apps-script-utils";
+import { chunk, transpose, is2DArray, isConsistent2DArray } from "@bootgs/utils";
chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
@@ -56,7 +56,7 @@ la ligne fautive.
## Nombres
```typescript
-import { isCountable, isFloat, isInteger, toInteger } from "apps-script-utils";
+import { isCountable, isFloat, isInteger, toInteger } from "@bootgs/utils";
isInteger(42); // true
isInteger(42.5); // false
@@ -73,7 +73,7 @@ que servent `isCountable` et `requireCountable`.
Changement de casse :
```typescript
-import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "apps-script-utils";
+import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "@bootgs/utils";
toCamelCase("user name"); // "userName"
toKebabCase("User Name"); // "user-name"
@@ -84,7 +84,7 @@ toProperCase("user name"); // "User Name"
Validation :
```typescript
-import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "apps-script-utils";
+import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "@bootgs/utils";
isEmail("ada@example.com"); // true
isValidSlug("my-post"); // true
@@ -96,7 +96,7 @@ requireValidEmail(formResponse); // renvoie la valeur, ou lève InvalidEmailForm
Comparaison de versions, pour les scripts qui conditionnent un comportement à une version de bibliothèque :
```typescript
-import { versionCompare, isVersionCompatible } from "apps-script-utils";
+import { versionCompare, isVersionCompatible } from "@bootgs/utils";
versionCompare("1.10.0", "1.9.0"); // 1
versionCompare("1.9.0", "1.10.0"); // -1
@@ -107,7 +107,7 @@ versionCompare("1.9.0", "1.9.0"); // 0
terme de recherche vient d'une cellule ou d'un formulaire :
```typescript
-import { escapeRegExp } from "apps-script-utils";
+import { escapeRegExp } from "@bootgs/utils";
const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
```
@@ -115,7 +115,7 @@ const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
## Objets
```typescript
-import { hashCode, objectToString } from "apps-script-utils";
+import { hashCode, objectToString } from "@bootgs/utils";
objectToString([]); // "[object Array]"
objectToString(null); // "[object Null]"
diff --git a/docs/content/fr/topics/module-net.md b/docs/content/fr/topics/module-net.md
index 7661f8ac..2d230b5d 100644
--- a/docs/content/fr/topics/module-net.md
+++ b/docs/content/fr/topics/module-net.md
@@ -2,7 +2,7 @@
Aides pour les URL, les chemins et les domaines.
-Le module net d'apps-script-utils : validation d'URL, analyse, assemblage et normalisation de chemins, contrôles de domaine — le tout utilisable dans Google Apps Script.
+Le module net d'@bootgs/utils : validation d'URL, analyse, assemblage et normalisation de chemins, contrôles de domaine — le tout utilisable dans Google Apps Script.
`net` couvre les chemins, les URL et ce qui gravite autour. Comme `lang`, il ne dépend pas de l'environnement Apps
Script.
@@ -21,7 +21,7 @@ d'Apps Script — voir [](module-appsscript.md).
## Chemins
```typescript
-import { join, normalize, parse, isAbsolute, isRelative } from "apps-script-utils";
+import { join, normalize, parse, isAbsolute, isRelative } from "@bootgs/utils";
join("/a", "b", "../c"); // "/a/c"
normalize("/a/b/../c"); // "/a/c"
@@ -40,7 +40,7 @@ fichiers dessous.
## Domaines et URL
```typescript
-import { isValidDomain, isUrl } from "apps-script-utils";
+import { isValidDomain, isUrl } from "@bootgs/utils";
isValidDomain("example.com"); // true
isValidDomain("not a domain"); // false
diff --git a/docs/content/fr/topics/overview.md b/docs/content/fr/topics/overview.md
index d8667658..f805dfec 100644
--- a/docs/content/fr/topics/overview.md
+++ b/docs/content/fr/topics/overview.md
@@ -1,14 +1,14 @@
# Présentation
-Ce qu'est apps-script-utils, ce que la bibliothèque couvre et comment cette documentation est organisée.
+Ce qu'est @bootgs/utils, ce que la bibliothèque couvre et comment cette documentation est organisée.
-apps-script-utils est une bibliothèque TypeScript pour Google Apps Script : aides aux feuilles de calcul et à la notation A1, validation isX/nonX/requireX et exceptions typées.
+@bootgs/utils est une bibliothèque TypeScript pour Google Apps Script : aides aux feuilles de calcul et à la notation A1, validation isX/nonX/requireX et exceptions typées.

_Artiste : [Daryna Mikhailenko](https://darynamikhailenko.com/?utm_source=docs&utm_medium=overview&utm_campaign=apps-script-utils&utm_content=banner-artist-credit)_
-**apps-script-utils** est une bibliothèque TypeScript conçue spécifiquement pour **Google Apps Script**. Elle
+**@bootgs/utils** est une bibliothèque TypeScript conçue spécifiquement pour **Google Apps Script**. Elle
rassemble dans un seul paquet testé ce que tout projet GAS finit par écrire à la main : manipulation des feuilles et
de la notation A1, validation des types et des valeurs (`isX`/`nonX`/`requireX`), transformations de chaînes et de
tableaux, exceptions typées, et le reste.
diff --git a/docs/content/fr/topics/reference-abstracts.md b/docs/content/fr/topics/reference-abstracts.md
index dcc2f891..50918721 100644
--- a/docs/content/fr/topics/reference-abstracts.md
+++ b/docs/content/fr/topics/reference-abstracts.md
@@ -2,7 +2,7 @@
Les classes de base abstraites sur lesquelles repose la bibliothèque.
-Référence des classes de base abstraites d'apps-script-utils et de ce pour quoi on les étend.
+Référence des classes de base abstraites d'@bootgs/utils et de ce pour quoi on les étend.
Classes abstraites et interfaces communes, que les autres modules de la bibliothèque utilisent comme briques.
diff --git a/docs/content/fr/topics/reference-appsscript.md b/docs/content/fr/topics/reference-appsscript.md
index 45d542ac..add693d8 100644
--- a/docs/content/fr/topics/reference-appsscript.md
+++ b/docs/content/fr/topics/reference-appsscript.md
@@ -2,7 +2,7 @@
Toutes les fonctions Google Apps Script de la bibliothèque, groupées par service.
-Référence de toutes les fonctions Google Apps Script d'apps-script-utils : feuilles de calcul, notation A1, interface, Drive, Slides et Admin SDK, avec les types de retour.
+Référence de toutes les fonctions Google Apps Script d'@bootgs/utils : feuilles de calcul, notation A1, interface, Drive, Slides et Admin SDK, avec les types de retour.
Des fonctions liées à des services Google Apps Script précis : Sheets, Slides, Admin SDK, Drive, Docs, Forms,
requêtes réseau et classes d'interface intégrées.
@@ -28,11 +28,11 @@ Aides pour le [service Admin SDK Directory](https://developers.google.cn/apps-sc
## Méthodes Google Docs {id="google-docs-methods"}
-Aides pour Google Docs. Pas encore implémentées. Les contributions sont bienvenues — voir [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Aides pour Google Docs. Pas encore implémentées. Les contributions sont bienvenues — voir [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Méthodes Google Forms {id="google-forms-methods"}
-Aides pour Google Forms. Pas encore implémentées. Les contributions sont bienvenues — voir [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Aides pour Google Forms. Pas encore implémentées. Les contributions sont bienvenues — voir [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Méthodes Google Sheets {id="google-sheets-methods"}
diff --git a/docs/content/fr/topics/reference-base.md b/docs/content/fr/topics/reference-base.md
index b982a64c..396e46ec 100644
--- a/docs/content/fr/topics/reference-base.md
+++ b/docs/content/fr/topics/reference-base.md
@@ -2,7 +2,7 @@
Toutes les fonctions indépendantes de l'environnement : gardes, tableaux, nombres, chaînes, objets, JSON et HTML.
-Référence de toutes les fonctions indépendantes de l'environnement d'apps-script-utils : gardes isX/nonX/requireX, aides pour tableaux, nombres, chaînes, objets, JSON, HTML et temps.
+Référence de toutes les fonctions indépendantes de l'environnement d'@bootgs/utils : gardes isX/nonX/requireX, aides pour tableaux, nombres, chaînes, objets, JSON, HTML et temps.
Des fonctions qui ne dépendent d'aucun framework : vérification des types et des valeurs (`isX`/`nonX`/`requireX`),
manipulation de chaînes, de tableaux et d'objets, JSON et HTML. L'environnement Google Apps Script ne leur est pas
diff --git a/docs/content/fr/topics/reference-exception.md b/docs/content/fr/topics/reference-exception.md
index 151690ef..9256998b 100644
--- a/docs/content/fr/topics/reference-exception.md
+++ b/docs/content/fr/topics/reference-exception.md
@@ -2,7 +2,7 @@
Toutes les classes d'exception que lève la bibliothèque.
-Référence des classes d'exception d'apps-script-utils : ce que signifie chacune et quelles fonctions la lèvent.
+Référence des classes d'exception d'@bootgs/utils : ce que signifie chacune et quelles fonctions la lèvent.
Des classes d'exception typées, utilisées dans toute la bibliothèque. Les exceptions liées à un service (Sheets,
Slides, Admin SDK, réseau) dérivent de la classe de base commune `Exception`, pour une gestion d'erreurs homogène.
diff --git a/docs/content/fr/topics/reference-path.md b/docs/content/fr/topics/reference-path.md
index edbdd38e..c4e55c1c 100644
--- a/docs/content/fr/topics/reference-path.md
+++ b/docs/content/fr/topics/reference-path.md
@@ -2,7 +2,7 @@
Toutes les fonctions pour les chemins et les URL.
-Référence des fonctions de chemin et d'URL d'apps-script-utils : analyse, assemblage, normalisation et validation de chemins et de domaines.
+Référence des fonctions de chemin et d'URL d'@bootgs/utils : analyse, assemblage, normalisation et validation de chemins et de domaines.
Fonctions pour travailler avec des chemins de fichiers et des URL.
diff --git a/docs/content/fr/topics/validation-conventions.md b/docs/content/fr/topics/validation-conventions.md
index 5cd015eb..d4253ca2 100644
--- a/docs/content/fr/topics/validation-conventions.md
+++ b/docs/content/fr/topics/validation-conventions.md
@@ -2,7 +2,7 @@
Le schéma de noms isX / nonX / requireX / requireNonX et ce que garantit chaque préfixe.
-Le schéma de nommage des validations dans apps-script-utils : isX et nonX répondent à une question, requireX et requireNonX valident et renvoient la valeur — chaque préfixe a sa signature.
+Le schéma de nommage des validations dans @bootgs/utils : isX et nonX répondent à une question, requireX et requireNonX valident et renvoient la valeur — chaque préfixe a sa signature.
L'essentiel de cette bibliothèque est fait de validations, et presque toutes suivent un seul schéma de noms.
Apprenez les quatre préfixes une fois, et le nom d'une fonction vous dira sa signature, sa valeur de retour et si
@@ -26,7 +26,7 @@ Les gardes `isX` sont déclarés comme prédicats de type TypeScript : le compil
branche.
```typescript
-import { isString } from "apps-script-utils";
+import { isString } from "@bootgs/utils";
function describe(value: unknown): string {
if (isString(value)) {
@@ -40,7 +40,7 @@ function describe(value: unknown): string {
`nonX` restreint dans l'autre sens — il retire `X` du type plutôt que de le confirmer :
```typescript
-import { nonString } from "apps-script-utils";
+import { nonString } from "@bootgs/utils";
function lengthOf(value: string | number): number {
if (nonString(value)) {
@@ -60,7 +60,7 @@ comme une phrase et non comme une négation — ce qui compte là où l'alternat
`requireX` valide et renvoie : l'appel s'insère dans une expression au lieu d'exiger une instruction séparée.
```typescript
-import { requireNumber, requireString } from "apps-script-utils";
+import { requireNumber, requireString } from "@bootgs/utils";
function repeat(text: unknown, times: unknown): string {
return requireString(text).repeat(requireNumber(times));
@@ -107,7 +107,7 @@ Trois noms couvrent les cas vides, et la distinction est exacte :
lève `NullPointerException`.
```typescript
-import { requireNonNull } from "apps-script-utils";
+import { requireNonNull } from "@bootgs/utils";
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"), "sheet 'Data' is missing");
```
diff --git a/docs/content/ru/topics/apps-script-runtime.md b/docs/content/ru/topics/apps-script-runtime.md
index 9dd21368..22d56787 100644
--- a/docs/content/ru/topics/apps-script-runtime.md
+++ b/docs/content/ru/topics/apps-script-runtime.md
@@ -2,7 +2,7 @@
Каким функциям нужна среда Apps Script, а какие работают где угодно.
-Какие части apps-script-utils зависят от сервисов Google Apps Script, а какие работают в Node.js и в тестах, и что это значит для тестирования вашего кода.
+Какие части @bootgs/utils зависят от сервисов Google Apps Script, а какие работают в Node.js и в тестах, и что это значит для тестирования вашего кода.
Библиотека одна, но её функции работают не в одних и тех же местах. От того, по какую сторону черты стоит функция,
зависит, получится ли покрыть её модульным тестом и стоит ли она обращения к сервису.
@@ -17,19 +17,79 @@
**Привязанные к сервисам** функции сами обращаются к глобальному сервису. Они работают только внутри скрипта с
выданными правами и в Node не работают вовсе. Сегодня это весь список:
-| Функция | К какому глобальному объекту обращается |
-| :---------------------- | :--------------------------------------------------------------- |
-| `isAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` |
-| `checkMultipleAccount` | `Session.getEffectiveUser` |
-| `getSheetById` | `SpreadsheetApp.getActiveSpreadsheet`, если таблица не передана |
-| `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, если таблица не передана |
-| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` |
-| `convertRichTextToHtml` | `Utilities.formatString` |
+| Функция | К какому глобальному объекту обращается | Какая область доступа нужна |
+| :------------------------------------ | :--------------------------------------------------------------- | :------------------------------------------------ |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` | `userinfo.email`, `admin.directory.user.readonly` |
+| `checkMultipleAccount` | `Session.getEffectiveUser` | `userinfo.email` |
+| `getSheetById`, `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, если таблица не передана | `spreadsheets.currentonly` |
+| `getSlideByIndex`, `getSlideIndex` | `SlidesApp.getActivePresentation`, если презентация не передана | `presentations.currentonly` |
+| `createFolder` | `DriveApp.getRootFolder`, если родительская папка не передана | `drive` |
+| `getTriggerById` | `ScriptApp.getProjectTriggers` | `script.scriptapp` |
+| `appendRows`, `prependRows` | `LockService.getDocumentLock` | для блокировки не нужна |
+| `appendRow`, `prependRow` | `LockService.getDocumentLock`, через две функции выше | для блокировки не нужна |
+| `appendColumns`, `prependColumns` | `LockService.getDocumentLock` | для блокировки не нужна |
+| `appendColumn`, `prependColumn` | `LockService.getDocumentLock`, через две функции выше | для блокировки не нужна |
+| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` | для конструкторов не нужна |
+| `insertSchema` | `SpreadsheetApp.newDataValidation` | для конструктора не нужна |
+| `deleteRowsByConditional` | `SpreadsheetApp.Dimension` | для перечисления не нужна |
+| `deleteColumnsByConditional` | `SpreadsheetApp.Dimension` | для перечисления не нужна |
+| `convertRichTextToHtml` | `Utilities.formatString` | не нужна |
+| `retry` | `Utilities.sleep`, если он есть | не нужна |
+
+Области доступа записаны без префикса `https://www.googleapis.com/auth/`. «Не нужна» значит, что самому глобальному
+объекту авторизация не требуется; листу, диапазону или папке, которые функция получает, всё равно нужна область
+доступа того сервиса, из которого они взяты, — об этом следующий раздел.
Всё остальное в `appsscript` принимает объект сервиса аргументом: `appendRows` пишет в тот `Sheet`, который вы ему
дали, а `requireSheet` разглядывает переданное значение, а не добывает его сам. Таким функциям живой объект сервиса
нужен, чтобы принести пользу, но искать его они не идут — именно это и позволяет подменить их в тесте.
+## Области доступа OAuth
+
+Apps Script решает, какие области доступа запросить, просматривая код всего проекта, включая библиотеку. Поэтому
+проект, в который библиотека встроена целиком, может запросить у пользователя больше, чем реально использует.
+Перечислите области доступа в `appsscript.json` сами: как только там есть `oauthScopes`, Apps Script запрашивает
+ровно их и ничего больше.
+
+| Что вызывает ваш код | Самая узкая область | Более широкая альтернатива |
+| :----------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------ | :------------------------------------------ |
+| Любая функция, принимающая `Sheet`, `Range`, `Spreadsheet` или `RichTextValue` из привязанной таблицы | `spreadsheets.currentonly` | `spreadsheets` — для таблиц, открытых по ID |
+| `getSheetById`, `getSheetByIndex` без таблицы | `spreadsheets.currentonly` | `spreadsheets` |
+| Любая функция, принимающая `Slide` или `Presentation`, а также `getSlideByIndex`, `getSlideIndex` без презентации | `presentations.currentonly` | `presentations` |
+| `createFolder` | `drive` | — |
+| `getTriggerById` | `script.scriptapp` | — |
+| `checkMultipleAccount` | `userinfo.email` | — |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `userinfo.email`, `admin.directory.user.readonly` | `admin.directory.user` |
+| Всё в `lang`, `net`, `json`, `html`, `time` и `exception`, а также помощники для нотации A1, букв столбцов и `GridRange` | не нужна | — |
+
+Скрипту, привязанному к таблице и работающему только с ней, больше ничего не нужно:
+
+```json
+{
+ "timeZone": "Etc/UTC",
+ "runtimeVersion": "V8",
+ "oauthScopes": ["https://www.googleapis.com/auth/spreadsheets.currentonly"]
+}
+```
+
+Что важно знать, прежде чем сужать:
+
+- **`*.currentonly`** покрывает только документ, к которому привязан скрипт, или тот, в котором работает дополнение.
+ Скрипту, который открывает другие таблицы или презентации по ID или URL, нужны `spreadsheets` или `presentations`.
+- **`createFolder`** сначала ищет существующие папки по имени и только потом создаёт новую. С `drive.file` скрипт
+ видит лишь файлы и папки, которые создал сам или которые пользователь открыл через него, поэтому поиск не находит
+ папки, созданные кем-то другим, и появляются дубликаты. Используйте `drive.file`, только если всё дерево создаёт
+ сам скрипт; иначе — `drive`.
+- **Функциям Admin SDK** также нужен включённый в проекте расширенный сервис Admin SDK Directory
+ (`dependencies.enabledAdvancedServices`, `serviceId` `admin`, `version` `directory_v1`) и пользователь, которому
+ разрешено читать каталог. Области только для чтения `admin.directory.user.readonly` достаточно: `isAdmin` лишь
+ читает пользователя.
+- **Нехватка области доступа** проявляется во время выполнения — ошибкой авторизации при вызове сервиса, а не при
+ сохранении проекта. После изменения `oauthScopes` прогоните каждую ветку кода хотя бы раз.
+
+Какая область нужна каждому методу, указано в разделе «Authorization» его страницы в
+[справочнике Apps Script](https://developers.google.com/apps-script/reference).
+
## Пакетность на границе
Каждое обращение к сервису — это поход туда и обратно, и Apps Script засчитывает его в лимит времени выполнения.
@@ -49,7 +109,7 @@ for (const row of rows) {
То же рассуждение верно и для проверок. Проверяйте форму данных до того, как они дойдут до сервиса, а не после:
```typescript
-import { IllegalArgumentException, appendRows, isConsistent2DArray } from "apps-script-utils";
+import { IllegalArgumentException, appendRows, isConsistent2DArray } from "@bootgs/utils";
if (!isConsistent2DArray(rows)) {
throw new IllegalArgumentException("every row must have the same number of columns");
diff --git a/docs/content/ru/topics/ecosystem.md b/docs/content/ru/topics/ecosystem.md
index 2bf74eeb..1f7770c1 100644
--- a/docs/content/ru/topics/ecosystem.md
+++ b/docs/content/ru/topics/ecosystem.md
@@ -2,7 +2,7 @@
Фреймворк boot.gs, который построен на этой библиотеке, и Agent Skills, которые учат ИИ-агентов ею пользоваться.
-Как apps-script-utils связан с фреймворком boot.gs для Google Apps Script и с Agent Skills, которые учат Claude Code, Gemini CLI и Cursor работать с обоими.
+Как @bootgs/utils связан с фреймворком boot.gs для Google Apps Script и с Agent Skills, которые учат Claude Code, Gemini CLI и Cursor работать с обоими.
Библиотека полезна и сама по себе: установили, импортировали функцию — готово. При этом она часть небольшой
экосистемы для разработки на Google Apps Script, и двух соседей стоит знать.
@@ -29,7 +29,7 @@ export class SheetController {
}
```
-**Отношение к этой библиотеке — зависимость, а не соперничество.** `bootgs` перечисляет `apps-script-utils` среди
+**Отношение к этой библиотеке — зависимость, а не соперничество.** `bootgs` перечисляет `@bootgs/utils` среди
своих зависимостей, поэтому в проекте на boot.gs уже есть каждая функция, описанная здесь, — доустанавливать ничего
не нужно. Из этих проверок и собраны его валидация параметров и поиск сервисов.
@@ -37,7 +37,7 @@ export class SheetController {
| Что нужно | Что брать |
| :------------------------------------------------------------------------------- | :------------------------------ |
-| Помощники в уже написанный скрипт — несколько функций, без новой архитектуры | `apps-script-utils` сам по себе |
+| Помощники в уже написанный скрипт — несколько функций, без новой архитектуры | `@bootgs/utils` сам по себе |
| Маршрутизация, контроллеры, внедрение зависимостей, веб-приложение с эндпоинтами | `bootgs`, библиотека уже внутри |
## Agent Skills — научить ИИ-агента этой библиотеке
@@ -50,7 +50,7 @@ export class SheetController {
| Скилл | Покрывает |
| :------------------------------ | :------------------------------------------------------------------------------------------------- |
-| `apps-script-utils` | эту библиотеку: соглашение `isX`/`nonX`/`requireX`, проверки, помощники |
+| `@bootgs/utils` | эту библиотеку: соглашение `isX`/`nonX`/`requireX`, проверки, помощники |
| `apps-script-triggers` | простые и устанавливаемые триггеры, форму событий, квоты |
| `apps-script-services` | безопасную по квотам работу с `SpreadsheetApp`, `PropertiesService`, `CacheService`, `LockService` |
| `apps-script-ui` | меню, боковые панели, диалоги и подводные камни `google.script.run` |
diff --git a/docs/content/ru/topics/exception-handling.md b/docs/content/ru/topics/exception-handling.md
index 8e97d8d5..32443265 100644
--- a/docs/content/ru/topics/exception-handling.md
+++ b/docs/content/ru/topics/exception-handling.md
@@ -2,7 +2,7 @@
Иерархия исключений, когда бросается каждый класс и как их ловить.
-Типизированные исключения apps-script-utils: иерархия под Exception, какая проверка какой класс бросает и как ловить их в проекте Google Apps Script.
+Типизированные исключения @bootgs/utils: иерархия под Exception, какая проверка какой класс бросает и как ловить их в проекте Google Apps Script.
Любая ошибка, которую поднимает эта библиотека, — экземпляр класса `Exception` или его наследника. Поэтому одного
блока `catch` достаточно, чтобы отличить сбои библиотеки от всего остального, что бросает среда выполнения.
@@ -39,7 +39,7 @@ Error
У `Exception` есть статический страж типа — рекомендуемая проверка, потому что она заодно сужает тип:
```typescript
-import { Exception, requireString } from "apps-script-utils";
+import { Exception, requireString } from "@bootgs/utils";
try {
requireString(input);
@@ -55,7 +55,7 @@ try {
`instanceof` тоже работает — им ловят один конкретный сбой:
```typescript
-import { NullPointerException, requireNonNull } from "apps-script-utils";
+import { NullPointerException, requireNonNull } from "@bootgs/utils";
try {
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"));
diff --git a/docs/content/ru/topics/getting-started.md b/docs/content/ru/topics/getting-started.md
index 4290f93e..c151e753 100644
--- a/docs/content/ru/topics/getting-started.md
+++ b/docs/content/ru/topics/getting-started.md
@@ -2,7 +2,7 @@
Требования, установка и первый рабочий скрипт.
-Установка apps-script-utils в проект Google Apps Script: пакет npm, настройка clasp и первый скрипт, читающий лист с помощью библиотеки.
+Установка @bootgs/utils в проект Google Apps Script: пакет npm, настройка clasp и первый скрипт, читающий лист с помощью библиотеки.
## Требования
@@ -12,13 +12,13 @@
## Установка
```bash
-npm install apps-script-utils
+npm install @bootgs/utils
```
Всё экспортируется из корня пакета, поэтому одного пути импорта достаточно для всей библиотеки:
```typescript
-import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script-utils";
+import { appendRows, isAdmin, parseA1Notation, requireString } from "@bootgs/utils";
```
## Первые примеры
@@ -28,7 +28,7 @@ import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script
Эффективно добавить несколько строк данных:
```typescript
-import { appendRows } from "apps-script-utils";
+import { appendRows } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
@@ -44,7 +44,7 @@ appendRows(sheet, data);
Проверить, есть ли у текущего пользователя права администратора:
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
@@ -58,7 +58,7 @@ if (isAdmin()) {
Превратить сложную нотацию A1 в структурированный объект:
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
@@ -73,7 +73,7 @@ console.log(rangeInfo.endColumnIndex); // 2
превращает непроверенное значение в типизированное — или бросает исключение:
```typescript
-import { requireString, requireNonEmptyString } from "apps-script-utils";
+import { requireString, requireNonEmptyString } from "@bootgs/utils";
function greet(name: unknown): string {
return `Hello, ${requireNonEmptyString(name)}!`;
diff --git a/docs/content/ru/topics/module-appsscript.md b/docs/content/ru/topics/module-appsscript.md
index 5a703828..5d8e5727 100644
--- a/docs/content/ru/topics/module-appsscript.md
+++ b/docs/content/ru/topics/module-appsscript.md
@@ -2,7 +2,7 @@
Помощники для Google Apps Script: таблицы, нотация A1, интерфейс, Диск и Admin SDK.
-Модуль appsscript в apps-script-utils: помощники для таблиц и нотации A1, проверки листов, интерфейс, Диск, Презентации и Admin SDK для Google Apps Script.
+Модуль appsscript в @bootgs/utils: помощники для таблиц и нотации A1, проверки листов, интерфейс, Диск, Презентации и Admin SDK для Google Apps Script.
`appsscript` содержит всё, что касается сервисов Google. Это та часть библиотеки, которая работает только внутри
среды Apps Script, — что это значит для тестов, разобрано в [](apps-script-runtime.md).
@@ -25,7 +25,7 @@
правой границей, как в Sheets API, а не позициями от единицы, которые принимают методы `Range`:
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
parseA1Notation("Sheet1!A1:B10");
// {
@@ -46,7 +46,7 @@ parseA1Notation("B5");
`toA1Notation` — обратная операция:
```typescript
-import { toA1Notation } from "apps-script-utils";
+import { toA1Notation } from "@bootgs/utils";
toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumnIndex: 2 });
// "A1:B10"
@@ -55,7 +55,7 @@ toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumn
`parseA1Notations` принимает список через запятую и возвращает по одному `GridRange` на запись:
```typescript
-import { parseA1Notations } from "apps-script-utils";
+import { parseA1Notations } from "@bootgs/utils";
parseA1Notations("Sheet1!A1:B2, Sheet1!D1"); // два объекта GridRange
```
@@ -67,7 +67,7 @@ import {
extractRangeFromA1Notation,
extractSheetNameFromA1Notation,
updateSheetNameInA1Notation
-} from "apps-script-utils";
+} from "@bootgs/utils";
extractSheetNameFromA1Notation("'My Sheet'!A1"); // "My Sheet"
extractRangeFromA1Notation("'My Sheet'!A1:B2"); // "A1:B2"
@@ -84,7 +84,7 @@ import {
getColumnIndexByLetter,
getColumnLetterByIndex,
getColumnPositionByLetter
-} from "apps-script-utils";
+} from "@bootgs/utils";
getColumnIndexByLetter("A"); // 0
getColumnIndexByLetter("AZ"); // 51
@@ -103,7 +103,7 @@ import {
isCellGridRange,
isGridRangeContainedIn,
isGridRangeSameDimensions
-} from "apps-script-utils";
+} from "@bootgs/utils";
const header = { startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 5 };
const body = { startRowIndex: 1, endRowIndex: 100, startColumnIndex: 0, endColumnIndex: 5 };
@@ -115,7 +115,7 @@ isCellGridRange(header); // false — он занимает пять столб
## Запись строк и столбцов
```typescript
-import { appendRows, prependRows, appendColumns } from "apps-script-utils";
+import { appendRows, prependRows, appendColumns } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
@@ -135,7 +135,7 @@ prependRows(sheet, [["Name", "Email", "Age"]]);
То же соглашение, что и во всей библиотеке, применённое к классам Apps Script:
```typescript
-import { isSheet, isSpreadsheet, isRange, requireSheet } from "apps-script-utils";
+import { isSheet, isSpreadsheet, isRange, requireSheet } from "@bootgs/utils";
function rowCount(value: unknown): number {
return requireSheet(value).getLastRow();
@@ -148,7 +148,7 @@ function rowCount(value: unknown): number {
## Презентации
```typescript
-import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "apps-script-utils";
+import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "@bootgs/utils";
const presentation = SlidesApp.getActivePresentation();
@@ -166,7 +166,7 @@ findReplaceAllTextInSlide(slide, "{{name}}", "Ada Lovelace");
## Admin SDK
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
diff --git a/docs/content/ru/topics/module-exception.md b/docs/content/ru/topics/module-exception.md
index e9120cba..3d16a0b7 100644
--- a/docs/content/ru/topics/module-exception.md
+++ b/docs/content/ru/topics/module-exception.md
@@ -2,7 +2,7 @@
Классы исключений и как их расширять.
-Модуль exception в apps-script-utils: базовый класс Exception, его наследники и как добавить в иерархию собственный класс.
+Модуль exception в @bootgs/utils: базовый класс Exception, его наследники и как добавить в иерархию собственный класс.
`exception` содержит классы ошибок, которые бросает остальная библиотека. Ничто в нём не зависит от среды
выполнения Apps Script.
@@ -24,7 +24,7 @@
работы, наследуйте `RuntimeException`:
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
export class QuotaExceededException extends RuntimeException {}
```
@@ -49,7 +49,7 @@ Object.prototype.toString.call(error); // "[object QuotaExceededException]"
меняется:
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
try {
UrlFetchApp.fetch(endpoint);
diff --git a/docs/content/ru/topics/module-lang.md b/docs/content/ru/topics/module-lang.md
index 60bb441c..fb12b162 100644
--- a/docs/content/ru/topics/module-lang.md
+++ b/docs/content/ru/topics/module-lang.md
@@ -2,7 +2,7 @@
Языковые утилиты, не зависящие от среды: проверки, массивы, числа, объекты, строки.
-Модуль lang в apps-script-utils: проверки типов, помощники для массивов и матриц, классификация чисел, хеширование объектов и преобразование строк — всё независимо от среды выполнения.
+Модуль lang в @bootgs/utils: проверки типов, помощники для массивов и матриц, классификация чисел, хеширование объектов и преобразование строк — всё независимо от среды выполнения.
`lang` — это языковые утилиты, та часть библиотеки, которая ничего не знает про Google Apps Script и работает везде,
где работает JavaScript.
@@ -26,7 +26,7 @@
[](validation-conventions.md); если коротко: `isX` и `nonX` отвечают на вопрос, а `requireX` проверяет и возвращает.
```typescript
-import { requireString, toKebabCase } from "apps-script-utils";
+import { requireString, toKebabCase } from "@bootgs/utils";
function slugify(input: unknown): string {
return toKebabCase(requireString(input));
@@ -36,7 +36,7 @@ function slugify(input: unknown): string {
## Массивы
```typescript
-import { chunk, transpose, is2DArray, isConsistent2DArray } from "apps-script-utils";
+import { chunk, transpose, is2DArray, isConsistent2DArray } from "@bootgs/utils";
chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
@@ -56,7 +56,7 @@ isConsistent2DArray([[1, 2], [3]]); // false — строки разной дл
## Числа
```typescript
-import { isCountable, isFloat, isInteger, toInteger } from "apps-script-utils";
+import { isCountable, isFloat, isInteger, toInteger } from "@bootgs/utils";
isInteger(42); // true
isInteger(42.5); // false
@@ -73,7 +73,7 @@ isCountable(-1); // false
Смена регистра:
```typescript
-import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "apps-script-utils";
+import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "@bootgs/utils";
toCamelCase("user name"); // "userName"
toKebabCase("User Name"); // "user-name"
@@ -84,7 +84,7 @@ toProperCase("user name"); // "User Name"
Проверки:
```typescript
-import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "apps-script-utils";
+import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "@bootgs/utils";
isEmail("ada@example.com"); // true
isValidSlug("my-post"); // true
@@ -96,7 +96,7 @@ requireValidEmail(formResponse); // вернёт значение или бро
Сравнение версий — для скриптов, которые включают поведение в зависимости от версии библиотеки:
```typescript
-import { versionCompare, isVersionCompatible } from "apps-script-utils";
+import { versionCompare, isVersionCompatible } from "@bootgs/utils";
versionCompare("1.10.0", "1.9.0"); // 1
versionCompare("1.9.0", "1.10.0"); // -1
@@ -107,7 +107,7 @@ versionCompare("1.9.0", "1.9.0"); // 0
поисковый запрос приходит из ячейки или формы:
```typescript
-import { escapeRegExp } from "apps-script-utils";
+import { escapeRegExp } from "@bootgs/utils";
const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
```
@@ -115,7 +115,7 @@ const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
## Объекты
```typescript
-import { hashCode, objectToString } from "apps-script-utils";
+import { hashCode, objectToString } from "@bootgs/utils";
objectToString([]); // "[object Array]"
objectToString(null); // "[object Null]"
diff --git a/docs/content/ru/topics/module-net.md b/docs/content/ru/topics/module-net.md
index 511d1502..fadc0e07 100644
--- a/docs/content/ru/topics/module-net.md
+++ b/docs/content/ru/topics/module-net.md
@@ -2,7 +2,7 @@
Помощники для URL, путей и доменов.
-Модуль net в apps-script-utils: проверка URL, разбор, склеивание и нормализация путей, проверка доменов — всё это работает и внутри Google Apps Script.
+Модуль net в @bootgs/utils: проверка URL, разбор, склеивание и нормализация путей, проверка доменов — всё это работает и внутри Google Apps Script.
`net` — это пути, URL и всё, что вокруг них. Как и `lang`, он не зависит от среды выполнения Apps Script.
@@ -20,7 +20,7 @@ Script — смотрите [](module-appsscript.md).
## Пути
```typescript
-import { join, normalize, parse, isAbsolute, isRelative } from "apps-script-utils";
+import { join, normalize, parse, isAbsolute, isRelative } from "@bootgs/utils";
join("/a", "b", "../c"); // "/a/c"
normalize("/a/b/../c"); // "/a/c"
@@ -38,7 +38,7 @@ isRelative("a/b"); // true
## Домены и URL
```typescript
-import { isValidDomain, isUrl } from "apps-script-utils";
+import { isValidDomain, isUrl } from "@bootgs/utils";
isValidDomain("example.com"); // true
isValidDomain("not a domain"); // false
diff --git a/docs/content/ru/topics/overview.md b/docs/content/ru/topics/overview.md
index 27a31ff6..8bd53518 100644
--- a/docs/content/ru/topics/overview.md
+++ b/docs/content/ru/topics/overview.md
@@ -1,14 +1,14 @@
# Обзор
-Что такое apps-script-utils, что входит в библиотеку и как устроена эта документация.
+Что такое @bootgs/utils, что входит в библиотеку и как устроена эта документация.
-apps-script-utils — библиотека утилит на TypeScript для Google Apps Script: работа с таблицами и нотацией A1, проверки isX/nonX/requireX, типизированные исключения.
+@bootgs/utils — библиотека утилит на TypeScript для Google Apps Script: работа с таблицами и нотацией A1, проверки isX/nonX/requireX, типизированные исключения.

_Художник: [Дарина Михайленко](https://darynamikhailenko.com/?utm_source=docs&utm_medium=overview&utm_campaign=apps-script-utils&utm_content=banner-artist-credit)_
-**apps-script-utils** — библиотека утилит на TypeScript, созданная специально для **Google Apps Script**. Она
+**@bootgs/utils** — библиотека утилит на TypeScript, созданная специально для **Google Apps Script**. Она
собирает в одном протестированном пакете то, что в каждом проекте на GAS всё равно приходится писать руками:
работу с таблицами и нотацией A1, проверку типов и значений (`isX`/`nonX`/`requireX`), преобразования строк и
массивов, типизированные исключения и многое другое.
diff --git a/docs/content/ru/topics/reference-abstracts.md b/docs/content/ru/topics/reference-abstracts.md
index d853a456..bfbd6de2 100644
--- a/docs/content/ru/topics/reference-abstracts.md
+++ b/docs/content/ru/topics/reference-abstracts.md
@@ -2,7 +2,7 @@
Абстрактные базовые классы, на которых построена библиотека.
-Справочник абстрактных базовых классов apps-script-utils и того, ради чего их наследуют.
+Справочник абстрактных базовых классов @bootgs/utils и того, ради чего их наследуют.
Общие абстрактные классы и интерфейсы, которые остальные модули библиотеки используют как строительные блоки.
diff --git a/docs/content/ru/topics/reference-appsscript.md b/docs/content/ru/topics/reference-appsscript.md
index e9758360..39e1104a 100644
--- a/docs/content/ru/topics/reference-appsscript.md
+++ b/docs/content/ru/topics/reference-appsscript.md
@@ -2,7 +2,7 @@
Все функции библиотеки, привязанные к Google Apps Script, по сервисам.
-Справочник функций apps-script-utils для Google Apps Script: таблицы, нотация A1, интерфейс, Диск, Презентации и Admin SDK — с типами возвращаемых значений.
+Справочник функций @bootgs/utils для Google Apps Script: таблицы, нотация A1, интерфейс, Диск, Презентации и Admin SDK — с типами возвращаемых значений.
Функции, привязанные к конкретным сервисам Google Apps Script: Таблицы, Презентации, Admin SDK, Диск, Документы,
Формы, сетевые запросы и встроенные классы интерфейса.
@@ -28,11 +28,11 @@
## Методы Google Документов {id="google-docs-methods"}
-Помощники для Google Документов. Пока не реализованы. Будем рады вкладу — смотрите [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Помощники для Google Документов. Пока не реализованы. Будем рады вкладу — смотрите [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Методы Google Форм {id="google-forms-methods"}
-Помощники для Google Форм. Пока не реализованы. Будем рады вкладу — смотрите [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Помощники для Google Форм. Пока не реализованы. Будем рады вкладу — смотрите [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Методы Google Таблиц {id="google-sheets-methods"}
diff --git a/docs/content/ru/topics/reference-base.md b/docs/content/ru/topics/reference-base.md
index bf7f1103..cf701df2 100644
--- a/docs/content/ru/topics/reference-base.md
+++ b/docs/content/ru/topics/reference-base.md
@@ -2,7 +2,7 @@
Все функции, не зависящие от среды выполнения: проверки, массивы, числа, строки, объекты, JSON и HTML.
-Справочник всех независимых от среды функций apps-script-utils: проверки isX/nonX/requireX, работа с массивами, числами, строками, объектами, JSON, HTML и временем.
+Справочник всех независимых от среды функций @bootgs/utils: проверки isX/nonX/requireX, работа с массивами, числами, строками, объектами, JSON, HTML и временем.
Функции, не привязанные к какому-либо фреймворку: проверка типов и значений (`isX`/`nonX`/`requireX`), работа со
строками, массивами и объектами, JSON и HTML. Среда выполнения Google Apps Script им не нужна.
diff --git a/docs/content/ru/topics/reference-exception.md b/docs/content/ru/topics/reference-exception.md
index c6c9b128..fc6fbecc 100644
--- a/docs/content/ru/topics/reference-exception.md
+++ b/docs/content/ru/topics/reference-exception.md
@@ -2,7 +2,7 @@
Все классы исключений, которые бросает библиотека.
-Справочник классов исключений apps-script-utils: что означает каждый и какие функции его бросают.
+Справочник классов исключений @bootgs/utils: что означает каждый и какие функции его бросают.
Типизированные классы исключений, используемые по всей библиотеке. Исключения, привязанные к сервисам (Таблицы,
Презентации, Admin SDK, сеть), наследуют общий базовый класс `Exception` — ради единообразной обработки ошибок.
diff --git a/docs/content/ru/topics/reference-path.md b/docs/content/ru/topics/reference-path.md
index e99d87b3..b58e1d12 100644
--- a/docs/content/ru/topics/reference-path.md
+++ b/docs/content/ru/topics/reference-path.md
@@ -2,7 +2,7 @@
Все функции для путей и URL.
-Справочник функций apps-script-utils для путей и URL: разбор, склеивание, нормализация и проверка путей и доменов.
+Справочник функций @bootgs/utils для путей и URL: разбор, склеивание, нормализация и проверка путей и доменов.
Функции для работы с путями к файлам и URL-адресами.
diff --git a/docs/content/ru/topics/validation-conventions.md b/docs/content/ru/topics/validation-conventions.md
index 2c65365c..70eb6743 100644
--- a/docs/content/ru/topics/validation-conventions.md
+++ b/docs/content/ru/topics/validation-conventions.md
@@ -2,7 +2,7 @@
Схема имён isX / nonX / requireX / requireNonX и что гарантирует каждый префикс.
-Схема именования проверок в apps-script-utils: isX и nonX отвечают на вопрос, requireX и requireNonX проверяют и возвращают значение; у каждого префикса своя сигнатура.
+Схема именования проверок в @bootgs/utils: isX и nonX отвечают на вопрос, requireX и requireNonX проверяют и возвращают значение; у каждого префикса своя сигнатура.
Большая часть библиотеки — это проверки, и почти все они подчиняются одной схеме имён. Выучите четыре префикса один
раз, и имя функции само расскажет её сигнатуру, возвращаемое значение и то, может ли она бросить исключение.
@@ -25,7 +25,7 @@
Стражи `isX` объявлены как type predicates в TypeScript, поэтому внутри ветки компилятор сужает тип значения:
```typescript
-import { isString } from "apps-script-utils";
+import { isString } from "@bootgs/utils";
function describe(value: unknown): string {
if (isString(value)) {
@@ -39,7 +39,7 @@ function describe(value: unknown): string {
`nonX` сужает в обратную сторону — он убирает `X` из типа, а не подтверждает его:
```typescript
-import { nonString } from "apps-script-utils";
+import { nonString } from "@bootgs/utils";
function lengthOf(value: string | number): number {
if (nonString(value)) {
@@ -59,7 +59,7 @@ function lengthOf(value: string | number): number {
`requireX` проверяет и возвращает, поэтому вызов встраивается в выражение, а не требует отдельного оператора:
```typescript
-import { requireNumber, requireString } from "apps-script-utils";
+import { requireNumber, requireString } from "@bootgs/utils";
function repeat(text: unknown, times: unknown): string {
return requireString(text).repeat(requireNumber(times));
@@ -106,7 +106,7 @@ _использовать_ значение как этот тип:
`NullPointerException`:
```typescript
-import { requireNonNull } from "apps-script-utils";
+import { requireNonNull } from "@bootgs/utils";
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"), "sheet 'Data' is missing");
```
diff --git a/docs/content/uk/topics/apps-script-runtime.md b/docs/content/uk/topics/apps-script-runtime.md
index 68d092b6..1cba9cc5 100644
--- a/docs/content/uk/topics/apps-script-runtime.md
+++ b/docs/content/uk/topics/apps-script-runtime.md
@@ -2,7 +2,7 @@
Яким функціям потрібне середовище Apps Script, а які працюють будь-де.
-Які частини apps-script-utils залежать від сервісів Google Apps Script, а які працюють у Node.js і в тестах, і що це означає для тестування вашого коду.
+Які частини @bootgs/utils залежать від сервісів Google Apps Script, а які працюють у Node.js і в тестах, і що це означає для тестування вашого коду.
Бібліотека одна, але її функції працюють не в тих самих місцях. Від того, по який бік межі стоїть функція,
залежить, чи вдасться покрити її модульним тестом і чи коштує вона звернення до сервісу.
@@ -17,19 +17,79 @@
**Прив'язані до сервісів** функції самі звертаються до глобального сервісу. Вони працюють лише всередині скрипта з
виданими правами і в Node не працюють зовсім. Сьогодні це весь список:
-| Функція | До якого глобального об'єкта звертається |
-| :---------------------- | :--------------------------------------------------------------- |
-| `isAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` |
-| `checkMultipleAccount` | `Session.getEffectiveUser` |
-| `getSheetById` | `SpreadsheetApp.getActiveSpreadsheet`, якщо таблицю не передано |
-| `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, якщо таблицю не передано |
-| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` |
-| `convertRichTextToHtml` | `Utilities.formatString` |
+| Функція | До якого глобального об'єкта звертається | Яка область доступу потрібна |
+| :------------------------------------ | :--------------------------------------------------------------- | :------------------------------------------------ |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` | `userinfo.email`, `admin.directory.user.readonly` |
+| `checkMultipleAccount` | `Session.getEffectiveUser` | `userinfo.email` |
+| `getSheetById`, `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, якщо таблицю не передано | `spreadsheets.currentonly` |
+| `getSlideByIndex`, `getSlideIndex` | `SlidesApp.getActivePresentation`, якщо презентацію не передано | `presentations.currentonly` |
+| `createFolder` | `DriveApp.getRootFolder`, якщо батьківську папку не передано | `drive` |
+| `getTriggerById` | `ScriptApp.getProjectTriggers` | `script.scriptapp` |
+| `appendRows`, `prependRows` | `LockService.getDocumentLock` | для блокування не потрібна |
+| `appendRow`, `prependRow` | `LockService.getDocumentLock`, через дві функції вище | для блокування не потрібна |
+| `appendColumns`, `prependColumns` | `LockService.getDocumentLock` | для блокування не потрібна |
+| `appendColumn`, `prependColumn` | `LockService.getDocumentLock`, через дві функції вище | для блокування не потрібна |
+| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` | для конструкторів не потрібна |
+| `insertSchema` | `SpreadsheetApp.newDataValidation` | для конструктора не потрібна |
+| `deleteRowsByConditional` | `SpreadsheetApp.Dimension` | для переліку не потрібна |
+| `deleteColumnsByConditional` | `SpreadsheetApp.Dimension` | для переліку не потрібна |
+| `convertRichTextToHtml` | `Utilities.formatString` | не потрібна |
+| `retry` | `Utilities.sleep`, якщо він є | не потрібна |
+
+Області доступу записано без префікса `https://www.googleapis.com/auth/`. «Не потрібна» означає, що самому
+глобальному об'єкту авторизація не потрібна; аркуш, діапазон чи папка, які функція отримує, однаково потребують
+області доступу того сервісу, з якого їх узято, — про це наступний розділ.
Усе інше в `appsscript` приймає об'єкт сервісу аргументом: `appendRows` пише в той `Sheet`, який ви йому дали, а
`requireSheet` розглядає передане значення, а не здобуває його сам. Таким функціям живий об'єкт сервісу потрібен,
щоб принести користь, але шукати його вони не йдуть — саме це й дозволяє підмінити їх у тесті.
+## Області доступу OAuth
+
+Apps Script вирішує, які області доступу запитати, переглядаючи код усього проєкту, разом із бібліотекою. Тому
+проєкт, у який бібліотеку вбудовано цілком, може запитати в користувача більше, ніж справді використовує.
+Перелічіть області доступу в `appsscript.json` самі: щойно там є `oauthScopes`, Apps Script запитує саме їх і нічого
+більше.
+
+| Що викликає ваш код | Найвужча область | Ширша альтернатива |
+| :------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------ | :-------------------------------------------- |
+| Будь-яка функція, що приймає `Sheet`, `Range`, `Spreadsheet` або `RichTextValue` з прив'язаної таблиці | `spreadsheets.currentonly` | `spreadsheets` — для таблиць, відкритих за ID |
+| `getSheetById`, `getSheetByIndex` без таблиці | `spreadsheets.currentonly` | `spreadsheets` |
+| Будь-яка функція, що приймає `Slide` або `Presentation`, а також `getSlideByIndex`, `getSlideIndex` без презентації | `presentations.currentonly` | `presentations` |
+| `createFolder` | `drive` | — |
+| `getTriggerById` | `script.scriptapp` | — |
+| `checkMultipleAccount` | `userinfo.email` | — |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `userinfo.email`, `admin.directory.user.readonly` | `admin.directory.user` |
+| Усе в `lang`, `net`, `json`, `html`, `time` і `exception`, а також помічники для нотації A1, літер стовпців і `GridRange` | не потрібна | — |
+
+Скрипту, прив'язаному до таблиці, що працює лише з нею, більше нічого не потрібно:
+
+```json
+{
+ "timeZone": "Etc/UTC",
+ "runtimeVersion": "V8",
+ "oauthScopes": ["https://www.googleapis.com/auth/spreadsheets.currentonly"]
+}
+```
+
+Що варто знати, перш ніж звужувати:
+
+- **`*.currentonly`** покриває лише документ, до якого прив'язано скрипт, або той, у якому працює доповнення.
+ Скрипту, що відкриває інші таблиці чи презентації за ID або URL, потрібні `spreadsheets` або `presentations`.
+- **`createFolder`** спершу шукає наявні папки за назвою і лише потім створює нову. З `drive.file` скрипт бачить
+ тільки файли й папки, які створив сам або які користувач відкрив через нього, тож пошук не знаходить папок,
+ створених кимось іншим, і з'являються дублікати. Використовуйте `drive.file`, лише якщо все дерево створює сам
+ скрипт; інакше — `drive`.
+- **Функціям Admin SDK** також потрібен увімкнений у проєкті розширений сервіс Admin SDK Directory
+ (`dependencies.enabledAdvancedServices`, `serviceId` `admin`, `version` `directory_v1`) і користувач, якому дозволено
+ читати каталог. Області лише для читання `admin.directory.user.readonly` досить: `isAdmin` тільки читає
+ користувача.
+- **Брак області доступу** виявляється під час виконання — помилкою авторизації під час виклику сервісу, а не під час
+ збереження проєкту. Після зміни `oauthScopes` пройдіть кожну гілку коду хоча б раз.
+
+Яка область потрібна кожному методу, зазначено в розділі «Authorization» його сторінки в
+[довіднику Apps Script](https://developers.google.com/apps-script/reference).
+
## Пакетність на межі
Кожне звернення до сервісу — це похід туди й назад, і Apps Script зараховує його до ліміту часу виконання.
@@ -49,7 +109,7 @@ for (const row of rows) {
Те саме міркування слушне й для перевірок. Перевіряйте форму даних до того, як вони дійдуть до сервісу, а не після:
```typescript
-import { IllegalArgumentException, appendRows, isConsistent2DArray } from "apps-script-utils";
+import { IllegalArgumentException, appendRows, isConsistent2DArray } from "@bootgs/utils";
if (!isConsistent2DArray(rows)) {
throw new IllegalArgumentException("every row must have the same number of columns");
diff --git a/docs/content/uk/topics/ecosystem.md b/docs/content/uk/topics/ecosystem.md
index 1c1be052..e12d7f19 100644
--- a/docs/content/uk/topics/ecosystem.md
+++ b/docs/content/uk/topics/ecosystem.md
@@ -2,7 +2,7 @@
Фреймворк boot.gs, побудований на цій бібліотеці, та Agent Skills, які вчать ШІ-агентів нею користуватися.
-Як apps-script-utils пов'язаний із фреймворком boot.gs для Google Apps Script і з Agent Skills, що вчать Claude Code, Gemini CLI та Cursor працювати з обома.
+Як @bootgs/utils пов'язаний із фреймворком boot.gs для Google Apps Script і з Agent Skills, що вчать Claude Code, Gemini CLI та Cursor працювати з обома.
Бібліотека корисна й сама по собі: встановили, імпортували функцію — готово. Водночас вона частина невеликої
екосистеми для розробки на Google Apps Script, і двох сусідів варто знати.
@@ -29,7 +29,7 @@ export class SheetController {
}
```
-**Відношення до цієї бібліотеки — залежність, а не суперництво.** `bootgs` перелічує `apps-script-utils` серед
+**Відношення до цієї бібліотеки — залежність, а не суперництво.** `bootgs` перелічує `@bootgs/utils` серед
своїх залежностей, тому в проєкті на boot.gs уже є кожна функція, описана тут, — доустановлювати нічого не треба. З
цих перевірок і зібрані його валідація параметрів та пошук сервісів.
@@ -37,7 +37,7 @@ export class SheetController {
| Що потрібно | Що брати |
| :------------------------------------------------------------------------------- | :--------------------------------- |
-| Помічники в уже написаний скрипт — кілька функцій, без нової архітектури | `apps-script-utils` сам по собі |
+| Помічники в уже написаний скрипт — кілька функцій, без нової архітектури | `@bootgs/utils` сам по собі |
| Маршрутизація, контролери, впровадження залежностей, вебзастосунок з ендпоінтами | `bootgs`, бібліотека вже всередині |
## Agent Skills — навчити ШІ-агента цій бібліотеці
@@ -50,7 +50,7 @@ export class SheetController {
| Скіл | Покриває |
| :------------------------------ | :----------------------------------------------------------------------------------------------- |
-| `apps-script-utils` | цю бібліотеку: домовленість `isX`/`nonX`/`requireX`, перевірки, помічники |
+| `@bootgs/utils` | цю бібліотеку: домовленість `isX`/`nonX`/`requireX`, перевірки, помічники |
| `apps-script-triggers` | прості та встановлювані тригери, форму подій, квоти |
| `apps-script-services` | безпечну щодо квот роботу з `SpreadsheetApp`, `PropertiesService`, `CacheService`, `LockService` |
| `apps-script-ui` | меню, бічні панелі, діалоги та підводні камені `google.script.run` |
diff --git a/docs/content/uk/topics/exception-handling.md b/docs/content/uk/topics/exception-handling.md
index 502dafa3..4ddc66e6 100644
--- a/docs/content/uk/topics/exception-handling.md
+++ b/docs/content/uk/topics/exception-handling.md
@@ -2,7 +2,7 @@
Ієрархія винятків, коли кидається кожен клас і як їх ловити.
-Типізовані винятки apps-script-utils: ієрархія під Exception, яка перевірка який клас кидає і як ловити їх у проєкті Google Apps Script.
+Типізовані винятки @bootgs/utils: ієрархія під Exception, яка перевірка який клас кидає і як ловити їх у проєкті Google Apps Script.
Будь-яка помилка, яку підіймає ця бібліотека, — екземпляр класу `Exception` або його нащадка. Тому одного блоку
`catch` досить, щоб відрізнити збої бібліотеки від усього іншого, що кидає середовище виконання.
@@ -39,7 +39,7 @@ Error
У `Exception` є статичний страж типу — рекомендована перевірка, бо вона заодно звужує тип:
```typescript
-import { Exception, requireString } from "apps-script-utils";
+import { Exception, requireString } from "@bootgs/utils";
try {
requireString(input);
@@ -55,7 +55,7 @@ try {
`instanceof` теж працює — ним ловлять один конкретний збій:
```typescript
-import { NullPointerException, requireNonNull } from "apps-script-utils";
+import { NullPointerException, requireNonNull } from "@bootgs/utils";
try {
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"));
diff --git a/docs/content/uk/topics/getting-started.md b/docs/content/uk/topics/getting-started.md
index acc007ef..fda7e1d2 100644
--- a/docs/content/uk/topics/getting-started.md
+++ b/docs/content/uk/topics/getting-started.md
@@ -2,7 +2,7 @@
Вимоги, встановлення та перший робочий скрипт.
-Встановлення apps-script-utils у проєкт Google Apps Script: пакет npm, налаштування clasp і перший скрипт, що читає аркуш за допомогою бібліотеки.
+Встановлення @bootgs/utils у проєкт Google Apps Script: пакет npm, налаштування clasp і перший скрипт, що читає аркуш за допомогою бібліотеки.
## Вимоги
@@ -12,13 +12,13 @@
## Встановлення
```bash
-npm install apps-script-utils
+npm install @bootgs/utils
```
Усе експортується з кореня пакета, тому одного шляху імпорту достатньо для всієї бібліотеки:
```typescript
-import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script-utils";
+import { appendRows, isAdmin, parseA1Notation, requireString } from "@bootgs/utils";
```
## Перші приклади
@@ -28,7 +28,7 @@ import { appendRows, isAdmin, parseA1Notation, requireString } from "apps-script
Ефективно додати кілька рядків даних:
```typescript
-import { appendRows } from "apps-script-utils";
+import { appendRows } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
const data = [
@@ -44,7 +44,7 @@ appendRows(sheet, data);
Перевірити, чи має поточний користувач права адміністратора:
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
@@ -58,7 +58,7 @@ if (isAdmin()) {
Перетворити складну нотацію A1 на структурований об'єкт:
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
@@ -73,7 +73,7 @@ console.log(rangeInfo.endColumnIndex); // 2
неперевірене значення на типізоване — або кидає виняток:
```typescript
-import { requireString, requireNonEmptyString } from "apps-script-utils";
+import { requireString, requireNonEmptyString } from "@bootgs/utils";
function greet(name: unknown): string {
return `Hello, ${requireNonEmptyString(name)}!`;
diff --git a/docs/content/uk/topics/module-appsscript.md b/docs/content/uk/topics/module-appsscript.md
index 2bf97fee..c3e7addd 100644
--- a/docs/content/uk/topics/module-appsscript.md
+++ b/docs/content/uk/topics/module-appsscript.md
@@ -2,7 +2,7 @@
Помічники для Google Apps Script: таблиці, нотація A1, інтерфейс, Диск та Admin SDK.
-Модуль appsscript в apps-script-utils: помічники для таблиць і нотації A1, перевірки аркушів, інтерфейс, Диск, Презентації та Admin SDK для Google Apps Script.
+Модуль appsscript в @bootgs/utils: помічники для таблиць і нотації A1, перевірки аркушів, інтерфейс, Диск, Презентації та Admin SDK для Google Apps Script.
`appsscript` містить усе, що стосується сервісів Google. Це та частина бібліотеки, яка працює лише всередині
середовища Apps Script, — що це означає для тестів, розібрано в [](apps-script-runtime.md).
@@ -25,7 +25,7 @@
межею, як у Sheets API, а не позиціями від одиниці, які приймають методи `Range`:
```typescript
-import { parseA1Notation } from "apps-script-utils";
+import { parseA1Notation } from "@bootgs/utils";
parseA1Notation("Sheet1!A1:B10");
// {
@@ -46,7 +46,7 @@ parseA1Notation("B5");
`toA1Notation` — зворотна операція:
```typescript
-import { toA1Notation } from "apps-script-utils";
+import { toA1Notation } from "@bootgs/utils";
toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumnIndex: 2 });
// "A1:B10"
@@ -55,7 +55,7 @@ toA1Notation({ startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumn
`parseA1Notations` приймає список через кому й повертає по одному `GridRange` на запис:
```typescript
-import { parseA1Notations } from "apps-script-utils";
+import { parseA1Notations } from "@bootgs/utils";
parseA1Notations("Sheet1!A1:B2, Sheet1!D1"); // два об'єкти GridRange
```
@@ -67,7 +67,7 @@ import {
extractRangeFromA1Notation,
extractSheetNameFromA1Notation,
updateSheetNameInA1Notation
-} from "apps-script-utils";
+} from "@bootgs/utils";
extractSheetNameFromA1Notation("'My Sheet'!A1"); // "My Sheet"
extractRangeFromA1Notation("'My Sheet'!A1:B2"); // "A1:B2"
@@ -84,7 +84,7 @@ import {
getColumnIndexByLetter,
getColumnLetterByIndex,
getColumnPositionByLetter
-} from "apps-script-utils";
+} from "@bootgs/utils";
getColumnIndexByLetter("A"); // 0
getColumnIndexByLetter("AZ"); // 51
@@ -103,7 +103,7 @@ import {
isCellGridRange,
isGridRangeContainedIn,
isGridRangeSameDimensions
-} from "apps-script-utils";
+} from "@bootgs/utils";
const header = { startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 5 };
const body = { startRowIndex: 1, endRowIndex: 100, startColumnIndex: 0, endColumnIndex: 5 };
@@ -115,7 +115,7 @@ isCellGridRange(header); // false — він займає п'ять стовпц
## Запис рядків і стовпців
```typescript
-import { appendRows, prependRows, appendColumns } from "apps-script-utils";
+import { appendRows, prependRows, appendColumns } from "@bootgs/utils";
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
@@ -135,7 +135,7 @@ prependRows(sheet, [["Name", "Email", "Age"]]);
Та сама домовленість, що й у всій бібліотеці, застосована до класів Apps Script:
```typescript
-import { isSheet, isSpreadsheet, isRange, requireSheet } from "apps-script-utils";
+import { isSheet, isSpreadsheet, isRange, requireSheet } from "@bootgs/utils";
function rowCount(value: unknown): number {
return requireSheet(value).getLastRow();
@@ -148,7 +148,7 @@ function rowCount(value: unknown): number {
## Презентації
```typescript
-import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "apps-script-utils";
+import { getSlideByIndex, findReplaceAllTextInSlide, requireSlide } from "@bootgs/utils";
const presentation = SlidesApp.getActivePresentation();
@@ -166,7 +166,7 @@ findReplaceAllTextInSlide(slide, "{{name}}", "Ada Lovelace");
## Admin SDK
```typescript
-import { isAdmin } from "apps-script-utils";
+import { isAdmin } from "@bootgs/utils";
if (isAdmin()) {
Logger.log("Access granted to admin panel.");
diff --git a/docs/content/uk/topics/module-exception.md b/docs/content/uk/topics/module-exception.md
index a0d013ad..737a2d43 100644
--- a/docs/content/uk/topics/module-exception.md
+++ b/docs/content/uk/topics/module-exception.md
@@ -2,7 +2,7 @@
Класи винятків і як їх розширювати.
-Модуль exception в apps-script-utils: базовий клас Exception, його нащадки і як додати до ієрархії власний клас.
+Модуль exception в @bootgs/utils: базовий клас Exception, його нащадки і як додати до ієрархії власний клас.
`exception` містить класи помилок, які кидає решта бібліотеки. Ніщо в ньому не залежить від середовища виконання
Apps Script.
@@ -24,7 +24,7 @@ Apps Script.
успадковуйте `RuntimeException`:
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
export class QuotaExceededException extends RuntimeException {}
```
@@ -49,7 +49,7 @@ Object.prototype.toString.call(error); // "[object QuotaExceededException]"
тип змінюється:
```typescript
-import { RuntimeException } from "apps-script-utils";
+import { RuntimeException } from "@bootgs/utils";
try {
UrlFetchApp.fetch(endpoint);
diff --git a/docs/content/uk/topics/module-lang.md b/docs/content/uk/topics/module-lang.md
index 690b1f89..6f7e177e 100644
--- a/docs/content/uk/topics/module-lang.md
+++ b/docs/content/uk/topics/module-lang.md
@@ -2,7 +2,7 @@
Мовні утиліти, що не залежать від середовища: перевірки, масиви, числа, об'єкти, рядки.
-Модуль lang в apps-script-utils: перевірки типів, помічники для масивів і матриць, класифікація чисел, хешування об'єктів і перетворення рядків — усе незалежно від середовища виконання.
+Модуль lang в @bootgs/utils: перевірки типів, помічники для масивів і матриць, класифікація чисел, хешування об'єктів і перетворення рядків — усе незалежно від середовища виконання.
`lang` — це мовні утиліти, та частина бібліотеки, яка нічого не знає про Google Apps Script і працює всюди, де
працює JavaScript.
@@ -27,7 +27,7 @@
повертає.
```typescript
-import { requireString, toKebabCase } from "apps-script-utils";
+import { requireString, toKebabCase } from "@bootgs/utils";
function slugify(input: unknown): string {
return toKebabCase(requireString(input));
@@ -37,7 +37,7 @@ function slugify(input: unknown): string {
## Масиви
```typescript
-import { chunk, transpose, is2DArray, isConsistent2DArray } from "apps-script-utils";
+import { chunk, transpose, is2DArray, isConsistent2DArray } from "@bootgs/utils";
chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
@@ -57,7 +57,7 @@ isConsistent2DArray([[1, 2], [3]]); // false — рядки різної дов
## Числа
```typescript
-import { isCountable, isFloat, isInteger, toInteger } from "apps-script-utils";
+import { isCountable, isFloat, isInteger, toInteger } from "@bootgs/utils";
isInteger(42); // true
isInteger(42.5); // false
@@ -74,7 +74,7 @@ isCountable(-1); // false
Зміна регістру:
```typescript
-import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "apps-script-utils";
+import { toCamelCase, toKebabCase, toSnakeCase, toProperCase } from "@bootgs/utils";
toCamelCase("user name"); // "userName"
toKebabCase("User Name"); // "user-name"
@@ -85,7 +85,7 @@ toProperCase("user name"); // "User Name"
Перевірки:
```typescript
-import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "apps-script-utils";
+import { isEmail, isValidSlug, isValidVersion, requireValidEmail } from "@bootgs/utils";
isEmail("ada@example.com"); // true
isValidSlug("my-post"); // true
@@ -97,7 +97,7 @@ requireValidEmail(formResponse); // поверне значення або ки
Порівняння версій — для скриптів, які вмикають поведінку залежно від версії бібліотеки:
```typescript
-import { versionCompare, isVersionCompatible } from "apps-script-utils";
+import { versionCompare, isVersionCompatible } from "@bootgs/utils";
versionCompare("1.10.0", "1.9.0"); // 1
versionCompare("1.9.0", "1.10.0"); // -1
@@ -108,7 +108,7 @@ versionCompare("1.9.0", "1.9.0"); // 0
запит надходить із комірки чи форми:
```typescript
-import { escapeRegExp } from "apps-script-utils";
+import { escapeRegExp } from "@bootgs/utils";
const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
```
@@ -116,7 +116,7 @@ const pattern = new RegExp(escapeRegExp(searchTerm), "gi");
## Об'єкти
```typescript
-import { hashCode, objectToString } from "apps-script-utils";
+import { hashCode, objectToString } from "@bootgs/utils";
objectToString([]); // "[object Array]"
objectToString(null); // "[object Null]"
diff --git a/docs/content/uk/topics/module-net.md b/docs/content/uk/topics/module-net.md
index ad87f73b..88766ce9 100644
--- a/docs/content/uk/topics/module-net.md
+++ b/docs/content/uk/topics/module-net.md
@@ -2,7 +2,7 @@
Помічники для URL, шляхів і доменів.
-Модуль net в apps-script-utils: перевірка URL, розбір, склеювання та нормалізація шляхів, перевірка доменів — усе це працює й усередині Google Apps Script.
+Модуль net в @bootgs/utils: перевірка URL, розбір, склеювання та нормалізація шляхів, перевірка доменів — усе це працює й усередині Google Apps Script.
`net` — це шляхи, URL і все навколо них. Як і `lang`, він не залежить від середовища виконання Apps Script.
@@ -20,7 +20,7 @@
## Шляхи
```typescript
-import { join, normalize, parse, isAbsolute, isRelative } from "apps-script-utils";
+import { join, normalize, parse, isAbsolute, isRelative } from "@bootgs/utils";
join("/a", "b", "../c"); // "/a/c"
normalize("/a/b/../c"); // "/a/c"
@@ -38,7 +38,7 @@ isRelative("a/b"); // true
## Домени та URL
```typescript
-import { isValidDomain, isUrl } from "apps-script-utils";
+import { isValidDomain, isUrl } from "@bootgs/utils";
isValidDomain("example.com"); // true
isValidDomain("not a domain"); // false
diff --git a/docs/content/uk/topics/overview.md b/docs/content/uk/topics/overview.md
index 12fbb3b0..1411a266 100644
--- a/docs/content/uk/topics/overview.md
+++ b/docs/content/uk/topics/overview.md
@@ -1,14 +1,14 @@
# Огляд
-Що таке apps-script-utils, що входить до бібліотеки та як побудована ця документація.
+Що таке @bootgs/utils, що входить до бібліотеки та як побудована ця документація.
-apps-script-utils — бібліотека утиліт на TypeScript для Google Apps Script: робота з таблицями та нотацією A1, перевірки isX/nonX/requireX, типізовані винятки.
+@bootgs/utils — бібліотека утиліт на TypeScript для Google Apps Script: робота з таблицями та нотацією A1, перевірки isX/nonX/requireX, типізовані винятки.

_Художниця: [Дарина Михайленко](https://darynamikhailenko.com/?utm_source=docs&utm_medium=overview&utm_campaign=apps-script-utils&utm_content=banner-artist-credit)_
-**apps-script-utils** — бібліотека утиліт на TypeScript, створена саме для **Google Apps Script**. Вона збирає в
+**@bootgs/utils** — бібліотека утиліт на TypeScript, створена саме для **Google Apps Script**. Вона збирає в
одному протестованому пакеті те, що в кожному проєкті на GAS однаково доводиться писати руками: роботу з таблицями
та нотацією A1, перевірку типів і значень (`isX`/`nonX`/`requireX`), перетворення рядків і масивів, типізовані
винятки та багато іншого.
diff --git a/docs/content/uk/topics/reference-abstracts.md b/docs/content/uk/topics/reference-abstracts.md
index 7dae1670..38c0e647 100644
--- a/docs/content/uk/topics/reference-abstracts.md
+++ b/docs/content/uk/topics/reference-abstracts.md
@@ -2,7 +2,7 @@
Абстрактні базові класи, на яких побудована бібліотека.
-Довідник абстрактних базових класів apps-script-utils і того, заради чого їх успадковують.
+Довідник абстрактних базових класів @bootgs/utils і того, заради чого їх успадковують.
Спільні абстрактні класи та інтерфейси, які решта модулів бібліотеки використовує як будівельні блоки.
diff --git a/docs/content/uk/topics/reference-appsscript.md b/docs/content/uk/topics/reference-appsscript.md
index 5e9cb4d4..b68b6ccd 100644
--- a/docs/content/uk/topics/reference-appsscript.md
+++ b/docs/content/uk/topics/reference-appsscript.md
@@ -2,7 +2,7 @@
Усі функції бібліотеки, прив'язані до Google Apps Script, за сервісами.
-Довідник функцій apps-script-utils для Google Apps Script: таблиці, нотація A1, інтерфейс, Диск, Презентації та Admin SDK — з типами значень, що повертаються.
+Довідник функцій @bootgs/utils для Google Apps Script: таблиці, нотація A1, інтерфейс, Диск, Презентації та Admin SDK — з типами значень, що повертаються.
Функції, прив'язані до конкретних сервісів Google Apps Script: Таблиці, Презентації, Admin SDK, Диск, Документи,
Форми, мережеві запити та вбудовані класи інтерфейсу.
@@ -28,11 +28,11 @@
## Методи Google Документів {id="google-docs-methods"}
-Помічники для Google Документів. Поки не реалізовані. Будемо раді внеску — дивіться [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Помічники для Google Документів. Поки не реалізовані. Будемо раді внеску — дивіться [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Методи Google Форм {id="google-forms-methods"}
-Помічники для Google Форм. Поки не реалізовані. Будемо раді внеску — дивіться [Contributing](https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md).
+Помічники для Google Форм. Поки не реалізовані. Будемо раді внеску — дивіться [Contributing](https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md).
## Методи Google Таблиць {id="google-sheets-methods"}
diff --git a/docs/content/uk/topics/reference-base.md b/docs/content/uk/topics/reference-base.md
index fd8c26b1..fd48b88a 100644
--- a/docs/content/uk/topics/reference-base.md
+++ b/docs/content/uk/topics/reference-base.md
@@ -2,7 +2,7 @@
Усі функції, що не залежать від середовища виконання: перевірки, масиви, числа, рядки, об'єкти, JSON і HTML.
-Довідник усіх незалежних від середовища функцій apps-script-utils: перевірки isX/nonX/requireX, робота з масивами, числами, рядками, об'єктами, JSON, HTML і часом.
+Довідник усіх незалежних від середовища функцій @bootgs/utils: перевірки isX/nonX/requireX, робота з масивами, числами, рядками, об'єктами, JSON, HTML і часом.
Функції, не прив'язані до жодного фреймворку: перевірка типів і значень (`isX`/`nonX`/`requireX`), робота з рядками,
масивами та об'єктами, JSON і HTML. Середовище виконання Google Apps Script їм не потрібне.
diff --git a/docs/content/uk/topics/reference-exception.md b/docs/content/uk/topics/reference-exception.md
index ee5230b8..9e484b5b 100644
--- a/docs/content/uk/topics/reference-exception.md
+++ b/docs/content/uk/topics/reference-exception.md
@@ -2,7 +2,7 @@
Усі класи винятків, які кидає бібліотека.
-Довідник класів винятків apps-script-utils: що означає кожен і які функції його кидають.
+Довідник класів винятків @bootgs/utils: що означає кожен і які функції його кидають.
Типізовані класи винятків, що використовуються в усій бібліотеці. Винятки, прив'язані до сервісів (Таблиці,
Презентації, Admin SDK, мережа), успадковують спільний базовий клас `Exception` — заради однакової обробки помилок.
diff --git a/docs/content/uk/topics/reference-path.md b/docs/content/uk/topics/reference-path.md
index 0219b89f..fc47014b 100644
--- a/docs/content/uk/topics/reference-path.md
+++ b/docs/content/uk/topics/reference-path.md
@@ -2,7 +2,7 @@
Усі функції для шляхів та URL.
-Довідник функцій apps-script-utils для шляхів та URL: розбір, склеювання, нормалізація й перевірка шляхів і доменів.
+Довідник функцій @bootgs/utils для шляхів та URL: розбір, склеювання, нормалізація й перевірка шляхів і доменів.
Функції для роботи зі шляхами до файлів та URL-адресами.
diff --git a/docs/content/uk/topics/validation-conventions.md b/docs/content/uk/topics/validation-conventions.md
index 73eacc01..91fb562a 100644
--- a/docs/content/uk/topics/validation-conventions.md
+++ b/docs/content/uk/topics/validation-conventions.md
@@ -2,7 +2,7 @@
Схема імен isX / nonX / requireX / requireNonX і що гарантує кожен префікс.
-Схема іменування перевірок в apps-script-utils: isX і nonX відповідають на питання, requireX і requireNonX перевіряють і повертають значення; у кожного префікса своя сигнатура.
+Схема іменування перевірок в @bootgs/utils: isX і nonX відповідають на питання, requireX і requireNonX перевіряють і повертають значення; у кожного префікса своя сигнатура.
Більша частина бібліотеки — це перевірки, і майже всі вони підпорядковані одній схемі імен. Вивчіть чотири префікси
один раз, і ім'я функції саме розкаже її сигнатуру, значення, що повертається, і те, чи може вона кинути виняток.
@@ -24,7 +24,7 @@
Стражі `isX` оголошені як type predicates у TypeScript, тому всередині гілки компілятор звужує тип значення:
```typescript
-import { isString } from "apps-script-utils";
+import { isString } from "@bootgs/utils";
function describe(value: unknown): string {
if (isString(value)) {
@@ -38,7 +38,7 @@ function describe(value: unknown): string {
`nonX` звужує у зворотний бік — він прибирає `X` із типу, а не підтверджує його:
```typescript
-import { nonString } from "apps-script-utils";
+import { nonString } from "@bootgs/utils";
function lengthOf(value: string | number): number {
if (nonString(value)) {
@@ -58,7 +58,7 @@ function lengthOf(value: string | number): number {
`requireX` перевіряє й повертає, тому виклик вбудовується у вираз, а не потребує окремого оператора:
```typescript
-import { requireNumber, requireString } from "apps-script-utils";
+import { requireNumber, requireString } from "@bootgs/utils";
function repeat(text: unknown, times: unknown): string {
return requireString(text).repeat(requireNumber(times));
@@ -105,7 +105,7 @@ _використати_ значення як цей тип:
`NullPointerException`:
```typescript
-import { requireNonNull } from "apps-script-utils";
+import { requireNonNull } from "@bootgs/utils";
const sheet = requireNonNull(spreadsheet.getSheetByName("Data"), "sheet 'Data' is missing");
```
diff --git a/docs/privacy.md b/docs/privacy.md
new file mode 100644
index 00000000..d4fad314
--- /dev/null
+++ b/docs/privacy.md
@@ -0,0 +1,23 @@
+# Privacy
+
+**@bootgs/utils collects no data.**
+
+- The library makes **no network calls of its own**: it does not use `UrlFetchApp`, `fetch` or any other HTTP
+ client, and it contacts no server — neither the maintainers' nor a third party's.
+- It contains **no telemetry**, analytics, tracking or "phone home" code.
+- It runs entirely inside your Google Apps Script project. Spreadsheet, document and user data that your code passes
+ to it, or that it reads on your behalf, stay in your project and the Google services your script already uses.
+- The Apps Script services it calls are the ones a function exists to work with: for example `SpreadsheetApp` for
+ the sheet helpers, `DriveApp` for the Drive helpers, the Admin SDK Directory service (`AdminDirectory`) for
+ `isAdmin`, and `Session` to read the active user's email. Each function, its services and the OAuth scope it
+ needs are listed on the
+ [Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) page.
+
+Your own code, other libraries you add and Google's services are governed by their own terms and privacy
+policies, for example the [Google Privacy Policy](https://policies.google.com/privacy).
+
+Installing the package from npm is subject to the
+[npm privacy policy](https://docs.npmjs.com/policies/privacy); the project receives only the aggregate download
+counts that npm publishes.
+
+Questions: open an [issue](https://github.com/bootgs/utils/issues) or see [SUPPORT.md](../SUPPORT.md).
diff --git a/docs/readme/README.ar.md b/docs/readme/README.ar.md
new file mode 100644
index 00000000..bda2456e
--- /dev/null
+++ b/docs/readme/README.ar.md
@@ -0,0 +1,346 @@
+
+
+
+
+
+
+> أُنجزت هذه الترجمة بمساعدة الذكاء الاصطناعي انطلاقًا من [README.md](../../README.md) للإصدار 2.1.1. النسخة المرجعية هي ملف README الإنجليزي؛ ونرحّب بالتصحيحات — راجع [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# أدوات مساعدة لمشاريع Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [أدوات مساعدة لمشاريع Google Apps Script™](#أدوات-مساعدة-لمشاريع-google-apps-script)
+ - [نظرة عامة](#نظرة-عامة)
+ - [الميزات الرئيسية](#الميزات-الرئيسية)
+ - [مهارات وكلاء الذكاء الاصطناعي](#مهارات-وكلاء-الذكاء-الاصطناعي)
+ - [المتطلبات](#المتطلبات)
+ - [التثبيت](#التثبيت)
+ - [التوثيق](#التوثيق)
+ - [أمثلة الاستخدام](#أمثلة-الاستخدام)
+ - [التطوير](#التطوير)
+ - [السكربتات](#السكربتات)
+ - [الاختبار](#الاختبار)
+ - [بنية المشروع](#بنية-المشروع)
+ - [الدوال حسب الفئة](#الدوال-حسب-الفئة)
+ - [المساهمة](#المساهمة)
+ - [الدعم](#الدعم)
+ - [خارطة الطريق](#خارطة-الطريق)
+ - [سجل التغييرات](#سجل-التغييرات)
+ - [الترخيص](#الترخيص)
+
+
+## نظرة عامة
+
+**@bootgs/utils** مكتبة أدوات مساعدة بلغة TypeScript صُمّمت خصيصًا لـ **Google Apps Script**. تجمع في حزمة واحدة،
+موثّقة جيدًا ومختبرة بالكامل، الدوال المساعدة التي ينتهي كل مشروع GAS بكتابتها يدويًا — التعامل مع جداول البيانات
+وتدوين A1، والتحقق من الأنواع والقيم (`isX`/`nonX`/`requireX`)، وتحويلات السلاسل النصية والمصفوفات، والاستثناءات
+ذات الأنواع المحددة، وغير ذلك.
+
+## الميزات الرئيسية
+
+- **مبنية لـ Google Apps Script** — مصمّمة حول بيئة تشغيل GAS وقيودها، وليست مقتبسة من مكتبة Node.js عامة.
+- **تغطية واسعة** — دوال مساعدة لجداول البيانات وواجهة المستخدم والشبكة وAdmin SDK، إلى جانب أدوات عامة للسلاسل
+ النصية والمصفوفات والكائنات.
+- **TypeScript أولًا** — تأتي كل دالة مع تعريفات أنواع كاملة للإكمال التلقائي في بيئة التطوير والأمان وقت الترجمة.
+- **مختبرة** — تغطيها مجموعة اختبارات وحدات مكتوبة بـ Vitest.
+- **توثيق مرجعي مترابط** — كل نوع من أنواع Google Apps Script المستخدمة في الواجهة البرمجية يرتبط مباشرةً بتوثيقه
+ الرسمي.
+- **معالجة متّسقة للأخطاء** — تسلسل هرمي مخصص لفئات الاستثناءات يحلّ محل الأخطاء المرمية بشكل عشوائي.
+
+## مهارات وكلاء الذكاء الاصطناعي
+
+للفرق التي تستخدم وكيل برمجة بالذكاء الاصطناعي (Claude Code وGemini CLI وغيرهما)، يقدّم المستودع
+[bootgs/skills](https://github.com/bootgs/skills) مهارة وكيل (Agent Skill) باسم
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) توثّق هذه المكتبة لمثل هذه
+الوكلاء، بما في ذلك اصطلاح التحقق `isX`/`nonX`/`requireX`، ودوال تدوين A1 والأوراق، ودوال السلاسل النصية والأرقام
+والمصفوفات، والاستثناءات ذات الأنواع المحددة، ودوال HTML وJSON والمسارات.
+
+التثبيت باستخدام Claude Code:
+
+
+
+بعد التثبيت، يطبّق الوكيل المهارة تلقائيًا عندما تتعلق المهمة بهذه المكتبة.
+
+## المتطلبات
+
+- [Node.js](https://nodejs.org/) الإصدار v22.14.0 أو أحدث
+- [npm](https://www.npmjs.com/) (أو مدير حزم آخر لـ Node، مثل pnpm)
+
+## التثبيت
+
+ثبّت الحزمة عبر npm:
+
+
+
+```bash
+npm install @bootgs/utils
+```
+
+
+
+## التوثيق
+
+التوثيق الكامل منشور على **** (بالإنجليزية): أدلة، وشروحات لكل وحدة، والمرجع
+الكامل للدوال. يوجد مصدره في [`docs/writerside/`](../writerside/) ويُعاد بناؤه مع كل دفع (push) إلى `main`.
+
+ترتيب مقترح للقراءة:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — الخطوات الأولى
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — نظام التسمية
+ `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — التسلسل الهرمي للفئات وما الذي
+ يطلق كل استثناء
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — أي الدوال المساعدة ترتبط
+ بخدمة من خدمات Google، وما يعنيه ذلك للاختبار
+
+## أمثلة الاستخدام
+
+### العمل مع جداول البيانات
+
+إلحاق عدة صفوف من البيانات بكفاءة:
+
+
+
+## التطوير
+
+### السكربتات
+
+السكربتات التالية متاحة في `package.json`:
+
+
+
+| Script | الوصف |
+| :------------------- | :------------------------------------------------------------ |
+| `npm run build` | ينظّف المجلد `dist` ويترجم شيفرة TypeScript المصدرية. |
+| `npm run dev` | يشغّل Vitest في وضع المراقبة. |
+| `npm test` | يشغّل مجموعة الاختبارات كاملةً مرة واحدة. |
+| `npm run type:check` | يتحقق من أنواع المشروع دون إنتاج مخرجات. |
+| `npm run lint` | يفحص الشيفرة باستخدام ESLint. |
+| `npm run lint:fix` | يفحص الشيفرة ويصلح تلقائيًا ما أمكن. |
+| `npm run format` | يتحقق من التنسيق باستخدام Prettier. |
+| `npm run format:fix` | ينسّق الشيفرة باستخدام Prettier. |
+| `npm run prepare` | يُعدّ خطافات Git الخاصة بـ Husky (يعمل تلقائيًا بعد التثبيت). |
+
+
+
+### الاختبار
+
+يستخدم المشروع [Vitest](https://vitest.dev/) لاختبارات الوحدات.
+
+تشغيل المجموعة كاملةً مرة واحدة:
+
+
+
+## الدوال حسب الفئة
+
+انتقل المرجع الكامل للدوال إلى موقع التوثيق (بالإنجليزية)، الذي يُبنى من [`docs/writerside/`](../writerside/)
+ويُنشر مع كل دفع (push) إلى `main`:
+
+****
+
+| القسم | المحتوى |
+| :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets وSlides وAdmin SDK وDrive وDocs وForms، وطلبات الشبكة، وفئات واجهة المستخدم المدمجة |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | فحص الأنواع والتحقق، ومعالجة السلاسل النصية والمصفوفات والكائنات، والتعامل مع JSON وHTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | فئات الاستثناءات ذات الأنواع المحددة وما الذي يطلق كلًّا منها |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | مسارات الملفات وعناوين URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | لبنات بناء مشتركة |
+
+إلى جانب المرجع، يضم الموقع الأدلة التي لم تتسع لها الجداول:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) يشرح نظام
+`isX`/`nonX`/`requireX`/`requireNonX` في مكان واحد، و[exception handling](https://bootgs.github.io/utils/exception-handling.html)
+يعرض التسلسل الهرمي للفئات، و[the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+يوضّح أي الدوال المساعدة ترتبط بخدمة من خدمات Google، وما كلفة ذلك، وما يعنيه للاختبار.
+
+## المساهمة
+
+نرحّب بالمساهمات. راجع [CONTRIBUTING.md](../../CONTRIBUTING.md) للاطلاع على الدليل الكامل. باختصار:
+
+1. أنشئ نسخة (fork) من المستودع وفرعًا للميزة أو الإصلاح الذي تعمل عليه.
+2. أضف اختبارات أو حدّثها لتغطية تغييراتك.
+3. شغّل `npm run lint` و`npm run format` قبل الإيداع (commit).
+4. لا تعدّل `CHANGELOG.md` يدويًا — فهو يُولَّد تلقائيًا بواسطة [release-please](https://github.com/googleapis/release-please).
+5. افتح طلب دمج (pull request) يصف ما الذي تغيّر ولماذا.
+
+اتبع أسلوب الشيفرة واصطلاحات التسمية المعتمدة. راجع [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md) للاطلاع على قواعد
+المجتمع.
+
+## الدعم
+
+- للإبلاغ عن الأخطاء أو طلب الميزات، ابحث عن [issue](https://github.com/bootgs/utils/issues) أو افتح واحدة على
+ GitHub.
+- لمعرفة أحدث التغييرات، راجع [سجل التغييرات](../../CHANGELOG.md).
+- للإبلاغ عن ثغرة أمنية، اتبع [سياسة الأمان](../../SECURITY.md) بدلًا من فتح issue عامة.
+- لدعم استمرار التطوير، راجع [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## خارطة الطريق
+
+ما هو مخطط له أو قيد التنفيذ أو منجز موجود على [لوحة المشروع](https://github.com/users/MaksymStoianov/projects/2/views/2)،
+المبنية من متتبّع المشكلات نفسه. لا توجد وثيقة خارطة طريق منفصلة قد تتخلف عنه: لاقتراح أمر ما، افتح
+[issue](https://github.com/bootgs/utils/issues).
+
+## سجل التغييرات
+
+للاطلاع على قائمة مفصّلة بالتغييرات حسب الإصدار، راجع [CHANGELOG.md](../../CHANGELOG.md).
+
+## الترخيص
+
+هذا المشروع مرخّص بموجب Apache License 2.0. راجع [LICENSE](../../LICENSE) لمزيد من التفاصيل.
+
+رسم الشعار ليس جزءًا من ذلك الترخيص. إنه من أعمال مؤلفته، ويجوز إعادة استخدامه دون تعديل مع ذكر اسم المؤلفة وربط
+الإشارة إليها برابط، ويخضع لـ [docs/assets/images/README.md](../assets/images/README.md).
+
+## العلامات التجارية
+
+Google Apps Script وGoogle Sheets وGoogle Slides وGoogle Docs وGoogle Forms وGoogle Drive علامات تجارية مملوكة لشركة
+Google LLC. هذا المشروع مكتبة مستقلة، وهو غير تابع لشركة Google LLC ولا معتمد أو مموّل منها، وتُستخدم العلامات
+التجارية فقط لوصف ما تعمل معه المكتبة.
+
+
diff --git a/docs/readme/README.cs.md b/docs/readme/README.cs.md
new file mode 100644
index 00000000..b88262d6
--- /dev/null
+++ b/docs/readme/README.cs.md
@@ -0,0 +1,302 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | **Čeština** | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Tento překlad vznikl s pomocí AI z [README.md](../../README.md) pro verzi 2.1.1. Referenční verzí je anglické README; opravy jsou vítány — viz [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Utility pro Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Utility pro Google Apps Script™](#utility-pro-google-apps-script)
+ - [Přehled](#přehled)
+ - [Hlavní funkce](#hlavní-funkce)
+ - [Skills pro AI agenty](#skills-pro-ai-agenty)
+ - [Požadavky](#požadavky)
+ - [Instalace](#instalace)
+ - [Dokumentace](#dokumentace)
+ - [Příklady použití](#příklady-použití)
+ - [Vývoj](#vývoj)
+ - [Skripty](#skripty)
+ - [Testování](#testování)
+ - [Struktura projektu](#struktura-projektu)
+ - [Funkce podle kategorií](#funkce-podle-kategorií)
+ - [Jak přispět](#jak-přispět)
+ - [Podpora](#podpora)
+ - [Plán vývoje](#plán-vývoje)
+ - [Seznam změn](#seznam-změn)
+ - [Licence](#licence)
+
+
+## Přehled
+
+**@bootgs/utils** je knihovna utilit v TypeScriptu vytvořená přímo pro **Google Apps Script**. Spojuje pomocné funkce,
+které si každý projekt GAS nakonec píše ručně — práci s tabulkami a notací A1, validaci typů a hodnot
+(`isX`/`nonX`/`requireX`), transformace řetězců a polí, typované výjimky a další — do jediného dobře zdokumentovaného
+a plně otestovaného balíčku.
+
+## Hlavní funkce
+
+- **Vytvořeno pro Google Apps Script** — navrženo podle běhového prostředí GAS a jeho omezení, nikoli převzato
+ z obecné knihovny pro Node.js.
+- **Široké pokrytí** — pomocné funkce pro tabulky, UI, síť a Admin SDK vedle univerzálních utilit pro řetězce, pole
+ a objekty.
+- **TypeScript na prvním místě** — každá funkce má úplné typové definice pro automatické doplňování v IDE a kontrolu
+ při kompilaci.
+- **Otestováno** — pokryto sadou jednotkových testů ve Vitestu.
+- **Propojená referenční dokumentace** — každý typ Google Apps Script použitý v API odkazuje přímo na svou oficiální
+ dokumentaci.
+- **Jednotné zpracování chyb** — vlastní hierarchie tříd výjimek nahrazuje nahodile vyhazované chyby.
+
+## Skills pro AI agenty
+
+Pro týmy, které používají AI agenta pro programování (Claude Code, Gemini CLI a další), nabízí repozitář
+[bootgs/skills](https://github.com/bootgs/skills) Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils), který tuto knihovnu
+takovým agentům popisuje, včetně konvence validace `isX`/`nonX`/`requireX`, pomocných funkcí pro notaci A1 a listy,
+pro řetězce, čísla a pole, typovaných výjimek a pomocných funkcí pro HTML, JSON a cesty.
+
+Instalace v Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Instalace pomocí CLI `npx skills`, které podporuje více agentů:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Po instalaci agent skill použije automaticky, jakmile se úloha týká této knihovny.
+
+## Požadavky
+
+- [Node.js](https://nodejs.org/) v22.14.0 nebo novější
+- [npm](https://www.npmjs.com/) (nebo jiný správce balíčků pro Node, např. pnpm)
+
+## Instalace
+
+Nainstalujte balíček přes npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Dokumentace
+
+Úplná dokumentace je zveřejněna na **** (v angličtině):
+průvodci, procházky jednotlivými moduly a kompletní reference funkcí. Její zdroj je v
+[`docs/writerside/`](../writerside/) a znovu se sestavuje při každém push do `main`.
+
+Doporučené pořadí čtení:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — první kroky
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) —
+ schéma pojmenování `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — hierarchie
+ tříd a co kterou výjimku vyvolává
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — které
+ pomocné funkce jsou vázány na službu Google a co to znamená pro testování
+
+## Příklady použití
+
+### Práce s listy
+
+Efektivní přidání více řádků dat:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Utility pro Admin SDK
+
+Ověření, zda má aktuální uživatel administrátorská oprávnění:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Parsování notace A1
+
+Rozbor složitých zápisů v notaci A1 do strukturovaných objektů:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Vývoj
+
+### Skripty
+
+V `package.json` jsou k dispozici tyto skripty:
+
+| Skript | Popis |
+| :------------------- | :-------------------------------------------------------------- |
+| `npm run build` | Vyčistí adresář `dist` a zkompiluje zdrojový kód v TypeScriptu. |
+| `npm run dev` | Spustí Vitest v režimu sledování změn. |
+| `npm test` | Jednou spustí celou sadu testů. |
+| `npm run type:check` | Zkontroluje typy projektu bez generování výstupu. |
+| `npm run lint` | Zkontroluje kód pomocí ESLintu. |
+| `npm run lint:fix` | Zkontroluje kód a automaticky opraví, co lze. |
+| `npm run format` | Zkontroluje formátování pomocí Prettieru. |
+| `npm run format:fix` | Naformátuje kód pomocí Prettieru. |
+| `npm run prepare` | Nastaví Git hooky Husky (spouští se automaticky po instalaci). |
+
+### Testování
+
+Projekt používá pro jednotkové testy [Vitest](https://vitest.dev/).
+
+Jednorázové spuštění celé sady:
+
+```bash
+npm test
+```
+
+Nebo spuštění v režimu sledování změn během vývoje:
+
+```bash
+npm run dev
+```
+
+## Struktura projektu
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Funkce podle kategorií
+
+Úplná reference funkcí se přesunula na web s dokumentací, který se sestavuje z
+[`docs/writerside/`](../writerside/) a zveřejňuje při každém push do `main`:
+
+****
+
+| Oddíl | Obsah |
+| :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, síťové požadavky a vestavěné třídy UI |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Kontrola typů a validace, práce s řetězci, poli a objekty, zpracování JSON a HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | Typované třídy výjimek a co kterou z nich vyvolává |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Cesty k souborům a URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Sdílené stavební prvky |
+
+Kromě reference obsahuje web i průvodce, které se do tabulek nevešly:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) vysvětluje
+schéma `isX`/`nonX`/`requireX`/`requireNonX` na jednom místě,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) popisuje hierarchii
+tříd a [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+vysvětluje, které pomocné funkce jsou vázány na službu Google, co to stojí a co to znamená pro testování.
+
+## Jak přispět
+
+Příspěvky jsou vítány. Úplný návod najdete v [CONTRIBUTING.md](../../CONTRIBUTING.md). Ve zkratce:
+
+1. Vytvořte fork repozitáře a založte větev pro novou funkci nebo opravu chyby.
+2. Přidejte nebo aktualizujte testy, které pokrývají vaše změny.
+3. Před commitem spusťte `npm run lint` a `npm run format`.
+4. Needitujte `CHANGELOG.md` ručně — generuje ho automaticky [release-please](https://github.com/googleapis/release-please).
+5. Otevřete pull request s popisem toho, co se změnilo a proč.
+
+Dodržujte stávající styl kódu a konvence pojmenování. Pravidla komunity najdete v
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Podpora
+
+- Chyby nebo požadavky na nové funkce vyhledejte nebo nahlaste jako [issue](https://github.com/bootgs/utils/issues)
+ na GitHubu.
+- Nedávné změny najdete v [seznamu změn](../../CHANGELOG.md).
+- Bezpečnostní zranitelnost nahlaste podle [bezpečnostní politiky](../../SECURITY.md), nikoli ve veřejném issue.
+- Chcete-li podpořit další vývoj, navštivte [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Plán vývoje
+
+Co je naplánováno, rozpracováno nebo hotovo, najdete na [nástěnce projektu](https://github.com/users/MaksymStoianov/projects/2/views/2),
+která vychází přímo ze seznamu issues. Neexistuje žádný samostatný dokument s plánem, který by se s ní mohl rozcházet:
+chcete-li něco navrhnout, otevřete [issue](https://github.com/bootgs/utils/issues).
+
+## Seznam změn
+
+Podrobný seznam změn podle verzí najdete v [CHANGELOG.md](../../CHANGELOG.md).
+
+## Licence
+
+Tento projekt je licencován pod licencí Apache License 2.0. Podrobnosti najdete v [LICENSE](../../LICENSE).
+
+Ilustrace banneru není součástí této licence. Je dílem své autorky, smí být znovu použita bez úprav, pokud je autorka
+uvedena a uvedení odkazuje na její stránky, a vztahuje se na ni [docs/assets/images/README.md](../assets/images/README.md).
+
+## Ochranné známky
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms a Google Drive jsou ochranné známky
+společnosti Google LLC. Tento projekt je nezávislá knihovna. Není přidružen ke společnosti Google LLC, není jí
+schvalován ani sponzorován a ochranné známky se používají pouze k popisu toho, s čím knihovna pracuje.
diff --git a/docs/readme/README.de.md b/docs/readme/README.de.md
new file mode 100644
index 00000000..a4b48eac
--- /dev/null
+++ b/docs/readme/README.de.md
@@ -0,0 +1,305 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | **Deutsch** | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Diese Übersetzung wurde mit KI-Unterstützung aus [README.md](../../README.md) für Version 2.1.1 erstellt. Maßgeblich ist die englische README; Korrekturen sind willkommen — siehe [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Werkzeuge für Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Werkzeuge für Google Apps Script™](#werkzeuge-für-google-apps-script)
+ - [Überblick](#überblick)
+ - [Wichtigste Merkmale](#wichtigste-merkmale)
+ - [Skills für KI-Agenten](#skills-für-ki-agenten)
+ - [Voraussetzungen](#voraussetzungen)
+ - [Installation](#installation)
+ - [Dokumentation](#dokumentation)
+ - [Anwendungsbeispiele](#anwendungsbeispiele)
+ - [Entwicklung](#entwicklung)
+ - [Skripte](#skripte)
+ - [Tests](#tests)
+ - [Projektstruktur](#projektstruktur)
+ - [Funktionen nach Kategorie](#funktionen-nach-kategorie)
+ - [Mitwirken](#mitwirken)
+ - [Unterstützung](#unterstützung)
+ - [Roadmap](#roadmap)
+ - [Änderungsprotokoll](#änderungsprotokoll)
+ - [Lizenz](#lizenz)
+
+
+## Überblick
+
+**@bootgs/utils** ist eine TypeScript-Bibliothek mit Hilfsfunktionen, die eigens für **Google Apps Script**
+entwickelt wurde. Sie bündelt die Helfer, die jedes GAS-Projekt früher oder später von Hand schreibt — Arbeit mit
+Tabellen und der A1-Notation, Typ- und Wertprüfungen (`isX`/`nonX`/`requireX`), Umwandlungen von Zeichenketten und
+Arrays, typisierte Ausnahmen und mehr — in einem einzigen, gut dokumentierten und vollständig getesteten Paket.
+
+## Wichtigste Merkmale
+
+- **Für Google Apps Script gebaut** — auf die GAS-Laufzeit und ihre Einschränkungen ausgelegt, nicht von einer
+ allgemeinen Node.js-Bibliothek übernommen.
+- **Breite Abdeckung** — Helfer für Tabellen, UI, Netzwerk und das Admin SDK neben allgemeinen Werkzeugen für
+ Zeichenketten, Arrays und Objekte.
+- **TypeScript zuerst** — jede Funktion bringt vollständige Typdefinitionen mit, für Autovervollständigung in der IDE
+ und Sicherheit zur Kompilierzeit.
+- **Getestet** — durch eine Suite von Unit-Tests mit Vitest abgedeckt.
+- **Verlinkte Referenzdokumentation** — jeder in der API verwendete Google-Apps-Script-Typ verweist direkt auf seine
+ offizielle Dokumentation.
+- **Einheitliche Fehlerbehandlung** — eine eigene Hierarchie von Ausnahmeklassen ersetzt ad hoc geworfene Fehler.
+
+## Skills für KI-Agenten
+
+Für Teams, die mit einem KI-Programmieragenten arbeiten (Claude Code, Gemini CLI und andere), stellt das Repository
+[bootgs/skills](https://github.com/bootgs/skills) einen Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) bereit, der diese
+Bibliothek für solche Agenten beschreibt — darunter die Prüfkonvention `isX`/`nonX`/`requireX`, die Helfer für die
+A1-Notation und Tabellenblätter, für Zeichenketten, Zahlen und Arrays, die typisierten Ausnahmen sowie die Helfer für
+HTML, JSON und Pfade.
+
+Installation mit Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Installation mit der CLI `npx skills`, die mehrere Agenten unterstützt:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Nach der Installation wendet der Agent den Skill automatisch an, sobald eine Aufgabe diese Bibliothek betrifft.
+
+## Voraussetzungen
+
+- [Node.js](https://nodejs.org/) v22.14.0 oder neuer
+- [npm](https://www.npmjs.com/) (oder ein anderer Paketmanager für Node, z. B. pnpm)
+
+## Installation
+
+Installieren Sie das Paket über npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Dokumentation
+
+Die vollständige Dokumentation ist unter **** veröffentlicht —
+Anleitungen, Rundgänge durch die einzelnen Module und die komplette Funktionsreferenz. Ihre Quelle liegt in
+[`docs/writerside-de/`](../writerside-de/) und wird bei jedem Push auf `main` neu gebaut.
+
+Eine sinnvolle Lesereihenfolge:
+
+- [Erste Schritte](https://bootgs.github.io/utils/de/getting-started.html)
+- [Konventionen der Prüfungen](https://bootgs.github.io/utils/de/validation-conventions.html) —
+ das Namensschema `isX`/`nonX`/`requireX`/`requireNonX`
+- [Ausnahmebehandlung](https://bootgs.github.io/utils/de/exception-handling.html) — die
+ Klassenhierarchie und wodurch jede Ausnahme ausgelöst wird
+- [Die Apps-Script-Laufzeit](https://bootgs.github.io/utils/de/apps-script-runtime.html) — welche
+ Helfer an einen Google-Dienst gebunden sind und was das für das Testen bedeutet
+
+## Anwendungsbeispiele
+
+### Arbeit mit Tabellen
+
+Mehrere Datenzeilen effizient anhängen:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Werkzeuge für das Admin SDK
+
+Prüfen, ob der aktuelle Benutzer Administratorrechte hat:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### A1-Notation parsen
+
+Komplexe A1-Notationen in strukturierte Objekte zerlegen:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Entwicklung
+
+### Skripte
+
+In `package.json` stehen folgende Skripte zur Verfügung:
+
+| Skript | Beschreibung |
+| :------------------- | :----------------------------------------------------------------------------- |
+| `npm run build` | Leert das Verzeichnis `dist` und kompiliert den TypeScript-Quellcode. |
+| `npm run dev` | Startet Vitest im Watch-Modus. |
+| `npm test` | Führt die gesamte Test-Suite einmal aus. |
+| `npm run type:check` | Prüft die Typen des Projekts, ohne Ausgabedateien zu erzeugen. |
+| `npm run lint` | Prüft den Code mit ESLint. |
+| `npm run lint:fix` | Prüft den Code und behebt automatisch, was sich beheben lässt. |
+| `npm run format` | Prüft die Formatierung mit Prettier. |
+| `npm run format:fix` | Formatiert den Code mit Prettier. |
+| `npm run prepare` | Richtet die Git-Hooks von Husky ein (läuft nach der Installation automatisch). |
+
+### Tests
+
+Das Projekt verwendet [Vitest](https://vitest.dev/) für Unit-Tests.
+
+Die gesamte Suite einmal ausführen:
+
+```bash
+npm test
+```
+
+Oder während der Entwicklung im Watch-Modus:
+
+```bash
+npm run dev
+```
+
+## Projektstruktur
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Funktionen nach Kategorie
+
+Die vollständige Funktionsreferenz ist auf die Dokumentationsseite umgezogen, die aus
+[`docs/writerside-de/`](../writerside-de/) gebaut und bei jedem Push auf `main` veröffentlicht wird:
+
+****
+
+| Abschnitt | Inhalt |
+| :------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- |
+| [Modul Google Apps Script](https://bootgs.github.io/utils/de/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, Netzwerkanfragen und die eingebauten UI-Klassen |
+| [Basis-Werkzeuge](https://bootgs.github.io/utils/de/reference-base.html) | Typ- und Wertprüfungen, Arbeit mit Zeichenketten, Arrays und Objekten, Umgang mit JSON und HTML |
+| [Ausnahmen](https://bootgs.github.io/utils/de/reference-exception.html) | Die typisierten Ausnahmeklassen und wodurch jede von ihnen ausgelöst wird |
+| [Modul `path`](https://bootgs.github.io/utils/de/reference-path.html) | Dateipfade und URLs |
+| [Abstrakte Klassen und Schnittstellen](https://bootgs.github.io/utils/de/reference-abstracts.html) | Gemeinsame Bausteine |
+
+Neben der Referenz enthält die Seite die Anleitungen, für die in den Tabellen kein Platz war: Die
+[Konventionen der Prüfungen](https://bootgs.github.io/utils/de/validation-conventions.html)
+erklären das Schema `isX`/`nonX`/`requireX`/`requireNonX` an einer Stelle, die
+[Ausnahmebehandlung](https://bootgs.github.io/utils/de/exception-handling.html) legt die
+Klassenhierarchie dar, und [die Apps-Script-Laufzeit](https://bootgs.github.io/utils/de/apps-script-runtime.html)
+behandelt, welche Helfer an einen Google-Dienst gebunden sind, was das kostet und was es für das Testen bedeutet.
+
+## Mitwirken
+
+Beiträge sind willkommen. Die vollständige Anleitung steht in [CONTRIBUTING.md](../../CONTRIBUTING.md). Kurz gefasst:
+
+1. Forken Sie das Repository und legen Sie einen Branch für Ihr Feature oder Ihren Bugfix an.
+2. Fügen Sie Tests hinzu oder passen Sie sie an, sodass Ihre Änderungen abgedeckt sind.
+3. Führen Sie vor dem Commit `npm run lint` und `npm run format` aus.
+4. Bearbeiten Sie `CHANGELOG.md` nicht von Hand — die Datei wird automatisch von [release-please](https://github.com/googleapis/release-please) erzeugt.
+5. Öffnen Sie einen Pull Request, der beschreibt, was sich geändert hat und warum.
+
+Halten Sie sich an den bestehenden Codestil und die Namenskonventionen. Die Regeln der Community stehen in
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Unterstützung
+
+- Für Fehlermeldungen oder Feature-Wünsche suchen oder eröffnen Sie ein
+ [Issue](https://github.com/bootgs/utils/issues) auf GitHub.
+- Die jüngsten Änderungen finden Sie im [Änderungsprotokoll](../../CHANGELOG.md).
+- Um eine Sicherheitslücke zu melden, folgen Sie der [Sicherheitsrichtlinie](../../SECURITY.md), statt ein öffentliches
+ Issue zu eröffnen.
+- Die weitere Entwicklung können Sie über [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov) unterstützen.
+
+## Roadmap
+
+Was geplant, in Arbeit oder erledigt ist, steht auf dem [Projektboard](https://github.com/users/MaksymStoianov/projects/2/views/2),
+das direkt aus dem Issue-Tracker entsteht. Ein separates Roadmap-Dokument, das davon abweichen könnte, gibt es
+nicht: Um etwas vorzuschlagen, eröffnen Sie ein [Issue](https://github.com/bootgs/utils/issues).
+
+## Änderungsprotokoll
+
+Eine ausführliche Liste der Änderungen nach Version finden Sie in [CHANGELOG.md](../../CHANGELOG.md).
+
+## Lizenz
+
+Dieses Projekt steht unter der Apache License 2.0. Einzelheiten finden Sie in [LICENSE](../../LICENSE).
+
+Das Bannerbild fällt nicht unter diese Lizenz. Es ist das Werk seiner Urheberin, darf unverändert weiterverwendet
+werden, sofern die Urheberin genannt und die Nennung verlinkt wird, und ist in
+[docs/assets/images/README.md](../assets/images/README.md) geregelt.
+
+## Marken
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms und Google Drive sind Marken der
+Google LLC. Dieses Projekt ist eine unabhängige Bibliothek. Es ist weder mit der Google LLC verbunden noch von ihr
+unterstützt oder gesponsert, und die Marken werden nur verwendet, um zu beschreiben, womit die Bibliothek arbeitet.
diff --git a/docs/readme/README.es.md b/docs/readme/README.es.md
new file mode 100644
index 00000000..61cee187
--- /dev/null
+++ b/docs/readme/README.es.md
@@ -0,0 +1,306 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | **Español** | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Esta traducción se hizo con ayuda de IA a partir de [README.md](../../README.md) para la versión 2.1.1. La versión de referencia es el README en inglés; las correcciones son bienvenidas — consulta [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Utilidades para Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Utilidades para Google Apps Script™](#utilidades-para-google-apps-script)
+ - [Descripción general](#descripción-general)
+ - [Características principales](#características-principales)
+ - [Skills para agentes de IA](#skills-para-agentes-de-ia)
+ - [Requisitos](#requisitos)
+ - [Instalación](#instalación)
+ - [Documentación](#documentación)
+ - [Ejemplos de uso](#ejemplos-de-uso)
+ - [Desarrollo](#desarrollo)
+ - [Scripts](#scripts)
+ - [Pruebas](#pruebas)
+ - [Estructura del proyecto](#estructura-del-proyecto)
+ - [Funciones por categoría](#funciones-por-categoría)
+ - [Cómo contribuir](#cómo-contribuir)
+ - [Soporte](#soporte)
+ - [Hoja de ruta](#hoja-de-ruta)
+ - [Registro de cambios](#registro-de-cambios)
+ - [Licencia](#licencia)
+
+
+## Descripción general
+
+**@bootgs/utils** es una biblioteca de utilidades en TypeScript creada específicamente para **Google Apps
+Script**. Reúne las funciones auxiliares que todo proyecto de GAS acaba escribiendo a mano — manipulación de hojas de
+cálculo y de la notación A1, validación de tipos y valores (`isX`/`nonX`/`requireX`), transformaciones de cadenas y
+arrays, excepciones tipadas y más — en un único paquete bien documentado y completamente probado.
+
+## Características principales
+
+- **Hecha para Google Apps Script** — diseñada en torno al entorno de ejecución de GAS y sus limitaciones, no
+ adaptada de una biblioteca genérica de Node.js.
+- **Amplia cobertura** — funciones para hojas de cálculo, UI, red y Admin SDK junto a utilidades de uso general para
+ cadenas, arrays y objetos.
+- **TypeScript primero** — cada función incluye definiciones de tipos completas para el autocompletado en el IDE y la
+ seguridad en tiempo de compilación.
+- **Probada** — cubierta por una suite de pruebas unitarias con Vitest.
+- **Documentación de referencia enlazada** — cada tipo de Google Apps Script usado en la API enlaza directamente con
+ su documentación oficial.
+- **Manejo de errores coherente** — una jerarquía propia de clases de excepción sustituye a los errores lanzados de
+ forma improvisada.
+
+## Skills para agentes de IA
+
+Para los equipos que usan un agente de programación con IA (Claude Code, Gemini CLI y otros), el repositorio
+[bootgs/skills](https://github.com/bootgs/skills) ofrece un Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) que documenta esta
+biblioteca para dichos agentes, incluida la convención de validación `isX`/`nonX`/`requireX`, las funciones para la
+notación A1 y las hojas, para cadenas, números y arrays, las excepciones tipadas y las funciones para HTML, JSON y
+rutas.
+
+Instalación con Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Instalación con la CLI `npx skills`, que admite varios agentes:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Una vez instalado, el agente aplica el skill automáticamente cuando una tarea tiene que ver con esta biblioteca.
+
+## Requisitos
+
+- [Node.js](https://nodejs.org/) v22.14.0 o posterior
+- [npm](https://www.npmjs.com/) (u otro gestor de paquetes de Node, p. ej. pnpm)
+
+## Instalación
+
+Instala el paquete con npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Documentación
+
+La documentación completa está publicada en **** (en inglés):
+guías, recorridos por cada módulo y la referencia completa de funciones. Su código fuente está en
+[`docs/writerside/`](../writerside/) y se reconstruye con cada push a `main`.
+
+Un buen orden de lectura:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — primeros pasos
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — el
+ esquema de nombres `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — la jerarquía de
+ clases y qué provoca cada excepción
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — qué
+ funciones dependen de un servicio de Google y qué implica eso para las pruebas
+
+## Ejemplos de uso
+
+### Trabajar con hojas
+
+Añadir varias filas de datos de forma eficiente:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Utilidades de Admin SDK
+
+Comprobar si el usuario actual tiene privilegios de administrador:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Análisis de la notación A1
+
+Analizar notaciones A1 complejas y convertirlas en objetos estructurados:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Desarrollo
+
+### Scripts
+
+En `package.json` están disponibles los siguientes scripts:
+
+| Script | Descripción |
+| :------------------- | :------------------------------------------------------------------------------------ |
+| `npm run build` | Limpia el directorio `dist` y compila el código fuente TypeScript. |
+| `npm run dev` | Inicia Vitest en modo observación. |
+| `npm test` | Ejecuta una vez la suite de pruebas completa. |
+| `npm run type:check` | Comprueba los tipos del proyecto sin generar salida. |
+| `npm run lint` | Analiza el código con ESLint. |
+| `npm run lint:fix` | Analiza el código y corrige automáticamente lo que puede. |
+| `npm run format` | Comprueba el formato con Prettier. |
+| `npm run format:fix` | Formatea el código con Prettier. |
+| `npm run prepare` | Configura los hooks de Git de Husky (se ejecuta automáticamente tras la instalación). |
+
+### Pruebas
+
+El proyecto usa [Vitest](https://vitest.dev/) para las pruebas unitarias.
+
+Ejecutar la suite completa una vez:
+
+```bash
+npm test
+```
+
+O ejecutarla en modo observación mientras desarrollas:
+
+```bash
+npm run dev
+```
+
+## Estructura del proyecto
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Funciones por categoría
+
+La referencia completa de funciones se ha trasladado al sitio de documentación, que se genera a partir de
+[`docs/writerside/`](../writerside/) y se publica con cada push a `main`:
+
+****
+
+| Sección | Contenido |
+| :------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, peticiones de red y las clases de UI integradas |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Comprobación de tipos y validación, manipulación de cadenas, arrays y objetos, tratamiento de JSON y HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | Las clases de excepción tipadas y qué provoca cada una |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Rutas de archivos y URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Piezas compartidas |
+
+Además de la referencia, el sitio incluye las guías que no cabían en las tablas:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) explica el
+esquema `isX`/`nonX`/`requireX`/`requireNonX` en un solo lugar,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) expone la jerarquía
+de clases y [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+explica qué funciones dependen de un servicio de Google, qué cuesta eso y qué implica para las pruebas.
+
+## Cómo contribuir
+
+Las contribuciones son bienvenidas. Consulta la guía completa en [CONTRIBUTING.md](../../CONTRIBUTING.md). En resumen:
+
+1. Haz un fork del repositorio y crea una rama para tu funcionalidad o corrección.
+2. Añade o actualiza las pruebas que cubren tus cambios.
+3. Ejecuta `npm run lint` y `npm run format` antes de hacer commit.
+4. No edites `CHANGELOG.md` a mano: lo genera automáticamente [release-please](https://github.com/googleapis/release-please).
+5. Abre una pull request que describa qué ha cambiado y por qué.
+
+Sigue el estilo de código y las convenciones de nombres existentes. Las normas de la comunidad están en
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Soporte
+
+- Para errores o solicitudes de funcionalidades, busca o abre una
+ [issue](https://github.com/bootgs/utils/issues) en GitHub.
+- Para los cambios recientes, consulta el [registro de cambios](../../CHANGELOG.md).
+- Para informar de una vulnerabilidad de seguridad, sigue la [política de seguridad](../../SECURITY.md) en lugar de abrir
+ una issue pública.
+- Para apoyar el desarrollo continuo, consulta [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Hoja de ruta
+
+Lo planificado, en curso o terminado está en el [tablero del proyecto](https://github.com/users/MaksymStoianov/projects/2/views/2),
+que se genera a partir del propio gestor de issues. No hay un documento de hoja de ruta aparte que pueda quedar
+desfasado: para proponer algo, abre una [issue](https://github.com/bootgs/utils/issues).
+
+## Registro de cambios
+
+Para ver la lista detallada de cambios por versión, consulta [CHANGELOG.md](../../CHANGELOG.md).
+
+## Licencia
+
+Este proyecto se distribuye bajo la licencia Apache License 2.0. Consulta [LICENSE](../../LICENSE) para más detalles.
+
+La ilustración del banner no forma parte de esa licencia. Es obra de su autora, puede reutilizarse sin
+modificaciones siempre que se cite a la autora con un enlace, y se rige por
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Marcas comerciales
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms y Google Drive son marcas comerciales de
+Google LLC. Este proyecto es una biblioteca independiente. No está afiliado a Google LLC ni cuenta con su respaldo o
+patrocinio, y las marcas se usan únicamente para describir con qué funciona la biblioteca.
diff --git a/docs/readme/README.fr.md b/docs/readme/README.fr.md
new file mode 100644
index 00000000..f3a4c5d6
--- /dev/null
+++ b/docs/readme/README.fr.md
@@ -0,0 +1,307 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | **Français** | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Cette traduction a été réalisée avec l'aide de l'IA à partir de [README.md](../../README.md) pour la version 2.1.1. Le README anglais fait foi ; les corrections sont les bienvenues — voir [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Utilitaires pour Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Utilitaires pour Google Apps Script™](#utilitaires-pour-google-apps-script)
+ - [Présentation](#présentation)
+ - [Fonctionnalités clés](#fonctionnalités-clés)
+ - [Skills pour agents IA](#skills-pour-agents-ia)
+ - [Prérequis](#prérequis)
+ - [Installation](#installation)
+ - [Documentation](#documentation)
+ - [Exemples d'utilisation](#exemples-dutilisation)
+ - [Développement](#développement)
+ - [Scripts](#scripts)
+ - [Tests](#tests)
+ - [Structure du projet](#structure-du-projet)
+ - [Fonctions par catégorie](#fonctions-par-catégorie)
+ - [Contribuer](#contribuer)
+ - [Assistance](#assistance)
+ - [Feuille de route](#feuille-de-route)
+ - [Journal des modifications](#journal-des-modifications)
+ - [Licence](#licence)
+
+
+## Présentation
+
+**@bootgs/utils** est une bibliothèque d'utilitaires en TypeScript conçue spécialement pour **Google Apps
+Script**. Elle réunit les fonctions d'aide que chaque projet GAS finit par écrire à la main — manipulation des
+feuilles de calcul et de la notation A1, validation des types et des valeurs (`isX`/`nonX`/`requireX`),
+transformations de chaînes et de tableaux, exceptions typées, et plus encore — dans un seul paquet bien documenté et
+entièrement testé.
+
+## Fonctionnalités clés
+
+- **Conçue pour Google Apps Script** — pensée autour de l'environnement d'exécution GAS et de ses contraintes, et non
+ adaptée d'une bibliothèque Node.js générique.
+- **Large couverture** — des fonctions pour les feuilles de calcul, l'UI, le réseau et l'Admin SDK, à côté
+ d'utilitaires généraux pour les chaînes, les tableaux et les objets.
+- **TypeScript d'abord** — chaque fonction est livrée avec des définitions de types complètes pour l'autocomplétion
+ dans l'IDE et la sûreté à la compilation.
+- **Testée** — couverte par une suite de tests unitaires Vitest.
+- **Documentation de référence liée** — chaque type Google Apps Script utilisé dans l'API renvoie directement à sa
+ documentation officielle.
+- **Gestion des erreurs cohérente** — une hiérarchie dédiée de classes d'exception remplace les erreurs levées au cas
+ par cas.
+
+## Skills pour agents IA
+
+Pour les équipes qui utilisent un agent de programmation IA (Claude Code, Gemini CLI et d'autres), le dépôt
+[bootgs/skills](https://github.com/bootgs/skills) fournit un Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) qui documente cette
+bibliothèque pour ces agents : la convention de validation `isX`/`nonX`/`requireX`, les fonctions pour la notation A1
+et les feuilles, pour les chaînes, les nombres et les tableaux, les exceptions typées, ainsi que les fonctions HTML,
+JSON et de chemins.
+
+Installation avec Claude Code :
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Installation avec la CLI `npx skills`, qui prend en charge plusieurs agents :
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Une fois installé, l'agent applique le skill automatiquement dès qu'une tâche concerne cette bibliothèque.
+
+## Prérequis
+
+- [Node.js](https://nodejs.org/) v22.14.0 ou ultérieur
+- [npm](https://www.npmjs.com/) (ou un autre gestionnaire de paquets Node, par exemple pnpm)
+
+## Installation
+
+Installez le paquet via npm :
+
+```bash
+npm install @bootgs/utils
+```
+
+## Documentation
+
+La documentation complète est publiée sur **** — guides,
+présentations de chaque module et référence complète des fonctions. Sa source se trouve dans
+[`docs/writerside-fr/`](../writerside-fr/) et est reconstruite à chaque push sur `main`.
+
+Un bon ordre de lecture :
+
+- [Premiers pas](https://bootgs.github.io/utils/fr/getting-started.html)
+- [Conventions de validation](https://bootgs.github.io/utils/fr/validation-conventions.html) —
+ le schéma de noms `isX`/`nonX`/`requireX`/`requireNonX`
+- [Gestion des exceptions](https://bootgs.github.io/utils/fr/exception-handling.html) — la
+ hiérarchie des classes et ce qui déclenche chacune d'elles
+- [L'environnement Apps Script](https://bootgs.github.io/utils/fr/apps-script-runtime.html) —
+ quelles fonctions sont liées à un service Google, et ce que cela implique pour les tests
+
+## Exemples d'utilisation
+
+### Travailler avec les feuilles
+
+Ajouter efficacement plusieurs lignes de données :
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Utilitaires Admin SDK
+
+Vérifier si l'utilisateur actuel dispose des droits d'administrateur :
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Analyse de la notation A1
+
+Analyser des notations A1 complexes en objets structurés :
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Développement
+
+### Scripts
+
+Les scripts suivants sont disponibles dans `package.json` :
+
+| Script | Description |
+| :------------------- | :-------------------------------------------------------------------------------- |
+| `npm run build` | Vide le répertoire `dist` et compile les sources TypeScript. |
+| `npm run dev` | Lance Vitest en mode surveillance. |
+| `npm test` | Exécute une fois la suite de tests complète. |
+| `npm run type:check` | Vérifie les types du projet sans générer de sortie. |
+| `npm run lint` | Analyse le code avec ESLint. |
+| `npm run lint:fix` | Analyse le code et corrige automatiquement ce qui peut l'être. |
+| `npm run format` | Vérifie la mise en forme avec Prettier. |
+| `npm run format:fix` | Met en forme le code avec Prettier. |
+| `npm run prepare` | Installe les hooks Git de Husky (s'exécute automatiquement après l'installation). |
+
+### Tests
+
+Le projet utilise [Vitest](https://vitest.dev/) pour les tests unitaires.
+
+Exécuter une fois la suite complète :
+
+```bash
+npm test
+```
+
+Ou la lancer en mode surveillance pendant le développement :
+
+```bash
+npm run dev
+```
+
+## Structure du projet
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Fonctions par catégorie
+
+La référence complète des fonctions a été déplacée sur le site de documentation, construit à partir de
+[`docs/writerside-fr/`](../writerside-fr/) et publié à chaque push sur `main` :
+
+****
+
+| Section | Contenu |
+| :--------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- |
+| [Module Google Apps Script](https://bootgs.github.io/utils/fr/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, requêtes réseau et classes d'UI intégrées |
+| [Utilitaires de base](https://bootgs.github.io/utils/fr/reference-base.html) | Vérification des types et validation, manipulation de chaînes, de tableaux et d'objets, traitement JSON et HTML |
+| [Exceptions](https://bootgs.github.io/utils/fr/reference-exception.html) | Les classes d'exception typées et ce qui déclenche chacune d'elles |
+| [Module `path`](https://bootgs.github.io/utils/fr/reference-path.html) | Chemins de fichiers et URL |
+| [Classes abstraites et interfaces](https://bootgs.github.io/utils/fr/reference-abstracts.html) | Briques de base partagées |
+
+En plus de la référence, le site propose les guides que les tableaux ne pouvaient pas contenir : les
+[conventions de validation](https://bootgs.github.io/utils/fr/validation-conventions.html)
+expliquent le schéma `isX`/`nonX`/`requireX`/`requireNonX` en un seul endroit, la
+[gestion des exceptions](https://bootgs.github.io/utils/fr/exception-handling.html) présente la
+hiérarchie des classes, et [l'environnement Apps Script](https://bootgs.github.io/utils/fr/apps-script-runtime.html)
+indique quelles fonctions sont liées à un service Google, ce que cela coûte et ce que cela implique pour les tests.
+
+## Contribuer
+
+Les contributions sont les bienvenues. Le guide complet se trouve dans [CONTRIBUTING.md](../../CONTRIBUTING.md). En résumé :
+
+1. Forkez le dépôt et créez une branche pour votre fonctionnalité ou votre correctif.
+2. Ajoutez ou mettez à jour les tests qui couvrent vos modifications.
+3. Lancez `npm run lint` et `npm run format` avant de committer.
+4. Ne modifiez pas `CHANGELOG.md` à la main — il est généré automatiquement par [release-please](https://github.com/googleapis/release-please).
+5. Ouvrez une pull request qui décrit ce qui a changé et pourquoi.
+
+Respectez le style de code et les conventions de nommage existants. Les règles de la communauté se trouvent dans
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Assistance
+
+- Pour signaler un bug ou proposer une fonctionnalité, recherchez ou ouvrez une
+ [issue](https://github.com/bootgs/utils/issues) sur GitHub.
+- Pour les changements récents, consultez le [journal des modifications](../../CHANGELOG.md).
+- Pour signaler une vulnérabilité, suivez la [politique de sécurité](../../SECURITY.md) plutôt que d'ouvrir une issue
+ publique.
+- Pour soutenir le développement, voir [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Feuille de route
+
+Ce qui est prévu, en cours ou terminé figure sur le [tableau du projet](https://github.com/users/MaksymStoianov/projects/2/views/2),
+construit à partir du suivi des issues lui-même. Il n'existe pas de document de feuille de route séparé qui pourrait
+s'en écarter : pour proposer quelque chose, ouvrez une [issue](https://github.com/bootgs/utils/issues).
+
+## Journal des modifications
+
+Pour la liste détaillée des changements par version, voir [CHANGELOG.md](../../CHANGELOG.md).
+
+## Licence
+
+Ce projet est distribué sous la licence Apache License 2.0. Voir [LICENSE](../../LICENSE) pour plus de détails.
+
+L'illustration de la bannière n'est pas couverte par cette licence. Elle est l'œuvre de son autrice, peut être
+réutilisée sans modification à condition de créditer l'autrice avec un lien, et relève de
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Marques
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms et Google Drive sont des marques de
+Google LLC. Ce projet est une bibliothèque indépendante. Il n'est ni affilié à Google LLC, ni approuvé ou sponsorisé
+par celle-ci, et les marques ne sont utilisées que pour décrire ce avec quoi la bibliothèque fonctionne.
diff --git a/docs/readme/README.id.md b/docs/readme/README.id.md
new file mode 100644
index 00000000..8a256bd7
--- /dev/null
+++ b/docs/readme/README.id.md
@@ -0,0 +1,303 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | **Bahasa Indonesia** | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Terjemahan ini dibuat dengan bantuan AI dari [README.md](../../README.md) untuk versi 2.1.1. Versi acuannya adalah README berbahasa Inggris; koreksi sangat kami harapkan — lihat [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Utilitas untuk Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Utilitas untuk Google Apps Script™](#utilitas-untuk-google-apps-script)
+ - [Ikhtisar](#ikhtisar)
+ - [Fitur utama](#fitur-utama)
+ - [Skill untuk agen AI](#skill-untuk-agen-ai)
+ - [Persyaratan](#persyaratan)
+ - [Instalasi](#instalasi)
+ - [Dokumentasi](#dokumentasi)
+ - [Contoh penggunaan](#contoh-penggunaan)
+ - [Pengembangan](#pengembangan)
+ - [Skrip](#skrip)
+ - [Pengujian](#pengujian)
+ - [Struktur proyek](#struktur-proyek)
+ - [Fungsi per kategori](#fungsi-per-kategori)
+ - [Berkontribusi](#berkontribusi)
+ - [Dukungan](#dukungan)
+ - [Peta jalan](#peta-jalan)
+ - [Catatan perubahan](#catatan-perubahan)
+ - [Lisensi](#lisensi)
+
+
+## Ikhtisar
+
+**@bootgs/utils** adalah pustaka utilitas TypeScript yang dibuat khusus untuk **Google Apps Script**. Pustaka ini
+mengumpulkan fungsi bantu yang pada akhirnya selalu ditulis manual di setiap proyek GAS — manipulasi spreadsheet dan
+notasi A1, validasi tipe dan nilai (`isX`/`nonX`/`requireX`), transformasi string dan array, exception bertipe, dan
+lainnya — dalam satu paket yang terdokumentasi dengan baik dan teruji sepenuhnya.
+
+## Fitur utama
+
+- **Dibuat untuk Google Apps Script** — dirancang di sekitar runtime GAS beserta batasannya, bukan diadaptasi dari
+ pustaka Node.js generik.
+- **Cakupan utilitas yang luas** — fungsi bantu untuk spreadsheet, UI, jaringan, dan Admin SDK, ditambah utilitas
+ serbaguna untuk string, array, dan objek.
+- **Mengutamakan TypeScript** — setiap fungsi dilengkapi definisi tipe lengkap untuk pelengkapan otomatis di IDE dan
+ keamanan saat kompilasi.
+- **Teruji** — dicakup oleh rangkaian unit test Vitest.
+- **Dokumentasi referensi bertaut** — setiap tipe Google Apps Script yang dipakai di API tertaut langsung ke
+ dokumentasi resminya.
+- **Penanganan error yang konsisten** — hierarki kelas exception khusus menggantikan error yang dilempar secara asal.
+
+## Skill untuk agen AI
+
+Bagi tim yang memakai agen pemrograman AI (Claude Code, Gemini CLI, dan lainnya), repositori
+[bootgs/skills](https://github.com/bootgs/skills) menyediakan Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) yang mendokumentasikan
+pustaka ini untuk agen tersebut, termasuk konvensi validasi `isX`/`nonX`/`requireX`, fungsi bantu untuk notasi A1 dan
+sheet, fungsi bantu untuk string, angka, dan array, exception bertipe, serta fungsi bantu untuk HTML, JSON, dan path.
+
+Instal dengan Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Instal dengan CLI `npx skills`, yang mendukung berbagai agen:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Setelah terinstal, agen menerapkan skill ini secara otomatis ketika sebuah tugas melibatkan pustaka ini.
+
+## Persyaratan
+
+- [Node.js](https://nodejs.org/) v22.14.0 atau yang lebih baru
+- [npm](https://www.npmjs.com/) (atau package manager Node lain, misalnya pnpm)
+
+## Instalasi
+
+Instal paket melalui npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Dokumentasi
+
+Dokumentasi lengkap diterbitkan di **** (dalam bahasa Inggris): panduan, penjelasan
+per modul, dan referensi fungsi selengkapnya. Sumbernya ada di [`docs/writerside/`](../writerside/) dan dibangun
+ulang pada setiap push ke `main`.
+
+Urutan membaca yang disarankan:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — langkah pertama
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — skema penamaan
+ `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — hierarki kelas dan apa yang memicu
+ masing-masing exception
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — fungsi bantu mana yang terikat
+ pada layanan Google, dan apa artinya bagi pengujian
+
+## Contoh penggunaan
+
+### Bekerja dengan sheet
+
+Menambahkan beberapa baris data sekaligus secara efisien:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Utilitas Admin SDK
+
+Memeriksa apakah pengguna saat ini memiliki hak administrator:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Parsing notasi A1
+
+Mengurai notasi A1 yang kompleks menjadi objek terstruktur:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Pengembangan
+
+### Skrip
+
+Skrip berikut tersedia di `package.json`:
+
+| Skrip | Deskripsi |
+| :------------------- | :--------------------------------------------------------------------- |
+| `npm run build` | Membersihkan direktori `dist` dan mengompilasi kode sumber TypeScript. |
+| `npm run dev` | Menjalankan Vitest dalam mode watch. |
+| `npm test` | Menjalankan seluruh rangkaian pengujian satu kali. |
+| `npm run type:check` | Memeriksa tipe proyek tanpa menghasilkan output. |
+| `npm run lint` | Memeriksa kode dengan ESLint. |
+| `npm run lint:fix` | Memeriksa kode dan memperbaiki otomatis apa yang bisa diperbaiki. |
+| `npm run format` | Memeriksa format dengan Prettier. |
+| `npm run format:fix` | Memformat kode dengan Prettier. |
+| `npm run prepare` | Menyiapkan git hook Husky (berjalan otomatis setelah instalasi). |
+
+### Pengujian
+
+Proyek ini menggunakan [Vitest](https://vitest.dev/) untuk unit test.
+
+Jalankan seluruh rangkaian pengujian satu kali:
+
+```bash
+npm test
+```
+
+Atau jalankan dalam mode watch selama pengembangan:
+
+```bash
+npm run dev
+```
+
+## Struktur proyek
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Fungsi per kategori
+
+Referensi fungsi selengkapnya telah dipindahkan ke situs dokumentasi, yang dibangun dari
+[`docs/writerside/`](../writerside/) dan diterbitkan pada setiap push ke `main`:
+
+****
+
+| Bagian | Cakupan |
+| :------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, permintaan jaringan, dan kelas UI bawaan |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Pemeriksaan tipe dan validasi, manipulasi string, array, dan objek, penanganan JSON dan HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | Kelas exception bertipe dan apa yang memicu masing-masing |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Path file dan URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Komponen dasar bersama |
+
+Selain referensi, situs ini juga memuat panduan yang tidak muat di tabel:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) menjelaskan skema
+`isX`/`nonX`/`requireX`/`requireNonX` di satu tempat,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) memaparkan hierarki kelas, dan
+[the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) membahas fungsi bantu mana yang
+terikat pada layanan Google, apa konsekuensinya, dan apa artinya bagi pengujian.
+
+## Berkontribusi
+
+Kontribusi sangat kami sambut. Panduan lengkapnya ada di [CONTRIBUTING.md](../../CONTRIBUTING.md). Ringkasnya:
+
+1. Fork repositori dan buat branch untuk fitur atau perbaikan bug Anda.
+2. Tambahkan atau perbarui pengujian yang mencakup perubahan Anda.
+3. Jalankan `npm run lint` dan `npm run format` sebelum melakukan commit.
+4. Jangan mengedit `CHANGELOG.md` secara manual — file ini dibuat otomatis oleh [release-please](https://github.com/googleapis/release-please).
+5. Buka pull request yang menjelaskan apa yang berubah dan alasannya.
+
+Ikuti gaya kode dan konvensi penamaan yang sudah ada. Pedoman komunitas ada di [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Dukungan
+
+- Untuk bug atau permintaan fitur, cari atau buka [issue](https://github.com/bootgs/utils/issues) di GitHub.
+- Untuk perubahan terbaru, lihat [catatan perubahan](../../CHANGELOG.md).
+- Untuk melaporkan kerentanan keamanan, ikuti [kebijakan keamanan](../../SECURITY.md) alih-alih membuka issue publik.
+- Untuk mendukung pengembangan yang berkelanjutan, lihat [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Peta jalan
+
+Apa yang direncanakan, sedang dikerjakan, atau sudah selesai ada di
+[papan proyek](https://github.com/users/MaksymStoianov/projects/2/views/2), yang dibangun langsung dari issue tracker.
+Tidak ada dokumen peta jalan terpisah yang bisa tertinggal darinya: untuk mengusulkan sesuatu, buka
+[issue](https://github.com/bootgs/utils/issues).
+
+## Catatan perubahan
+
+Untuk daftar perubahan per versi secara terperinci, lihat [CHANGELOG.md](../../CHANGELOG.md).
+
+## Lisensi
+
+Proyek ini dilisensikan di bawah Apache License 2.0. Lihat [LICENSE](../../LICENSE) untuk detailnya.
+
+Karya seni banner tidak termasuk dalam lisensi tersebut. Karya ini milik pembuatnya, boleh digunakan ulang tanpa
+diubah dengan mencantumkan nama pembuat beserta tautannya, dan diatur oleh
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Merek dagang
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms, dan Google Drive adalah merek dagang
+Google LLC. Proyek ini adalah pustaka independen. Proyek ini tidak berafiliasi dengan, tidak didukung, dan tidak
+disponsori oleh Google LLC, dan merek dagang tersebut digunakan semata-mata untuk menjelaskan dengan apa pustaka ini
+bekerja.
diff --git a/docs/readme/README.it.md b/docs/readme/README.it.md
new file mode 100644
index 00000000..85817a58
--- /dev/null
+++ b/docs/readme/README.it.md
@@ -0,0 +1,305 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | **Italiano** | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Questa traduzione è stata realizzata con l'aiuto dell'IA a partire da [README.md](../../README.md) per la versione 2.1.1. La versione di riferimento è il README in inglese; le correzioni sono benvenute — consulta [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Utility per Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Utility per Google Apps Script™](#utility-per-google-apps-script)
+ - [Panoramica](#panoramica)
+ - [Funzionalità principali](#funzionalità-principali)
+ - [Skill per agenti IA](#skill-per-agenti-ia)
+ - [Requisiti](#requisiti)
+ - [Installazione](#installazione)
+ - [Documentazione](#documentazione)
+ - [Esempi di utilizzo](#esempi-di-utilizzo)
+ - [Sviluppo](#sviluppo)
+ - [Script](#script)
+ - [Test](#test)
+ - [Struttura del progetto](#struttura-del-progetto)
+ - [Funzioni per categoria](#funzioni-per-categoria)
+ - [Come contribuire](#come-contribuire)
+ - [Supporto](#supporto)
+ - [Roadmap](#roadmap)
+ - [Registro delle modifiche](#registro-delle-modifiche)
+ - [Licenza](#licenza)
+
+
+## Panoramica
+
+**@bootgs/utils** è una libreria di utility in TypeScript pensata appositamente per **Google Apps Script**. Riunisce
+le funzioni di supporto che ogni progetto GAS finisce per scrivere a mano — manipolazione dei fogli di calcolo e della
+notazione A1, validazione di tipi e valori (`isX`/`nonX`/`requireX`), trasformazioni di stringhe e array, eccezioni
+tipizzate e altro ancora — in un unico pacchetto ben documentato e interamente testato.
+
+## Funzionalità principali
+
+- **Pensata per Google Apps Script** — progettata attorno al runtime GAS e ai suoi vincoli, non adattata da una
+ libreria Node.js generica.
+- **Ampia copertura** — funzioni per fogli di calcolo, UI, rete e Admin SDK accanto a utility di uso generale per
+ stringhe, array e oggetti.
+- **TypeScript prima di tutto** — ogni funzione include definizioni di tipo complete per l'autocompletamento nell'IDE
+ e la sicurezza in fase di compilazione.
+- **Testata** — coperta da una suite di test unitari con Vitest.
+- **Documentazione di riferimento collegata** — ogni tipo di Google Apps Script usato nell'API rimanda direttamente
+ alla relativa documentazione ufficiale.
+- **Gestione coerente degli errori** — una gerarchia dedicata di classi di eccezione sostituisce gli errori lanciati
+ in modo estemporaneo.
+
+## Skill per agenti IA
+
+Per i team che usano un agente di programmazione basato sull'IA (Claude Code, Gemini CLI e altri), il repository
+[bootgs/skills](https://github.com/bootgs/skills) offre un Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) che documenta questa
+libreria per tali agenti, compresa la convenzione di validazione `isX`/`nonX`/`requireX`, le funzioni per la
+notazione A1 e i fogli, per stringhe, numeri e array, le eccezioni tipizzate e le funzioni per HTML, JSON e percorsi.
+
+Installazione con Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Installazione con la CLI `npx skills`, che supporta più agenti:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Una volta installato, l'agente applica lo skill automaticamente quando un'attività riguarda questa libreria.
+
+## Requisiti
+
+- [Node.js](https://nodejs.org/) v22.14.0 o successiva
+- [npm](https://www.npmjs.com/) (o un altro gestore di pacchetti per Node, ad es. pnpm)
+
+## Installazione
+
+Installa il pacchetto tramite npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Documentazione
+
+La documentazione completa è pubblicata su **** (in inglese):
+guide, percorsi dedicati a ogni modulo e il riferimento completo delle funzioni. Il suo sorgente si trova in
+[`docs/writerside/`](../writerside/) e viene ricostruito a ogni push su `main`.
+
+Un buon ordine di lettura:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — primi passi
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — lo
+ schema di denominazione `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — la gerarchia
+ delle classi e cosa solleva ciascuna eccezione
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — quali
+ funzioni sono legate a un servizio Google e cosa comporta questo per i test
+
+## Esempi di utilizzo
+
+### Lavorare con i fogli
+
+Aggiungere più righe di dati in modo efficiente:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Utility per Admin SDK
+
+Verificare se l'utente corrente ha privilegi di amministratore:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Analisi della notazione A1
+
+Analizzare notazioni A1 complesse e convertirle in oggetti strutturati:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Sviluppo
+
+### Script
+
+In `package.json` sono disponibili i seguenti script:
+
+| Script | Descrizione |
+| :------------------- | :------------------------------------------------------------------------------------- |
+| `npm run build` | Svuota la directory `dist` e compila il sorgente TypeScript. |
+| `npm run dev` | Avvia Vitest in modalità watch. |
+| `npm test` | Esegue una volta l'intera suite di test. |
+| `npm run type:check` | Controlla i tipi del progetto senza generare output. |
+| `npm run lint` | Analizza il codice con ESLint. |
+| `npm run lint:fix` | Analizza il codice e corregge automaticamente ciò che può. |
+| `npm run format` | Controlla la formattazione con Prettier. |
+| `npm run format:fix` | Formatta il codice con Prettier. |
+| `npm run prepare` | Configura gli hook Git di Husky (viene eseguito automaticamente dopo l'installazione). |
+
+### Test
+
+Il progetto usa [Vitest](https://vitest.dev/) per i test unitari.
+
+Eseguire l'intera suite una volta:
+
+```bash
+npm test
+```
+
+Oppure eseguirla in modalità watch durante lo sviluppo:
+
+```bash
+npm run dev
+```
+
+## Struttura del progetto
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Funzioni per categoria
+
+Il riferimento completo delle funzioni è stato spostato sul sito della documentazione, generato a partire da
+[`docs/writerside/`](../writerside/) e pubblicato a ogni push su `main`:
+
+****
+
+| Sezione | Contenuto |
+| :------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, richieste di rete e le classi UI integrate |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Controllo dei tipi e validazione, manipolazione di stringhe, array e oggetti, gestione di JSON e HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | Le classi di eccezione tipizzate e cosa solleva ciascuna |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Percorsi di file e URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Componenti condivisi |
+
+Oltre al riferimento, il sito ospita le guide che non trovavano posto nelle tabelle:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) spiega lo
+schema `isX`/`nonX`/`requireX`/`requireNonX` in un unico punto,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) illustra la gerarchia
+delle classi e [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+spiega quali funzioni sono legate a un servizio Google, quanto costa questo legame e cosa comporta per i test.
+
+## Come contribuire
+
+I contributi sono benvenuti. La guida completa è in [CONTRIBUTING.md](../../CONTRIBUTING.md). In sintesi:
+
+1. Fai un fork del repository e crea un branch per la tua funzionalità o correzione.
+2. Aggiungi o aggiorna i test che coprono le tue modifiche.
+3. Esegui `npm run lint` e `npm run format` prima del commit.
+4. Non modificare `CHANGELOG.md` a mano: viene generato automaticamente da [release-please](https://github.com/googleapis/release-please).
+5. Apri una pull request che descriva cosa è cambiato e perché.
+
+Segui lo stile del codice e le convenzioni di denominazione esistenti. Le linee guida della comunità sono in
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Supporto
+
+- Per bug o richieste di funzionalità, cerca o apri una [issue](https://github.com/bootgs/utils/issues)
+ su GitHub.
+- Per le modifiche recenti, consulta il [registro delle modifiche](../../CHANGELOG.md).
+- Per segnalare una vulnerabilità di sicurezza, segui la [politica di sicurezza](../../SECURITY.md) invece di aprire una
+ issue pubblica.
+- Per sostenere lo sviluppo continuo, consulta [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Roadmap
+
+Ciò che è pianificato, in corso o completato si trova nella [bacheca del progetto](https://github.com/users/MaksymStoianov/projects/2/views/2),
+costruita direttamente a partire dal tracker delle issue. Non esiste un documento di roadmap separato che possa
+disallinearsi: per proporre qualcosa, apri una [issue](https://github.com/bootgs/utils/issues).
+
+## Registro delle modifiche
+
+Per l'elenco dettagliato delle modifiche per versione, consulta [CHANGELOG.md](../../CHANGELOG.md).
+
+## Licenza
+
+Questo progetto è distribuito con licenza Apache License 2.0. Consulta [LICENSE](../../LICENSE) per i dettagli.
+
+L'illustrazione del banner non rientra in tale licenza. È opera della sua autrice, può essere riutilizzata senza
+modifiche citando l'autrice con un link, ed è disciplinata da
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Marchi
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms e Google Drive sono marchi di Google LLC.
+Questo progetto è una libreria indipendente. Non è affiliato a Google LLC né da essa approvato o sponsorizzato, e i
+marchi sono usati solo per descrivere con cosa funziona la libreria.
diff --git a/docs/readme/README.ja.md b/docs/readme/README.ja.md
new file mode 100644
index 00000000..73a12195
--- /dev/null
+++ b/docs/readme/README.ja.md
@@ -0,0 +1,273 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | **한국어** | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> 이 번역은 버전 2.1.1의 [README.md](../../README.md)를 바탕으로 AI의 도움을 받아 작성했습니다. 기준이 되는 버전은 영어 README이며, 수정 제안을 환영합니다. 자세한 내용은 [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations)를 참고하세요.
+
+# Google Apps Script™용 유틸리티
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Google Apps Script™용 유틸리티](#google-apps-script용-유틸리티)
+ - [개요](#개요)
+ - [주요 기능](#주요-기능)
+ - [AI 에이전트용 스킬](#ai-에이전트용-스킬)
+ - [요구 사항](#요구-사항)
+ - [설치](#설치)
+ - [문서](#문서)
+ - [사용 예제](#사용-예제)
+ - [개발](#개발)
+ - [스크립트](#스크립트)
+ - [테스트](#테스트)
+ - [프로젝트 구조](#프로젝트-구조)
+ - [카테고리별 함수](#카테고리별-함수)
+ - [기여하기](#기여하기)
+ - [지원](#지원)
+ - [로드맵](#로드맵)
+ - [변경 이력](#변경-이력)
+ - [라이선스](#라이선스)
+
+
+## 개요
+
+**@bootgs/utils**는 **Google Apps Script** 전용으로 만든 TypeScript 유틸리티 라이브러리입니다. 모든 GAS 프로젝트에서 결국 직접 작성하게 되는 헬퍼 — 스프레드시트와 A1 표기법 조작, 타입·값 검증(`isX`/`nonX`/`requireX`), 문자열과 배열 변환, 타입이 지정된 예외 등 — 를 문서화가 잘 되어 있고 테스트를 모두 거친 하나의 패키지로 모았습니다.
+
+## 주요 기능
+
+- **Google Apps Script 전용 설계** — 범용 Node.js 라이브러리를 옮겨 온 것이 아니라 GAS 런타임과 그 제약을 기준으로 설계했습니다.
+- **폭넓은 유틸리티** — 스프레드시트, UI, 네트워크, Admin SDK 헬퍼와 함께 문자열, 배열, 객체를 위한 범용 유틸리티를 제공합니다.
+- **TypeScript 우선** — 모든 함수에 완전한 타입 정의가 포함되어 IDE 자동 완성과 컴파일 타임 안전성을 누릴 수 있습니다.
+- **테스트 완료** — Vitest 단위 테스트 스위트로 검증됩니다.
+- **연결된 레퍼런스 문서** — API에서 사용하는 모든 Google Apps Script 타입이 공식 문서로 바로 연결됩니다.
+- **일관된 오류 처리** — 그때그때 던지는 오류 대신 전용 예외 클래스 계층 구조를 사용합니다.
+
+## AI 에이전트용 스킬
+
+AI 코딩 에이전트(Claude Code, Gemini CLI 등)를 사용하는 팀을 위해 [bootgs/skills](https://github.com/bootgs/skills) 저장소는 이 라이브러리를 에이전트에게 설명하는 [`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) Agent Skill을 제공합니다. 여기에는 `isX`/`nonX`/`requireX` 검증 규칙, A1 표기법과 시트 헬퍼, 문자열·숫자·배열 헬퍼, 타입이 지정된 예외, HTML/JSON/경로 헬퍼가 포함됩니다.
+
+Claude Code로 설치:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+여러 에이전트를 지원하는 `npx skills` CLI로 설치:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+설치가 끝나면 작업이 이 라이브러리와 관련될 때 에이전트가 스킬을 자동으로 적용합니다.
+
+## 요구 사항
+
+- [Node.js](https://nodejs.org/) v22.14.0 이상
+- [npm](https://www.npmjs.com/) (또는 pnpm 같은 다른 Node 패키지 관리자)
+
+## 설치
+
+npm으로 패키지를 설치합니다.
+
+```bash
+npm install @bootgs/utils
+```
+
+## 문서
+
+전체 문서는 ****(영어)에 게시되어 있습니다. 가이드, 모듈별 안내, 전체 함수 레퍼런스를 담고 있습니다. 소스는 [`docs/writerside/`](../writerside/)에 있으며 `main`에 push할 때마다 다시 빌드됩니다.
+
+추천하는 읽는 순서:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — 시작하기
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — `isX`/`nonX`/`requireX`/`requireNonX` 명명 규칙
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — 예외 클래스 계층 구조와 각 예외가 발생하는 상황
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — 어떤 헬퍼가 Google 서비스에 묶여 있는지, 그리고 그것이 테스트에 어떤 의미인지
+
+## 사용 예제
+
+### 시트 다루기
+
+여러 행의 데이터를 효율적으로 추가합니다.
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Admin SDK 유틸리티
+
+현재 사용자에게 관리자 권한이 있는지 확인합니다.
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### A1 표기법 파싱
+
+복잡한 A1 표기법을 구조화된 객체로 파싱합니다.
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## 개발
+
+### 스크립트
+
+`package.json`에서 다음 스크립트를 사용할 수 있습니다.
+
+| 스크립트 | 설명 |
+| :------------------- | :------------------------------------------------------- |
+| `npm run build` | `dist` 디렉터리를 비우고 TypeScript 소스를 컴파일합니다. |
+| `npm run dev` | Vitest를 watch 모드로 시작합니다. |
+| `npm test` | 전체 테스트 스위트를 한 번 실행합니다. |
+| `npm run type:check` | 출력물을 생성하지 않고 프로젝트의 타입을 검사합니다. |
+| `npm run lint` | ESLint로 코드베이스를 검사합니다. |
+| `npm run lint:fix` | 코드베이스를 검사하고 가능한 문제를 자동으로 수정합니다. |
+| `npm run format` | Prettier로 포맷을 확인합니다. |
+| `npm run format:fix` | Prettier로 코드베이스를 포맷합니다. |
+| `npm run prepare` | Husky Git 훅을 설정합니다(설치 후 자동으로 실행됨). |
+
+### 테스트
+
+이 프로젝트는 단위 테스트에 [Vitest](https://vitest.dev/)를 사용합니다.
+
+전체 스위트를 한 번 실행:
+
+```bash
+npm test
+```
+
+또는 개발 중에 watch 모드로 실행:
+
+```bash
+npm run dev
+```
+
+## 프로젝트 구조
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## 카테고리별 함수
+
+전체 함수 레퍼런스는 문서 사이트(영어)로 옮겨졌습니다. 이 사이트는 [`docs/writerside/`](../writerside/)에서 빌드되며 `main`에 push할 때마다 게시됩니다.
+
+****
+
+| 섹션 | 다루는 내용 |
+| :------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, 네트워크 요청, 내장 UI 클래스 |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | 타입 검사와 유효성 검사, 문자열·배열·객체 조작, JSON 및 HTML 처리 |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | 타입이 지정된 예외 클래스와 각 예외가 발생하는 상황 |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | 파일 경로와 URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | 공통 구성 요소 |
+
+레퍼런스와 함께, 표로는 담을 수 없었던 가이드도 사이트에서 제공합니다. [validation conventions](https://bootgs.github.io/utils/validation-conventions.html)는 `isX`/`nonX`/`requireX`/`requireNonX` 규칙을 한곳에서 설명하고, [exception handling](https://bootgs.github.io/utils/exception-handling.html)은 클래스 계층 구조를 정리하며, [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)은 어떤 헬퍼가 Google 서비스에 묶여 있는지, 그에 따른 비용은 무엇인지, 테스트에는 어떤 의미가 있는지를 다룹니다.
+
+## 기여하기
+
+기여를 환영합니다. 전체 가이드는 [CONTRIBUTING.md](../../CONTRIBUTING.md)를 참고하세요. 요약하면 다음과 같습니다.
+
+1. 저장소를 포크하고 기능 추가나 버그 수정을 위한 브랜치를 만듭니다.
+2. 변경 사항을 검증하는 테스트를 추가하거나 업데이트합니다.
+3. 커밋하기 전에 `npm run lint`와 `npm run format`을 실행합니다.
+4. `CHANGELOG.md`는 직접 수정하지 마세요. [release-please](https://github.com/googleapis/release-please)가 자동으로 생성합니다.
+5. 무엇을 왜 변경했는지 설명하는 풀 리퀘스트를 엽니다.
+
+기존 코드 스타일과 명명 규칙을 따라 주세요. 커뮤니티 가이드라인은 [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md)를 참고하세요.
+
+## 지원
+
+- 버그 신고나 기능 요청은 GitHub에서 [이슈](https://github.com/bootgs/utils/issues)를 검색하거나 새로 등록해 주세요.
+- 최근 변경 사항은 [변경 이력](../../CHANGELOG.md)을 참고하세요.
+- 보안 취약점은 공개 이슈를 여는 대신 [보안 정책](../../SECURITY.md)에 따라 신고해 주세요.
+- 지속적인 개발을 후원하려면 [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov)를 참고하세요.
+
+## 로드맵
+
+계획 중이거나 진행 중이거나 완료된 작업은 이슈 트래커를 바탕으로 만든 [프로젝트 보드](https://github.com/users/MaksymStoianov/projects/2/views/2)에서 확인할 수 있습니다. 보드와 어긋날 수 있는 별도의 로드맵 문서는 두지 않습니다. 제안할 내용이 있다면 [이슈](https://github.com/bootgs/utils/issues)를 열어 주세요.
+
+## 변경 이력
+
+버전별 변경 사항의 자세한 목록은 [CHANGELOG.md](../../CHANGELOG.md)를 참고하세요.
+
+## 라이선스
+
+이 프로젝트는 Apache License 2.0에 따라 배포됩니다. 자세한 내용은 [LICENSE](../../LICENSE)를 참고하세요.
+
+배너 일러스트는 이 라이선스에 포함되지 않습니다. 이 작품은 작가의 저작물로, 작가를 표기하고 그 표기에 링크를 걸면 수정하지 않은 상태로 재사용할 수 있으며, [docs/assets/images/README.md](../assets/images/README.md)의 적용을 받습니다.
+
+## 상표
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms, Google Drive는 Google LLC의 상표입니다. 이 프로젝트는 독립적인 라이브러리이며 Google LLC와 제휴하거나 Google LLC의 보증 또는 후원을 받지 않습니다. 상표는 이 라이브러리가 함께 동작하는 대상을 설명하기 위해서만 사용됩니다.
diff --git a/docs/readme/README.nl.md b/docs/readme/README.nl.md
new file mode 100644
index 00000000..ce5d9cfd
--- /dev/null
+++ b/docs/readme/README.nl.md
@@ -0,0 +1,304 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | **Nederlands** | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Deze vertaling is met behulp van AI gemaakt op basis van [README.md](../../README.md) voor versie 2.1.1. De referentieversie is de Engelse README; correcties zijn welkom — zie [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Hulpprogramma's voor Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Hulpprogramma's voor Google Apps Script™](#hulpprogrammas-voor-google-apps-script)
+ - [Overzicht](#overzicht)
+ - [Belangrijkste functies](#belangrijkste-functies)
+ - [Skills voor AI-agents](#skills-voor-ai-agents)
+ - [Vereisten](#vereisten)
+ - [Installatie](#installatie)
+ - [Documentatie](#documentatie)
+ - [Gebruiksvoorbeelden](#gebruiksvoorbeelden)
+ - [Ontwikkeling](#ontwikkeling)
+ - [Scripts](#scripts)
+ - [Testen](#testen)
+ - [Projectstructuur](#projectstructuur)
+ - [Functies per categorie](#functies-per-categorie)
+ - [Bijdragen](#bijdragen)
+ - [Ondersteuning](#ondersteuning)
+ - [Roadmap](#roadmap)
+ - [Changelog](#changelog)
+ - [Licentie](#licentie)
+
+
+## Overzicht
+
+**@bootgs/utils** is een TypeScript-hulpbibliotheek die speciaal is gebouwd voor **Google Apps Script**. Ze bundelt de
+hulpfuncties die elk GAS-project uiteindelijk zelf schrijft — bewerken van spreadsheets en A1-notatie, validatie van
+typen en waarden (`isX`/`nonX`/`requireX`), transformaties van strings en arrays, getypeerde exceptions en meer — in
+één goed gedocumenteerd en volledig getest pakket.
+
+## Belangrijkste functies
+
+- **Gebouwd voor Google Apps Script** — ontworpen rond de GAS-runtime en de beperkingen daarvan, niet aangepast vanuit
+ een generieke Node.js-bibliotheek.
+- **Brede dekking** — hulpfuncties voor spreadsheets, UI, netwerk en Admin SDK, naast algemene hulpmiddelen voor
+ strings, arrays en objecten.
+- **TypeScript-first** — elke functie wordt geleverd met volledige typedefinities voor automatisch aanvullen in de IDE
+ en veiligheid tijdens het compileren.
+- **Getest** — gedekt door een suite met unittests in Vitest.
+- **Gekoppelde referentiedocumentatie** — elk Google Apps Script-type dat in de API wordt gebruikt, linkt rechtstreeks
+ naar de officiële documentatie ervan.
+- **Consistente foutafhandeling** — een eigen hiërarchie van exceptionklassen vervangt willekeurig gegooide fouten.
+
+## Skills voor AI-agents
+
+Voor teams die een AI-codeeragent gebruiken (Claude Code, Gemini CLI en andere) biedt de repository
+[bootgs/skills](https://github.com/bootgs/skills) een Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) die deze bibliotheek voor
+zulke agents documenteert, waaronder de validatieconventie `isX`/`nonX`/`requireX`, de hulpfuncties voor A1-notatie
+en sheets, voor strings, getallen en arrays, de getypeerde exceptions en de hulpfuncties voor HTML, JSON en paden.
+
+Installeren met Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Installeren met de CLI `npx skills`, die meerdere agents ondersteunt:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Na installatie past de agent de skill automatisch toe wanneer een taak met deze bibliotheek te maken heeft.
+
+## Vereisten
+
+- [Node.js](https://nodejs.org/) v22.14.0 of nieuwer
+- [npm](https://www.npmjs.com/) (of een andere pakketbeheerder voor Node, bijv. pnpm)
+
+## Installatie
+
+Installeer het pakket via npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Documentatie
+
+De volledige documentatie staat op **** (in het Engels): handleidingen, uitleg per
+module en de complete functiereferentie. De bron staat in [`docs/writerside/`](../writerside/) en wordt bij elke
+push naar `main` opnieuw gebouwd.
+
+Een goede leesvolgorde:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — de eerste stappen
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — het naamgevingsschema
+ `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — de klassenhiërarchie en wat elke
+ exception veroorzaakt
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — welke hulpfuncties aan een
+ Google-service gebonden zijn en wat dat betekent voor het testen
+
+## Gebruiksvoorbeelden
+
+### Werken met sheets
+
+Voeg efficiënt meerdere rijen met gegevens toe:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Hulpfuncties voor de Admin SDK
+
+Controleer of de huidige gebruiker beheerdersrechten heeft:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### A1-notatie parsen
+
+Zet complexe A1-notaties om in gestructureerde objecten:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Ontwikkeling
+
+### Scripts
+
+De volgende scripts zijn beschikbaar in `package.json`:
+
+| Script | Beschrijving |
+| :------------------- | :---------------------------------------------------------------------- |
+| `npm run build` | Leegt de map `dist` en compileert de TypeScript-broncode. |
+| `npm run dev` | Start Vitest in watch-modus. |
+| `npm test` | Voert de volledige testsuite één keer uit. |
+| `npm run type:check` | Controleert de typen van het project zonder uitvoer te genereren. |
+| `npm run lint` | Controleert de code met ESLint. |
+| `npm run lint:fix` | Controleert de code en herstelt automatisch wat mogelijk is. |
+| `npm run format` | Controleert de opmaak met Prettier. |
+| `npm run format:fix` | Formatteert de code met Prettier. |
+| `npm run prepare` | Richt de Git-hooks van Husky in (draait automatisch na de installatie). |
+
+### Testen
+
+Het project gebruikt [Vitest](https://vitest.dev/) voor unittests.
+
+Voer de volledige suite één keer uit:
+
+```bash
+npm test
+```
+
+Of draai hem in watch-modus tijdens het ontwikkelen:
+
+```bash
+npm run dev
+```
+
+## Projectstructuur
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Functies per categorie
+
+De volledige functiereferentie is verhuisd naar de documentatiesite (in het Engels), die wordt gebouwd vanuit
+[`docs/writerside/`](../writerside/) en bij elke push naar `main` wordt gepubliceerd:
+
+****
+
+| Sectie | Inhoud |
+| :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, netwerkverzoeken en de ingebouwde UI-klassen |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Typecontrole en validatie, bewerken van strings, arrays en objecten, verwerking van JSON en HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | De getypeerde exceptionklassen en wat elk ervan veroorzaakt |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Bestandspaden en URL's |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Gedeelde bouwstenen |
+
+Naast de referentie bevat de site de handleidingen waar in de tabellen geen ruimte voor was:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) legt het schema
+`isX`/`nonX`/`requireX`/`requireNonX` op één plek uit,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) beschrijft de klassenhiërarchie, en
+[the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) behandelt welke hulpfuncties aan
+een Google-service gebonden zijn, wat dat kost en wat het betekent voor het testen.
+
+## Bijdragen
+
+Bijdragen zijn welkom. Zie [CONTRIBUTING.md](../../CONTRIBUTING.md) voor de volledige handleiding. Kort samengevat:
+
+1. Fork de repository en maak een branch aan voor je feature of bugfix.
+2. Voeg tests toe of werk ze bij zodat ze je wijzigingen dekken.
+3. Voer `npm run lint` en `npm run format` uit voordat je commit.
+4. Bewerk `CHANGELOG.md` niet handmatig: het bestand wordt automatisch gegenereerd door [release-please](https://github.com/googleapis/release-please).
+5. Open een pull request waarin je beschrijft wat er is veranderd en waarom.
+
+Volg de bestaande codestijl en naamgevingsconventies. Zie [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md) voor de
+gemeenschapsrichtlijnen.
+
+## Ondersteuning
+
+- Voor bugs of featureverzoeken: zoek of open een [issue](https://github.com/bootgs/utils/issues) op GitHub.
+- Voor recente wijzigingen: zie de [changelog](../../CHANGELOG.md).
+- Om een beveiligingsprobleem te melden, volg je het [beveiligingsbeleid](../../SECURITY.md) in plaats van een openbare
+ issue te openen.
+- Om de verdere ontwikkeling te steunen: zie [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Roadmap
+
+Wat gepland, in uitvoering of afgerond is, staat op het [projectbord](https://github.com/users/MaksymStoianov/projects/2/views/2),
+dat rechtstreeks uit de issuetracker wordt opgebouwd. Er is geen apart roadmapdocument dat daarmee uit de pas kan
+gaan lopen: wil je iets voorstellen, open dan een [issue](https://github.com/bootgs/utils/issues).
+
+## Changelog
+
+Een gedetailleerde lijst met wijzigingen per versie vind je in [CHANGELOG.md](../../CHANGELOG.md).
+
+## Licentie
+
+Dit project valt onder de Apache License 2.0. Zie [LICENSE](../../LICENSE) voor details.
+
+De bannerillustratie valt niet onder die licentie. Het is het werk van de maker, mag ongewijzigd worden hergebruikt
+mits de maker wordt vermeld en die vermelding een link bevat, en valt onder
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Handelsmerken
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms en Google Drive zijn handelsmerken van
+Google LLC. Dit project is een onafhankelijke bibliotheek. Het is niet gelieerd aan Google LLC en wordt niet door
+Google LLC onderschreven of gesponsord; de handelsmerken worden alleen gebruikt om te beschrijven waarmee de
+bibliotheek werkt.
diff --git a/docs/readme/README.pl.md b/docs/readme/README.pl.md
new file mode 100644
index 00000000..2e37b9a7
--- /dev/null
+++ b/docs/readme/README.pl.md
@@ -0,0 +1,304 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | **Polski** | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> To tłumaczenie powstało z pomocą AI na podstawie [README.md](../../README.md) dla wersji 2.1.1. Wersją wzorcową jest angielskie README; poprawki są mile widziane — zajrzyj do [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Narzędzia dla Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Narzędzia dla Google Apps Script™](#narzędzia-dla-google-apps-script)
+ - [Przegląd](#przegląd)
+ - [Najważniejsze funkcje](#najważniejsze-funkcje)
+ - [Skills dla agentów AI](#skills-dla-agentów-ai)
+ - [Wymagania](#wymagania)
+ - [Instalacja](#instalacja)
+ - [Dokumentacja](#dokumentacja)
+ - [Przykłady użycia](#przykłady-użycia)
+ - [Rozwój projektu](#rozwój-projektu)
+ - [Skrypty](#skrypty)
+ - [Testy](#testy)
+ - [Struktura projektu](#struktura-projektu)
+ - [Funkcje według kategorii](#funkcje-według-kategorii)
+ - [Jak pomóc w rozwoju](#jak-pomóc-w-rozwoju)
+ - [Wsparcie](#wsparcie)
+ - [Plan rozwoju](#plan-rozwoju)
+ - [Historia zmian](#historia-zmian)
+ - [Licencja](#licencja)
+
+
+## Przegląd
+
+**@bootgs/utils** to biblioteka narzędziowa w TypeScript stworzona specjalnie dla **Google Apps Script**. Zbiera
+w jednym, dobrze udokumentowanym i w pełni przetestowanym pakiecie funkcje pomocnicze, które każdy projekt GAS
+w końcu pisze ręcznie — operacje na arkuszach i notacji A1, walidację typów i wartości (`isX`/`nonX`/`requireX`),
+przekształcenia ciągów znaków i tablic, typowane wyjątki i nie tylko.
+
+## Najważniejsze funkcje
+
+- **Stworzona dla Google Apps Script** — zaprojektowana z myślą o środowisku uruchomieniowym GAS i jego
+ ograniczeniach, a nie zaadaptowana z ogólnej biblioteki Node.js.
+- **Szeroki zakres narzędzi** — funkcje pomocnicze do arkuszy, UI, sieci i Admin SDK obok uniwersalnych narzędzi do
+ ciągów znaków, tablic i obiektów.
+- **Przede wszystkim TypeScript** — każda funkcja ma pełne definicje typów, co daje autouzupełnianie w IDE
+ i bezpieczeństwo na etapie kompilacji.
+- **Przetestowana** — objęta zestawem testów jednostkowych w Vitest.
+- **Powiązana dokumentacja referencyjna** — każdy typ Google Apps Script używany w API prowadzi bezpośrednio do
+ swojej oficjalnej dokumentacji.
+- **Spójna obsługa błędów** — dedykowana hierarchia klas wyjątków zastępuje doraźnie rzucane błędy.
+
+## Skills dla agentów AI
+
+Dla zespołów korzystających z agenta AI do programowania (Claude Code, Gemini CLI i innych) repozytorium
+[bootgs/skills](https://github.com/bootgs/skills) udostępnia Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils), który opisuje tę bibliotekę
+dla takich agentów, w tym konwencję walidacji `isX`/`nonX`/`requireX`, funkcje do notacji A1 i arkuszy, do ciągów
+znaków, liczb i tablic, typowane wyjątki oraz funkcje do HTML, JSON i ścieżek.
+
+Instalacja w Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Instalacja za pomocą CLI `npx skills`, które obsługuje wielu agentów:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Po instalacji agent automatycznie stosuje ten skill, gdy zadanie dotyczy tej biblioteki.
+
+## Wymagania
+
+- [Node.js](https://nodejs.org/) v22.14.0 lub nowszy
+- [npm](https://www.npmjs.com/) (lub inny menedżer pakietów Node, np. pnpm)
+
+## Instalacja
+
+Zainstaluj pakiet przez npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Dokumentacja
+
+Pełna dokumentacja jest opublikowana pod adresem **** (po angielsku):
+przewodniki, omówienia poszczególnych modułów i kompletna dokumentacja referencyjna funkcji. Jej źródła znajdują się
+w [`docs/writerside/`](../writerside/) i są przebudowywane przy każdym pushu do `main`.
+
+Dobra kolejność lektury:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — pierwsze kroki
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — schemat
+ nazewnictwa `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — hierarchia klas
+ i to, co wywołuje każdy wyjątek
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — które
+ funkcje są powiązane z usługą Google i co to oznacza dla testowania
+
+## Przykłady użycia
+
+### Praca z arkuszami
+
+Wydajne dopisywanie wielu wierszy danych:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Narzędzia Admin SDK
+
+Sprawdzanie, czy bieżący użytkownik ma uprawnienia administratora:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Parsowanie notacji A1
+
+Parsowanie złożonych zapisów w notacji A1 do ustrukturyzowanych obiektów:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Rozwój projektu
+
+### Skrypty
+
+W `package.json` dostępne są następujące skrypty:
+
+| Skrypt | Opis |
+| :------------------- | :----------------------------------------------------------------------- |
+| `npm run build` | Czyści katalog `dist` i kompiluje kod źródłowy TypeScript. |
+| `npm run dev` | Uruchamia Vitest w trybie obserwowania zmian. |
+| `npm test` | Jednorazowo uruchamia pełny zestaw testów. |
+| `npm run type:check` | Sprawdza typy w projekcie bez generowania plików wynikowych. |
+| `npm run lint` | Analizuje kod za pomocą ESLint. |
+| `npm run lint:fix` | Analizuje kod i automatycznie poprawia to, co się da. |
+| `npm run format` | Sprawdza formatowanie za pomocą Prettier. |
+| `npm run format:fix` | Formatuje kod za pomocą Prettier. |
+| `npm run prepare` | Konfiguruje hooki Git Husky (uruchamia się automatycznie po instalacji). |
+
+### Testy
+
+Projekt używa [Vitest](https://vitest.dev/) do testów jednostkowych.
+
+Jednorazowe uruchomienie pełnego zestawu:
+
+```bash
+npm test
+```
+
+Albo uruchomienie w trybie obserwowania zmian podczas pracy:
+
+```bash
+npm run dev
+```
+
+## Struktura projektu
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Funkcje według kategorii
+
+Pełna dokumentacja referencyjna funkcji została przeniesiona na stronę dokumentacji, która jest budowana
+z [`docs/writerside/`](../writerside/) i publikowana przy każdym pushu do `main`:
+
+****
+
+| Sekcja | Zawartość |
+| :------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, żądania sieciowe i wbudowane klasy UI |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Sprawdzanie typów i walidacja, operacje na ciągach znaków, tablicach i obiektach, obsługa JSON i HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | Typowane klasy wyjątków i to, co wywołuje każdą z nich |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Ścieżki plików i adresy URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Wspólne elementy składowe |
+
+Oprócz dokumentacji referencyjnej strona zawiera przewodniki, które nie zmieściły się w tabelach:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) objaśnia w jednym miejscu
+schemat `isX`/`nonX`/`requireX`/`requireNonX`,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) przedstawia hierarchię
+klas, a [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+omawia, które funkcje są powiązane z usługą Google, ile to kosztuje i co oznacza dla testowania.
+
+## Jak pomóc w rozwoju
+
+Wkład w projekt jest mile widziany. Pełny przewodnik znajdziesz w [CONTRIBUTING.md](../../CONTRIBUTING.md). W skrócie:
+
+1. Zrób fork repozytorium i utwórz gałąź dla swojej funkcji lub poprawki.
+2. Dodaj lub zaktualizuj testy obejmujące Twoje zmiany.
+3. Przed commitem uruchom `npm run lint` i `npm run format`.
+4. Nie edytuj `CHANGELOG.md` ręcznie — jest generowany automatycznie przez [release-please](https://github.com/googleapis/release-please).
+5. Otwórz pull request z opisem tego, co się zmieniło i dlaczego.
+
+Trzymaj się istniejącego stylu kodu i konwencji nazewnictwa. Zasady społeczności opisuje
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Wsparcie
+
+- W przypadku błędów lub propozycji nowych funkcji wyszukaj albo otwórz
+ [issue](https://github.com/bootgs/utils/issues) na GitHubie.
+- Ostatnie zmiany znajdziesz w [historii zmian](../../CHANGELOG.md).
+- Aby zgłosić lukę w zabezpieczeniach, postępuj zgodnie z [polityką bezpieczeństwa](../../SECURITY.md), zamiast otwierać
+ publiczne issue.
+- Aby wesprzeć dalszy rozwój, zajrzyj na [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Plan rozwoju
+
+To, co jest zaplanowane, w toku lub ukończone, widać na [tablicy projektu](https://github.com/users/MaksymStoianov/projects/2/views/2),
+budowanej bezpośrednio z systemu zgłoszeń. Nie ma osobnego dokumentu z planem rozwoju, który mógłby się z nią
+rozjechać: aby coś zaproponować, otwórz [issue](https://github.com/bootgs/utils/issues).
+
+## Historia zmian
+
+Szczegółową listę zmian w poszczególnych wersjach znajdziesz w [CHANGELOG.md](../../CHANGELOG.md).
+
+## Licencja
+
+Ten projekt jest udostępniany na licencji Apache License 2.0. Szczegóły znajdziesz w pliku [LICENSE](../../LICENSE).
+
+Grafika banera nie jest objęta tą licencją. Jest dziełem jej autorki, może być ponownie wykorzystywana bez zmian
+pod warunkiem podania autorki wraz z linkiem i podlega zasadom opisanym w
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Znaki towarowe
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms i Google Drive są znakami towarowymi
+Google LLC. Ten projekt jest niezależną biblioteką. Nie jest powiązany z Google LLC ani przez nią popierany czy
+sponsorowany, a znaki towarowe są używane wyłącznie do opisania, z czym współpracuje biblioteka.
diff --git a/docs/readme/README.pt.md b/docs/readme/README.pt.md
new file mode 100644
index 00000000..17bddb38
--- /dev/null
+++ b/docs/readme/README.pt.md
@@ -0,0 +1,305 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | **Português** | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Esta tradução foi feita com ajuda de IA a partir do [README.md](../../README.md) para a versão 2.1.1. A versão de referência é o README em inglês; correções são bem-vindas — veja [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Utilitários para Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Utilitários para Google Apps Script™](#utilitários-para-google-apps-script)
+ - [Visão geral](#visão-geral)
+ - [Principais recursos](#principais-recursos)
+ - [Skills para agentes de IA](#skills-para-agentes-de-ia)
+ - [Requisitos](#requisitos)
+ - [Instalação](#instalação)
+ - [Documentação](#documentação)
+ - [Exemplos de uso](#exemplos-de-uso)
+ - [Desenvolvimento](#desenvolvimento)
+ - [Scripts](#scripts)
+ - [Testes](#testes)
+ - [Estrutura do projeto](#estrutura-do-projeto)
+ - [Funções por categoria](#funções-por-categoria)
+ - [Como contribuir](#como-contribuir)
+ - [Suporte](#suporte)
+ - [Roadmap](#roadmap)
+ - [Registro de alterações](#registro-de-alterações)
+ - [Licença](#licença)
+
+
+## Visão geral
+
+**@bootgs/utils** é uma biblioteca de utilitários em TypeScript criada especificamente para **Google Apps
+Script**. Ela reúne as funções auxiliares que todo projeto GAS acaba escrevendo à mão — manipulação de planilhas e da
+notação A1, validação de tipos e valores (`isX`/`nonX`/`requireX`), transformações de strings e arrays, exceções
+tipadas e muito mais — em um único pacote bem documentado e totalmente testado.
+
+## Principais recursos
+
+- **Feita para Google Apps Script** — projetada em torno do ambiente de execução do GAS e de suas restrições, e não
+ adaptada de uma biblioteca genérica de Node.js.
+- **Ampla cobertura** — funções para planilhas, UI, rede e Admin SDK ao lado de utilitários de uso geral para
+ strings, arrays e objetos.
+- **TypeScript em primeiro lugar** — cada função vem com definições de tipos completas para autocompletar na IDE e
+ segurança em tempo de compilação.
+- **Testada** — coberta por uma suíte de testes unitários com Vitest.
+- **Documentação de referência com links** — cada tipo do Google Apps Script usado na API aponta diretamente para a
+ sua documentação oficial.
+- **Tratamento de erros consistente** — uma hierarquia própria de classes de exceção substitui erros lançados de
+ forma improvisada.
+
+## Skills para agentes de IA
+
+Para equipes que usam um agente de programação com IA (Claude Code, Gemini CLI e outros), o repositório
+[bootgs/skills](https://github.com/bootgs/skills) oferece um Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) que documenta esta
+biblioteca para esses agentes, incluindo a convenção de validação `isX`/`nonX`/`requireX`, as funções para notação A1
+e planilhas, para strings, números e arrays, as exceções tipadas e as funções para HTML, JSON e caminhos.
+
+Instalação com o Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Instalação com a CLI `npx skills`, que oferece suporte a vários agentes:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Depois de instalado, o agente aplica o skill automaticamente quando uma tarefa envolve esta biblioteca.
+
+## Requisitos
+
+- [Node.js](https://nodejs.org/) v22.14.0 ou superior
+- [npm](https://www.npmjs.com/) (ou outro gerenciador de pacotes do Node, como o pnpm)
+
+## Instalação
+
+Instale o pacote via npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Documentação
+
+A documentação completa está publicada em **** (em inglês):
+guias, explicações de cada módulo e a referência completa de funções. O código-fonte dela fica em
+[`docs/writerside/`](../writerside/) e é reconstruído a cada push para `main`.
+
+Uma boa ordem de leitura:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — primeiros passos
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — o
+ esquema de nomes `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — a hierarquia de
+ classes e o que dispara cada exceção
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — quais
+ funções dependem de um serviço do Google e o que isso significa para os testes
+
+## Exemplos de uso
+
+### Trabalhando com planilhas
+
+Adicionar várias linhas de dados de forma eficiente:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Utilitários do Admin SDK
+
+Verificar se o usuário atual tem privilégios de administrador:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Análise da notação A1
+
+Converter notações A1 complexas em objetos estruturados:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Desenvolvimento
+
+### Scripts
+
+Os seguintes scripts estão disponíveis no `package.json`:
+
+| Script | Descrição |
+| :------------------- | :-------------------------------------------------------------------------------- |
+| `npm run build` | Limpa o diretório `dist` e compila o código-fonte TypeScript. |
+| `npm run dev` | Inicia o Vitest em modo watch. |
+| `npm test` | Executa uma vez a suíte de testes completa. |
+| `npm run type:check` | Verifica os tipos do projeto sem gerar saída. |
+| `npm run lint` | Analisa o código com o ESLint. |
+| `npm run lint:fix` | Analisa o código e corrige automaticamente o que for possível. |
+| `npm run format` | Verifica a formatação com o Prettier. |
+| `npm run format:fix` | Formata o código com o Prettier. |
+| `npm run prepare` | Configura os hooks do Git do Husky (executado automaticamente após a instalação). |
+
+### Testes
+
+O projeto usa o [Vitest](https://vitest.dev/) para testes unitários.
+
+Executar a suíte completa uma vez:
+
+```bash
+npm test
+```
+
+Ou executá-la em modo watch durante o desenvolvimento:
+
+```bash
+npm run dev
+```
+
+## Estrutura do projeto
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Funções por categoria
+
+A referência completa de funções foi movida para o site de documentação, gerado a partir de
+[`docs/writerside/`](../writerside/) e publicado a cada push para `main`:
+
+****
+
+| Seção | Abrange |
+| :------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, requisições de rede e as classes de UI integradas |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Verificação de tipos e validação, manipulação de strings, arrays e objetos, tratamento de JSON e HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | As classes de exceção tipadas e o que dispara cada uma |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Caminhos de arquivos e URLs |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Blocos de construção compartilhados |
+
+Além da referência, o site traz os guias que não cabiam nas tabelas:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) explica o
+esquema `isX`/`nonX`/`requireX`/`requireNonX` em um só lugar,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) apresenta a
+hierarquia de classes e [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+mostra quais funções dependem de um serviço do Google, quanto isso custa e o que significa para os testes.
+
+## Como contribuir
+
+Contribuições são bem-vindas. Veja o guia completo em [CONTRIBUTING.md](../../CONTRIBUTING.md). Em resumo:
+
+1. Faça um fork do repositório e crie um branch para o seu recurso ou correção.
+2. Adicione ou atualize os testes que cobrem as suas alterações.
+3. Execute `npm run lint` e `npm run format` antes de fazer commit.
+4. Não edite o `CHANGELOG.md` manualmente — ele é gerado automaticamente pelo [release-please](https://github.com/googleapis/release-please).
+5. Abra um pull request descrevendo o que mudou e por quê.
+
+Siga o estilo de código e as convenções de nomenclatura existentes. As regras da comunidade estão em
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Suporte
+
+- Para bugs ou pedidos de recursos, procure ou abra uma
+ [issue](https://github.com/bootgs/utils/issues) no GitHub.
+- Para as alterações recentes, veja o [registro de alterações](../../CHANGELOG.md).
+- Para relatar uma vulnerabilidade de segurança, siga a [política de segurança](../../SECURITY.md) em vez de abrir uma
+ issue pública.
+- Para apoiar o desenvolvimento contínuo, veja o [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Roadmap
+
+O que está planejado, em andamento ou concluído fica no [quadro do projeto](https://github.com/users/MaksymStoianov/projects/2/views/2),
+montado a partir do próprio rastreador de issues. Não há um documento de roadmap separado que possa ficar
+desatualizado em relação a ele: para propor algo, abra uma [issue](https://github.com/bootgs/utils/issues).
+
+## Registro de alterações
+
+Para a lista detalhada de alterações por versão, veja [CHANGELOG.md](../../CHANGELOG.md).
+
+## Licença
+
+Este projeto é licenciado sob a Apache License 2.0. Veja [LICENSE](../../LICENSE) para mais detalhes.
+
+A ilustração do banner não faz parte dessa licença. Ela é obra de sua autora, pode ser reutilizada sem modificações
+desde que a autora seja creditada com um link, e é regida por
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Marcas comerciais
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms e Google Drive são marcas comerciais da
+Google LLC. Este projeto é uma biblioteca independente. Ele não é afiliado à Google LLC nem endossado ou patrocinado
+por ela, e as marcas são usadas apenas para descrever com o que a biblioteca funciona.
diff --git a/docs/readme/README.ru.md b/docs/readme/README.ru.md
new file mode 100644
index 00000000..b0395ec2
--- /dev/null
+++ b/docs/readme/README.ru.md
@@ -0,0 +1,304 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | **Русский** | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Этот перевод выполнен с помощью ИИ по [README.md](../../README.md) для версии 2.1.1. Основной считается английская версия README; исправления приветствуются — см. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Утилиты для Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Утилиты для Google Apps Script™](#утилиты-для-google-apps-script)
+ - [Обзор](#обзор)
+ - [Ключевые возможности](#ключевые-возможности)
+ - [Навыки для ИИ-агентов](#навыки-для-ии-агентов)
+ - [Требования](#требования)
+ - [Установка](#установка)
+ - [Документация](#документация)
+ - [Примеры использования](#примеры-использования)
+ - [Разработка](#разработка)
+ - [Скрипты](#скрипты)
+ - [Тестирование](#тестирование)
+ - [Структура проекта](#структура-проекта)
+ - [Функции по категориям](#функции-по-категориям)
+ - [Участие в разработке](#участие-в-разработке)
+ - [Поддержка](#поддержка)
+ - [Дорожная карта](#дорожная-карта)
+ - [Журнал изменений](#журнал-изменений)
+ - [Лицензия](#лицензия)
+
+
+## Обзор
+
+**@bootgs/utils** — это библиотека утилит на TypeScript, созданная специально для **Google Apps Script**. Она
+собирает в одном хорошо документированном и полностью протестированном пакете вспомогательные функции, которые
+каждый GAS-проект рано или поздно пишет вручную: работу с таблицами и нотацией A1, проверку типов и значений
+(`isX`/`nonX`/`requireX`), преобразования строк и массивов, типизированные исключения и многое другое.
+
+## Ключевые возможности
+
+- **Создана для Google Apps Script** — спроектирована с учётом среды выполнения GAS и её ограничений, а не
+ адаптирована из универсальной библиотеки для Node.js.
+- **Широкий набор утилит** — вспомогательные функции для таблиц, UI, сети и Admin SDK наряду с универсальными
+ утилитами для строк, массивов и объектов.
+- **TypeScript в первую очередь** — каждая функция поставляется с полными определениями типов для автодополнения в
+ IDE и безопасности на этапе компиляции.
+- **Протестирована** — покрыта набором модульных тестов на Vitest.
+- **Справочная документация со ссылками** — каждый тип Google Apps Script, используемый в API, ссылается напрямую на
+ свою официальную документацию.
+- **Единообразная обработка ошибок** — отдельная иерархия классов исключений заменяет произвольно брошенные ошибки.
+
+## Навыки для ИИ-агентов
+
+Для команд, работающих с ИИ-агентом для программирования (Claude Code, Gemini CLI и другие), репозиторий
+[bootgs/skills](https://github.com/bootgs/skills) предоставляет Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils), описывающий эту
+библиотеку для таких агентов: соглашение о проверках `isX`/`nonX`/`requireX`, вспомогательные функции для нотации A1
+и листов, для строк, чисел и массивов, типизированные исключения, а также вспомогательные функции для HTML, JSON и
+путей.
+
+Установка в Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Установка через CLI `npx skills`, который поддерживает разные агенты:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+После установки агент применяет навык автоматически, когда задача касается этой библиотеки.
+
+## Требования
+
+- [Node.js](https://nodejs.org/) v22.14.0 или новее
+- [npm](https://www.npmjs.com/) (или другой менеджер пакетов для Node, например pnpm)
+
+## Установка
+
+Установите пакет через npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Документация
+
+Полная документация опубликована по адресу **** —
+руководства, обзоры отдельных модулей и полный справочник функций. Её исходники лежат в
+[`docs/writerside-ru/`](../writerside-ru/) и пересобираются после каждого push в `main`.
+
+Рекомендуемый порядок чтения:
+
+- [Первые шаги](https://bootgs.github.io/utils/ru/getting-started.html)
+- [Соглашения о проверках](https://bootgs.github.io/utils/ru/validation-conventions.html) —
+ схема имён `isX`/`nonX`/`requireX`/`requireNonX`
+- [Обработка исключений](https://bootgs.github.io/utils/ru/exception-handling.html) — иерархия
+ классов и причины каждого исключения
+- [Среда выполнения Apps Script](https://bootgs.github.io/utils/ru/apps-script-runtime.html) —
+ какие вспомогательные функции привязаны к сервису Google и что это значит для тестирования
+
+## Примеры использования
+
+### Работа с листами
+
+Эффективное добавление нескольких строк данных:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Утилиты Admin SDK
+
+Проверка, есть ли у текущего пользователя права администратора:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Разбор нотации A1
+
+Разбор сложных нотаций A1 в структурированные объекты:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Разработка
+
+### Скрипты
+
+В `package.json` доступны следующие скрипты:
+
+| Скрипт | Описание |
+| :------------------- | :-------------------------------------------------------------------- |
+| `npm run build` | Очищает каталог `dist` и компилирует исходный код TypeScript. |
+| `npm run dev` | Запускает Vitest в режиме наблюдения. |
+| `npm test` | Один раз запускает весь набор тестов. |
+| `npm run type:check` | Проверяет типы в проекте без генерации выходных файлов. |
+| `npm run lint` | Проверяет код с помощью ESLint. |
+| `npm run lint:fix` | Проверяет код и автоматически исправляет то, что может. |
+| `npm run format` | Проверяет форматирование с помощью Prettier. |
+| `npm run format:fix` | Форматирует код с помощью Prettier. |
+| `npm run prepare` | Настраивает git-хуки Husky (запускается автоматически после install). |
+
+### Тестирование
+
+Для модульного тестирования проект использует [Vitest](https://vitest.dev/).
+
+Запустить весь набор один раз:
+
+```bash
+npm test
+```
+
+Или запустить в режиме наблюдения во время разработки:
+
+```bash
+npm run dev
+```
+
+## Структура проекта
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Функции по категориям
+
+Полный справочник функций переехал на сайт документации, который собирается из
+[`docs/writerside-ru/`](../writerside-ru/) и публикуется после каждого push в `main`:
+
+****
+
+| Раздел | Что охватывает |
+| :--------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
+| [Модуль Google Apps Script](https://bootgs.github.io/utils/ru/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, сетевые запросы и встроенные классы UI |
+| [Базовые утилиты](https://bootgs.github.io/utils/ru/reference-base.html) | Проверка типов и значений, работа со строками, массивами и объектами, обработка JSON и HTML |
+| [Исключения](https://bootgs.github.io/utils/ru/reference-exception.html) | Типизированные классы исключений и причины каждого из них |
+| [Модуль `path`](https://bootgs.github.io/utils/ru/reference-path.html) | Пути к файлам и URL |
+| [Абстракции и интерфейсы](https://bootgs.github.io/utils/ru/reference-abstracts.html) | Общие строительные блоки |
+
+Помимо справочника, на сайте есть руководства, которые не поместились бы в таблицы:
+[соглашения о проверках](https://bootgs.github.io/utils/ru/validation-conventions.html)
+объясняют схему `isX`/`nonX`/`requireX`/`requireNonX` в одном месте,
+[обработка исключений](https://bootgs.github.io/utils/ru/exception-handling.html) описывает
+иерархию классов, а [среда выполнения Apps Script](https://bootgs.github.io/utils/ru/apps-script-runtime.html)
+рассказывает, какие вспомогательные функции привязаны к сервису Google, чего это стоит и что это значит для
+тестирования.
+
+## Участие в разработке
+
+Вклад приветствуется. Полное руководство — в [CONTRIBUTING.md](../../CONTRIBUTING.md). Вкратце:
+
+1. Сделайте форк репозитория и создайте ветку для своей функции или исправления.
+2. Добавьте или обновите тесты, покрывающие ваши изменения.
+3. Перед коммитом запустите `npm run lint` и `npm run format`.
+4. Не редактируйте `CHANGELOG.md` вручную — его автоматически генерирует [release-please](https://github.com/googleapis/release-please).
+5. Откройте pull request с описанием того, что изменилось и почему.
+
+Придерживайтесь существующего стиля кода и соглашений об именах. Правила сообщества — в
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Поддержка
+
+- Чтобы сообщить об ошибке или предложить функцию, найдите или откройте
+ [issue](https://github.com/bootgs/utils/issues) на GitHub.
+- Последние изменения — в [журнале изменений](../../CHANGELOG.md).
+- Чтобы сообщить об уязвимости, следуйте [политике безопасности](../../SECURITY.md), а не открывайте публичный issue.
+- Поддержать дальнейшую разработку можно через [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Дорожная карта
+
+Что запланировано, что в работе, а что уже сделано — на [доске проекта](https://github.com/users/MaksymStoianov/projects/2/views/2),
+которая строится из самого трекера issues. Отдельного документа с дорожной картой, который мог бы с ней разойтись,
+нет: чтобы что-то предложить, откройте [issue](https://github.com/bootgs/utils/issues).
+
+## Журнал изменений
+
+Подробный список изменений по версиям — в [CHANGELOG.md](../../CHANGELOG.md).
+
+## Лицензия
+
+Проект распространяется по лицензии Apache License 2.0. Подробности — в [LICENSE](../../LICENSE).
+
+Иллюстрация баннера не подпадает под эту лицензию. Это работа её автора; её можно использовать без изменений,
+указав автора со ссылкой, а условия описаны в [docs/assets/images/README.md](../assets/images/README.md).
+
+## Товарные знаки
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms и Google Drive являются товарными знаками
+Google LLC. Этот проект — независимая библиотека. Он не связан с Google LLC, не одобрен и не спонсируется ею, а
+товарные знаки используются только для описания того, с чем работает библиотека.
diff --git a/docs/readme/README.tr.md b/docs/readme/README.tr.md
new file mode 100644
index 00000000..636e5868
--- /dev/null
+++ b/docs/readme/README.tr.md
@@ -0,0 +1,307 @@
+
+
+
+
+
+
+
+
+- [Google Apps Script™ için yardımcı araçlar](#google-apps-script-için-yardımcı-araçlar)
+ - [Genel bakış](#genel-bakış)
+ - [Temel özellikler](#temel-özellikler)
+ - [Yapay zekâ ajanları için skill'ler](#yapay-zekâ-ajanları-için-skilller)
+ - [Gereksinimler](#gereksinimler)
+ - [Kurulum](#kurulum)
+ - [Dokümantasyon](#dokümantasyon)
+ - [Kullanım örnekleri](#kullanım-örnekleri)
+ - [Geliştirme](#geliştirme)
+ - [Betikler](#betikler)
+ - [Testler](#testler)
+ - [Proje yapısı](#proje-yapısı)
+ - [Kategorilere göre fonksiyonlar](#kategorilere-göre-fonksiyonlar)
+ - [Katkıda bulunma](#katkıda-bulunma)
+ - [Destek](#destek)
+ - [Yol haritası](#yol-haritası)
+ - [Değişiklik günlüğü](#değişiklik-günlüğü)
+ - [Lisans](#lisans)
+
+
+## Genel bakış
+
+**@bootgs/utils**, özellikle **Google Apps Script** için geliştirilmiş bir TypeScript yardımcı kütüphanesidir. Her GAS
+projesinin eninde sonunda elle yazdığı yardımcıları — tablo ve A1 gösterimi işlemleri, tür/değer doğrulaması
+(`isX`/`nonX`/`requireX`), dize ve dizi dönüşümleri, türlendirilmiş istisnalar ve daha fazlası — iyi belgelenmiş ve
+tamamen test edilmiş tek bir pakette bir araya getirir.
+
+## Temel özellikler
+
+- **Google Apps Script için geliştirildi** — genel amaçlı bir Node.js kütüphanesinden uyarlanmadı; GAS çalışma zamanı
+ ve onun kısıtlamaları göz önünde bulundurularak tasarlandı.
+- **Geniş kapsam** — genel amaçlı dize, dizi ve nesne yardımcılarının yanında tablo, UI, ağ ve Admin SDK yardımcıları.
+- **Önce TypeScript** — her fonksiyon, IDE'de otomatik tamamlama ve derleme zamanında güvenlik için eksiksiz tür
+ tanımlarıyla gelir.
+- **Test edilmiş** — Vitest birim test paketiyle kapsanır.
+- **Bağlantılı başvuru dokümantasyonu** — API'de kullanılan her Google Apps Script türü doğrudan resmî
+ dokümantasyonuna bağlanır.
+- **Tutarlı hata yönetimi** — rastgele fırlatılan hataların yerini özel bir istisna sınıfları hiyerarşisi alır.
+
+## Yapay zekâ ajanları için skill'ler
+
+Bir yapay zekâ kodlama ajanı (Claude Code, Gemini CLI ve diğerleri) kullanan ekipler için
+[bootgs/skills](https://github.com/bootgs/skills) deposu, bu kütüphaneyi söz konusu ajanlara tanıtan
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) Agent Skill'ini sunar:
+`isX`/`nonX`/`requireX` doğrulama kuralı, A1 gösterimi ve sayfa yardımcıları, dize/sayı/dizi yardımcıları,
+türlendirilmiş istisnalar ve HTML/JSON/yol yardımcıları dahil.
+
+Claude Code ile kurulum:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Birden fazla ajanı destekleyen `npx skills` CLI'ı ile kurulum:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Kurulduktan sonra ajan, bir görev bu kütüphaneyle ilgili olduğunda skill'i otomatik olarak uygular.
+
+## Gereksinimler
+
+- [Node.js](https://nodejs.org/) v22.14.0 veya üzeri
+- [npm](https://www.npmjs.com/) (ya da pnpm gibi başka bir Node paket yöneticisi)
+
+## Kurulum
+
+Paketi npm ile kurun:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Dokümantasyon
+
+Dokümantasyonun tamamı **** adresinde (İngilizce) yayımlanır: kılavuzlar, her modül
+için adım adım anlatımlar ve eksiksiz fonksiyon başvurusu. Kaynağı [`docs/writerside/`](../writerside/) dizinindedir
+ve `main` dalına yapılan her push'ta yeniden derlenir.
+
+Önerilen okuma sırası:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — ilk adımlar
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) —
+ `isX`/`nonX`/`requireX`/`requireNonX` adlandırma şeması
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — sınıf hiyerarşisi
+ ve her istisnaya neyin yol açtığı
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — hangi
+ yardımcıların bir Google hizmetine bağlı olduğu ve bunun test açısından ne anlama geldiği
+
+## Kullanım örnekleri
+
+### Sheets ile çalışma
+
+Birden fazla veri satırını verimli bir şekilde ekleyin:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Admin SDK yardımcıları
+
+Geçerli kullanıcının yönetici ayrıcalıklarına sahip olup olmadığını kontrol edin:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### A1 gösterimini ayrıştırma
+
+Karmaşık A1 gösterimlerini yapılandırılmış nesnelere ayrıştırın:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Geliştirme
+
+### Betikler
+
+`package.json` içinde şu betikler bulunur:
+
+| Betik | Açıklama |
+| :------------------- | :---------------------------------------------------------------------- |
+| `npm run build` | `dist` dizinini temizler ve TypeScript kaynak kodunu derler. |
+| `npm run dev` | Vitest'i izleme modunda başlatır. |
+| `npm test` | Test paketinin tamamını bir kez çalıştırır. |
+| `npm run type:check` | Çıktı üretmeden projenin tür denetimini yapar. |
+| `npm run lint` | Kod tabanını ESLint ile denetler. |
+| `npm run lint:fix` | Kod tabanını denetler ve düzeltebildiklerini otomatik olarak düzeltir. |
+| `npm run format` | Biçimlendirmeyi Prettier ile kontrol eder. |
+| `npm run format:fix` | Kod tabanını Prettier ile biçimlendirir. |
+| `npm run prepare` | Husky Git hook'larını kurar (kurulumdan sonra otomatik olarak çalışır). |
+
+### Testler
+
+Proje, birim testleri için [Vitest](https://vitest.dev/) kullanır.
+
+Paketin tamamını bir kez çalıştırın:
+
+```bash
+npm test
+```
+
+Ya da geliştirme sırasında izleme modunda çalıştırın:
+
+```bash
+npm run dev
+```
+
+## Proje yapısı
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Kategorilere göre fonksiyonlar
+
+Fonksiyon başvurusunun tamamı, [`docs/writerside/`](../writerside/) dizininden derlenen ve `main` dalına yapılan her
+push'ta yayımlanan dokümantasyon sitesine taşındı (İngilizce):
+
+****
+
+| Bölüm | Kapsam |
+| :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, ağ istekleri ve yerleşik UI sınıfları |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Tür denetimi ve doğrulama; dize, dizi ve nesne işlemleri; JSON ve HTML işleme |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | Türlendirilmiş istisna sınıfları ve her birine neyin yol açtığı |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Dosya yolları ve URL'ler |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Ortak yapı taşları |
+
+Site, başvurunun yanı sıra tablolara sığmayan kılavuzları da içerir:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html)
+`isX`/`nonX`/`requireX`/`requireNonX` şemasını tek bir yerde açıklar,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) sınıf hiyerarşisini
+ortaya koyar, [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+ise hangi yardımcıların bir Google hizmetine bağlı olduğunu, bunun maliyetini ve test açısından ne anlama geldiğini
+ele alır.
+
+## Katkıda bulunma
+
+Katkılarınızı memnuniyetle karşılıyoruz. Kılavuzun tamamı için [CONTRIBUTING.md](../../CONTRIBUTING.md) dosyasına bakın.
+Özetle:
+
+1. Depoyu fork'layın ve özelliğiniz ya da hata düzeltmeniz için bir dal oluşturun.
+2. Değişikliklerinizi kapsayan testleri ekleyin veya güncelleyin.
+3. Commit'ten önce `npm run lint` ve `npm run format` komutlarını çalıştırın.
+4. `CHANGELOG.md` dosyasını elle düzenlemeyin — [release-please](https://github.com/googleapis/release-please) tarafından otomatik olarak oluşturulur.
+5. Neyin neden değiştiğini açıklayan bir pull request açın.
+
+Mevcut kod stiline ve adlandırma kurallarına uyun. Topluluk kuralları için [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md)
+dosyasına bakın.
+
+## Destek
+
+- Hatalar veya özellik istekleri için GitHub'da bir [issue](https://github.com/bootgs/utils/issues)
+ arayın ya da açın.
+- Son değişiklikler için [değişiklik günlüğüne](../../CHANGELOG.md) bakın.
+- Bir güvenlik açığı bildirmek için herkese açık bir issue açmak yerine [güvenlik politikasını](../../SECURITY.md) izleyin.
+- Süregelen geliştirmeyi desteklemek için [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov) sayfasına
+ bakın.
+
+## Yol haritası
+
+Planlanan, üzerinde çalışılan ve tamamlanan işler, doğrudan issue takip sisteminden oluşturulan
+[proje panosunda](https://github.com/users/MaksymStoianov/projects/2/views/2) yer alır. Panoyla uyumsuz hâle
+gelebilecek ayrı bir yol haritası belgesi yoktur: bir öneriniz varsa bir [issue](https://github.com/bootgs/utils/issues)
+açın.
+
+## Değişiklik günlüğü
+
+Sürümlere göre değişikliklerin ayrıntılı listesi için [CHANGELOG.md](../../CHANGELOG.md) dosyasına bakın.
+
+## Lisans
+
+Bu proje Apache License 2.0 ile lisanslanmıştır. Ayrıntılar için [LICENSE](../../LICENSE) dosyasına bakın.
+
+Banner görseli bu lisansın kapsamında değildir. Sanatçısına aittir; sanatçının adı belirtilip bu atıf bağlantıyla
+verildiği sürece değiştirilmeden yeniden kullanılabilir ve [docs/assets/images/README.md](../assets/images/README.md)
+kapsamındadır.
+
+## Ticari markalar
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms ve Google Drive, Google LLC'nin ticari
+markalarıdır. Bu proje bağımsız bir kütüphanedir. Google LLC ile bağlantılı değildir, Google LLC tarafından
+onaylanmamış veya desteklenmemiştir; markalar yalnızca kütüphanenin hangi ürünlerle çalıştığını belirtmek için
+kullanılır.
diff --git a/docs/readme/README.uk.md b/docs/readme/README.uk.md
new file mode 100644
index 00000000..05465aeb
--- /dev/null
+++ b/docs/readme/README.uk.md
@@ -0,0 +1,302 @@
+
+
+
+
+
+
+[English](../../README.md) | **Українська** | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Цей переклад зроблено за допомогою ШІ з [README.md](../../README.md) для версії 2.1.1. Основною є англійська версія README; виправлення вітаються — див. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Утиліти для Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Утиліти для Google Apps Script™](#утиліти-для-google-apps-script)
+ - [Огляд](#огляд)
+ - [Ключові можливості](#ключові-можливості)
+ - [Навички для ШІ-агентів](#навички-для-ші-агентів)
+ - [Вимоги](#вимоги)
+ - [Встановлення](#встановлення)
+ - [Документація](#документація)
+ - [Приклади використання](#приклади-використання)
+ - [Розробка](#розробка)
+ - [Скрипти](#скрипти)
+ - [Тестування](#тестування)
+ - [Структура проєкту](#структура-проєкту)
+ - [Функції за категоріями](#функції-за-категоріями)
+ - [Участь у розробці](#участь-у-розробці)
+ - [Підтримка](#підтримка)
+ - [Дорожня карта](#дорожня-карта)
+ - [Журнал змін](#журнал-змін)
+ - [Ліцензія](#ліцензія)
+
+
+## Огляд
+
+**@bootgs/utils** — це бібліотека утиліт на TypeScript, створена спеціально для **Google Apps Script**. Вона
+збирає в одному добре задокументованому й повністю протестованому пакеті допоміжні функції, які кожен GAS-проєкт
+рано чи пізно пише вручну: роботу з таблицями та нотацією A1, перевірку типів і значень (`isX`/`nonX`/`requireX`),
+перетворення рядків і масивів, типізовані винятки тощо.
+
+## Ключові можливості
+
+- **Створено для Google Apps Script** — спроєктовано з урахуванням середовища виконання GAS та його обмежень, а не
+ адаптовано з універсальної бібліотеки для Node.js.
+- **Широке покриття утилітами** — допоміжні функції для таблиць, UI, мережі й Admin SDK поряд з універсальними
+ утилітами для рядків, масивів і об'єктів.
+- **TypeScript передусім** — кожна функція має повні визначення типів для автодоповнення в IDE та безпеки на етапі
+ компіляції.
+- **Протестовано** — покрито набором модульних тестів на Vitest.
+- **Довідкова документація з посиланнями** — кожен тип Google Apps Script, що використовується в API, посилається
+ безпосередньо на свою офіційну документацію.
+- **Послідовна обробка помилок** — окрема ієрархія класів винятків замінює довільно кинуті помилки.
+
+## Навички для ШІ-агентів
+
+Для команд, які користуються ШІ-агентом для програмування (Claude Code, Gemini CLI та інші), репозиторій
+[bootgs/skills](https://github.com/bootgs/skills) надає Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils), що описує цю бібліотеку
+для таких агентів: домовленість про перевірки `isX`/`nonX`/`requireX`, допоміжні функції для нотації A1 і аркушів,
+для рядків, чисел і масивів, типізовані винятки, а також допоміжні функції для HTML, JSON і шляхів.
+
+Встановлення в Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Встановлення через CLI `npx skills`, який підтримує різні агенти:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Після встановлення агент застосовує навичку автоматично, коли завдання стосується цієї бібліотеки.
+
+## Вимоги
+
+- [Node.js](https://nodejs.org/) v22.14.0 або новіший
+- [npm](https://www.npmjs.com/) (або інший менеджер пакетів для Node, наприклад pnpm)
+
+## Встановлення
+
+Встановіть пакет через npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Документація
+
+Повна документація опублікована за адресою **** — посібники,
+огляди окремих модулів і повний довідник функцій. Її джерело лежить у [`docs/writerside-uk/`](../writerside-uk/) і
+перезбирається після кожного push у `main`.
+
+Рекомендований порядок читання:
+
+- [Перші кроки](https://bootgs.github.io/utils/uk/getting-started.html)
+- [Домовленості про перевірки](https://bootgs.github.io/utils/uk/validation-conventions.html) —
+ схема імен `isX`/`nonX`/`requireX`/`requireNonX`
+- [Обробка винятків](https://bootgs.github.io/utils/uk/exception-handling.html) — ієрархія
+ класів і причини кожного винятку
+- [Середовище виконання Apps Script](https://bootgs.github.io/utils/uk/apps-script-runtime.html) —
+ які допоміжні функції прив'язані до сервісу Google і що це означає для тестування
+
+## Приклади використання
+
+### Робота з аркушами
+
+Ефективне додавання кількох рядків даних:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Утиліти Admin SDK
+
+Перевірка, чи має поточний користувач права адміністратора:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Розбір нотації A1
+
+Розбір складних нотацій A1 у структуровані об'єкти:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Розробка
+
+### Скрипти
+
+У `package.json` доступні такі скрипти:
+
+| Скрипт | Опис |
+| :------------------- | :------------------------------------------------------------------ |
+| `npm run build` | Очищає каталог `dist` і компілює вихідний код TypeScript. |
+| `npm run dev` | Запускає Vitest у режимі спостереження. |
+| `npm test` | Один раз запускає весь набір тестів. |
+| `npm run type:check` | Перевіряє типи в проєкті без генерації вихідних файлів. |
+| `npm run lint` | Перевіряє код за допомогою ESLint. |
+| `npm run lint:fix` | Перевіряє код і автоматично виправляє те, що може. |
+| `npm run format` | Перевіряє форматування за допомогою Prettier. |
+| `npm run format:fix` | Форматує код за допомогою Prettier. |
+| `npm run prepare` | Налаштовує git-хуки Husky (запускається автоматично після install). |
+
+### Тестування
+
+Для модульного тестування проєкт використовує [Vitest](https://vitest.dev/).
+
+Запустити весь набір один раз:
+
+```bash
+npm test
+```
+
+Або запустити в режимі спостереження під час розробки:
+
+```bash
+npm run dev
+```
+
+## Структура проєкту
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Функції за категоріями
+
+Повний довідник функцій переїхав на сайт документації, який збирається з
+[`docs/writerside-uk/`](../writerside-uk/) і публікується після кожного push у `main`:
+
+****
+
+| Розділ | Що охоплює |
+| :--------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- |
+| [Модуль Google Apps Script](https://bootgs.github.io/utils/uk/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, мережеві запити й вбудовані класи UI |
+| [Базові утиліти](https://bootgs.github.io/utils/uk/reference-base.html) | Перевірка типів і значень, робота з рядками, масивами й об'єктами, обробка JSON і HTML |
+| [Винятки](https://bootgs.github.io/utils/uk/reference-exception.html) | Типізовані класи винятків і причини кожного з них |
+| [Модуль `path`](https://bootgs.github.io/utils/uk/reference-path.html) | Шляхи до файлів і URL |
+| [Абстракції та інтерфейси](https://bootgs.github.io/utils/uk/reference-abstracts.html) | Спільні будівельні блоки |
+
+Окрім довідника, на сайті є посібники, які не вмістилися б у таблиці:
+[домовленості про перевірки](https://bootgs.github.io/utils/uk/validation-conventions.html)
+пояснюють схему `isX`/`nonX`/`requireX`/`requireNonX` в одному місці,
+[обробка винятків](https://bootgs.github.io/utils/uk/exception-handling.html) описує ієрархію
+класів, а [середовище виконання Apps Script](https://bootgs.github.io/utils/uk/apps-script-runtime.html)
+розповідає, які допоміжні функції прив'язані до сервісу Google, чого це коштує і що це означає для тестування.
+
+## Участь у розробці
+
+Внески вітаються. Повний посібник — у [CONTRIBUTING.md](../../CONTRIBUTING.md). Коротко:
+
+1. Зробіть форк репозиторію та створіть гілку для своєї функції чи виправлення.
+2. Додайте або оновіть тести, що покривають ваші зміни.
+3. Перед комітом запустіть `npm run lint` і `npm run format`.
+4. Не редагуйте `CHANGELOG.md` вручну — його автоматично генерує [release-please](https://github.com/googleapis/release-please).
+5. Відкрийте pull request з описом того, що змінилося і чому.
+
+Дотримуйтеся наявного стилю коду та домовленостей щодо імен. Правила спільноти — у
+[CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Підтримка
+
+- Щоб повідомити про помилку чи запропонувати функцію, знайдіть або відкрийте
+ [issue](https://github.com/bootgs/utils/issues) на GitHub.
+- Останні зміни — у [журналі змін](../../CHANGELOG.md).
+- Щоб повідомити про вразливість, дотримуйтеся [політики безпеки](../../SECURITY.md), а не відкривайте публічний issue.
+- Підтримати подальшу розробку можна через [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Дорожня карта
+
+Що заплановано, що в роботі, а що вже зроблено — на [дошці проєкту](https://github.com/users/MaksymStoianov/projects/2/views/2),
+яка будується з самого трекера issues. Окремого документа з дорожньою картою, що міг би з нею розійтися, немає: щоб
+щось запропонувати, відкрийте [issue](https://github.com/bootgs/utils/issues).
+
+## Журнал змін
+
+Докладний перелік змін за версіями — у [CHANGELOG.md](../../CHANGELOG.md).
+
+## Ліцензія
+
+Проєкт поширюється за ліцензією Apache License 2.0. Подробиці — у [LICENSE](../../LICENSE).
+
+Ілюстрація банера не підпадає під цю ліцензію. Це робота її авторки; її можна використовувати без змін, зазначивши
+авторку з посиланням, а умови описано в [docs/assets/images/README.md](../assets/images/README.md).
+
+## Торговельні марки
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms і Google Drive є торговельними марками
+Google LLC. Цей проєкт — незалежна бібліотека. Він не пов'язаний із Google LLC, не схвалений і не спонсорований нею, а
+торговельні марки вжито лише для опису того, з чим працює бібліотека.
diff --git a/docs/readme/README.vi.md b/docs/readme/README.vi.md
new file mode 100644
index 00000000..81085219
--- /dev/null
+++ b/docs/readme/README.vi.md
@@ -0,0 +1,304 @@
+
+
+
+
+
+
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | **Tiếng Việt** | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+
+> Bản dịch này được thực hiện với sự hỗ trợ của AI từ [README.md](../../README.md) cho phiên bản 2.1.1. Phiên bản tham chiếu là README tiếng Anh; mọi góp ý chỉnh sửa đều được hoan nghênh — xem [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+
+# Tiện ích cho Google Apps Script™
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- [Tiện ích cho Google Apps Script™](#tiện-ích-cho-google-apps-script)
+ - [Tổng quan](#tổng-quan)
+ - [Tính năng chính](#tính-năng-chính)
+ - [Skill cho tác tử AI](#skill-cho-tác-tử-ai)
+ - [Yêu cầu](#yêu-cầu)
+ - [Cài đặt](#cài-đặt)
+ - [Tài liệu](#tài-liệu)
+ - [Ví dụ sử dụng](#ví-dụ-sử-dụng)
+ - [Phát triển](#phát-triển)
+ - [Scripts](#scripts)
+ - [Kiểm thử](#kiểm-thử)
+ - [Cấu trúc dự án](#cấu-trúc-dự-án)
+ - [Hàm theo danh mục](#hàm-theo-danh-mục)
+ - [Đóng góp](#đóng-góp)
+ - [Hỗ trợ](#hỗ-trợ)
+ - [Lộ trình](#lộ-trình)
+ - [Nhật ký thay đổi](#nhật-ký-thay-đổi)
+ - [Giấy phép](#giấy-phép)
+
+
+## Tổng quan
+
+**@bootgs/utils** là một thư viện tiện ích TypeScript được xây dựng riêng cho **Google Apps Script**. Thư viện tập hợp
+những hàm trợ giúp mà dự án GAS nào rồi cũng phải tự viết — thao tác với bảng tính và ký hiệu A1, kiểm tra kiểu và giá
+trị (`isX`/`nonX`/`requireX`), biến đổi chuỗi và mảng, các ngoại lệ có kiểu, và nhiều hơn nữa — trong một gói duy nhất,
+có tài liệu đầy đủ và được kiểm thử toàn diện.
+
+## Tính năng chính
+
+- **Xây dựng cho Google Apps Script** — được thiết kế xoay quanh runtime GAS và các giới hạn của nó, không phải chuyển
+ thể từ một thư viện Node.js chung chung.
+- **Phạm vi tiện ích rộng** — các hàm trợ giúp cho bảng tính, UI, mạng và Admin SDK, bên cạnh các tiện ích đa dụng cho
+ chuỗi, mảng và đối tượng.
+- **Ưu tiên TypeScript** — mọi hàm đều đi kèm định nghĩa kiểu đầy đủ để IDE tự động gợi ý và đảm bảo an toàn khi biên
+ dịch.
+- **Được kiểm thử** — được bao phủ bởi bộ kiểm thử đơn vị Vitest.
+- **Tài liệu tham chiếu có liên kết** — mọi kiểu Google Apps Script dùng trong API đều liên kết trực tiếp tới tài liệu
+ chính thức của nó.
+- **Xử lý lỗi nhất quán** — một hệ thống phân cấp lớp ngoại lệ chuyên biệt thay cho các lỗi được ném ra tùy tiện.
+
+## Skill cho tác tử AI
+
+Với các nhóm đang dùng tác tử lập trình AI (Claude Code, Gemini CLI và các công cụ khác), kho mã
+[bootgs/skills](https://github.com/bootgs/skills) cung cấp Agent Skill
+[`@bootgs/utils`](https://github.com/bootgs/skills/tree/main/skills/apps-script-utils) mô tả thư viện này cho các tác
+tử đó, bao gồm quy ước kiểm tra `isX`/`nonX`/`requireX`, các hàm trợ giúp cho ký hiệu A1 và trang tính, cho chuỗi, số
+và mảng, các ngoại lệ có kiểu, cùng các hàm trợ giúp cho HTML, JSON và đường dẫn.
+
+Cài đặt với Claude Code:
+
+```bash
+/plugin marketplace add bootgs/skills
+/plugin install apps-script-utils@bootgs-skills
+```
+
+Cài đặt bằng CLI `npx skills`, hỗ trợ nhiều tác tử:
+
+```bash
+npx skills add bootgs/skills --skill apps-script-utils
+```
+
+Sau khi cài đặt, tác tử sẽ tự động áp dụng skill khi một tác vụ liên quan đến thư viện này.
+
+## Yêu cầu
+
+- [Node.js](https://nodejs.org/) v22.14.0 trở lên
+- [npm](https://www.npmjs.com/) (hoặc một trình quản lý gói Node khác, ví dụ pnpm)
+
+## Cài đặt
+
+Cài đặt gói qua npm:
+
+```bash
+npm install @bootgs/utils
+```
+
+## Tài liệu
+
+Tài liệu đầy đủ được xuất bản tại **** (bằng tiếng Anh): các hướng
+dẫn, phần giới thiệu từng module và tài liệu tham chiếu đầy đủ của các hàm. Mã nguồn của tài liệu nằm trong
+[`docs/writerside/`](../writerside/) và được build lại mỗi lần push lên `main`.
+
+Thứ tự đọc được đề xuất:
+
+- [Getting started](https://bootgs.github.io/utils/getting-started.html) — những bước đầu tiên
+- [Validation conventions](https://bootgs.github.io/utils/validation-conventions.html) — quy ước
+ đặt tên `isX`/`nonX`/`requireX`/`requireNonX`
+- [Exception handling](https://bootgs.github.io/utils/exception-handling.html) — hệ thống phân cấp
+ lớp và nguyên nhân phát sinh từng ngoại lệ
+- [The Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html) — những hàm
+ trợ giúp nào gắn với một dịch vụ của Google, và điều đó có ý nghĩa gì đối với việc kiểm thử
+
+## Ví dụ sử dụng
+
+### Làm việc với trang tính
+
+Nối thêm nhiều hàng dữ liệu một cách hiệu quả:
+
+```typescript
+import { appendRows } from "@bootgs/utils";
+
+const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data");
+const data = [
+ ["John Doe", "john@example.com", 28],
+ ["Jane Smith", "jane@example.com", 32]
+];
+
+appendRows(sheet, data);
+```
+
+### Tiện ích Admin SDK
+
+Kiểm tra xem người dùng hiện tại có quyền quản trị hay không:
+
+```typescript
+import { isAdmin } from "@bootgs/utils";
+
+if (isAdmin()) {
+ Logger.log("Access granted to admin panel.");
+} else {
+ Logger.log("Access denied.");
+}
+```
+
+### Phân tích ký hiệu A1
+
+Phân tích các ký hiệu A1 phức tạp thành các đối tượng có cấu trúc:
+
+```typescript
+import { parseA1Notation } from "@bootgs/utils";
+
+const rangeInfo = parseA1Notation("'Sheet1'!A1:B10");
+
+console.log(rangeInfo.sheetName); // "Sheet1"
+console.log(rangeInfo.startRowIndex); // 0
+console.log(rangeInfo.endColumnIndex); // 2
+```
+
+## Phát triển
+
+### Scripts
+
+Các script sau có sẵn trong `package.json`:
+
+| Script | Mô tả |
+| :------------------- | :----------------------------------------------------------- |
+| `npm run build` | Dọn thư mục `dist` và biên dịch mã nguồn TypeScript. |
+| `npm run dev` | Khởi chạy Vitest ở chế độ theo dõi (watch). |
+| `npm test` | Chạy toàn bộ bộ kiểm thử một lần. |
+| `npm run type:check` | Kiểm tra kiểu của dự án mà không xuất ra kết quả build. |
+| `npm run lint` | Kiểm tra mã nguồn bằng ESLint. |
+| `npm run lint:fix` | Kiểm tra mã nguồn và tự động sửa những gì có thể. |
+| `npm run format` | Kiểm tra định dạng bằng Prettier. |
+| `npm run format:fix` | Định dạng mã nguồn bằng Prettier. |
+| `npm run prepare` | Thiết lập Git hook của Husky (tự động chạy sau khi cài đặt). |
+
+### Kiểm thử
+
+Dự án sử dụng [Vitest](https://vitest.dev/) để kiểm thử đơn vị.
+
+Chạy toàn bộ bộ kiểm thử một lần:
+
+```bash
+npm test
+```
+
+Hoặc chạy ở chế độ theo dõi trong khi phát triển:
+
+```bash
+npm run dev
+```
+
+## Cấu trúc dự án
+
+```text
+.
+├── config/ # Configuration files
+├── dist/ # Compiled output (after build)
+├── docs/ # Documentation: assets and the Writerside source
+├── scripts/ # Maintenance and helper scripts
+├── src/ # Source code
+│ ├── appsscript/ # Google Apps Script specific utilities
+│ ├── exception/ # Custom exception classes
+│ ├── html/ # HTML utilities
+│ ├── json/ # JSON utilities
+│ ├── lang/ # Language-level utilities (array, string, etc.)
+│ ├── net/ # Network and path utilities
+│ ├── time/ # Time-related utilities
+│ └── index.ts # Main entry point
+├── test/ # Unit tests
+└── vitest.config.ts # Vitest configuration
+```
+
+## Hàm theo danh mục
+
+Tài liệu tham chiếu đầy đủ của các hàm đã được chuyển sang trang tài liệu, được build từ
+[`docs/writerside/`](../writerside/) và xuất bản mỗi lần push lên `main`:
+
+****
+
+| Phần | Nội dung |
+| :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------- |
+| [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets, Slides, Admin SDK, Drive, Docs, Forms, yêu cầu mạng và các lớp UI dựng sẵn |
+| [Base utilities](https://bootgs.github.io/utils/reference-base.html) | Kiểm tra kiểu và xác thực, thao tác với chuỗi, mảng và đối tượng, xử lý JSON và HTML |
+| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | Các lớp ngoại lệ có kiểu và nguyên nhân phát sinh từng loại |
+| [`path` module](https://bootgs.github.io/utils/reference-path.html) | Đường dẫn tệp và URL |
+| [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | Các thành phần dùng chung |
+
+Bên cạnh tài liệu tham chiếu, trang web còn có những hướng dẫn mà các bảng không thể trình bày hết:
+[validation conventions](https://bootgs.github.io/utils/validation-conventions.html) giải thích quy
+ước `isX`/`nonX`/`requireX`/`requireNonX` tại một nơi duy nhất,
+[exception handling](https://bootgs.github.io/utils/exception-handling.html) trình bày hệ thống
+phân cấp lớp, còn [the Apps Script runtime](https://bootgs.github.io/utils/apps-script-runtime.html)
+cho biết những hàm trợ giúp nào gắn với một dịch vụ của Google, điều đó tốn kém gì và có ý nghĩa gì đối với việc kiểm
+thử.
+
+## Đóng góp
+
+Chúng tôi hoan nghênh mọi đóng góp. Xem hướng dẫn đầy đủ tại [CONTRIBUTING.md](../../CONTRIBUTING.md). Tóm tắt:
+
+1. Fork kho mã và tạo một nhánh cho tính năng hoặc bản sửa lỗi của bạn.
+2. Thêm hoặc cập nhật kiểm thử để bao phủ các thay đổi của bạn.
+3. Chạy `npm run lint` và `npm run format` trước khi commit.
+4. Không chỉnh sửa `CHANGELOG.md` thủ công — tệp này được tạo tự động bởi [release-please](https://github.com/googleapis/release-please).
+5. Mở một pull request mô tả những gì đã thay đổi và lý do.
+
+Hãy tuân theo phong cách mã và quy ước đặt tên hiện có. Xem [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md) để biết các quy
+tắc của cộng đồng.
+
+## Hỗ trợ
+
+- Đối với lỗi hoặc yêu cầu tính năng, hãy tìm kiếm hoặc mở một [issue](https://github.com/bootgs/utils/issues)
+ trên GitHub.
+- Để xem các thay đổi gần đây, hãy xem [nhật ký thay đổi](../../CHANGELOG.md).
+- Để báo cáo lỗ hổng bảo mật, hãy làm theo [chính sách bảo mật](../../SECURITY.md) thay vì mở một issue công khai.
+- Để ủng hộ việc phát triển liên tục, hãy xem [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov).
+
+## Lộ trình
+
+Những việc đã lên kế hoạch, đang thực hiện hoặc đã hoàn thành có trên [bảng dự án](https://github.com/users/MaksymStoianov/projects/2/views/2),
+được xây dựng trực tiếp từ trình theo dõi issue. Không có tài liệu lộ trình riêng nào có thể bị lệch so với nó: để
+đề xuất điều gì đó, hãy mở một [issue](https://github.com/bootgs/utils/issues).
+
+## Nhật ký thay đổi
+
+Để xem danh sách chi tiết các thay đổi theo từng phiên bản, hãy xem [CHANGELOG.md](../../CHANGELOG.md).
+
+## Giấy phép
+
+Dự án này được cấp phép theo Apache License 2.0. Xem [LICENSE](../../LICENSE) để biết chi tiết.
+
+Hình minh họa banner không thuộc phạm vi giấy phép đó. Đây là tác phẩm của tác giả, có thể được tái sử dụng mà không
+chỉnh sửa với điều kiện ghi công tác giả kèm liên kết, và được điều chỉnh bởi
+[docs/assets/images/README.md](../assets/images/README.md).
+
+## Nhãn hiệu
+
+Google Apps Script, Google Sheets, Google Slides, Google Docs, Google Forms và Google Drive là các nhãn hiệu của Google
+LLC. Dự án này là một thư viện độc lập. Dự án không liên kết với, không được Google LLC xác nhận hay tài trợ, và các
+nhãn hiệu chỉ được dùng để mô tả các sản phẩm mà thư viện hoạt động cùng.
diff --git a/docs/readme/README.zh-TW.md b/docs/readme/README.zh-TW.md
new file mode 100644
index 00000000..02832351
--- /dev/null
+++ b/docs/readme/README.zh-TW.md
@@ -0,0 +1,273 @@
+
+
+
+
+
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/appsscript/admin/AdminDirectoryException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/appsscript/admin/AdminDirectoryException.ts)
+[`src/exception/appsscript/admin/AdminDirectoryException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/appsscript/admin/AdminDirectoryException.ts)
diff --git a/docs/writerside-de/topics/AuthenticationException.md b/docs/writerside-de/topics/AuthenticationException.md
index 3e532f84..c044cda7 100644
--- a/docs/writerside-de/topics/AuthenticationException.md
+++ b/docs/writerside-de/topics/AuthenticationException.md
@@ -4,7 +4,7 @@
Die Authentifizierung schlug fehl: wer aufruft, ließ sich nicht feststellen.
-AuthenticationException — Die Authentifizierung schlug fehl: wer aufruft, ließ sich nicht feststellen. apps-script-utils, Deutsch.
+AuthenticationException — Die Authentifizierung schlug fehl: wer aufruft, ließ sich nicht feststellen. @bootgs/utils, Deutsch.
Modul: exception/net · Verfügbar seit: 1.5.0
@@ -42,4 +42,4 @@ try {
## Quellcode
-[`src/exception/net/AuthenticationException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/net/AuthenticationException.ts)
+[`src/exception/net/AuthenticationException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/net/AuthenticationException.ts)
diff --git a/docs/writerside-de/topics/AuthorizationException.md b/docs/writerside-de/topics/AuthorizationException.md
index 3cba94fe..2aefbc37 100644
--- a/docs/writerside-de/topics/AuthorizationException.md
+++ b/docs/writerside-de/topics/AuthorizationException.md
@@ -4,7 +4,7 @@
Der Aufrufer ist bekannt, darf dies aber nicht.
-AuthorizationException — Der Aufrufer ist bekannt, darf dies aber nicht. apps-script-utils, Deutsch.
+AuthorizationException — Der Aufrufer ist bekannt, darf dies aber nicht. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.11.0
@@ -42,4 +42,4 @@ try {
## Quellcode
-[`src/exception/AuthorizationException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/AuthorizationException.ts)
+[`src/exception/AuthorizationException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/AuthorizationException.ts)
diff --git a/docs/writerside-de/topics/Class.md b/docs/writerside-de/topics/Class.md
index a5c5cbfa..6af34fe7 100644
--- a/docs/writerside-de/topics/Class.md
+++ b/docs/writerside-de/topics/Class.md
@@ -4,7 +4,7 @@
Die abstrakte Basis, von der die eigenen Klassen der Bibliothek erben.
-Class — Die abstrakte Basis, von der die eigenen Klassen der Bibliothek erben. apps-script-utils, Deutsch.
+Class — Die abstrakte Basis, von der die eigenen Klassen der Bibliothek erben. @bootgs/utils, Deutsch.
Modul: lang · Verfügbar seit: 1.0.0
@@ -38,4 +38,4 @@ class Money extends Class {
## Quellcode
-[`src/lang/Class.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/lang/Class.ts)
+[`src/lang/Class.ts`](https://github.com/bootgs/utils/blob/main/src/lang/Class.ts)
diff --git a/docs/writerside-de/topics/ColumnConditionalOptions.md b/docs/writerside-de/topics/ColumnConditionalOptions.md
index 65d36e59..5dc3b089 100644
--- a/docs/writerside-de/topics/ColumnConditionalOptions.md
+++ b/docs/writerside-de/topics/ColumnConditionalOptions.md
@@ -4,7 +4,7 @@
Wie die Spalten gelesen werden und welche als Kandidaten gelten.
-ColumnConditionalOptions — Wie die Spalten gelesen werden und welche als Kandidaten gelten. apps-script-utils, Deutsch.
+ColumnConditionalOptions — Wie die Spalten gelesen werden und welche als Kandidaten gelten. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -33,4 +33,4 @@ const options = { headerColumn: 1 };
## Quellcode
-[`src/appsscript/sheet/clearColumnsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/clearColumnsByConditional.ts)
+[`src/appsscript/sheet/clearColumnsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/clearColumnsByConditional.ts)
diff --git a/docs/writerside-de/topics/ColumnPredicate.md b/docs/writerside-de/topics/ColumnPredicate.md
index 849c5b93..794777bc 100644
--- a/docs/writerside-de/topics/ColumnPredicate.md
+++ b/docs/writerside-de/topics/ColumnPredicate.md
@@ -4,7 +4,7 @@
Entscheidet, ob eine Spalte eine ist, auf die gewirkt wird.
-ColumnPredicate — Entscheidet, ob eine Spalte eine ist, auf die gewirkt wird. apps-script-utils, Deutsch.
+ColumnPredicate — Entscheidet, ob eine Spalte eine ist, auf die gewirkt wird. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -33,4 +33,4 @@ const predicate = (values) => values.every((cell) => cell === "");
## Quellcode
-[`src/appsscript/sheet/clearColumnsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/clearColumnsByConditional.ts)
+[`src/appsscript/sheet/clearColumnsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/clearColumnsByConditional.ts)
diff --git a/docs/writerside-de/topics/EmptyStringException.md b/docs/writerside-de/topics/EmptyStringException.md
index 1dffc651..5b44d048 100644
--- a/docs/writerside-de/topics/EmptyStringException.md
+++ b/docs/writerside-de/topics/EmptyStringException.md
@@ -4,7 +4,7 @@
Von einer Zeichenkette war Inhalt erwartet, sie war null, undefined oder leer.
-EmptyStringException — Von einer Zeichenkette war Inhalt erwartet, sie war null, undefined oder leer. apps-script-utils, Deutsch.
+EmptyStringException — Von einer Zeichenkette war Inhalt erwartet, sie war null, undefined oder leer. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.0.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/EmptyStringException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/EmptyStringException.ts)
+[`src/exception/EmptyStringException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/EmptyStringException.ts)
diff --git a/docs/writerside-de/topics/Exception.md b/docs/writerside-de/topics/Exception.md
index e40f0a02..4978c5be 100644
--- a/docs/writerside-de/topics/Exception.md
+++ b/docs/writerside-de/topics/Exception.md
@@ -4,7 +4,7 @@
Die Wurzel der Hierarchie, abgeleitet von Error.
-Exception — Die Wurzel der Hierarchie, abgeleitet von Error. apps-script-utils, Deutsch.
+Exception — Die Wurzel der Hierarchie, abgeleitet von Error. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.0.0
@@ -42,4 +42,4 @@ try {
## Quellcode
-[`src/exception/Exception.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/Exception.ts)
+[`src/exception/Exception.ts`](https://github.com/bootgs/utils/blob/main/src/exception/Exception.ts)
diff --git a/docs/writerside-de/topics/Falsy.md b/docs/writerside-de/topics/Falsy.md
index c4a82ed6..f945ca4e 100644
--- a/docs/writerside-de/topics/Falsy.md
+++ b/docs/writerside-de/topics/Falsy.md
@@ -4,7 +4,7 @@
Die Werte, die JavaScript in einem booleschen Kontext als falsch behandelt.
-Falsy — Die Werte, die JavaScript in einem booleschen Kontext als falsch behandelt. apps-script-utils, Deutsch.
+Falsy — Die Werte, die JavaScript in einem booleschen Kontext als falsch behandelt. @bootgs/utils, Deutsch.
@@ -32,4 +32,4 @@ const rewrite = (formula, row, column) => formula.replace("Sheet1", "Data");
## Quellcode
-[`src/appsscript/sheet/updateFormulas.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/updateFormulas.ts)
+[`src/appsscript/sheet/updateFormulas.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/updateFormulas.ts)
diff --git a/docs/writerside-de/topics/GetValuesConfig.md b/docs/writerside-de/topics/GetValuesConfig.md
index a57c18ee..b281baf0 100644
--- a/docs/writerside-de/topics/GetValuesConfig.md
+++ b/docs/writerside-de/topics/GetValuesConfig.md
@@ -4,7 +4,7 @@
Wie `getValues` ein Blatt liest.
-GetValuesConfig — Wie `getValues` ein Blatt liest. apps-script-utils, Deutsch.
+GetValuesConfig — Wie `getValues` ein Blatt liest. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -38,4 +38,4 @@ const config = {
## Quellcode
-[`src/appsscript/sheet/getValues.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/getValues.ts)
+[`src/appsscript/sheet/getValues.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/getValues.ts)
diff --git a/docs/writerside-de/topics/GridRange.md b/docs/writerside-de/topics/GridRange.md
index c7e14067..046fb5a0 100644
--- a/docs/writerside-de/topics/GridRange.md
+++ b/docs/writerside-de/topics/GridRange.md
@@ -4,7 +4,7 @@
Ein Zellblock, beschrieben wie ihn die Sheets-API beschreibt.
-GridRange — Ein Zellblock, beschrieben wie ihn die Sheets-API beschreibt. apps-script-utils, Deutsch.
+GridRange — Ein Zellblock, beschrieben wie ihn die Sheets-API beschreibt. @bootgs/utils, Deutsch.
@@ -42,4 +42,4 @@ const range = {
## Quellcode
-[`src/appsscript/sheet/types/GridRange.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/types/GridRange.ts)
+[`src/appsscript/sheet/types/GridRange.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/types/GridRange.ts)
diff --git a/docs/writerside-de/topics/IllegalArgumentException.md b/docs/writerside-de/topics/IllegalArgumentException.md
index b425f003..fc95cfed 100644
--- a/docs/writerside-de/topics/IllegalArgumentException.md
+++ b/docs/writerside-de/topics/IllegalArgumentException.md
@@ -4,7 +4,7 @@
Ein Argument war von der falschen Art oder lag außerhalb des akzeptierten Bereichs.
-IllegalArgumentException — Ein Argument war von der falschen Art oder lag außerhalb des akzeptierten Bereichs. apps-script-utils, Deutsch.
+IllegalArgumentException — Ein Argument war von der falschen Art oder lag außerhalb des akzeptierten Bereichs. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.0.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/IllegalArgumentException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/IllegalArgumentException.ts)
+[`src/exception/IllegalArgumentException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/IllegalArgumentException.ts)
diff --git a/docs/writerside-de/topics/IllegalStateException.md b/docs/writerside-de/topics/IllegalStateException.md
index d62879b5..46ae5c41 100644
--- a/docs/writerside-de/topics/IllegalStateException.md
+++ b/docs/writerside-de/topics/IllegalStateException.md
@@ -4,7 +4,7 @@
Der Aufruf kam zum falschen Zeitpunkt: die Argumente mögen gültig sein, aber das Objekt ist nicht in einem Zustand, der ihn erlaubt.
-IllegalStateException — Der Aufruf kam zum falschen Zeitpunkt: die Argumente mögen gültig sein, aber das Objekt ist nicht in einem Zustand, der ihn erlaubt. apps-script-utils, Deutsch.
+IllegalStateException — Der Aufruf kam zum falschen Zeitpunkt: die Argumente mögen gültig sein, aber das Objekt ist nicht in einem Zustand, der ihn erlaubt. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.11.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/IllegalStateException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/IllegalStateException.ts)
+[`src/exception/IllegalStateException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/IllegalStateException.ts)
diff --git a/docs/writerside-de/topics/InvalidEmailFormatException.md b/docs/writerside-de/topics/InvalidEmailFormatException.md
index 0bf9098c..663011b9 100644
--- a/docs/writerside-de/topics/InvalidEmailFormatException.md
+++ b/docs/writerside-de/topics/InvalidEmailFormatException.md
@@ -4,7 +4,7 @@
Eine Zeichenkette sollte eine E-Mail-Adresse sein und hat nicht deren Form.
-InvalidEmailFormatException — Eine Zeichenkette sollte eine E-Mail-Adresse sein und hat nicht deren Form. apps-script-utils, Deutsch.
+InvalidEmailFormatException — Eine Zeichenkette sollte eine E-Mail-Adresse sein und hat nicht deren Form. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.0.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/InvalidEmailFormatException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/InvalidEmailFormatException.ts)
+[`src/exception/InvalidEmailFormatException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/InvalidEmailFormatException.ts)
diff --git a/docs/writerside-de/topics/InvalidGridRangeException.md b/docs/writerside-de/topics/InvalidGridRangeException.md
index 4b8db1b9..082df078 100644
--- a/docs/writerside-de/topics/InvalidGridRangeException.md
+++ b/docs/writerside-de/topics/InvalidGridRangeException.md
@@ -4,7 +4,7 @@
Ein GridRange war erwartet, das Objekt ist kein gültiges — Grenzen fehlen, stehen verkehrt herum oder sind negativ.
-InvalidGridRangeException — Ein GridRange war erwartet, das Objekt ist kein gültiges — Grenzen fehlen, stehen verkehrt herum oder sind negativ. apps-script-utils, Deutsch.
+InvalidGridRangeException — Ein GridRange war erwartet, das Objekt ist kein gültiges — Grenzen fehlen, stehen verkehrt herum oder sind negativ. @bootgs/utils, Deutsch.
@@ -42,4 +42,4 @@ try {
## Quellcode
-[`src/exception/appsscript/sheet/InvalidGridRangeException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/appsscript/sheet/InvalidGridRangeException.ts)
+[`src/exception/appsscript/sheet/InvalidGridRangeException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/appsscript/sheet/InvalidGridRangeException.ts)
diff --git a/docs/writerside-de/topics/InvalidPresentationException.md b/docs/writerside-de/topics/InvalidPresentationException.md
index 9c0a2c84..9b815efd 100644
--- a/docs/writerside-de/topics/InvalidPresentationException.md
+++ b/docs/writerside-de/topics/InvalidPresentationException.md
@@ -4,7 +4,7 @@
Eine Präsentation war erwartet, der Wert ist keine.
-InvalidPresentationException — Eine Präsentation war erwartet, der Wert ist keine. apps-script-utils, Deutsch.
+InvalidPresentationException — Eine Präsentation war erwartet, der Wert ist keine. @bootgs/utils, Deutsch.
@@ -45,4 +45,4 @@ try {
## Quellcode
-[`src/exception/appsscript/slide/InvalidPresentationException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/appsscript/slide/InvalidPresentationException.ts)
+[`src/exception/appsscript/slide/InvalidPresentationException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/appsscript/slide/InvalidPresentationException.ts)
diff --git a/docs/writerside-de/topics/InvalidRangeException.md b/docs/writerside-de/topics/InvalidRangeException.md
index 7ef03353..231a4993 100644
--- a/docs/writerside-de/topics/InvalidRangeException.md
+++ b/docs/writerside-de/topics/InvalidRangeException.md
@@ -4,7 +4,7 @@
Ein Bereich war erwartet, der Wert ist keiner.
-InvalidRangeException — Ein Bereich war erwartet, der Wert ist keiner. apps-script-utils, Deutsch.
+InvalidRangeException — Ein Bereich war erwartet, der Wert ist keiner. @bootgs/utils, Deutsch.
@@ -45,4 +45,4 @@ try {
## Quellcode
-[`src/exception/appsscript/sheet/InvalidRangeException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/appsscript/sheet/InvalidRangeException.ts)
+[`src/exception/appsscript/sheet/InvalidRangeException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/appsscript/sheet/InvalidRangeException.ts)
diff --git a/docs/writerside-de/topics/InvalidSheetException.md b/docs/writerside-de/topics/InvalidSheetException.md
index e96070fe..999cd860 100644
--- a/docs/writerside-de/topics/InvalidSheetException.md
+++ b/docs/writerside-de/topics/InvalidSheetException.md
@@ -4,7 +4,7 @@
Ein Blatt war erwartet, der Wert ist keines.
-InvalidSheetException — Ein Blatt war erwartet, der Wert ist keines. apps-script-utils, Deutsch.
+InvalidSheetException — Ein Blatt war erwartet, der Wert ist keines. @bootgs/utils, Deutsch.
@@ -45,4 +45,4 @@ try {
## Quellcode
-[`src/exception/appsscript/sheet/InvalidSheetException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/appsscript/sheet/InvalidSheetException.ts)
+[`src/exception/appsscript/sheet/InvalidSheetException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/appsscript/sheet/InvalidSheetException.ts)
diff --git a/docs/writerside-de/topics/InvalidSpreadsheetException.md b/docs/writerside-de/topics/InvalidSpreadsheetException.md
index 2414271b..1c1e418b 100644
--- a/docs/writerside-de/topics/InvalidSpreadsheetException.md
+++ b/docs/writerside-de/topics/InvalidSpreadsheetException.md
@@ -4,7 +4,7 @@
Eine Tabelle war erwartet, der Wert ist keine.
-InvalidSpreadsheetException — Eine Tabelle war erwartet, der Wert ist keine. apps-script-utils, Deutsch.
+InvalidSpreadsheetException — Eine Tabelle war erwartet, der Wert ist keine. @bootgs/utils, Deutsch.
@@ -45,4 +45,4 @@ try {
## Quellcode
-[`src/exception/appsscript/sheet/InvalidSpreadsheetException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/appsscript/sheet/InvalidSpreadsheetException.ts)
+[`src/exception/appsscript/sheet/InvalidSpreadsheetException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/appsscript/sheet/InvalidSpreadsheetException.ts)
diff --git a/docs/writerside-de/topics/InvalidStringException.md b/docs/writerside-de/topics/InvalidStringException.md
index 9937d026..42132919 100644
--- a/docs/writerside-de/topics/InvalidStringException.md
+++ b/docs/writerside-de/topics/InvalidStringException.md
@@ -4,7 +4,7 @@
Eine Zeichenkette war erwartet, etwas anderes kam an.
-InvalidStringException — Eine Zeichenkette war erwartet, etwas anderes kam an. apps-script-utils, Deutsch.
+InvalidStringException — Eine Zeichenkette war erwartet, etwas anderes kam an. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.0.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/InvalidStringException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/InvalidStringException.ts)
+[`src/exception/InvalidStringException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/InvalidStringException.ts)
diff --git a/docs/writerside-de/topics/Iterator.md b/docs/writerside-de/topics/Iterator.md
index fb0788e9..894cd4eb 100644
--- a/docs/writerside-de/topics/Iterator.md
+++ b/docs/writerside-de/topics/Iterator.md
@@ -4,7 +4,7 @@
Ein Zeiger über eine Folge, der auch rückwärts gehen kann.
-Iterator — Ein Zeiger über eine Folge, der auch rückwärts gehen kann. apps-script-utils, Deutsch.
+Iterator — Ein Zeiger über eine Folge, der auch rückwärts gehen kann. @bootgs/utils, Deutsch.
Modul: lang · Verfügbar seit: 1.0.0
@@ -37,4 +37,4 @@ while (iterator.hasNext()) {
## Quellcode
-[`src/lang/Iterator.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/lang/Iterator.ts)
+[`src/lang/Iterator.ts`](https://github.com/bootgs/utils/blob/main/src/lang/Iterator.ts)
diff --git a/docs/writerside-de/topics/MergeOptions.md b/docs/writerside-de/topics/MergeOptions.md
index 91db89d3..9e37867c 100644
--- a/docs/writerside-de/topics/MergeOptions.md
+++ b/docs/writerside-de/topics/MergeOptions.md
@@ -4,7 +4,7 @@
Wie `merge` eine Vorlage füllt.
-MergeOptions — Wie `merge` eine Vorlage füllt. apps-script-utils, Deutsch.
+MergeOptions — Wie `merge` eine Vorlage füllt. @bootgs/utils, Deutsch.
Modul: lang/string · Verfügbar seit: 1.11.0
@@ -34,4 +34,4 @@ const options = { onMissing: "empty", escape: escapeHtml };
## Quellcode
-[`src/lang/string/merge.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/lang/string/merge.ts)
+[`src/lang/string/merge.ts`](https://github.com/bootgs/utils/blob/main/src/lang/string/merge.ts)
diff --git a/docs/writerside-de/topics/NullPointerException.md b/docs/writerside-de/topics/NullPointerException.md
index 83f1d7d8..c40dfc63 100644
--- a/docs/writerside-de/topics/NullPointerException.md
+++ b/docs/writerside-de/topics/NullPointerException.md
@@ -4,7 +4,7 @@
null oder undefined tauchte dort auf, wo ein Objekt verlangt war.
-NullPointerException — null oder undefined tauchte dort auf, wo ein Objekt verlangt war. apps-script-utils, Deutsch.
+NullPointerException — null oder undefined tauchte dort auf, wo ein Objekt verlangt war. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.0.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/NullPointerException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/NullPointerException.ts)
+[`src/exception/NullPointerException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/NullPointerException.ts)
diff --git a/docs/writerside-de/topics/ObjectTag.md b/docs/writerside-de/topics/ObjectTag.md
index e4d2467e..00cd7de8 100644
--- a/docs/writerside-de/topics/ObjectTag.md
+++ b/docs/writerside-de/topics/ObjectTag.md
@@ -4,7 +4,7 @@
Die internen Tags, die ein Wert melden kann, als benannte Konstanten.
-ObjectTag — Die internen Tags, die ein Wert melden kann, als benannte Konstanten. apps-script-utils, Deutsch.
+ObjectTag — Die internen Tags, die ein Wert melden kann, als benannte Konstanten. @bootgs/utils, Deutsch.
Modul: lang/object · Verfügbar seit: 1.0.0
@@ -36,4 +36,4 @@ objectToString(null) === ObjectTag.NULL; // => true
## Quellcode
-[`src/lang/object/ObjectTag.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/lang/object/ObjectTag.ts)
+[`src/lang/object/ObjectTag.ts`](https://github.com/bootgs/utils/blob/main/src/lang/object/ObjectTag.ts)
diff --git a/docs/writerside-de/topics/ParsedPath.md b/docs/writerside-de/topics/ParsedPath.md
index 465774a7..b94f23a8 100644
--- a/docs/writerside-de/topics/ParsedPath.md
+++ b/docs/writerside-de/topics/ParsedPath.md
@@ -4,7 +4,7 @@
Die Teile, in die ein Pfad zerfällt.
-ParsedPath — Die Teile, in die ein Pfad zerfällt. apps-script-utils, Deutsch.
+ParsedPath — Die Teile, in die ein Pfad zerfällt. @bootgs/utils, Deutsch.
Modul: net/path/types · Verfügbar seit: 0.1.0
@@ -39,4 +39,4 @@ parse("readme.md");
## Quellcode
-[`src/net/path/types/ParsedPath.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/net/path/types/ParsedPath.ts)
+[`src/net/path/types/ParsedPath.ts`](https://github.com/bootgs/utils/blob/main/src/net/path/types/ParsedPath.ts)
diff --git a/docs/writerside-de/topics/RemoveSchemaOptions.md b/docs/writerside-de/topics/RemoveSchemaOptions.md
index 54806069..9d1f03e0 100644
--- a/docs/writerside-de/topics/RemoveSchemaOptions.md
+++ b/docs/writerside-de/topics/RemoveSchemaOptions.md
@@ -4,7 +4,7 @@
Wie weit `removeSchema` geht.
-RemoveSchemaOptions — Wie weit `removeSchema` geht. apps-script-utils, Deutsch.
+RemoveSchemaOptions — Wie weit `removeSchema` geht. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -32,4 +32,4 @@ const options = { validation: true };
## Quellcode
-[`src/appsscript/sheet/removeSchema.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/removeSchema.ts)
+[`src/appsscript/sheet/removeSchema.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/removeSchema.ts)
diff --git a/docs/writerside-de/topics/RepositoryIsNotDefinedException.md b/docs/writerside-de/topics/RepositoryIsNotDefinedException.md
index 48adaf24..5dff84b0 100644
--- a/docs/writerside-de/topics/RepositoryIsNotDefinedException.md
+++ b/docs/writerside-de/topics/RepositoryIsNotDefinedException.md
@@ -4,7 +4,7 @@
Ein Repository, das das Skript erwartet hat, ist nicht da.
-RepositoryIsNotDefinedException — Ein Repository, das das Skript erwartet hat, ist nicht da. apps-script-utils, Deutsch.
+RepositoryIsNotDefinedException — Ein Repository, das das Skript erwartet hat, ist nicht da. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.5.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/RepositoryIsNotDefinedException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/RepositoryIsNotDefinedException.ts)
+[`src/exception/RepositoryIsNotDefinedException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/RepositoryIsNotDefinedException.ts)
diff --git a/docs/writerside-de/topics/RetryOptions.md b/docs/writerside-de/topics/RetryOptions.md
index f304f22f..dc8665a9 100644
--- a/docs/writerside-de/topics/RetryOptions.md
+++ b/docs/writerside-de/topics/RetryOptions.md
@@ -4,7 +4,7 @@
Wie `retry` wartet und wann es aufgibt.
-RetryOptions — Wie `retry` wartet und wann es aufgibt. apps-script-utils, Deutsch.
+RetryOptions — Wie `retry` wartet und wann es aufgibt. @bootgs/utils, Deutsch.
Modul: lang/function
@@ -38,4 +38,4 @@ const options = {
## Quellcode
-[`src/lang/function/retry.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/lang/function/retry.ts)
+[`src/lang/function/retry.ts`](https://github.com/bootgs/utils/blob/main/src/lang/function/retry.ts)
diff --git a/docs/writerside-de/topics/Row.md b/docs/writerside-de/topics/Row.md
index 1fac1a29..8432fb3d 100644
--- a/docs/writerside-de/topics/Row.md
+++ b/docs/writerside-de/topics/Row.md
@@ -4,7 +4,7 @@
Eine Zeile, wie `getValues` sie einem Filter oder Mapper übergibt.
-Row — Eine Zeile, wie `getValues` sie einem Filter oder Mapper übergibt. apps-script-utils, Deutsch.
+Row — Eine Zeile, wie `getValues` sie einem Filter oder Mapper übergibt. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -39,4 +39,4 @@ const row = {
## Quellcode
-[`src/appsscript/sheet/getValues.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/getValues.ts)
+[`src/appsscript/sheet/getValues.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/getValues.ts)
diff --git a/docs/writerside-de/topics/RowConditionalOptions.md b/docs/writerside-de/topics/RowConditionalOptions.md
index f1a03d17..41c19064 100644
--- a/docs/writerside-de/topics/RowConditionalOptions.md
+++ b/docs/writerside-de/topics/RowConditionalOptions.md
@@ -4,7 +4,7 @@
Wie die Zeilen gelesen werden und welche als Kandidaten gelten.
-RowConditionalOptions — Wie die Zeilen gelesen werden und welche als Kandidaten gelten. apps-script-utils, Deutsch.
+RowConditionalOptions — Wie die Zeilen gelesen werden und welche als Kandidaten gelten. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -33,4 +33,4 @@ const options = { headerRow: 1 };
## Quellcode
-[`src/appsscript/sheet/clearRowsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/clearRowsByConditional.ts)
+[`src/appsscript/sheet/clearRowsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/clearRowsByConditional.ts)
diff --git a/docs/writerside-de/topics/RowPredicate.md b/docs/writerside-de/topics/RowPredicate.md
index e1f78285..64dcade3 100644
--- a/docs/writerside-de/topics/RowPredicate.md
+++ b/docs/writerside-de/topics/RowPredicate.md
@@ -4,7 +4,7 @@
Entscheidet, ob eine Zeile eine ist, auf die gewirkt wird.
-RowPredicate — Entscheidet, ob eine Zeile eine ist, auf die gewirkt wird. apps-script-utils, Deutsch.
+RowPredicate — Entscheidet, ob eine Zeile eine ist, auf die gewirkt wird. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -33,4 +33,4 @@ const predicate = (values, position, record) => record?.status === "done";
## Quellcode
-[`src/appsscript/sheet/clearRowsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/clearRowsByConditional.ts)
+[`src/appsscript/sheet/clearRowsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/clearRowsByConditional.ts)
diff --git a/docs/writerside-de/topics/RuntimeException.md b/docs/writerside-de/topics/RuntimeException.md
index f6654988..826c4753 100644
--- a/docs/writerside-de/topics/RuntimeException.md
+++ b/docs/writerside-de/topics/RuntimeException.md
@@ -4,7 +4,7 @@
Die Oberklasse jeder Ausnahme, die ein laufendes Skript auslösen kann.
-RuntimeException — Die Oberklasse jeder Ausnahme, die ein laufendes Skript auslösen kann. apps-script-utils, Deutsch.
+RuntimeException — Die Oberklasse jeder Ausnahme, die ein laufendes Skript auslösen kann. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.0.0
@@ -42,4 +42,4 @@ try {
## Quellcode
-[`src/exception/RuntimeException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/RuntimeException.ts)
+[`src/exception/RuntimeException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/RuntimeException.ts)
diff --git a/docs/writerside-de/topics/ServiceIsNotDefinedException.md b/docs/writerside-de/topics/ServiceIsNotDefinedException.md
index 7c3636f2..47e0208e 100644
--- a/docs/writerside-de/topics/ServiceIsNotDefinedException.md
+++ b/docs/writerside-de/topics/ServiceIsNotDefinedException.md
@@ -4,7 +4,7 @@
Ein Dienst, den das Skript erwartet hat, ist nicht da: ein nicht aktivierter erweiterter Dienst oder eine nie definierte globale Variable.
-ServiceIsNotDefinedException — Ein Dienst, den das Skript erwartet hat, ist nicht da: ein nicht aktivierter erweiterter Dienst oder eine nie definierte globale Variable. apps-script-utils, Deutsch.
+ServiceIsNotDefinedException — Ein Dienst, den das Skript erwartet hat, ist nicht da: ein nicht aktivierter erweiterter Dienst oder eine nie definierte globale Variable. @bootgs/utils, Deutsch.
Modul: exception · Verfügbar seit: 1.5.0
@@ -44,4 +44,4 @@ try {
## Quellcode
-[`src/exception/ServiceIsNotDefinedException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/ServiceIsNotDefinedException.ts)
+[`src/exception/ServiceIsNotDefinedException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/ServiceIsNotDefinedException.ts)
diff --git a/docs/writerside-de/topics/SheetColumnSchema.md b/docs/writerside-de/topics/SheetColumnSchema.md
index 492f0969..9da5e369 100644
--- a/docs/writerside-de/topics/SheetColumnSchema.md
+++ b/docs/writerside-de/topics/SheetColumnSchema.md
@@ -4,7 +4,7 @@
Eine Spalte des Schemas eines Blattes.
-SheetColumnSchema — Eine Spalte des Schemas eines Blattes. apps-script-utils, Deutsch.
+SheetColumnSchema — Eine Spalte des Schemas eines Blattes. @bootgs/utils, Deutsch.
@@ -32,4 +32,4 @@ const type = "date";
## Quellcode
-[`src/appsscript/sheet/types/SheetSchema.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/types/SheetSchema.ts)
+[`src/appsscript/sheet/types/SheetSchema.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/types/SheetSchema.ts)
diff --git a/docs/writerside-de/topics/SheetSchema.md b/docs/writerside-de/topics/SheetSchema.md
index 839270e5..45a075dd 100644
--- a/docs/writerside-de/topics/SheetSchema.md
+++ b/docs/writerside-de/topics/SheetSchema.md
@@ -4,7 +4,7 @@
Wie die Spalten eines Blattes heißen und was sie enthalten.
-SheetSchema — Wie die Spalten eines Blattes heißen und was sie enthalten. apps-script-utils, Deutsch.
+SheetSchema — Wie die Spalten eines Blattes heißen und was sie enthalten. @bootgs/utils, Deutsch.
@@ -42,4 +42,4 @@ const schema = {
## Quellcode
-[`src/appsscript/sheet/types/SheetSchema.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/types/SheetSchema.ts)
+[`src/appsscript/sheet/types/SheetSchema.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/types/SheetSchema.ts)
diff --git a/docs/writerside-de/topics/SlideNotFoundException.md b/docs/writerside-de/topics/SlideNotFoundException.md
index 0bac423f..9f98acdb 100644
--- a/docs/writerside-de/topics/SlideNotFoundException.md
+++ b/docs/writerside-de/topics/SlideNotFoundException.md
@@ -4,7 +4,7 @@
Eine Folie war erwartet, der Wert ist keine, oder die gesuchte Folie gibt es in der Präsentation nicht.
-SlideNotFoundException — Eine Folie war erwartet, der Wert ist keine, oder die gesuchte Folie gibt es in der Präsentation nicht. apps-script-utils, Deutsch.
+SlideNotFoundException — Eine Folie war erwartet, der Wert ist keine, oder die gesuchte Folie gibt es in der Präsentation nicht. @bootgs/utils, Deutsch.
@@ -45,4 +45,4 @@ try {
## Quellcode
-[`src/exception/appsscript/slide/SlideNotFoundException.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/exception/appsscript/slide/SlideNotFoundException.ts)
+[`src/exception/appsscript/slide/SlideNotFoundException.ts`](https://github.com/bootgs/utils/blob/main/src/exception/appsscript/slide/SlideNotFoundException.ts)
diff --git a/docs/writerside-de/topics/StopWatch.md b/docs/writerside-de/topics/StopWatch.md
index 173bc3ca..dc96c5f1 100644
--- a/docs/writerside-de/topics/StopWatch.md
+++ b/docs/writerside-de/topics/StopWatch.md
@@ -4,7 +4,7 @@
Misst die Zeit einer Folge benannter Aufgaben.
-StopWatch — Misst die Zeit einer Folge benannter Aufgaben. apps-script-utils, Deutsch.
+StopWatch — Misst die Zeit einer Folge benannter Aufgaben. @bootgs/utils, Deutsch.
Modul: time · Verfügbar seit: 1.11.0
@@ -45,4 +45,4 @@ watch.getTotalTimeMillis();
## Quellcode
-[`src/time/StopWatch.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/time/StopWatch.ts)
+[`src/time/StopWatch.ts`](https://github.com/bootgs/utils/blob/main/src/time/StopWatch.ts)
diff --git a/docs/writerside-de/topics/TaskInfo.md b/docs/writerside-de/topics/TaskInfo.md
index 9b675696..f30ca1d9 100644
--- a/docs/writerside-de/topics/TaskInfo.md
+++ b/docs/writerside-de/topics/TaskInfo.md
@@ -4,7 +4,7 @@
Eine gemessene Aufgabe, wie eine `StopWatch` sie festgehalten hat.
-TaskInfo — Eine gemessene Aufgabe, wie eine `StopWatch` sie festgehalten hat. apps-script-utils, Deutsch.
+TaskInfo — Eine gemessene Aufgabe, wie eine `StopWatch` sie festgehalten hat. @bootgs/utils, Deutsch.
Modul: time
@@ -36,4 +36,4 @@ watch.getLastTaskInfo(); // { taskName: "fetch", timeMillis: …, timeSeconds:
## Quellcode
-[`src/time/StopWatch.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/time/StopWatch.ts)
+[`src/time/StopWatch.ts`](https://github.com/bootgs/utils/blob/main/src/time/StopWatch.ts)
diff --git a/docs/writerside-de/topics/TimeUnit.md b/docs/writerside-de/topics/TimeUnit.md
index 46e6826e..7ce73100 100644
--- a/docs/writerside-de/topics/TimeUnit.md
+++ b/docs/writerside-de/topics/TimeUnit.md
@@ -4,7 +4,7 @@
Eine Einheit, in der ein Abstand ausgedrückt werden kann.
-TimeUnit — Eine Einheit, in der ein Abstand ausgedrückt werden kann. apps-script-utils, Deutsch.
+TimeUnit — Eine Einheit, in der ein Abstand ausgedrückt werden kann. @bootgs/utils, Deutsch.
Modul: time/types · Verfügbar seit: 1.11.0
@@ -35,4 +35,4 @@ offset(date, 1, "month");
## Quellcode
-[`src/time/types/TimeUnit.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/time/types/TimeUnit.ts)
+[`src/time/types/TimeUnit.ts`](https://github.com/bootgs/utils/blob/main/src/time/types/TimeUnit.ts)
diff --git a/docs/writerside-de/topics/appendColumn.md b/docs/writerside-de/topics/appendColumn.md
index d33df894..1bb4efcd 100644
--- a/docs/writerside-de/topics/appendColumn.md
+++ b/docs/writerside-de/topics/appendColumn.md
@@ -4,7 +4,7 @@
Fügt eine Spalte hinter der letzten Spalte mit Daten an.
-appendColumn() — Fügt eine Spalte hinter der letzten Spalte mit Daten an. apps-script-utils, Deutsch.
+appendColumn() — Fügt eine Spalte hinter der letzten Spalte mit Daten an. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.0.0
@@ -70,4 +70,4 @@ appendColumn(sheet.getRange("A1:D3"), ["status", "new", "new"]);
## Quellcode
-[`src/appsscript/sheet/appendColumn.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/appendColumn.ts)
+[`src/appsscript/sheet/appendColumn.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/appendColumn.ts)
diff --git a/docs/writerside-de/topics/appendColumns.md b/docs/writerside-de/topics/appendColumns.md
index 6dab223e..f9622ef3 100644
--- a/docs/writerside-de/topics/appendColumns.md
+++ b/docs/writerside-de/topics/appendColumns.md
@@ -4,7 +4,7 @@
Fügt Spalten hinter der letzten Spalte mit Daten an.
-appendColumns() — Fügt Spalten hinter der letzten Spalte mit Daten an. apps-script-utils, Deutsch.
+appendColumns() — Fügt Spalten hinter der letzten Spalte mit Daten an. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.0.0
@@ -76,4 +76,4 @@ appendColumns(sheet.getRange("A1:D2"), [["a"], ["b"]]);
## Quellcode
-[`src/appsscript/sheet/appendColumns.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/appendColumns.ts)
+[`src/appsscript/sheet/appendColumns.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/appendColumns.ts)
diff --git a/docs/writerside-de/topics/appendRow.md b/docs/writerside-de/topics/appendRow.md
index f7db41df..c6fce8c7 100644
--- a/docs/writerside-de/topics/appendRow.md
+++ b/docs/writerside-de/topics/appendRow.md
@@ -4,7 +4,7 @@
Fügt eine Zeile unter der letzten Zeile mit Daten an.
-appendRow() — Fügt eine Zeile unter der letzten Zeile mit Daten an. apps-script-utils, Deutsch.
+appendRow() — Fügt eine Zeile unter der letzten Zeile mit Daten an. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.0.0
@@ -70,4 +70,4 @@ appendRow(sheet.getRange("B1:D10"), ["Ada", "ada@example.com"]);
## Quellcode
-[`src/appsscript/sheet/appendRow.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/appendRow.ts)
+[`src/appsscript/sheet/appendRow.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/appendRow.ts)
diff --git a/docs/writerside-de/topics/appendRows.md b/docs/writerside-de/topics/appendRows.md
index 873f9fe7..4cc2721b 100644
--- a/docs/writerside-de/topics/appendRows.md
+++ b/docs/writerside-de/topics/appendRows.md
@@ -4,7 +4,7 @@
Fügt Zeilen unter der letzten Zeile mit Daten an.
-appendRows() — Fügt Zeilen unter der letzten Zeile mit Daten an. apps-script-utils, Deutsch.
+appendRows() — Fügt Zeilen unter der letzten Zeile mit Daten an. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.0.0
@@ -78,4 +78,4 @@ appendRows(sheet.getRange("B1:C10"), [["Ada", "ada@example.com"]]);
## Quellcode
-[`src/appsscript/sheet/appendRows.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/appendRows.ts)
+[`src/appsscript/sheet/appendRows.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/appendRows.ts)
diff --git a/docs/writerside-de/topics/apps-script-runtime.md b/docs/writerside-de/topics/apps-script-runtime.md
index 1f1f7a22..baf10958 100644
--- a/docs/writerside-de/topics/apps-script-runtime.md
+++ b/docs/writerside-de/topics/apps-script-runtime.md
@@ -4,7 +4,7 @@
Welche Funktionen die Apps-Script-Laufzeit brauchen und welche überall laufen.
-Welche Teile von apps-script-utils von Google-Apps-Script-Diensten abhängen und welche in Node.js oder einer Testsuite laufen — und was das fürs Testen des eigenen Codes bedeutet.
+Welche Teile von @bootgs/utils von Google-Apps-Script-Diensten abhängen und welche in Node.js oder einer Testsuite laufen — und was das fürs Testen des eigenen Codes bedeutet.
Die Bibliothek ist ein Paket, aber ihre Funktionen laufen nicht alle an denselben Orten. Auf welcher Seite der Linie
eine Funktion steht, entscheidet, ob sie sich als Unit testen lässt und ob sie einen Dienstaufruf kostet.
@@ -19,19 +19,79 @@ Spaltenbuchstaben-Umrechnungen und die `GridRange`-Vergleiche.
**Dienstgebundene** Funktionen greifen selbst nach einem globalen Dienst. Sie funktionieren nur in einem Skript mit
den nötigen Berechtigungen und in Node gar nicht. Das ist derzeit die ganze Liste:
-| Funktion | Greift nach |
-| :---------------------- | :----------------------------------------------------------------------- |
-| `isAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` |
-| `checkMultipleAccount` | `Session.getEffectiveUser` |
-| `getSheetById` | `SpreadsheetApp.getActiveSpreadsheet`, wenn keine Tabelle übergeben wird |
-| `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, wenn keine Tabelle übergeben wird |
-| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` |
-| `convertRichTextToHtml` | `Utilities.formatString` |
+| Funktion | Greift nach | Benötigter Bereich |
+| :------------------------------------ | :------------------------------------------------------------------------ | :------------------------------------------------ |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `Session.getActiveUser`, `AdminDirectory.Users` | `userinfo.email`, `admin.directory.user.readonly` |
+| `checkMultipleAccount` | `Session.getEffectiveUser` | `userinfo.email` |
+| `getSheetById`, `getSheetByIndex` | `SpreadsheetApp.getActiveSpreadsheet`, wenn keine Tabelle übergeben wird | `spreadsheets.currentonly` |
+| `getSlideByIndex`, `getSlideIndex` | `SlidesApp.getActivePresentation`, wenn keine Präsentation übergeben wird | `presentations.currentonly` |
+| `createFolder` | `DriveApp.getRootFolder`, wenn kein übergeordneter Ordner übergeben wird | `drive` |
+| `getTriggerById` | `ScriptApp.getProjectTriggers` | `script.scriptapp` |
+| `appendRows`, `prependRows` | `LockService.getDocumentLock` | keiner für die Sperre |
+| `appendRow`, `prependRow` | `LockService.getDocumentLock`, über die beiden Funktionen darüber | keiner für die Sperre |
+| `appendColumns`, `prependColumns` | `LockService.getDocumentLock` | keiner für die Sperre |
+| `appendColumn`, `prependColumn` | `LockService.getDocumentLock`, über die beiden Funktionen darüber | keiner für die Sperre |
+| `highlightHtml` | `SpreadsheetApp.newTextStyle`, `SpreadsheetApp.newRichTextValue` | keiner für die Builder |
+| `insertSchema` | `SpreadsheetApp.newDataValidation` | keiner für den Builder |
+| `deleteRowsByConditional` | `SpreadsheetApp.Dimension` | keiner für die Aufzählung |
+| `deleteColumnsByConditional` | `SpreadsheetApp.Dimension` | keiner für die Aufzählung |
+| `convertRichTextToHtml` | `Utilities.formatString` | keiner |
+| `retry` | `Utilities.sleep`, wenn vorhanden | keiner |
+
+Die Bereiche stehen ohne das Präfix `https://www.googleapis.com/auth/`. „Keiner“ heißt, dass das globale Objekt
+selbst keine Autorisierung braucht; das Blatt, der Bereich oder der Ordner, den die Funktion erhält, braucht trotzdem
+den Bereich des Dienstes, aus dem er stammt — dazu der nächste Abschnitt.
Alles Übrige in `appsscript` nimmt das Dienstobjekt als Argument: `appendRows` schreibt in das `Sheet`, das Sie ihm
geben, und `requireSheet` betrachtet den übergebenen Wert, statt selbst einen zu holen. Solche Funktionen brauchen
ein lebendes Dienstobjekt, um nützlich zu sein, suchen aber keines — genau das macht sie im Test ersetzbar.
+## OAuth-Bereiche
+
+Apps Script entscheidet, welche Bereiche es anfordert, indem es den Code des ganzen Projekts durchsucht, die
+Bibliothek eingeschlossen. Ein Projekt, das die Bibliothek vollständig einbindet, kann den Nutzer daher um mehr bitten,
+als es tatsächlich verwendet. Tragen Sie die Bereiche deshalb selbst in `appsscript.json` ein: Sobald `oauthScopes`
+vorhanden ist, fordert Apps Script genau diese an und keine anderen.
+
+| Was Ihr Code aufruft | Engster Bereich | Breitere Alternative |
+| :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------ | :-------------------------------------------- |
+| Jede Funktion, die ein `Sheet`, `Range`, `Spreadsheet` oder `RichTextValue` aus der gebundenen Tabelle erhält | `spreadsheets.currentonly` | `spreadsheets`, für per ID geöffnete Tabellen |
+| `getSheetById`, `getSheetByIndex` ohne Tabelle | `spreadsheets.currentonly` | `spreadsheets` |
+| Jede Funktion, die eine `Slide` oder `Presentation` erhält, sowie `getSlideByIndex`, `getSlideIndex` ohne Präsentation | `presentations.currentonly` | `presentations` |
+| `createFolder` | `drive` | — |
+| `getTriggerById` | `script.scriptapp` | — |
+| `checkMultipleAccount` | `userinfo.email` | — |
+| `isAdmin`, `nonAdmin`, `requireAdmin` | `userinfo.email`, `admin.directory.user.readonly` | `admin.directory.user` |
+| Alles in `lang`, `net`, `json`, `html`, `time` und `exception` sowie die Helfer für A1-Notation, Spaltenbuchstaben und `GridRange` | keiner | — |
+
+Ein an eine Tabelle gebundenes Skript, das nur mit dieser Tabelle arbeitet, braucht nicht mehr als das:
+
+```json
+{
+ "timeZone": "Etc/UTC",
+ "runtimeVersion": "V8",
+ "oauthScopes": ["https://www.googleapis.com/auth/spreadsheets.currentonly"]
+}
+```
+
+Was Sie vor dem Einschränken wissen sollten:
+
+- **`*.currentonly`** deckt nur das Dokument ab, an das das Skript gebunden ist, oder das, in dem ein Add-on läuft.
+ Ein Skript, das andere Tabellen oder Präsentationen per ID oder URL öffnet, braucht `spreadsheets` oder
+ `presentations`.
+- **`createFolder`** sucht zuerst vorhandene Ordner nach Namen und legt erst dann einen neuen an. Mit `drive.file`
+ sieht ein Skript nur die Dateien und Ordner, die es selbst angelegt oder die der Nutzer damit geöffnet hat; die
+ Suche übersieht also Ordner, die jemand anderes angelegt hat, und es entstehen Duplikate. Verwenden Sie
+ `drive.file` nur, wenn das Skript den ganzen Baum selbst anlegt, sonst `drive`.
+- **Die Admin-SDK-Funktionen** brauchen außerdem den im Projekt aktivierten erweiterten Dienst Admin SDK Directory
+ (`dependencies.enabledAdvancedServices`, `serviceId` `admin`, `version` `directory_v1`) und einen Nutzer, der das
+ Verzeichnis lesen darf. Der Lesebereich `admin.directory.user.readonly` genügt: `isAdmin` liest den Nutzer nur.
+- **Ein fehlender Bereich** zeigt sich zur Laufzeit, als Autorisierungsfehler beim Dienstaufruf, nicht beim Speichern
+ des Projekts. Führen Sie nach jeder Änderung an `oauthScopes` jeden Codepfad einmal aus.
+
+Welchen Bereich eine Methode braucht, steht unter „Authorization“ auf ihrer Seite in der
+[Apps-Script-Referenz](https://developers.google.com/apps-script/reference).
+
## An der Grenze bündeln
Jeder Dienstaufruf ist ein Hin und Zurück, und Apps Script rechnet ihn gegen das Zeitlimit. Die Schreibhelfer gibt
@@ -52,7 +112,7 @@ Dieselbe Überlegung gilt für die Prüfung. Prüfen Sie die Form der Daten, bev
danach:
```typescript
-import { IllegalArgumentException, appendRows, isConsistent2DArray } from "apps-script-utils";
+import { IllegalArgumentException, appendRows, isConsistent2DArray } from "@bootgs/utils";
if (!isConsistent2DArray(rows)) {
throw new IllegalArgumentException("every row must have the same number of columns");
diff --git a/docs/writerside-de/topics/checkMultipleAccount.md b/docs/writerside-de/topics/checkMultipleAccount.md
index 0cafb7e8..fccf884c 100644
--- a/docs/writerside-de/topics/checkMultipleAccount.md
+++ b/docs/writerside-de/topics/checkMultipleAccount.md
@@ -4,7 +4,7 @@
Meldet, ob das Skript unter einem anderen Konto läuft als dem, das es gestartet hat.
-checkMultipleAccount() — Meldet, ob das Skript unter einem anderen Konto läuft als dem, das es gestartet hat. apps-script-utils, Deutsch.
+checkMultipleAccount() — Meldet, ob das Skript unter einem anderen Konto läuft als dem, das es gestartet hat. @bootgs/utils, Deutsch.
Modul: appsscript/ui · Verfügbar seit: 1.0.0
@@ -52,4 +52,4 @@ function onOpen(event) {
## Quellcode
-[`src/appsscript/ui/checkMultipleAccount.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/ui/checkMultipleAccount.ts)
+[`src/appsscript/ui/checkMultipleAccount.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/ui/checkMultipleAccount.ts)
diff --git a/docs/writerside-de/topics/chunk.md b/docs/writerside-de/topics/chunk.md
index b1ae6d9f..30f73345 100644
--- a/docs/writerside-de/topics/chunk.md
+++ b/docs/writerside-de/topics/chunk.md
@@ -4,7 +4,7 @@
Teilt ein Array in aufeinanderfolgende Gruppen fester Größe und prüft beide Argumente.
-chunk() — Teilt ein Array in aufeinanderfolgende Gruppen fester Größe und prüft beide Argumente. apps-script-utils, Deutsch.
+chunk() — Teilt ein Array in aufeinanderfolgende Gruppen fester Größe und prüft beide Argumente. @bootgs/utils, Deutsch.
Modul: lang/array · Verfügbar seit: 1.0.0
@@ -82,4 +82,4 @@ chunk([1, 2, 3], 1.5); // throws TypeError: Input 'size' must be an integer.
## Quellcode
-[`src/lang/array/chunk.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/lang/array/chunk.ts)
+[`src/lang/array/chunk.ts`](https://github.com/bootgs/utils/blob/main/src/lang/array/chunk.ts)
diff --git a/docs/writerside-de/topics/clearColumnsByConditional.md b/docs/writerside-de/topics/clearColumnsByConditional.md
index 089c22ee..16d14754 100644
--- a/docs/writerside-de/topics/clearColumnsByConditional.md
+++ b/docs/writerside-de/topics/clearColumnsByConditional.md
@@ -4,7 +4,7 @@
Leert die vom Prädikat gewählten Spalten, ohne die Spalten zu entfernen.
-clearColumnsByConditional() — Leert die vom Prädikat gewählten Spalten, ohne die Spalten zu entfernen. apps-script-utils, Deutsch.
+clearColumnsByConditional() — Leert die vom Prädikat gewählten Spalten, ohne die Spalten zu entfernen. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -74,4 +74,4 @@ clearColumnsByConditional(sheet.getRange("B2:Z100"), (values) =>
## Quellcode
-[`src/appsscript/sheet/clearColumnsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/clearColumnsByConditional.ts)
+[`src/appsscript/sheet/clearColumnsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/clearColumnsByConditional.ts)
diff --git a/docs/writerside-de/topics/clearRowsByConditional.md b/docs/writerside-de/topics/clearRowsByConditional.md
index e2061082..160dc8f1 100644
--- a/docs/writerside-de/topics/clearRowsByConditional.md
+++ b/docs/writerside-de/topics/clearRowsByConditional.md
@@ -4,7 +4,7 @@
Leert die vom Prädikat gewählten Zeilen, ohne die Zeilen zu entfernen.
-clearRowsByConditional() — Leert die vom Prädikat gewählten Zeilen, ohne die Zeilen zu entfernen. apps-script-utils, Deutsch.
+clearRowsByConditional() — Leert die vom Prädikat gewählten Zeilen, ohne die Zeilen zu entfernen. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -75,4 +75,4 @@ clearRowsByConditional(sheet.getRange("B2:D100"), (values) => values.every((cell
## Quellcode
-[`src/appsscript/sheet/clearRowsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/clearRowsByConditional.ts)
+[`src/appsscript/sheet/clearRowsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/clearRowsByConditional.ts)
diff --git a/docs/writerside-de/topics/compact.md b/docs/writerside-de/topics/compact.md
index 31ca32ee..a2f4156b 100644
--- a/docs/writerside-de/topics/compact.md
+++ b/docs/writerside-de/topics/compact.md
@@ -4,7 +4,7 @@
Entfernt jeden falsy-Wert aus einem Array und verengt dabei den Elementtyp ohne Cast.
-compact() — Entfernt jeden falsy-Wert aus einem Array und verengt dabei den Elementtyp ohne Cast. apps-script-utils, Deutsch.
+compact() — Entfernt jeden falsy-Wert aus einem Array und verengt dabei den Elementtyp ohne Cast. @bootgs/utils, Deutsch.
Modul: lang/array · Verfügbar seit: 1.11.0
@@ -67,7 +67,7 @@ function readIds(sheet) {
### Wann `nonNil` der bessere Filter ist
```typescript
-import { nonNil } from "apps-script-utils";
+import { nonNil } from "@bootgs/utils";
const cells = [0, "", 5, null]; // a column read from a sheet
@@ -82,4 +82,4 @@ cells.filter(nonNil); // => [0, "", 5] — drops only the absent values
## Quellcode
-[`src/lang/array/compact.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/lang/array/compact.ts)
+[`src/lang/array/compact.ts`](https://github.com/bootgs/utils/blob/main/src/lang/array/compact.ts)
diff --git a/docs/writerside-de/topics/convertMarkdownToRichText.md b/docs/writerside-de/topics/convertMarkdownToRichText.md
index 90ed4e22..fbd8b87e 100644
--- a/docs/writerside-de/topics/convertMarkdownToRichText.md
+++ b/docs/writerside-de/topics/convertMarkdownToRichText.md
@@ -4,7 +4,7 @@
Verwandelt eine kleine Teilmenge von Markdown in formatierte Textabschnitte.
-convertMarkdownToRichText() — Verwandelt eine kleine Teilmenge von Markdown in formatierte Textabschnitte. apps-script-utils, Deutsch.
+convertMarkdownToRichText() — Verwandelt eine kleine Teilmenge von Markdown in formatierte Textabschnitte. @bootgs/utils, Deutsch.
Modul: appsscript/slide · Verfügbar seit: 1.5.0
@@ -50,4 +50,4 @@ const runs = convertMarkdownToRichText("**bold** and `code`");
## Quellcode
-[`src/appsscript/slide/convertMarkdownToRichText.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/slide/convertMarkdownToRichText.ts)
+[`src/appsscript/slide/convertMarkdownToRichText.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/slide/convertMarkdownToRichText.ts)
diff --git a/docs/writerside-de/topics/convertRichTextToHtml.md b/docs/writerside-de/topics/convertRichTextToHtml.md
index c4ea6f91..87db7299 100644
--- a/docs/writerside-de/topics/convertRichTextToHtml.md
+++ b/docs/writerside-de/topics/convertRichTextToHtml.md
@@ -4,7 +4,7 @@
Gibt einen Rich-Text-Zellwert als HTML aus.
-convertRichTextToHtml() — Gibt einen Rich-Text-Zellwert als HTML aus. apps-script-utils, Deutsch.
+convertRichTextToHtml() — Gibt einen Rich-Text-Zellwert als HTML aus. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.0.0
@@ -46,4 +46,4 @@ const html = convertRichTextToHtml(range.getRichTextValue());
## Quellcode
-[`src/appsscript/sheet/convertRichTextToHtml.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/convertRichTextToHtml.ts)
+[`src/appsscript/sheet/convertRichTextToHtml.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/convertRichTextToHtml.ts)
diff --git a/docs/writerside-de/topics/convertRichTextToMarkdown.md b/docs/writerside-de/topics/convertRichTextToMarkdown.md
index adf9657a..03e1c0ac 100644
--- a/docs/writerside-de/topics/convertRichTextToMarkdown.md
+++ b/docs/writerside-de/topics/convertRichTextToMarkdown.md
@@ -4,7 +4,7 @@
Führt gestaltete Textabschnitte wieder in Markdown zurück.
-convertRichTextToMarkdown() — Führt gestaltete Textabschnitte wieder in Markdown zurück. apps-script-utils, Deutsch.
+convertRichTextToMarkdown() — Führt gestaltete Textabschnitte wieder in Markdown zurück. @bootgs/utils, Deutsch.
Modul: appsscript/slide · Verfügbar seit: 2.0.0
@@ -61,4 +61,4 @@ convertRichTextToMarkdown([
## Quellcode
-[`src/appsscript/slide/convertRichTextToMarkdown.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/slide/convertRichTextToMarkdown.ts)
+[`src/appsscript/slide/convertRichTextToMarkdown.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/slide/convertRichTextToMarkdown.ts)
diff --git a/docs/writerside-de/topics/createFolder.md b/docs/writerside-de/topics/createFolder.md
index 2a0689a1..24ec005a 100644
--- a/docs/writerside-de/topics/createFolder.md
+++ b/docs/writerside-de/topics/createFolder.md
@@ -4,7 +4,7 @@
Legt einen Ordnerpfad in Drive an und nutzt bereits vorhandene Ordner weiter.
-createFolder() — Legt einen Ordnerpfad in Drive an und nutzt bereits vorhandene Ordner weiter. apps-script-utils, Deutsch.
+createFolder() — Legt einen Ordnerpfad in Drive an und nutzt bereits vorhandene Ordner weiter. @bootgs/utils, Deutsch.
Modul: appsscript/drive · Verfügbar seit: 1.11.0
@@ -47,4 +47,4 @@ const folder = createFolder("reports/2026/january");
## Quellcode
-[`src/appsscript/drive/createFolder.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/drive/createFolder.ts)
+[`src/appsscript/drive/createFolder.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/drive/createFolder.ts)
diff --git a/docs/writerside-de/topics/decodeHtml.md b/docs/writerside-de/topics/decodeHtml.md
index ab62a3c5..fca7f988 100644
--- a/docs/writerside-de/topics/decodeHtml.md
+++ b/docs/writerside-de/topics/decodeHtml.md
@@ -4,7 +4,7 @@
Verwandelt numerische Zeichenreferenzen zurück in Zeichen.
-decodeHtml() — Verwandelt numerische Zeichenreferenzen zurück in Zeichen. apps-script-utils, Deutsch.
+decodeHtml() — Verwandelt numerische Zeichenreferenzen zurück in Zeichen. @bootgs/utils, Deutsch.
Modul: html · Verfügbar seit: 1.0.0
@@ -49,4 +49,4 @@ decodeHtml("&"); // => "&"
## Quellcode
-[`src/html/decodeHtml.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/html/decodeHtml.ts)
+[`src/html/decodeHtml.ts`](https://github.com/bootgs/utils/blob/main/src/html/decodeHtml.ts)
diff --git a/docs/writerside-de/topics/deleteColumnsByConditional.md b/docs/writerside-de/topics/deleteColumnsByConditional.md
index 9b7035f7..022639f5 100644
--- a/docs/writerside-de/topics/deleteColumnsByConditional.md
+++ b/docs/writerside-de/topics/deleteColumnsByConditional.md
@@ -4,7 +4,7 @@
Löscht die vom Prädikat gewählten Spalten.
-deleteColumnsByConditional() — Löscht die vom Prädikat gewählten Spalten. apps-script-utils, Deutsch.
+deleteColumnsByConditional() — Löscht die vom Prädikat gewählten Spalten. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -76,4 +76,4 @@ deleteColumnsByConditional(sheet.getRange("B2:Z100"), (values) =>
## Quellcode
-[`src/appsscript/sheet/deleteColumnsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/deleteColumnsByConditional.ts)
+[`src/appsscript/sheet/deleteColumnsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/deleteColumnsByConditional.ts)
diff --git a/docs/writerside-de/topics/deleteRowsByConditional.md b/docs/writerside-de/topics/deleteRowsByConditional.md
index fa71651c..491406e8 100644
--- a/docs/writerside-de/topics/deleteRowsByConditional.md
+++ b/docs/writerside-de/topics/deleteRowsByConditional.md
@@ -4,7 +4,7 @@
Löscht die vom Prädikat gewählten Zeilen.
-deleteRowsByConditional() — Löscht die vom Prädikat gewählten Zeilen. apps-script-utils, Deutsch.
+deleteRowsByConditional() — Löscht die vom Prädikat gewählten Zeilen. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.11.0
@@ -74,4 +74,4 @@ deleteRowsByConditional(sheet.getRange("B2:D100"), (values) => values.every((cel
## Quellcode
-[`src/appsscript/sheet/deleteRowsByConditional.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/deleteRowsByConditional.ts)
+[`src/appsscript/sheet/deleteRowsByConditional.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/deleteRowsByConditional.ts)
diff --git a/docs/writerside-de/topics/diff.md b/docs/writerside-de/topics/diff.md
index 629f7194..be62c747 100644
--- a/docs/writerside-de/topics/diff.md
+++ b/docs/writerside-de/topics/diff.md
@@ -4,7 +4,7 @@
Gibt den Abstand zweier Daten in einer gewählten Einheit zurück.
-diff() — Gibt den Abstand zweier Daten in einer gewählten Einheit zurück. apps-script-utils, Deutsch.
+diff() — Gibt den Abstand zweier Daten in einer gewählten Einheit zurück. @bootgs/utils, Deutsch.
Modul: time · Verfügbar seit: 1.11.0
@@ -60,4 +60,4 @@ diff(new Date(2026, 0, 2, 1), new Date(2026, 0, 1, 23), "day"); // => 0
## Quellcode
-[`src/time/diff.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/time/diff.ts)
+[`src/time/diff.ts`](https://github.com/bootgs/utils/blob/main/src/time/diff.ts)
diff --git a/docs/writerside-de/topics/doGridRangesIntersect.md b/docs/writerside-de/topics/doGridRangesIntersect.md
index dedf161c..6426afb0 100644
--- a/docs/writerside-de/topics/doGridRangesIntersect.md
+++ b/docs/writerside-de/topics/doGridRangesIntersect.md
@@ -4,7 +4,7 @@
Meldet, ob zwei Rasterbereiche sich in einer Zelle überschneiden.
-doGridRangesIntersect() — Meldet, ob zwei Rasterbereiche sich in einer Zelle überschneiden. apps-script-utils, Deutsch.
+doGridRangesIntersect() — Meldet, ob zwei Rasterbereiche sich in einer Zelle überschneiden. @bootgs/utils, Deutsch.
Modul: appsscript/sheet · Verfügbar seit: 1.0.0
@@ -47,4 +47,4 @@ doGridRangesIntersect(left, right); // => true
## Quellcode
-[`src/appsscript/sheet/doGridRangesIntersect.ts`](https://github.com/MaksymStoianov/apps-script-utils/blob/main/src/appsscript/sheet/doGridRangesIntersect.ts)
+[`src/appsscript/sheet/doGridRangesIntersect.ts`](https://github.com/bootgs/utils/blob/main/src/appsscript/sheet/doGridRangesIntersect.ts)
diff --git a/docs/writerside-de/topics/ecosystem.md b/docs/writerside-de/topics/ecosystem.md
index d74c220c..0633af75 100644
--- a/docs/writerside-de/topics/ecosystem.md
+++ b/docs/writerside-de/topics/ecosystem.md
@@ -4,7 +4,7 @@
Das Framework boot.gs, das auf dieser Bibliothek aufbaut, und die Agent Skills, die KI-Agenten den Umgang damit beibringen.
-Wie apps-script-utils mit dem boot.gs-Framework für Google Apps Script zusammenhängt und mit den Agent Skills, die Claude Code, Gemini CLI und Cursor den Umgang mit beidem beibringen.
+Wie @bootgs/utils mit dem boot.gs-Framework für Google Apps Script zusammenhängt und mit den Agent Skills, die Claude Code, Gemini CLI und Cursor den Umgang mit beidem beibringen.
Die Bibliothek ist für sich allein nützlich: installieren, eine Funktion importieren, fertig. Sie ist zugleich Teil
eines kleinen Ökosystems für die Entwicklung mit Google Apps Script, und zwei Nachbarn lohnen die Bekanntschaft.
@@ -31,7 +31,7 @@ export class SheetController {
}
```
-**Das Verhältnis zu dieser Bibliothek ist eine Abhängigkeit, keine Rivalität.** `bootgs` führt `apps-script-utils`
+**Das Verhältnis zu dieser Bibliothek ist eine Abhängigkeit, keine Rivalität.** `bootgs` führt `@bootgs/utils`
unter seinen Laufzeitabhängigkeiten, ein boot.gs-Projekt hat also jede hier beschriebene Funktion bereits an Bord,
ohne zweite Installation. Aus diesen Prüfungen sind seine Parametervalidierung und seine Dienstsuche gebaut.
@@ -39,7 +39,7 @@ Wozu man greift:
| Was gebraucht wird | Was man nimmt |
| :---------------------------------------------------------------------------- | :------------------------------------- |
-| Helfer in einem bestehenden Skript — ein paar Funktionen, keine neue Struktur | `apps-script-utils` allein |
+| Helfer in einem bestehenden Skript — ein paar Funktionen, keine neue Struktur | `@bootgs/utils` allein |
| Routing, Controller, Dependency Injection, eine Web-App mit echten Endpunkten | `bootgs`, die Bibliothek ist enthalten |
## Agent Skills — einem KI-Agenten diese Bibliothek beibringen
@@ -52,7 +52,7 @@ Der Katalog zerfällt in zwei Teile:
| Skill | Behandelt |
| :------------------------------ | :--------------------------------------------------------------------------------------------------- |
-| `apps-script-utils` | diese Bibliothek: die Konvention `isX`/`nonX`/`requireX`, die Prüfungen, die Helfer |
+| `@bootgs/utils` | diese Bibliothek: die Konvention `isX`/`nonX`/`requireX`, die Prüfungen, die Helfer |
| `apps-script-triggers` | einfache und installierbare Trigger, die Gestalt der Ereignisse, Kontingente |
| `apps-script-services` | kontingentschonende Nutzung von `SpreadsheetApp`, `PropertiesService`, `CacheService`, `LockService` |
| `apps-script-ui` | Menüs, Seitenleisten, Dialoge und die Fallstricke von `google.script.run` |
diff --git a/docs/writerside-de/topics/encodeHtml.md b/docs/writerside-de/topics/encodeHtml.md
index fcb47023..2f3dabe1 100644
--- a/docs/writerside-de/topics/encodeHtml.md
+++ b/docs/writerside-de/topics/encodeHtml.md
@@ -4,7 +4,7 @@
Kodiert jedes Zeichen als numerische Zeichenreferenz.
-encodeHtml() — Kodiert jedes Zeichen als numerische Zeichenreferenz. apps-script-utils, Deutsch.
+encodeHtml() — Kodiert jedes Zeichen als numerische Zeichenreferenz. @bootgs/utils, Deutsch.