Implement Responsive Client-Side Autoscaling

[Lightning11wins]

This PR adds responsive client-side autoscaling to HTML UIs generated by Centrallix.

After extracting changes into #87, #88, #89, and removing a few minor/unnecessary changes; this PR is hopefully slightly more manageable.

Known Issues

• Code that might break responsive layout.
  • widget/pane: resize action (test apps/kardia/modules/payroll/pay_form.app)
  • widget/image: offset & scale actions (not used anywhere)
  • widget/objcanvas: add_osrc_object()

GitHub Relationships

• Replaces Implement Responsive Client-Side Autoscaling (OLD) #85
  • Which replaced Implement Responsive Client-Side Autoscaling (DRAFT) #84
• Depends on Reduce Optimization Warnings #132
• Depends on Remove Obsolete sys_osml Widget Driver #99
• Depends on Qprintf Rewrite #97
  • Resolves qprintf() prints % and & inside skipped conditionals #140
• Depends on Add centrallix-lib Utilities #130
• Resolves Autoscaling/responsive widgets using CSS calc() #25
• Resolves aposSpaceOutLines() divides by zero, breaking layout #136
• Resolves Dropdown leaks its popup pane on ever data update #137
• Resolves Treeview rows overhang the right edge when indented #138
• Resolves Line and scatter charts render nothing for string x data #139
• Resolves apos discards authored flex values and caps flex to 100 #141
• Resolves textarea Widget Breaks Child Rendering #150

Dependent PRs must be reviewed and merged into master before this PR is reviewed to fix their changes appearing in the PR diff.

widget.xml Fixes

This branch

• Documented: 58/58 widgets (100%)
• Missing widget docs: 0
• Stale widget docs: 1
• Ignored widgets: 10
• Widget docs with errors: 3 (5%)
• Widget doc errors: 4 (~0.07/widget)
• Ignored errors: 25

master

• Documented: 48/61 widgets (79%)
• Missing widget docs: 13
• Stale widget docs: 1
• Ignored widgets: 10
• Widget docs with errors: 26 (54%)
• Widget doc errors: 172 (~3.58/widget)
• Ignored errors: 0

Greptile Summary

[greptile-apps]

Greptile Summary

This PR introduces responsive client-side autoscaling across server-side widget layout, generated HTML, and shared browser drivers, together with extensive widget documentation, sample applications, utility-library changes, and merged dependency work.

• Adds flexible geometry, inset, container, and responsive-layout behavior across the widget tree and browser runtime.
• Consolidates legacy text and image buttons into the button driver and expands autoscaling demonstrations and tests.
• Updates shared formatting, session, task, string, timer, query, and documentation infrastructure.
• One blocking regression remains in the rewritten session error formatter: unsupported printf conversions can corrupt subsequent variadic argument interpretation.

Confidence Score: 4/5

The PR is not yet safe to merge because the session error formatter can misread variadic arguments and crash while handling an error.

The new mssError implementation skips unsupported conversion tokens without consuming their arguments; existing formats that place %i before %s consequently pass an integer to the string handler, causing invalid memory access during failure reporting. All previous Greptile threads were manually resolved and do not remain outstanding.

Files Needing Attention: centrallix-lib/src/mtsession.c

Important Files Changed

Filename	Overview
centrallix/wgtr/apos.c	Refactors application positioning around responsive dimensions, flexibility, insets, and container geometry.
centrallix/htmlgen/ht_render.c	Updates generated-page assembly and shared rendering behavior for the revised widget and utility contracts.
centrallix-os/sys/js/htdrv_page.js	Revises page-wide client geometry, lifecycle, focus, loading, and responsive behavior.
centrallix-os/sys/js/htdrv_button.js	Consolidates browser behavior for text, image, and combined button variants.
centrallix-lib/src/qprintf.c	Reworks constrained formatting semantics and adds boolean and unsigned-long-long conversions with regression tests.
centrallix-lib/src/mtsession.c	Rewrites session error formatting but mishandles unsupported printf conversions, potentially crashing error paths.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    App[Application widget tree] --> Layout[Server autoscaling and layout]
    Layout --> Render[HTML and client parameter generation]
    Render --> Assets[Shared browser widget drivers]
    Assets --> Client[Responsive interactive UI]
    Client --> Resize[Viewport and container resize]
    Resize --> Assets

Loading

_{Reviews (15): Last reviewed commit: "Merge branch 'master' into apos_autoscal..." | Re-trigger Greptile}

[greptile-apps]

Additional Comments (1)

centrallix/htmlgen/ht_render.c
Missing thExcessiveRecursion() guard and NULL parent check in recursive helpers

ht_get_parent_w__INTERNAL and ht_get_parent_h__INTERNAL both recurse upward through the widget tree without:

1. A thExcessiveRecursion() check — required for all deeply recursive functions to prevent stack exhaustion.
2. A NULL guard on parent — if every ancestor has a negative width/height, the recursion will walk past the root node (Root->Parent == NULL) and dereference a null pointer.

int
ht_get_parent_w__INTERNAL(pWgtrNode widget)
    {
    if (thExcessiveRecursion())
        {
        mssError(1, "HTRND", "Resource exhaustion in ht_get_parent_w__INTERNAL");
        return 0;
        }
    const int cached_value = widget->fl_parent_w;
    if (cached_value != -1) return cached_value;
    const pWgtrNode parent = widget->Parent;
    if (!parent) return widget->fl_parent_w = 0;
    const int parentWidth = parent->width;
    return widget->fl_parent_w = (parentWidth >= 0)
        ? parentWidth - (parent->left + parent->right)
        : ht_get_parent_w__INTERNAL(parent);
    }

Apply the same fix to ht_get_parent_h__INTERNAL.

Context Used: Rule from dashboard - What: Use thExcessiveRecursion() checks in any deeply recursive functions.

Why: This prevents sta... (source)

[Lightning11wins]

@greptileai Can you rereview this and let me know if you have any other comments? Did I resolve your issues?

[Lightning11wins]

@greptileai Can you rereview this and let me know if you have any other comments? Did I resolve your issues?

[Lightning11wins]

@greptileai Can you rereview this and let me know if you have any other comments? Did I resolve your issues?

[Lightning11wins]

PR cleared for human review.

[Lightning11wins]

Note: I'd recommend merging #97 before this PR so that I can handle the inevitable merge conflict.

Also, I'm planning to do my own rereview of this code soon.

[Lightning11wins]

I'm looking over this project again and it looks like there's a lot that I could improve by adding additonal error handling.

[Lightning11wins]

@greptileai Please rereview this PR.

[Lightning11wins]

@greptileai Please rereview this PR.

[Lightning11wins]

@greptileai Please rereview this PR.

[Lightning11wins]

I've concluded that I probably can't fix the table row detail issues mentioned in the initial PR comment, and help would be nice for some of the other listed issues as well.

[Lightning11wins]

@greptileai Please rereview this PR anyway.

[Lightning11wins]

@greptileai I think I've addressed your previous comments. Please rereview this PR.