bare-script 4.2.0__tar.gz → 4.2.2__tar.gz

{bare_script-4.2.0/src/bare_script.egg-info → bare_script-4.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bare-script
-Version: 4.2.0
+Version: 4.2.2
 Summary: bare-script
 Home-page: https://github.com/craigahobbs/bare-script
 Author: Craig A. Hobbs
@@ -224,6 +224,20 @@ Once installed, you can prompt the assistant with tasks like:
 > Build a MarkdownUp application that plays tic-tac-toe against the user, with a reset button
 > and a running win/loss/draw tally rendered as a bar chart.
 
+To run the resulting MarkdownUp application locally, install the
+[markdown-up](https://pypi.org/project/markdown-up/) viewer and point it at the Markdown file:
+
+```
+pip install markdown-up
+markdown-up yourApp.md
+```
+
+The BareScript library is also documented as single-page Markdown, which can be fetched directly
+into an assistant's context alongside `SKILL.md`:
+
+- [The BareScript Library](https://craigahobbs.github.io/bare-script-py/library/barescript-library.md)
+- [The BareScript Library Models](https://craigahobbs.github.io/bare-script-py/library/barescript-library-model.md)
+
 
 ## Development
 

{bare_script-4.2.0 → bare_script-4.2.2}/README.md

@@ -199,6 +199,20 @@ Once installed, you can prompt the assistant with tasks like:
 > Build a MarkdownUp application that plays tic-tac-toe against the user, with a reset button
 > and a running win/loss/draw tally rendered as a bar chart.
 
+To run the resulting MarkdownUp application locally, install the
+[markdown-up](https://pypi.org/project/markdown-up/) viewer and point it at the Markdown file:
+
+```
+pip install markdown-up
+markdown-up yourApp.md
+```
+
+The BareScript library is also documented as single-page Markdown, which can be fetched directly
+into an assistant's context alongside `SKILL.md`:
+
+- [The BareScript Library](https://craigahobbs.github.io/bare-script-py/library/barescript-library.md)
+- [The BareScript Library Models](https://craigahobbs.github.io/bare-script-py/library/barescript-library-model.md)
+
 
 ## Development
 

{bare_script-4.2.0 → bare_script-4.2.2}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = bare-script
-version = 4.2.0
+version = 4.2.2
 url = https://github.com/craigahobbs/bare-script
 author = Craig A. Hobbs
 author_email = craigahobbs@gmail.com

{bare_script-4.2.0 → bare_script-4.2.2}/src/bare_script/include/data.bare

@@ -549,7 +549,10 @@ dataAggregationTypes = schemaParse( \
 # $group: data.bare
 # $doc: Sort a data array
 # $arg data: The data array
-# $arg sorts: The sort field-name/descending-sort tuples
+# $arg sorts: The array of sort tuples. Each tuple is a one- or two-element array, \[field\] or
+# $arg sorts: \[field, descending\]. "field" is the field name to sort by. "descending" is an
+# $arg sorts: optional boolean - if true, the field is sorted in descending order (default is
+# $arg sorts: ascending).
 # $return: The sorted data array
 function dataSort(data, sorts):
     return arraySort(data, systemPartial(dataSortCompare, sorts))
@@ -561,7 +564,7 @@ function dataSortCompare(sorts, row1, row2):
     result = 0
     for sort in sorts:
         field = arrayGet(sort, 0)
-        result = if(arrayGet(sort, 1), \
+        result = if(arrayLength(sort) >= 2 && arrayGet(sort, 1), \
             systemCompare(objectGet(row2, field), objectGet(row1, field)), \
             systemCompare(objectGet(row1, field), objectGet(row2, field)))
         if result != 0:

{bare_script-4.2.0 → bare_script-4.2.2}/src/bare_script/include/markdownUp.bare

@@ -332,6 +332,48 @@ function windowHeight():
 endfunction
 
 
+# $function: windowKeyState
+# $group: markdownUp.bare
+# $doc: Test whether a key combination is currently held down. Unlike `documentSetKeyDown`, which
+# $doc: fires a callback once per key press, this polls the live keyboard state and is intended for
+# $doc: game loops and animations. The modifier-key states must match exactly, so by default the key
+# $doc: must be pressed with no modifier keys held. For example:
+# $doc:
+# $doc: ```barescript
+# $doc: if windowKeyState('ArrowLeft'):
+# $doc:     playerX = playerX - playerSpeed
+# $doc: endif
+# $doc: if windowKeyState('ArrowRight'):
+# $doc:     playerX = playerX + playerSpeed
+# $doc: endif
+# $doc: ```
+# $doc:
+# $doc: The key is matched against the physical key code (e.g., "ArrowUp", "KeyW", "Space", "Enter").
+# $arg key: The physical key code (e.g., "ArrowUp", "ArrowDown", "KeyA", "KeyW", "Space")
+# $arg ctrl: If true, the control key must be down; if false (the default), it must be up
+# $arg shift: If true, the shift key must be down; if false (the default), it must be up
+# $arg alt: If true, the alt key must be down; if false (the default), it must be up
+# $arg meta: If true, the meta (command) key must be down; if false (the default), it must be up
+# $return: true if the key is down and all modifier-key states match, false otherwise
+function windowKeyState():
+endfunction
+
+
+# $function: windowPlaySound
+# $group: markdownUp.bare
+# $doc: Play a generated sound effect. Unknown sounds are ignored. The sound name is one of:
+# $doc:
+# $doc: - **UI** - "beep", "click", "error", "success", "warning"
+# $doc: - **Arcade** - "coin", "jump", "laser", "explosion", "powerup", "powerdown", "hit", "blip", "gameover"
+# $doc: - **Notes** - "noteC4", "noteCs4", "noteD4", "noteDs4", "noteE4", "noteF4", "noteFs4", "noteG4",
+# $doc:   "noteGs4", "noteA4", "noteAs4", "noteB4", "noteC5"
+# $doc: - **Drums** - "drumKick", "drumSnare", "drumHihat", "drumOpenhat", "drumTomLow", "drumTomMid",
+# $doc:   "drumTomHigh", "drumClap", "drumCrash", "drumRide"
+# $arg sound: The sound name
+function windowPlaySound():
+endfunction
+
+
 # $function: windowSetLocation
 # $group: markdownUp.bare
 # $doc: Navigate the browser window to a location URL

{bare_script-4.2.0 → bare_script-4.2.2/src/bare_script.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bare-script
-Version: 4.2.0
+Version: 4.2.2
 Summary: bare-script
 Home-page: https://github.com/craigahobbs/bare-script
 Author: Craig A. Hobbs
@@ -224,6 +224,20 @@ Once installed, you can prompt the assistant with tasks like:
 > Build a MarkdownUp application that plays tic-tac-toe against the user, with a reset button
 > and a running win/loss/draw tally rendered as a bar chart.
 
+To run the resulting MarkdownUp application locally, install the
+[markdown-up](https://pypi.org/project/markdown-up/) viewer and point it at the Markdown file:
+
+```
+pip install markdown-up
+markdown-up yourApp.md
+```
+
+The BareScript library is also documented as single-page Markdown, which can be fetched directly
+into an assistant's context alongside `SKILL.md`:
+
+- [The BareScript Library](https://craigahobbs.github.io/bare-script-py/library/barescript-library.md)
+- [The BareScript Library Models](https://craigahobbs.github.io/bare-script-py/library/barescript-library-model.md)
+
 
 ## Development