add debug

* update Taskfile.tmpl.yml to include darwin run task

* add changelog line for #3417

.github/workflows/build-and-test-alpha.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       matrix:
         os: [windows-latest, macos-latest, ubuntu-latest]
-        go-version: [1.21]
+        go-version: [1.22]
 
     steps:
       - name: Checkout code
@@ -58,7 +58,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x]
+        node-version: [20.x]
 
     steps:
       - name: Checkout code
@@ -100,7 +100,7 @@ jobs:
             vanilla,
             vanilla-ts,
           ]
-        go-version: [1.21]
+        go-version: [1.22]
     steps:
       - name: Checkout
         uses: actions/checkout@v3

.github/workflows/build-and-test.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest, macos-11]
-        go-version: ['1.20']
+        go-version: ['1.22']
 
     steps:
       - name: Checkout code
@@ -47,7 +47,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [20.x]
 
     steps:
       - name: Checkout code
@@ -90,7 +90,7 @@ jobs:
             vanilla-ts,
             plain,
           ]
-        go-version: ['1.20']
+        go-version: ['1.22']
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/generate-sponsor-image.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Set Node
         uses: actions/setup-node@v2
         with:
-          node-version: 16.x
+          node-version: 20.x
 
       - name: Update Sponsors
         run: cd scripts/sponsors && chmod 755 ./generate-sponsor-image.sh && ./generate-sponsor-image.sh

.github/workflows/pr.yml

@@ -6,6 +6,15 @@ on:
     types: [submitted]
 
 jobs:
+  debug_context:
+    name: Debug Context
+    runs-on: ubuntu-latest
+    steps:
+      - name: Print GitHub Context
+        run: echo "$GITHUB_CONTEXT"
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+
   check_docs:
     name: Check Docs
     if: ${{github.repository == 'wailsapp/wails' && contains(github.head_ref,'feature/')}}
@@ -56,7 +65,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        go-version: ['1.20']
+        go-version: ['1.22']
 
     steps:
       - name: Checkout code
@@ -71,14 +80,26 @@ jobs:
         with:
           go-version: ${{ matrix.go-version }}
 
-      - name: Run tests (mac)
-        if: matrix.os == 'macos-latest'
+      - name: Run tests (mac) | v2
+        if: ${{ matrix.os == 'macos-latest' && github.base_ref == 'master' }}
         env:
           CGO_LDFLAGS: -framework UniformTypeIdentifiers -mmacosx-version-min=10.13
         working-directory: ./v2
         run: go test -v ./...
 
-      - name: Run tests (!mac)
-        if: matrix.os != 'macos-latest'
-        working-directory: ./v2
+      - name: Run tests (!mac) | v2
+        if: ${{ matrix.os != 'macos-latest' && github.base_ref == 'master' }}
+        working-directory:  ./v2
+        run: go test -v ./...
+
+      - name: Run tests (mac) | v3
+        if: ${{ matrix.os == 'macos-latest' && github.base_ref == 'v3-alpha' }}
+        env:
+          CGO_LDFLAGS: -framework UniformTypeIdentifiers -mmacosx-version-min=10.13
+        working-directory: ./v3
+        run: go test -v ./...
+
+      - name: Run tests (!mac) | v3
+        if: ${{ matrix.os != 'macos-latest' && github.base_ref == 'v3-alpha' }}
+        working-directory:  ./v3
         run: go test -v ./...

.github/workflows/sync-translated-documents.yml

@@ -15,7 +15,7 @@ jobs:
       - name: Setup Nodejs
         uses: actions/setup-node@v2
         with:
-          node-version: 18.x
+          node-version: 20.x
 
       - name: Install Task
         uses: arduino/setup-task@v1

.github/workflows/upload-source-documents.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Setup Nodejs
         uses: actions/setup-node@v2
         with:
-          node-version: 18.x
+          node-version: 20.x
 
       - name: Setup Task
         uses: arduino/setup-task@v1

mkdocs-website/docs/cy/API/application.md

@@ -0,0 +1,141 @@
+# Cais
+
+Mae'r API cais yn cynorthwyo i greu cais gan ddefnyddio fframwaith Wails.
+
+### Newydd
+
+API: `New(appOptions Options) *App`
+
+`New(appOptions Options)` yn creu cais newydd gan ddefnyddio'r opsiynau cais a ddarperir. Mae'n cymhwyso gwerthoedd rhagosodedig ar gyfer opsiynau heb eu pennu, yn eu cyfuno â'r rhai a ddarparwyd, yn eu cychwyn a'n dychwelyd enghraifft o'r cais.
+
+Os bydd gwall yn ystod y cychwyn, caiff y cais ei atal gyda'r neges gwall a ddarperir.
+
+Dylid nodi, os oes enghraifft gyffredinol o gais yn bodoli eisoes, y bydd yr enghraifft honno'n cael ei dychwelyd yn hytrach na chreu un newydd.
+
+```go title="main.go" hl_lines="6-9"
+package main
+
+import "github.com/wailsapp/wails/v3/pkg/application"
+
+func main() {
+    app := application.New(application.Options{
+        Name:        "Demo Ffenestr Gweddarlunydd",
+		// Opsiynau eraill
+    })
+
+	// Gweddill y cais
+}
+```
+
+### Cael
+
+`Get()` yn dychwelyd yr enghraifft gyffredinol o'r cais. Mae'n ddefnyddiol pan fydd angen mynediad i'r cais o wahanol rannau o'ch cod.
+
+```go
+    // Cael enghraifft o'r cais
+    app := application.Get()
+```
+
+### Galluoedd
+
+API: `Capabilities() capabilities.Capabilities`
+
+`Capabilities()` yn adfer map o'r galluoedd sydd gan y cais ar hyn o bryd. Gall y galluoedd fod ynghylch y nodweddion gwahanol y system weithredu sy'n darparu, fel nodweddion gweddarlunydd.
+
+```go
+    // Cael galluoedd y cais
+    capabilities := app.Capabilities()
+	if capabilities.HasNativeDrag {
+		// Gwneud rhywbeth
+    }
+```
+
+### GetPID
+
+API: `GetPID() int`
+
+`GetPID()` yn dychwelyd ID y Broses y cais.
+
+```go
+    pid := app.GetPID()
+```
+
+### Rhedeg
+
+API: `Run() error`
+
+`Run()` yn dechrau gweithredu'r cais a'i gydrannau.
+
+```go
+    app := application.New(application.Options{
+	    //options
+	})
+    // Rhedeg y cais
+    err := application.Run()
+    if err != nil {
+        // Ymdrin â'r gwall
+    }
+```
+
+### Gadael
+
+API: `Quit()`
+
+`Quit()` yn gadael y cais trwy ddinistrio ffenestri a rhai cydrannau eraill o bosibl.
+
+```go
+    // Gadael y cais
+    app.Quit()
+```
+
+### AydunDdyryslyd
+
+API: `IsDarkMode() bool`
+
+`IsDarkMode()` yn gwirio a yw'r cais yn rhedeg mewn modd tywyll. Mae'n dychwelyd gwerth boolean yn nodi a yw'r modd tywyll wedi'i alluogi.
+
+```go
+    // Gwiriwch a yw'r modd tywyll wedi'i alluogi
+    if app.IsDarkMode() {
+        // Gwneud rhywbeth
+    }
+```
+
+### Cuddio
+
+API: `Hide()`
+
+`Hide()` yn cuddio ffenestr y cais.
+
+```go
+    // Cuddio ffenestr y cais
+    app.Hide()
+```
+
+### Dangos
+
+API: `Show()`
+
+`Show()` yn dangos ffenestr y cais.
+
+```go
+    // Dangos ffenestr y cais
+    app.Show()
+```
+
+--8<--
+./docs/cy/API/application_window.md
+./docs/cy/API/application_menu.md
+./docs/cy/API/application_dialogs.md
+./docs/cy/API/application_events.md
+./docs/cy/API/application_screens.md
+--8<--
+
+
+## Opsiynau
+
+```go title="pkg/application/application_options.go"
+--8<--
+../v3/pkg/application/application_options.go
+--8<--
+```

mkdocs-website/docs/cy/API/application_dialogs.md

@@ -0,0 +1,67 @@
+### Dangos Deialog Ynghylch
+
+API: `ShowAboutDialog()`
+
+Mae `ShowAboutDialog()` yn dangos blwch deialog "Ynghylch". Gall ddangos enw'r
+cymhwysiad, disgrifiad ac eicon.
+
+```go
+    // Dangos y deialog ynghylch
+    app.ShowAboutDialog()
+```
+
+### Gwybodaeth
+
+API: `InfoDialog()`
+
+Mae `InfoDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog` gyda
+`InfoDialogType`. Defnyddir y deialog hon fel arfer i ddangos negeseuon
+gwybodaeth i'r defnyddiwr.
+
+### Cwestiwn
+
+API: `QuestionDialog()`
+
+Mae `QuestionDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog`
+gyda `QuestionDialogType`. Defnyddir y deialog hon yn aml i ofyn cwestiwn i'r
+defnyddiwr a disgwyl ymateb.
+
+### Rhybudd
+
+API: `WarningDialog()`
+
+Mae `WarningDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog`
+gyda `WarningDialogType`. Fel y mae'r enw yn awgrymu, defnyddir y deialog hon yn
+bennaf i ddangos negeseuon rhybudd i'r defnyddiwr.
+
+### Gwall
+
+API: `ErrorDialog()`
+
+Mae `ErrorDialog()` yn creu ac yn dychwelyd esiampl newydd o `MessageDialog` gyda
+`ErrorDialogType`. Cynlluniwyd y deialog hon i'w defnyddio pan fydd angen
+dangos neges gwall i'r defnyddiwr.
+
+### Agor Ffeil
+
+API: `OpenFileDialog()`
+
+Mae `OpenFileDialog()` yn creu ac yn dychwelyd esiampl newydd o
+`OpenFileDialogStruct`. Mae'r deialog hon yn annog y defnyddiwr i ddewis un neu
+ragor o ffeiliau o'u system ffeiliau.
+
+### Cadw Ffeil
+
+API: `SaveFileDialog()`
+
+Mae `SaveFileDialog()` yn creu ac yn dychwelyd esiampl newydd o
+`SaveFileDialogStruct`. Mae'r deialog hon yn annog y defnyddiwr i ddewis lleoliad
+yn eu system ffeiliau lle y dylid cadw ffeil.
+
+### Agor Cyfeiriadur
+
+API: `OpenDirectoryDialog()`
+
+Mae `OpenDirectoryDialog()` yn creu ac yn dychwelyd esiampl newydd o
+`MessageDialog` gyda `OpenDirectoryDialogType`. Mae'r deialog hon yn galluogi'r
+defnyddiwr i ddewis cyfeiriadur o'u system ffeiliau.

mkdocs-website/docs/cy/API/application_events.md

@@ -0,0 +1,13 @@
+### Ar
+
+API:
+`Ar(eventType digwyddiadau.DdigwyddiadweithgangeningApplicationEventType, atebydd func(digwyddiad *Digwyddiad)) func()`
+
+Mae `Ar()` yn cofrestru gwrandäwr digwyddiad ar gyfer digwyddiadau cymhwysiad penodol. Bydd y swyddogaeth atebydd a ddarperir yn cael ei sbarduno pan fydd y digwyddiad cysylltiedig yn digwydd. Mae'r swyddogaeth yn dychwelyd swyddogaeth y gellir ei galw i dynnu'r gwrandäwr.
+
+### CofrestruArgraffwyr
+
+API: 
+`CofrestruArgraffwyr(eventType digwyddiadau.DdigwyddiadweithgangeningApplicationEventType, atebydd func(digwyddiad *Digwyddiad)) func()`
+
+Mae `CofrestruArgraffwyr()` yn cofrestru atebydd i'w redeg fel crocen yn ystod digwyddiadau penodol. Caiff y crocenau hyn eu rhedeg cyn gwrandawyr sy'n gysylltiedig ag `Ar()`. Mae'r swyddogaeth yn dychwelyd swyddogaeth y gellir ei galw i dynnu'r bâs.

mkdocs-website/docs/cy/API/application_menu.md

@@ -0,0 +1,27 @@
+### RegisterContextMenu
+
+API: `RegisterContextMenu(name string, menu *Menu)`
+
+Mae `RegisterContextMenu()` yn cofrestru dewislen cyd-destun gyda enw penodol. Gellir defnyddio'r dewislen hon yn ddiweddarach yn yr ap.
+
+```go
+    // Creu dewislen newydd
+    ctxmenu := app.NewMenu()
+
+    // Cofrestru'r dewislen fel dewislen cyd-destun
+    app.RegisterContextMenu("MyContextMenu", ctxmenu)
+```
+
+### SetMenu
+
+API: `SetMenu(menu *Menu)`
+
+Mae `SetMenu()` yn gosod y ddewislen ar gyfer yr ap. Ar Mac, bydd hyn yn fod y ddewislen fyd-eang. Ar gyfer Windows a Linux, bydd hyn yn fod y ddewislen ddiofyn ar gyfer unrhyw ffenestr newydd a grëir.
+
+```go
+    // Creu dewislen newydd
+    menu := app.NewMenu()
+
+    // Gosod y ddewislen ar gyfer yr ap
+    app.SetMenu(menu)
+```

mkdocs-website/docs/cy/API/application_screens.md

@@ -0,0 +1,13 @@
+### GetPrimaryScreen
+
+API: `GetPrimaryScreen() (*Sgrin, error)`
+
+Mae `GetPrimaryScreen()` yn dychwelyd y sgrin brif y system.
+
+### GetScreens
+
+API: `GetScreens() ([]*Sgrin, error)`
+
+Mae `GetScreens()` yn dychwelyd gwybodaeth am bob sgrin sydd wedi'i chysylltu â'r system.
+
+Dyma grynodeb byr o'r dulliau allforio yn y `App` strwythur a ddarparwyd. Cofiwch, ar gyfer mwy o swyddogaethau neu ystyriaethau manwl, cyfeiriwch at y cod Go gwirioneddol neu ddogfennaeth fewnol bellach.

mkdocs-website/docs/cy/API/application_window.md

@@ -0,0 +1,64 @@
+Dyma'r testun wedi'i gyfieithu i'r Gymraeg:
+
+### NewWebviewWindow
+
+API: `NewWebviewWindow() *WebviewWindow`
+
+Mae `NewWebviewWindow()` yn creu ffenestr Webview newydd gyda'r opsiynau rhagosodedig, ac yn ei dychwelyd.
+
+```go
+    // Creu ffenestr webview newydd
+    window := app.NewWebviewWindow()
+```
+
+### NewWebviewWindowWithOptions
+
+API:
+`NewWebviewWindowWithOptions(windowOptions WebviewWindowOptions) *WebviewWindow`
+
+Mae `NewWebviewWindowWithOptions()` yn creu ffenestr webview newydd gydag opsiynau custom. Caiff y ffenestr newydd ei ychwanegu at fap o ffenestri a reolir gan y cymhwysiad.
+
+```go
+    // Creu ffenestr webview newydd gydag opsiynau custom
+    window := app.NewWebviewWindowWithOptions(WebviewWindowOptions{
+		Name: "Main",
+        Title: "Fy Ffenestr",
+        Width: 800,
+        Height: 600,
+    })
+```
+
+### OnWindowCreation
+
+API: `OnWindowCreation(callback func(window *WebviewWindow))`
+
+Mae `OnWindowCreation()` yn cofrestru ffwythiant alw-nôl i'w alw pan grëir ffenestr.
+
+```go
+    // Cofrestru ffwythiant alw-nôl i'w alw pan grëir ffenestr
+    app.OnWindowCreation(func(window *WebviewWindow) {
+        // Gwneud rhywbeth
+    })
+```
+
+### GetWindowByName
+
+API: `GetWindowByName(name string) *WebviewWindow`
+
+Mae `GetWindowByName()` yn nôl ac yn dychwelyd ffenestr gyda enw penodol.
+
+```go
+    // Cael ffenestr drwy ei henw
+    window := app.GetWindowByName("Main")
+```
+
+### CurrentWindow
+
+API: `CurrentWindow() *WebviewWindow`
+
+Mae `CurrentWindow()` yn nôl ac yn dychwelyd cyfeiriad at y ffenestr weithredol yn y cymhwysiad. Os nad oes ffenestr, mae'n dychwelyd nil.
+
+```go
+    // Cael y ffenestr gyfredol
+    window := app.CurrentWindow()
+```

mkdocs-website/docs/cy/API/mainthread.md

@@ -0,0 +1,50 @@
+# Prif Swyddogaethau Trywydd
+
+Mae'r dulliau hyn yn swyddogaethau cymorth i redeg cod ar y prif drywydd. Mae hyn yn
+ofynnol pan fyddwch am redeg cod cyfaddas ar y llwyfan UI.
+
+### InvokeSync
+
+API: `InvokeSync(fn func())`
+
+Mae'r swyddogaeth hon yn rhedeg y swyddogaeth a drosglwyddwyd (`fn`) yn ddilynebol. Mae'n defnyddio WaitGroup
+(`wg`) i sicrhau bod y prif drywydd yn aros i `fn` swyddogaeth orffen
+cyn iddo barhau. Os bydd panig yn digwydd o fewn `fn`, bydd yn cael ei drosglwyddo i'r
+swyddogaeth trin panig `PanicHandler`, a ddiffinnir yn opsiynau'r cymhwysiad.
+
+### InvokeSyncWithResult
+
+API: `InvokeSyncWithResult[T any](fn func() T) (res T)`
+
+Mae'r swyddogaeth hon yn gweithio'n debyg i `InvokeSync(fn func())`, fodd bynnag, mae'n rhoi
+canlyniad. Defnyddiwch hyn ar gyfer galw unrhyw swyddogaeth gyda un canlyniad yn unig.
+
+### InvokeSyncWithError
+
+API: `InvokeSyncWithError(fn func() error) (err error)`
+
+Mae'r swyddogaeth hon yn rhedeg `fn` yn ddilynebol ac yn dychwelyd unrhyw wall a gynhyrchir gan `fn`.
+Sylwch y bydd y swyddogaeth hon yn adfer o banig os bydd un yn digwydd yn ystod
+gweithrediad `fn`.
+
+### InvokeSyncWithResultAndError
+
+API:
+`InvokeSyncWithResultAndError[T any](fn func() (T, error)) (res T, err error)`
+
+Mae'r swyddogaeth hon yn rhedeg `fn` yn ddilynebol ac yn dychwelyd canlyniad o fath `T` a
+gwall.
+
+### InvokeAsync
+
+API: `InvokeAsync(fn func())`
+
+Mae'r swyddogaeth hon yn rhedeg `fn` yn asyng. Mae'n rhedeg y swyddogaeth a roddir ar y
+prif drywydd. Os bydd panig yn digwydd o fewn `fn`, bydd yn cael ei drosglwyddo i'r
+swyddogaeth trin panig `PanicHandler`, a ddiffinnir yn opsiynau'r cymhwysiad.
+
+---
+
+_Sylw_: Bydd y swyddogaethau hyn yn rhwystro gweithrediad nes bod `fn` wedi gorffen. Mae'n
+hanfodol sicrhau nad yw `fn` yn rhwystro. Os bydd angen i chi redeg swyddogaeth sy'n
+rhwystro, defnyddiwch `InvokeAsync` yn lle.

mkdocs-website/docs/cy/API/menu.md

@@ -0,0 +1,73 @@
+# Dewislen
+
+Gellir creu a chynnwys dewislenni yn y rhaglen. Gellir eu defnyddio i greu
+dewislenni cyd-destun, dwylo system a dewislenni rhaglen.
+
+I greu dewislen newydd, galwch:
+
+```go
+    // Creu dewislen newydd
+    dewislen := app.NewMenu()
+```
+
+Mae'r gweithrediadau canlynol ar gael ar y `Dewislen` math:
+
+### Ychwanegu
+
+API: `Ychwanegu(label string) *EitemDewislen`
+
+Mae'r dull hwn yn cymryd `label` o fath `string` fel mewnbwn ac yn ychwanegu
+`EitemDewislen` newydd gyda'r label a roddir at y ddewislen. Mae'n dychwelyd yr
+`EitemDewislen` a ychwanegwyd.
+
+### YchwaneguSeparwr
+
+API: `YchwaneguSeparwr()`
+
+Mae'r dull hwn yn ychwanegu `EitemDewislen` gwahanol newydd at y ddewislen.
+
+### YchwaneguBlwch
+
+API: `YchwaneguBlwch(label string, galluogedig bool) *EitemDewislen`
+
+Mae'r dull hwn yn cymryd `label` o fath `string` a `galluogedig` o fath `bool`
+fel mewnbwn ac yn ychwanegu `EitemDewislen` blwch ticio newydd gyda'r label a'r
+cyflwr galluogedig a roddir at y ddewislen. Mae'n dychwelyd yr `EitemDewislen`
+a ychwanegwyd.
+
+### YchwaneguRadio
+
+API: `YchwaneguRadio(label string, galluogedig bool) *EitemDewislen`
+
+Mae'r dull hwn yn cymryd `label` o fath `string` a `galluogedig` o fath `bool`
+fel mewnbwn ac yn ychwanegu `EitemDewislen` radio newydd gyda'r label a'r
+cyflwr galluogedig a roddir at y ddewislen. Mae'n dychwelyd yr `EitemDewislen`
+a ychwanegwyd.
+
+### Diweddaru
+
+API: `Diweddaru()`
+
+Mae'r dull hwn yn prosesu unrhyw grwpiau radio ac yn diweddaru'r ddewislen os
+na chaiff y rhyngwyneb dewislen ei gychwyn.
+
+### YchwaneguIsddewislen
+
+API: `YchwaneguIsddewislen(s string) *Dewislen`
+
+Mae'r dull hwn yn cymryd `s` o fath `string` fel mewnbwn ac yn ychwanegu
+`EitemDewislen` isddewislen newydd gyda'r label a roddir at y ddewislen. Mae'n
+dychwelyd yr isddewislen a ychwanegwyd.
+
+### YchwaneguRôl
+
+API: `YchwaneguRôl(rôl Rôl) *Dewislen`
+
+Mae'r dull hwn yn cymryd `rôl` o fath `Rôl` fel mewnbwn, yn ei ychwanegu at y
+ddewislen os nad yw'n `nil` ac yn dychwelyd y `Dewislen`.
+
+### SetLabel
+
+API: `SetLabel(label string)`
+
+Mae'r dull hwn yn gosod `label` y `Dewislen`.

mkdocs-website/docs/cy/API/systray.md

@@ -0,0 +1,104 @@
+# Ardal Hysbysu
+
+Mae'r ardal hysbysu yn cynnwys ardal hysbysu ar amgylchedd bwrdd gwaith, a all
+gynnwys eiconau o'r rhaglenni sy'n rhedeg ar hyn o bryd a hysbysiadau system
+penodol.
+
+Rydych yn creu ardal hysbysu trwy alw `app.NewSystemTray()`:
+
+```go
+    // Creu ardal hysbysu newydd
+tray := app.NewSystemTray()
+```
+
+Mae'r dulliau canlynol ar gael ar y `SystemTray` math:
+
+### SetLabel
+
+API: `SetLabel(label string)`
+
+Mae'r dull `SetLabel` yn gosod label yr ardal hysbysu.
+
+### Label
+
+API: `Label() string`
+
+Mae'r dull `Label` yn adfer label yr ardal hysbysu.
+
+### PositionWindow
+
+API: `PositionWindow(*WebviewWindow, offset int) error`
+
+Mae'r dull `PositionWindow` yn galw'r dulliau `AttachWindow` a `WindowOffset`.
+
+### SetIcon
+
+API: `SetIcon(icon []byte) *SystemTray`
+
+Mae'r dull `SetIcon` yn gosod eicon yr ardal hysbysu system.
+
+### SetDarkModeIcon
+
+API: `SetDarkModeIcon(icon []byte) *SystemTray`
+
+Mae'r dull `SetDarkModeIcon` yn gosod eicon yr ardal hysbysu system pan mewn modd tywyll.
+
+### SetMenu
+
+API: `SetMenu(menu *Menu) *SystemTray`
+
+Mae'r dull `SetMenu` yn gosod dewislen yr ardal hysbysu.
+
+### Destroy
+
+API: `Destroy()`
+
+Mae'r dull `Destroy` yn dinistrio'r enghraifft ardal hysbysu.
+
+### OnClick
+
+API: `OnClick(handler func()) *SystemTray`
+
+Mae'r dull `OnClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio.
+
+### OnRightClick
+
+API: `OnRightClick(handler func()) *SystemTray`
+
+Mae'r dull `OnRightClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio â'r dde.
+
+### OnDoubleClick
+
+API: `OnDoubleClick(handler func()) *SystemTray`
+
+Mae'r dull `OnDoubleClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio ddwywaith.
+
+### OnRightDoubleClick
+
+API: `OnRightDoubleClick(handler func()) *SystemTray`
+
+Mae'r dull `OnRightDoubleClick` yn gosod y swyddogaeth i'w gweithredu pan fo'r eicon ardal hysbysu wedi'i glicio ddwywaith â'r dde.
+
+### AttachWindow
+
+API: `AttachWindow(window *WebviewWindow) *SystemTray`
+
+Mae'r dull `AttachWindow` yn atodi ffenestr i'r ardal hysbysu system. Bydd y ffenestr yn cael ei dangos pan fo'r eicon ardal hysbysu wedi'i glicio.
+
+### WindowOffset
+
+API: `WindowOffset(offset int) *SystemTray`
+
+Mae'r dull `WindowOffset` yn gosod y bwlch mewn picselau rhwng yr ardal hysbysu system a'r ffenestr.
+
+### WindowDebounce
+
+API: `WindowDebounce(debounce time.Duration) *SystemTray`
+
+Mae'r dull `WindowDebounce` yn gosod amser diddymu. Yng nghyd-destun Windows, defnyddir hyn i bennu faint o amser i aros cyn ymateb i ddigwyddiad clic llygoden i fyny ar yr eicon hysbysu.
+
+### OpenMenu
+
+API: `OpenMenu()`
+
+Mae'r dull `OpenMenu` yn agor y ddewislen sy'n gysylltiedig â'r ardal hysbysu system.

mkdocs-website/docs/cy/API/window.md

@@ -0,0 +1,116 @@
+# Ffenestr
+
+I greu ffenestr, defnyddiwch
+[Application.NewWebviewWindow](application.md#newwebviewwindow) neu
+[Application.NewWebviewWindowWithOptions](application.md#newwebviewwindowwithoptions).
+Mae'r cyntaf yn creu ffenestr gyda nodweddion rhagosodedig, tra bod yr olaf yn
+caniatáu i chi bennu opsiynau wedi'u haddasu.
+
+Mae'r dulliau hyn yn galladwy ar y gwrthrych WebviewWindow a ddychwelir:
+
+### SetTitle
+
+API: `SetTitle(teitl string) *WebviewWindow`
+
+Mae'r dull hwn yn diweddaru teitl y ffenestr i'r llinyn a ddarperir. Mae'n dychwelyd
+y gwrthrych WebviewWindow, gan ganiatáu i ddulliau gael eu cadwyn.
+
+### Enw
+
+API: `Enw() string`
+
+Mae'r swyddogaeth hon yn dychwelyd enw'r WebviewWindow.
+
+### SetSize
+
+API: `SetSize(lled, uchder int) *WebviewWindow`
+
+Mae'r dull hwn yn gosod maint y WebviewWindow i'r lled a'r uchder a ddarperir. Os
+yw'r dimensiynau a ddarparwyd yn rhagori ar y cyfyngiadau, mae'n eu haddasu'n briodol.
+
+### SetAlwaysOnTop
+
+API: `SetAlwaysOnTop(b bool) *WebviewWindow`
+
+Mae'r swyddogaeth hon yn gosod y ffenestr i aros ar y brig yn seiliedig ar y blaen
+llinyn a ddarperir.
+
+### Dangos
+
+API: `Dangos() *WebviewWindow`
+
+Mae'r dull `Dangos` yn cael ei ddefnyddio i wneud y ffenestr yn weladwy. Os
+nad yw'r ffenestr yn rhedeg, mae'n gwahodd y dull `rhedeg` i ddechrau'r ffenestr
+ac yna'n ei gwneud yn weladwy.
+
+### Cuddio
+
+API: `Cuddio() *WebviewWindow`
+
+Mae'r dull `Cuddio` yn cael ei ddefnyddio i guddio'r ffenestr. Mae'n gosod y
+statws cudd o'r ffenestr i wir ac yn lledu'r digwyddiad cuddio ffenestr.
+
+### SetURL
+
+API: `SetURL(s string) *WebviewWindow`
+
+Mae'r dull `SetURL` yn cael ei ddefnyddio i osod URL y ffenestr i'r llinyn URL a ddarparwyd.
+
+### SetZoom
+
+API: `SetZoom(mewnosod float64) *WebviewWindow`
+
+Mae'r dull `SetZoom` yn gosod lefel swm cynnwys y ffenestr i'r lefel mewnosod a ddarparwyd.
+
+### GetZoom
+
+API: `GetZoom() float64`
+
+Mae'r swyddogaeth `GetZoom` yn dychwelyd y lefel swm bresennol o gynnwys y ffenestr.
+
+### GetScreen
+
+API: `GetScreen() (*Screen, error)`
+
+Mae'r dull `GetScreen` yn dychwelyd y sgrin lle mae'r ffenestr yn cael ei harddangos.
+
+### SetFrameless
+
+API: `SetFrameless(frameless bool) *WebviewWindow`
+
+Mae'r swyddogaeth hon yn cael ei defnyddio i dynnu'r ffrâm a bar teitl y ffenestr.
+Mae'n toglo'r framelessness o'r ffenestr yn unol â'r gwerth boolean a ddarperir
+(gwir ar gyfer frameless, ffug ar gyfer ffrâm).
+
+### RegisterContextMenu
+
+API: `RegisterContextMenu(enw string, dewislen *Dewislen)`
+
+Mae'r swyddogaeth hon yn cael ei defnyddio i gofrestru dewislen cyd-destun ac
+yn ei neilltuo i'r enw a ddarparwyd.
+
+### NativeWindowHandle
+
+API: `NativeWindowHandle() (uintptr, error)`
+
+Mae'r swyddogaeth hon yn cael ei defnyddio i nodi'r handlen ffenestr brodorol
+ar gyfer y ffenestr.
+
+### Ffocws
+
+API: `Ffocws()`
+
+Mae'r swyddogaeth hon yn cael ei defnyddio i ffocysu'r ffenestr.
+
+### SetEnabled
+
+API: `SetEnabled(galluogwyd bool)`
+
+Mae'r swyddogaeth hon yn cael ei defnyddio i alluogi/analluogi'r ffenestr yn
+seiliedig ar y gwerth boolean a ddarperir.
+
+### SetAbsolutePosition
+
+API: `SetAbsolutePosition(x int, y int)`
+
+Mae'r swyddogaeth hon yn gosod y safle absoliwt o'r ffenestr yn y sgrin.

mkdocs-website/docs/cy/changelog.md

@@ -0,0 +1,55 @@
+# Croniclau
+
+<!--
+Bydd pob newid sylweddol i'r prosiect hwn yn cael ei ddogfennu yn y ffeil hon.
+
+Mae'r fformat yn seiliedig ar [Cadw Croniclau](https://keepachangelog.com/en/1.0.0/),
+ac mae'r prosiect hwn yn cydymffurfio â [Fersiwneiddio Semantig](https://semver.org/spec/v2.0.0.html).
+
+- `Ychwanegwyd` ar gyfer nodweddion newydd.
+- `Newidiwyd` ar gyfer newidiadau mewn swyddogaeth bresennol.
+- `Wedi Dibrisio` ar gyfer nodweddion a fydd yn cael eu dileu yn fuan.
+- `Tynnwyd` ar gyfer nodweddion a gafodd eu tynnu yn awr.
+- `Wedi Trwsio` ar gyfer unrhyw ddatrysiadau grwydro.
+- `Diogelwch` os oes agoreiddiadau diamddiffyn.
+
+-->
+
+## [Heb ei ryddhau]
+
+### Ychwanegwyd
+- [darwin] ychwanegu Digwyddiad ApplicationShouldHandleReopen i fedru ymdrin â chlicio ar yr eicon doc gan @5aaee9 yn [#2991](https://github.com/wailsapp/wails/pull/2991)
+- [darwin] ychwanegu getPrimaryScreen/getScreens i impl gan @tmclane yn [#2618](https://github.com/wailsapp/wails/pull/2618)
+- [darwin] ychwanegu opsiwn ar gyfer dangos y bar offer mewn modd sgrin llawn ar macOS gan [@fbbdev](https://github.com/fbbdev) yn [#3282](https://github.com/wailsapp/wails/pull/3282)
+- [linux] ychwanegu rhesymeg onKeyPress i drosi allwedd linux i gyflymydd gan @[Atterpac](https://github.com/Atterpac) yn [#3022](https://github.com/wailsapp/wails/pull/3022])
+- [linux] ychwanegu tasg `rhedeg:linux` gan [@marcus-crane](https://github.com/marcus-crane) yn [#3146](https://github.com/wailsapp/wails/pull/3146)
+- allforio dull `SetIcon` gan @almas1992 yn [PR](https://github.com/wailsapp/wails/pull/3147)
+- Gwella `OnShutdown` gan @almas1992 yn [PR](https://github.com/wailsapp/wails/pull/3189)
+- adfer dull `ToggleMaximise` yn y rhyngwyneb `Window` gan [@fbbdev](https://github.com/fbbdev) yn [#3281](https://github.com/wailsapp/wails/pull/3281)
+
+### Wedi Trwsio
+
+- Wedi trwsio prosesau zombie wrth weithio mewn modd datblygu drwy ddiweddaru i'r diweddaraf gan [Atterpac](https://github.com/atterpac) yn [#3320](https://github.com/wailsapp/wails/pull/3320).
+- Wedi trwsio ffynhonnell ffeil webkit appimage gan [Atterpac](https://github.com/atterpac) yn [#3306](https://github.com/wailsapp/wails/pull/3306).
+- Wedi trwsio Doctor fygythiad pecyn apt gan [Atterpac](https://github.com/Atterpac) yn [#2972](https://github.com/wailsapp/wails/pull/2972).
+- Wedi trwsio'r cais wedi rhewi wrth ddod allan (Darwin) gan @5aaee9 yn [#2982](https://github.com/wailsapp/wails/pull/2982)
+- Wedi trwsio lliwiau cefndir yr enghreifftiau ar Windows gan [mmgvh](https://github.com/mmghv) yn [#2750](https://github.com/wailsapp/wails/pull/2750).
+- Wedi trwsio dewislenni cyd-destun rhagosodedig gan [mmgvh](https://github.com/mmghv) yn [#2753](https://github.com/wailsapp/wails/pull/2753).
+- Wedi trwsio gwerth hecsadegol ar gyfer bysellau saeth ar Darwin gan [jaybeecave](https://github.com/jaybeecave) yn [#3052](https://github.com/wailsapp/wails/pull/3052).
+- Gosod llusgo-a-gollwng ar gyfer Windows i weithio. Ychwanegwyd gan [@pylotlight](https://github.com/pylotlight) yn [PR](https://github.com/wailsapp/wails/pull/3039)
+- Wedi trwsio bygiau ar gyfer linux yn y meddyg os nad oes gan y defnyddiwr y gyrwyr priodol wedi'u gosod. Ychwanegwyd gan [@pylotlight](https://github.com/pylotlight) yn [PR](https://github.com/wailsapp/wails/pull/3032)
+- Trwsio graddio dpi wrth gychwyn (windows). Newidiwyd gan @almas1992 yn [PR](https://github.com/wailsapp/wails/pull/3145)
+- Trwsio'r llinell amnewid yn `go.mod` i ddefnyddio llwybrau cymharol - Trwsio llwybrau Windows gyda gofodau gan @leaanthony.
+- Trwsio gweithredu clicio Maclanwad system wrth ddim cysylltiedig â ffenestr gan [thomas-senechal](https://github.com/thomas-senechal) yn PR [#3207](https://github.com/wailsapp/wails/pull/3207)
+- Trwsio adeiladu Windows yn methu oherwydd opsiwn anhysbys gan [thomas-senechal](https://github.com/thomas-senechal) yn PR [#3208](https://github.com/wailsapp/wails/pull/3208)
+- Trwsio URL sylfaenol anghywir wrth agor ffenestr ddwywaith gan @5aaee9 yn PR [#3273](https://github.com/wailsapp/wails/pull/3273)
+- Trwsio trefn brigiau os yn y dull `WebviewWindow.Restore` gan [@fbbdev](https://github.com/fbbdev) yn [#3279](https://github.com/wailsapp/wails/pull/3279)
+- Cyfrifo `startURL` yn gywir ar draws galwadau lluosog `GetStartURL` pan fo `FRONTEND_DEVSERVER_URL` yn bresennol. [#3299](https://github.com/wailsapp/wails/pull/3299)
+
+### Newidiwyd
+
+### Tynnwyd
+
+### Wedi Dibrisio
+
+### Diogelwch

mkdocs-website/docs/cy/development/changes.md

@@ -0,0 +1,20 @@
+# Newidiadau ar gyfer v3
+
+!!! note 
+    Mae hwn ar hyn o bryd yn ddampio meddwl heb ei drefnu o newidiadau. Bydd yn cael ei drefnu i fformat mwy darllenadwy yn fuan.
+
+--8<--
+./docs/en/development/changes_events.md
+./docs/en/development/changes_window.md
+./docs/en/development/changes_systray.md
+./docs/en/development/changes_bindings.md
+./docs/en/development/changes_dragndrop.md
+./docs/en/development/changes_context_menus.md
+./docs/en/development/changes_dialogs.md
+./docs/en/development/changes_clipboard.md
+./docs/en/development/changes_wml.md
+./docs/en/development/changes_plugins.md
+./docs/en/development/changes_enums.md
+./docs/en/development/changes_logging.md
+./docs/en/development/changes_misc.md
+--8<--

mkdocs-website/docs/cy/development/changes_bindings.md

@@ -0,0 +1,87 @@
+Dyma'r cyfieithiad i'r gymraeg:
+
+## Rhwymedigaethau
+
+Mae rhwymedigaethau yn gweithio mewn modd tebyg i v2, drwy ddarparu ffordd i rwymo
+dulliau strwythur i'r rhyngwyneb blaen. Gellir eu galw yn y rhyngwyneb blaen gan
+ddefnyddio'r wraperi rhwymedigaeth a gynhyrchwyd gan y gorchymyn `wails3 generate bindings`:
+
+```javascript
+// @ts-check
+// Mae'r ffeil hon wedi'i chynhyrchu'n awtomatig. PEIDIWCH Â'I GOLYGU
+
+import { main } from "./models";
+
+window.go = window.go || {};
+window.go.main = {
+  GreetService: {
+    /**
+     * GreetService.Greet
+     * Mae Greet yn cyfarch rhywun
+     * @param name {string}
+     * @returns {Promise<string>}
+     **/
+    Greet: function (name) {
+      wails.CallByID(1411160069, ...Array.prototype.slice.call(arguments, 0));
+    },
+
+    /**
+     * GreetService.GreetPerson
+     * Mae GreetPerson yn cyfarch rhywun
+     * @param person {main.Person}
+     * @returns {Promise<string>}
+     **/
+    GreetPerson: function (person) {
+      wails.CallByID(4021313248, ...Array.prototype.slice.call(arguments, 0));
+    },
+  },
+};
+```
+
+Mae dulliau rhwymo wedi'u cuddio'n ddiofyn, ac maent yn cael eu hadnabod gan IDs uint32,
+a gyfrifir gan ddefnyddio'r [algorithm hasio FNV](https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function).
+Mae hyn er mwyn atal enw'r dull rhag cael ei ddatgelu mewn adeiladau cynhyrchiol. Mewn
+modd dadfygio, mae'r IDs dull yn cael eu logio ynghyd â'r ID a gyfrifwyd o'r dull
+i helpu i ddadfygio. Os ydych chi am ychwanegu haen arall o guddio, gallwch
+ddefnyddio'r opsiwn `BindAliases`. Mae hyn yn caniatáu ichi bennu map o IDs alias i
+IDs dull. Pan fydd y rhyngwyneb blaen yn galw dull gan ddefnyddio ID, bydd yr ID dull
+yn cael ei chwilio yn y map alias yn gyntaf am gywiro. Os nad yw'n ei ganfod,
+mae'n tybio mai ID dull safonol yw ac yn ceisio canfod y dull yn y ffordd arferol.
+
+Enghraifft:
+
+```go
+	app := application.New(application.Options{
+		Bind: []any{
+			&GreetService{},
+		},
+		BindAliases: map[uint32]uint32{
+			1: 1411160069,
+			2: 4021313248,
+		},
+		Assets: application.AssetOptions{
+			Handler: application.AssetFileServerFS(assets),
+		},
+		Mac: application.MacOptions{
+			ApplicationShouldTerminateAfterLastWindowClosed: true,
+		},
+	})
+```
+
+Nawr gallwn alw gan ddefnyddio'r alias hwn yn y rhyngwyneb blaen: `wails.Call(1, "byd!")`.
+
+### Galwadau anniogel
+
+Os nad ydych chi'n poeni am eich galwadau yn cael eu cyhoeddi mewn testun plaen yn eich binari
+ac nid oes gennych fwriad o ddefnyddio [garble](https://github.com/burrowers/garble), yna
+gallwch ddefnyddio'r dull `wails.CallByName()` anniogel. Mae'r dull hwn yn cymryd enw
+llawn cymhwysol y dull i'w alw a'r arguments i'w pasio iddo.
+Enghraifft:
+
+    ```go
+    wails.CallByName("main.GreetService.Greet", "byd!")
+    ```
+
+!!! angen gofal
+
+    Darperir hwn dim ond fel dull cyfleustra ar gyfer datblygu. Ni chyngherir i'w ddefnyddio mewn cynhyrchiad.

mkdocs-website/docs/cy/development/changes_clipboard.md

@@ -0,0 +1,3 @@
+## ClipBoard
+
+Mae API y clipfwrdd wedi'i symleiddio. Mae bellach un gwrthrych `Clipboard` y gellir ei ddefnyddio i ddarllen a chyflwyno i'r clipfwrdd. Mae'r gwrthrych `Clipboard` ar gael yn Go ac JS. `SetText()` i osod y testun a `Text()` i gael y testun.