TypeScript Clasp

Cursor-Regel für TypeScript-Entwicklung mit Clasp, dem CLI-Tool für Google Apps Script.

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

Clasp ist Googles offizielles CLI-Tool, um Apps-Script-Projekte lokal in TypeScript statt im Web-Editor zu entwickeln. Diese Cursor-Regel gibt Konventionen für diesen speziellen Workflow vor: Umgang mit den Google-Apps-Script-Typdefinitionen, Struktur von .clasp.json/appsscript.json und die Einschränkungen der Apps-Script-Laufzeitumgebung (kein volles Node-API, spezielle Trigger-Funktionen). Nützlich für alle, die Google-Workspace-Automatisierungen (Sheets, Docs, Gmail) mit echter TypeScript-Tooling statt im schwerfälligen Online-Editor bauen. Für normale Node- oder Frontend-Projekte ohne Apps-Script-Bezug ist sie irrelevant, da sie sehr spezifisch auf die Eigenheiten dieser Google-Plattform zugeschnitten ist.

Praxis-Tipp

Erst clasp init/clone im Projekt einrichten, dann die Regel aktivieren — sie entfaltet ihren Nutzen erst im Zusammenspiel mit einer bestehenden Apps-Script-Projektstruktur.

Lizenz & Quelle

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

Lade …