@monimesl/dot-cli 0.1.0-alpha.21 → 0.1.0-alpha.23

package/dist/templates/showcase/pages/dash/calls/state.ts

@@ -3,4 +3,7 @@ export default {
   // The last call's outcome: the DashError's code and message, or how it ended.
   code: '',
   message: '',
+  // What this Dash offers, for the supports section.
+  apiVersions: '',
+  picksPhones: false,
 };

package/dist/templates/showcase/pages/dash/calls/view.dml

@@ -34,6 +34,21 @@
     </View>
   </View>
 
+  <View gap="small">
+    <Text variant="subtitle">supports</Text>
+    <Text variant="caption" tone="muted">Each call's docs say which Dash API version it came in, and dot.json's dash.minApiVersion says which one the dot needs. To use a newer call and still open on older Dash, check this.dash.supports first.</Text>
+    <View variant="card" gap="none">
+      <DetailRow label="This Dash offers" value="Dash API {{ apiVersions }}" />
+      <DetailRow label="contacts.pickPhone" value="{{ picksPhones ? 'Supported' : 'Not on this Dash' }}" />
+    </View>
+  </View>
+
+  <View gap="small">
+    <Text variant="subtitle">dash.dot.close</Text>
+    <Text variant="caption" tone="muted">Closes the dot, as going back from its first page does, such as once a payment is done.</Text>
+    <Button variant="secondary" onClick="closeDot">Close the showcase</Button>
+  </View>
+
   <View gap="small">
     <Text variant="subtitle">The last call</Text>
     <View variant="card" gap="none">

package/dist/templates/showcase/pages/dash/crypto/controller.ts

@@ -0,0 +1,34 @@
+import { errorMessage } from '@monimesl/dot-runtime';
+
+import state from './state';
+
+export default definePage({
+  initialState: state,
+  configs: { navigationBar: { title: 'dash.crypto' } },
+  mutations: {
+    setText: (_state, event: ValueEvent) => ({ text: event.detail.value }),
+    setKey: (_state, event: ValueEvent) => ({ key: event.detail.value }),
+    // dash.utils answers at once, so even a mutation can use it.
+    encode: (state) => ({ encoded: dash.utils.base64.encode(state.text) }),
+  },
+  actions: {
+    async hash(state) {
+      try {
+        const sha256 = await this.dash.crypto.sha256(state.text);
+        const hmac = await this.dash.crypto.hmac('sha256', state.key, state.text);
+        this.setState({ sha256, hmac, note: '' });
+      } catch (error) {
+        this.setState({ note: errorMessage(error) });
+      }
+    },
+    async makeRandom() {
+      try {
+        const random = await this.dash.crypto.randomBytes(16);
+        const uuid = await this.dash.crypto.randomUUID();
+        this.setState({ random, uuid, note: '' });
+      } catch (error) {
+        this.setState({ note: errorMessage(error) });
+      }
+    },
+  },
+});

package/dist/templates/showcase/pages/dash/crypto/state.ts

@@ -0,0 +1,10 @@
+export default {
+  text: 'Salone Sounds Live, Freetown',
+  key: 'shared secret',
+  sha256: '',
+  hmac: '',
+  random: '',
+  uuid: '',
+  encoded: '',
+  note: '',
+};

package/dist/templates/showcase/pages/dash/crypto/view.dml

@@ -0,0 +1,48 @@
+<View>
+  <Text variant="title">dash.crypto</Text>
+  <Text>Hashes, signatures and random values, worked out on the phone. Each gives hex, or base64 with { as: 'base64' }.</Text>
+
+  <View variant="card" gap="medium">
+    <Input label="Text" value="{{ text }}" onChange="setText" />
+    <Input label="HMAC key" value="{{ key }}" onChange="setKey" />
+  </View>
+
+  <View gap="small">
+    <Text variant="subtitle">sha256 and hmac</Text>
+    <Text variant="caption" tone="muted">sha512 works the same way. hmac signs with a key, such as to check a message from the dot's own server.</Text>
+    <Button variant="secondary" onClick="hash">Hash and sign the text</Button>
+    <If condition="{{ sha256 }}">
+      <View variant="card" gap="none">
+        <DetailRow label="sha256" value="{{ sha256 }}" />
+        <DetailRow label="hmac sha256" value="{{ hmac }}" />
+      </View>
+    </If>
+  </View>
+
+  <View gap="small">
+    <Text variant="subtitle">randomBytes and randomUUID</Text>
+    <Text variant="caption" tone="muted">From the phone's secure random source, such as for a nonce.</Text>
+    <Button variant="secondary" onClick="makeRandom">Make random values</Button>
+    <If condition="{{ uuid }}">
+      <View variant="card" gap="none">
+        <DetailRow label="16 random bytes" value="{{ random }}" />
+        <DetailRow label="randomUUID" value="{{ uuid }}" />
+      </View>
+    </If>
+  </View>
+
+  <View gap="small">
+    <Text variant="subtitle">dash.utils</Text>
+    <Text variant="caption" tone="muted">Not Dash calls: dash.utils.base64 and dash.utils.hex run in the dot and answer at once, without await, for UTF-8 text.</Text>
+    <Button variant="secondary" onClick="encode">Encode the text</Button>
+    <If condition="{{ encoded }}">
+      <View variant="card" gap="none">
+        <DetailRow label="utils.base64.encode" value="{{ encoded }}" />
+      </View>
+    </If>
+  </View>
+
+  <If condition="{{ note }}">
+    <Notice tone="danger">{{ note }}</Notice>
+  </If>
+</View>

package/dist/templates/showcase/pages/dash/files/controller.ts

@@ -1,5 +1,3 @@
-import { errorMessage, unlessCancelled } from '@monimesl/dot-runtime';
-
 import type { Archive, Song } from './state';
 import state from './state';
 
@@ -65,24 +63,6 @@ export default definePage({
       await this.dash.storage.file.remove('setlist', { recursive: true });
       await this.actions.refresh();
     },
-    // A picked file goes when the dot closes, so it's saved into the dot's own folder.
-    async attach() {
-      try {
-        // Undefined when the person closes the picker, which isn't a problem.
-        const file = await unlessCancelled(
-          this.dash.storage.file.pick({ types: ['application/pdf', 'image/*'] }),
-        );
-        if (!file) {
-          return;
-        }
-        await this.dash.storage.file.createFolder('documents');
-        await this.dash.storage.file.save(file, `documents/${file.name}`, { overwrite: true });
-        this.setState({ attachNote: '' });
-        await this.actions.refresh();
-      } catch (error) {
-        this.setState({ attachNote: errorMessage(error) });
-      }
-    },
     async forgetPicture() {
       await this.dash.storage.file.remove(PICTURE);
       await this.actions.refresh();

package/dist/templates/showcase/pages/dash/files/state.ts

@@ -18,7 +18,6 @@ export default {
   archives: [] as Archive[],
   usage: '',
   picture: '',
-  // Files the person attached, kept in the dot's documents folder.
+  // Files saved into the dot's documents folder, such as a ticket from the dash.media page.
   documents: [] as FileEntry[],
-  attachNote: '',
 };

package/dist/templates/showcase/pages/dash/files/view.dml

@@ -42,18 +42,17 @@
   </View>
 
   <View gap="small">
-    <Text variant="subtitle">pick and save</Text>
-    <Text variant="caption" tone="muted">pick lets the person choose a file from the phone, with the files permission. A picked file goes when the dot closes, so save copies it into the dot's folder.</Text>
+    <Text variant="subtitle">save</Text>
+    <Text variant="caption" tone="muted">A picked photo or file, or a download, goes when the dot closes. save copies it into the dot's folder to keep it. These are the tickets kept on the dash.media page.</Text>
     <View variant="card" gap="small">
-      <Button variant="secondary" onClick="attach">Attach your concert ticket</Button>
       <For each="{{ documents }}" item="document" key="path">
         <View gap="none">
           <Text>{{ document.name }}</Text>
           <Text variant="caption" tone="muted">{{ document.path }}</Text>
         </View>
       </For>
-      <If condition="{{ attachNote }}">
-        <Text variant="caption" tone="muted">{{ attachNote }}</Text>
+      <If condition="{{ documents.length === 0 }}">
+        <Text variant="caption" tone="muted">None yet. On the dash.media page, attach a ticket and tap Keep it.</Text>
       </If>
     </View>
   </View>

package/dist/templates/showcase/pages/dash/media/controller.ts

@@ -22,6 +22,35 @@ export default definePage({
         this.setState({ note: errorMessage(error) });
       }
     },
+    async pickTicket() {
+      try {
+        const ticket = await unlessCancelled(
+          this.dash.media.pickFile({ types: ['application/pdf', 'image/*'] }),
+        );
+        if (!ticket) {
+          return;
+        }
+        const ticketSize = `${Math.round(ticket.size / 1024)} KB`;
+        this.setState({ ticket, ticketSize, ticketKept: false, note: '' });
+      } catch (error) {
+        this.setState({ note: errorMessage(error) });
+      }
+    },
+    // A picked file goes when the dot closes, so it's saved into the dot's own folder.
+    async keepTicket(state) {
+      if (!state.ticket) {
+        return;
+      }
+      try {
+        await this.dash.storage.file.createFolder('documents');
+        await this.dash.storage.file.save(state.ticket, `documents/${state.ticket.name}`, {
+          overwrite: true,
+        });
+        this.setState({ ticketKept: true, note: '' });
+      } catch (error) {
+        this.setState({ note: errorMessage(error) });
+      }
+    },
     async scanTicket() {
       try {
         const scanned = await unlessCancelled(this.dash.media.scanCode());

package/dist/templates/showcase/pages/dash/media/state.ts

@@ -3,6 +3,10 @@ import type { DotFile } from '@monimesl/dot-runtime';
 export default {
   photo: null as DotFile | null,
   photoDetails: '',
+  ticket: null as DotFile | null,
+  ticketSize: '',
+  // Whether the ticket was saved into the dot's documents folder.
+  ticketKept: false,
   scanned: '',
   note: '',
 };

package/dist/templates/showcase/pages/dash/media/view.dml

@@ -1,6 +1,6 @@
 <View>
   <Text variant="title">dash.media</Text>
-  <Text>Photos and codes from the camera. Each needs a permission in dot.json, which Dash asks the person for the first time.</Text>
+  <Text>Photos, files and codes from the phone. Each needs a permission in dot.json, which Dash asks the person for the first time.</Text>
 
   <View gap="small">
     <Text variant="subtitle">pickPhoto</Text>
@@ -17,6 +17,25 @@
     </View>
   </View>
 
+  <View gap="small">
+    <Text variant="subtitle">pickFile</Text>
+    <Text variant="caption" tone="muted">Lets the person choose a file from the phone, of at most 25 MB, with the files permission. types narrows what they can choose, here a PDF or a picture. Like a photo, it goes when the dot closes, so keep it with dash.storage.file.save.</Text>
+    <View variant="card" gap="small">
+      <Button variant="secondary" onClick="pickTicket">Attach your concert ticket</Button>
+      <If condition="{{ ticket }}">
+        <DetailRow label="Name" value="{{ ticket.name }}" />
+        <DetailRow label="Size" value="{{ ticketSize }}" />
+        <DetailRow label="Type" value="{{ ticket.contentType }}" />
+        <If condition="{{ ticketKept }}">
+          <Text variant="caption" tone="success">Kept in documents/. The dash.storage.file page lists it.</Text>
+        </If>
+        <Else>
+          <Button variant="secondary" onClick="keepTicket">Keep it</Button>
+        </Else>
+      </If>
+    </View>
+  </View>
+
   <View gap="small">
     <Text variant="subtitle">scanCode</Text>
     <Text variant="caption" tone="muted">Opens Dash's scanner until it reads a QR code. It needs the camera permission.</Text>

package/dist/templates/showcase/pages/dash/secrets/view.dml

@@ -1,6 +1,6 @@
 <View>
   <Text variant="title">dash.storage.secret</Text>
-  <Text>Secrets hold sign-in tokens from the dot's own server. Dash keeps them encrypted on the phone. A dot can keep up to 8, of up to 4 KB each.</Text>
+  <Text>Secrets hold sign-in tokens from the dot's own server. Dash keeps them encrypted on the phone. A dot can keep up to 32, of up to 4 KB each.</Text>
 
   <View gap="small">
     <Text variant="subtitle">set, get, remove and clear</Text>

package/dist/templates/showcase/pages/dash/system/controller.ts

@@ -77,10 +77,10 @@ export default definePage({
       }
     },
     async toggleTorch(state) {
-      const next = state.torch === 'on' ? 'off' : 'on';
+      const torchOn = !state.torchOn;
       try {
-        await this.dash.system.torch(next);
-        this.setState({ torch: next, note: '' });
+        await this.dash.system.torch(torchOn);
+        this.setState({ torchOn, note: '' });
       } catch (error) {
         this.setState({ note: errorMessage(error) });
       }

package/dist/templates/showcase/pages/dash/system/state.ts

@@ -1,8 +1,8 @@
-import type { SystemInfo, TorchState, VibrationStyle } from '@monimesl/dot-runtime';
+import type { SystemInfo, VibrationStyle } from '@monimesl/dot-runtime';
 
 export default {
   styles: ['light', 'medium', 'heavy', 'success', 'warning', 'error'] as VibrationStyle[],
-  torch: 'off' as TorchState,
+  torchOn: false,
   info: null as SystemInfo | null,
   // The ticket's QR code shows awake and bright, so a scanner at the door reads it.
   ticketShown: false,

package/dist/templates/showcase/pages/dash/system/view.dml

@@ -86,7 +86,7 @@
     <Text variant="subtitle">torch</Text>
     <Text variant="caption" tone="muted">Turns the camera's light on or off.</Text>
     <View variant="card">
-      <Button variant="secondary" onClick="toggleTorch">{{ torch === 'on' ? 'Turn the torch off' : 'Lights up for the slow song' }}</Button>
+      <Button variant="secondary" onClick="toggleTorch">{{ torchOn ? 'Turn the torch off' : 'Lights up for the slow song' }}</Button>
     </View>
   </View>
 

package/dist/templates/showcase/pages/index/state.ts

@@ -58,9 +58,21 @@ export default {
         {
           page: 'basics/bars',
           title: "Dash's bars",
-          covers: 'configs, setNavigationBar, setTabBar',
+          covers: 'configs, setNavigationBar, setTabBar, setColors',
           icon: 'settings',
         },
+        {
+          page: 'basics/colors',
+          title: 'Page colours',
+          covers: 'configs.colors, setColors, background, primary, surfaces',
+          icon: 'water',
+        },
+        {
+          page: 'basics/share',
+          title: 'Share links',
+          covers: "share, opening a link, checking a link's options",
+          icon: 'share',
+        },
       ],
     },
     {
@@ -167,7 +179,7 @@ export default {
         {
           page: 'dash/media',
           title: 'dash.media',
-          covers: 'pickPhoto, scanCode',
+          covers: 'pickPhoto, pickFile, scanCode',
           icon: 'image',
         },
         {
@@ -176,6 +188,19 @@ export default {
           covers: 'pickPhone',
           icon: 'users',
         },
+        {
+          page: 'dash/account',
+          title: 'dash.account',
+          covers: 'readProfile',
+          icon: 'user',
+        },
+        {
+          page: 'dash/crypto',
+          title: 'dash.crypto',
+          covers:
+            'sha256, sha512, hmac, randomBytes, randomUUID, and dash.utils for base64 and hex',
+          icon: 'lock',
+        },
         {
           page: 'dash/network',
           title: 'dash.network',
@@ -185,7 +210,7 @@ export default {
         {
           page: 'dash/files',
           title: 'dash.storage.file',
-          covers: 'write, read, list, move, copy, pick, save',
+          covers: 'write, read, list, move, copy, remove, save, stat, open, usage',
           icon: 'file',
         },
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monimesl/dot-cli",
-  "version": "0.1.0-alpha.21",
+  "version": "0.1.0-alpha.23",
   "description": "The dotctl command: build mini apps and run them in the simulator",
   "type": "module",
   "repository": {
@@ -24,11 +24,11 @@
   "dependencies": {
     "typescript": "^5.9.3",
     "uqr": "^0.1.3",
-    "@monimesl/dot-core": "0.1.0-alpha.21",
-    "@monimesl/dot-compiler": "0.1.0-alpha.21",
-    "@monimesl/dot-script-parser": "0.1.0-alpha.21",
-    "@monimesl/dot-dml-parser": "0.1.0-alpha.21",
-    "@monimesl/dot-simulator": "0.1.0-alpha.21"
+    "@monimesl/dot-compiler": "0.1.0-alpha.23",
+    "@monimesl/dot-core": "0.1.0-alpha.23",
+    "@monimesl/dot-dml-parser": "0.1.0-alpha.23",
+    "@monimesl/dot-script-parser": "0.1.0-alpha.23",
+    "@monimesl/dot-simulator": "0.1.0-alpha.23"
   },
   "devDependencies": {
     "@types/node": "^22.20.4",