@gtkx/utils 1.3.0 → 1.4.0

package/README.md

@@ -5,9 +5,9 @@
 <h1 align="center">GTKX</h1>
 
 <p align="center">
-  The React framework for Linux.<br />
-  Write native Linux applications with React and TypeScript.
-  Built on the GNOME stack and standard web tooling.
+  The React framework for Linux, built on GTK.<br />
+  Write native GTK4 desktop applications with React and TypeScript.
+  Real GTK widgets, the GNOME stack, and standard web tooling.
 </p>
 
 <p align="center">
@@ -98,7 +98,7 @@ GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing r
 - a React reconciler that exposes every GObject as a JSX element,
 - a CLI for scaffolding, development, and production builds,
 - a dev server with Fast Refresh that patches your running UI in place,
-- CSS-in-JS styling, React Spring animations, and high-level list, grid, and dialog components,
+- CSS-in-JS styling, React Spring animations, React Navigation stack, tab, drawer, and split view navigators, and high-level list, grid, and dialog components,
 - a Testing Library-style API for querying and driving your widgets in tests,
 - and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
 
@@ -158,6 +158,7 @@ Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
 - [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
 - [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
 - [`animations`](https://github.com/gtkx-org/gtkx/tree/main/examples/animations): a tour of `@gtkx/animated`, React Spring animations driven by the GTK frame clock.
+- [`navigation`](https://github.com/gtkx-org/gtkx/tree/main/examples/navigation): a tour of `@gtkx/navigation`, React Navigation's stack, tab, and drawer navigators rendered with libadwaita.
 - [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
 
 ## Status

package/dist/source/escape-identifier-start.d.ts

@@ -1,3 +1,4 @@
 declare const escapeIdentifierStart: (name: string) => string;
-export { escapeIdentifierStart };
+declare const unescapeIdentifierStart: (name: string) => string;
+export { escapeIdentifierStart, unescapeIdentifierStart };
 //# sourceMappingURL=escape-identifier-start.d.ts.map

package/dist/source/escape-identifier-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escape-identifier-start.d.ts","sourceRoot":"","sources":["../../src/source/escape-identifier-start.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,MAAsD,CAAC;AAErG,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"escape-identifier-start.d.ts","sourceRoot":"","sources":["../../src/source/escape-identifier-start.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,MAAsD,CAAC;AAErG,QAAA,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MACS,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/source/escape-identifier-start.js

@@ -1,4 +1,6 @@
 const DIGIT_START = /^\d/;
+const ESCAPED_DIGIT_START = /^_\d/;
 const escapeIdentifierStart = (name) => (DIGIT_START.test(name) ? `_${name}` : name);
-export { escapeIdentifierStart };
+const unescapeIdentifierStart = (name) => ESCAPED_DIGIT_START.test(name) ? name.slice(1) : name;
+export { escapeIdentifierStart, unescapeIdentifierStart };
 //# sourceMappingURL=escape-identifier-start.js.map

package/dist/source/escape-identifier-start.js.map

@@ -1 +1 @@
-{"version":3,"file":"escape-identifier-start.js","sourceRoot":"","sources":["../../src/source/escape-identifier-start.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAErG,OAAO,EAAE,qBAAqB,EAAE,CAAC","sourcesContent":["const DIGIT_START = /^\\d/;\n\nconst escapeIdentifierStart = (name: string): string => (DIGIT_START.test(name) ? `_${name}` : name);\n\nexport { escapeIdentifierStart };\n"]}
+{"version":3,"file":"escape-identifier-start.js","sourceRoot":"","sources":["../../src/source/escape-identifier-start.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAErG,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAU,EAAE,CACrD,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,CAAC","sourcesContent":["const DIGIT_START = /^\\d/;\nconst ESCAPED_DIGIT_START = /^_\\d/;\n\nconst escapeIdentifierStart = (name: string): string => (DIGIT_START.test(name) ? `_${name}` : name);\n\nconst unescapeIdentifierStart = (name: string): string =>\n    ESCAPED_DIGIT_START.test(name) ? name.slice(1) : name;\n\nexport { escapeIdentifierStart, unescapeIdentifierStart };\n"]}

package/dist/source/escape-reserved.d.ts

@@ -1,3 +1,4 @@
 declare const escapeReserved: (name: string, reserved: Set<string>) => string;
-export { escapeReserved };
+declare const unescapeReserved: (name: string, reserved: Set<string>) => string;
+export { escapeReserved, unescapeReserved };
 //# sourceMappingURL=escape-reserved.d.ts.map

package/dist/source/escape-reserved.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escape-reserved.d.ts","sourceRoot":"","sources":["../../src/source/escape-reserved.ts"],"names":[],"mappings":"AAYA,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,CAAC,KAAG,MACW,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"escape-reserved.d.ts","sourceRoot":"","sources":["../../src/source/escape-reserved.ts"],"names":[],"mappings":"AAYA,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,CAAC,KAAG,MACW,CAAC;AAE1E,QAAA,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,CAAC,KAAG,MAQ/D,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/source/escape-reserved.js

@@ -7,5 +7,12 @@ const getUnsuffixedName = (name) => {
     return name.slice(0, end);
 };
 const escapeReserved = (name, reserved) => reserved.has(getUnsuffixedName(name)) ? `${name}${UNDERSCORE}` : name;
-export { escapeReserved };
+const unescapeReserved = (name, reserved) => {
+    if (!name.endsWith(UNDERSCORE)) {
+        return name;
+    }
+    const escaped = name.slice(0, -1);
+    return reserved.has(getUnsuffixedName(escaped)) ? escaped : name;
+};
+export { escapeReserved, unescapeReserved };
 //# sourceMappingURL=escape-reserved.js.map

package/dist/source/escape-reserved.js.map

@@ -1 +1 @@
-{"version":3,"file":"escape-reserved.js","sourceRoot":"","sources":["../../src/source/escape-reserved.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE;IAC/C,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IAEtB,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QACpD,GAAG,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,QAAqB,EAAU,EAAE,CACnE,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["const UNDERSCORE = \"_\";\n\nconst getUnsuffixedName = (name: string): string => {\n    let end = name.length;\n\n    while (end > 0 && name.charAt(end - 1) === UNDERSCORE) {\n        end -= 1;\n    }\n\n    return name.slice(0, end);\n};\n\nconst escapeReserved = (name: string, reserved: Set<string>): string =>\n    reserved.has(getUnsuffixedName(name)) ? `${name}${UNDERSCORE}` : name;\n\nexport { escapeReserved };\n"]}
+{"version":3,"file":"escape-reserved.js","sourceRoot":"","sources":["../../src/source/escape-reserved.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE;IAC/C,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IAEtB,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QACpD,GAAG,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,QAAqB,EAAU,EAAE,CACnE,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1E,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,QAAqB,EAAU,EAAE;IACrE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAElC,OAAO,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["const UNDERSCORE = \"_\";\n\nconst getUnsuffixedName = (name: string): string => {\n    let end = name.length;\n\n    while (end > 0 && name.charAt(end - 1) === UNDERSCORE) {\n        end -= 1;\n    }\n\n    return name.slice(0, end);\n};\n\nconst escapeReserved = (name: string, reserved: Set<string>): string =>\n    reserved.has(getUnsuffixedName(name)) ? `${name}${UNDERSCORE}` : name;\n\nconst unescapeReserved = (name: string, reserved: Set<string>): string => {\n    if (!name.endsWith(UNDERSCORE)) {\n        return name;\n    }\n\n    const escaped = name.slice(0, -1);\n\n    return reserved.has(getUnsuffixedName(escaped)) ? escaped : name;\n};\n\nexport { escapeReserved, unescapeReserved };\n"]}

package/dist/source/index.d.ts

@@ -3,4 +3,5 @@ export { sanitizeIdentifier } from "./sanitize-identifier.ts";
 export { sanitizeTypeIdentifier } from "./sanitize-type-identifier.ts";
 export { sourceStringLiteral } from "./source-string-literal.ts";
 export { toCamelIdentifier } from "./to-camel-identifier.ts";
+export { unsanitizeIdentifier } from "./unsanitize-identifier.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/source/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/source/index.js

@@ -3,4 +3,5 @@ export { sanitizeIdentifier } from "./sanitize-identifier.js";
 export { sanitizeTypeIdentifier } from "./sanitize-type-identifier.js";
 export { sourceStringLiteral } from "./source-string-literal.js";
 export { toCamelIdentifier } from "./to-camel-identifier.js";
+export { unsanitizeIdentifier } from "./unsanitize-identifier.js";
 //# sourceMappingURL=index.js.map

package/dist/source/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { escapeIdentifierStart } from \"./escape-identifier-start.ts\";\nexport { sanitizeIdentifier } from \"./sanitize-identifier.ts\";\nexport { sanitizeTypeIdentifier } from \"./sanitize-type-identifier.ts\";\nexport { sourceStringLiteral } from \"./source-string-literal.ts\";\nexport { toCamelIdentifier } from \"./to-camel-identifier.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC","sourcesContent":["export { escapeIdentifierStart } from \"./escape-identifier-start.ts\";\nexport { sanitizeIdentifier } from \"./sanitize-identifier.ts\";\nexport { sanitizeTypeIdentifier } from \"./sanitize-type-identifier.ts\";\nexport { sourceStringLiteral } from \"./source-string-literal.ts\";\nexport { toCamelIdentifier } from \"./to-camel-identifier.ts\";\nexport { unsanitizeIdentifier } from \"./unsanitize-identifier.ts\";\n"]}

package/dist/source/unsanitize-identifier.d.ts

@@ -0,0 +1,3 @@
+declare function unsanitizeIdentifier(name: string): string;
+export { unsanitizeIdentifier };
+//# sourceMappingURL=unsanitize-identifier.d.ts.map

package/dist/source/unsanitize-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsanitize-identifier.d.ts","sourceRoot":"","sources":["../../src/source/unsanitize-identifier.ts"],"names":[],"mappings":"AAIA,iBAAS,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/source/unsanitize-identifier.js

@@ -0,0 +1,8 @@
+import { unescapeIdentifierStart } from "./escape-identifier-start.js";
+import { unescapeReserved } from "./escape-reserved.js";
+import { RESERVED } from "./sanitize-identifier.js";
+function unsanitizeIdentifier(name) {
+    return unescapeReserved(unescapeIdentifierStart(name), RESERVED);
+}
+export { unsanitizeIdentifier };
+//# sourceMappingURL=unsanitize-identifier.js.map

package/dist/source/unsanitize-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsanitize-identifier.js","sourceRoot":"","sources":["../../src/source/unsanitize-identifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,SAAS,oBAAoB,CAAC,IAAY;IACtC,OAAO,gBAAgB,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["import { unescapeIdentifierStart } from \"./escape-identifier-start.ts\";\nimport { unescapeReserved } from \"./escape-reserved.ts\";\nimport { RESERVED } from \"./sanitize-identifier.ts\";\n\nfunction unsanitizeIdentifier(name: string): string {\n    return unescapeReserved(unescapeIdentifierStart(name), RESERVED);\n}\n\nexport { unsanitizeIdentifier };\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gtkx/utils",
-  "version": "1.3.0",
-  "description": "Cross-package utilities shared by the GTKX packages and toolchain: logging, error formatting, string and class helpers",
+  "version": "1.4.0",
+  "description": "Shared utilities for the GTK toolchain: logging, errors, strings.",
   "keywords": [
     "gtkx",
     "gtk",

package/src/source/escape-identifier-start.ts

@@ -1,5 +1,9 @@
 const DIGIT_START = /^\d/;
+const ESCAPED_DIGIT_START = /^_\d/;
 
 const escapeIdentifierStart = (name: string): string => (DIGIT_START.test(name) ? `_${name}` : name);
 
-export { escapeIdentifierStart };
+const unescapeIdentifierStart = (name: string): string =>
+    ESCAPED_DIGIT_START.test(name) ? name.slice(1) : name;
+
+export { escapeIdentifierStart, unescapeIdentifierStart };

package/src/source/escape-reserved.ts

@@ -13,4 +13,14 @@ const getUnsuffixedName = (name: string): string => {
 const escapeReserved = (name: string, reserved: Set<string>): string =>
     reserved.has(getUnsuffixedName(name)) ? `${name}${UNDERSCORE}` : name;
 
-export { escapeReserved };
+const unescapeReserved = (name: string, reserved: Set<string>): string => {
+    if (!name.endsWith(UNDERSCORE)) {
+        return name;
+    }
+
+    const escaped = name.slice(0, -1);
+
+    return reserved.has(getUnsuffixedName(escaped)) ? escaped : name;
+};
+
+export { escapeReserved, unescapeReserved };

package/src/source/index.ts

@@ -3,3 +3,4 @@ export { sanitizeIdentifier } from "./sanitize-identifier.ts";
 export { sanitizeTypeIdentifier } from "./sanitize-type-identifier.ts";
 export { sourceStringLiteral } from "./source-string-literal.ts";
 export { toCamelIdentifier } from "./to-camel-identifier.ts";
+export { unsanitizeIdentifier } from "./unsanitize-identifier.ts";

package/src/source/unsanitize-identifier.ts

@@ -0,0 +1,9 @@
+import { unescapeIdentifierStart } from "./escape-identifier-start.ts";
+import { unescapeReserved } from "./escape-reserved.ts";
+import { RESERVED } from "./sanitize-identifier.ts";
+
+function unsanitizeIdentifier(name: string): string {
+    return unescapeReserved(unescapeIdentifierStart(name), RESERVED);
+}
+
+export { unsanitizeIdentifier };