mirror of
https://github.com/actualbudget/actual.git
synced 2026-07-15 22:54:03 -05:00
[PR #7451] [CLOSED] [AI] Formula Feature Improvements: FORMATNUMBER, FORMATCURRENCY, and Tooltip Fixes #113992
Closed
opened 2026-06-05 21:19:01 -05:00 by GiteaMirror
·
0 comments
No Branch/Tag Specified
master
dependabot/npm_and_yarn/npm_and_yarn-cd62b4b37a
enforce-append-only-migrations-ci
claude/error-codes-worker-boundary-26i5uu
api-browser-custom-data-dir
tabedzki/feat/replacing-month-picker-with-day-picker
delay-initial-sync-until-loaded
jfdoming/mobile-app-build
cross-version-sync-compat
jfdoming/api-tokens-part-1
jfdoming/api-tokens-part-2
jfdoming/api-tokens-part-3
jfdoming/mobile-app-updates
claude/budget-version-migration-compat-151jlr
claude/worker-error-serialization-9iqtl7
claude/react-table-library-research-afx83z
claude/issue-8401-regression-test-9nw9l3
jfdoming/mobile-app-foundation-part-1
jfdoming/mobile-app-scaffold
release
ai-fix-cleanup-def-8290
claude/relaxed-shannon-jusywa
claude/fervent-keller-s6f2fq
claude/determined-feynman-st1y9z
claude/wizardly-einstein-vi2wce
claude/sweet-albattani-7nseio
feat/bank-sync-per-budget-file
claude/affectionate-cannon-y0kc82
claude/dependabot-findings-m9pgmb
claude/mac-app-ios-publish-zjs1lz
claude/vigilant-tesla-aiiyos
depot-migrate-secrets-1781296330308
claude/quirky-cerf-v5qck7
claude/animation-removal-alternative-2etfh1
claude/netlify-preview-comments-consolidate-9XPYa
osc/7391-error-boundaries-reports
claude/pensive-dijkstra-7DYui
claude/server-app-version-mismatch-HTCGv
claude/pr-8027-review-feedback-mELuO
claude/zealous-wozniak-e5pO0
claude/intelligent-heisenberg-BSHJq
claude/translation-download-refactor-jFRsO
claude/mobile-performance-ideas-G9PAO
claude/github-issue-7988-5A5ly
blacksmith-migration-ff70d2d
claude/great-mayer-KRvOk
claude/react-native-ios-compilation-fcJh5
claude/serene-goldberg-58xv0
claude/kind-euler-LVG3K
release-automation/edge-nightly
7710-bundle-migrations
claude/fix-docker-build-error-WMfed
claude/llm-compatible-release-notes-t20Nr
7710-tests-tdd
cursor/transaction-table-rewrite-f077
claude/plan-ci-secure-context-OtEe1
claude/fix-issue-7667-DPXi3
cursor/resolve-pr-7449-ee11
claude/fix-typescript-build-error-JPtZ5
copilot/add-repository-configs-to-packages
worktree-compressed-drifting-ritchie
claude/api-consumer-verification-kfz1K
pr-7454
claude/fix-issue-7410-LLLQ4
revert-7281-generate-icons
react-query-useSchedules
copilot/sub-pr-6140
package-upgrades
v26.7.0
v26.6.0
v26.5.2
v26.5.1
v26.5.0
v26.4.0
v26.3.0
v26.2.1
v26.2.0
v26.1.0
v25.12.0
v25.11.0
v25.10.0
v25.9.0
v25.8.0
v25.7.1
v25.7.0
v25.6.1
v25.6.0
v25.5.0
v25.4.0
v25.3.1
v25.3.0
v25.2.1
v25.2.0
v25.1.0
v24.12.0
v24.11.0
v24.10.1
v24.10.0
v24.9.0
v24.8.0
v24.7.0
v24.6.0
v24.5.0
v24.4.0
v24.3.0
v24.2.0
v24.1.0
v23.12.0
v23.11.0
v23.10.0
v23.9.0
v23.8.1
v23.8.0
v23.7.2
v23.7.1
v23.7.0
v23.6.0
v23.5.0
v23.4.2
v23.4.1
v23.4.0
v23.3.2
v23.3.0
v23.2.9
v23.2.5
v23.1.12
v22.12.9
Labels
Clear labels
AI generated
API
bank sync
budgeting
bug
can’t replicate
dependencies
docker
documentation
electron
experimental feature
feature
feedback
goal templates
good first issue
help wanted
importers
maintenance
needs info
needs testing
needs triage
needs votes
openid
payees
pull-request
regression
reports
responsive
rules
schedules
server
✨ merged
split transactions
tech debt
tech-support
theme
transaction import
transaction reconciliation
transactions
translations
upstream
user interface
✅ approved
wontfix
Mirrored from GitHub Pull Request
No Label
pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: github-starred/actual#113992
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
📋 Pull Request Information
Original PR: https://github.com/actualbudget/actual/pull/7451
Author: @lelemm
Created: 4/9/2026
Status: ❌ Closed
Base:
master← Head:cursor/formula-feedback-improvements-4223📝 Commits (10+)
517ac78[AI] Add FORMATNUMBER and FORMATCURRENCY functions to address TEXT() formatting limitations4b56f31[AI] Add support for line breaks in formula card resultsefae23f[AI] Remove unusable formula functions that require cell ranges00ee079[AI] Add comprehensive integration tests for formula rules and formula cards2bb86c4Potential fix for pull request finding 'Unused variable, import, function or class'837300c[AI] Make formatting functions respect app settings with locale-based fallbacks65f5a11Update VRT screenshots0a26108[AI] Fix type errors after rebase with masterfe0f903[autofix.ci] apply automated fixesd3dee95Add release notes for PR #7451📊 Changes
13 files changed (+2487 additions, -259 deletions)
View changed files
📝
packages/desktop-client/src/components/formula/codeMirror-excelLanguage.tsx(+21 -40)📝
packages/desktop-client/src/components/formula/queryModeFunctions.ts(+63 -198)📝
packages/desktop-client/src/components/formula/transactionModeFunctions.ts(+47 -5)📝
packages/desktop-client/src/components/reports/FormulaResult.tsx(+15 -5)📝
packages/desktop-client/src/hooks/useFormulaExecution.ts(+38 -11)📝
packages/desktop-electron/e2e/__screenshots__/onboarding.test.ts/Onboarding-checks-the-page-visuals-1-linux.png(+0 -0)➕
packages/loot-core/src/server/reports/formula-card-integration.test.ts(+739 -0)📝
packages/loot-core/src/server/rules/action.ts(+8 -0)📝
packages/loot-core/src/server/rules/customFunctions.ts(+173 -0)➕
packages/loot-core/src/server/rules/customFunctionsPreferences.ts(+141 -0)➕
packages/loot-core/src/server/rules/formula-action-integration.test.ts(+1159 -0)📝
packages/loot-core/src/server/rules/formula-action.test.ts(+77 -0)➕
upcoming-release-notes/7451.md(+6 -0)📄 Description
Summary
This PR addresses several user feedback items from issue #5949 regarding the formula card and formula rules feature.
Changes Made
1. FORMATNUMBER() Function (Addresses TEXT() formatting limitations)
Feedback: Users reported that
TEXT(QUERY("NetWorth"), "$#,##0.00")doesn't properly format numbers with thousands separators. The TEXT function in HyperFormula has limited format code support compared to Excel.Solution: Added a new
FORMATNUMBER()function that properly formats numbers with thousands separators and respects app settings.Usage:
Settings Integration:
2. FORMATCURRENCY() Function (Proper currency formatting)
Feedback: Users need proper currency formatting for formula cards with symbol, thousands separators, and decimal places.
Solution: Added a new
FORMATCURRENCY()function that formats numbers as currency and respects app currency settings.Usage:
Settings Integration:
Locale-based Defaults:
en-GB→ GBP (£)de/fr/es/it/nl→ EUR (€)ja→ JPY (¥)en-IN/hi→ INR (₹)en-CA→ CAD ($)en-AU→ AUD ($)Number Format Patterns:
comma-dot: 1,000.00 (US/UK/Canada)dot-comma: 1.000,00 (Europe)space-comma: 1 000,00 (France)apostrophe-dot: 1'000.00 (Switzerland)comma-dot-in: 1,00,000.00 (India)3. Line Break Support in Formula Cards ✨
Feedback: User @Juulz reported that line breaks don't work in formula cards, making multi-line displays ugly. Requested ability to use CHAR(10) or CHAR(13) in CONCATENATE.
Solution: Updated FormulaResult component to support multi-line text with proper rendering and font size calculation.
Usage:
Result:
Implementation:
whiteSpace: 'pre-wrap'to preserve line breakstextAlign: 'center'to keep multi-line text centered4. Formula Function Cleanup 🧹
Feedback: User requested review of all formula functions to remove ones that don't make sense in Actual's context.
Problem: Many Excel functions require cell ranges (like
A1:A10) which don't exist in Actual. Actual uses named expressions likeQUERY("myQuery")and transaction field variables likeamountordate.Solution: Removed 27 unusable functions from autocomplete suggestions:
Removed Functions:
AVERAGEA,COUNT,COUNTA,COUNTBLANK,COUNTIF,COUNTIFSQUERY_COUNT()insteadMAXA,MINA,SUMIF,SUMIFS,SUMPRODUCT,SUMSQQUERY()with filters insteadMEDIAN,MODE,STDEV,STDEVP,VAR,VARP,PERCENTILE,QUARTILE,RANKVLOOKUP,HLOOKUP,INDEX,MATCH,LOOKUPISREFKept Useful Functions:
SUM,AVERAGE,MAX,MIN,ROUND, etc.CONCATENATE,UPPER,LEFT,RIGHT, etc.TODAY,YEAR,MONTH,EOMONTH, etc.IF,AND,OR,IFERROR, etc.QUERY,QUERY_COUNT,BUDGET_QUERY, etc.CHOOSE(works with index and individual values)Impact: Autocomplete suggestions are now more relevant and less confusing. Users won't see functions they can't actually use.
5. Tooltip Quote Consistency Fix
Feedback: Tooltips used backticks around formula examples while actual usage used double quotes, causing confusion.
Solution: Removed backticks from all formula examples in tooltips for consistency. Examples now show formulas as plain text without wrapping backticks.
Before:
`=UPPER(notes)`After:
=UPPER(notes)6. Updated Documentation
queryModeFunctions.ts(for formula cards)transactionModeFunctions.ts(for formula rules)7. Comprehensive Integration Tests 🧪
Added 50 integration tests that validate formulas with real database operations:
Formula Rule Integration Tests (36 tests)
Tests validate formula execution with actual transaction data:
Formula Card Integration Tests (14 tests)
Tests validate formulas with real query results from database:
Test Quality:
Technical Implementation
Settings Architecture
Problem: HyperFormula custom functions are synchronous, but preferences are stored in async database.
Solution:
loadUserPreferencesForFormulas()async function that loads preferences onceSettings Priority:
This approach avoids unnecessary reactors while properly respecting user preferences!
Feedbacks Not Addressed (with reasoning)
BALANCEONDAY() Function
Feedback: Request for a function to get account balance on a specific date for credit card statement calculations.
Reason not implemented: This would require database access to query transaction history, which is not available in the formula execution context (both for formula cards and formula rules). The formula execution is designed to be stateless and work with the data provided in the context. Implementing this would require architectural changes to allow async database queries during formula execution.
Alternative approach: Users can currently achieve this by creating a query with appropriate date filters and using
QUERY()to get the sum of transactions up to that date.LASTSYNCEDBALANCE Variable
Feedback: Request for access to
lastSyncedBalancein custom pills/formulas.Reason not implemented: Similar to BALANCEONDAY, this would require access to account metadata that isn't available in the current formula execution context. The
balance_currentfield is stored in the accounts table and would need to be passed as a variable to the formula execution context.Alternative approach: This could be added in a future enhancement by extending the variable context passed to formula execution to include account metadata when the formula is executed in an account-specific context.
Dynamic "Last Month" Dropdown
Feedback: Request for dynamic time selection like "last month" in the hamburger menu for time selections.
Reason not in this PR: This is a UI/UX enhancement for the query time frame selector, not related to formula functions. This would be better addressed in a separate PR focused on the query configuration UI.
Testing
Code Comments
Throughout the code, I've added comments explaining which feedback triggered each change:
This makes it easy to trace each change back to the original user feedback.
Related Issue
Addresses feedback items from #5949
Bundle Stats
View detailed bundle stats
desktop-client
Total
Changeset (largest 100 files by percent change)
node_modules/@jlongster/sql.js/dist/sql-wasm.jsnode_modules/google-protobuf/google-protobuf.jshome/runner/work/actual/actual/packages/crdt/dist/index.jshome/runner/work/actual/actual/packages/loot-core/src/server/aql/compiler.tshome/runner/work/actual/actual/packages/loot-core/src/server/db/index.tsnode_modules/adm-zip/adm-zip.jshome/runner/work/actual/actual/packages/loot-core/src/server/sync/index.tsnode_modules/adm-zip/zipEntry.jshome/runner/work/actual/actual/packages/loot-core/src/server/aql/schema/index.tshome/runner/work/actual/actual/packages/loot-core/src/server/budget/envelope.tsnode_modules/adm-zip/zipFile.jsnode_modules/adm-zip/util/utils.jsnode_modules/adm-zip/headers/entryHeader.jshome/runner/work/actual/actual/packages/loot-core/src/server/budget/tracking.tshome/runner/work/actual/actual/packages/loot-core/src/server/budget/base.tshome/runner/work/actual/actual/packages/loot-core/src/server/aql/schema/executors.tshome/runner/work/actual/actual/packages/loot-core/src/server/db/sort.tshome/runner/work/actual/actual/packages/loot-core/src/server/aql/schema-helpers.tsnode_modules/murmurhash/murmurhash.jsnode_modules/adm-zip/methods/zipcrypto.jshome/runner/work/actual/actual/packages/loot-core/src/server/sync/encoder.tsnode_modules/adm-zip/headers/mainHeader.jshome/runner/work/actual/actual/packages/loot-core/src/server/models.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/sqlite/index.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/customFunctionsPreferences.tsnode_modules/adm-zip/util/errors.jshome/runner/work/actual/actual/packages/loot-core/src/platform/server/fs/path-join.tsnode_modules/adm-zip/util/constants.jshome/runner/work/actual/actual/packages/loot-core/src/server/aql/exec.tshome/runner/work/actual/actual/packages/loot-core/src/server/sheet.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/fs/index.tsnode_modules/adm-zip/util/fattr.jshome/runner/work/actual/actual/packages/loot-core/src/server/app.tshome/runner/work/actual/actual/packages/loot-core/src/server/encryption/encryption-internals.tsnode_modules/adm-zip/methods/inflater.jshome/runner/work/actual/actual/packages/loot-core/src/server/post.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/sqlite/unicodeLike.tsnode_modules/adm-zip/methods/deflater.jshome/runner/work/actual/actual/packages/loot-core/src/server/undo.tshome/runner/work/actual/actual/packages/loot-core/src/server/prefs.tshome/runner/work/actual/actual/packages/loot-core/src/server/server-config.tshome/runner/work/actual/actual/packages/loot-core/src/server/mutators.tsnode_modules/mitt/dist/mitt.mjshome/runner/work/actual/actual/packages/loot-core/src/platform/server/connection/index.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/fs/shared.tshome/runner/work/actual/actual/packages/loot-core/src/server/budget/util.tshome/runner/work/actual/actual/packages/loot-core/src/server/encryption/index.tshome/runner/work/actual/actual/packages/loot-core/src/server/sync/repair.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/fetch/index.tsnode_modules/adm-zip/util/index.jsnode_modules/adm-zip/util/decoder.jshome/runner/work/actual/actual/packages/loot-core/src/server/spreadsheet/globals.tsnode_modules/adm-zip/methods/index.jshome/runner/work/actual/actual/packages/loot-core/src/server/aql/index.tsnode_modules/adm-zip/headers/index.jshome/runner/work/actual/actual/packages/loot-core/src/server/db/util.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/sqlite/normalise.ts__vite-browser-externalhome/runner/work/actual/actual/packages/loot-core/src/server/main-app.tshome/runner/work/actual/actual/packages/loot-core/src/server/spreadsheet/util.tsnode_modules/absurd-sql/dist/indexeddb-backend.jshome/runner/work/actual/actual/packages/loot-core/src/server/cloud-storage.tshome/runner/work/actual/actual/packages/loot-core/src/shared/async.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/customFunctions.tshome/runner/work/actual/actual/packages/loot-core/src/server/errors.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/asyncStorage/index.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/action.tshome/runner/work/actual/actual/packages/loot-core/src/platform/server/indexeddb/index.tshome/runner/work/actual/actual/packages/loot-core/src/shared/normalisation.tssrc/components/formula/transactionModeFunctions.tssrc/components/reports/FormulaResult.tsxhome/runner/work/actual/actual/packages/loot-core/src/shared/util.tssrc/queries/aqlQuery.tssrc/hooks/useFormulaExecution.tssrc/undo/index.tssrc/tags/queries.tsnode_modules/chevrotain/lib_esm/src/parse/grammar/first.jssrc/hooks/useMetadataPref.tssrc/budget/mutations.tssrc/reports/queries.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/handlebars-helpers.tssrc/hooks/useTransactionBatchActions.tssrc/transactions/queries.tsnode_modules/handlebars/dist/cjs/handlebars/decorators/inline.jsnode_modules/moment/dist/moment.jssrc/components/ServerContext.tsxsrc/budget/queries.tsnode_modules/handlebars/dist/cjs/handlebars/helpers/block-helper-missing.jssrc/hooks/useSpreadsheet.tsxnode_modules/handlebars/dist/cjs/handlebars/logger.jshome/runner/work/actual/actual/packages/loot-core/src/shared/schedules.tsnode_modules/handlebars/dist/cjs/handlebars/helpers/with.jsnode_modules/handlebars/dist/cjs/handlebars/helpers/if.jsnode_modules/handlebars/dist/cjs/handlebars.runtime.jssrc/components/transactions/TransactionList.tsxnode_modules/chevrotain/lib_esm/src/parse/grammar/follow.jsnode_modules/source-map/lib/mapping-list.jsnode_modules/handlebars/dist/cjs/handlebars/helpers/each.jsnode_modules/handlebars/dist/cjs/handlebars/utils.jssrc/components/mobile/MobileNavTabs.tsxView detailed bundle breakdown
Added
No assets were added
Removed
No assets were removed
Bigger
Smaller
Unchanged
loot-core
Total
Changeset
home/runner/work/actual/actual/packages/loot-core/src/server/rules/customFunctionsPreferences.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/customFunctions.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/action.tsView detailed bundle breakdown
Added
Removed
Bigger
No assets were bigger
Smaller
No assets were smaller
Unchanged
No assets were unchanged
api
Total
Changeset
home/runner/work/actual/actual/packages/loot-core/src/server/rules/customFunctionsPreferences.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/customFunctions.tshome/runner/work/actual/actual/packages/loot-core/src/server/rules/action.tsView detailed bundle breakdown
Added
No assets were added
Removed
No assets were removed
Bigger
Smaller
No assets were smaller
Unchanged
cli
Total
View detailed bundle breakdown
Added
No assets were added
Removed
No assets were removed
Bigger
No assets were bigger
Smaller
No assets were smaller
Unchanged
crdt
Total
View detailed bundle breakdown
Added
No assets were added
Removed
No assets were removed
Bigger
No assets were bigger
Smaller
No assets were smaller
Unchanged
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.