@appsemble/lang-sdk 0.36.6-test.0 → 0.36.7-test.0

package/README.md

@@ -22,6 +22,9 @@ npm install @appsemble/lang-sdk
 
 This package provides utilities and tools for working with the language DSL used in Appsemble.
 
+It also includes helpers for working with app page definitions, translated page labels, and
+canonical page path segments.
+
 ## Exports
 
 ### 1. **Validators**
@@ -90,6 +93,10 @@ This package provides utilities and tools for working with the language DSL used
 ### 6. **Miscellaneous**
 
 - `findPageByName`
+- `findPageById`
+- `getPageDisplayName`
+- `getPageMessageId`
+- `getPagePathSegment`
 - `examples`
 - `noop`
 - `schemaExample`

package/index.d.ts

@@ -6,6 +6,7 @@ export * from './authorization.js';
 export * from './blockUtils.js';
 export * from './validation.js';
 export * from './findPageByName.js';
+export * from './pageUtils.js';
 export * from './iterApp.js';
 export * from './serverActions.js';
 export * from './allActions.js';

package/index.js

@@ -6,6 +6,7 @@ export * from './authorization.js';
 export * from './blockUtils.js';
 export * from './validation.js';
 export * from './findPageByName.js';
+export * from './pageUtils.js';
 export * from './iterApp.js';
 export * from './serverActions.js';
 export * from './allActions.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsemble/lang-sdk",
-  "version": "0.36.6-test.0",
+  "version": "0.36.7-test.0",
   "description": "Language SDK for Appsemble",
   "keywords": [
     "app",

package/pageUtils.d.ts

@@ -0,0 +1,8 @@
+import { type MessageGetter } from './remap.js';
+import { type PageDefinition } from './types/index.js';
+type NamedPage = Pick<PageDefinition, 'name'>;
+export declare function getPageMessageId(pageName: string): string;
+export declare function getPagePathSegment(page: string | NamedPage): string;
+export declare function getPageDisplayName(page: NamedPage, getAppMessage: MessageGetter): string;
+export declare function findPageById(pages: PageDefinition[], normalizedPageId: string, appMessageIds: string[], getAppMessage: MessageGetter): PageDefinition | null;
+export {};

package/pageUtils.js

@@ -0,0 +1,38 @@
+import { normalize } from './normalize.js';
+export function getPageMessageId(pageName) {
+    return `pages.${normalize(pageName)}`;
+}
+export function getPagePathSegment(page) {
+    return normalize(typeof page === 'string' ? page : page.name);
+}
+export function getPageDisplayName(page, getAppMessage) {
+    return getAppMessage({
+        id: getPageMessageId(page.name),
+        defaultMessage: page.name,
+    }).format();
+}
+function matchesPageId(page, normalizedPageId, appMessageIds, getAppMessage) {
+    if (getPagePathSegment(page) === normalizedPageId) {
+        return true;
+    }
+    const pageMessageId = getPageMessageId(page.name);
+    if (!appMessageIds.includes(pageMessageId)) {
+        return false;
+    }
+    return normalize(getPageDisplayName(page, getAppMessage)) === normalizedPageId;
+}
+export function findPageById(pages, normalizedPageId, appMessageIds, getAppMessage) {
+    for (const page of pages) {
+        if (matchesPageId(page, normalizedPageId, appMessageIds, getAppMessage)) {
+            return page;
+        }
+        if (page.type === 'container') {
+            const foundPage = findPageById(page.pages, normalizedPageId, appMessageIds, getAppMessage);
+            if (foundPage) {
+                return foundPage;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=pageUtils.js.map