Update docs for modules

Author: eliot-akira

docs/pages/modules/fields/index.md

@@ -217,6 +217,28 @@ End-to-end tests with [Playwright](https://playwright.dev/).
 npm run e2e
 ```
 
+### Storybook
+
+Frontend workshop for building UI components and pages in isolation with [Storybook](https://storybook.js.org)
+
+Start Storybook in dev mode, to watch files and rebuild.
+
+```
+npm run storybook
+```
+
+It serves on a random port by default. To specify a port number:
+
+```
+npm run storybook -- -p 6006
+```
+
+Build Storybook for publishing.
+
+```
+npm run storybook:build
+```
+
 ## Render fields
 
 To render a field, we use `$fields->render_field`. It takes 2 arguments:

docs/pages/modules/roller/index.md

@@ -125,7 +125,7 @@ Create a file called `tangible.config.js` in your project folder.
 Example:
 
 ```js
-module.exports = {
+export default {
   build: [
     {
       src: 'src/index.js',
@@ -176,10 +176,162 @@ Its value is one of:
 
 The following optional task properties perform various substitutions.
 
-- `alias` - Map import module name to target module name or file path
-- `importToGlobal` - Map import module name to global variable name; supports dynamic name such as `@example/*`, for which a function should be given that takes the module name and returns the variable name
-- `globalToImport` - Map global variable name to import module name
-- `replaceStrings` - Map string to another string
+##### alias
+
+Using `alias` you can map an import module name to target another module name or file path. This uses rollup's [alias](https://github.com/rollup/plugins/tree/master/packages/alias#custom-resolvers) plugin under the hood.
+
+Here's an example use of the `alias` parameter:
+
+```js
+export default {
+  build: [
+    {
+      src: 'src/index.js',
+      dest: 'build/app.min.js',
+      alias: [
+        {
+          find: 'src',
+          replacement: path.resolve(projectRootDir, 'src')
+        }
+      ]
+    },
+  // ...
+}
+```
+
+##### importToGlobal
+
+Using `importToGlobal` you can map import module names to global variable names. It supports dynamic names such as `@example/*`, for which a function should be given that takes the module name and returns the variable name:
+
+```js
+export default {
+  build: [
+    {
+      src: 'src/index.js',
+      dest: 'build/app.min.js',
+      importToGlobal: {
+        '@my-namespace/*': 'myGlobalVar.*'
+      }
+    },
+  // ...
+}
+```
+
+In WordPress mode Roller imports `@wordpress/*` into the global variable `wp.*`.
+
+##### globalToImport
+
+Using `globalToImport` would be a reverse situation of using `importToGlobal`. Here you can map a global variable name to an import module name. This uses Rollup's [inject](https://github.com/rollup/plugins/tree/master/packages/inject) plugin under the hood.
+
+```js
+export default {
+  build: [
+    {
+      src: 'src/index.js',
+      dest: 'build/app.min.js',
+      globalToImport: {
+        // import { Promise } from 'es6-promise'
+        Promise: [ 'es6-promise', 'Promise' ],
+
+        // import { Promise as P } from 'es6-promise'
+        P: [ 'es6-promise', 'Promise' ],
+
+        // import $ from 'jquery'
+        $: 'jquery',
+
+        // import * as fs from 'fs'
+        fs: [ 'fs', '*' ],
+
+        // use a local module instead of a third-party one
+        'Object.assign': path.resolve( 'src/helpers/object-assign.js' ),
+      }
+    },
+  // ...
+}
+```
+
+##### replaceStrings
+
+Using `replaceStrings` you can [map a string to another string](https://github.com/rollup/plugins/tree/master/packages/replace) during script processing. It can be handy for replacing placeholders with actual values at build time.
+
+```js
+export default {
+  build: [
+    {
+      src: 'src/index.js',
+      dest: 'build/app.min.js',
+      replaceStrings: {
+        'process.env.NODE_ENV': 'production',
+        __buildDate__: () => new Date(),
+        __buildVersion__: 15
+      },
+      replaceInclude: [
+        path.resolve( 'some/path/' ),
+        /\.[jt]sx?$/,
+        /node_modules/
+      ]
+    },
+  // ...
+}
+```
+
+The given values are encoded with `JSON.stringify()`.
+
+By default, the string replacement applies to all files. Optionally use `replaceInclude` to specify an array of include file patterns.
+
+The above replacements will convert this:
+
+```js
+const buildTimeValues = {
+  date: __buildDate__,
+  version: __buildVersion__
+}
+```
+
+..into..
+
+```js
+const buildTimeValues = {
+  date: "2025-09-16T15:26:54.280Z",
+  version: 15
+}
+```
+
+##### replaceCode
+
+This is similar to `replaceStrings`, but it replaces the source with literal code instead of JSON string. It's useful for replacing a placeholder with code that evaluates to a value at run time.
+
+To demonstrate the difference:
+
+```js
+{
+  replaceCode: {
+    'process.env.NODE_ENV': '"production"'
+    __currentDate__: 'new Date()'
+    __currentVersion__: '15'
+  }
+}
+```
+
+The date constant will be replaced by the given code to get a new `Date` instance, instead of a string value evaluated at build time. The version constant will be replaced by the code `15`.
+
+The above replacements will convert this:
+
+```js
+const runTimeValues = {
+  date: __currentDate__,
+  version: __currentVersion__
+}
+```
+
+..into..
+
+```js
+const runTimeValues = {
+  date: new Date(),
+  version: 15
+}
+```
 
 #### HTML
 

docs/pages/modules/template-system/modules/index.md

@@ -25,6 +25,8 @@ Do not edit this file - Generated from https://github.com/tangibleinc/template-s
 - [Pager](pager)
 - [Prism](prism)
 - [Sass](sass)
+- [Select](select)
+- [Site structure](site-structure)
 - [Slider](slider)
 - [Sortable](sortable)
 - [Table](table)

docs/pages/modules/updater/index.md

@@ -70,6 +70,28 @@ add_action('plugins_loaded', function() {
 
 Register the plugin with its name and file path.
 
+### Framework
+
+When registering with the Framework module, the same plugin instance can be passed to the Updater.
+
+```php
+use tangible\framework;
+use tangible\updater;
+
+require_once __DIR__ . '/vendor/tangible/framework/index.php';
+require_once __DIR__ . '/vendor/tangible/updater/index.php';
+
+add_action('plugins_loaded', function() {
+
+  $plugin = framework\register_plugin([
+    'name' => 'example-plugin',
+    // ...
+  ]);
+
+  updater\register_plugin($plugin);
+});
+```
+
 ### Cloud
 
 Optionally set the property `cloud_id` to pass additional parameters to the update server.
@@ -78,13 +100,13 @@ Optionally set the property `cloud_id` to pass additional parameters to the upda
 updater\register_plugin([
   'name' => $plugin->name,
   'file' => __FILE__,
-  'cloud_id' => '',      // Plugin ID (Required)
-  'api' => '',           // Update API server's URL (Optional)
-  ]
+  'cloud_id' => '',       // Plugin ID (Required)
+  'updater_url' => '',    // Update server URL (Optional)
+  'activation_url' => '', // License activation URL (Optional)
 ]);
 ```
 
-#### License settings page
+### Licensing
 
 This feature requires a plugin to be registered with the [Framework](https://github.com/tangibleinc/framework) module, which adds a plugin settings page.