slint-ui 1.9.0-nightly.2024100903 → 1.9.0-nightly.2024101016

package/Cargo.toml

@@ -41,10 +41,10 @@ accessibility = ["slint-interpreter/accessibility"]
 [dependencies]
 napi = { version = "2.14.0", default-features = false, features = ["napi8"] }
 napi-derive = "2.14.0"
-i-slint-compiler = { features = ["default"] , git = "https://github.com/slint-ui/slint", rev = "d38d968f9b72f99ae3fb71b5c288bd4dd395aaaf", version = "=1.9.0", default-features = false }
-i-slint-core = { features = ["default"] , git = "https://github.com/slint-ui/slint", rev = "d38d968f9b72f99ae3fb71b5c288bd4dd395aaaf", version = "=1.9.0", default-features = false }
-i-slint-backend-selector = { git = "https://github.com/slint-ui/slint", rev = "d38d968f9b72f99ae3fb71b5c288bd4dd395aaaf", version = "=1.9.0", default-features = false }
-slint-interpreter = { default-features = false , features = ["display-diagnostics", "internal", "compat-1-2"] , git = "https://github.com/slint-ui/slint", rev = "d38d968f9b72f99ae3fb71b5c288bd4dd395aaaf", version = "=1.9.0"}
+i-slint-compiler = { features = ["default"] , git = "https://github.com/slint-ui/slint", rev = "ccf5f04087c5d920c80e7e706230e99a12b9e9ef", version = "=1.9.0", default-features = false }
+i-slint-core = { features = ["default", "gettext-rs"] , git = "https://github.com/slint-ui/slint", rev = "ccf5f04087c5d920c80e7e706230e99a12b9e9ef", version = "=1.9.0", default-features = false }
+i-slint-backend-selector = { git = "https://github.com/slint-ui/slint", rev = "ccf5f04087c5d920c80e7e706230e99a12b9e9ef", version = "=1.9.0", default-features = false }
+slint-interpreter = { default-features = false , features = ["display-diagnostics", "internal", "compat-1-2"] , git = "https://github.com/slint-ui/slint", rev = "ccf5f04087c5d920c80e7e706230e99a12b9e9ef", version = "=1.9.0"}
 spin_on = { version = "0.1" }
 css-color-parser2 = { version = "1.0.1" }
 itertools = { version = "0.13" }

package/README.md

@@ -57,7 +57,7 @@ Combining these two steps leads us to the obligatory "Hello World" example:
 
 ```js
 import * as slint from "slint-ui";
-let ui = slint.loadFile(".ui/main.slint");
+let ui = slint.loadFile(new URL(".ui/main.slint", import.meta.url));
 let main = new ui.Main();
 main.run();
 ```
@@ -94,7 +94,7 @@ an object which allow to initialize the value of public properties or callbacks.
 import * as slint from "slint-ui";
 // In this example, the main.slint file exports a module which
 // has a counter property and a clicked callback
-let ui = slint.loadFile("ui/main.slint");
+let ui = slint.loadFile(new URL("ui/main.slint", import.meta.url));
 let component = new ui.MainWindow({
     counter: 42,
     clicked: function() { console.log("hello"); }
@@ -135,7 +135,7 @@ The callbacks in Slint are exposed as properties in JavaScript and that can be c
 ```js
 import * as slint from "slint-ui";
 
-let ui = slint.loadFile("ui/my-component.slint");
+let ui = slint.loadFile(new URL("ui/my-component.slint", import.meta.url));
 let component = new ui.MyComponent();
 
 // connect to a callback
@@ -168,7 +168,7 @@ If the function is marked `public`, it can also be called from JavaScript.
 ```js
 import * as slint from "slint-ui";
 
-let ui = slint.loadFile("ui/my-component.slint");
+let ui = slint.loadFile(new URL("ui/my-component.slint", import.meta.url));
 let component = new ui.MyComponent();
 
 // call a public function
@@ -273,3 +273,72 @@ model.push(4); // this works
 // does NOT work, getting the model does not return the right object
 // component.model.push(5);
 ```
+
+### structs
+
+An exported struct can be created either by defing of an object literal or by using the new keyword.
+
+**`my-component.slint`**
+
+```slint
+export struct Person {
+    name: string,
+    age: int
+}
+
+export component MyComponent inherits Window {
+    in-out property <Person> person;
+}
+```
+
+**`main.js`**
+
+```js
+
+import * as slint from "slint-ui";
+
+let ui = slint.loadFile(new URL("my-component.slint", import.meta.url));
+let component = new ui.MyComponent();
+
+// object literal
+component.person = { name: "Peter", age: 22 };
+
+// new keyword (sets property values to default e.g. '' for string)
+component.person = new ui.Person();
+
+// new keyword with parameters
+component.person = new ui.Person({ name: "Tim", age: 30 });
+```
+
+### enums
+
+A value of an exported enum can be set as string or by usign the value from the exported enum.
+
+**`my-component.slint`**
+
+```slint
+export enum Position {
+    top,
+    bottom
+}
+
+export component MyComponent inherits Window {
+    in-out property <Position> position;
+}
+```
+
+**`main.js`**
+
+```js
+
+import * as slint from "slint-ui";
+
+let ui = slint.loadFile(new URL("my-component.slint", import.meta.url));
+let component = new ui.MyComponent();
+
+// set enum value as string
+component.position = "top";
+
+// use the value of the enum
+component.position = ui.Position.bottom;
+```

package/cover.md

@@ -271,6 +271,75 @@ component.model = component.model.concat(4);
 
 Another option is to set an object that implements the {@link Model} interface.
 
+### structs
+
+An exported struct can be created either by defing of an object literal or by using the new keyword.
+
+**`my-component.slint`**
+
+```
+export struct Person {
+    name: string,
+    age: int
+}
+
+export component MyComponent inherits Window {
+    in-out property <Person> person;
+}
+```
+
+**`main.js`**
+
+```js
+
+import * as slint from "slint-ui";
+
+let ui = slint.loadFile("my-component.slint");
+let component = new ui.MyComponent();
+
+// object literal
+component.person = { name: "Peter", age: 22 };
+
+// new keyword (sets property values to default e.g. '' for string)
+component.person = new ui.Person();
+
+// new keyword with parameters
+component.person = new ui.Person({ name: "Tim", age: 30 });
+```
+
+### enums
+
+A value of an exported enum can be set as string or by usign the value from the exported enum.
+
+**`my-component.slint`**
+
+```
+export enum Position {
+    top,
+    bottom
+}
+
+export component MyComponent inherits Window {
+    in-out property <Position> position;
+}
+```
+
+**`main.js`**
+
+```js
+
+import * as slint from "slint-ui";
+
+let ui = slint.loadFile("my-component.slint");
+let component = new ui.MyComponent();
+
+// set enum value as string
+component.position = "top";
+
+// use the value of the enum
+component.position = ui.Position.bottom;
+```
+
 ### Globals
 
 You can declare [globally available singletons](../slint/src/language/syntax/globals) in your
@@ -302,3 +371,4 @@ component.Logic.to_upper_case = (str) => {
 
 **Note**: Global singletons are instantiated once per component. When declaring multiple components for `export` to JavaScript,
 each instance will have their own instance of associated globals singletons.
+

package/dist/index.d.ts

@@ -194,7 +194,7 @@ export interface LoadFileOptions {
  * main.greeting = "Hello friends";
  * ```
  *
- * @param filePath The path to the file to load. Relative paths are resolved against the process' current working directory.
+ * @param filePath The path to the file to load as `string` or `URL`. Relative paths are resolved against the process' current working directory.
  * @param options An optional {@link LoadFileOptions} to configure additional Slint compilation settings,
  *                such as include search paths, library imports, or the widget style.
  * @returns Returns an object that is immutable and provides a constructor function for each exported Window component found in the `.slint` file.
@@ -203,7 +203,7 @@ export interface LoadFileOptions {
  *          For further information on the available properties, refer to [Instantiating A Component](../index.html#md:instantiating-a-component).
  * @throws {@link CompileError} if errors occur during compilation.
  */
-export declare function loadFile(filePath: string, options?: LoadFileOptions): Object;
+export declare function loadFile(filePath: string | URL, options?: LoadFileOptions): Object;
 /**
  * Loads the given Slint source code and returns an object that contains a functions to construct the exported
  * components of the Slint source code.
@@ -404,6 +404,24 @@ export declare namespace private_api {
         rowData(row: number): U | undefined;
     }
 }
+/**
+ * Initialize translations.
+ *
+ * Call this with the path where translations are located. This function internally calls the [bindtextdomain](https://man7.org/linux/man-pages/man3/bindtextdomain.3.html) function from gettext.
+ *
+ * Translations are expected to be found at <path>/<locale>/LC_MESSAGES/<domain>.mo, where path is the directory passed as an argument to this function, locale is a locale name (e.g., en, en_GB, fr), and domain is the package name.
+ *
+ * @param domain defines the domain name e.g. name of the package.
+ * @param path specifies the directory as `string` or as `URL` in which gettext should search for translations.
+ *
+ * For example, assuming this is in a package called example and the default locale is configured to be French, it will load translations at runtime from ``/path/to/example/translations/fr/LC_MESSAGES/example.mo`.
+ *
+ * ```js
+ * import * as slint from "slint-ui";
+ * slint.initTranslations("example", new URL("translations/", import.meta.url));
+ * ````
+ */
+export declare function initTranslations(domain: string, path: string | URL): void;
 /**
  * @hidden
  */

package/dist/index.js

@@ -2,7 +2,7 @@
 // Copyright © SixtyFPS GmbH <info@slint.dev>
 // SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.private_api = exports.quitEventLoop = exports.runEventLoop = exports.loadSource = exports.loadFile = exports.CompileError = exports.ArrayModel = exports.Model = exports.Brush = exports.RgbaColor = exports.DiagnosticLevel = exports.Diagnostic = void 0;
+exports.initTranslations = exports.private_api = exports.quitEventLoop = exports.runEventLoop = exports.loadSource = exports.loadFile = exports.CompileError = exports.ArrayModel = exports.Model = exports.Brush = exports.RgbaColor = exports.DiagnosticLevel = exports.Diagnostic = void 0;
 const napi = require("../rust-module.cjs");
 var rust_module_cjs_1 = require("../rust-module.cjs");
 Object.defineProperty(exports, "Diagnostic", { enumerable: true, get: function () { return rust_module_cjs_1.Diagnostic; } });
@@ -72,6 +72,9 @@ class CompileError extends Error {
     }
 }
 exports.CompileError = CompileError;
+function translateName(key) {
+    return key.replace(/-/g, "_");
+}
 function loadSlint(loadData) {
     const { filePath, options } = loadData.fileData;
     const compiler = new napi.ComponentCompiler();
@@ -101,14 +104,44 @@ function loadSlint(loadData) {
         }
     }
     const slint_module = Object.create({});
+    // generate structs
+    const structs = compiler.structs;
+    for (const key in compiler.structs) {
+        Object.defineProperty(slint_module, translateName(key), {
+            value: function (properties) {
+                const defaultObject = structs[key];
+                const newObject = Object.create({});
+                for (const propertyKey in defaultObject) {
+                    const propertyName = translateName(propertyKey);
+                    const propertyValue = properties !== undefined &&
+                        Object.hasOwn(properties, propertyName)
+                        ? properties[propertyName]
+                        : defaultObject[propertyKey];
+                    Object.defineProperty(newObject, propertyName, {
+                        value: propertyValue,
+                        writable: true,
+                        enumerable: true,
+                    });
+                }
+                return Object.seal(newObject);
+            },
+        });
+    }
+    // generate enums
+    const enums = compiler.enums;
+    for (const key in enums) {
+        Object.defineProperty(slint_module, translateName(key), {
+            value: Object.seal(enums[key]),
+            enumerable: true,
+        });
+    }
     Object.keys(definitions).forEach((key) => {
         const definition = definitions[key];
-        Object.defineProperty(slint_module, definition.name.replace(/-/g, "_"), {
+        Object.defineProperty(slint_module, translateName(definition.name), {
             value: function (properties) {
                 const instance = definition.create();
                 if (instance == null) {
-                    throw Error("Could not create a component handle for" +
-                        filePath);
+                    throw Error("Could not create a component handle for" + filePath);
                 }
                 for (var key in properties) {
                     const value = properties[key];
@@ -121,7 +154,7 @@ function loadSlint(loadData) {
                 }
                 const componentHandle = new Component(instance);
                 instance.definition().properties.forEach((prop) => {
-                    const propName = prop.name.replace(/-/g, "_");
+                    const propName = translateName(prop.name);
                     if (componentHandle[propName] !== undefined) {
                         console.warn("Duplicated property name " + propName);
                     }
@@ -138,12 +171,12 @@ function loadSlint(loadData) {
                     }
                 });
                 instance.definition().callbacks.forEach((cb) => {
-                    const callbackName = cb.replace(/-/g, "_");
+                    const callbackName = translateName(cb);
                     if (componentHandle[callbackName] !== undefined) {
                         console.warn("Duplicated callback name " + callbackName);
                     }
                     else {
-                        Object.defineProperty(componentHandle, cb.replace(/-/g, "_"), {
+                        Object.defineProperty(componentHandle, translateName(cb), {
                             get() {
                                 return function () {
                                     return instance.invoke(cb, Array.from(arguments));
@@ -157,12 +190,12 @@ function loadSlint(loadData) {
                     }
                 });
                 instance.definition().functions.forEach((cb) => {
-                    const functionName = cb.replace(/-/g, "_");
+                    const functionName = translateName(cb);
                     if (componentHandle[functionName] !== undefined) {
                         console.warn("Duplicated function name " + functionName);
                     }
                     else {
-                        Object.defineProperty(componentHandle, cb.replace(/-/g, "_"), {
+                        Object.defineProperty(componentHandle, translateName(cb), {
                             get() {
                                 return function () {
                                     return instance.invoke(cb, Array.from(arguments));
@@ -183,7 +216,7 @@ function loadSlint(loadData) {
                             .definition()
                             .globalProperties(globalName)
                             .forEach((prop) => {
-                            const propName = prop.name.replace(/-/g, "_");
+                            const propName = translateName(prop.name);
                             if (globalObject[propName] !== undefined) {
                                 console.warn("Duplicated property name " +
                                     propName +
@@ -206,7 +239,7 @@ function loadSlint(loadData) {
                             .definition()
                             .globalCallbacks(globalName)
                             .forEach((cb) => {
-                            const callbackName = cb.replace(/-/g, "_");
+                            const callbackName = translateName(cb);
                             if (globalObject[callbackName] !== undefined) {
                                 console.warn("Duplicated property name " +
                                     cb +
@@ -214,7 +247,7 @@ function loadSlint(loadData) {
                                     global);
                             }
                             else {
-                                Object.defineProperty(globalObject, cb.replace(/-/g, "_"), {
+                                Object.defineProperty(globalObject, translateName(cb), {
                                     get() {
                                         return function () {
                                             return instance.invokeGlobal(globalName, cb, Array.from(arguments));
@@ -231,7 +264,7 @@ function loadSlint(loadData) {
                             .definition()
                             .globalFunctions(globalName)
                             .forEach((cb) => {
-                            const functionName = cb.replace(/-/g, "_");
+                            const functionName = translateName(cb);
                             if (globalObject[functionName] !== undefined) {
                                 console.warn("Duplicated function name " +
                                     cb +
@@ -239,7 +272,7 @@ function loadSlint(loadData) {
                                     global);
                             }
                             else {
-                                Object.defineProperty(globalObject, cb.replace(/-/g, "_"), {
+                                Object.defineProperty(globalObject, translateName(cb), {
                                     get() {
                                         return function () {
                                             return instance.invokeGlobal(globalName, cb, Array.from(arguments));
@@ -286,7 +319,7 @@ function loadSlint(loadData) {
  * main.greeting = "Hello friends";
  * ```
  *
- * @param filePath The path to the file to load. Relative paths are resolved against the process' current working directory.
+ * @param filePath The path to the file to load as `string` or `URL`. Relative paths are resolved against the process' current working directory.
  * @param options An optional {@link LoadFileOptions} to configure additional Slint compilation settings,
  *                such as include search paths, library imports, or the widget style.
  * @returns Returns an object that is immutable and provides a constructor function for each exported Window component found in the `.slint` file.
@@ -296,8 +329,9 @@ function loadSlint(loadData) {
  * @throws {@link CompileError} if errors occur during compilation.
  */
 function loadFile(filePath, options) {
+    const pathname = filePath instanceof URL ? filePath.pathname : filePath;
     return loadSlint({
-        fileData: { filePath, options },
+        fileData: { filePath: pathname, options },
         from: "file",
     });
 }
@@ -570,6 +604,28 @@ var private_api;
     }
     private_api.MapModel = MapModel;
 })(private_api || (exports.private_api = private_api = {}));
+/**
+ * Initialize translations.
+ *
+ * Call this with the path where translations are located. This function internally calls the [bindtextdomain](https://man7.org/linux/man-pages/man3/bindtextdomain.3.html) function from gettext.
+ *
+ * Translations are expected to be found at <path>/<locale>/LC_MESSAGES/<domain>.mo, where path is the directory passed as an argument to this function, locale is a locale name (e.g., en, en_GB, fr), and domain is the package name.
+ *
+ * @param domain defines the domain name e.g. name of the package.
+ * @param path specifies the directory as `string` or as `URL` in which gettext should search for translations.
+ *
+ * For example, assuming this is in a package called example and the default locale is configured to be French, it will load translations at runtime from ``/path/to/example/translations/fr/LC_MESSAGES/example.mo`.
+ *
+ * ```js
+ * import * as slint from "slint-ui";
+ * slint.initTranslations("example", new URL("translations/", import.meta.url));
+ * ````
+ */
+function initTranslations(domain, path) {
+    const pathname = path instanceof URL ? path.pathname : path;
+    napi.initTranslations(domain, pathname);
+}
+exports.initTranslations = initTranslations;
 /**
  * @hidden
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slint-ui",
-  "version": "1.9.0-nightly.2024100903",
+  "version": "1.9.0-nightly.2024101016",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "homepage": "https://github.com/slint-ui/slint",
@@ -67,10 +67,10 @@
     "@napi-rs/cli": "2.16.5"
   },
   "optionalDependencies": {
-    "@slint-ui/slint-ui-binary-linux-x64-gnu": "1.9.0-nightly.2024100903",
-    "@slint-ui/slint-ui-binary-darwin-x64": "1.9.0-nightly.2024100903",
-    "@slint-ui/slint-ui-binary-darwin-arm64": "1.9.0-nightly.2024100903",
-    "@slint-ui/slint-ui-binary-win32-x64-msvc": "1.9.0-nightly.2024100903",
-    "@slint-ui/slint-ui-binary-win32-ia32-msvc": "1.9.0-nightly.2024100903"
+    "@slint-ui/slint-ui-binary-linux-x64-gnu": "1.9.0-nightly.2024101016",
+    "@slint-ui/slint-ui-binary-darwin-x64": "1.9.0-nightly.2024101016",
+    "@slint-ui/slint-ui-binary-darwin-arm64": "1.9.0-nightly.2024101016",
+    "@slint-ui/slint-ui-binary-win32-x64-msvc": "1.9.0-nightly.2024101016",
+    "@slint-ui/slint-ui-binary-win32-ia32-msvc": "1.9.0-nightly.2024101016"
   }
 }

package/rust/interpreter/component_compiler.rs

@@ -1,10 +1,16 @@
 // Copyright © SixtyFPS GmbH <info@slint.dev>
 // SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0
 
+use crate::to_js_unknown;
+
 use super::JsComponentDefinition;
 use super::JsDiagnostic;
+use i_slint_compiler::langtype::Type;
 use itertools::Itertools;
+use napi::Env;
+use napi::JsUnknown;
 use slint_interpreter::Compiler;
+use slint_interpreter::Value;
 use std::collections::HashMap;
 use std::path::PathBuf;
 
@@ -13,6 +19,7 @@ use std::path::PathBuf;
 #[napi(js_name = "ComponentCompiler")]
 pub struct JsComponentCompiler {
     internal: Compiler,
+    structs_and_enums: Vec<Type>,
     diagnostics: Vec<slint_interpreter::Diagnostic>,
 }
 
@@ -44,7 +51,7 @@ impl JsComponentCompiler {
 
         compiler.set_include_paths(include_paths);
         compiler.set_library_paths(library_paths);
-        Self { internal: compiler, diagnostics: vec![] }
+        Self { internal: compiler, diagnostics: vec![], structs_and_enums: vec![] }
     }
 
     #[napi(setter)]
@@ -99,12 +106,72 @@ impl JsComponentCompiler {
         self.diagnostics.iter().map(|d| JsDiagnostic::from(d.clone())).collect()
     }
 
+    #[napi(getter)]
+    pub fn structs(&self, env: Env) -> HashMap<String, JsUnknown> {
+        fn convert_type(env: &Env, ty: &Type) -> Option<(String, JsUnknown)> {
+            match ty {
+                Type::Struct { fields, name: Some(name), node: Some(_), .. } => {
+                    let struct_instance = to_js_unknown(
+                        env,
+                        &Value::Struct(slint_interpreter::Struct::from_iter(fields.iter().map(
+                            |(name, field_type)| {
+                                (
+                                    name.to_string(),
+                                    slint_interpreter::default_value_for_type(field_type),
+                                )
+                            },
+                        ))),
+                    );
+
+                    return Some((name.to_string(), struct_instance.ok()?));
+                }
+                _ => return None,
+            }
+        }
+
+        self.structs_and_enums
+            .iter()
+            .filter_map(|ty| convert_type(&env, ty))
+            .into_iter()
+            .collect::<HashMap<String, JsUnknown>>()
+    }
+
+    #[napi(getter)]
+    pub fn enums(&self, env: Env) -> HashMap<String, JsUnknown> {
+        fn convert_type(env: &Env, ty: &Type) -> Option<(String, JsUnknown)> {
+            match ty {
+                Type::Enumeration(en) => {
+                    let mut o = env.create_object().ok()?;
+
+                    for value in en.values.iter() {
+                        let value = value.replace('-', "_");
+                        o.set_property(
+                            env.create_string(&value).ok()?,
+                            env.create_string(&value).ok()?.into_unknown(),
+                        )
+                        .ok()?;
+                    }
+                    return Some((en.name.clone(), o.into_unknown()));
+                }
+                _ => return None,
+            }
+        }
+
+        self.structs_and_enums
+            .iter()
+            .filter_map(|ty| convert_type(&env, ty))
+            .into_iter()
+            .collect::<HashMap<String, JsUnknown>>()
+    }
+
     /// Compile a .slint file into a ComponentDefinition
     ///
     /// Returns the compiled `ComponentDefinition` if there were no errors.
     #[napi]
     pub fn build_from_path(&mut self, path: String) -> HashMap<String, JsComponentDefinition> {
         let r = spin_on::spin_on(self.internal.build_from_path(PathBuf::from(path)));
+        self.structs_and_enums =
+            r.structs_and_enums(i_slint_core::InternalToken {}).cloned().collect::<Vec<_>>();
         self.diagnostics = r.diagnostics().collect();
         r.components().map(|c| (c.name().to_owned(), c.into())).collect()
     }
@@ -118,6 +185,8 @@ impl JsComponentCompiler {
     ) -> HashMap<String, JsComponentDefinition> {
         let r = spin_on::spin_on(self.internal.build_from_source(source_code, PathBuf::from(path)));
         self.diagnostics = r.diagnostics().collect();
+        self.structs_and_enums =
+            r.structs_and_enums(i_slint_core::InternalToken {}).cloned().collect::<Vec<_>>();
         r.components().map(|c| (c.name().to_owned(), c.into())).collect()
     }
 }

package/rust/lib.rs

@@ -2,6 +2,8 @@
 // SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0
 
 mod interpreter;
+use std::path::PathBuf;
+
 pub use interpreter::*;
 
 mod types;
@@ -86,6 +88,12 @@ pub fn init_testing() {
     i_slint_backend_testing::init_integration_test_with_mock_time();
 }
 
+#[napi]
+pub fn init_translations(domain: String, dir_name: String) -> napi::Result<()> {
+    i_slint_core::translations::gettext_bindtextdomain(domain.as_str(), PathBuf::from(dir_name))
+        .map_err(|e| napi::Error::from_reason(e.to_string()))
+}
+
 pub fn print_to_console(env: Env, function: &str, arguments: core::fmt::Arguments) {
     let Ok(global) = env.get_global() else {
         eprintln!("Unable to obtain global object");

package/rust-module.cjs

@@ -252,7 +252,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { DiagnosticLevel, ComponentCompiler, ComponentDefinition, ComponentInstance, ValueType, Property, Window, SlintRgbaColor, SlintBrush, SlintImageData, SharedModelNotify, jsModelNotifyNew, jsModelNotifyRowDataChanged, jsModelNotifyRowAdded, jsModelNotifyRowRemoved, jsModelNotifyReset, ReadOnlyRustModel, ModelIterator, SlintPoint, SlintSize, mockElapsedTime, getMockedTime, ProcessEventsResult, processEvents, invokeFromEventLoop, setQuitOnLastWindowClosed, initTesting } = nativeBinding
+const { DiagnosticLevel, ComponentCompiler, ComponentDefinition, ComponentInstance, ValueType, Property, Window, SlintRgbaColor, SlintBrush, SlintImageData, SharedModelNotify, jsModelNotifyNew, jsModelNotifyRowDataChanged, jsModelNotifyRowAdded, jsModelNotifyRowRemoved, jsModelNotifyReset, ReadOnlyRustModel, ModelIterator, SlintPoint, SlintSize, mockElapsedTime, getMockedTime, ProcessEventsResult, processEvents, invokeFromEventLoop, setQuitOnLastWindowClosed, initTesting, initTranslations } = nativeBinding
 
 module.exports.DiagnosticLevel = DiagnosticLevel
 module.exports.ComponentCompiler = ComponentCompiler
@@ -281,3 +281,4 @@ module.exports.processEvents = processEvents
 module.exports.invokeFromEventLoop = invokeFromEventLoop
 module.exports.setQuitOnLastWindowClosed = setQuitOnLastWindowClosed
 module.exports.initTesting = initTesting
+module.exports.initTranslations = initTranslations

package/rust-module.d.ts

@@ -83,6 +83,7 @@ export declare function processEvents(): ProcessEventsResult
 export declare function invokeFromEventLoop(callback: (...args: any[]) => any): void
 export declare function setQuitOnLastWindowClosed(quitOnLastWindowClosed: boolean): void
 export declare function initTesting(): void
+export declare function initTranslations(domain: string, dirName: string): void
 export type JsComponentCompiler = ComponentCompiler
 /**
  * ComponentCompiler is the entry point to the Slint interpreter that can be used
@@ -98,6 +99,8 @@ export class ComponentCompiler {
   set style(style: string)
   get style(): string | null
   get diagnostics(): Array<Diagnostic>
+  get structs(): Record<string, unknown>
+  get enums(): Record<string, unknown>
   /**
    * Compile a .slint file into a ComponentDefinition
    *

package/typescript/index.ts

@@ -266,6 +266,10 @@ type LoadData =
           from: "source";
       };
 
+function translateName(key: string): string {
+    return key.replace(/-/g, "_");
+}
+
 function loadSlint(loadData: LoadData): Object {
     const { filePath, options } = loadData.fileData;
 
@@ -309,252 +313,271 @@ function loadSlint(loadData: LoadData): Object {
 
     const slint_module = Object.create({});
 
+    // generate structs
+    const structs = compiler.structs;
+
+    for (const key in compiler.structs) {
+        Object.defineProperty(slint_module, translateName(key), {
+            value: function (properties: any) {
+                const defaultObject = structs[key];
+                const newObject = Object.create({});
+
+                for (const propertyKey in defaultObject) {
+                    const propertyName = translateName(propertyKey);
+                    const propertyValue =
+                        properties !== undefined &&
+                        Object.hasOwn(properties, propertyName)
+                            ? properties[propertyName]
+                            : defaultObject[propertyKey];
+
+                    Object.defineProperty(newObject, propertyName, {
+                        value: propertyValue,
+                        writable: true,
+                        enumerable: true,
+                    });
+                }
+
+                return Object.seal(newObject);
+            },
+        });
+    }
+
+    // generate enums
+    const enums = compiler.enums;
+
+    for (const key in enums) {
+        Object.defineProperty(slint_module, translateName(key), {
+            value: Object.seal(enums[key]),
+            enumerable: true,
+        });
+    }
+
     Object.keys(definitions).forEach((key) => {
         const definition = definitions[key];
 
-        Object.defineProperty(
-            slint_module,
-            definition.name.replace(/-/g, "_"),
-            {
-                value: function (properties: any) {
-                    const instance = definition.create();
-
-                    if (instance == null) {
-                        throw Error(
-                            "Could not create a component handle for" +
-                                filePath,
-                        );
-                    }
+        Object.defineProperty(slint_module, translateName(definition.name), {
+            value: function (properties: any) {
+                const instance = definition.create();
+
+                if (instance == null) {
+                    throw Error(
+                        "Could not create a component handle for" + filePath,
+                    );
+                }
 
-                    for (var key in properties) {
-                        const value = properties[key];
+                for (var key in properties) {
+                    const value = properties[key];
 
-                        if (value instanceof Function) {
-                            instance.setCallback(key, value);
-                        } else {
-                            instance.setProperty(key, properties[key]);
-                        }
+                    if (value instanceof Function) {
+                        instance.setCallback(key, value);
+                    } else {
+                        instance.setProperty(key, properties[key]);
                     }
+                }
+
+                const componentHandle = new Component(instance!);
+                instance!.definition().properties.forEach((prop) => {
+                    const propName = translateName(prop.name);
+
+                    if (componentHandle[propName] !== undefined) {
+                        console.warn("Duplicated property name " + propName);
+                    } else {
+                        Object.defineProperty(componentHandle, propName, {
+                            get() {
+                                return instance!.getProperty(prop.name);
+                            },
+                            set(value) {
+                                instance!.setProperty(prop.name, value);
+                            },
+                            enumerable: true,
+                        });
+                    }
+                });
 
-                    const componentHandle = new Component(instance!);
-                    instance!.definition().properties.forEach((prop) => {
-                        const propName = prop.name.replace(/-/g, "_");
+                instance!.definition().callbacks.forEach((cb) => {
+                    const callbackName = translateName(cb);
 
-                        if (componentHandle[propName] !== undefined) {
-                            console.warn(
-                                "Duplicated property name " + propName,
-                            );
-                        } else {
-                            Object.defineProperty(componentHandle, propName, {
+                    if (componentHandle[callbackName] !== undefined) {
+                        console.warn(
+                            "Duplicated callback name " + callbackName,
+                        );
+                    } else {
+                        Object.defineProperty(
+                            componentHandle,
+                            translateName(cb),
+                            {
                                 get() {
-                                    return instance!.getProperty(prop.name);
+                                    return function () {
+                                        return instance!.invoke(
+                                            cb,
+                                            Array.from(arguments),
+                                        );
+                                    };
                                 },
-                                set(value) {
-                                    instance!.setProperty(prop.name, value);
+                                set(callback) {
+                                    instance!.setCallback(cb, callback);
                                 },
                                 enumerable: true,
-                            });
-                        }
-                    });
+                            },
+                        );
+                    }
+                });
 
-                    instance!.definition().callbacks.forEach((cb) => {
-                        const callbackName = cb.replace(/-/g, "_");
-
-                        if (componentHandle[callbackName] !== undefined) {
-                            console.warn(
-                                "Duplicated callback name " + callbackName,
-                            );
-                        } else {
-                            Object.defineProperty(
-                                componentHandle,
-                                cb.replace(/-/g, "_"),
-                                {
-                                    get() {
-                                        return function () {
-                                            return instance!.invoke(
-                                                cb,
-                                                Array.from(arguments),
-                                            );
-                                        };
-                                    },
-                                    set(callback) {
-                                        instance!.setCallback(cb, callback);
-                                    },
-                                    enumerable: true,
-                                },
-                            );
-                        }
-                    });
+                instance!.definition().functions.forEach((cb) => {
+                    const functionName = translateName(cb);
 
-                    instance!.definition().functions.forEach((cb) => {
-                        const functionName = cb.replace(/-/g, "_");
-
-                        if (componentHandle[functionName] !== undefined) {
-                            console.warn(
-                                "Duplicated function name " + functionName,
-                            );
-                        } else {
-                            Object.defineProperty(
-                                componentHandle,
-                                cb.replace(/-/g, "_"),
-                                {
-                                    get() {
-                                        return function () {
-                                            return instance!.invoke(
-                                                cb,
-                                                Array.from(arguments),
-                                            );
-                                        };
-                                    },
-                                    enumerable: true,
+                    if (componentHandle[functionName] !== undefined) {
+                        console.warn(
+                            "Duplicated function name " + functionName,
+                        );
+                    } else {
+                        Object.defineProperty(
+                            componentHandle,
+                            translateName(cb),
+                            {
+                                get() {
+                                    return function () {
+                                        return instance!.invoke(
+                                            cb,
+                                            Array.from(arguments),
+                                        );
+                                    };
                                 },
-                            );
-                        }
-                    });
-
-                    // globals
-                    instance!.definition().globals.forEach((globalName) => {
-                        if (componentHandle[globalName] !== undefined) {
-                            console.warn(
-                                "Duplicated property name " + globalName,
-                            );
-                        } else {
-                            const globalObject = Object.create({});
-
-                            instance!
-                                .definition()
-                                .globalProperties(globalName)
-                                .forEach((prop) => {
-                                    const propName = prop.name.replace(
-                                        /-/g,
-                                        "_",
+                                enumerable: true,
+                            },
+                        );
+                    }
+                });
+
+                // globals
+                instance!.definition().globals.forEach((globalName) => {
+                    if (componentHandle[globalName] !== undefined) {
+                        console.warn("Duplicated property name " + globalName);
+                    } else {
+                        const globalObject = Object.create({});
+
+                        instance!
+                            .definition()
+                            .globalProperties(globalName)
+                            .forEach((prop) => {
+                                const propName = translateName(prop.name);
+
+                                if (globalObject[propName] !== undefined) {
+                                    console.warn(
+                                        "Duplicated property name " +
+                                            propName +
+                                            " on global " +
+                                            global,
                                     );
+                                } else {
+                                    Object.defineProperty(
+                                        globalObject,
+                                        propName,
+                                        {
+                                            get() {
+                                                return instance!.getGlobalProperty(
+                                                    globalName,
+                                                    prop.name,
+                                                );
+                                            },
+                                            set(value) {
+                                                instance!.setGlobalProperty(
+                                                    globalName,
+                                                    prop.name,
+                                                    value,
+                                                );
+                                            },
+                                            enumerable: true,
+                                        },
+                                    );
+                                }
+                            });
 
-                                    if (globalObject[propName] !== undefined) {
-                                        console.warn(
-                                            "Duplicated property name " +
-                                                propName +
-                                                " on global " +
-                                                global,
-                                        );
-                                    } else {
-                                        Object.defineProperty(
-                                            globalObject,
-                                            propName,
-                                            {
-                                                get() {
-                                                    return instance!.getGlobalProperty(
-                                                        globalName,
-                                                        prop.name,
-                                                    );
-                                                },
-                                                set(value) {
-                                                    instance!.setGlobalProperty(
+                        instance!
+                            .definition()
+                            .globalCallbacks(globalName)
+                            .forEach((cb) => {
+                                const callbackName = translateName(cb);
+
+                                if (globalObject[callbackName] !== undefined) {
+                                    console.warn(
+                                        "Duplicated property name " +
+                                            cb +
+                                            " on global " +
+                                            global,
+                                    );
+                                } else {
+                                    Object.defineProperty(
+                                        globalObject,
+                                        translateName(cb),
+                                        {
+                                            get() {
+                                                return function () {
+                                                    return instance!.invokeGlobal(
                                                         globalName,
-                                                        prop.name,
-                                                        value,
+                                                        cb,
+                                                        Array.from(arguments),
                                                     );
-                                                },
-                                                enumerable: true,
+                                                };
                                             },
-                                        );
-                                    }
-                                });
-
-                            instance!
-                                .definition()
-                                .globalCallbacks(globalName)
-                                .forEach((cb) => {
-                                    const callbackName = cb.replace(/-/g, "_");
-
-                                    if (
-                                        globalObject[callbackName] !== undefined
-                                    ) {
-                                        console.warn(
-                                            "Duplicated property name " +
-                                                cb +
-                                                " on global " +
-                                                global,
-                                        );
-                                    } else {
-                                        Object.defineProperty(
-                                            globalObject,
-                                            cb.replace(/-/g, "_"),
-                                            {
-                                                get() {
-                                                    return function () {
-                                                        return instance!.invokeGlobal(
-                                                            globalName,
-                                                            cb,
-                                                            Array.from(
-                                                                arguments,
-                                                            ),
-                                                        );
-                                                    };
-                                                },
-                                                set(callback) {
-                                                    instance!.setGlobalCallback(
+                                            set(callback) {
+                                                instance!.setGlobalCallback(
+                                                    globalName,
+                                                    cb,
+                                                    callback,
+                                                );
+                                            },
+                                            enumerable: true,
+                                        },
+                                    );
+                                }
+                            });
+
+                        instance!
+                            .definition()
+                            .globalFunctions(globalName)
+                            .forEach((cb) => {
+                                const functionName = translateName(cb);
+
+                                if (globalObject[functionName] !== undefined) {
+                                    console.warn(
+                                        "Duplicated function name " +
+                                            cb +
+                                            " on global " +
+                                            global,
+                                    );
+                                } else {
+                                    Object.defineProperty(
+                                        globalObject,
+                                        translateName(cb),
+                                        {
+                                            get() {
+                                                return function () {
+                                                    return instance!.invokeGlobal(
                                                         globalName,
                                                         cb,
-                                                        callback,
+                                                        Array.from(arguments),
                                                     );
-                                                },
-                                                enumerable: true,
+                                                };
                                             },
-                                        );
-                                    }
-                                });
-
-                            instance!
-                                .definition()
-                                .globalFunctions(globalName)
-                                .forEach((cb) => {
-                                    const functionName = cb.replace(/-/g, "_");
-
-                                    if (
-                                        globalObject[functionName] !== undefined
-                                    ) {
-                                        console.warn(
-                                            "Duplicated function name " +
-                                                cb +
-                                                " on global " +
-                                                global,
-                                        );
-                                    } else {
-                                        Object.defineProperty(
-                                            globalObject,
-                                            cb.replace(/-/g, "_"),
-                                            {
-                                                get() {
-                                                    return function () {
-                                                        return instance!.invokeGlobal(
-                                                            globalName,
-                                                            cb,
-                                                            Array.from(
-                                                                arguments,
-                                                            ),
-                                                        );
-                                                    };
-                                                },
-                                                enumerable: true,
-                                            },
-                                        );
-                                    }
-                                });
-
-                            Object.defineProperty(componentHandle, globalName, {
-                                get() {
-                                    return globalObject;
-                                },
-                                enumerable: true,
+                                            enumerable: true,
+                                        },
+                                    );
+                                }
                             });
-                        }
-                    });
 
-                    return Object.seal(componentHandle);
-                },
+                        Object.defineProperty(componentHandle, globalName, {
+                            get() {
+                                return globalObject;
+                            },
+                            enumerable: true,
+                        });
+                    }
+                });
+
+                return Object.seal(componentHandle);
             },
-        );
+        });
     });
     return Object.seal(slint_module);
 }
@@ -582,7 +605,7 @@ function loadSlint(loadData: LoadData): Object {
  * main.greeting = "Hello friends";
  * ```
  *
- * @param filePath The path to the file to load. Relative paths are resolved against the process' current working directory.
+ * @param filePath The path to the file to load as `string` or `URL`. Relative paths are resolved against the process' current working directory.
  * @param options An optional {@link LoadFileOptions} to configure additional Slint compilation settings,
  *                such as include search paths, library imports, or the widget style.
  * @returns Returns an object that is immutable and provides a constructor function for each exported Window component found in the `.slint` file.
@@ -591,9 +614,13 @@ function loadSlint(loadData: LoadData): Object {
  *          For further information on the available properties, refer to [Instantiating A Component](../index.html#md:instantiating-a-component).
  * @throws {@link CompileError} if errors occur during compilation.
  */
-export function loadFile(filePath: string, options?: LoadFileOptions): Object {
+export function loadFile(
+    filePath: string | URL,
+    options?: LoadFileOptions,
+): Object {
+    const pathname = filePath instanceof URL ? filePath.pathname : filePath;
     return loadSlint({
-        fileData: { filePath, options },
+        fileData: { filePath: pathname, options },
         from: "file",
     });
 }
@@ -895,6 +922,28 @@ export namespace private_api {
     }
 }
 
+/**
+ * Initialize translations.
+ *
+ * Call this with the path where translations are located. This function internally calls the [bindtextdomain](https://man7.org/linux/man-pages/man3/bindtextdomain.3.html) function from gettext.
+ *
+ * Translations are expected to be found at <path>/<locale>/LC_MESSAGES/<domain>.mo, where path is the directory passed as an argument to this function, locale is a locale name (e.g., en, en_GB, fr), and domain is the package name.
+ *
+ * @param domain defines the domain name e.g. name of the package.
+ * @param path specifies the directory as `string` or as `URL` in which gettext should search for translations.
+ *
+ * For example, assuming this is in a package called example and the default locale is configured to be French, it will load translations at runtime from ``/path/to/example/translations/fr/LC_MESSAGES/example.mo`.
+ *
+ * ```js
+ * import * as slint from "slint-ui";
+ * slint.initTranslations("example", new URL("translations/", import.meta.url));
+ * ````
+ */
+export function initTranslations(domain: string, path: string | URL) {
+    const pathname = path instanceof URL ? path.pathname : path;
+    napi.initTranslations(domain, pathname);
+}
+
 /**
  * @hidden
  */