@lowdefy/blocks-basic 0.0.0-experimental-20260928105334 → 0.0.0-experimental-20260929101721

package/dist/blocks/Icon/tests.yaml

@@ -17,38 +17,38 @@
 - id: properties.icon
   type: Icon
   properties:
-    name: AiOutlineRocket
+    name: Rocket
 - id: 'properties.disableLoadingIcon: true'
   type: Icon
   properties:
-    name: AiOutlineRocket
+    name: Rocket
     disableLoadingIcon: true
 - id: 'properties.size: 30'
   type: Icon
   properties:
-    name: AiOutlineRocket
+    name: Rocket
     size: 30
 - id: 'properties.rotate: 90'
   type: Icon
   properties:
-    name: AiOutlineRocket
+    name: Rocket
     size: 30
     rotate: 90
 - id: 'properties.spin: true'
   type: Icon
   properties:
-    name: AiOutlineRocket
+    name: Rocket
     size: 30
     spin: true
 - id: 'properties.color'
   type: Icon
   properties:
-    name: AiOutlineRocket
+    name: Rocket
     size: 25
     color: '#9c27b0'
 - id: 'properties.style: border: 1px solid red'
   type: Icon
   properties:
-    name: AiOutlineRocket
+    name: Rocket
     style:
       border: 1px solid red

package/dist/blocks/Img/meta.js

@@ -28,6 +28,7 @@
         properties: {
             src: {
                 type: 'string',
+                urlKind: 'src',
                 description: 'The image URL.'
             },
             alt: {
@@ -69,6 +70,7 @@
             },
             srcSet: {
                 type: 'string',
+                urlKind: 'srcSet',
                 description: 'Possible image sources for the user agent to use, strings separated by commas.',
                 docs: {
                     displayType: 'text-area'

package/dist/blocks/List/gallery.yaml

@@ -37,7 +37,7 @@
             flex: 0 0 auto
           properties:
             title: Add Note
-            icon: AiOutlinePlus
+            icon: add
             color: primary
             variant: solid
             size: small
@@ -66,7 +66,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            icon: AiOutlineClose
+            icon: close
             color: default
             variant: text
             shape: circle
@@ -135,7 +135,7 @@
             flex: 0 0 auto
           properties:
             title: Add Task
-            icon: AiOutlinePlus
+            icon: add
             color: primary
             variant: solid
             size: small
@@ -209,7 +209,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            icon: AiOutlineArrowUp
+            icon: arrow-up
             color: default
             variant: text
             size: small
@@ -228,7 +228,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            icon: AiOutlineArrowDown
+            icon: arrow-down
             color: default
             variant: text
             size: small
@@ -247,7 +247,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            icon: AiOutlineDelete
+            icon: delete
             color: danger
             variant: text
             size: small
@@ -272,7 +272,7 @@
             flex: 0 0 auto
           properties:
             title: Save Tasks
-            icon: AiOutlineSave
+            icon: save
             color: primary
             variant: solid
           events:
@@ -315,7 +315,7 @@
                 flex: 0 0 auto
               properties:
                 title: Load Users
-                icon: AiOutlineCloudDownload
+                icon: CloudDownload
                 color: primary
                 variant: solid
                 size: small
@@ -408,7 +408,7 @@
             flex: 0 0 auto
           properties:
             title: Add Line
-            icon: AiOutlinePlus
+            icon: add
             color: primary
             variant: dashed
             size: small
@@ -467,7 +467,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            icon: AiOutlineMinusCircle
+            icon: remove
             color: danger
             variant: text
             size: small
@@ -507,7 +507,7 @@
             flex: 0 0 auto
           properties:
             title: Submit Invoice
-            icon: AiOutlineSend
+            icon: send
             color: primary
             variant: solid
           events:

package/dist/blocks/PollingTimer/PollingTimer.js

@@ -0,0 +1,120 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { useEffect, useRef } from 'react';
+import { type } from '@lowdefy/helpers';
+import { withBlockDefaults } from '@lowdefy/block-utils';
+import validateInterval from './validateInterval.js';
+// Headless timer: renders nothing and fires onTick while running. Typically used to poll a
+// request until a background job completes. Each tick is scheduled "interval" ms after the
+// previous onTick actions finish, so a slow chain never overlaps the next tick.
+function PollingTimer({ methods, properties }) {
+    // Validated while rendering so an invalid interval reaches the block error boundary, instead
+    // of throwing from a timeout or visibility listener where nothing surfaces it.
+    validateInterval({
+        interval: properties.interval
+    });
+    const timeoutRef = useRef(null);
+    const scheduledIntervalRef = useRef(null);
+    const inFlightRef = useRef(false);
+    const runningRef = useRef(false);
+    const tickRef = useRef(0);
+    // Methods are registered once, so property changes are read through a ref.
+    const propertiesRef = useRef(properties);
+    propertiesRef.current = properties;
+    function hiddenAndPaused() {
+        if (propertiesRef.current.pauseWhenHidden === false) return false;
+        return document.visibilityState === 'hidden';
+    }
+    function clearScheduledTick() {
+        if (timeoutRef.current === null) return;
+        clearTimeout(timeoutRef.current);
+        timeoutRef.current = null;
+    }
+    function scheduleTick() {
+        if (!runningRef.current) return;
+        if (timeoutRef.current !== null) return;
+        // A tick in flight schedules the next one when its onTick actions finish.
+        if (inFlightRef.current) return;
+        if (hiddenAndPaused()) return;
+        const { interval } = propertiesRef.current;
+        scheduledIntervalRef.current = interval;
+        timeoutRef.current = setTimeout(tick, interval);
+    }
+    async function tick() {
+        timeoutRef.current = null;
+        tickRef.current += 1;
+        const { maxTicks } = propertiesRef.current;
+        if (type.isInt(maxTicks) && tickRef.current >= maxTicks) {
+            runningRef.current = false;
+        }
+        inFlightRef.current = true;
+        // The engine resolves triggerEvent once the chain finishes, including when an action fails.
+        await methods.triggerEvent({
+            name: 'onTick',
+            event: {
+                tick: tickRef.current
+            }
+        });
+        inFlightRef.current = false;
+        scheduleTick();
+    }
+    function start() {
+        if (runningRef.current) return;
+        tickRef.current = 0;
+        runningRef.current = true;
+        scheduleTick();
+    }
+    function stop() {
+        runningRef.current = false;
+        clearScheduledTick();
+    }
+    function toggle() {
+        if (runningRef.current) {
+            stop();
+            return;
+        }
+        start();
+    }
+    function onVisibilityChange() {
+        if (hiddenAndPaused()) {
+            clearScheduledTick();
+            return;
+        }
+        scheduleTick();
+    }
+    useEffect(()=>{
+        methods.registerMethod('start', start);
+        methods.registerMethod('stop', stop);
+        methods.registerMethod('toggle', toggle);
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        if (properties.autoStart === true) {
+            start();
+        }
+        return ()=>{
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            stop();
+        };
+    }, []);
+    useEffect(()=>{
+        if (timeoutRef.current === null) return;
+        if (scheduledIntervalRef.current === properties.interval) return;
+        clearScheduledTick();
+        scheduleTick();
+    }, [
+        properties.interval
+    ]);
+    return null;
+}
+export default withBlockDefaults(PollingTimer);

package/dist/blocks/PollingTimer/e2e.js

@@ -0,0 +1,21 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { createBlockHelper, escapeId } from '@lowdefy/e2e-utils';
+// PollingTimer renders nothing — assert on what onTick does, and use the block wrapper for
+// presence checks.
+const locator = (page, blockId)=>page.locator(`#bl-${escapeId(blockId)}`);
+export default createBlockHelper({
+    locator
+});

package/dist/blocks/PollingTimer/gallery.yaml

@@ -0,0 +1,190 @@
+# Copyright 2020-2026 Lowdefy, Inc
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+
+#     http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- title: Poll Until a Job Is Done
+  blocks:
+    - id: job_timer
+      type: PollingTimer
+      properties:
+        interval: 1000
+      events:
+        onTick:
+          # In an app this is a Request that fetches the job status. Here the job
+          # reports done on the fifth tick.
+          - id: job_timer_set_status
+            type: SetState
+            params:
+              job_status:
+                _if:
+                  test:
+                    _gte:
+                      - _event: tick
+                      - 5
+                  then: done
+                  else: running
+          - id: job_timer_stop_when_done
+            type: CallMethod
+            skip:
+              _ne:
+                - _state: job_status
+                - done
+            params:
+              blockId: job_timer
+              method: stop
+    - id: job_timer_controls
+      type: Box
+      layout:
+        gap: 8
+      blocks:
+        - id: job_timer_start
+          type: Button
+          properties:
+            title: Start Job
+            icon: CirclePlay
+          events:
+            onClick:
+              - id: job_timer_set_running
+                type: SetState
+                params:
+                  job_status: running
+              - id: job_timer_call_start
+                type: CallMethod
+                params:
+                  blockId: job_timer
+                  method: start
+        - id: job_timer_status
+          type: Span
+          properties:
+            content:
+              _nunjucks:
+                template: 'Job status: {{ status }}'
+                on:
+                  status:
+                    _if_none:
+                      - _state: job_status
+                      - not started
+
+- title: Start and Stop
+  blocks:
+    - id: manual_timer
+      type: PollingTimer
+      properties:
+        interval: 1000
+      events:
+        onTick:
+          - id: manual_timer_set_tick
+            type: SetState
+            params:
+              manual_ticks:
+                _event: tick
+    - id: manual_timer_controls
+      type: Box
+      layout:
+        gap: 8
+      blocks:
+        - id: manual_timer_start
+          type: Button
+          properties:
+            title: Start
+            icon: CirclePlay
+          events:
+            onClick:
+              - id: manual_timer_call_start
+                type: CallMethod
+                params:
+                  blockId: manual_timer
+                  method: start
+        - id: manual_timer_stop
+          type: Button
+          properties:
+            title: Stop
+            icon: CirclePause
+          events:
+            onClick:
+              - id: manual_timer_call_stop
+                type: CallMethod
+                params:
+                  blockId: manual_timer
+                  method: stop
+        - id: manual_timer_toggle
+          type: Button
+          properties:
+            title: Toggle
+            icon: ArrowRightLeft
+          events:
+            onClick:
+              - id: manual_timer_call_toggle
+                type: CallMethod
+                params:
+                  blockId: manual_timer
+                  method: toggle
+    - id: manual_timer_ticks
+      type: Span
+      properties:
+        content:
+          _nunjucks:
+            template: 'Ticks: {{ ticks }}'
+            on:
+              ticks:
+                _state: manual_ticks
+
+- title: Auto Start with a Tick Limit
+  blocks:
+    - id: limited_timer
+      type: PollingTimer
+      properties:
+        interval: 1000
+        autoStart: true
+        maxTicks: 5
+      events:
+        onTick:
+          - id: limited_timer_set_tick
+            type: SetState
+            params:
+              limited_ticks:
+                _event: tick
+    - id: limited_timer_ticks
+      type: Span
+      properties:
+        content:
+          _nunjucks:
+            template: 'Ticks: {{ ticks }} of 5'
+            on:
+              ticks:
+                _state: limited_ticks
+
+- title: Keep Ticking in a Hidden Tab
+  blocks:
+    - id: background_timer
+      type: PollingTimer
+      properties:
+        interval: 2000
+        autoStart: true
+        pauseWhenHidden: false
+      events:
+        onTick:
+          - id: background_timer_set_tick
+            type: SetState
+            params:
+              background_ticks:
+                _event: tick
+    - id: background_timer_ticks
+      type: Span
+      properties:
+        content:
+          _nunjucks:
+            template: 'Ticks while this tab was open or hidden: {{ ticks }}'
+            on:
+              ticks:
+                _state: background_ticks

package/dist/blocks/PollingTimer/meta.js

@@ -0,0 +1,61 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ export default {
+    category: 'display',
+    icons: [],
+    valueType: null,
+    events: {
+        onTick: {
+            description: 'Trigger actions on every tick while the timer is running. The next tick is scheduled `interval` ms after the `onTick` actions finish, so ticks never overlap.',
+            event: {
+                tick: 'The number of ticks since the timer was started, starting at 1.'
+            }
+        }
+    },
+    methods: {
+        start: 'Start the timer and reset the tick count to zero. The first tick fires after `interval` ms. Does nothing if the timer is already running.',
+        stop: 'Stop the timer. If `onTick` actions are running, they finish but no further tick is scheduled. Does nothing if the timer is not running.',
+        toggle: 'Start the timer if it is stopped, stop it if it is running.'
+    },
+    properties: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            interval: {
+                type: 'integer',
+                minimum: 1,
+                description: 'Milliseconds to wait after the `onTick` actions of one tick finish before the next tick fires. Changing it while the timer is waiting restarts the wait.'
+            },
+            autoStart: {
+                type: 'boolean',
+                default: false,
+                description: 'Start ticking when the block mounts. Off by default, so the timer is started with the `start` method.'
+            },
+            maxTicks: {
+                type: 'integer',
+                minimum: 1,
+                description: 'Stop the timer after this many ticks. The `onTick` event of the last tick is still triggered. Unlimited by default.'
+            },
+            pauseWhenHidden: {
+                type: 'boolean',
+                default: true,
+                description: 'Pause ticking while the browser tab is hidden (`document.visibilityState`), and resume when it becomes visible again. Ticks missed while hidden are not fired on resume; the next tick fires `interval` ms after the tab is visible.'
+            }
+        },
+        required: [
+            'interval'
+        ]
+    }
+};

package/dist/blocks/PollingTimer/validateInterval.js

@@ -0,0 +1,21 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+function validateInterval({ interval }) {
+    if (!type.isInt(interval) || interval < 1) {
+        throw new Error('PollingTimer "interval" should be a positive integer of milliseconds.');
+    }
+}
+export default validateInterval;

package/dist/blocks/Span/Span.js

@@ -13,13 +13,15 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import React from 'react';
-import { withBlockDefaults } from '@lowdefy/block-utils';
+import { isEventFromDomDescendant, withBlockDefaults } from '@lowdefy/block-utils';
 const Span = ({ blockId, classNames, content, events, methods, properties, styles })=>/*#__PURE__*/ React.createElement("span", {
         id: blockId,
         "data-testid": blockId,
-        onClick: ()=>methods.triggerEvent({
+        onClick: (event)=>{
+            if (isEventFromDomDescendant(event)) methods.triggerEvent({
                 name: 'onClick'
-            }),
+            });
+        },
         className: classNames?.element,
         style: {
             outline: 'none',

package/dist/blocks/Span/gallery.yaml

@@ -57,7 +57,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            name: AiOutlineInfoCircle
+            name: info
             size: 14
             color: '#1677ff'
         - id: span_content_area_text
@@ -305,7 +305,7 @@
               layout:
                 flex: 0 0 auto
               properties:
-                name: AiOutlineCheckCircle
+                name: check-circle
                 size: 14
                 color: '#52c41a'
             - id: span_nested_value_text
@@ -420,7 +420,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            name: AiOutlineSmile
+            name: FaceSlightlySmiling
             size: 16
             color: '#faad14'
         - id: span_icon_smile_label
@@ -442,7 +442,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            name: AiOutlineCheckCircle
+            name: check-circle
             size: 16
             color: '#52c41a'
         - id: span_icon_check_label
@@ -464,7 +464,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            name: AiOutlineWarning
+            name: warning
             size: 16
             color: '#ff4d4f'
         - id: span_icon_warning_label
@@ -514,7 +514,7 @@
               layout:
                 flex: 0 0 auto
               properties:
-                name: AiOutlineCheckCircle
+                name: check-circle
                 size: 14
                 color: '#52c41a'
             - id: span_order_shipped_text
@@ -616,7 +616,7 @@
           layout:
             flex: 0 0 auto
           properties:
-            name: AiOutlineUser
+            name: user
             size: 20
             color: '#1677ff'
         - id: span_profile_name

package/dist/blocks.js

@@ -21,5 +21,6 @@ export { default as Html } from './blocks/Html/Html.js';
 export { default as Icon } from './blocks/Icon/Icon.js';
 export { default as Img } from './blocks/Img/Img.js';
 export { default as List } from './blocks/List/List.js';
+export { default as PollingTimer } from './blocks/PollingTimer/PollingTimer.js';
 export { default as Span } from './blocks/Span/Span.js';
 export { default as Throw } from './blocks/Throw/Throw.js';

package/dist/e2e.js

@@ -21,5 +21,6 @@ export { default as Html } from './blocks/Html/e2e.js';
 export { default as Icon } from './blocks/Icon/e2e.js';
 export { default as Img } from './blocks/Img/e2e.js';
 export { default as List } from './blocks/List/e2e.js';
+export { default as PollingTimer } from './blocks/PollingTimer/e2e.js';
 export { default as Span } from './blocks/Span/e2e.js';
 export { default as Throw } from './blocks/Throw/e2e.js';

package/dist/metas.js

@@ -21,5 +21,6 @@ export { default as Html } from './blocks/Html/meta.js';
 export { default as Icon } from './blocks/Icon/meta.js';
 export { default as Img } from './blocks/Img/meta.js';
 export { default as List } from './blocks/List/meta.js';
+export { default as PollingTimer } from './blocks/PollingTimer/meta.js';
 export { default as Span } from './blocks/Span/meta.js';
 export { default as Throw } from './blocks/Throw/meta.js';