From a462d8ab4f0673de3e284301f2d6d2801472ee76 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jaroslav=20Bene=C5=A1?= <admin@ecoposta.sk>
Date: Wed, 15 Jul 2026 14:18:32 +0200
Subject: [PATCH] Add plasmoid scaffold: metadata.json + config schema
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Plasma/Applet package metadata (tray applet, id sk.houmeres.synologynas)
and the KConfigXT schema (hosts JSON, mount root, SMB version, options).
Passwords are never stored in config — they live in KWallet.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 package/contents/config/config.qml | 15 ++++++++++++++
 package/contents/config/main.xml   | 33 ++++++++++++++++++++++++++++++
 package/metadata.json              | 24 ++++++++++++++++++++++
 3 files changed, 72 insertions(+)
 create mode 100644 package/contents/config/config.qml
 create mode 100644 package/contents/config/main.xml
 create mode 100644 package/metadata.json

diff --git a/package/contents/config/config.qml b/package/contents/config/config.qml
new file mode 100644
index 0000000..6ced115
--- /dev/null
+++ b/package/contents/config/config.qml
@@ -0,0 +1,15 @@
+import QtQuick
+import org.kde.plasma.configuration
+
+ConfigModel {
+    ConfigCategory {
+        name: i18n("NAS Hosts")
+        icon: "network-server"
+        source: "config/ConfigHosts.qml"
+    }
+    ConfigCategory {
+        name: i18n("General")
+        icon: "configure"
+        source: "config/ConfigGeneral.qml"
+    }
+}
diff --git a/package/contents/config/main.xml b/package/contents/config/main.xml
new file mode 100644
index 0000000..501864d
--- /dev/null
+++ b/package/contents/config/main.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<kcfg xmlns="http://www.kde.org/standards/kcfg/1.0"
+      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+      xsi:schemaLocation="http://www.kde.org/standards/kcfg/1.0
+                          http://www.kde.org/standards/kcfg/1.0/kcfg.xsd">
+    <kcfgfile name=""/>
+    <group name="General">
+        <!-- JSON array of host objects:
+             {id, label, host, username, domain, mountRoot, vers}
+             Passwords are NEVER stored here; they live in KWallet. -->
+        <entry name="hosts" type="String">
+            <default>[]</default>
+        </entry>
+        <!-- Empty => resolved at runtime to <home>/NAS -->
+        <entry name="defaultMountRoot" type="String">
+            <default></default>
+        </entry>
+        <!-- SMB dialect passed to mount.cifs (vers=). -->
+        <entry name="smbVersion" type="String">
+            <default>3.1.1</default>
+        </entry>
+        <!-- Extra comma-separated mount.cifs options. -->
+        <entry name="mountOptions" type="String">
+            <default>iocharset=utf8</default>
+        </entry>
+        <entry name="fileMode" type="String">
+            <default>0700</default>
+        </entry>
+        <entry name="dirMode" type="String">
+            <default>0700</default>
+        </entry>
+    </group>
+</kcfg>
diff --git a/package/metadata.json b/package/metadata.json
new file mode 100644
index 0000000..19d2d4c
--- /dev/null
+++ b/package/metadata.json
@@ -0,0 +1,24 @@
+{
+    "KPackageStructure": "Plasma/Applet",
+    "KPlugin": {
+        "Authors": [
+            {
+                "Name": "Houmeres"
+            }
+        ],
+        "Category": "Utilities",
+        "Description": "Browse, mount and unmount Synology / SMB (CIFS) network shares from the system tray.",
+        "EnabledByDefault": true,
+        "Icon": "folder-network",
+        "Id": "sk.houmeres.synologynas",
+        "License": "MIT",
+        "Name": "Synology NAS",
+        "Version": "0.1.0",
+        "Website": "https://git.houmeres.sk/Houmeres/Plasma-Addon-Synology-NAS"
+    },
+    "X-Plasma-API": "declarativeappletscript",
+    "X-Plasma-API-Minimum-Version": "6.0",
+    "X-Plasma-MainScript": "ui/main.qml",
+    "X-Plasma-NotificationArea": "true",
+    "X-Plasma-NotificationAreaCategory": "SystemServices"
+}