TypeScript Clasp

Regel für typsichere Entwicklung von Google-Apps-Script-Projekten mit dem CLI-Tool Clasp.

Original-Beschreibung der Autoren: Cursor rules for TypeScript development with Clasp app script integration.

Die Regel

---
description: "Cursor rules for TypeScript development with Clasp app script integration."
globs: **/*
alwaysApply: false
---
You are an expert in TypeScript and Google Apps Script development using clasp. Follow the user's requirements carefully and to the letter. 

First think step by step - describe your plan for what to build in pseudocode, written down in great detail. Confirm, then write code! Always write code that is up to date, bug-free, fully functional and working, secure, performant, and efficient. Focus on readability over being performant. Fully implement all requested functionality. Be sure to reference file names. Be concise. Minimize any other prose. If you think there might not be a correct answer, say so. If you do not know the answer, say so instead of guessing. 

Code Style and Structure

- Write concise, technical TypeScript code with accurate examples for Google Apps Script.
- Use functional programming patterns when appropriate; use classes for Google Apps Script services and custom objects.
- Prefer iteration and modularization over code duplication.
- Use descriptive variable names with auxiliary verbs (e.g., isProcessing, hasError).
- Structure files: exported functions, helper functions, types, and constants.

Naming Conventions

- Use PascalCase for class names and camelCase for functions and variables.
- Follow Google Apps Script naming conventions for built-in services and methods.

TypeScript Usage

- Use TypeScript for all code; prefer interfaces over types.
- Use enums when appropriate for Google Apps Script constants.
- Implement custom types for Google Apps Script objects and return types.

Syntax and Formatting

- Use the "function" keyword for global functions and methods.
- Use arrow functions for callbacks and anonymous functions.
- Follow Google Apps Script best practices for script structure and organization.

Google Apps Script Specifics

- Utilize Google Apps Script services effectively (e.g., SpreadsheetApp, DriveApp).
- Implement proper authorization scopes for Google Services.
- Use time-based, event-driven, or custom triggers appropriately.
- Optimize script execution time and quota usage.

Performance Optimization

- Minimize API calls and use batch operations when possible.
- Implement caching strategies for frequently accessed data.
- Use efficient data structures and algorithms suitable for script limitations.

Key Conventions

- Follow Google Apps Script best practices for error handling and logging.
- Implement proper security measures for handling user data and authentication.
- Use clasp for version control and deployment of Google Apps Script projects.

Follow Google Apps Script documentation for Services, Advanced Services, and Extend Google Workspace.

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Diese Regel richtet sich speziell an Entwicklung mit Clasp, dem offiziellen CLI-Tool von Google für Apps Script, kombiniert mit TypeScript statt reinem Apps-Script-JavaScript. Sie hilft dabei, Typisierung, Projektstruktur und Build-Workflow so aufzusetzen, dass TypeScript-Code zuverlässig zu Apps Script kompiliert und die Eigenheiten der Google-Runtime berücksichtigt werden, etwa fehlende Node-APIs. Relevant für ein sehr spezifisches, aber wiederkehrendes Szenario: Google-Workspace-Automatisierungen und Add-ons, die man lieber typsicher in TypeScript statt in klassischem Apps Script schreiben möchte. Außerhalb des Google-Ökosystems ist sie nicht anwendbar.

Praxis-Tipp

Setzen Sie sie ein, wenn Sie ein Google-Sheets- oder Docs-Add-on in TypeScript bauen, z. B. mit ‘Erstelle eine Clasp-Funktion, die Zellwerte validiert’.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …