AI-native design editor. Open-source Figma alternative.
docs: sync translations with documentation changes since v0.15.1 (#886)
Danila Poyarkovb9753aa01645
diff --git a/packages/docs/de/getting-started.md b/packages/docs/de/getting-started.mdindex 6e770562b..4985c1b48 100644--- a/packages/docs/de/getting-started.md+++ b/packages/docs/de/getting-started.md@@ -18,6 +18,18 @@ Fertige Versionen für macOS, Windows und Linux finden Sie auf der [Release-Seit| Windows (ARM) | `.msi` / `.exe` || Linux (x64) | `.AppImage` / `.deb` |+## Systemvoraussetzungen++OpenPencil rendert mit CanvasKit über WebGL und nutzt aktuelle Webplattform-Funktionen, daher ist eine neuere Browser-Engine erforderlich. Die Webversion unterstützt Chrome 111, Edge 111, Firefox 128 und Safari 16.4 oder neuer; Chromium-basierte Browser wie Brave und Opera richten sich nach ihrer Chrome-Version. Die Desktop-Anwendung rendert im WebView des Systems, daher bestimmt die Engine des Betriebssystems die Untergrenze:++| Plattform | Voraussetzung |+| --------- | ------------- |+| macOS | macOS 13 Ventura oder neuer mit den aktuellen Safari-Updates (Safari 16.4 wurde mit macOS 13.3 ausgeliefert). |+| Windows | Windows 10 oder neuer mit der Laufzeitumgebung Microsoft Edge WebView2 Evergreen, die sich selbst aktualisiert. |+| Linux | WebKitGTK 2.40 oder neuer (`webkit2gtk-4.1`). |++Ist die Engine zu alt, zeigt OpenPencil an, was aktualisiert werden muss, statt ein leeres Fenster darzustellen. Erscheint dieser Hinweis auf einem System, das die Voraussetzungen erfüllt, verwenden Sie den Link „Report a problem“, der die Angaben zu Browser und Engine vorausfüllt.+## Installation unter macOS mit Homebrew```shdiff --git a/packages/docs/de/overview/features.md b/packages/docs/de/overview/features.mdindex c5f27dd38..8c60be895 100644--- a/packages/docs/de/overview/features.md+++ b/packages/docs/de/overview/features.md@@ -19,7 +19,7 @@ OpenPencil öffnet und speichert `.fig`-Dateien direkt. Import und Export verwen## Eigenschaften-Die Registerkarten Design, Code und AI passen sich der aktuellen Auswahl an:+Die Registerkarten Design, Code, KI und Prüfen passen sich der aktuellen Auswahl an:- **Darstellung:** Deckkraft, einheitlicher oder separater Eckenradius und Sichtbarkeit.- **Füllung:** Volltonfarbe, lineare, radiale, Winkel- und Diamantverläufe sowie Bilder.@@ -28,6 +28,8 @@ Die Registerkarten Design, Code und AI passen sich der aktuellen Auswahl an:- **Typografie:** Schriftwahl mit Suche und virtuellem Scrollen, Schnitt, Größe, Ausrichtung und Formatierung.- **Anordnung:** Einstellungen der automatischen Anordnung.- **Export:** Maßstab, PNG/JPG/WEBP/SVG und Vorschau.+- **Code:** Design JSX und Tailwind JSX für die Auswahl, mit Design JSX live in beide Richtungen bearbeitbar: Der Code wird angepasst, wenn sich Ebenen ändern. Das Element an der Cursorposition umrandet seine Ebene auf der Arbeitsfläche, und Designprobleme werden an der Eigenschaft unterstrichen, die sie verursacht.+- **Prüfen:** Live-Designprüfung für die Seite oder die Auswahl: geringer Kontrast, kleine Touch-Ziele, nicht gebundene Farben, Abstände außerhalb der Skala, mit Problemmarkierungen auf der Arbeitsfläche und Variablenbindung per Klick ([Designs prüfen](/user-guide/checking-designs)).## Darstellungdiff --git a/packages/docs/de/programmable/ai-chat.md b/packages/docs/de/programmable/ai-chat.mdindex 5ae250b7e..ed31f43d3 100644--- a/packages/docs/de/programmable/ai-chat.md+++ b/packages/docs/de/programmable/ai-chat.md@@ -43,12 +43,13 @@ Der Assistent verfügt über mehr als 90 Werkzeuge für Erstellung, Gestaltung,## Visuelle Prüfung-Nach Änderungen kann der Assistent das Ergebnis mit `export_image` rendern und mit der Anfrage vergleichen. Dadurch werden Anordnungsfehler, fehlende Elemente und abweichende Farben sichtbar.+Nach Änderungen kann der Assistent das Ergebnis mit `export_image` rendern und mit der Anfrage vergleichen. Dadurch werden Anordnungsfehler, fehlende Elemente und abweichende Farben sichtbar. `diff_visual`, standardmäßig aktiviert, vergleicht ein bearbeitetes Objekt mit einer Referenzkopie und liefert die geänderten Pixel und den betroffenen Bereich, sodass der Assistent prüfen kann, ob eine Änderung auf ihr Ziel beschränkt blieb.## Hinweise- Vor der Anfrage die betreffenden Objekte auswählen; der Assistent kennt die aktuelle Auswahl.- Farben, Größen und Positionen möglichst genau angeben.- Eine Nachricht kann mehrere Objekte ändern.+- Während eine Antwort läuft, können Sie andere Seiten ansehen: Der Assistent arbeitet auf der Seite weiter, auf der die Nachricht begonnen hat, und seine Vorschauen erscheinen, sobald Sie zurückkehren. Solange Sie woanders sind, nennt der Chat die Seite, an der gearbeitet wird, mit **Zur Seite**, um dorthin zurückzukehren. Wechselt der Assistent selbst die Seite, folgt Ihre Ansicht.- Änderungen durch AI können rückgängig gemacht werden.- Nach jedem Werkzeugaufruf wird die Anordnung neu berechnet.diff --git a/packages/docs/de/programmable/cli/exporting.md b/packages/docs/de/programmable/cli/exporting.mdindex bbbd2f599..f399656ea 100644--- a/packages/docs/de/programmable/cli/exporting.md+++ b/packages/docs/de/programmable/cli/exporting.md@@ -1,11 +1,11 @@---title: Export mit der CLI-description: PNG, JPG, WEBP, SVG, `.fig`, JSX und HTML exportieren oder Dokumentformate umwandeln.+description: PNG, JPG, WEBP, SVG, `.fig`, JSX, HTML und Storybook-Stories exportieren oder Dokumentformate umwandeln.---# Export mit der CLI-Die CLI exportiert Rasterbilder, SVG, Teile eines Dokuments als `.fig`, JSX und HTML.+Die CLI exportiert Rasterbilder, SVG, Teile eines Dokuments als `.fig`, JSX, HTML und Storybook-Stories.## Formate@@ -17,12 +17,12 @@ openpencil export design.fig -f fig --page "Page 1" # Seite als .figopenpencil export design.fig -f html --css tailwind # HTML mit Tailwind-Klassen```-`-f` wählt das Format, `-s` den Maßstab, `-q` die Qualität und `-o` den Ausgabepfad. `--page` und `--node` begrenzen den Export.+`-f` wählt das Format (`png`, `jpg`, `webp`, `svg`, `pdf`, `pptx`, `jsx`, `html`, `fig`, `storybook`), `-s` den Maßstab, `-q` die Qualität und `-o` den Ausgabepfad. `--page` und `--node` begrenzen den Export.## JSX```sh-openpencil export design.fig -f jsx --style tailwind+openpencil export design.fig -f tailwind-jsx # oder: -f jsx --style tailwind````--style openpencil` erzeugt das native JSX-Format des [JSX-Renderers](../jsx-renderer).@@ -38,3 +38,46 @@ openpencil export design.fig -f html --html standalone --assets externalDer eigenständige HTML-Export wird sofort mit Tailwind kompiliert und benötigt keine Browser-Laufzeit. `--assets external` schreibt CSS und Bilder neben die HTML-Datei. `--fonts assets` speichert aufgelöste Webschriften als lokale `@font-face`-Dateien.Der HTML-Export dient Übergabe und Weiterverarbeitung, nicht als pixelgenauer Ersatz für die Darstellung auf der Arbeitsfläche.++## Storybook++Erzeugt pro Komponentensatz oder Komponente eine CSF3-Datei `.stories.ts`:++```sh+openpencil export design.fig -f storybook # React-Stories in ./design-stories/+openpencil export design.fig -f storybook --framework vue -o src/stories+openpencil export design.fig -f storybook --framework html --page "Components"+openpencil export design.pen -f storybook -o src/stories --watch # bei jedem Speichern neu exportieren+openpencil export 'src/**/*.pen' -f storybook --beside --watch # Stories neben jedem Design+```++### Designs neben ihren Stories++Legen Sie die Designdatei jeder Komponente in den Ordner der Komponente und exportieren Sie mit `--beside`: Die Stories, Designbilder und das Manifest `.openpencil-stories.json` jedes Dokuments landen im eigenen Ordner dieses Dokuments, neben dem Code der Komponente. Ein Storybook-`stories`-Glob wie `../src/**/*.stories.ts` in `.storybook/main.ts` erfasst sie dann ohne weitere Konfiguration.++Sie können mehrere Dokumente übergeben oder einen Glob in Anführungszeichen wie `'src/**/*.pen'`, den OpenPencil selbst auflöst (Node.js 22 oder neuer). Mehrere Dokumente erfordern `--beside` oder `--output`; `--page` funktioniert nur mit einem Dokument. Die Dokumente werden nacheinander exportiert, und schlägt eines fehl, werden die übrigen trotzdem exportiert, bevor der Befehl mit einem Fehler endet. `--watch` beobachtet jedes passende Dokument; ein Dokument, das nach dem Start der Beobachtung entsteht, erfordert einen neuen Lauf.++Jede Variante eines Komponentensatzes wird zu einer Story, und ihre Variantenmerkmale werden zu `select`-Controls, sodass das Umschalten eines Controls die passende Variante zeigt. Eigenständige Komponenten mit Schrägstrich im Namen, etwa `Button/Primary` und `Button/Secondary`, werden in einer `Button`-Datei mit einem `Variant`-Control zusammengefasst. Eine Kombination, für die das Design keine Variante hat, löst in Storybook einen benannten Fehler aus, statt eine andere Variante zu zeigen.++Die Stories rendern die Komponente wie `-f html` als HTML mit Inline-Stilen und benötigen daher keine OpenPencil-Laufzeit; `--framework` (`react`, `vue` oder `html`) ändert nur den Wrapper und den Import von `Meta`/`StoryObj` aus `@storybook/react-vite`, `@storybook/vue3-vite` oder `@storybook/html-vite`. Text verwendet die Schriftfamilien des Dokuments, die Storybook selbst laden muss. Text-, Boolean- und Instanztausch-Eigenschaften werden noch nicht exportiert.++Die Stories enthalten `parameters.design`-Einträge für [`@storybook/addon-designs`](https://github.com/storybookjs/addon-designs):++- **OpenPencil:** Liegt der Dokumentpfad im aktuellen Verzeichnis, ein [`openpencil://`-Link](../index#url-scheme), der das Dokument in der Desktop-Anwendung öffnet und die Variante auswählt, oder ihren Komponentensatz, wenn eine andere Ebene den Namen der Variante trägt. Das Schema adressiert Ebenen über ihren Namen; eine Story, deren Varianten- und Komponentenname beide von anderen Ebenen geteilt werden, erhält keinen Link.+- **Design:** ein PNG der Variante in 2×, das neben der Story in `<Name>.design/` abgelegt und mit `new URL(…, import.meta.url)` referenziert wird, sodass Vite es bündelt. Kopieren Sie den Parameter in die Story Ihrer eigenen Komponente, um die Implementierung mit dem Design zu vergleichen. `--no-design-images` überspringt das Rendern; die Schriftersetzung folgt wie beim Rasterexport `--font-policy`.++`-o` benennt das Ausgabeverzeichnis. Ein dortiges Manifest `.openpencil-stories.json` hält fest, welches Dokument (als Pfad relativ zum Ausgabeverzeichnis) und welche Seite jede Story und jedes Designbild erzeugt hat; checken Sie es zusammen mit den Stories ein. Ein Export ersetzt die Dateien, die ein früherer Export desselben Dokuments dort erzeugt hat, auch die inzwischen gelöschter oder umbenannter Komponenten; mit `--page` nur die dieser Seite. Er weigert sich, bevor etwas geändert wird, jede andere Datei zu überschreiben – eine handgeschriebene Story, die eines anderen Dokuments oder ein verirrtes Bild. Ein Export einer einzelnen Seite, dessen Dateinamen auf die Stories einer anderen Seite verschoben wurden, verlangt stattdessen einen vollständigen Export. Ohne das Manifest gelten vorhandene Stories als fremd, entfernen Sie sie daher vor einem erneuten Export. `--watch` hält den Befehl am Laufen und exportiert bei jedem Speichern des Dokuments neu, sodass das Hot Reload von Storybook dem Design folgt; ein Speicherstand, der nicht gelesen werden kann, wird gemeldet, und die Beobachtung läuft weiter. Ein fehlendes `--page` oder eine Ersetzung bei `--font-policy strict` beendet den Befehl dennoch.++## Laufende Anwendung++Ohne Dateiargument exportiert die CLI aus der laufenden Anwendung:++```sh+openpencil export -f png # Auswahl im aktiven Dokument exportieren+openpencil export --page "Components" -f png # alle Ebenen einer Seite exportieren+openpencil export --node 1:23 -f png # eine Ebene auf einer beliebigen Seite exportieren+```++`--page` nimmt einen Seitennamen und `--page-id` eine Seiten-ID aus `openpencil documents list`; beide exportieren diese Seite, ohne die Anwendung zu ihr zu wechseln. Mit `--document-id` exportieren Sie aus einem anderen als dem aktiven Dokument.++Dieser Modus unterstützt PNG, JPG, WEBP, SVG und PDF. PowerPoint, JSX, HTML, Storybook und `.fig` erfordern ein Dateiargument.diff --git a/packages/docs/de/programmable/cli/inspecting.md b/packages/docs/de/programmable/cli/inspecting.mdindex e6f7373fb..d9ef1930f 100644--- a/packages/docs/de/programmable/cli/inspecting.md+++ b/packages/docs/de/programmable/cli/inspecting.md@@ -66,6 +66,7 @@ Für automatisierte Abläufe zuerst `openpencil documents list --json` aufrufenopenpencil lint design.figopenpencil lint design.pen --preset strictopenpencil lint design.fig --rule color-contrast+openpencil lint design.fig --fix -o fixed.fig```-Alle Befehle unterstützen `--json`.+Alle Befehle unterstützen `--json`; jede Meldung enthält ihre `fix`- und `suggestions`-Angaben als Daten. `--fix` wendet die sicheren Korrekturen an – Farben werden an die passende Farbvariable gebunden und die Geometrie auf ganze Pixel gerundet – und schreibt das Ergebnis in die mit `-o` angegebene `.fig`-Datei.diff --git a/packages/docs/de/programmable/collaboration.md b/packages/docs/de/programmable/collaboration.mdindex ed1de0c7e..49273e198 100644--- a/packages/docs/de/programmable/collaboration.md+++ b/packages/docs/de/programmable/collaboration.md@@ -19,11 +19,16 @@ Jede Person mit dem Link kann beitreten. Der Raum bleibt erreichbar, solange min- **Dokument:** Änderungen an Formen, Text, Eigenschaften und Anordnung;- **Zeiger:** Position, Name und Farbe jedes Teilnehmers;-- **Auswahl:** ausgewählte Objekte der anderen Teilnehmer.+- **Auswahl:** ausgewählte Objekte der anderen Teilnehmer;+- **Agenten:** Der integrierte AI-Chat erscheint als Zeiger an den Ebenen, die er bearbeitet; seine umrandete Beschriftung zeigt ein Funkelsymbol und einen Rufnamen wie *Fern*. Zeiger und Umrandung haben die Farbe der Person, die den Agenten ausführt, sodass erkennbar ist, wem er gehört. Geteilt werden nur Name, Art, Modell, Status, Seite, Position und bearbeitete Ebenen, niemals Prompts oder Antworten.## Ansichtsverfolgung-Ein Klick auf einen Avatar folgt der Ansicht dieses Teilnehmers. Position und Zoom werden angepasst. Ein weiterer Klick beendet die Verfolgung.+Ein Klick auf einen Avatar folgt der Ansicht dieses Teilnehmers. Position und Zoom werden angepasst, und ein Rahmen in dessen Farbe mit einer Leiste „Du folgst …“ zeigt, wem Sie folgen. Zum Beenden klicken Sie erneut auf den Avatar, drücken <kbd>Esc</kbd> oder klicken, scrollen, zoomen oder wechseln selbst die Seite.++Ein Avatar zählt die Agenten, die die Person ausführt. Beim Daraufzeigen erscheinen alle Agenten, ihre Tätigkeit und die jeweilige Seite; mit **Folgen** neben einem Agenten bleiben die Seite und die Ebenen, die er bearbeitet, im Blick. Die Verfolgung läuft zwischen seinen Antworten weiter und endet, wenn er den Raum verlässt. Die Schaltfläche nach den Avataren listet alle Personen im Raum mit ihren Agenten auf und ist per Tastatur bedienbar. Ihr eigener Avatar listet Ihre Agenten auf – ein Klick benennt einen Agenten um – und enthält **Raum verlassen**.++Das Teilen-Panel listet alle Personen im Raum mit den Agenten auf, die sie ausführen, mit ihrer Tätigkeit und der jeweiligen Seite. Einem Agenten folgen Sie auf dieselbe Weise, um die Seite und die Ebenen, die er bearbeitet, im Blick zu behalten; die Verfolgung läuft zwischen seinen Antworten weiter und endet, wenn er den Raum verlässt. Mit einem Doppelklick auf einen eigenen Agenten benennen Sie ihn um.## Technische Grundlagediff --git a/packages/docs/de/programmable/index.md b/packages/docs/de/programmable/index.mdindex 5b490beb6..bc0b27674 100644--- a/packages/docs/de/programmable/index.md+++ b/packages/docs/de/programmable/index.md@@ -34,9 +34,9 @@ In der Gegenrichtung exportiert OpenPencil eine Auswahl als JSX oder HTML mit TaDie CLI untersucht, exportiert und analysiert `.fig`-Dateien ohne geöffneten Editor. Sie listet Seiten und Objekte auf, sucht Inhalte, extrahiert Designtoken und rendert PNG. Für die Weiterverarbeitung steht eine JSON-Ausgabe zur Verfügung.-Über RPC kann die CLI außerdem den laufenden Desktop-Editor steuern.+Über RPC kann die CLI außerdem den laufenden Desktop-Editor steuern: Dokumente öffnen, speichern und wechseln, Änderungen rückgängig machen, Einstellungen ändern und jedes MCP-Werkzeug aufrufen.-[Dateien untersuchen](./cli/inspecting) · [Export](./cli/exporting) · [Designs analysieren](./cli/analyzing) · [Skripte](./cli/scripting)+[Dateien untersuchen](./cli/inspecting) · [Export](./cli/exporting) · [Designs analysieren](./cli/analyzing) · [Skripte](./cli/scripting) · [App steuern](/programmable/cli/app-control)## MCP-Server@@ -44,6 +44,32 @@ Claude Code, Cursor, Windsurf und andere MCP-Clients können dieselben 90 Werkze[MCP-Server →](/programmable/mcp-server)+## URL-Schema {#url-scheme}++Die Desktop-Anwendung registriert `openpencil://`. Eine veröffentlichte Seite – eine Storybook-Story, eine Design-Review, eine README – kann damit direkt auf eine Ebene verweisen:++```+openpencil://open?file=web/design/hikyo.pen&node=Button/Large/Default+```++`file` ist ein auf das Repository bezogener Pfad, der auf `.pen` oder `.fig` endet; absolute Pfade und Segmente `.` oder `..` werden abgelehnt. `node` ist optional. Beide Werte sind URL-kodiert – Pfadtrenner dürfen unkodiert bleiben, ein literales `+` muss jedoch als `%2B` gesendet werden –, und bei einem wiederholten Schlüssel gilt der letzte Wert.++Die App gleicht `file` mit den Pfaden der geöffneten Tabs als vollständige abschließende Segmentfolge ab und fokussiert diesen Tab, ohne das Dokument erneut zu lesen. So wird die Ebene auch dann ausgewählt, wenn die Datei seit dem Öffnen verschoben wurde oder nicht mehr lesbar ist. Es gilt der erste geöffnete Tab, dessen Pfad auf den angeforderten Pfad endet; das ist wichtig, wenn zwei Checkouts dieselbe Datei geöffnet haben. Die Segmente werden so verglichen, wie es das Dateisystem der Plattform tut: unter macOS und Windows ohne Beachtung der ASCII-Groß-/Kleinschreibung, unter Linux exakt. `Web/Design/hikyo.pen` und `web/design/hikyo.pen` sind daher auf einem Mac dieselbe Datei und unter Linux zwei verschiedene. Passt kein geöffneter Tab, fragt ein Dateidialog einmal nach der Datei; die gewählte Datei muss auf denselben relativen Pfad enden, sonst wird der Link abgebrochen. Es wird kein Pfad an ein Stammverzeichnis angehängt, und über das, was der Dialog liefert, hinaus wird kein Dateisystemzugriff gewährt. Eine Datei, die der Link tatsächlich öffnet – die gewählte –, kommt wie jede andere geöffnete Datei in die Liste der zuletzt geöffneten Dateien; das Fokussieren eines bereits geöffneten Tabs ändert die Liste nicht, weil nichts geöffnet wurde.++Mit einem Objektnamen wählt die App alle Ebenen auf der aktuellen Seite aus, die genau diesen Namen tragen, und zoomt die Ansicht auf die gesamte Auswahl. Enthält die aktuelle Seite keine, wechselt die App zur ersten Seite, die eine enthält, und lädt dazu bei Bedarf Seiten nach. Ein unbekannter Name zeigt einen Hinweis und lässt das Dokument geöffnet. Das Schema kann nur eine Datei öffnen und Ebenen auswählen.++Die Webversion nimmt denselben Link aus ihrer Adressleiste an:++```+https://app.openpencil.dev/?file=https://raw.githubusercontent.com/open-pencil/open-pencil/master/tests/fixtures/pencil_button.pen&node=Button/Large/Default+```++Hier ist `file` eine absolute `https:`-URL, die auf `.pen` oder `.fig` endet – die Webversion hat kein Dateisystem, daher werden ein relativer Pfad, eine `http:`-URL oder jede andere Endung mit einer Warnung in der Konsole und sonst ohne Folgen abgelehnt. Die Endung wird dem Pfad der URL entnommen, ein Query-String an der verlinkten Datei ändert also nichts. Ein Fragment wird vor dem Abruf entfernt: Es erreicht den Server nie, daher öffnen `…/hikyo.pen#a` und `…/hikyo.pen#b` einen Tab, nicht zwei. `node` verhält sich genau wie oben: dieselbe Auswahl nach exaktem Namen samt Zoom, derselbe Hinweis, wenn keine Ebene den Namen trägt. Beide Werte sind URL-kodiert, ein literales `+` muss als `%2B` gesendet werden, und bei einem wiederholten Schlüssel gilt der letzte Wert, wie in der Desktop-Anwendung. Der Link wird auf jeder Route verarbeitet, `/share/<room>?file=…` und `/demo?file=…` funktionieren also wie `/?file=…`.++Der Browser ruft die Datei Cross-Origin ab, der Host muss das daher erlauben: `raw.githubusercontent.com` sendet `Access-Control-Allow-Origin: *` und funktioniert. Die Anfrage enthält keine Zugangsdaten und folgt keinen Weiterleitungen, damit ein `https:`-Link nicht auf einen unverschlüsselten umgeleitet werden kann – eine URL der Form `https://github.com/<owner>/<repo>/raw/...` leitet auf `raw.githubusercontent.com` weiter und wird deshalb abgelehnt; verlinken Sie daher direkt den Raw-Host. `file` und `node` werden über den Router aus der Adressleiste entfernt, sobald sie gelesen wurden – vor dem Abruf und auch dann, wenn der Link abgelehnt wurde –, sodass ein Neuladen das Dokument nicht erneut öffnet und weder eine kopierte URL noch eine spätere Navigation in der App den Link enthält. Ein verlinktes Dokument ist auf 64 MiB begrenzt: Der Body wird beim Streamen mitgezählt, nicht aus `Content-Length` übernommen, und die Anfrage wird abgebrochen, sobald die Grenze überschritten ist; der Link meldet dann, dass die Datei 64 MiB überschreitet. Eine Bereitstellung, die die App mit einer Content-Security-Policy ausliefert, muss den verlinkten Host in `connect-src` erlauben, sonst wird der Abruf blockiert und der Link meldet, dass die Datei nicht geöffnet werden konnte.++Unter macOS gehört das Schema dem installierten App-Bundle, Links erreichen daher einen installierten Build und keinen `tauri dev`-Prozess. Unter Windows und Linux kommt der Link über das Deep-Link-Plugin an, auch wenn die App noch nicht läuft: Der Link wird beim Start vorgemerkt und verarbeitet, sobald der Editor bereit ist; unter Linux reicht der mitgelieferte Desktop-Eintrag den Link über `%U` weiter.+## Offene PlattformOpenPencil steht unter der MIT-Lizenz, speichert Dokumente lokal und macht seine Vorgänge programmatisch zugänglich. `.fig`-Dateien können untersucht, umgewandelt, in CI verarbeitet oder als Kontext an ein Sprachmodell übergeben werden, ohne an einen bestimmten Hostinganbieter gebunden zu sein.diff --git a/packages/docs/de/programmable/jsx-renderer.md b/packages/docs/de/programmable/jsx-renderer.mdindex 32da21fad..1ff60caf0 100644--- a/packages/docs/de/programmable/jsx-renderer.md+++ b/packages/docs/de/programmable/jsx-renderer.md@@ -20,6 +20,8 @@ Das Werkzeug `render`, verfügbar in AI-Chat, MCP und CLI `eval`, akzeptiert JSX</Frame>```+In Anwendungs- oder Headless-Bibliothekscode importieren Sie `Frame`, `Text` und weitere Authoring-Exporte aus `@open-pencil/design-jsx` und erzeugen die Objekte mit `renderTree` oder `renderJSX` aus `@open-pencil/core/design-jsx`, die Icons, SVG-Umwandlung und Layout ergänzen. Um die Bäume als TSX zu schreiben, setzen Sie in der `tsconfig.json` `"jsxImportSource": "@open-pencil/design-jsx"` zusammen mit `"jsx": "react-jsx"` oder fügen der Datei den Kommentar `/** @jsxImportSource @open-pencil/design-jsx */` hinzu. Welche APIs `eval` bereitstehen, bestimmt die Skriptumgebung; Paket-Exporte sind dort nicht automatisch global verfügbar.+## ElementeJSX-Elemente wie `<Frame>`, `<Rectangle>`, `<Ellipse>`, `<Text>`, `<Line>`, `<Vector>`, `<Group>` und `<Section>` erzeugen die entsprechenden OpenPencil-Objekte.@@ -40,4 +42,4 @@ openpencil export design.fig -f jsxopenpencil export design.fig -f jsx --style tailwind```-Exportiertes JSX kann als Code verändert und erneut gerendert werden. Unterschiede können in Pull Requests geprüft und in der Versionsverwaltung gespeichert werden.+Exportiertes JSX kann als Code verändert und erneut gerendert werden. Der Export schreibt ausgeblendete und gesperrte Ebenen, Constraints, Größenbegrenzungen, gestapelte Füllungen, Verlaufs- und Bildfüllungen, Konturen, Effekte, Masken und Variablenbindungen. Das erneute Rendern eines Exports bildet sie daher nach, und `diff_jsx` zeigt Änderungen an jedem davon. Rich Text mit gemischten Stilen, Vektorpfade, Layoutraster, geteilte Stile und Definitionen von Komponenteneigenschaften werden noch nicht geschrieben. Instanzen werden als Rahmen mit ihrem Inhalt geschrieben, sodass exportiertes JSX für sich allein steht. Unterschiede können in Pull Requests geprüft und in der Versionsverwaltung gespeichert werden.diff --git a/packages/docs/de/programmable/sdk/api/composables/use-export.md b/packages/docs/de/programmable/sdk/api/composables/use-export.mdindex 724cfe56a..1a851cc33 100644--- a/packages/docs/de/programmable/sdk/api/composables/use-export.md+++ b/packages/docs/de/programmable/sdk/api/composables/use-export.md@@ -10,7 +10,7 @@ description: Scale und Format für den Export der aktuellen Selection verwalten.- Export settings;- IDs der ausgewählten Objekte;- Name der Output file;-- verfügbare Scales und Formats.+- verfügbare Scales und Formats (`formats`-IDs und beschriftete `formatOptions`).## Verwendung@@ -28,6 +28,7 @@ const {nodeName,scales,formats,+ formatOptions,addSetting,updateScale,updateFormat,diff --git a/packages/docs/de/user-guide/canvas-navigation.md b/packages/docs/de/user-guide/canvas-navigation.mdindex 02eeb5054..dc95ad394 100644--- a/packages/docs/de/user-guide/canvas-navigation.md+++ b/packages/docs/de/user-guide/canvas-navigation.md@@ -40,3 +40,9 @@ Gesten über den Ebenen- und Eigenschaften-Panels werden nicht an die Arbeitsfl| 100 % | <kbd>⌘</kbd><kbd>0</kbd> | <kbd>Strg</kbd><kbd>0</kbd> || Dokument einpassen | <kbd>⌘</kbd><kbd>1</kbd> | <kbd>Strg</kbd><kbd>1</kbd> || Auf Auswahl zoomen | <kbd>⌘</kbd><kbd>2</kbd> | <kbd>Strg</kbd><kbd>2</kbd> |++## Befehlspalette++<kbd>⌘</kbd><kbd>K</kbd> unter macOS beziehungsweise <kbd>Strg</kbd><kbd>K</kbd> unter Windows und Linux durchsucht Aktionen des Editors und der Anwendung. Ein Treffer wird mit Auswahl ausgeführt; nicht verfügbare Aktionen bleiben von der aktuellen Auswahl und dem Dokumentzustand abhängig.++Die Palette wechselt auch zwischen Seiten. Vor der Eingabe listet sie die in diesem Tab zuletzt besuchten Seiten, die neueste zuerst, und **Zu Seite wechseln…** öffnet eine Liste aller Seiten. Auch die Eingabe eines Seitennamens findet sie. Seiten, auf denen Mitarbeitende oder AI-Agenten arbeiten, nennen deren Namen; das Seiten-Panel markiert dieselben Seiten mit ihren Farben.diff --git a/packages/docs/de/user-guide/index.md b/packages/docs/de/user-guide/index.mdindex c0844d70c..efe6362e7 100644--- a/packages/docs/de/user-guide/index.md+++ b/packages/docs/de/user-guide/index.md@@ -35,3 +35,4 @@ Die Dokumentation verwendet die macOS-Schreibweise: <kbd>⌘</kbd> entspricht <k- [Automatische Anordnung](./auto-layout) — Anordnung mit Flexbox und CSS Grid;- [Komponenten](./components) — wiederverwendbare Komponenten, Instanzen und Überschreibungen;- [Variablen](./variables) — Designvariablen, Sammlungen, Modi und Bindungen.+- [Designs prüfen](/user-guide/checking-designs) — das Prüfen-Panel, Problemmarkierungen auf der Arbeitsfläche und Lint-Regeln.diff --git a/packages/docs/es/getting-started.md b/packages/docs/es/getting-started.mdindex a6ebcf86d..265e39a09 100644--- a/packages/docs/es/getting-started.md+++ b/packages/docs/es/getting-started.md@@ -18,6 +18,18 @@ Las versiones preparadas para macOS, Windows y Linux están disponibles en la [p| Windows (ARM) | `.msi` / `.exe` || Linux (x64) | `.AppImage` / `.deb` |+## Requisitos del sistema++OpenPencil dibuja con CanvasKit sobre WebGL y usa funciones recientes de la plataforma web, por lo que necesita un motor de navegador actual. La versión web admite Chrome 111, Edge 111, Firefox 128 y Safari 16.4 o posteriores; los navegadores basados en Chromium, como Brave u Opera, siguen la versión de Chrome en la que se basan. La aplicación de escritorio dibuja en el WebView del sistema, así que el mínimo depende del motor del sistema operativo:++| Plataforma | Requisito |+| ---------- | --------- |+| macOS | macOS 13 Ventura o posterior con las actualizaciones actuales de Safari instaladas (Safari 16.4 se incluyó con macOS 13.3). |+| Windows | Windows 10 o posterior con el runtime Evergreen de Microsoft Edge WebView2, que se actualiza solo. |+| Linux | WebKitGTK 2.40 o posterior (`webkit2gtk-4.1`). |++Si el motor es demasiado antiguo, OpenPencil muestra qué debes actualizar en lugar de una ventana en blanco. Si ves ese aviso en un sistema que cumple los requisitos, usa su enlace «Report a problem», que rellena de antemano los datos del navegador y del motor.+## Instalación en macOS con Homebrew```shdiff --git a/packages/docs/es/overview/features.md b/packages/docs/es/overview/features.mdindex d48104b6f..4303859a3 100644--- a/packages/docs/es/overview/features.md+++ b/packages/docs/es/overview/features.md@@ -19,7 +19,7 @@ OpenPencil abre y guarda archivos `.fig` directamente. La importación y exporta## Panel de propiedades-Las pestañas Diseño, Código e AI se adaptan a la selección:+Las pestañas Diseño, Código, IA y Revisar se adaptan a la selección:- **Apariencia:** opacidad, radio uniforme o por esquina y visibilidad.- **Relleno:** color sólido, degradados lineal, radial, angular y diamante, e imágenes.@@ -28,6 +28,8 @@ Las pestañas Diseño, Código e AI se adaptan a la selección:- **Tipografía:** selector de fuentes con búsqueda y desplazamiento virtual, estilo, tamaño, alineación y formato.- **Disposición:** controles de la disposición automática.- **Exportación:** escala, PNG/JPG/WEBP/SVG y vista previa.+- **Código:** Design JSX y Tailwind JSX de la selección, con edición bidireccional en vivo de Design JSX que actualiza tu código a medida que cambian las capas; el elemento bajo el cursor resalta su capa en el lienzo y los problemas de diseño se subrayan en la propiedad que los causa.+- **Revisar:** revisión de diseño en vivo de la página o la selección (bajo contraste, áreas táctiles pequeñas, colores sin variable, espaciados fuera de escala), con marcadores de problemas en el lienzo y enlace a variables con un clic ([Revisar diseños](/user-guide/checking-designs)).## Renderizadodiff --git a/packages/docs/es/programmable/ai-chat.md b/packages/docs/es/programmable/ai-chat.mdindex 8995cb27a..48401e2d7 100644--- a/packages/docs/es/programmable/ai-chat.md+++ b/packages/docs/es/programmable/ai-chat.md@@ -31,6 +31,16 @@ El token se guarda en el almacén seguro de credenciales, no en los ajustes ordiLas herramientas cubren lectura, creación, modificación, estructura, variables, vectores, análisis, descripción, generación de código e imágenes de stock. Cada llamada actúa sobre el editor activo y participa en su historial de deshacer cuando corresponde.+## Verificación visual++El asistente puede comprobar su trabajo visualmente. Con `export_image` activada, captura una imagen tras crear o modificar diseños y la compara con lo que se pidió. `diff_visual`, activada por defecto, compara un objeto editado con una copia de referencia y devuelve los píxeles y la región que cambiaron, de modo que el asistente puede confirmar que la edición se limitó a su objetivo.++Las herramientas de inspección incluyen `get_jsx`, `diff_create` y `diff_jsx` para diferencias estructurales, `diff_visual` para diferencias de píxeles y `describe` para el rol semántico y la detección de problemas de diseño.++## Consejos++- Puedes recorrer otras páginas mientras se genera una respuesta: el asistente sigue trabajando en la página donde empezó el mensaje y sus vistas previas aparecen al volver. Mientras estás en otra página, el chat indica en cuál trabaja y ofrece **Ir a la página** para volver. Si el asistente cambia de página por su cuenta, tu vista lo sigue.+## Privacidad y costesLas solicitudes se envían al proveedor configurado. Revisa sus condiciones, política de datos y precios antes de enviar documentos sensibles. OpenPencil no incluye créditos de modelos.diff --git a/packages/docs/es/programmable/cli/exporting.md b/packages/docs/es/programmable/cli/exporting.mdindex b47263646..f9a76b61b 100644--- a/packages/docs/es/programmable/cli/exporting.md+++ b/packages/docs/es/programmable/cli/exporting.md@@ -1,6 +1,6 @@---title: Exportar desde la CLI-description: Generar imágenes, SVG, HTML y otros resultados sin abrir el editor.+description: Generar imágenes, SVG, HTML, historias de Storybook y otros resultados sin abrir el editor.---# Exportar desde la CLI@@ -31,6 +31,57 @@ bun open-pencil export design.fig --node 12:34 -o icon.svgLa exportación HTML genera un documento independiente con la estructura y los estilos disponibles. Está pensada para entrega, inspección y procesamiento posterior, no como sustituto exacto del renderizador CanvasKit. Solo está disponible al trabajar con archivos.+## JSX con Tailwind++Exporta JSX con clases de utilidad Tailwind:++```sh+bun open-pencil export design.fig -f tailwind-jsx # o: -f jsx --style tailwind+```++## Storybook++Genera un archivo CSF3 `.stories.ts` por cada conjunto de componentes o componente:++```sh+bun open-pencil export design.fig -f storybook # historias de React en ./design-stories/+bun open-pencil export design.fig -f storybook --framework vue -o src/stories+bun open-pencil export design.fig -f storybook --framework html --page "Components"+bun open-pencil export design.pen -f storybook -o src/stories --watch # reexporta en cada guardado+bun open-pencil export 'src/**/*.pen' -f storybook --beside --watch # historias junto a cada diseño+```++### Diseños junto a sus historias++Guarda el archivo de diseño de cada componente en la carpeta del componente y exporta con `--beside`: las historias, las imágenes de diseño y el manifiesto `.openpencil-stories.json` de cada documento van a la carpeta de ese documento, junto al código del componente. Un glob de `stories` de Storybook como `../src/**/*.stories.ts` en `.storybook/main.ts` las recoge sin más configuración.++Pasa varios documentos, o un glob entre comillas como `'src/**/*.pen'` que OpenPencil expande por sí mismo (Node.js 22 o posterior). Varios documentos requieren `--beside` o `--output`; `--page` solo funciona con un documento. Los documentos se exportan uno tras otro y, si uno falla, el resto se exporta igualmente antes de que el comando termine con un error. `--watch` vigila todos los documentos coincidentes; un documento creado después de iniciar la vigilancia requiere ejecutar el comando de nuevo.++Cada variante de un conjunto de componentes se convierte en una historia y sus propiedades de variante pasan a ser controles `select`, de modo que al cambiar un control se muestra la variante correspondiente. Los componentes independientes con nombres separados por barras, como `Button/Primary` y `Button/Secondary`, se agrupan en un único archivo `Button` con un control `Variant`. Una combinación para la que el diseño no tiene variante lanza en Storybook un error con nombre en lugar de mostrar otra variante.++Las historias muestran el componente como HTML con estilos en línea, igual que `-f html`, así que no necesitan el runtime de OpenPencil; `--framework` (`react`, `vue` o `html`) solo cambia el contenedor y la importación de `Meta`/`StoryObj` desde `@storybook/react-vite`, `@storybook/vue3-vite` o `@storybook/html-vite`. El texto usa las familias tipográficas del documento, que Storybook debe cargar por su cuenta. Las propiedades de texto, booleanas y de intercambio de instancia aún no se exportan.++Las historias incluyen entradas `parameters.design` para [`@storybook/addon-designs`](https://github.com/storybookjs/addon-designs):++- **OpenPencil:** cuando la ruta del documento está dentro del directorio actual, un [enlace `openpencil://`](../index#url-scheme) que abre el documento en la aplicación de escritorio y selecciona la variante, o su conjunto de componentes cuando otra capa comparte el nombre de la variante. El esquema direcciona las capas por nombre, así que una historia cuyos nombres de variante y de componente comparten otras capas no recibe enlace.+- **Design:** un PNG a 2× de la variante, escrito en `<Name>.design/` junto a la historia y referenciado con `new URL(…, import.meta.url)`, de modo que Vite lo empaqueta. Copia el parámetro a la historia de tu propio componente para comparar la implementación con el diseño. `--no-design-images` omite el renderizado; la sustitución de fuentes sigue `--font-policy`, como en la exportación raster.++`-o` indica el directorio de salida. Allí, un manifiesto `.openpencil-stories.json` registra qué documento, como ruta relativa al directorio de salida, y qué página generó cada historia e imagen de diseño; súbelo al repositorio junto con las historias. Una exportación reemplaza los archivos que generó antes una exportación del mismo documento, incluidos los de componentes eliminados o renombrados desde entonces; con `--page`, solo los de esa página. Antes de cambiar nada, se niega a sobrescribir cualquier otro archivo: una historia escrita a mano, la de otro documento o una imagen suelta. Una exportación de una sola página cuyos nombres de archivo han pasado a historias de otra página pide una exportación completa. Sin el manifiesto, las historias existentes se consideran ajenas, así que elimínalas antes de volver a exportar. `--watch` mantiene el comando en ejecución y reexporta cada vez que se guarda el documento, de modo que la recarga en caliente de Storybook sigue al diseño; un guardado que no se puede leer se notifica y la vigilancia continúa. Un `--page` inexistente o una sustitución con `--font-policy strict` sí terminan el comando.++## Modo con la aplicación en ejecución++Omite el archivo para exportar desde la aplicación en ejecución:++```sh+bun open-pencil export -f png # exporta la selección del documento activo+bun open-pencil export --page "Components" -f png # exporta todas las capas de una página+bun open-pencil export --node 1:23 -f png # exporta una capa, en cualquier página+```++`--page` toma el nombre de una página y `--page-id` el ID de una página de `openpencil documents list`; ambas exportan esa página sin cambiar la aplicación a ella. Añade `--document-id` para exportar desde un documento distinto del activo.++Este modo admite PNG, JPG, WEBP, SVG y PDF. PowerPoint, JSX, HTML, Storybook y `.fig` requieren un archivo como argumento. La exportación de miniaturas en modo archivo aún no es compatible.+## Sobrescritura y rutas`-o` o `--output` define la ruta. La CLI informa de errores de formato, objetos inexistentes y rutas no válidas en lugar de producir resultados parciales silenciosamente.diff --git a/packages/docs/es/programmable/cli/inspecting.md b/packages/docs/es/programmable/cli/inspecting.mdindex eb158fdd9..284922ab2 100644--- a/packages/docs/es/programmable/cli/inspecting.md+++ b/packages/docs/es/programmable/cli/inspecting.md@@ -54,6 +54,33 @@ bun open-pencil variables design.fig`formats` lista los formatos de documento registrados y sus capacidades de lectura y escritura.+## Aplicación en ejecución++Cuando la aplicación de escritorio está abierta, omite el archivo: la CLI se conecta por RPC y opera sobre el lienzo en vivo:++```sh+bun open-pencil documents list # lista los ID de documentos y páginas abiertos+bun open-pencil tree # inspecciona el documento activo+bun open-pencil tree --document-id tab-123 --page-id 0:1+bun open-pencil eval --document-id tab-123 --page-id 0:1 -c "..."+```++En flujos con agentes, usa `bun open-pencil documents list --json` y pasa `--document-id` y `--page-id` de forma explícita en lugar de depender de la pestaña o página visible. Para abrir, guardar, cambiar y cerrar documentos, deshacer, modificar ajustes o llamar a cualquier herramienta del editor, consulta [Controlar la aplicación](/programmable/cli/app-control).++## Lint++`lint` revisa un diseño con reglas de accesibilidad y consistencia.++```sh+bun open-pencil lint design.fig+bun open-pencil lint design.pen --preset strict+bun open-pencil lint design.fig --rule color-contrast+bun open-pencil lint design.fig --list-rules+bun open-pencil lint design.fig --fix -o fixed.fig+```++Usa `--json` para una salida legible por máquinas; cada mensaje incluye su `fix` y sus `suggestions` como datos. `--fix` aplica las correcciones seguras —enlazar los colores a la variable de color que coincide y redondear la geometría a píxeles enteros— y escribe el resultado en el archivo `.fig` indicado con `-o`.+## Salida JSONLos comandos de consulta admiten `--json`, apropiado para `jq`, CI y programas que necesiten una salida estable y legible por máquinas.diff --git a/packages/docs/es/programmable/collaboration.md b/packages/docs/es/programmable/collaboration.mdindex e2f7e9bfe..50d53f577 100644--- a/packages/docs/es/programmable/collaboration.md+++ b/packages/docs/es/programmable/collaboration.md@@ -18,7 +18,16 @@ Quien abre el enlace entra en la misma sala. El documento inicial se sincroniza- **Documento:** cambios en formas, texto, propiedades y disposición;- **Presencia:** nombre, color, selección y página activa;- **Cursores:** posición de cada participante;-- **Vista:** posibilidad de seguir el encuadre de otra persona.+- **Vista:** posibilidad de seguir el encuadre de otra persona;+- **Agentes:** el chat con AI integrado aparece como un cursor sobre las capas que edita, con una etiqueta con contorno que muestra una chispa y un nombre en clave como *Fern*. El cursor y el contorno tienen el color de la persona que lo ejecuta, para que se sepa de quién es el agente. Solo se comparten su nombre, tipo, modelo, estado, página, posición y capas editadas, nunca los prompts ni las respuestas.++## Modo seguimiento++Haz clic en el avatar de un participante en la barra superior para seguir su vista. Tu lienzo se desplaza y amplía para coincidir con la suya, y un marco de su color con una barra «Siguiendo a …» indica a quién sigues. Para dejar de seguir, vuelve a hacer clic en el avatar, pulsa <kbd>Esc</kbd>, o haz clic, desplázate, haz zoom o cambia de página por tu cuenta.++Un avatar cuenta los agentes que ejecuta esa persona. Pasa el cursor por encima para ver cada agente, qué hace y en qué página, y haz clic en **Seguir** junto a un agente para mantener a la vista la página y las capas que edita; el seguimiento continúa entre sus respuestas y termina cuando se va. El botón situado después de los avatares enumera a todos los presentes en la sala con sus agentes y funciona con el teclado. Tu propio avatar enumera tus agentes —haz clic en uno para cambiarle el nombre— y ofrece **Salir de la sala**.++El panel para compartir enumera a todos los presentes en la sala con los agentes que ejecutan, qué hace cada uno y en qué página. Sigue a un agente del mismo modo para mantener a la vista la página y las capas que edita; el seguimiento continúa entre sus respuestas y termina cuando se va. Haz doble clic en uno de tus agentes para cambiarle el nombre.## Arquitecturadiff --git a/packages/docs/es/programmable/index.md b/packages/docs/es/programmable/index.mdindex 307154b73..9a579aa1a 100644--- a/packages/docs/es/programmable/index.md+++ b/packages/docs/es/programmable/index.md@@ -24,7 +24,9 @@ Claude Code, Cursor, Windsurf y otros clientes MCP pueden usar las mismas herramLa CLI examina, exporta y analiza archivos `.fig` sin abrir el editor. Puede listar páginas y objetos, buscar contenido, extraer variables de diseño y generar PNG. `--json` facilita la integración con CI y otros programas.-[CLI →](./cli/inspecting)+La CLI también se conecta a la aplicación de escritorio en ejecución mediante RPC, de modo que puedes automatizar el editor mientras lo usas: abrir, guardar y cambiar de documento, deshacer, modificar ajustes y llamar a cualquier herramienta MCP.++[CLI →](./cli/inspecting) · [Controlar la aplicación](/programmable/cli/app-control)## JSX@@ -40,4 +42,30 @@ El comando `eval` ejecuta JavaScript con un objeto global `figma` compatible. Pe[Scripting con `eval` →](./cli/scripting)+## Esquema de URL {#url-scheme}++La aplicación de escritorio registra `openpencil://`, de modo que una página publicada —una historia de Storybook, una revisión de diseño, un README— puede enlazar directamente a una capa:++```+openpencil://open?file=web/design/hikyo.pen&node=Button/Large/Default+```++`file` es una ruta relativa al repositorio que termina en `.pen` o `.fig`; se rechazan las rutas absolutas y los segmentos `.` o `..`. `node` es opcional. Ambos valores van codificados como URL —los separadores de ruta pueden quedar tal cual, pero un `+` literal debe enviarse como `%2B`— y, si una clave se repite, se usa su último valor.++La aplicación compara `file` con las rutas de las pestañas abiertas como una secuencia completa de segmentos finales y da el foco a esa pestaña sin volver a leer el documento, así que un archivo que se movió o dejó de ser legible desde que se abrió sigue pudiendo seleccionar su capa. Gana la primera pestaña abierta cuya ruta termina con la ruta solicitada, lo que importa cuando dos copias del repositorio tienen abierto el mismo archivo. Los segmentos se comparan como lo hace el sistema de archivos de la plataforma: sin distinguir mayúsculas ASCII en macOS y Windows, y de forma exacta en Linux, de modo que `Web/Design/hikyo.pen` y `web/design/hikyo.pen` son el mismo archivo en un Mac y dos distintos en Linux. Si ninguna pestaña abierta coincide, un selector de archivos pide el archivo una sola vez; el archivo elegido debe terminar con la misma ruta relativa, de lo contrario el enlace se cancela. No se une ninguna ruta a una raíz y no se concede más acceso al sistema de archivos que el que devuelve el selector. Un archivo que el enlace abre de verdad —el elegido— se añade a la lista de archivos recientes como cualquier otro archivo que abras; dar el foco a una pestaña que ya estaba abierta no toca la lista, porque no se abrió nada.++Con un nombre de nodo, la aplicación selecciona todas las capas que llevan exactamente ese nombre en la página actual y ajusta la vista a toda la selección. Si la página actual no tiene ninguna, cambia a la primera página que sí la tenga, cargando páginas según haga falta. Un nombre desconocido muestra un aviso y deja el documento abierto. Abrir un archivo y seleccionar capas es todo lo que puede hacer el esquema.++La versión web acepta el mismo enlace desde su propia barra de direcciones:++```+https://app.openpencil.dev/?file=https://raw.githubusercontent.com/open-pencil/open-pencil/master/tests/fixtures/pencil_button.pen&node=Button/Large/Default+```++Aquí `file` es una URL `https:` absoluta que termina en `.pen` o `.fig`: la versión web no tiene sistema de archivos, así que una ruta relativa, una URL `http:` o cualquier otra extensión se rechaza con una advertencia en la consola y nada más. La extensión se lee de la ruta de la URL, por lo que una cadena de consulta en el archivo enlazado no cambia nada. El fragmento se descarta antes de la descarga: nunca llega al servidor, así que `…/hikyo.pen#a` y `…/hikyo.pen#b` abren una pestaña, no dos. `node` se comporta exactamente igual que arriba: la misma selección por nombre exacto y el mismo zoom, y el mismo aviso cuando ninguna capa lleva ese nombre. Ambos valores van codificados como URL, un `+` literal debe enviarse como `%2B` y una clave repetida toma su último valor, igual que en el escritorio. El enlace se procesa en cualquier ruta, de modo que `/share/<room>?file=…` y `/demo?file=…` funcionan como `/?file=…`.++El navegador descarga el archivo entre orígenes distintos, así que el servidor debe permitirlo: `raw.githubusercontent.com` envía `Access-Control-Allow-Origin: *` y funciona. La solicitud no lleva credenciales y se niega a seguir redirecciones, lo que evita que un enlace `https:` acabe desviado a uno en texto plano: una URL `https://github.com/<owner>/<repo>/raw/...` redirige a `raw.githubusercontent.com` y por tanto se rechaza, así que enlaza directamente al host raw. `file` y `node` se eliminan de la barra de direcciones mediante el router en cuanto se leen —antes de la descarga y también cuando el enlace se rechazó—, de modo que recargar no vuelve a abrir el documento y ni una URL copiada ni una navegación posterior dentro de la aplicación arrastran el contenido del enlace. Un documento enlazado tiene un límite de 64 MiB: el cuerpo se cuenta a medida que llega, sin fiarse de `Content-Length`, y la solicitud se aborta en cuanto lo supera; el enlace informa de que el archivo supera los 64 MiB. Un despliegue que sirva la aplicación con una Content-Security-Policy debe permitir el host enlazado en `connect-src`; de lo contrario la descarga se bloquea y el enlace informa de que no pudo abrir el archivo.++En macOS el esquema pertenece al paquete de la aplicación instalada, por lo que los enlaces llegan a una versión instalada y no a un proceso de `tauri dev`. En Windows y Linux el enlace llega mediante el plugin de deep links, incluso cuando la aplicación aún no está en ejecución: el enlace se pone en cola al arrancar y se procesa cuando el editor está listo; en Linux, la entrada de escritorio incluida pasa el enlace mediante `%U`.+OpenPencil tiene licencia MIT y guarda los documentos localmente. Los archivos `.fig` se pueden examinar, transformar, procesar en CI o proporcionar como contexto a un modelo sin depender de un proveedor de alojamiento concreto.diff --git a/packages/docs/es/programmable/jsx-renderer.md b/packages/docs/es/programmable/jsx-renderer.mdindex 99d03bd84..e25bad8fa 100644--- a/packages/docs/es/programmable/jsx-renderer.md+++ b/packages/docs/es/programmable/jsx-renderer.md@@ -55,6 +55,10 @@ OpenPencil puede convertir JSX declarativo en un árbol de diseño. El mismo sisLas propiedades desconocidas se conservan cuando el tipo de objeto las admite. Los eventos DOM no se ejecutan: el resultado es un documento de diseño, no una aplicación web.+## Importar en código++En código de aplicación o de biblioteca sin interfaz, importa `Frame`, `Text` y el resto de exportaciones de autoría desde `@open-pencil/design-jsx` y crea los nodos con `renderTree` o `renderJSX` de `@open-pencil/core/design-jsx`, que añaden iconos, conversión de SVG y disposición. Para escribir los árboles como TSX, define `"jsxImportSource": "@open-pencil/design-jsx"` con `"jsx": "react-jsx"` en `tsconfig.json`, o añade al archivo el comentario `/** @jsxImportSource @open-pencil/design-jsx */`. El entorno de scripting determina qué API se exponen a `eval`; las exportaciones de los paquetes no son globales automáticamente.+## Exportar a JSX-El menú **Copiar como → JSX** convierte la selección en JSX y clases Tailwind. La salida intenta conservar jerarquía, disposición, tamaños, colores, tipografía y bordes, y sirve como punto de partida para implementar una interfaz.+El menú **Copiar como → JSX** convierte la selección en JSX y clases Tailwind. La salida intenta conservar jerarquía, disposición, tamaños, colores, tipografía y bordes, y sirve como punto de partida para implementar una interfaz. El JSX exportado se puede editar y volver a renderizar en el documento. La exportación incluye capas ocultas y bloqueadas, restricciones, límites de tamaño, rellenos apilados, de degradado y de imagen, contornos, efectos, máscaras y enlaces a variables, así que al renderizarla se reproducen y `diff_jsx` muestra los cambios en cualquiera de ellos. Aún no se escriben el texto enriquecido con estilos mixtos, los trazados vectoriales, las cuadrículas de disposición, los estilos compartidos ni las definiciones de propiedades de componentes. Las instancias se escriben como marcos con su contenido, de modo que el JSX exportado se sostiene por sí solo.diff --git a/packages/docs/es/programmable/sdk/api/composables/use-export.md b/packages/docs/es/programmable/sdk/api/composables/use-export.mdindex a541ae891..87afbea48 100644--- a/packages/docs/es/programmable/sdk/api/composables/use-export.md+++ b/packages/docs/es/programmable/sdk/api/composables/use-export.md@@ -8,7 +8,7 @@ description: Gestionar escala y formato de exportación de la selección actual.`useExport()` proporciona estado y acciones para un panel de exportación:- selección y ajustes actuales;-- formato, escala y sufijo;+- formato (ids en `formats` y opciones con etiqueta en `formatOptions`), escala y sufijo;- vista previa;- creación, actualización y eliminación de ajustes;- ejecución de la exportación.diff --git a/packages/docs/es/user-guide/canvas-navigation.md b/packages/docs/es/user-guide/canvas-navigation.mdindex cb701eb87..6f789d5cc 100644--- a/packages/docs/es/user-guide/canvas-navigation.md+++ b/packages/docs/es/user-guide/canvas-navigation.md@@ -13,6 +13,10 @@ El lienzo no tiene límites. El desplazamiento y el zoom permiten llegar a cualq- Arrastra con el botón central del ratón.- Desliza dos dedos sobre el panel táctil.+## Paleta de comandos y páginas++Pulsa <kbd>⌘</kbd><kbd>K</kbd> en macOS o <kbd>Ctrl</kbd><kbd>K</kbd> en Windows/Linux para buscar acciones del editor y de la aplicación. La paleta también permite cambiar de página. Antes de escribir, muestra las páginas que has visitado recientemente en esta pestaña, las más recientes primero, y **Ir a la página…** abre una lista de todas las páginas. Si escribes el nombre de una página, también la encuentra. Las páginas donde trabajan colaboradores o agentes de AI muestran sus nombres; el panel de páginas marca esas mismas páginas con sus colores.+## Herramienta ManoPulsa <kbd>H</kbd>. Mientras esté activa, cualquier arrastre desplaza la vista sin mantener <kbd>Space</kbd>. Pulsa <kbd>V</kbd> para volver a Selección.diff --git a/packages/docs/es/user-guide/index.md b/packages/docs/es/user-guide/index.mdindex 7ac37f420..3426165f6 100644--- a/packages/docs/es/user-guide/index.md+++ b/packages/docs/es/user-guide/index.md@@ -30,4 +30,5 @@ OpenPencil es un editor de diseño local y de código abierto, compatible con Fi- [Disposición automática](./auto-layout) — distribución con Flexbox y CSS Grid;- [Componentes](./components) — componentes reutilizables, instancias y sustituciones;-- [Variables](./variables) — variables de diseño, colecciones, modos y enlaces.+- [Variables](./variables) — variables de diseño, colecciones, modos y enlaces;+- [Revisar diseños](/user-guide/checking-designs) — panel de revisión, marcadores de problemas en el lienzo y reglas de lint.diff --git a/packages/docs/fr/getting-started.md b/packages/docs/fr/getting-started.mdindex 8f7d31c87..d071622e8 100644--- a/packages/docs/fr/getting-started.md+++ b/packages/docs/fr/getting-started.md@@ -18,6 +18,18 @@ Les versions prêtes à l'emploi pour macOS, Windows et Linux sont disponibles s| Windows (ARM) | `.msi` / `.exe` || Linux (x64) | `.AppImage` / `.deb` |+## Configuration requise++OpenPencil affiche le rendu avec CanvasKit sur WebGL et s’appuie sur des fonctionnalités récentes de la plateforme web ; il faut donc un moteur de navigateur récent. L’application web prend en charge Chrome 111, Edge 111, Firefox 128 et Safari 16.4 ou version ultérieure ; les navigateurs basés sur Chromium, comme Brave et Opera, suivent leur version de Chrome. L’application de bureau s’affiche dans la WebView du système : le minimum dépend donc du moteur du système d’exploitation.++| Plateforme | Configuration requise |+| ---------- | --------------------- |+| macOS | macOS 13 Ventura ou version ultérieure, avec les dernières mises à jour de Safari installées (Safari 16.4 est fourni avec macOS 13.3). |+| Windows | Windows 10 ou version ultérieure, avec le runtime Evergreen de Microsoft Edge WebView2, qui se met à jour seul. |+| Linux | WebKitGTK 2.40 ou version ultérieure (`webkit2gtk-4.1`). |++Lorsque le moteur est trop ancien, OpenPencil indique ce qu’il faut mettre à jour au lieu d’afficher une fenêtre vide. Si cet avis apparaît sur un système conforme, utilisez son lien « Report a problem », qui préremplit les informations sur le navigateur et le moteur.+## Installation sous macOS avec Homebrew```shdiff --git a/packages/docs/fr/overview/features.md b/packages/docs/fr/overview/features.mdindex 58b11e599..a1e68fb59 100644--- a/packages/docs/fr/overview/features.md+++ b/packages/docs/fr/overview/features.md@@ -19,7 +19,7 @@ OpenPencil ouvre et enregistre directement les fichiers `.fig`. L’import et l## Panneau de propriétés-Les onglets Design, Code et AI s’adaptent à la sélection :+Les onglets Design, Code, IA et Vérifier s’adaptent à la sélection :- **Apparence :** opacité, rayon uniforme ou par coin et visibilité.- **Remplissage :** couleur unie, dégradés linéaire, radial, angulaire et diamant, et images.@@ -28,6 +28,8 @@ Les onglets Design, Code et AI s’adaptent à la sélection :- **Typographie :** choix de police avec recherche et défilement virtuel, style, taille, alignement et mise en forme.- **Disposition :** réglages de la disposition automatique.- **Export :** échelle, PNG/JPG/WEBP/SVG et aperçu.+- **Code :** Design JSX et Tailwind JSX pour la sélection, avec édition bidirectionnelle en direct du Design JSX qui met à jour votre code à mesure que les calques changent ; l’élément situé sous le curseur met en évidence son calque sur la zone de travail, et les problèmes de design sont soulignés sur la propriété qui les cause.+- **Vérifier :** analyse de design en direct pour la page ou la sélection : contraste insuffisant, cibles tactiles trop petites, couleurs non liées, espacements hors échelle, avec des repères de problèmes sur la zone de travail et une liaison à une variable en un clic ([Checking Designs](/user-guide/checking-designs)).## Rendudiff --git a/packages/docs/fr/programmable/ai-chat.md b/packages/docs/fr/programmable/ai-chat.mdindex 824ec00fe..4f6aa7295 100644--- a/packages/docs/fr/programmable/ai-chat.md+++ b/packages/docs/fr/programmable/ai-chat.md@@ -29,7 +29,15 @@ Le jeton est conservé dans le stockage sécurisé des identifiants, pas dans le## Outils-Les outils couvrent lecture, création, modification, structure, variables, vecteurs, analyse, description, génération de code et images de stock. Chaque appel agit sur l’éditeur actif et participe à l’historique d’annulation lorsque cela s’applique.+Les outils couvrent lecture, création, modification, structure, variables, vecteurs, analyse, description, génération de code et images de stock. L’inspection comprend `get_jsx` pour la vue JSX aller-retour, `diff_create` et `diff_jsx` pour les différences structurelles, `diff_visual` pour les différences de pixels et `describe` pour le rôle sémantique et la détection des problèmes de design. Chaque appel agit sur l’éditeur actif et participe à l’historique d’annulation lorsque cela s’applique.++## Vérification visuelle++L’assistant peut vérifier visuellement son travail. Lorsque `export_image` est activé, il peut capturer une image après avoir créé ou modifié des designs et comparer le résultat à la demande initiale. Cela permet de repérer les problèmes de disposition, les éléments manquants et les écarts de couleur qu’une réponse purement textuelle laisserait passer. `diff_visual`, activé par défaut, compare un objet modifié à une copie de référence et renvoie les pixels et la zone modifiés ; l’assistant peut ainsi confirmer qu’une modification est restée dans sa cible.++## Conseils++- Vous pouvez consulter d’autres pages pendant qu’une réponse est générée : l’assistant continue de travailler sur la page où le message a été envoyé, et ses aperçus s’affichent à votre retour. Pendant votre absence, le chat indique la page sur laquelle il travaille, avec **Aller à la page** pour y revenir. Si l’assistant change lui-même de page, votre vue le suit.## Confidentialité et coûtdiff --git a/packages/docs/fr/programmable/cli/exporting.md b/packages/docs/fr/programmable/cli/exporting.mdindex ea8824d96..1e2779e54 100644--- a/packages/docs/fr/programmable/cli/exporting.md+++ b/packages/docs/fr/programmable/cli/exporting.md@@ -1,6 +1,6 @@---title: Exporter avec la CLI-description: Générer images, SVG, HTML et autres sorties sans ouvrir l’éditeur.+description: Générer images, SVG, HTML, stories Storybook et autres sorties sans ouvrir l’éditeur.---# Exporter avec la CLI@@ -27,6 +27,57 @@ SVG préserve la géométrie vectorielle et convient aux icônes, à la revue etL’exportation HTML crée un document autonome avec la structure et les styles disponibles. Elle vise la transmission, l’inspection et les traitements ultérieurs, pas le remplacement à l’identique du rendu CanvasKit. Elle n’est disponible qu’en mode fichier.+## JSX Tailwind++Exportez en JSX avec des classes utilitaires Tailwind :++```sh+openpencil export design.fig -f tailwind-jsx # or: -f jsx --style tailwind+```++## Export Storybook++Génère un fichier CSF3 `.stories.ts` par ensemble de composants ou par composant :++```sh+openpencil export design.fig -f storybook # React stories in ./design-stories/+openpencil export design.fig -f storybook --framework vue -o src/stories+openpencil export design.fig -f storybook --framework html --page "Components"+openpencil export design.pen -f storybook -o src/stories --watch # re-export on every save+openpencil export 'src/**/*.pen' -f storybook --beside --watch # stories next to each design+```++### Designs à côté de leurs stories++Gardez le fichier de design de chaque composant dans le dossier du composant et exportez avec `--beside` : les stories, les images de design et le manifeste `.openpencil-stories.json` de chaque document vont dans le dossier de ce document, à côté du code du composant. Un glob `stories` de Storybook tel que `../src/**/*.stories.ts` dans `.storybook/main.ts` les prend alors en compte sans autre configuration.++Passez plusieurs documents, ou un glob entre guillemets tel que `'src/**/*.pen'` que OpenPencil développe lui-même (Node.js 22 ou version ultérieure). Plusieurs documents nécessitent `--beside` ou `--output` ; `--page` ne fonctionne qu’avec un seul document. Les documents sont exportés l’un après l’autre, et lorsqu’un export échoue, les autres sont tout de même exportés avant que la commande ne se termine par une erreur. `--watch` surveille tous les documents correspondants ; un document créé après le début de la surveillance nécessite une nouvelle exécution.++Chaque variante d’un ensemble de composants devient une story, et ses propriétés de variante deviennent des contrôles `select` : changer un contrôle affiche la variante correspondante. Les composants autonomes dont le nom contient des barres obliques, comme `Button/Primary` et `Button/Secondary`, sont regroupés dans un seul fichier `Button` avec un contrôle `Variant`. Une combinaison pour laquelle le design n’a pas de variante déclenche dans Storybook une erreur nommée au lieu d’afficher une autre variante.++Les stories affichent le composant en HTML avec des styles en ligne, comme `-f html`, et n’ont donc besoin d’aucun runtime OpenPencil ; `--framework` (`react`, `vue` ou `html`) ne change que l’enveloppe et l’import de `Meta`/`StoryObj` depuis `@storybook/react-vite`, `@storybook/vue3-vite` ou `@storybook/html-vite`. Le texte utilise les familles de polices du document, que Storybook doit charger lui-même. Les propriétés de texte, booléennes et d’échange d’instance ne sont pas encore exportées.++Les stories comportent des entrées `parameters.design` pour [`@storybook/addon-designs`](https://github.com/storybookjs/addon-designs) :++- **OpenPencil :** lorsque le chemin du document se trouve dans le répertoire courant, un [lien `openpencil://`](../index#url-scheme) qui ouvre le document dans l’application de bureau et sélectionne la variante, ou son ensemble de composants lorsqu’un autre calque porte le même nom que la variante. Le schéma adresse les calques par nom : une story dont les noms de variante et de composant sont tous deux partagés par d’autres calques n’a donc pas de lien.+- **Design :** un PNG 2× de la variante, écrit dans `<Name>.design/` à côté de la story et référencé avec `new URL(…, import.meta.url)`, de sorte que Vite l’intègre. Copiez le paramètre sur la story de votre propre composant pour comparer l’implémentation au design. `--no-design-images` ignore le rendu ; la substitution de polices suit `--font-policy` comme pour l’export raster.++`-o` désigne le répertoire de sortie. Un manifeste `.openpencil-stories.json` y indique quel document, sous forme de chemin relatif au répertoire de sortie, et quelle page ont généré chaque story et chaque image de design ; versionnez-le avec les stories. Un export remplace les fichiers générés là par un export précédent du même document, y compris ceux de composants supprimés ou renommés depuis ; avec `--page`, seulement ceux de cette page. Il refuse, avant toute modification, d’écraser un autre fichier — une story écrite à la main, celle d’un autre document ou une image isolée. Un export d’une seule page dont les noms de fichiers se sont décalés sur les stories d’une autre page demande à la place un export complet. Sans le manifeste, les stories existantes sont considérées comme appartenant à quelqu’un d’autre : supprimez-les avant d’exporter de nouveau. `--watch` garde la commande active et réexporte à chaque enregistrement du document, afin que le rechargement à chaud de Storybook suive le design ; un enregistrement illisible est signalé et la surveillance continue. Un `--page` introuvable ou une substitution `--font-policy strict` met toujours fin à la commande.++## Mode application en direct++Omettez le fichier pour exporter depuis l’application en cours d’exécution :++```sh+openpencil export -f png # export the selection in the active document+openpencil export --page "Components" -f png # export every layer of a page+openpencil export --node 1:23 -f png # export one layer, on any page+```++`--page` prend un nom de page et `--page-id` un identifiant de page issu de `openpencil documents list` ; l’un comme l’autre exporte cette page sans y basculer l’application. Ajoutez `--document-id` pour exporter depuis un document autre que le document actif.++Le mode application en direct prend en charge PNG, JPG, WEBP, SVG et PDF. Les exports PowerPoint, JSX, HTML, Storybook et `.fig` nécessitent un fichier en argument. L’export de vignettes en mode fichier n’est pas pris en charge pour l’instant.+## Chemin de sortie`-o` ou `--output` définit le chemin. La CLI signale les erreurs de format, les objets introuvables et les chemins invalides au lieu de produire silencieusement un résultat incomplet.diff --git a/packages/docs/fr/programmable/cli/inspecting.md b/packages/docs/fr/programmable/cli/inspecting.mdindex 4907bb8e6..14b7b6761 100644--- a/packages/docs/fr/programmable/cli/inspecting.md+++ b/packages/docs/fr/programmable/cli/inspecting.md@@ -42,6 +42,31 @@ bun open-pencil find design.fig --type TEXT`formats` affiche les formats enregistrés et leurs capacités de lecture et d’écriture.+## Mode application en direct++Lorsque l’application de bureau est lancée, omettez le fichier : la CLI se connecte via RPC et agit sur la zone de travail active :++```sh+openpencil documents list # list open document/page IDs+openpencil tree # inspect the active live document+openpencil tree --document-id tab-123 --page-id 0:1+openpencil eval --document-id tab-123 --page-id 0:1 -c "..."+```++Dans les workflows d’agents, utilisez `openpencil documents list --json`, puis passez explicitement `--document-id` et `--page-id` au lieu de vous fier à l’onglet ou à la page visibles. Pour ouvrir, enregistrer, changer et fermer des documents, annuler, modifier les réglages ou appeler un outil de l’éditeur, consultez [Piloter l’application](/programmable/cli/app-control).++## Analyser la qualité du design++```sh+openpencil lint design.fig+openpencil lint design.pen --preset strict+openpencil lint design.fig --rule color-contrast+openpencil lint design.fig --list-rules+openpencil lint design.fig --fix -o fixed.fig+```++Utilisez `--json` pour une sortie exploitable par une machine ; chaque message porte ses `fix` et `suggestions` sous forme de données. `--fix` applique les corrections sûres — liaison des couleurs à la variable de couleur correspondante et arrondi de la géométrie au pixel entier — et écrit le résultat dans le fichier `.fig` indiqué avec `-o`.+## Sortie JSONLes commandes de consultation acceptent `--json`, adapté à `jq`, la CI et aux programmes qui nécessitent une sortie stable et exploitable par une machine.diff --git a/packages/docs/fr/programmable/collaboration.md b/packages/docs/fr/programmable/collaboration.mdindex 6ce262947..8554100e8 100644--- a/packages/docs/fr/programmable/collaboration.md+++ b/packages/docs/fr/programmable/collaboration.md@@ -16,7 +16,16 @@ Ouvrez le menu de collaboration, créez une salle et partagez le lien. L’ident- **Document :** formes, texte, propriétés et disposition ;- **Présence :** nom, couleur, sélection et page active ;- **Curseurs :** position de chaque participant ;-- **Vue :** possibilité de suivre le cadrage d’une autre personne.+- **Vue :** possibilité de suivre le cadrage d’une autre personne ;+- **Agents :** le chat AI intégré apparaît sous la forme d’un curseur sur les calques qu’il modifie, son étiquette cerclée affichant une étincelle et un nom de code tel que *Fern*. Le curseur et le contour ont la couleur de la personne qui l’utilise, ce qui permet de savoir à qui appartient l’agent. Seuls son nom, son type, son modèle, son état, sa page, sa position et les calques modifiés sont partagés, jamais les instructions ni les réponses.++## Mode suivi++Cliquez sur l’avatar d’une personne dans la barre supérieure pour suivre sa vue. Votre zone de travail se déplace et zoome comme la sienne, et un cadre de sa couleur avec une barre « Vous suivez … » indique qui vous suivez. Cliquez de nouveau sur l’avatar, appuyez sur <kbd>Esc</kbd>, ou cliquez, faites défiler, zoomez ou changez de page vous-même pour arrêter.++Un avatar compte les agents que cette personne utilise. Survolez-le pour voir chaque agent, ce qu’il fait et sur quelle page, puis cliquez sur **Suivre** à côté d’un agent pour garder à l’écran la page et les calques qu’il modifie ; le suivi se poursuit entre ses réponses et s’arrête quand il s’en va. Le bouton placé après les avatars énumère toutes les personnes de la salle avec leurs agents et fonctionne au clavier. Votre propre avatar énumère vos agents — cliquez sur l’un d’eux pour le renommer — et propose **Quitter la salle**.++Le panneau de partage énumère toutes les personnes de la salle avec les agents qu’elles utilisent, ce que fait chaque agent et sur quelle page. Suivez un agent de la même manière pour garder à l’écran la page et les calques qu’il modifie ; le suivi se poursuit entre ses réponses et s’arrête quand il s’en va. Double-cliquez sur l’un de vos agents pour le renommer.## Architecturediff --git a/packages/docs/fr/programmable/index.md b/packages/docs/fr/programmable/index.mdindex c9016cc74..06a22f7f2 100644--- a/packages/docs/fr/programmable/index.md+++ b/packages/docs/fr/programmable/index.md@@ -24,7 +24,9 @@ Claude Code, Cursor, Windsurf et d’autres clients MCP peuvent utiliser les mêLa CLI examine, exporte et analyse les fichiers `.fig` sans ouvrir l’éditeur. Elle peut lister pages et objets, rechercher du contenu, extraire des variables de design et générer des PNG. `--json` facilite l’intégration avec la CI.-[CLI →](./cli/inspecting)+La CLI se connecte aussi à l’application de bureau en cours d’exécution via RPC, ce qui permet de piloter l’éditeur par script pendant que vous l’utilisez : ouvrir, enregistrer et changer de document, annuler, modifier les réglages et appeler n’importe quel outil MCP.++[CLI →](./cli/inspecting) · [Piloter l’application](/programmable/cli/app-control)## JSX@@ -40,4 +42,28 @@ La commande `eval` exécute JavaScript avec un objet global `figma` compatible.[Scripting avec `eval` →](./cli/scripting)+## Schéma d’URL {#url-scheme}++L’application de bureau enregistre `openpencil://` : une page publiée — une story Storybook, une revue de design, un README — peut ainsi pointer directement vers un calque :++```+openpencil://open?file=web/design/hikyo.pen&node=Button/Large/Default+```++`file` est un chemin relatif au dépôt se terminant par `.pen` ou `.fig` ; les chemins absolus et les segments `.` ou `..` sont refusés. `node` est facultatif. Les deux valeurs sont encodées en URL — les séparateurs de chemin peuvent rester littéraux, mais un `+` littéral doit être envoyé sous la forme `%2B` — et une clé répétée prend sa dernière valeur.++L’application compare `file` aux chemins des onglets ouverts, comme une séquence complète de segments finaux, et active cet onglet sans relire le document ; un fichier déplacé ou devenu illisible depuis son ouverture voit donc tout de même son calque sélectionné. Le premier onglet ouvert dont le chemin se termine par le chemin demandé l’emporte, ce qui compte lorsque deux copies de travail ont le même fichier ouvert. Les segments sont comparés comme le fait le système de fichiers de la plateforme : sans tenir compte de la casse ASCII sous macOS et Windows, exactement sous Linux ; `Web/Design/hikyo.pen` et `web/design/hikyo.pen` désignent donc le même fichier sur un Mac et deux fichiers différents sous Linux. Si aucun onglet ouvert ne correspond, un sélecteur de fichier demande une seule fois le fichier ; le fichier choisi doit se terminer par le même chemin relatif, sinon le lien est annulé. Aucun chemin n’est joint à une racine et aucun accès au système de fichiers n’est accordé au-delà de ce que renvoie le sélecteur. Un fichier réellement ouvert par le lien — celui qui a été choisi — rejoint la liste des fichiers récents comme tout autre fichier que vous ouvrez ; activer un onglet déjà ouvert ne touche pas à la liste, car rien n’a été ouvert.++Avec un nom d’objet, l’application sélectionne tous les calques portant exactement ce nom sur la page courante et zoome sur l’ensemble de la sélection. Si la page courante n’en contient aucun, elle bascule sur la première page qui en contient, en chargeant les pages si nécessaire. Un nom inconnu affiche un avis et laisse le document ouvert. Ouvrir un fichier et sélectionner des calques est tout ce que le schéma sait faire.++L’application web accepte le même lien depuis sa propre barre d’adresse :++```+https://app.openpencil.dev/?file=https://raw.githubusercontent.com/open-pencil/open-pencil/master/tests/fixtures/pencil_button.pen&node=Button/Large/Default+```++Ici, `file` est une URL `https:` absolue se terminant par `.pen` ou `.fig` — l’application web n’a pas de système de fichiers ; un chemin relatif, une URL `http:` ou toute autre extension est donc refusé avec un avertissement dans la console, sans autre effet. `node` se comporte exactement comme ci-dessus. Le navigateur récupère le fichier d’une autre origine : l’hôte doit l’autoriser (`raw.githubusercontent.com` envoie `Access-Control-Allow-Origin: *` et convient). La requête n’envoie aucun identifiant et refuse de suivre les redirections ; une URL `https://github.com/<owner>/<repo>/raw/...` est donc refusée, et il faut pointer directement vers l’hôte brut. `file` et `node` sont retirés de la barre d’adresse dès leur lecture, de sorte qu’un rechargement ne rouvre pas le document. Un document lié est limité à 64 Mio. Un déploiement qui sert l’application avec une Content-Security-Policy doit autoriser l’hôte lié dans `connect-src`.++Sous macOS, le schéma appartient au bundle de l’application installée : les liens atteignent donc une version installée et non un processus `tauri dev`. Sous Windows et Linux, le lien arrive par le plugin de liens profonds, y compris lorsque l’application n’est pas encore lancée : il est mis en file d’attente au démarrage et traité dès que l’éditeur est prêt.+OpenPencil est sous licence MIT et conserve les documents localement. Les fichiers `.fig` peuvent être examinés, transformés, traités en CI ou fournis comme contexte à un modèle sans dépendre d’un hébergeur particulier.diff --git a/packages/docs/fr/programmable/jsx-renderer.md b/packages/docs/fr/programmable/jsx-renderer.mdindex fdd33a4be..76c84714d 100644--- a/packages/docs/fr/programmable/jsx-renderer.md+++ b/packages/docs/fr/programmable/jsx-renderer.md@@ -15,6 +15,10 @@ OpenPencil convertit du JSX déclaratif en arbre de design. Le même système es</Frame>```+## Créer des designs++L’outil `render` accepte des chaînes JSX dans le chat AI et MCP. Dans le code d’une application ou d’une bibliothèque sans interface, importez `Frame`, `Text` et les autres exports d’écriture depuis `@open-pencil/design-jsx`, puis créez les objets avec `renderTree` ou `renderJSX` depuis `@open-pencil/core/design-jsx`, qui ajoutent les icônes, la conversion SVG et la disposition. Pour écrire les arbres en TSX, définissez `"jsxImportSource": "@open-pencil/design-jsx"` avec `"jsx": "react-jsx"` dans `tsconfig.json`, ou ajoutez au fichier un commentaire `/** @jsxImportSource @open-pencil/design-jsx */`. L’environnement de script détermine les API exposées à `eval` ; les exports des paquets n’y sont pas automatiquement des variables globales.+## Éléments| JSX | Résultat |@@ -47,3 +51,5 @@ OpenPencil convertit du JSX déclaratif en arbre de design. Le même système es## Exporter vers JSX**Copier comme → JSX** convertit la sélection en JSX et classes Tailwind. La sortie tente de préserver hiérarchie, disposition, dimensions, couleurs, typographie et bordures comme point de départ d’une implémentation.++Le JSX OpenPencil exporté peut être modifié puis rendu de nouveau dans le document. L’export écrit les calques masqués et verrouillés, les contraintes, les limites de taille, les remplissages multiples, en dégradé et en image, les contours, les effets, les masques et les liaisons de variables : le rendu d’un export les reproduit, et `diff_jsx` montre les changements de chacun d’eux. Le texte riche à styles mixtes, les tracés vectoriels, les grilles de disposition, les styles partagés et les définitions de propriétés de composant ne sont pas encore écrits. Les instances sont écrites sous forme de cadres avec leur contenu, si bien que le JSX exporté se suffit à lui-même. Voir [Exports de la CLI](./cli/exporting).diff --git a/packages/docs/fr/programmable/sdk/api/composables/use-export.md b/packages/docs/fr/programmable/sdk/api/composables/use-export.mdindex d100ba8bd..006e5d82f 100644--- a/packages/docs/fr/programmable/sdk/api/composables/use-export.md+++ b/packages/docs/fr/programmable/sdk/api/composables/use-export.md@@ -7,6 +7,8 @@ description: Gérer l’échelle et le format d’exportation de la sélection a`useExport()` fournit l’état et les actions d’un panneau d’exportation : sélection et réglages, format, échelle, suffixe, aperçu, création et modification des réglages, puis exécution.+Il expose aussi les échelles et formats pris en charge : `formats` (identifiants) et `formatOptions` (options avec libellé). Par exemple, `exportState.updateFormat(0, 'webp')`.+Utilisez-le pour construire une interface propre au-dessus du système d’exportation de l’éditeur.## Voir aussidiff --git a/packages/docs/fr/user-guide/canvas-navigation.md b/packages/docs/fr/user-guide/canvas-navigation.mdindex 03d0d5b43..3fb240a82 100644--- a/packages/docs/fr/user-guide/canvas-navigation.md+++ b/packages/docs/fr/user-guide/canvas-navigation.md@@ -26,3 +26,9 @@ Le zoom est centré sur le pointeur. Utilisez <kbd>Ctrl</kbd>/<kbd>⌘</kbd> + m| 100 % | <kbd>⌘</kbd><kbd>0</kbd> | <kbd>Ctrl</kbd><kbd>0</kbd> || Ajuster le document | <kbd>⌘</kbd><kbd>1</kbd> | <kbd>Ctrl</kbd><kbd>1</kbd> || Zoomer sur la sélection | <kbd>⌘</kbd><kbd>2</kbd> | <kbd>Ctrl</kbd><kbd>2</kbd> |++## Palette de commandes++Appuyez sur <kbd>⌘</kbd><kbd>K</kbd> sous macOS ou <kbd>Ctrl</kbd><kbd>K</kbd> sous Windows/Linux pour rechercher des actions de l’éditeur et de l’application. Sélectionnez un résultat pour l’exécuter ; les actions indisponibles restent soumises à la sélection et à l’état du document.++La palette permet aussi de changer de page. Avant que vous ne tapiez, elle liste les pages visitées récemment dans cet onglet, de la plus récente à la plus ancienne, et **Aller à la page…** ouvre la liste de toutes les pages. Saisir le nom d’une page permet aussi de la trouver. Les pages où des collaborateurs ou des agents AI travaillent affichent leurs noms ; le panneau Pages marque les mêmes pages avec leurs couleurs.diff --git a/packages/docs/fr/user-guide/index.md b/packages/docs/fr/user-guide/index.mdindex 2b05c1dce..0dc004fe6 100644--- a/packages/docs/fr/user-guide/index.md+++ b/packages/docs/fr/user-guide/index.md@@ -30,4 +30,5 @@ OpenPencil est un éditeur de design local et open source, compatible avec Figma- [Disposition automatique](./auto-layout) — distribution avec Flexbox et CSS Grid ;- [Composants](./components) — composants réutilisables, instances et surcharges ;-- [Variables](./variables) — collections, modes, valeurs et liaisons.+- [Variables](./variables) — collections, modes, valeurs et liaisons ;+- [Checking Designs](/user-guide/checking-designs) — panneau Check, repères de problèmes sur la zone de travail et règles de lint.diff --git a/packages/docs/it/getting-started.md b/packages/docs/it/getting-started.mdindex 6c8079a02..f4c94c9d2 100644--- a/packages/docs/it/getting-started.md+++ b/packages/docs/it/getting-started.md@@ -18,6 +18,18 @@ Le versioni pronte per macOS, Windows e Linux sono disponibili nella [pagina del| Windows (ARM) | `.msi` / `.exe` || Linux (x64) | `.AppImage` / `.deb` |+## Requisiti di sistema++OpenPencil esegue il rendering con CanvasKit su WebGL e usa funzionalità recenti della piattaforma web, quindi richiede un motore del browser aggiornato. L’app web supporta Chrome 111, Edge 111, Firefox 128 e Safari 16.4 o versioni successive; i browser basati su Chromium, come Brave e Opera, seguono la versione di Chrome. L’app desktop usa il WebView di sistema, quindi il requisito minimo dipende dal motore del sistema operativo:++| Piattaforma | Requisito |+| ----------- | --------- |+| macOS | macOS 13 Ventura o successivo con gli aggiornamenti correnti di Safari installati (Safari 16.4 è incluso in macOS 13.3). |+| Windows | Windows 10 o successivo con il runtime Evergreen di Microsoft Edge WebView2, che si aggiorna da solo. |+| Linux | WebKitGTK 2.40 o successivo (`webkit2gtk-4.1`). |++Se il motore è troppo vecchio, OpenPencil mostra cosa aggiornare invece di una finestra vuota. Se vedi questo avviso su un sistema che soddisfa i requisiti, usa il link «Report a problem», che precompila i dettagli di browser e motore.+## Installazione in macOS con Homebrew```shdiff --git a/packages/docs/it/overview/features.md b/packages/docs/it/overview/features.mdindex 08826942c..3894fbfd1 100644--- a/packages/docs/it/overview/features.md+++ b/packages/docs/it/overview/features.md@@ -19,7 +19,7 @@ OpenPencil apre e salva direttamente i file `.fig`. Import ed export usano lo st## Pannello Proprietà-Le schede Design, Code e AI cambiano in base alla selezione.+Le schede Design, Codice, AI e Verifica cambiano in base alla selezione.- **Aspetto:** opacità, raggio comune o per angolo e visibilità.- **Riempimento:** colore solido, gradienti lineare, radiale, angolare e diamante, immagini.@@ -28,6 +28,8 @@ Le schede Design, Code e AI cambiano in base alla selezione.- **Tipografia:** scelta del font con ricerca e scorrimento virtuale, stile, dimensione, allineamento e formattazione.- **Layout:** impostazioni della disposizione automatica.- **Export:** scala, PNG/JPG/WEBP/SVG e anteprima.+- **Codice:** Design JSX e Tailwind JSX per la selezione, con modifica bidirezionale in tempo reale del Design JSX che aggiorna il codice al variare dei livelli; l’elemento sotto il cursore evidenzia il proprio livello nell’area di lavoro e i problemi di design sono sottolineati sulla proprietà che li causa.+- **Verifica:** controllo di design in tempo reale per la pagina o la selezione (contrasto basso, aree di tocco piccole, colori non collegati, spaziature fuori scala), con indicatori dei problemi nell’area di lavoro e collegamento alle variabili con un clic ([Controllare i design](/user-guide/checking-designs)).## Renderingdiff --git a/packages/docs/it/programmable/ai-chat.md b/packages/docs/it/programmable/ai-chat.mdindex 2234b13bc..d211984a5 100644--- a/packages/docs/it/programmable/ai-chat.md+++ b/packages/docs/it/programmable/ai-chat.md@@ -31,6 +31,16 @@ Il token è conservato nell’archivio sicuro delle credenziali, non nelle normaGli strumenti coprono lettura, creazione, modifica, struttura, variabili, vettori, analisi, descrizione, generazione di codice e immagini stock. Ogni chiamata agisce sull’editor attivo e partecipa alla cronologia quando applicabile.+Per l’ispezione, `get_jsx` offre la vista JSX di andata e ritorno, `diff_create` e `diff_jsx` i confronti strutturali, `diff_visual` i confronti pixel per pixel e `describe` il ruolo semantico e il rilevamento dei problemi di design.++## Verifica visiva++L’assistente può verificare visivamente il proprio lavoro. Con `export_image` abilitato, cattura un’immagine dopo aver creato o modificato un design e controlla il risultato rispetto alla richiesta, individuando problemi di disposizione, elementi mancanti e colori sbagliati che una risposta solo testuale non rileverebbe. `diff_visual`, abilitato per impostazione predefinita, confronta un oggetto modificato con una copia di riferimento e restituisce i pixel e l’area cambiati, così l’assistente può confermare che la modifica sia rimasta nel bersaglio previsto.++## Lavorare su altre pagine++Mentre una risposta è in corso puoi esplorare altre pagine: l’assistente continua a lavorare sulla pagina in cui è partito il messaggio e le sue anteprime compaiono al tuo ritorno. Quando non sei su quella pagina, la chat indica su quale sta lavorando, con **Vai alla pagina** per tornarci. Se è l’assistente a cambiare pagina, la tua vista lo segue.+## Privacy e costiLe richieste vanno al provider configurato. Verifica condizioni, politica dei dati e prezzi prima di inviare documenti sensibili. OpenPencil non include crediti per i modelli.diff --git a/packages/docs/it/programmable/cli/exporting.md b/packages/docs/it/programmable/cli/exporting.mdindex 6e44ae93a..c0ca89d93 100644--- a/packages/docs/it/programmable/cli/exporting.md+++ b/packages/docs/it/programmable/cli/exporting.md@@ -1,6 +1,6 @@---title: Esportare dalla CLI-description: Generare immagini, SVG, HTML e altri output senza aprire l’editor.+description: Generare immagini, SVG, HTML, storie Storybook e altri output senza aprire l’editor.---# Esportare dalla CLI@@ -25,6 +25,57 @@ SVG conserva la geometria vettoriale ed è adatto a icone, revisione e modificheL’esportazione HTML crea un documento autonomo con struttura e stili disponibili. È pensata per consegna, ispezione ed elaborazioni successive, non come sostituto identico del rendering CanvasKit. È disponibile solo lavorando su file.+## Tailwind JSX++Per esportare JSX con classi di utilità Tailwind:++```sh+openpencil export design.fig -f tailwind-jsx # oppure: -f jsx --style tailwind+```++## Esportazione Storybook++Il formato `-f storybook` genera un file CSF3 `.stories.ts` per ogni set di componenti o componente:++```sh+openpencil export design.fig -f storybook # storie React in ./design-stories/+openpencil export design.fig -f storybook --framework vue -o src/stories+openpencil export design.fig -f storybook --framework html --page "Components"+openpencil export design.pen -f storybook -o src/stories --watch # riesporta a ogni salvataggio+openpencil export 'src/**/*.pen' -f storybook --beside --watch # storie accanto a ogni design+```++### Design accanto alle storie++Tieni il file di design di ogni componente nella cartella del componente ed esporta con `--beside`: storie, immagini del design e manifest `.openpencil-stories.json` di ciascun documento finiscono nella cartella del documento stesso, accanto al codice del componente. Un glob `stories` di Storybook come `../src/**/*.stories.ts` in `.storybook/main.ts` le raccoglie senza altra configurazione.++Puoi passare più documenti, oppure un glob tra apici come `'src/**/*.pen'` che OpenPencil espande da solo (Node.js 22 o successivo). Più documenti richiedono `--beside` oppure `--output`; `--page` funziona solo con un documento. I documenti vengono esportati uno dopo l’altro e, se uno fallisce, gli altri vengono comunque esportati prima che il comando termini con un errore. `--watch` osserva tutti i documenti trovati; un documento creato dopo l’avvio dell’osservazione richiede una nuova esecuzione.++Ogni variante di un set di componenti diventa una storia e le sue proprietà di variante diventano controlli `select`, quindi cambiando un controllo si vede la variante corrispondente. I componenti singoli con nomi separati da barre, come `Button/Primary` e `Button/Secondary`, sono raggruppati in un unico file `Button` con un controllo `Variant`. Una combinazione per cui il design non ha una variante genera in Storybook un errore con nome invece di mostrare un’altra variante.++Le storie renderizzano il componente come HTML con stili inline, come `-f html`, quindi non richiedono il runtime di OpenPencil; `--framework` (`react`, `vue` o `html`) cambia solo il wrapper e l’import di `Meta`/`StoryObj` da `@storybook/react-vite`, `@storybook/vue3-vite` o `@storybook/html-vite`. Il testo usa le famiglie di font del documento, che Storybook deve caricare per conto proprio. Le proprietà di testo, booleane e di sostituzione dell’istanza non vengono ancora esportate.++Le storie includono voci `parameters.design` per [`@storybook/addon-designs`](https://github.com/storybookjs/addon-designs):++- **OpenPencil:** quando il percorso del documento è dentro la cartella corrente, un [link `openpencil://`](../index#url-scheme) che apre il documento nell’app desktop e seleziona la variante, o il suo set di componenti se un altro livello ha lo stesso nome della variante. Lo schema indirizza i livelli per nome, quindi una storia i cui nomi di variante e di componente sono entrambi condivisi con altri livelli non ottiene alcun link.+- **Design:** un PNG 2× della variante, scritto in `<Name>.design/` accanto alla storia e referenziato con `new URL(…, import.meta.url)`, così Vite lo include nel bundle. Copia il parametro sulla storia del tuo componente per confrontare l’implementazione con il design. `--no-design-images` salta il rendering; la sostituzione dei font segue `--font-policy` come nell’esportazione raster.++`-o` indica la cartella di output. Un manifest `.openpencil-stories.json` registra, con un percorso relativo alla cartella di output, quale documento e quale pagina hanno generato ogni storia e immagine; includilo nel commit insieme alle storie. Un’esportazione sostituisce i file generati da una precedente esportazione dello stesso documento, compresi quelli di componenti nel frattempo eliminati o rinominati; con `--page`, solo quelli di quella pagina. Prima di modificare qualsiasi cosa, rifiuta di sovrascrivere qualunque altro file: una storia scritta a mano, quella di un altro documento o un’immagine estranea. Un’esportazione di una sola pagina i cui nomi di file sono slittati su storie di un’altra pagina richiede invece un’esportazione completa. Senza il manifest, le storie esistenti sono considerate di qualcun altro, quindi rimuovile prima di esportare di nuovo. `--watch` mantiene il comando in esecuzione e riesporta a ogni salvataggio del documento, così l’hot reload di Storybook segue il design; un salvataggio che non può essere letto viene segnalato e l’osservazione continua. Una `--page` mancante o una sostituzione con `--font-policy strict` terminano comunque il comando.++## Modalità app in esecuzione++Ometti il file per esportare dall’app in esecuzione:++```sh+openpencil export -f png # esporta la selezione del documento attivo+openpencil export --page "Components" -f png # esporta ogni livello di una pagina+openpencil export --node 1:23 -f png # esporta un livello, in qualsiasi pagina+```++`--page` accetta il nome di una pagina e `--page-id` l’ID di una pagina da `openpencil documents list`; entrambi esportano quella pagina senza portare l’app su di essa. Aggiungi `--document-id` per esportare da un documento diverso da quello attivo.++La modalità app supporta PNG, JPG, WEBP, SVG e PDF. Le esportazioni PowerPoint, JSX, HTML, Storybook e `.fig` richiedono un file. L’esportazione di miniature in modalità file non è attualmente supportata.+## Percorso di output`-o` o `--output` definisce il percorso. La CLI segnala formati errati, oggetti mancanti e percorsi non validi invece di produrre risultati parziali in silenzio.diff --git a/packages/docs/it/programmable/cli/inspecting.md b/packages/docs/it/programmable/cli/inspecting.mdindex 2eeabae34..1fc01a6f8 100644--- a/packages/docs/it/programmable/cli/inspecting.md+++ b/packages/docs/it/programmable/cli/inspecting.md@@ -33,6 +33,30 @@ bun open-pencil tree design.fig`variables` elenca raccolte, modalità, tipi e valori. `formats` mostra i formati registrati e le capacità di lettura e scrittura.+## Modalità app in esecuzione++Con l’app desktop in esecuzione, ometti il file: la CLI si collega tramite RPC.++```sh+openpencil documents list # elenca gli ID di documenti e pagine aperti+openpencil tree # esamina il documento attivo+openpencil tree --document-id tab-123 --page-id 0:1+openpencil eval --document-id tab-123 --page-id 0:1 -c "..."+```++Nei flussi di lavoro con agenti usa `openpencil documents list --json`, poi passa esplicitamente `--document-id` e `--page-id` invece di affidarti alla scheda o pagina attiva. Per aprire, salvare, cambiare e chiudere documenti, annullare, modificare le impostazioni o chiamare qualsiasi strumento dell’editor, vedi [Controllare l’app](/programmable/cli/app-control).++## Lint dei design++```sh+openpencil lint design.fig --preset strict+openpencil lint design.fig --rule color-contrast+openpencil lint design.fig --list-rules+openpencil lint design.fig --fix -o fixed.fig+```++Usa `--json` per un output leggibile dalle macchine; ogni messaggio include `fix` e `suggestions` come dati. `--fix` applica le correzioni sicure (collega i colori alla variabile di colore corrispondente e arrotonda la geometria a pixel interi) e scrive il risultato nel file `.fig` indicato con `-o`.+## Output JSONI comandi di consultazione supportano `--json`, adatto a `jq`, CI e programmi che richiedono un output stabile e leggibile dalle macchine.diff --git a/packages/docs/it/programmable/collaboration.md b/packages/docs/it/programmable/collaboration.mdindex 6883a84ad..e56e31eac 100644--- a/packages/docs/it/programmable/collaboration.md+++ b/packages/docs/it/programmable/collaboration.md@@ -16,7 +16,16 @@ Apri il menu di collaborazione, crea una stanza e condividi il link. L’identif- **Documento:** forme, testo, proprietà e disposizione;- **Presenza:** nome, colore, selezione e pagina attiva;- **Cursori:** posizione di ogni partecipante;-- **Vista:** possibilità di seguire l’inquadratura di un’altra persona.+- **Vista:** possibilità di seguire l’inquadratura di un’altra persona;+- **Agenti:** la chat AI integrata compare come cursore sui livelli che sta modificando, con un’etichetta contornata che mostra una scintilla e un nome in codice come *Fern*. Cursore e contorno hanno il colore di chi lo esegue, così si capisce a chi appartiene l’agente. Vengono condivisi solo nome, tipo, modello, stato, pagina, posizione e livelli modificati, mai richieste o risposte.++## Modalità di seguito++Fai clic sull’avatar di un partecipante nella barra superiore per seguire la sua inquadratura. L’area di lavoro si sposta e cambia zoom come la sua vista, e una cornice del suo colore con una barra «Stai seguendo …» indica chi stai seguendo. Per smettere, fai di nuovo clic sull’avatar, premi <kbd>Esc</kbd> oppure fai clic, scorri, cambia zoom o pagina.++Un avatar conta gli agenti eseguiti da quella persona. Passaci sopra il puntatore per vedere ogni agente, cosa sta facendo e su quale pagina, e fai clic su **Segui** accanto a un agente per tenere in vista la pagina e i livelli che sta modificando; il seguito continua tra una risposta e l’altra e termina quando l’agente se ne va. Il pulsante dopo gli avatar elenca tutti i presenti nella stanza con i rispettivi agenti e funziona anche da tastiera. Il tuo avatar elenca i tuoi agenti (fai clic su uno per rinominarlo) e contiene **Esci dalla stanza**.++Il pannello di condivisione elenca tutti i presenti nella stanza con gli agenti che eseguono, cosa fa ciascun agente e su quale pagina. Segui un agente allo stesso modo per tenere in vista la pagina e i livelli che sta modificando. Fai doppio clic su un tuo agente per rinominarlo.## Architetturadiff --git a/packages/docs/it/programmable/index.md b/packages/docs/it/programmable/index.mdindex cda8474fd..a74491ac6 100644--- a/packages/docs/it/programmable/index.md+++ b/packages/docs/it/programmable/index.md@@ -24,6 +24,8 @@ Claude Code, Cursor, Windsurf e altri client MCP possono usare gli stessi strumeLa CLI esamina, esporta e analizza file `.fig` senza aprire l’editor. Può elencare pagine e oggetti, cercare contenuti, estrarre variabili di design e generare PNG. `--json` facilita l’integrazione con CI.+La CLI si collega anche all’app desktop in esecuzione tramite RPC, quindi puoi automatizzare l’editor mentre lo usi: aprire, salvare e cambiare documento, annullare, modificare le impostazioni e chiamare qualsiasi strumento MCP ([Controllare l’app](/programmable/cli/app-control)).+[CLI →](./cli/inspecting)## JSX@@ -40,4 +42,16 @@ Il comando `eval` esegue JavaScript con un oggetto globale `figma` compatibile.[Scripting con `eval` →](./cli/scripting)+## Schema URL {#url-scheme}++L’app desktop registra `openpencil://`, quindi una pagina pubblicata (una storia Storybook, una revisione del design, un README) può rimandare direttamente a un livello:++```+openpencil://open?file=web/design/hikyo.pen&node=Button/Large/Default+```++`file` è un percorso relativo al repository che termina con `.pen` o `.fig`; percorsi assoluti e segmenti `.` o `..` vengono rifiutati. `node` è facoltativo. L’app cerca `file` tra i percorsi delle schede aperte e, se non ne trova, chiede il file con un selettore.++Con un nome di nodo, l’app seleziona ogni livello con quel nome esatto nella pagina corrente e adatta la vista all’intera selezione. Se la pagina corrente non ne contiene, passa alla prima pagina che ne ha, caricando le pagine se necessario. Un nome sconosciuto mostra un avviso e lascia aperto il documento.+OpenPencil ha licenza MIT e conserva i documenti localmente. I file `.fig` possono essere esaminati, trasformati, elaborati in CI o forniti come contesto a un modello senza dipendere da uno specifico servizio di hosting.diff --git a/packages/docs/it/programmable/jsx-renderer.md b/packages/docs/it/programmable/jsx-renderer.mdindex 02d3c4daf..d6f513164 100644--- a/packages/docs/it/programmable/jsx-renderer.md+++ b/packages/docs/it/programmable/jsx-renderer.md@@ -14,6 +14,8 @@ OpenPencil converte JSX dichiarativo in un albero di design. Lo stesso sistema</Frame>```+Nel codice dell’applicazione o nelle librerie headless, importa `Frame`, `Text` e gli altri export di scrittura da `@open-pencil/design-jsx`, poi crea i nodi con `renderTree` o `renderJSX` da `@open-pencil/core/design-jsx`, che aggiungono icone, conversione SVG e disposizione. Per scrivere gli alberi come TSX, imposta `"jsxImportSource": "@open-pencil/design-jsx"` con `"jsx": "react-jsx"` in `tsconfig.json`, oppure aggiungi al file il commento `/** @jsxImportSource @open-pencil/design-jsx */`. L’ambiente di scripting determina quali API sono esposte a `eval`: gli export dei pacchetti non diventano automaticamente globali.+## Elementi`Frame`, `Text`, `Rectangle`, `Ellipse` e `Image` creano i rispettivi oggetti. I componenti registrati possono generare alberi riutilizzabili definiti dall’applicazione.@@ -34,3 +36,5 @@ Le proprietà tipografiche come `size`, `font`, `weight`, `lineHeight` e `letter## Esportare in JSX**Copia come → JSX** converte la selezione in JSX e classi Tailwind. L’output prova a conservare gerarchia, disposizione, dimensioni, colori, tipografia e bordi come punto di partenza per l’implementazione.++Il JSX esportato può essere modificato e renderizzato di nuovo nel documento. L’esportazione scrive livelli nascosti e bloccati, vincoli, limiti di dimensione, riempimenti multipli, sfumati e immagine, contorni, effetti, maschere e collegamenti alle variabili, quindi renderizzare un export li riproduce e `diff_jsx` mostra le modifiche a ciascuno di essi. Testo formattato con stili misti, tracciati vettoriali, griglie di layout, stili condivisi e definizioni delle proprietà dei componenti non vengono ancora scritti. Le istanze sono scritte come frame con il loro contenuto, così il JSX esportato è autonomo. Vedi [esportazioni dalla CLI](./cli/exporting).diff --git a/packages/docs/it/programmable/sdk/api/composables/use-export.md b/packages/docs/it/programmable/sdk/api/composables/use-export.mdindex 1f71ac59e..95c350a79 100644--- a/packages/docs/it/programmable/sdk/api/composables/use-export.md+++ b/packages/docs/it/programmable/sdk/api/composables/use-export.md@@ -7,6 +7,30 @@ description: Gestire scala e formato di esportazione della selezione corrente.`useExport()` fornisce stato e azioni per impostazioni, oggetti selezionati, nome del file, scale, formati e anteprima, oltre all’esecuzione dell’esportazione.+Gestisce anche scale e formati supportati: gli ID in `formats` e le voci con etichetta in `formatOptions`.++## Esempi++```ts+const {+ settings,+ nodeName,+ scales,+ formats,+ formatOptions,+ addSetting,+ updateScale,+ updateFormat,+} = useExport()+```++Per portare la prima esportazione a 2× in WEBP:++```ts+exportState.updateScale(0, 2)+exportState.updateFormat(0, 'webp')+```+## Vedi anche- [Guida all’esportazione](/user-guide/exporting)diff --git a/packages/docs/it/user-guide/canvas-navigation.md b/packages/docs/it/user-guide/canvas-navigation.mdindex 6e13ea71e..1dbaf4438 100644--- a/packages/docs/it/user-guide/canvas-navigation.md+++ b/packages/docs/it/user-guide/canvas-navigation.md@@ -26,3 +26,9 @@ Lo zoom è centrato sul puntatore. Usa <kbd>Ctrl</kbd>/<kbd>⌘</kbd> + rotella,| 100% | <kbd>⌘</kbd><kbd>0</kbd> | <kbd>Ctrl</kbd><kbd>0</kbd> || Adatta documento | <kbd>⌘</kbd><kbd>1</kbd> | <kbd>Ctrl</kbd><kbd>1</kbd> || Inquadra selezione | <kbd>⌘</kbd><kbd>2</kbd> | <kbd>Ctrl</kbd><kbd>2</kbd> |++## Palette dei comandi++Premi <kbd>⌘</kbd><kbd>K</kbd> su macOS o <kbd>Ctrl</kbd> + <kbd>K</kbd> su Windows/Linux per cercare azioni dell’editor e dell’applicazione. Seleziona un risultato per eseguirlo; le azioni non disponibili restano soggette alla selezione e allo stato del documento.++La palette permette anche di passare da una pagina all’altra. Prima che tu scriva, elenca le pagine visitate di recente in questa scheda, dalla più recente, e **Vai alla pagina…** apre l’elenco di tutte le pagine. Anche digitare il nome di una pagina la trova. Le pagine in cui lavorano collaboratori o agenti AI ne riportano i nomi; il pannello Pagine le contrassegna con gli stessi colori.diff --git a/packages/docs/it/user-guide/index.md b/packages/docs/it/user-guide/index.mdindex d0f137917..319de8e77 100644--- a/packages/docs/it/user-guide/index.md+++ b/packages/docs/it/user-guide/index.md@@ -30,4 +30,5 @@ OpenPencil è un editor di design locale e open source, compatibile con Figma, c- [Disposizione automatica](./auto-layout) — distribuzione con Flexbox e CSS Grid;- [Componenti](./components) — componenti riutilizzabili, istanze e sostituzioni;-- [Variabili](./variables) — raccolte, modalità, valori e collegamenti.+- [Variabili](./variables) — raccolte, modalità, valori e collegamenti;+- [Controllare i design](/user-guide/checking-designs) — pannello Verifica, indicatori dei problemi nell’area di lavoro e regole di lint.diff --git a/packages/docs/pl/getting-started.md b/packages/docs/pl/getting-started.mdindex 1afc1ccc2..872c21756 100644--- a/packages/docs/pl/getting-started.md+++ b/packages/docs/pl/getting-started.md@@ -18,6 +18,18 @@ Gotowe wersje dla macOS, Windows i Linux są dostępne na [stronie wydań](https| Windows (ARM) | `.msi` / `.exe` || Linux (x64) | `.AppImage` / `.deb` |+## Wymagania systemowe++OpenPencil renderuje przez CanvasKit na WebGL i korzysta z nowoczesnych funkcji platformy webowej, dlatego wymaga aktualnego silnika przeglądarki. Wersja internetowa działa w Chrome 111, Edge 111, Firefox 128 i Safari 16.4 lub nowszych; przeglądarki oparte na Chromium, takie jak Brave i Opera, odpowiadają wersji Chrome, na której bazują. Aplikacja na komputer renderuje w systemowym WebView, więc jej minimum wyznacza silnik systemu operacyjnego:++| Platforma | Wymaganie |+| --------- | --------- |+| macOS | macOS 13 Ventura lub nowszy z zainstalowanymi bieżącymi aktualizacjami Safari (Safari 16.4 trafiło do systemu w macOS 13.3). |+| Windows | Windows 10 lub nowszy z środowiskiem Microsoft Edge WebView2 Evergreen, które aktualizuje się samo. |+| Linux | WebKitGTK 2.40 lub nowszy (`webkit2gtk-4.1`). |++Gdy silnik jest zbyt stary, OpenPencil zamiast pustego okna pokazuje, co należy zaktualizować. Jeśli widzisz to powiadomienie w systemie spełniającym wymagania, użyj odnośnika „Report a problem”, który uzupełnia dane przeglądarki i silnika.+## Instalacja w macOS przez Homebrew```shdiff --git a/packages/docs/pl/overview/features.md b/packages/docs/pl/overview/features.mdindex 9d98c3347..341d0fe9f 100644--- a/packages/docs/pl/overview/features.md+++ b/packages/docs/pl/overview/features.md@@ -19,7 +19,7 @@ OpenPencil otwiera i zapisuje pliki `.fig` bez wcześniejszej konwersji. Import## Panel właściwości-Zawartość kart „Projekt”, „Kod” i „AI” zależy od zaznaczenia.+Zawartość kart „Design”, „Kod”, „AI” i „Sprawdź” zależy od zaznaczenia.- **Wygląd:** przezroczystość, wspólny lub osobny promień narożników i widoczność.- **Zalew:** kolor jednolity, gradient liniowy, radialny, kątowy lub diamentowy oraz obraz.@@ -28,6 +28,8 @@ Zawartość kart „Projekt”, „Kod” i „AI” zależy od zaznaczenia.- **Typografia:** wybór czcionki z wyszukiwaniem i wirtualnym przewijaniem, odmiana, rozmiar, wyrównanie i formatowanie.- **Układ:** ustawienia automatycznego układu.- **Eksport:** skala, format PNG/JPG/WEBP/SVG i podgląd.+- **Kod:** Design JSX i Tailwind JSX dla zaznaczenia; dwukierunkowa edycja Design JSX na żywo aktualizuje kod wraz ze zmianami warstw. Element pod kursorem obrysowuje swoją warstwę na obszarze roboczym, a problemy projektowe są podkreślone przy właściwości, która je powoduje.+- **Sprawdź:** lint projektu na żywo dla strony lub zaznaczenia: niski kontrast, małe obszary dotykowe, niepowiązane kolory, odstępy spoza skali. Znaczniki problemów widać na obszarze roboczym, a zmienną można powiązać jednym kliknięciem ([Checking Designs](/user-guide/checking-designs)).## Renderowaniediff --git a/packages/docs/pl/programmable/ai-chat.md b/packages/docs/pl/programmable/ai-chat.mdindex bc4f18592..87a4d0405 100644--- a/packages/docs/pl/programmable/ai-chat.md+++ b/packages/docs/pl/programmable/ai-chat.md@@ -41,16 +41,17 @@ Zdalny serwer musi używać HTTPS. W lokalnym środowisku programistycznym dozwo## Możliwości-Asystent korzysta z ponad 90 narzędzi do tworzenia, stylizowania, układu, komponentów, zmiennych, wyszukiwania, inspekcji, analizy, eksportu i operacji wektorowych.+Asystent korzysta z ponad 90 narzędzi do tworzenia, stylizowania, układu, komponentów, zmiennych, wyszukiwania, inspekcji, analizy, eksportu i operacji wektorowych. Do inspekcji należą `get_jsx` (widok JSX w obie strony), `diff_create` i `diff_jsx` (różnice strukturalne), `diff_visual` (różnice pikseli) oraz `describe` (rola semantyczna i wykrywanie problemów projektowych).## Kontrola wizualna-Po utworzeniu lub zmianie projektu asystent może wywołać `export_image`, uzyskać obraz wyniku i porównać go z pierwotnym poleceniem. Pozwala to wykryć problemy z układem, brakujące elementy i nieprawidłowe kolory.+Po utworzeniu lub zmianie projektu asystent może wywołać `export_image`, uzyskać obraz wyniku i porównać go z pierwotnym poleceniem. Pozwala to wykryć problemy z układem, brakujące elementy i nieprawidłowe kolory. Domyślnie włączone `diff_visual` porównuje zmieniony obiekt z kopią wzorcową i zwraca zmienione piksele oraz obszar, dzięki czemu asystent może sprawdzić, że zmiana nie wyszła poza cel.## Wskazówki- Przed wysłaniem polecenia zaznacz odpowiednie obiekty: asystent widzi zaznaczenie.- Dokładnie podawaj kolory, rozmiary i położenie.- Jedna wiadomość może zmienić kilka obiektów.+- Podczas odpowiedzi możesz przeglądać inne strony: asystent dalej pracuje na stronie, na której zaczęła się wiadomość, a jego podglądy pojawią się po powrocie. Gdy jesteś na innej stronie, czat pokazuje, nad którą pracuje asystent, i udostępnia przycisk **Przejdź do strony**. Jeśli asystent sam zmieni stronę, widok podąża za nim.- Wszystkie zmiany AI można cofnąć.- Po każdym wywołaniu narzędzia układ jest przeliczany automatycznie.diff --git a/packages/docs/pl/programmable/cli/exporting.md b/packages/docs/pl/programmable/cli/exporting.mdindex c0f34ee4c..230022f5c 100644--- a/packages/docs/pl/programmable/cli/exporting.md+++ b/packages/docs/pl/programmable/cli/exporting.md@@ -1,11 +1,11 @@---title: Eksport-description: Eksport zawartości dokumentu do PNG, JPG, WEBP, SVG, .fig, JSX lub HTML i konwersja między formatami.+description: Eksport zawartości dokumentu do PNG, JPG, WEBP, SVG, .fig, JSX, HTML lub historyjek Storybook i konwersja między formatami.---# Eksport-CLI eksportuje projekt do raster images, vector graphics, osobnych dokumentów `.fig`, JSX albo HTML.+CLI eksportuje projekt do raster images, vector graphics, osobnych dokumentów `.fig`, JSX, HTML albo historyjek Storybook.## Obrazy i .fig@@ -21,7 +21,7 @@ openpencil export design.fig -f html --css tailwind # Fragment HTML z klasamiOpcje:-- `-f` — format: `png`, `jpg`, `webp`, `svg`, `jsx`, `html` albo `fig`;+- `-f` — format: `png`, `jpg`, `webp`, `svg`, `jsx`, `html`, `fig` albo `storybook`;- `-s` — skala od `1` do `4`;- `-q` — jakość od `0` do `100`, tylko dla JPG i WEBP;- `-o` — ścieżka pliku wynikowego;@@ -33,7 +33,7 @@ Opcje:Aby otrzymać JSX z utility classes Tailwind:```sh-openpencil export design.fig -f jsx --style tailwind+openpencil export design.fig -f tailwind-jsx # albo: -f jsx --style tailwind```Przykład wyniku:@@ -68,6 +68,35 @@ Podczas standalone export Tailwind CSS jest od razu kompilowany, więc browser rEksport HTML jest dostępny podczas pracy z plikiem.+## Eksport do Storybook++Polecenie generuje jeden plik CSF3 `.stories.ts` dla każdego zestawu komponentów lub komponentu:++```sh+openpencil export design.fig -f storybook # Historyjki React w ./design-stories/+openpencil export design.fig -f storybook --framework vue -o src/stories+openpencil export design.fig -f storybook --framework html --page "Components"+openpencil export design.pen -f storybook -o src/stories --watch # Ponowny eksport po każdym zapisie+openpencil export 'src/**/*.pen' -f storybook --beside --watch # Historyjki obok każdego projektu+```++### Projekty obok historyjek++Trzymaj plik projektu komponentu w folderze komponentu i eksportuj z `--beside`: historyjki każdego dokumentu, obrazy projektu i manifest `.openpencil-stories.json` trafiają do folderu tego dokumentu, obok kodu komponentu. Wzorzec `stories` w `.storybook/main.ts`, na przykład `../src/**/*.stories.ts`, znajdzie je bez dodatkowej konfiguracji.++Możesz podać kilka dokumentów albo ujęty w cudzysłów wzorzec, na przykład `'src/**/*.pen'`, który OpenPencil rozwija samodzielnie (Node.js 22 lub nowszy). Kilka dokumentów wymaga `--beside` albo `--output`, a `--page` działa tylko z jednym dokumentem. Dokumenty są eksportowane kolejno, a gdy któryś się nie powiedzie, pozostałe nadal są eksportowane, po czym polecenie kończy się błędem. `--watch` obserwuje każdy dopasowany dokument; dokument utworzony po uruchomieniu obserwacji wymaga ponownego uruchomienia polecenia.++Każdy wariant zestawu komponentów staje się historyjką, a jego właściwości wariantów — kontrolką `select`, więc zmiana kontrolki pokazuje odpowiedni wariant. Samodzielne komponenty nazwane z ukośnikami, takie jak `Button/Primary` i `Button/Secondary`, trafiają do jednego pliku `Button` z kontrolką `Variant`. Kombinacja, dla której projekt nie ma wariantu, zgłasza w Storybooku nazwany błąd zamiast pokazywać inny wariant.++Historyjki renderują komponent jako HTML z inline styles, tak jak `-f html`, więc nie potrzebują środowiska OpenPencil; `--framework` (`react`, `vue` lub `html`) zmienia tylko opakowanie oraz import `Meta`/`StoryObj` z `@storybook/react-vite`, `@storybook/vue3-vite` lub `@storybook/html-vite`. Tekst używa rodzin czcionek dokumentu, które Storybook musi wczytać sam. Właściwości tekstowe, logiczne i podmiany egzemplarza nie są jeszcze eksportowane.++Historyjki zawierają wpisy `parameters.design` dla [`@storybook/addon-designs`](https://github.com/storybookjs/addon-designs):++- **OpenPencil:** gdy ścieżka dokumentu leży w bieżącym katalogu, [odnośnik `openpencil://`](../index#url-scheme), który otwiera dokument w aplikacji na komputer i zaznacza wariant albo jego zestaw komponentów, gdy inna warstwa ma taką samą nazwę jak wariant. Schemat adresuje warstwy po nazwie, więc historyjka, której nazwy wariantu i komponentu są współdzielone z innymi warstwami, nie dostaje odnośnika.+- **Design:** obraz PNG wariantu w skali 2×, zapisany w `<Name>.design/` obok historyjki i wskazany przez `new URL(…, import.meta.url)`, dzięki czemu Vite go dołącza do paczki. Skopiuj ten parametr do historyjki własnego komponentu, aby porównać implementację z projektem. `--no-design-images` pomija renderowanie; podmiana czcionek podlega `--font-policy`, tak jak w eksporcie rastrowym.++`-o` wskazuje katalog wyjściowy. Znajdujący się tam manifest `.openpencil-stories.json` zapisuje, który dokument (jako ścieżkę względną względem katalogu wyjściowego) i która strona wygenerowały każdą historyjkę i obraz projektu; zatwierdzaj go razem z historyjkami. Eksport zastępuje pliki wygenerowane tam wcześniej z tego samego dokumentu, także dla komponentów usuniętych lub przemianowanych od tego czasu; z `--page` tylko pliki tej strony. Przed jakąkolwiek zmianą odmawia nadpisania każdego innego pliku — ręcznie napisanej historyjki, historyjki innego dokumentu lub zbłąkanego obrazu. Eksport jednej strony, w którym nazwy plików przesunęły się na historyjki innej strony, wymaga pełnego eksportu. Bez manifestu istniejące historyjki są traktowane jak cudze, więc usuń je przed ponownym eksportem. `--watch` utrzymuje działanie polecenia i ponawia eksport po każdym zapisie dokumentu, dzięki czemu gorące przeładowanie Storybooka podąża za projektem; zapis, którego nie da się odczytać, jest zgłaszany, a obserwacja trwa dalej. Brakująca strona z `--page` lub podmiana czcionki przy `--font-policy strict` nadal kończy polecenie.+## Thumbnail```sh@@ -76,8 +105,14 @@ openpencil export design.fig --thumbnail --width 1920 --height 1080## Eksport z uruchomionej aplikacji-Nie podawaj pliku, aby eksportować bieżący dokument z aplikacji:+Nie podawaj pliku, aby eksportować z aplikacji:```sh-openpencil export -f png # Zrzut bieżącego obszaru roboczego+openpencil export -f png # Zaznaczenie w aktywnym dokumencie+openpencil export --page "Components" -f png # Wszystkie warstwy strony+openpencil export --node 1:23 -f png # Jedna warstwa, na dowolnej stronie```++`--page` przyjmuje nazwę strony, a `--page-id` identyfikator strony z `openpencil documents list`; oba eksportują tę stronę bez przełączania na nią aplikacji. Dodaj `--document-id`, aby eksportować z dokumentu innego niż aktywny.++Tryb aplikacji obsługuje PNG, JPG, WEBP, SVG i PDF. PowerPoint, JSX, HTML, Storybook i `.fig` wymagają podania pliku. Eksport miniatury z pliku nie jest obecnie obsługiwany.diff --git a/packages/docs/pl/programmable/cli/inspecting.md b/packages/docs/pl/programmable/cli/inspecting.mdindex 481f3f182..7c916b5a0 100644--- a/packages/docs/pl/programmable/cli/inspecting.md+++ b/packages/docs/pl/programmable/cli/inspecting.md@@ -100,8 +100,11 @@ openpencil lint design.figopenpencil lint design.pen --preset strictopenpencil lint design.fig --rule color-contrastopenpencil lint design.fig --list-rules+openpencil lint design.fig --fix -o fixed.fig```+Wyjście `--json` zawiera dla każdego komunikatu dane `fix` i `suggestions`. Opcja `--fix` stosuje bezpieczne poprawki — wiąże kolory z pasującą zmienną koloru i zaokrągla geometrię do pełnych pikseli — a wynik zapisuje w pliku `.fig` podanym w `-o`.+## Wyjście JSONWszystkie polecenia obsługują `--json`. Wynik można przekazać do `jq`, CI albo innego programu.diff --git a/packages/docs/pl/programmable/collaboration.md b/packages/docs/pl/programmable/collaboration.mdindex 2bf429482..1ed644ef4 100644--- a/packages/docs/pl/programmable/collaboration.md+++ b/packages/docs/pl/programmable/collaboration.md@@ -20,10 +20,15 @@ Dołączyć może każda osoba znająca odnośnik. Pokój pozostaje dostępny, d- **Dokument:** figury, tekst, właściwości i układ są aktualizowane po każdej zmianie.- **Kursory:** widoczne są położenie, nazwa i kolor każdego uczestnika.- **Zaznaczenie:** obiekty wybrane przez innych są widoczne dla wszystkich.+- **Agenci:** wbudowany czat AI pojawia się jako kursor przy edytowanych warstwach, a jego obrysowana etykieta zawiera iskrę i kryptonim, na przykład *Fern*. Kursor i obrys mają kolor osoby, która go uruchomiła, więc widać, czyj to agent. Udostępniane są tylko nazwa, rodzaj, model, stan, strona, położenie i edytowane warstwy agenta, nigdy prompty ani odpowiedzi.## Tryb śledzenia-Kliknij awatar uczestnika na górnym pasku, aby śledzić jego widok. Położenie i skala obszaru roboczego będą odpowiadać jego widokowi. Ponowne kliknięcie wyłącza śledzenie.+Kliknij awatar uczestnika na górnym pasku, aby śledzić jego widok. Położenie i skala obszaru roboczego będą odpowiadać jego widokowi, a ramka w kolorze uczestnika z paskiem „Obserwujesz: …” pokazuje, kogo śledzisz. Aby przestać, kliknij awatar ponownie, naciśnij <kbd>Esc</kbd> albo sam kliknij, przewiń, zmień powiększenie lub przełącz stronę.++Awatar pokazuje liczbę agentów uruchomionych przez daną osobę. Najedź na niego, aby zobaczyć każdego agenta, jego bieżące działanie i stronę, a następnie kliknij **Obserwuj** przy agencie, aby mieć w widoku stronę i warstwy, które edytuje; śledzenie trwa między jego odpowiedziami i kończy się, gdy agent odejdzie. Przycisk za awatarami wyświetla wszystkich uczestników pokoju wraz z ich agentami i działa z klawiatury. Twój awatar wyświetla Twoich agentów — kliknij jednego, aby zmienić jego nazwę — i zawiera polecenie **Opuść pokój**.++Panel udostępniania wyświetla wszystkich uczestników pokoju wraz z ich agentami, tym, co każdy z nich robi, i stroną, na której pracuje. Agenta śledzisz tak samo: strona i warstwy, które edytuje, pozostają w widoku; śledzenie trwa między jego odpowiedziami i kończy się, gdy agent odejdzie. Kliknij dwukrotnie własnego agenta, aby zmienić jego nazwę.## Jak to działadiff --git a/packages/docs/pl/programmable/index.md b/packages/docs/pl/programmable/index.mdindex 61a7a89de..7bf5bdb29 100644--- a/packages/docs/pl/programmable/index.md+++ b/packages/docs/pl/programmable/index.md@@ -40,9 +40,9 @@ W drugą stronę OpenPencil eksportuje zaznaczenie jako JSX albo HTML z klasamiPrzeglądaj, eksportuj i analizuj dokumenty bez uruchamiania edytora. CLI pozwala wyświetlać strony, znajdować obiekty, wydobywać tokeny projektu, wykrywać problemy układu i eksportować PNG. Wszystkie polecenia obsługują wyjście JSON.-CLI łączy się również przez RPC z uruchomioną aplikacją komputerową i steruje otwartym dokumentem.+CLI łączy się również przez RPC z uruchomioną aplikacją komputerową i steruje otwartym dokumentem: pozwala otwierać, zapisywać i przełączać dokumenty, cofać zmiany, zmieniać ustawienia oraz wywoływać dowolne narzędzie MCP.-[Przeglądanie plików](./cli/inspecting) · [Eksport](./cli/exporting) · [Analiza](./cli/analyzing) · [Skrypty](./cli/scripting)+[Przeglądanie plików](./cli/inspecting) · [Eksport](./cli/exporting) · [Analiza](./cli/analyzing) · [Skrypty](./cli/scripting) · [Controlling the App](/programmable/cli/app-control)## Serwer MCP@@ -50,6 +50,32 @@ Claude Code, Cursor, Windsurf i inni klienci MCP mogą korzystać z tych samych[Serwer MCP →](/programmable/mcp-server)+## Schemat URL {#url-scheme}++Aplikacja na komputer rejestruje `openpencil://`, dzięki czemu opublikowana strona — historyjka Storybook, przegląd projektu, README — może prowadzić prosto do warstwy:++```+openpencil://open?file=web/design/hikyo.pen&node=Button/Large/Default+```++`file` to ścieżka względem repozytorium, kończąca się na `.pen` lub `.fig`; ścieżki bezwzględne oraz segmenty `.` i `..` są odrzucane. `node` jest opcjonalny. Obie wartości są kodowane jako URL — separatory ścieżki mogą pozostać dosłowne, ale dosłowny `+` trzeba wysłać jako `%2B` — a powtórzony klucz przyjmuje ostatnią wartość.++Aplikacja dopasowuje `file` do ścieżek otwartych kart jako całą końcową sekwencję segmentów i aktywuje tę kartę bez ponownego odczytu dokumentu, więc plik, który od otwarcia został przeniesiony lub stał się nieczytelny, nadal pozwala zaznaczyć swoją warstwę. Wygrywa pierwsza otwarta karta, której ścieżka kończy się żądaną ścieżką, co ma znaczenie, gdy dwie kopie repozytorium mają otwarty ten sam plik. Segmenty są porównywane tak jak w systemie plików platformy: bez rozróżniania wielkości liter ASCII w macOS i Windows, dokładnie w Linuksie, więc `Web/Design/hikyo.pen` i `web/design/hikyo.pen` to ten sam plik na Macu i dwa różne w Linuksie. Jeśli żadna otwarta karta nie pasuje, selektor plików jednorazowo prosi o plik; wybrany plik musi kończyć się tą samą ścieżką względną, w przeciwnym razie odnośnik zostaje anulowany. Żadna ścieżka nie jest doklejana do katalogu głównego i nie jest przyznawany dostęp do systemu plików poza tym, co zwróci selektor. Plik, który odnośnik faktycznie otwiera — wybrany — trafia na listę ostatnich plików jak każdy inny otwarty plik; aktywowanie karty już otwartej nie zmienia listy, bo nic nie zostało otwarte.++Przy podanej nazwie obiektu aplikacja zaznacza wszystkie warstwy o dokładnie tej nazwie na bieżącej stronie i przybliża widok do całego zaznaczenia. Gdy bieżąca strona takich warstw nie ma, przełącza się na pierwszą stronę, która je ma, wczytując strony w miarę potrzeby. Nieznana nazwa pokazuje powiadomienie i pozostawia dokument otwarty. Schemat potrafi wyłącznie otworzyć plik i zaznaczyć warstwy.++Wersja internetowa przyjmuje taki sam odnośnik z własnego paska adresu:++```+https://app.openpencil.dev/?file=https://raw.githubusercontent.com/open-pencil/open-pencil/master/tests/fixtures/pencil_button.pen&node=Button/Large/Default+```++Tutaj `file` to bezwzględny adres `https:` kończący się na `.pen` lub `.fig` — wersja internetowa nie ma systemu plików, więc ścieżka względna, adres `http:` lub inne rozszerzenie są odrzucane z ostrzeżeniem w konsoli i niczym więcej. Rozszerzenie jest odczytywane ze ścieżki adresu, więc zapytanie w adresie pliku niczego nie zmienia. Fragment jest odcinany przed pobraniem: nigdy nie trafia na serwer, więc `…/hikyo.pen#a` i `…/hikyo.pen#b` otwierają jedną kartę, nie dwie. `node` działa dokładnie jak wyżej: to samo zaznaczanie po dokładnej nazwie i przybliżenie, to samo powiadomienie, gdy żadna warstwa nie ma takiej nazwy. Obie wartości są kodowane jako URL, dosłowny `+` trzeba wysłać jako `%2B`, a powtórzony klucz przyjmuje ostatnią wartość, tak jak na komputerze. Odnośnik jest obsługiwany na każdej trasie, więc `/share/<room>?file=…` i `/demo?file=…` działają jak `/?file=…`.++Przeglądarka pobiera plik między domenami, więc host musi to dopuszczać: `raw.githubusercontent.com` wysyła `Access-Control-Allow-Origin: *` i działa. Żądanie nie niesie danych uwierzytelniających i odmawia podążania za przekierowaniami, co chroni przed przekierowaniem odnośnika `https:` na niezaszyfrowany — adres `https://github.com/<owner>/<repo>/raw/...` przekierowuje na `raw.githubusercontent.com`, więc jest odrzucany; podaj bezpośrednio adres hosta raw. `file` i `node` są usuwane z paska adresu przez router zaraz po odczycie — przed pobraniem, a także gdy odnośnik został odrzucony — więc przeładowanie nie otwiera dokumentu ponownie, a skopiowany adres ani późniejsza nawigacja w aplikacji nie niosą danych odnośnika. Dokument z odnośnika jest ograniczony do 64 MiB: treść jest liczona w trakcie strumieniowania, nie na podstawie `Content-Length`, a żądanie jest przerywane w chwili przekroczenia limitu, po czym odnośnik zgłasza, że plik przekracza 64 MiB. Wdrożenie udostępniające aplikację z Content-Security-Policy musi dopuścić host odnośnika w `connect-src`, inaczej pobranie jest blokowane, a odnośnik zgłasza, że nie udało się otworzyć pliku.++W macOS schemat należy do zainstalowanego pakietu aplikacji, więc odnośniki trafiają do zainstalowanej wersji, a nie do procesu `tauri dev`. W Windows i Linuksie odnośnik dociera przez wtyczkę deep-link, także gdy aplikacja jeszcze nie działa: jest kolejkowany przy starcie i obsługiwany, gdy edytor jest gotowy; w Linuksie dołączony wpis pulpitu przekazuje odnośnik przez `%U`.+## Otwarta platformaOpenPencil jest udostępniany na licencji MIT, przechowuje dokumenty lokalnie i zapewnia programowy dostęp do operacji. Pliki `.fig` można sprawdzać, przekształcać, przetwarzać w CI i przekazywać modelowi językowemu bez zależności od konkretnego dostawcy hostingu.diff --git a/packages/docs/pl/programmable/jsx-renderer.md b/packages/docs/pl/programmable/jsx-renderer.mdindex 6e727815a..320ed2c55 100644--- a/packages/docs/pl/programmable/jsx-renderer.md+++ b/packages/docs/pl/programmable/jsx-renderer.md@@ -20,7 +20,7 @@ Narzędzie `render`, dostępne w czacie AI, MCP i `eval` CLI, przyjmuje JSX:</Frame>```-W MCP i czacie AI przekaż narzędziu `render` ciąg JSX. Do konwersji w drugą stronę użyj polecenia `export`.+W MCP i czacie AI przekaż narzędziu `render` ciąg JSX. W kodzie aplikacji lub bibliotece działającej bez interfejsu zaimportuj `Frame`, `Text` i pozostałe elementy do tworzenia projektu z `@open-pencil/design-jsx`, a potem twórz obiekty przez `renderTree` lub `renderJSX` z `@open-pencil/core/design-jsx`, które dodają ikony, konwersję SVG i układ. Aby zapisywać drzewa jako TSX, ustaw w `tsconfig.json` `"jsxImportSource": "@open-pencil/design-jsx"` wraz z `"jsx": "react-jsx"` albo dodaj do pliku komentarz `/** @jsxImportSource @open-pencil/design-jsx */`. Środowisko skryptowe określa, które API są dostępne w `eval`; eksporty pakietów nie są tam automatycznie zmiennymi globalnymi. Do konwersji w drugą stronę użyj polecenia `export`.## Elementy@@ -53,7 +53,7 @@ openpencil export design.fig -f jsx # Format OpenPencilopenpencil export design.fig -f jsx --style tailwind # Klasy Tailwind```-Wyeksportowany projekt można zmienić jak kod i ponownie wyrenderować.+Wyeksportowany projekt można zmienić jak kod i ponownie wyrenderować. Eksport zapisuje ukryte i zablokowane warstwy, ograniczenia, limity rozmiaru, wielowarstwowe, gradientowe i obrazowe zalewy, obwiednie, efekty, maski oraz powiązania ze zmiennymi, więc renderowanie eksportu je odtwarza, a `diff_jsx` pokazuje zmiany każdego z nich. Tekst sformatowany wieloma stylami, ścieżki wektorowe, siatki układu, style współdzielone i definicje właściwości komponentów nie są jeszcze zapisywane. Egzemplarze są zapisywane jako ramki z zawartością, dzięki czemu wyeksportowany JSX jest samodzielny.## Porównanie zmiandiff --git a/packages/docs/pl/programmable/sdk/api/composables/use-export.md b/packages/docs/pl/programmable/sdk/api/composables/use-export.mdindex 50a7b1a05..645712e35 100644--- a/packages/docs/pl/programmable/sdk/api/composables/use-export.md+++ b/packages/docs/pl/programmable/sdk/api/composables/use-export.md@@ -10,7 +10,7 @@ description: Ustawienia scale i format eksportu bieżącego selection.- ustawienia eksportu;- IDs zaznaczonych obiektów;- nazwę pliku wynikowego;-- dostępne scales i formats.+- dostępne scales i formats (identyfikatory `formats` i opisane `formatOptions`).## Użycie@@ -28,6 +28,7 @@ const {nodeName,scales,formats,+ formatOptions,addSetting,updateScale,updateFormat,diff --git a/packages/docs/pl/user-guide/canvas-navigation.md b/packages/docs/pl/user-guide/canvas-navigation.mdindex d9cfd708e..535774ffe 100644--- a/packages/docs/pl/user-guide/canvas-navigation.md+++ b/packages/docs/pl/user-guide/canvas-navigation.md@@ -41,6 +41,12 @@ Gest zmiany powiększenia jest wyłączony na panelach warstw i właściwości,| Pomniejszyć | <kbd>⌘</kbd><kbd>−</kbd> | <kbd>Ctrl</kbd> + <kbd>−</kbd> || Powiększenie 100% | <kbd>⌘</kbd><kbd>0</kbd> | <kbd>Ctrl</kbd> + <kbd>0</kbd> |+## Paleta poleceń++Naciśnij <kbd>⌘</kbd><kbd>K</kbd> w macOS albo <kbd>Ctrl</kbd> + <kbd>K</kbd> w Windows i Linuksie, aby przeszukać działania edytora i aplikacji. Wybranie wyniku uruchamia je; niedostępne działania nadal zależą od bieżącego zaznaczenia i stanu dokumentu.++Paleta służy też do przechodzenia między stronami. Zanim zaczniesz pisać, wyświetla strony odwiedzone ostatnio w tej karcie, od najnowszej, a **Przejdź do strony…** otwiera listę wszystkich stron. Stronę można też znaleźć, wpisując jej nazwę. Strony, na których pracują współpracownicy lub agenci AI, są wyświetlane z ich nazwami; panel Strony oznacza te same strony ich kolorami.+## Wskazówki- Przed zmianą powiększenia umieść wskaźnik nad obszarem, który chcesz dokładniej obejrzeć.diff --git a/packages/docs/pl/user-guide/index.md b/packages/docs/pl/user-guide/index.mdindex 4051e51ff..f5d0a5ad8 100644--- a/packages/docs/pl/user-guide/index.md+++ b/packages/docs/pl/user-guide/index.md@@ -34,4 +34,5 @@ W podręczniku używane są oznaczenia z macOS: <kbd>⌘</kbd> oznacza <kbd>Comm- [Automatyczny układ](./auto-layout) — rozmieszczanie obiektów za pomocą Flexbox i CSS Grid;- [Komponenty](./components) — komponenty, egzemplarze i nadpisania przeznaczone do ponownego użycia;-- [Zmienne](./variables) — zmienne projektu, kolekcje, tryby i powiązania z zalewami.+- [Zmienne](./variables) — zmienne projektu, kolekcje, tryby i powiązania z zalewami;+- [Checking Designs](/user-guide/checking-designs) — panel Sprawdź, znaczniki problemów na obszarze roboczym i reguły lintu.diff --git a/packages/docs/programmable/cli/exporting.md b/packages/docs/programmable/cli/exporting.mdindex b64b938a6..e2a97b2e7 100644--- a/packages/docs/programmable/cli/exporting.md+++ b/packages/docs/programmable/cli/exporting.md@@ -127,6 +127,6 @@ openpencil export --page "Components" -f png # export every layer of a pageopenpencil export --node 1:23 -f png # export one layer, on any page```-`--page` takes a page name and `--page-id` a page ID from `openpencil documents`; either exports that page without switching the app to it. Add `--document-id` to export from a document other than the active one.+`--page` takes a page name and `--page-id` a page ID from `openpencil documents list`; either exports that page without switching the app to it. Add `--document-id` to export from a document other than the active one.Live app mode supports PNG, JPG, WEBP, SVG, and PDF. PowerPoint, JSX, HTML, Storybook, and `.fig` exports require a file argument. File-mode thumbnail export is not currently supported.diff --git a/packages/docs/ru/getting-started.md b/packages/docs/ru/getting-started.mdindex 7ff9d3fd3..a3502681d 100644--- a/packages/docs/ru/getting-started.md+++ b/packages/docs/ru/getting-started.md@@ -18,6 +18,18 @@ OpenPencil работает прямо в браузере и не требуе| Windows (ARM) | `.msi` / `.exe` || Linux (x64) | `.AppImage` / `.deb` |+## Системные требования++OpenPencil отрисовывает графику через CanvasKit на WebGL и использует современные возможности веб-платформы, поэтому нужен свежий движок браузера. Веб-версия работает в Chrome 111, Edge 111, Firefox 128 и Safari 16.4 или новее; браузеры на основе Chromium, например Brave и Opera, ориентируются на версию своего Chrome. Приложение для компьютера отрисовывает интерфейс в системном WebView, поэтому нижняя граница определяется движком операционной системы:++| Платформа | Требование |+| --------- | ---------- |+| macOS | macOS 13 Ventura или новее с актуальными обновлениями Safari (Safari 16.4 вышел вместе с macOS 13.3). |+| Windows | Windows 10 или новее со средой Microsoft Edge WebView2 Evergreen, которая обновляется сама. |+| Linux | WebKitGTK 2.40 или новее (`webkit2gtk-4.1`). |++Если движок слишком старый, OpenPencil вместо пустого окна показывает, что нужно обновить. Если вы видите такое уведомление в системе, которая подходит под требования, воспользуйтесь ссылкой «Report a problem»: в ней уже указаны сведения о браузере и движке.+## Установка в macOS через Homebrew```shdiff --git a/packages/docs/ru/overview/features.md b/packages/docs/ru/overview/features.mdindex 211c3c515..efb464d2b 100644--- a/packages/docs/ru/overview/features.md+++ b/packages/docs/ru/overview/features.md@@ -19,7 +19,7 @@ OpenPencil открывает и сохраняет `.fig` без предвар## Панель свойств-Содержимое вкладок «Дизайн», «Код» и «ИИ» зависит от выделения.+Содержимое вкладок «Дизайн», «Код», «AI» и «Проверка» зависит от выделения.- **Внешний вид:** прозрачность, общий или отдельный радиус углов и видимость.- **Заливка:** сплошной цвет, линейный, радиальный, угловой и ромбический градиенты, а также изображения.@@ -28,6 +28,8 @@ OpenPencil открывает и сохраняет `.fig` без предвар- **Типографика:** выбор шрифта с поиском и виртуальной прокруткой, начертание, размер, выравнивание и кнопки форматирования.- **Компоновка:** параметры автоматической компоновки.- **Экспорт:** масштаб, форматы PNG/JPG/WEBP/SVG и предварительный просмотр.+- **Код:** Design JSX и Tailwind JSX для выделения; Design JSX можно редактировать с двусторонней синхронизацией — код обновляется при изменении слоёв. Элемент под курсором обводит свой слой на холсте, а проблемы дизайна подчёркиваются в том свойстве, которое их вызывает.+- **Проверка:** проверка дизайна страницы или выделения в реальном времени: низкий контраст, мелкие области нажатия, цвета без привязки к переменным, интервалы вне шкалы. Проблемы отмечаются на холсте, а переменную можно привязать одним щелчком ([Checking Designs](/user-guide/checking-designs)).## Отрисовкаdiff --git a/packages/docs/ru/programmable/ai-chat.md b/packages/docs/ru/programmable/ai-chat.mdindex 6c3331a38..faf691859 100644--- a/packages/docs/ru/programmable/ai-chat.md+++ b/packages/docs/ru/programmable/ai-chat.md@@ -49,14 +49,14 @@ description: Встроенный помощник с более чем 90 ин- **Компоненты:** создание компонентов, экземпляров и наборов, управление переопределениями.- **Переменные:** создание и изменение переменных, коллекций и режимов, привязка к заливкам.- **Запросы:** поиск объектов, селекторы XPath, чтение свойств, получение списка страниц, шрифтов и выделения.-- **Проверка:** `get_jsx`, `diff_jsx` и `describe` для анализа структуры, роли объекта и возможных проблем дизайна.+- **Проверка:** `get_jsx`, `diff_create` и `diff_jsx` для структурных различий, `diff_visual` для попиксельных различий, `describe` для анализа структуры, роли объекта и возможных проблем дизайна.- **Анализ:** палитра, типографика, интервалы и повторяющиеся группы.- **Экспорт:** PNG, SVG и JSX с классами Tailwind; визуальная проверка через `export_image`.- **Векторы:** логические операции и изменение контуров.## Визуальная проверка-После создания или изменения дизайна помощник может вызвать `export_image`, получить снимок результата и сопоставить его с исходным запросом. Так обнаруживаются проблемы компоновки, отсутствующие элементы и неверные цвета.+После создания или изменения дизайна помощник может вызвать `export_image`, получить снимок результата и сопоставить его с исходным запросом. Так обнаруживаются проблемы компоновки, отсутствующие элементы и неверные цвета. Инструмент `diff_visual`, который включён по умолчанию, сравнивает изменённый объект с эталонной копией и возвращает изменившиеся пиксели и область, поэтому помощник может убедиться, что правка не вышла за пределы цели.## Примеры запросов@@ -74,5 +74,6 @@ description: Встроенный помощник с более чем 90 ин- Перед запросом выделите нужные объекты: помощник видит выделение.- Точно указывайте цвета, размеры и положение.- В одном сообщении можно изменить несколько объектов.+- Пока идёт ответ, можно смотреть другие страницы: помощник продолжает работать на той странице, где было отправлено сообщение, а его предпросмотры появятся, когда вы вернётесь. Пока вы на другой странице, чат сообщает, с какой страницей работает помощник, и предлагает кнопку **Перейти к странице**. Если помощник сам переключает страницу, ваш вид следует за ним.- Если результат не подходит, используйте отмену.- После каждого вызова инструмента компоновка пересчитывается автоматически.diff --git a/packages/docs/ru/programmable/cli/exporting.md b/packages/docs/ru/programmable/cli/exporting.mdindex 8af88b948..419424a3f 100644--- a/packages/docs/ru/programmable/cli/exporting.md+++ b/packages/docs/ru/programmable/cli/exporting.md@@ -1,11 +1,11 @@---title: Экспорт-description: Экспорт содержимого документа в PNG, JPG, WEBP, SVG, .fig, JSX или HTML и преобразование между форматами.+description: Экспорт содержимого документа в PNG, JPG, WEBP, SVG, .fig, JSX, HTML или истории Storybook и преобразование между форматами.---# Экспорт-CLI экспортирует дизайн в растровые изображения, векторную графику, отдельные документы `.fig`, JSX или HTML.+CLI экспортирует дизайн в растровые изображения, векторную графику, отдельные документы `.fig`, JSX, HTML или истории Storybook.## Изображения и .fig@@ -21,7 +21,7 @@ openpencil export design.fig -f html --css tailwind # фрагмент HTMLПараметры:-- `-f` — формат: `png`, `jpg`, `webp`, `svg`, `jsx`, `html` или `fig`;+- `-f` — формат: `png`, `jpg`, `webp`, `svg`, `jsx`, `html`, `fig` или `storybook`;- `-s` — масштаб от `1` до `4`;- `-q` — качество от `0` до `100`, только для JPG и WEBP;- `-o` — путь к выходному файлу;@@ -33,7 +33,7 @@ openpencil export design.fig -f html --css tailwind # фрагмент HTMLЧтобы получить JSX с классами Tailwind:```sh-openpencil export design.fig -f jsx --style tailwind+openpencil export design.fig -f tailwind-jsx # или: -f jsx --style tailwind```Параметр `--style openpencil` выбирает собственный формат JSX OpenPencil. Подробнее — в разделе [Рендерер JSX](../jsx-renderer).@@ -59,6 +59,35 @@ openpencil export design.fig -f html --html standalone --css tailwind --assets eЭкспорт HTML доступен при работе с файлом.+## Экспорт в Storybook++Команда создаёт по одному файлу CSF3 `.stories.ts` для каждого набора компонентов или компонента:++```sh+openpencil export design.fig -f storybook # истории React в ./design-stories/+openpencil export design.fig -f storybook --framework vue -o src/stories+openpencil export design.fig -f storybook --framework html --page "Components"+openpencil export design.pen -f storybook -o src/stories --watch # повторный экспорт при каждом сохранении+openpencil export 'src/**/*.pen' -f storybook --beside --watch # истории рядом с каждым дизайном+```++### Дизайн рядом с историями++Храните файл дизайна компонента в папке самого компонента и экспортируйте с `--beside`: истории каждого документа, изображения дизайна и манифест `.openpencil-stories.json` попадут в папку этого документа, рядом с кодом компонента. Шаблон `stories` в `.storybook/main.ts`, например `../src/**/*.stories.ts`, подхватит их без дополнительной настройки.++Можно передать несколько документов или шаблон в кавычках, например `'src/**/*.pen'`, который OpenPencil раскрывает сам (нужен Node.js 22 или новее). Для нескольких документов необходим `--beside` или `--output`; `--page` работает только с одним документом. Документы экспортируются по очереди; если один не удалось экспортировать, остальные всё равно будут обработаны, а команда завершится с ошибкой. `--watch` следит за всеми найденными документами; документ, созданный после запуска слежения, потребует повторного запуска.++Каждый вариант набора компонентов становится историей, а его свойства вариантов — элементами управления `select`, поэтому переключение элемента показывает соответствующий вариант. Отдельные компоненты с именами через косую черту, например `Button/Primary` и `Button/Secondary`, собираются в один файл `Button` с элементом управления `Variant`. Если в дизайне нет варианта для выбранной комбинации, Storybook выдаст ошибку с именем, а не покажет другой вариант.++Истории отображают компонент как HTML со встроенными стилями, как `-f html`, поэтому среда выполнения OpenPencil не нужна; `--framework` (`react`, `vue` или `html`) меняет только обёртку и импорт `Meta`/`StoryObj` из `@storybook/react-vite`, `@storybook/vue3-vite` или `@storybook/html-vite`. В тексте используются семейства шрифтов документа, которые Storybook должен загрузить сам. Текстовые, логические свойства и свойства подмены экземпляра пока не экспортируются.++В историях есть записи `parameters.design` для [`@storybook/addon-designs`](https://github.com/storybookjs/addon-designs):++- **OpenPencil:** если документ находится внутри текущей папки, это [ссылка `openpencil://`](../index#url-scheme), которая открывает документ в приложении для компьютера и выделяет вариант или его набор компонентов, когда другой слой носит то же имя, что и вариант. Схема обращается к слоям по имени, поэтому история, у которой имена варианта и компонента повторяются у других слоёв, ссылки не получает.+- **Design:** PNG варианта в масштабе 2×, записанный в `<Name>.design/` рядом с историей и подключённый через `new URL(…, import.meta.url)`, чтобы Vite включил его в сборку. Скопируйте параметр в историю собственного компонента, чтобы сравнить реализацию с дизайном. `--no-design-images` пропускает отрисовку; подстановка шрифтов подчиняется `--font-policy`, как при растровом экспорте.++`-o` задаёт папку вывода. Манифест `.openpencil-stories.json` в ней записывает, какой документ (путь относительно папки вывода) и какая страница создали каждую историю и изображение; сохраняйте его в репозитории вместе с историями. Экспорт заменяет файлы, созданные предыдущим экспортом того же документа, включая файлы удалённых или переименованных компонентов; с `--page` — только файлы этой страницы. Прежде чем что-либо менять, команда откажется перезаписывать любой другой файл: написанную вручную историю, историю другого документа или посторонний образ. Если при экспорте одной страницы имена файлов сместились на истории другой страницы, потребуется полный экспорт. Без манифеста существующие истории считаются чужими, поэтому перед повторным экспортом удалите их. `--watch` оставляет команду запущенной и повторяет экспорт при каждом сохранении документа, так что горячая перезагрузка Storybook следует за дизайном; если сохранённый файл прочитать не удалось, команда сообщает об этом и продолжает следить. Отсутствующая `--page` или подстановка при `--font-policy strict` по-прежнему завершают команду.+## Миниатюра```sh@@ -70,5 +99,11 @@ openpencil export design.fig --thumbnail --width 1920 --height 1080Не указывайте файл, чтобы экспортировать текущий документ из приложения:```sh-openpencil export -f png # снимок текущего холста+openpencil export -f png # выделение в активном документе+openpencil export --page "Components" -f png # все слои страницы+openpencil export --node 1:23 -f png # один слой на любой странице```++`--page` принимает имя страницы, а `--page-id` — ID страницы из `openpencil documents list`; любой из параметров экспортирует страницу, не переключая на неё приложение. Добавьте `--document-id`, чтобы экспортировать из документа, который не является активным.++В режиме запущенного приложения поддерживаются PNG, JPG, WEBP, SVG и PDF. Для PowerPoint, JSX, HTML, Storybook и `.fig` нужно указать файл. Экспорт миниатюр в режиме файла пока не поддерживается.diff --git a/packages/docs/ru/programmable/cli/inspecting.md b/packages/docs/ru/programmable/cli/inspecting.mdindex 8674ab702..ec23ce42b 100644--- a/packages/docs/ru/programmable/cli/inspecting.md+++ b/packages/docs/ru/programmable/cli/inspecting.md@@ -127,9 +127,10 @@ openpencil lint design.figopenpencil lint design.pen --preset strictopenpencil lint design.fig --rule color-contrastopenpencil lint design.fig --list-rules+openpencil lint design.fig --fix -o fixed.fig```-Добавьте `--json`, если результат будет обрабатывать другая программа.+Добавьте `--json`, если результат будет обрабатывать другая программа: каждое сообщение содержит `fix` и `suggestions` в виде данных. `--fix` применяет безопасные исправления — привязывает цвета к подходящим переменным цвета и округляет геометрию до целых пикселей — и записывает результат в файл `.fig`, указанный в `-o`.## Вывод JSONdiff --git a/packages/docs/ru/programmable/collaboration.md b/packages/docs/ru/programmable/collaboration.mdindex 1bdf7c78f..e7ff62acf 100644--- a/packages/docs/ru/programmable/collaboration.md+++ b/packages/docs/ru/programmable/collaboration.md@@ -20,10 +20,15 @@ description: Одновременное редактирование напря- **Документ:** фигуры, текст, свойства и компоновка обновляются после каждого изменения.- **Указатели:** видны положение, имя и цвет каждого участника.- **Выделение:** выбранные другими участниками объекты видны всем.+- **Агенты:** встроенный чат с ИИ отображается как указатель у слоёв, которые он редактирует; на его контурной подписи есть значок-искорка и позывной, например *Fern*. Указатель и контур имеют цвет того, кто его запустил, так что видно, чей это агент. Передаются только имя, тип, модель, состояние, страница, положение и изменяемые слои — но не запросы и ответы.## Режим слежения-Щёлкните аватар участника на верхней панели, чтобы следовать за его областью просмотра. Положение и масштаб вашего холста будут повторять его вид. Повторный щелчок отключает слежение.+Щёлкните аватар участника на верхней панели, чтобы следовать за его областью просмотра. Положение и масштаб вашего холста будут повторять его вид, а рамка его цвета с панелью «Вы следуете за …» показывает, за кем вы следите. Чтобы остановить слежение, снова щёлкните аватар, нажмите <kbd>Esc</kbd> либо сами щёлкните по холсту, прокрутите его, измените масштаб или переключите страницу.++На аватаре отображается число агентов, которых запустил этот участник. Наведите на него указатель, чтобы увидеть каждого агента, чем он занят и на какой странице, и нажмите **Следовать** рядом с агентом, чтобы страница и слои, которые он редактирует, оставались в поле зрения. Слежение продолжается между его ответами и прекращается, когда агент уходит. Кнопка после аватаров показывает всех участников комнаты с их агентами и доступна с клавиатуры. Ваш собственный аватар перечисляет ваших агентов — щёлкните по одному, чтобы переименовать, — и содержит пункт **Покинуть комнату**.++Панель «Поделиться» перечисляет всех участников комнаты с запущенными ими агентами, показывает, чем занят каждый агент и на какой странице. Следуйте за агентом так же, чтобы страница и слои, которые он редактирует, оставались в поле зрения; слежение продолжается между его ответами и прекращается, когда агент уходит. Дважды щёлкните своего агента, чтобы переименовать его.## Как это работаетdiff --git a/packages/docs/ru/programmable/index.md b/packages/docs/ru/programmable/index.mdindex 24ae73254..93077807a 100644--- a/packages/docs/ru/programmable/index.md+++ b/packages/docs/ru/programmable/index.md@@ -40,9 +40,9 @@ OpenPencil позволяет работать с файлами дизайнаПросматривайте, экспортируйте и анализируйте документы без запуска редактора. CLI позволяет получить список страниц, найти объекты, извлечь токены дизайна, обнаружить проблемы компоновки и выполнить экспорт в PNG. Все команды поддерживают вывод JSON.-CLI также подключается по RPC к запущенному настольному приложению и управляет открытым документом.+CLI также подключается по RPC к запущенному настольному приложению и управляет открытым документом: открывать, сохранять и переключать документы, отменять изменения, менять настройки и вызывать любой инструмент MCP.-[Просмотр файлов](./cli/inspecting) · [Экспорт](./cli/exporting) · [Анализ](./cli/analyzing) · [Сценарии](./cli/scripting)+[Просмотр файлов](./cli/inspecting) · [Экспорт](./cli/exporting) · [Анализ](./cli/analyzing) · [Сценарии](./cli/scripting) · [Controlling the App](/programmable/cli/app-control)## Сервер MCP@@ -50,6 +50,32 @@ Claude Code, Cursor, Windsurf и другие клиенты MCP могут ис[Сервер MCP →](/programmable/mcp-server)+## Схема URL {#url-scheme}++Настольное приложение регистрирует схему `openpencil://`, поэтому опубликованная страница — история Storybook, обзор дизайна, README — может ссылаться прямо на слой:++```+openpencil://open?file=web/design/hikyo.pen&node=Button/Large/Default+```++`file` — путь относительно репозитория, оканчивающийся на `.pen` или `.fig`; абсолютные пути и сегменты `.` или `..` отклоняются. `node` необязателен. Оба значения кодируются как URL: разделители пути можно оставить как есть, но символ `+` нужно передавать как `%2B`; если ключ повторяется, используется последнее значение.++Приложение сопоставляет `file` с путями открытых вкладок как с целой конечной последовательностью сегментов и переключается на эту вкладку, не перечитывая документ, поэтому слой выделяется, даже если файл с момента открытия переместили или он стал нечитаемым. Побеждает первая открытая вкладка, путь которой оканчивается запрошенным путём, — это важно, когда один и тот же файл открыт из двух копий репозитория. Сегменты сравниваются так же, как это делает файловая система платформы: без учёта регистра ASCII в macOS и Windows и точно в Linux, поэтому `Web/Design/hikyo.pen` и `web/design/hikyo.pen` — один файл на Mac и два разных в Linux. Если подходящей вкладки нет, окно выбора файла один раз запрашивает файл; выбранный файл должен оканчиваться тем же относительным путём, иначе ссылка отменяется. Путь не присоединяется ни к какому корню, и доступ к файловой системе не выдаётся сверх того, что вернёт окно выбора. Файл, который ссылка действительно открывает (выбранный), попадает в список недавних файлов, как любой другой открытый файл; переход на уже открытую вкладку список не меняет, потому что ничего не открывалось.++Если указано имя объекта, приложение выделяет все слои с точно таким именем на текущей странице и подбирает масштаб так, чтобы в кадр попало всё выделение. Если на текущей странице таких слоёв нет, приложение переключается на первую страницу, где они есть, загружая страницы по мере необходимости. Неизвестное имя вызывает уведомление, а документ остаётся открытым. Схема умеет только открывать файл и выделять слои.++Веб-версия принимает такую же ссылку в адресной строке:++```+https://app.openpencil.dev/?file=https://raw.githubusercontent.com/open-pencil/open-pencil/master/tests/fixtures/pencil_button.pen&node=Button/Large/Default+```++Здесь `file` — абсолютный URL с `https:`, оканчивающийся на `.pen` или `.fig`. В веб-версии нет файловой системы, поэтому относительный путь, URL с `http:` и любое другое расширение отклоняются с предупреждением в консоли и больше ничего не происходит. Расширение определяется по пути URL, так что строка запроса у файла ничего не меняет. Фрагмент отбрасывается до загрузки: на сервер он не попадает, поэтому `…/hikyo.pen#a` и `…/hikyo.pen#b` открывают одну вкладку, а не две. `node` работает точно так же, как выше: то же выделение по точному имени и тот же масштаб, то же уведомление, если слоя с таким именем нет. Оба значения кодируются как URL, символ `+` нужно передавать как `%2B`, а при повторе ключа берётся последнее значение, как и в настольной версии. Ссылка обрабатывается на любом маршруте, поэтому `/share/<room>?file=…` и `/demo?file=…` работают так же, как `/?file=…`.++Браузер загружает файл с другого источника, поэтому хост должен это разрешать: `raw.githubusercontent.com` отправляет `Access-Control-Allow-Origin: *` и подходит. Запрос не содержит учётных данных и не следует перенаправлениям, чтобы ссылка с `https:` не могла перенаправить на незащищённую: URL вида `https://github.com/<owner>/<repo>/raw/...` перенаправляет на `raw.githubusercontent.com` и потому отклоняется, так что ссылайтесь сразу на хост raw. `file` и `node` удаляются из адресной строки через маршрутизатор сразу после чтения — до загрузки, а также если ссылка была отклонена, — поэтому перезагрузка не откроет документ заново, а скопированный URL или последующая навигация внутри приложения не несут данных ссылки. Размер загружаемого документа ограничен 64 МиБ: тело считается по мере поступления, значению `Content-Length` не доверяют, а запрос прерывается, как только лимит превышен; ссылка сообщает, что файл больше 64 МиБ. Если приложение развёрнуто с политикой Content-Security-Policy, она должна разрешать хост ссылки в `connect-src`, иначе загрузка блокируется, и ссылка сообщает, что не удалось открыть файл.++В macOS схема принадлежит установленному пакету приложения, поэтому ссылки доходят до установленной сборки, а не до процесса `tauri dev`. В Windows и Linux ссылка приходит через плагин deep-link, в том числе когда приложение ещё не запущено: при запуске она ставится в очередь и обрабатывается, когда редактор готов; в Linux встроенный файл рабочего стола передаёт ссылку через `%U`.+## Открытая платформаOpenPencil распространяется по лицензии MIT, хранит документы локально и предоставляет программный доступ к операциям. Файлы `.fig` можно проверять, преобразовывать, обрабатывать в CI и передавать языковой модели без привязки к определённому поставщику размещения.diff --git a/packages/docs/ru/programmable/jsx-renderer.md b/packages/docs/ru/programmable/jsx-renderer.mdindex 3253c4f02..5c0fb2481 100644--- a/packages/docs/ru/programmable/jsx-renderer.md+++ b/packages/docs/ru/programmable/jsx-renderer.md@@ -20,7 +20,7 @@ JSX также служит читаемым представлением сущ</Frame>```-В MCP и чате с ИИ передайте инструменту `render` строку JSX. Для обратного преобразования используйте команду `export` — подробнее в разделе [Экспорт дизайна в JSX](./cli/exporting).+В MCP и чате с ИИ передайте инструменту `render` строку JSX. В коде приложения или библиотеки без интерфейса импортируйте `Frame`, `Text` и другие элементы для описания дизайна из `@open-pencil/design-jsx`, а узлы создавайте через `renderTree` или `renderJSX` из `@open-pencil/core/design-jsx`: они добавляют значки, преобразование SVG и компоновку. Чтобы писать такие деревья в TSX, укажите в `tsconfig.json` `"jsxImportSource": "@open-pencil/design-jsx"` вместе с `"jsx": "react-jsx"` или добавьте в файл комментарий `/** @jsxImportSource @open-pencil/design-jsx */`. Для обратного преобразования используйте команду `export` — подробнее в разделе [Экспорт дизайна в JSX](./cli/exporting).## Элементы@@ -95,7 +95,7 @@ openpencil export design.fig -f jsx # Формат OpenPencilopenpencil export design.fig -f jsx --style tailwind # Классы Tailwind```-Экспортированный дизайн можно изменить как код и снова отрисовать.+Экспортированный дизайн можно изменить как код и снова отрисовать. Экспорт записывает скрытые и заблокированные слои, ограничения, ограничения размеров, многослойные, градиентные и изображённые заливки, обводки, эффекты, маски и привязки переменных, поэтому при повторной отрисовке они воспроизводятся, а `diff_jsx` показывает изменения любого из них. Форматированный текст со смешанными стилями, векторные контуры, сетки компоновки, общие стили и определения свойств компонентов пока не записываются. Экземпляры записываются как фреймы со своим содержимым, поэтому экспортированный JSX самодостаточен.## Сравнение измененийdiff --git a/packages/docs/ru/programmable/sdk/api/composables/use-export.md b/packages/docs/ru/programmable/sdk/api/composables/use-export.mdindex e2e6dd241..5fc3af746 100644--- a/packages/docs/ru/programmable/sdk/api/composables/use-export.md+++ b/packages/docs/ru/programmable/sdk/api/composables/use-export.md@@ -12,7 +12,7 @@ description: Управление настройками экспорта — м- настройки экспорта;- ID выбранных объектов;- имя экспортируемого файла;-- доступные масштабы и форматы.+- доступные масштабы и форматы (идентификаторы `formats` и подписанные `formatOptions`).## Использование@@ -30,6 +30,7 @@ const {nodeName,scales,formats,+ formatOptions,addSetting,updateScale,updateFormat,diff --git a/packages/docs/ru/user-guide/canvas-navigation.md b/packages/docs/ru/user-guide/canvas-navigation.mdindex d0bbcc74e..6134fe399 100644--- a/packages/docs/ru/user-guide/canvas-navigation.md+++ b/packages/docs/ru/user-guide/canvas-navigation.md@@ -43,6 +43,12 @@ description: Перемещение по документу, изменение| Вписать документ | <kbd>⌘</kbd><kbd>1</kbd> | <kbd>Ctrl</kbd> + <kbd>1</kbd> || Масштаб по выделению | <kbd>⌘</kbd><kbd>2</kbd> | <kbd>Ctrl</kbd> + <kbd>2</kbd> |+## Палитра команд++Нажмите <kbd>⌘</kbd><kbd>K</kbd> в macOS или <kbd>Ctrl</kbd> + <kbd>K</kbd> в Windows и Linux, чтобы искать действия редактора и приложения. Выберите результат, чтобы выполнить его; недоступные действия по-прежнему зависят от текущего выделения и состояния документа.++Палитра также переключает страницы. Пока вы ничего не ввели, она показывает страницы, которые вы недавно открывали в этой вкладке, начиная с последней, а пункт **Перейти к странице…** открывает список всех страниц. Страницу можно найти и по названию. Для страниц, на которых работают участники или агенты ИИ, указаны их имена; на панели страниц те же страницы отмечены их цветами.+## Советы- Перед масштабированием наведите указатель на область, которую хотите рассмотреть.diff --git a/packages/docs/ru/user-guide/index.md b/packages/docs/ru/user-guide/index.mdindex 0dc416359..eed820aba 100644--- a/packages/docs/ru/user-guide/index.md+++ b/packages/docs/ru/user-guide/index.md@@ -34,4 +34,5 @@ OpenPencil — локальный графический редактор с о- [Автоматическая компоновка](./auto-layout) — размещение объектов с помощью Flexbox и CSS Grid;- [Компоненты](./components) — переиспользуемые компоненты, экземпляры и переопределения;-- [Переменные](./variables) — переменные дизайна, коллекции, режимы и привязки.+- [Переменные](./variables) — переменные дизайна, коллекции, режимы и привязки;+- [Checking Designs](/user-guide/checking-designs) — панель проверки, отметки проблем на холсте и правила проверки дизайна.