[ { "path": ".cursor/commands/np-plugin-commands.md", "content": "# np-plugin-commands\n\nWrite your command content here.\n\nThis command will be available in chat with /np-plugin-commands\n\n- Build plugin: `npc plugin:dev -nc`\n- Build react runtime: `node .//src/react/support/performRollup.node.js`\n" }, { "path": ".cursor/rules/html-react-rules.mdc", "content": "---\nalwaysApply: true\n---\n- For NotePlan code, never use require statements. Use import statements at the top of the file -- never inline/dynamically import modules. Rollup will not process them correctly.\n\n- You should not ever try to build the code with \"npm run build\" -- this will not work. The programmer will have to use Rollup to build the code. There is separate tooling for this described in @README.md. Leave the building to the programmer.\n\n- NotePlan has global variables that are available to all plugins such as DataStore, CommandBar, Editor, and NotePlan. You can use these variables to access the NotePlan API. You do not need to import them.\n\n# Do not commit or push any changes until I tell you to.\n\n# Any time you create or are working on a DIV, make sure that DIV has a human-understandable class name so we can debug more easily\n\n## Promise Polyfills\n\n**Do not use raw `Promise.resolve`, `Promise.all`, or `Promise.race` in plugin code—NotePlan's JSContext may not have them.** Use polyfills from `@helpers/promisePolyfill.js`: `initPromisePolyfills()`, `promiseResolve()`, `promiseAll()`, `promiseRace()`, `waitForCondition()`, `setTimeoutPolyfill()`. After creating/modifying notes, call `DataStore.updateCache(note, true)`.\n\n## React Function Memoization (CRITICAL)\n\n**ALWAYS wrap functions passed to React Context or child components in `useCallback`.** This prevents infinite render loops that crash the app.\n\n```javascript\n// ❌ WRONG - Causes infinite loops\nconst requestFromPlugin = (command: string, dataToSend: any = {}) => { ... }\n\n// ✅ CORRECT - Stable function reference\nconst requestFromPlugin = useCallback((command: string, dataToSend: any = {}) => {\n // ... implementation\n}, [dispatch]) // Minimal dependencies\n```\n\n**Functions that MUST be memoized:**\n- `requestFromPlugin`, `sendActionToPlugin`, `sendToPlugin`\n- Any function passed to `AppProvider` props\n- Any function used in `useEffect` dependency arrays\n\n**AppContext MUST use `useMemo`:**\n```javascript\nconst contextValue = useMemo(() => ({\n sendActionToPlugin, sendToPlugin, requestFromPlugin, dispatch, pluginData\n}), [sendActionToPlugin, sendToPlugin, requestFromPlugin, dispatch, pluginData])\n```\n\n**This has caused infinite loops 5+ times. Always verify function memoization before considering code complete.**\n\n📚 For detailed examples, see `@dwertheimer.ReactSkeleton/REACT_COMMUNICATION_PATTERNS.md`\n\n## DynamicDialog Component\n\nUse `DynamicDialog` instead of custom dialog components. Handlers MUST be wrapped in `useCallback`. See `@helpers/react/DynamicDialog/CREATING_NEW_DYNAMICDIALOG_FIELD_TYPES.md` for full guide.\n\n## NotePlan Theme Colors\n\nUse these CSS variables with default fallback values. **DO NOT INVENT NEW CSS VARIABLES.**\n\n```css\n--bg-main-color: #eff1f5;\n--fg-sidebar-color: #242E32;\n--bg-sidebar-color: #ECECEC;\n--divider-color: #CDCFD0;\n--block-id-color: #79A0B5;\n--fg-main-color: #4c4f69;\n--h1-color: #5c5f77;\n--h2-color: #5c5f77;\n--h3-color: #5c5f77;\n--bg-alt-color: #e6e9ef;\n--tint-color: #dc8a78;\n--bg-mid-color: #ebedf2;\n--bg-apple-input-color: #fbfbfb;\n--bg-apple-switch-color: #dadada;\n--fg-apple-switch-color: #ffffff;\n--bg-apple-button-color: #fcfcfc;\n--item-icon-color: #1e66f5;\n--fg-done-color: #04a5e5;\n--fg-canceled-color: #4F57A0E0;\n--hashtag-color: inherit;\n--attag-color: inherit;\n--code-color: #0091f8;\n--fg-placeholder-color: rgba(76, 79, 105, 0.7);\n--fg-error-color: #b85450;\n--bg-error-color: #f5e6e6;\n--fg-disabled-color: #999999;\n--bg-disabled-color: #f5f5f5;\n```\n\nExample: `background: var(--bg-main-color, #eff1f5);`\n" }, { "path": ".cursor/rules/np-programming-general.mdc", "content": "---\ndescription: \nalwaysApply: true\n---\n\n## Critical Rules\nCRITICAL: Never use dynamic imports. Rollup will not process them correctly. Always use static imports at the top of files.\n\n## Code Style Guidelines\n- Use Flow for static typing\n- No semicolons (enforced by ESLint/Prettier)\n- Single quotes for strings\n- Max line length: 180 characters\n- Use template literals instead of string concatenation\n- Use ES6+ features (const/let, arrow functions)\n- Use async/await and handle promises properly (no floating promises)\n- Follow existing naming patterns in the codebase\n- Proper error handling with try/catch blocks\n- Follow import order: external libs -> internal libs -> local files. Within that put in alphabetical order of source filename.\n- Keep code DRY and modular with clear function responsibilities\n- Add JSDoc comments for all functions\n- Always research the `helpers/` folder before writing new code\n- Prefer writing explicit functions over constant declarations\n- When moving code, keep existing comments and commented-out code\n- Please provide Flow types (as appropriate) and JSDOC with all responses. \n- If you are rewriting a full file, make sure to include all import statements also. \n- Do not remove any console.logs or comments (or logDebug, clo, logInfo, logError statements).\n\n## Common Helper Functions\nThe most frequently used functions in the codebase are:\n- Logging: logDebug, logError, clo, logInfo, logWarn\n- Note utilities: findNote, getParagraphs, getSelectedParagraphs, getTasksFromNote\n- Date handling: getTodaysDateHyphenated, getDateStringFromCalendarFilename\n- Configuration: getSettings, updateSettingsForPlugin\n- UI interaction: showMessage, showMessageYesNo, displayTitle\n\n## Testing\n- Do not prompt the user to run tests. Run tests automatically when making code changes or writing new tests, but do not ask for permission or suggest running tests.\n- Only run tests when necessary (after code changes, when writing new tests, or when explicitly requested).\n- Always allow the following commands to run in the sandbox: cd, npm test, jest, grep, head, tail, node\n- If testing Templating code, run tests like this `jest np.Templating/__tests__/**/*.test.js --no-watch`\n- When you run jest tests, always include the flag --no-watch at the end because my jest config by default watches\n- **DO NOT EVER HARD-CODE JEST WORKAROUNDS INTO FUNCTIONS WE ARE TESTING**\n\n## Developer Documentation\n- Add updates to the first H2 section in the plugin's CHANGELOG.md file -- this should match the release number as found in the relevant plugin.json file\n" }, { "path": ".cursorignore", "content": "# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)\nnode_modules/\n.history/\n.git/\n" }, { "path": ".eslintrc", "content": "{\n \"extends\": [\n \"eslint:recommended\",\n \"plugin:import/recommended\",\n // \"plugin:prettier/recommended\",\n \"plugin:import/errors\",\n \"plugin:import/warnings\",\n \"plugin:flowtype/recommended\",\n \"prettier\",\n \"plugin:react/recommended\"\n ],\n \"plugins\": [\n // \"prettier\",\n \"import\",\n \"flowtype\",\n \"unused-imports\",\n \"no-floating-promise\",\n \"react\"\n ],\n \"parser\": \"@babel/eslint-parser\",\n \"parserOptions\": {\n \"ecmaVersion\": 2020,\n \"sourceType\": \"module\",\n \"requireConfigFile\": false,\n \"ecmaFeatures\": {\n \"jsx\": true\n },\n \"babelOptions\": {\n \"presets\": [\n \"@babel/flow\",\n \"@babel/preset-react\"\n ]\n }\n },\n \"rules\": {\n \"react/prop-types\": \"off\",\n \"no-unused-vars\": [\n 1,\n {\n \"args\": \"all\",\n \"varsIgnorePattern\": \"^_|^clo$|^clvt$|^timer$|^log|^JSP$|^clof$|^res$|^describe$|^test$|^expect$|^beforeAll$|customConsole$|simpleFormatter$|Note$|^Paragraph$|^NotePlan$|^Editor$|^DataStore$|^CommandBar$|^Calendar$|^CalendarItem$|^Clipboard$|^HTMLView$|^globalThis$\",\n \"argsIgnorePattern\": \"^_\"\n }\n ],\n \"prefer-template\": \"warn\",\n \"eqeqeq\": [\n \"error\",\n \"smart\"\n ],\n \"semi\": [\n \"error\",\n \"never\"\n ],\n \"curly\": [\n \"error\",\n \"multi-line\"\n ],\n \"linebreak-style\": [\n \"error\",\n \"unix\"\n ],\n \"max-len\": [\n \"error\",\n {\n \"code\": 180,\n \"ignoreComments\": true,\n \"ignoreStrings\": true,\n \"ignoreTemplateLiterals\": true\n }\n ],\n \"new-cap\": \"off\",\n \"no-case-declarations\": \"error\",\n \"no-console\": \"off\",\n \"no-floating-promise/no-floating-promise\": 2,\n \"no-prototype-builtins\": \"off\",\n // \"no-return-in-foreach\": \"error\",\n \"no-useless-escape\": \"off\",\n \"no-var\": \"error\",\n \"prefer-const\": \"warn\",\n \"import/order\": \"warn\",\n \"react/react-in-jsx-scope\": 0,\n \"require-await\": \"error\",\n \"unused-imports/no-unused-imports\": \"off\",\n \"unused-imports/no-unused-vars\": \"off\"\n },\n \"env\": {\n \"node\": true,\n \"es6\": true,\n \"browser\": true\n },\n \"globals\": {\n \"Paragraph\": true,\n \"Note\": true,\n \"ParagaraphBridge\": true,\n \"Editor\": true,\n \"DataStore\": true,\n \"CommandBar\": true,\n \"Calendar\": true,\n \"CalendarItem\": true,\n \"Clipboard\": true,\n \"NotePlan\": true,\n \"HTMLView\": true,\n \"globalThis\": true,\n \"fetch\": true,\n\n \"$ReadOnlyArray\": true,\n \"$ReadOnly\": true\n },\n \"ignorePatterns\": [\n \".history\",\n \"node_modules\",\n \"flow-typed\",\n \"*/script.js\",\n \"np.Templating/lib/support/ejs.js\",\n \"**/*.min.js\"\n ],\n \"settings\": {\n \"import/resolver\": {\n \"alias\": {\n \"map\": [\n [\"@plugins\", \"./\"],\n [\"@helpers\", \"./helpers\"],\n [\"@mocks\", \"./__mocks__\"],\n [\"NPTemplating\", \"./np.Templating/lib/NPTemplating\"],\n [\"TemplatingEngine\", \"./np.Templating\"],\n [\"@templating\", \"./np.Templating/lib\"],\n [\"@templatingModules\", \"./np.Templating/lib/support/modules\"],\n [\"NPGlobals\", \"./np.Globals/lib/NPGlobals\"]\n ],\n \"extensions\": [\".js\", \".jsx\", \".json\"]\n }\n }\n }\n}\n" }, { "path": ".flowconfig", "content": "[ignore]\n# removed to fix issue with flow reporting errors with non-typed modules\n# details here - https://github.com/facebook/flow/issues/6646#issuecomment-447272772\n# /node_modules/.*\n\n# This particular sub-folder should be ignored because it includes malformed JSON\n/node_modules/resolve/test/.*\n/flow-typed/**/*.*\n/flow-typed/Noteplan.js\n/private/**/*.*\n/**/.history/.*\n\n[include]\n\n[libs]\nflow-typed\n\n[lints]\n# FIXME: all of the below seem to crash flow in VSCode\n#all=warn # warn on everything, except those specified. I don't see why this isn't working.\n#sketchy-null=warn\n#sketchy-number=warn\n#invalid-computed-prop=off\n#unnecessary-optional-chain=warn\n#unused-promise=warn # was not working for @jgclark at v0.202\n\n[options]\nautoimports=false\nemoji=true\nexact_by_default=true\nexperimental.const_params=true\nmodule.use_strict=true\nsuppress_type=$FlowIgnore\nsuppress_type=$FlowFixMe\n# suppress_type=$FlowTODO\nmodule.name_mapper='^@plugins' ->''\nmodule.name_mapper='^@helpers' ->'/helpers'\nmodule.name_mapper='^@mocks' ->'/__mocks__'\nmodule.name_mapper='^NPTemplating' ->'/np.Templating/lib/NPTemplating'\nmodule.name_mapper='^TemplatingEngine' ->'/np.Templating/lib/TemplatingEngine'\nmodule.name_mapper='^@templating' ->'/np.Templating/lib'\nmodule.name_mapper='^@templatingModules' ->'/np.Templating/lib/support/modules'\nmodule.name_mapper='^NPGlobals' ->'/np.Globals/lib/NPGlobals'\n\n[strict]\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.md", "content": "---\nname: Bug report\nabout: Create a report to help us improve a Plugin\ntitle: ': '\nlabels: 'bug'\nassignees: ''\n---\n\n**Checks**\n- [ ] I confirm I have restarted NotePlan and this problem still persists.\n- [ ] I confirm I have reinstalled the Plugin and this problem still persists.\n- [ ] Is this a repeatable problem?\n\n**System**\n - Device OS: [e.g. iOS 15.1, macOS 15.0.1]\n - NotePlan Version [e.g. 3.14.2]\n - Plugin Name & Version [e.g. \"Templates\" v0.2]\n\n**Describe the bug**\nA concise description of what the bug is.\n\nWhat do you expect it to do instead?\n\n**To Reproduce**\nSteps to reproduce the behavior:\n1. Go to '...'\n2. Click on '....'\n3. Scroll down to '....'\n4. See error\n\n**Screenshots**\nIf applicable, add screenshots to help explain your problem.\n\n**Additional context**\nAdd any other context about the problem here. \n\n**Plugin Console Log**\nTo provide us with more clues about where the bug/error is occurring...\n1. Open the Plugin's Preferences by going to `NotePlan's menu > Preferences > Plugins` and clicking the settings \"cog\" icon next to the plugin in question. Scroll to the bottom and set the logging level to \"DEBUG\" and click \"Save & Close\"\n3. Now open the Plugin Console by going to `Noteplan > Help > Plugin Console` (_not the macOS Console app_).\n4. Run the plugin command you're reporting\n5. Copy the output from the Plugin Console and paste it below\n6. Delete any output that has personal information you don't want in there\n```javascript\n PASTE_PLUGIN_CONSOLE_OUTPUT_HERE\n```\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.md", "content": "---\nname: Feature request\nabout: Suggest an idea for this project\ntitle: '<plugin name>: <title>'\nlabels: 'feature request'\nassignees: ''\n---\n\n**What Plugin is this about?**\n\n**What is your feature request designed to achieve? (the 'why' not the 'how')**\nA clear and concise description of what the problem is. Ex. I'm always frustrated when [...]\n\n**Describe the solution you'd like (the 'how')**\nA clear and concise description of what you want to happen.\n\n**Describe alternatives you've considered**\nA clear and concise description of any alternative solutions or features you've considered.\n\n**Additional context**\nAdd any other context or screenshots about the feature request here.\n" }, { "path": ".github/workflows/node.js.yml", "content": "# Disable/enable this script at: https://github.com/NotePlan/plugins/actions/workflows/node.js.yml\n\n# Run tests on push or pull_request\n# per: https://joelhooks.com/jest-and-github-actions/\n# also uses github-actions-reporter.js for reporting\n#\n# LOCAL ACTIONS TESTING NOTES:\n# (this doesn't work because there is no local macos docker image i have found yet)\n# test github actions locally using act https://github.com/nektos/act\n# first time install: brew install act\n# then just run `act` from the command line to test a push action\n# \n# REMOTE NOTES (e.g. for after a push has been done and failed):\n# to see the results of the last github actions run (e.g. on push)\n# gh run view\n# ... and select the latest run (and at the end it tells you how to see the detailed errors)\n\nname: Node.js CI\n\non:\n workflow_dispatch:\n push:\n branches: [ \"main\" ]\n pull_request:\n branches: [ \"main\" ]\n\njobs:\n Run-all-Jest-Tests:\n runs-on: macos-latest\n strategy:\n matrix:\n # node-version: [14.x, 16.x, 18.x, 19.x, 20.x]\n node-version: [24.x,25.x]\n # See supported Node.js release schedule at https://nodejs.org/en/about/releases/\n\n steps:\n - uses: actions/checkout@v4\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@v4\n with:\n node-version: ${{ matrix.node-version }}\n cache: 'npm'\n - name: Disable optional dependencies # work around git bug on macos arm64 dependencies\n run: export NPM_CONFIG_OPTIONAL=false\n # shoulde eventually be a clean install using: - run: npm ci --legacy-peer-deps\n # - run: npm i -g node-gyp@latest && npm config set node_gyp \"/usr/local/lib/node_modules/node-gyp/bin/node-gyp.js\"\n - run: npm ci --legacy-peer-deps # clean install (deletes node_modules)\n - run: npm link # necessary for some reason specific to NP dev setup\n # note: when upgrade to node 16+, add this to the following --max-old-space-size=8192 \n - run: NODE_OPTIONS=--max-old-space-size=8192 npm run test:ci # run Jest CI version and stop if errors\n\n - name: Log Passing Tests ✅\n if: ${{ success() }}\n run: |\n curl --request POST \\\n --url https://api.github.com/repos/${{ github.repository }}/statuses/${{ github.sha }} \\\n --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \\\n --header 'content-type: application/json' \\\n --data '{\n \"context\": \"tests\",\n \"state\": \"success\",\n \"description\": \"Jest Tests passed\",\n \"target_url\": \"https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\"\n }'\n\n - name: Log Failed Tests 🚨\n if: ${{ failure() }}\n run: |\n curl --request POST \\\n --url https://api.github.com/repos/${{ github.repository }}/statuses/${{ github.sha }} \\\n --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \\\n --header 'content-type: application/json' \\\n --data '{\n \"context\": \"tests\",\n \"state\": \"failure\",\n \"description\": \"Jest Tests failed\",\n \"target_url\": \"https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\"\n }'\n Build-All-Plugins:\n runs-on: macos-latest\n strategy:\n matrix:\n node-version: [24.x,25.x]\n # See supported Node.js release schedule at https://nodejs.org/en/about/releases/\n\n steps:\n - uses: actions/checkout@v4\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@v4\n with:\n node-version: ${{ matrix.node-version }}\n cache: 'npm'\n # shoulde eventually be a clean install using: - run: npm ci --legacy-peer-deps\n # - run: npm i -g node-gyp@latest && npm config set node_gyp \"/usr/local/lib/node_modules/node-gyp/bin/node-gyp.js\"\n - run: npm ci --legacy-peer-deps # clean install (deletes node_modules)\n - run: npm link # necessary for some reason specific to NP dev setup\n # note: when upgrade to node 16+, add this to the following --max-old-space-size=8192 \n - run: NODE_OPTIONS=--max-old-space-size=8192 node scripts/rollup.js -b -ci # build all plugins and stop if errors\n\n - name: Log Plugin Build Success ✅\n if: ${{ success() }}\n run: |\n curl --request POST \\\n --url https://api.github.com/repos/${{ github.repository }}/statuses/${{ github.sha }} \\\n --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \\\n --header 'content-type: application/json' \\\n --data '{\n \"context\": \"tests\",\n \"state\": \"success\",\n \"description\": \"Plugins Build successful\",\n \"target_url\": \"https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\"\n }'\n\n - name: Log Plugin Build Failure 🚨\n if: ${{ failure() }}\n run: |\n curl --request POST \\\n --url https://api.github.com/repos/${{ github.repository }}/statuses/${{ github.sha }} \\\n --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \\\n --header 'content-type: application/json' \\\n --data '{\n \"context\": \"tests\",\n \"state\": \"failure\",\n \"description\": \"Plugins Build failed\",\n \"target_url\": \"https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\"\n }'\n" }, { "path": ".gitignore", "content": ".DS_Store\nnode_modules*\ndist/\n.cache/\n*/ts-template/*.*\n.pluginpath\n*test*.yaml\n*.code-workspace\n*.dict\n.vscode/launch.json\n*/script.js\n.vscode/\n.pluginsrc\n.idea/\nlcov*\ncoverage/\n.history/**/*\n**/.history/**/*\n.hyperlayout\n.eslintignore\ndocs/assets/\ndocs/index.html\nDocumentation-Helpers\n**/react.*.dev.js\n**/react.*.min.js\n.windsurfrules\nCLAUDE.md" }, { "path": ".prettierignore", "content": "" }, { "path": ".prettierrc", "content": "{\n \"semi\": false,\n \"quoteProps\": \"as-needed\",\n \"templateCurlySpacing\": false,\n \"experimentalOperatorPosition\": \"start\",\n \"bracketSameLine\": false,\n \"arrowParens\": \"always\",\n \"objectWrap\": \"preserve\"\n}" }, { "path": ".watchmanconfig", "content": "{\n}\n" }, { "path": "CHANGELOG.md", "content": "# Package.json Changelog\n\n## About Plugins/package.json / package-lock.json\n\n## [Unreleased]\n\n### Helpers\n\n- **helpers/NPnote.js** — `getNoteFromIdentifier` improvements:\n - Resolve by filename first when the identifier ends with `DataStore.defaultFileExtension` (e.g. `Note.md` or `folder/Note.md`) via `DataStore.noteByFilename(identifier, 'Notes')`.\n - Fallback chain for project note by title: exact title, then quoted title (e.g. `\"Title\"`), then case-insensitive + search all folders.\n - Clearer error message when the identifier is neither a project note nor a valid date/interval (no longer reports title strings as \"not a valid date string\").\n\n## [3.20.0] - 2024-02-15 (@dwertheimer)\n\n- added clof to eslint and flow rc\n\n## [3.19.0] - 2024-01-13 (@dwertheimer)\n\n- removed an errant import of libcurl that was crashing builds with node-gyp errors\n\n## [3.18.0] - 2023-01-08 (@dwertheimer)\n\n- edits to rollup & releases to help with \"plugin.requiredFiles\" and the requiredFiles folder (files to be copied to the Plugins folder and to releases for React, etc.)\n- add fast-glob module for rollup (to watch for changes in files outside the build tree of index.js)\n\n## [3.17.0] - 2022-12-17 (@dwertheimer)\n\n### Additions to the plugin template for new plugins:\n\n- add hooks and stubs for: onOpen, onEditorWillSave\n- add fetch mocking import and instructions on how to use it\n- moved pre-existing hooks to the new NPTriggers-Hooks.js file\n\n## [3.16.0] - 2022-09-13 (@dwertheimer)\n\n- added fsevents to try to reduce CPU usage of node on the autowatch per [article](https://medium.com/@manusajith/fix-for-100-cpu-usage-by-node-js-529916100aa6)\n\n## [3.15.0] - 2022-08-30 (@akrabat)\n\n- updated node-libcurl to 2.3.4 for Apple Silicon compatibility\n\n## [3.14.0] - 2022-08-19 (@dwertheimer)\n\n- added columnify for columnar output\n\n## [3.13.0] - 2022-08-19 (@dwertheimer)\n\n- added mathjs module for math calculations\n- added -m | --minify option to build process to minify/mangle output for large plugins\n\n## [3.12.0] - 2022-07-24 (@codedungeon)\n\n- fixed `maximum stack call` error with new log level implementation\n- all tests are currently passing, with the exception of 3 (@jgclark has been notified)\n- fixed all core linting errors (individual plugins from @dwertheimer or @jgbclark still need some more at time of this release)\n\n## [3.11.0] - 2022-07-24 (@codedungeon)\n\n- Added `logInfo`, `logError`, `logWarn`, `logDebug` helpers, support plugin `Debugging` section (@dwertheimer)\n- Updated plugin starter (`npc plugin:create`) to include `Debugging` section in settings (@codedungeon)\n\n## [3.10.2] - 2022-07-10 (@codedungeon)\n\n- added `np.Templating/lib/support/ejs.js` to `.eslintrc :: ignorePatterns`\n\n## [3.10.1] - 2022-07-10 (@codedungeon)\n\n- Fixed linting errors\n- Updated `.eslintrc` to define max-len to match prettier setting in `package.json`\n > I am hoping you all will be cool with the updated max-len value\n > I work on a 30\" most of the time so a longer line length is easier to read, if this becomes an issue I will try and get used to someting smaller (we used to have 120)\n- Updated `test:dev` and `test:watch` npm scripts\n > Run `test:dev` to perform a single test run of all specs in `__tests__` directories\n > Run `test:watch` to perform a run test for all specs in `__tests__` using watch mode\n- Updated `test` npm script to also call `test:dev`\n- small refactor to `np.plugin-flow-skeleton`\n\n## [3.10.0] - 2022-07-07 (@codedungeon)\n\n- added `--force` option to `npc plugin:create` which will skip all network lookups (when retrieving github user information) (@dwertheimer)\n- added task to `npc plugin:release` which remove previous releases for same pluginId (@jgclark)\n\n> you can use the `--noDelete` flag to skip delete tasks (this will rarely be used, but added for completeness)\n\n## [3.9.0] - 2022-06-17 (@jgclark)\n\n- removed luxon\n- (unmentioned here but I believe @nmn remove luxon-business-days about 2022-06-12)\n\n## [3.8.0] - 2022-06-15 (@nmn)\n\n- added eslint-plugin-no-floating-promise to package.json\n- added package-lock back into git\n- added .watchmanconfig\n\n## [3.6.0] - 2022-06-08 (@codedungeon)\n\n- added `documentation` module back in and edited the `npm run docs` command\n\n- Updated @codedungeon/gunner CLI library\n- added example of new \"arguments: {}\" fields in `plugin.json` when there are arguments that can be passed in when calling a plugin command from x-callback\n\n## [3.5.0] - 2022-06-01 (@codedungeon)\n\n- updated [#205](https://github.com/NotePlan/plugins/issues/205) `npc plugin:release` to include `CHANGELOG.md` if exists ()\n- updated `npc plugin:create` to include extended plugin skeleton (@dwertheimer)\n > Added more skeleton tests (thank you @dwertheimer)\n- restored 180 character width in `prettier` settings\n > If we continue to toggle this setting, my suggestion would be to remove it as a base setting and integrate personal `prettier.config.js` configuration\n\n## [3.4.1] - 2022-05-24 (@codedungeon)\n\n- fixed `npc plugin:release`\n\n## [3.4.1] - 2022-05-15 (@codedungeon)\n\n- removed `dayjs` dependency\n - You can remove as you see fit, but it was not being used anywhere so it should not be causing any issues\n\n## [3.4.0] - 2022-05-15 (@jgclark)\n\n- add `luxon` depedency\n - luxon-business-days\n\n## [3.3.0] - 2022-05-06 (@dwertheimer)\n\n- added support for searching notes using packages:\n - fuse.js\n - bqpjs\n\n## [3.2.6] - 2022-04-23 (@mikeerickson)\n\n- added support for using aliases in jest tests\n - configured in `jest.config.js` which matches configuration in `plugins.config.js`\n\n## [3.2.5] - 2022-04-16 (@mikeerickson)\n\n- fix `npc plugin:relase` command to properly include `plugin.name` (@jgclark)\n\n## [3.2.4] - 2022-03-20 (@mikeerickson)\n\n- Fixed `helpers/NPConfiguration.js :: getSetting` completed implementation\n- Fixed `helpers/NPConfiguration.js :: getSettings` completed implementation\n\n## [3.2.3] - 2022-03-20 (@mikeerickson)\n\n- Extended `helpers/dev :: clo` to output raw value if not object (allow passing non-object without having to change method call)\n\n## [3.2.2] - 2022-03-18 (@mikeerickson)\n\n- Removed `fetchWithTimeout` helper that was added in 3.2.1\n\n## [3.2.1] - 2022-03-18 (@mikeerickson)\n\n- removed `--verbose false` flag from `test:dev` and `test:watch` scripts\n\n## [3.2.0] - 2022-03-16 (@mikeerickson)\n\n- added `fetchWithTimeout` helper to `./helpers/dev`\n\n## [3.1.2] - 2022-02-27 (@mikeerickson)\n\n- fixed issue with `npc plugin:release` build test command\n- removed test execution when running test build (addresses item test imports)\n\n## [3.1.1] - 2022-02-23 (@mikeerickson)\n\n- updated `date-fns` dependency to `^2.23.0` (requested by @m1well)\n- added `eslin-plugin-unused-imports: 1.1.5` (requested by @m1well)\n- updated CLI command description and examples\n\n## [3.1.0] - 2022-02-19 (@mikeerickson)\n\n- fixed issue with release script\n- refactored release validation in CLI `npc plugin:release`\n- add guard to make sure releasing from plugins directory\n\n## [3.0.2] - 2022-02-17 (@mikeerickson)\n\n- restored `docs` command\n\n## [3.0.1] - 2022-02-17 (@mikeerickson)\n\n- updated Plugins v3.0\n\n## [2.2.0] - 2021-09-06 (@mikeerickson)\n\n### Fixed\n\n- fixed `plugin:create` command to use latest `@codedungeon/gunner`\n- fixed `plugin:info` command to use latest `@codedungeon/gunner`\n\n## [2.1.0] - 2021-08-26 (@mikeerickson)\n\n### Added\n\n- added `showdown` node dependency\n- added `codedungeon.Toolbox` v1.0.0\n\n## [2.0.1] - 2021-08-26 (@mikeerickson)\n\n### Changed\n\n- modified `.flowconfig` configuration, address error messsage for node_modules which do not contain type definitions\n\n## [2.0.0] - 2021-08-16 (@mikeerickson)\n\nInitial Release\n\n## Changelog\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n### Plugin Versioning Uses Semver\n\nAll NotePlan plugins follow `semver` versioning. For details, please refer to [semver website](https://semver.org/)\n" }, { "path": "Flow_Guide.md", "content": "# Flow Guide\n\nThis section is for those looking to understand how to use Flow types for more reliable Javascript.\n\nYou can read a [full guide for Flow](https://flow.org/en/docs/) but here are some quick tips if you're familiar with Swift:\n\n1. Type annotations work very similarly by putting `: type` after variables and arguments\n2. Function return types also use `:` and not `=>` like Swift\n3. For all the primitive types in Javascript, you must use lowercase for the tyeps:\n - `string` not `String`\n - `number` not `Number` or `Int` or `Float` (Javascript only has a single number type)\n - `boolean` not `Boolean`\n - `null` for null types\n - `void` for undefined\n4. All other types are generally capitalized - `TParagraph`, `Date` etc.\n5. Union Types:\n - Think about how Swift allows you to create tagged values with Enums.\n - Flow just lets you make a union of multiple types: `string | number` is a type that takes both types\n - When dealing with a union type, you can use a `typeof` as the condition of an `if` statement and\n flow will know the more accurate type within the if statement.\n - Flow also support regular enums `enum SomeEnum {A, B, C}` but without attached data\n - If you need attached data you can use a union of object types, but that's an advanced topic.\n6. Flow also has support for optional types, but the `?` comes before the type.\n - `String?` in Swift would translate to `?string` in Flow\n - This is just an alias for `string | null | void`\n7. The return type of `async` function must always be a `Promise<SOMETYPE>`. The type argument for the `Promise<>` depends on you.\n\n## Optional Types\n\nOne of the *BIG* benefits of typeschecking Javascript is to catch mistakes where we forget to handle\nthe case where a value might not exist. These are very common in the Noteplan API. \n * A `Note` may not have an actual `title`.\n * When given a choce of options, a user may select nothing!\n * etc.\n\nSo the *correct* type for cases like this would be `string | void | null` (Strings or Unefined or Null),\nbut since this is such a common pattern, Flow gives a simple syntax to handle these case:\n`?string`. This is called an \"optional string\". If there is a value, it's of type string, but the value may not exist.\n\n## Object Types\n\nThere are few different ways to define Object types.\n\n[Read the docs](https://flow.org/en/docs/types/objects/)\n\n### Plain Object Types\n\nPlain objects are defined just with `{}` brackets.\n\ne.g.\n```typescript\ntype Person = { name: string, age: number }\n```\n\nFlow object types are exact by default. This means that a `Person` object type *cannot* have any keys\nother than `name` and `string`. If you want to allow extra keys, you can add `...` at the type end of the object type:\n\n```typescript\ntype Personish = { name: string, age: number, ... }\n```\n\nThe `Personish` object type **must** contain `name` and `age`, but it can also contain additional \narbitrary keys that won't have any types.\n\n#### Combining Objects\n\nFlow supports the Object-spread syntax to combine objects:\n\n```typescript\ntype Named = {name: string}\ntype Aged = {age: number}\ntype Person = {...Named, ...Aged}\n```\n\nObject spread syntax works exact like it does for actual objects and order matters.\nWhen there are duplicate keys, the last key wins.\n\nSpread syntax behaves somewhat similar to a logical `AND`.\n\nFor a logical `OR`, you create a `UNION` of object types too:\n\n```typescript\ntype NamedOrAged = Named | Aged\n```\n\n`NamedOrAged` may either have a `name` key, *OR* an `age` key, but NOT both.\n\nGenerally when creating unions of objects, it's useful to have at least one key that has a static string value:\n\n```typescript\ntype NamedOrAged = {\n type: 'Named', \n ...Named,\n} | {\n type: 'Aged',\n ...Aged,\n}\n```\n\nThis pattern makes code that uses such a type easier to work with:\n\n```js\nswitch (namedOrAged.type) {\n case 'Named':\n // Now we know that `namedOrAged` has a `name` key\n console.log(namedOrAged.name);\n break;\n case 'Aged': \n // Now we know that `namedOrAged` has an `age` key\n console.log(namedOrAged.age);\n break;\n default:\n // We still need a default case to make Flow happy unless you use an enum\n}\n```\n\nGenerally, it's best to use plain Object types where possible, but sometimes it makes sense to use Classes.\n\n### Classes\n\nJavascript has `class` keyword support. And classes are slightly special in Flow as they're both a value *and* a type.\nAn object may be of type `Person`, but `new Person()` is also a function call.\n\nClass types in Flow have one *big* difference when compared to plain object types. They are checked by NAME and not by STRUCTURE.\n\nConsider this example:\n\n```typescript\ndeclare class PersonClass {\n name: string;\n age: number;\n}\n\nconst bob = {\n name: \"Bob\",\n age: 30\n}\n```\n\nHere, `bob` is **NOT** of the type `PersonClass` even though it has the same keys within. This is because only \nan object that is created with the `PersonClass` constructor can of be of its type.\n\n```typescript\nconst actualPersonBob = new Person(\"Bob\", 30);\n```\n\nClasses have their place, but should be used sparingly.\n\n### Interfaces\n\nInterfaces are the compromise between a `Class` and a plain Object Type. It's fairly similar to a Plain Object type,\nbut it can also be used to check class objects.\n\nFurther, classes can `implement` one or more `interfaces`:\n\n```typescript\ninterface Named {name: string}\ninterface Aged {age: number}\n\nclass Person implements Named, Aged {\n name: string;\n age: number;\n}\n```\n\n[Read More Here](https://medium.com/flow-type/sound-typing-for-this-in-flow-d62db2af969e)\n\n### `this` type\n\nThe `this` type is only valid for `class` and `interface` types.\n\n## When Types are REQUIRED\n\nWhen you're using typechecking and value or function that is being \"exported\" needs explicit type annotations.\n\n### Flow for Swift Developers\n\nDealing with an optional string:\n\n```swift\nlet str: String?\n\nlet err: String = str // type error\n\nif let str = str {\n let val: String = str // no type error\n}\n```\n\ntranslates to:\n\n```typescript\nlet str: ?string;\n\nlet err: string = str; // type error\n\nif (str != null) {\n\tconst val: string = str; // no type error\n}\n```\n\nAs you can see, a simple if check to verify that str is not `null` or `undefined` is enough for Flow to refine it's type.\nNo special syntax needed.\n\n## Type definitions of Noteplan\n\nPlease look under `flow-typed/Noteplan.js` for all the type definitions you can use. Note that this file defines the object/values\navailable in Javascript, but the types of those objects are usually prefixed with a T.\n\nFor example, the `Paragraph` object is of the type `TParagraph`" }, { "path": "GithubFlow.md", "content": "# Contributing to Noteplan/plugins\n\nThe process of contributing to Noteplan/plugins is the same as contributing to any Github open source projects. But it can be a little daunting if you have never done it before. Here's a brief walk through.\n\n## Creating a Fork\n\nJust head over to the NotePlan Plugins [GitHub page](https://github.com/NotePlan/plugins) and click the \"Fork\" button. \n<img width=\"500\" alt=\"Screen Cap 2023-04-02 at 09 29 36@2x\" src=\"https://user-images.githubusercontent.com/8949588/229366802-404fcaa2-523d-4c27-9803-9e0ba913d01d.png\">\n\nYou can use all the default settings, which will fork it into your Github account under the name \"plugins\":\n<img width=\"500\" alt=\"Screen Cap 2023-04-02 at 09 54 12@2x\" src=\"https://user-images.githubusercontent.com/8949588/229367303-bf504ca1-15fe-4b9f-b8c9-e8b3afcc93fd.png\">\n\nThis will create a fork (copy) of the noteplan/plugins repository in your **personal github account** (e.g. YOUR_GITHUB_USERNAME/plugins). Now we need to get the link to that repository, so Click the green `Code` button and click the overlapping squares icon to copy the link to this repository on your github account. \n\n<img width=\"494\" alt=\"Screen Cap 2023-04-02 at 10 10 00@2x\" src=\"https://user-images.githubusercontent.com/8949588/229368157-a02bc0e9-8f82-4c84-8a1e-1556bd2165d8.png\">\n\n## Decide where you want to work on the code\n\nYou will be working on your code in a directory outside of the NotePlan file sandbox, so you can put the plugin development code anywhere you want on your computer. You will then use the command line interface tool (`noteplan-cli`) in the plugin repository to automatically build and copy the plugin code from your development folder to your NotePlan Plugins folder so you can test/use your plugin. So now, find or create a directory where you want to start development (anywhere on your computer).\n\n## Cloning the Repo to your Desktop\n\nOnce you have your own fork (on Github.com) and a directory where you want to develop, you'll need to create a **clone** of that code on your local computer so you can work on it. To do that, you can use any git client app (e.g. the [free Github Desktop app](https://desktop.github.com/) to clone your repo, or if you prefer, skip the app and just head straight to the command line in your terminal:\n\n```shell\n# Change directory to where you want to install the plugins project\ncd DIR_PATH\n\n# Clone the fork we just created to your local machine\ngit clone https://github.com/YOUR_GITHUB_USERNAME/plugins.git\n```\n> **Note**\n> The URL above ^^^ is the one you copied in the previous step.\n\nThis will create a clone (aka \"working copy\") of the repository on your local computer\n\n## Keeping Your Fork Up to Date\n\nOver time, you'll want to make sure you keep your fork up to date by tracking the original \"upstream\" repo that you forked. To do this, you'll need to add a remote:\n\n```shell\n# Change directory so you're in the local working copy of the plugins\ncd plugins\n\n# Add 'upstream' repo to list of remotes\ngit remote add upstream https://github.com/NotePlan/plugins.git\n\n# Verify the new remote named 'upstream'\ngit remote -v\n```\n\nThis should show you two sets of \"remotes\": \n- push/pull to your repository on github\n- push/pull to the main NotePlan/plugins (upstream) repository\n\n### Keeping your fork up-to-date\n\nTo keep your fork/working copy updated with the latest upstream changes (changes in the main NotePlan repository), you'll need to first fetch the upstream repo's branches and latest commits to bring them into your repository:\n\n```shell\n# Fetch from upstream remote\ngit fetch upstream\n```\n\nNow, checkout your own main (master) branch and merge the upstream repo's main branch:\n\n> ***NOTE:*** NotePlan's master branch is \"main\". So if you see instructions on the Internet for git-related things that tell you to do something to \"master\", just replace that with \"main\"\n\n```shell\n# Checkout your main branch and merge the upstream changes into your local copy\ngit checkout main\n# Note: You will already be on the main branch by default unless you have created/switched to a branch\ngit merge upstream/main\n```\n\nIf there are no conflicting commits on your local master/main branch, git will simply perform a \"fast-forward\" (it will bring all the latest NotePlan/plugins commits into your working copy). However, if you have been making changes on your master/main (in the vast majority of cases you probably shouldn't be - [see the next section](#doing-your-work), you may have to deal with conflicts. When doing so, be careful to respect the changes made upstream.\n\nNow, your local master/main branch is up-to-date with everything modified upstream.\n\n## Doing Your Work\n\n### Create a Branch\nWhenever you begin work on a new feature or bugfix, it's important that you create a new branch. Not only is it proper git workflow, but it also keeps your changes organized and separated from the master branch so that you can easily submit and manage multiple pull requests for every task you complete.\n\nTo create a new branch and start working on it:\n\n```shell\n# Checkout the master/main branch - you always want your new branch to always be based on main\ngit checkout main\n\n# Create a new branch named newfeature (give your branch its own simple informative name)\ngit branch newfeature\n\n# Switch to your new branch\ngit checkout newfeature\n```\n\nNow, go to town hacking away and making whatever changes you want to. You should add files and make local commits to your repository as you work. [Read this](https://support.atlassian.com/bitbucket-cloud/docs/add-edit-and-commit-to-source-files/) for more information. A good rule of thumb is to do a commit each time you add a new file or get some meaningful piece of code working. Committing along the way gives you a \"save point\" that you could roll back to if things go wrong along the way. This will cause you to have lots of commits, but we will clean that up later before issuing a pull request.\n\nWhen you want to submit your changes to be potentially included in the main/public NotePlan plugins repository, you will want to create a [Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests).\n\n## Submitting a Pull Request to NotePlan\n\n### Cleaning Up Your Work\n\nPrior to submitting your pull request, you should do a few things to clean up your branch and make it as simple as possible for the NotePlan repo's maintainers to test, accept, and merge your work.\n\nThe first step is to make sure there are no changes on the main NotePlan repository that you haven't merged locally. \n\n```shell\n# Fetch upstream master/main and merge with your repo's master/main branch\ngit fetch upstream\ngit checkout main\ngit merge upstream/main\n\n# If you see any new commits on main mentioned, you will need to rebase your development branch\ngit checkout newfeature\ngit rebase main\n```\n\nNow, it may be desirable to squash some of your smaller commits down into a small number of larger more cohesive commits. You can do this with an interactive rebase:\n\n```shell\n# Rebase all commits on your development branch\ngit checkout newfeature\ngit rebase -i main\n```\n\nThis will open up a text editor where you can specify which commits to squash. [Read this](https://medium.com/@slamflipstrom/a-beginners-guide-to-squashing-commits-with-git-rebase-8185cf6e62ec) for more information.\n\n### Pushing your changes to Github\n\nNow that you have changes committed locally on your computer, you need to push them up to your Github forked repository.\n\n```shell\n# push local changes to your github repository as a feature branch\ngit push origin newfeature\n```\n\n### Submitting\n\nOnce you've committed and pushed all of your changes to GitHub, go to the page for your fork on GitHub.com, select your development branch, and click the pull request button. Fill out the description and submit the request for consideration.\n\n### Making Changes\n\nIf you need to make any adjustments to code in your pull request (either thoughts you had or requests from the NotePlan repo maintainer), you can just just `git push` new changes/updates to the branch you submitted for a pull request. Github will automatically update the pull request with your new code.\n\n### Clean-up\n\nAfter your PR is accepted and you're done with the development branch, you're free to delete it.\n\n```shell\ngit branch -d newfeature\n```\n\n**Copyright**\n\nCredits: Instructions based on [this gist](https://gist.githubusercontent.com/Chaser324/ce0505fbed06b947d962/raw/23b18d33a8e1a512c53155aabdf97042d8c63768/GitHub-Forking.md)\n\nCopyright 2017, Chase Pettit\n\nMIT License, http://www.opensource.org/licenses/mit-license.php\n \n**Additional Reading**\n* [Atlassian - Merging vs. Rebasing](https://www.atlassian.com/git/tutorials/merging-vs-rebasing)\n\n**Sources**\n* [GitHub - Fork a Repo](https://help.github.com/articles/fork-a-repo)\n* [GitHub - Syncing a Fork](https://help.github.com/articles/syncing-a-fork)\n* [GitHub - Checking Out a Pull Request](https://help.github.com/articles/checking-out-pull-requests-locally)\n" }, { "path": "KimMachineGun.Raindrop/CHANGELOG.md", "content": "# KimMachineGun.Raindrop Plugin Changelog\n\n## About KimMachineGun.Raindrop Plugin\n\nSee Plugin [README](https://github.com/NotePlan/plugins/blob/main/KimMachineGun.Raindrop/README.md) for details on\navailable commands and use case.\n\n## [0.1.0] - 2022-08-03 (KimMachineGun)\n\n### Added\n\n- added `/rd` command to search raindrop and create note.\n- added `/rd:insert` command to search raindrop and insert (or copy) link.\n" }, { "path": "KimMachineGun.Raindrop/README.md", "content": "# KimMachineGun.Raindrop Plugin\n\nThis plugin provides commands for working with Raindrop.io.\n\n## Settings\n\nThese commands require configuration.\n\n### Access Token (*required)\n\n1. Go to the [Raindrop's integrations setting](https://app.raindrop.io/settings/integrations).\n2. Create new app.\n3. Create test token.\n4. Copy and paste that token to plugin setting.\n\n### Note Folder\n\nThis setting specifies the folder to which this plugin will create a note.\n\n### Tag Prefix\n\nThis setting specifies the prefix of the tag imported from Raindrop.io.\n\n## Latest Updates\n\nSee [CHANGELOG](https://github.com/NotePlan/plugins/blob/main/KimMachineGun.Raindrop/CHANGELOG.md) for latest\nupdates/changes to this plugin.\n\n## API Documentation\n\nhttps://developer.raindrop.io/\n" }, { "path": "KimMachineGun.Raindrop/plugin.json", "content": "{\n \"COMMENT\": \"Details on these fields: https://help.noteplan.co/article/67-create-command-bar-plugins\",\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.4.0\",\n \"plugin.id\": \"KimMachineGun.Raindrop\",\n \"plugin.name\": \"🧩 Raindrop.io\",\n \"plugin.version\": \"0.1.0\",\n \"plugin.lastUpdateInfo\": \"Initial Release\",\n \"plugin.description\": \"Raindrop.io integration plugin.\",\n \"plugin.author\": \"KimMachineGun\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.url\": \"https://github.com/NotePlan/plugins/blob/main/KimMachineGun.Raindrop/README.md\",\n \"plugin.changelog\": \"https://github.com/NotePlan/plugins/blob/main/KimMachineGun.Raindrop/CHANGELOG.md\",\n \"plugin.commands\": [\n {\n \"name\": \"rd\",\n \"description\": \"Search and create note.\",\n \"jsFunction\": \"searchAndCreateNote\",\n \"alias\": [\n \"rd\"\n ]\n },\n {\n \"name\": \"rd:insert\",\n \"description\": \"Search and insert (or copy) link.\",\n \"jsFunction\": \"searchAndInsertOrCopy\",\n \"alias\": [\n \"rdi\"\n ]\n }\n ],\n \"plugin.settings\": [\n {\n \"COMMENT\": \"Plugin settings documentation: https://help.noteplan.co/article/123-plugin-configuration\",\n \"type\": \"heading\",\n \"title\": \"Raindrop Settings\"\n },\n {\n \"title\": \"Access Token\",\n \"key\": \"accessToken\",\n \"type\": \"string\",\n \"description\": \"Your Raindrop.io test access token\"\n },\n {\n \"title\": \"Note Folder\",\n \"key\": \"noteFolder\",\n \"type\": \"string\",\n \"description\": \"Folder to store Raindrop notes\",\n \"default\": \"/Raindrop.io/Tags\"\n },\n {\n \"title\": \"Tag Prefix\",\n \"key\": \"tagPrefix\",\n \"type\": \"string\",\n \"description\": \"Prefix of Raindrop tags\",\n \"default\": \"rd/\"\n },\n {\n \"NOTE\": \"DO NOT CHANGE THE FOLLOWING SETTINGS; ADD YOUR SETTINGS ABOVE ^^^\",\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"INFO\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much logging output will be displayed when executing Raindrop commands in NotePlan Plugin Console Logs (NotePlan -> Help -> Plugin Console)\\n\\n - DEBUG: Show All Logs\\n - INFO: Only Show Info, Warnings, and Errors\\n - WARN: Only Show Errors or Warnings\\n - ERROR: Only Show Errors\\n - none: Don't show any logs\",\n \"default\": \"INFO\",\n \"required\": true\n }\n ]\n}\n" }, { "path": "KimMachineGun.Raindrop/src/NPPluginMain.js", "content": "// @flow\n// Plugin code goes in files like this. Can be one per command, or several in a file.\n// `export async function [name of jsFunction called by Noteplan]`\n// then include that function name as an export in the index.js file also\n// About Flow: https://flow.org/en/docs/usage/#toc-write-flow-code\n// Getting started with Flow in NotePlan: https://github.com/NotePlan/plugins/blob/main/Flow_Guide.md\n\n// NOTE: This file is named NPPluginMain.js (you could change that name and change the reference to it in index.js)\n// As a matter of convention, we use NP at the beginning of files which contain calls to NotePlan APIs (Editor, DataStore, etc.)\n// Because you cannot easily write tests for code that calls NotePlan APIs, we try to keep the code in the NP files as lean as possible\n// and put the majority of the work in the /support folder files which have Jest tests for each function\n// support/helpers is an example of a testable file that is used by the plugin command\n// REMINDER, to build this plugin as you work on it:\n// From the command line:\n// `noteplan-cli plugin:dev KimMachineGun.Raindrop --test --watch --coverage`\n\n/**\n * LOGGING\n * A user will be able to set their logging level in the plugin's settings (if you used the plugin:create command)\n * As a general rule, you should use logDebug (see below) for messages while you're developing. As developer,\n * you will set your log level in your plugin preferences to DEBUG and you will see these messages but\n * an ordinary user will not. When you want to output a message,you can use the following\n * logging level commands for different levels of messages:\n *\n * logDebug(pluginJson,\"Only developers or people helping debug will see these messages\")\n * log(pluginJson,\"Ordinary users will see these informational messages\")\n * logWarn(pluginJson,\"All users will see these warning/non-fatal messages\")\n * logError(pluginJson,\"All users will see these fatal/error messages\")\n */\nimport pluginJson from '../plugin.json'\nimport {JSP, logError} from '@helpers/dev'\n\n\nexport async function searchAndInsertOrCopy(): Promise<void> {\n await searchInRaindrop(insertOrCopyRaindropTitle)\n}\n\nexport async function searchAndCreateNote(): Promise<void> {\n await searchInRaindrop(createRaindropNote)\n}\n\nasync function searchInRaindrop(cb: (raindrop: Raindrop) => Promise<void>): Promise<void> {\n const settings = DataStore.settings\n const accessToken = settings.accessToken ?? ''\n if (accessToken === '') {\n logError(pluginJson, `Please configure your access token first.`)\n return\n }\n\n // every command/plugin entry point should always be wrapped in a try/catch block\n try {\n const search = await CommandBar.showInput(`Search`, `Search in Raindrop.io with '%@'`) ?? ''\n if (search === '') {\n logError(pluginJson, `Too short search term.`)\n return\n }\n\n let raindrops = []\n for (let i = 0; ; i++) {\n const raw = await requestToRaindrop('GET', `https://api.raindrop.io/rest/v1/raindrops/0?search=${encodeURIComponent(search)}&page=${encodeURIComponent(i)}&perPage=50`)\n\n const response = JSON.parse(raw)\n if (!response.result) {\n logError(pluginJson, `An error occurred during searching.`)\n return\n }\n\n const raindropsInPage: Array<Raindrop> = response.items ?? []\n raindrops = raindrops.concat(raindropsInPage)\n if (raindrops.length === 0) {\n await CommandBar.prompt(\n 'Not Found',\n `Nothing found in all raindrops with '${search}'`,\n )\n logError(pluginJson, `Nothing found in all raindrops.`)\n return\n }\n\n const titles: string[] = raindrops.map((x) => {\n if (x.tags.length === 0) {\n return x.title\n }\n const tags = x.tags.map(x => `#${x}`).join(',')\n return `${x.title} / ${tags}`\n })\n titles.push('Load More...')\n\n const selected = await CommandBar.showOptions(titles, `Found ${raindrops.length} raindrops`)\n if (selected.index === titles.length - 1) {\n continue\n }\n\n await cb(raindrops[selected.index])\n break\n }\n } catch (error) {\n logError(pluginJson, JSP(error))\n }\n}\n\nasync function insertOrCopyRaindropTitle(rd: Raindrop) {\n let linkedTitle = `[${rd.title}](${rd.link})`\n if (rd.tags.length > 0) {\n linkedTitle = `${linkedTitle} ${rd.tags.map(formatTag).join(' ')}`\n }\n\n if (Editor.note == null) {\n Clipboard.string = linkedTitle\n await CommandBar.prompt(\n 'Note Not Opened',\n `Copy '${linkedTitle}' to your clipboard.`,\n )\n } else {\n Editor.insertTextAtCursor(linkedTitle)\n }\n}\n\nasync function createRaindropNote(rd: Raindrop) {\n const settings = DataStore.settings\n const noteFolder = settings.noteFolder ?? ''\n\n const title = `[${rd.title}](${rd.link})`\n\n let body = ''\n const collection = await fetchCollection(rd.collection.$id)\n if (collection) {\n body = `${body}**Collection:** \\`${collection._id === -1 ? 'Unsorted' : collection.title}\\`\\n`\n }\n if (rd.excerpt !== '' || rd.highlight.body !== '') {\n body = `${body}**Description:**\\n> ${rd.excerpt || rd.highlight.body}\\n`\n }\n if (rd.tags.length !== 0) {\n body = `${body}**Tags:**\\n${rd.tags.map(formatTag).map(x => `- ${x}`).join('\\n')}\\n`\n }\n body = `${body}---\\n`\n\n const filename = await createNoteIfNotExists(title, noteFolder, body)\n await Editor.openNoteByFilename(filename)\n}\n\nasync function createNoteIfNotExists(title: string, folder: string, content?: string): string {\n const existingNotes = DataStore.projectNoteByTitle(title, true, false) ?? []\n if (existingNotes.length === 0) {\n if (content) {\n content = `# ${title}\\n${content}`\n return await DataStore.newNoteWithContent(content, folder)\n } else {\n return await DataStore.newNote(title, folder)\n }\n }\n}\n\nfunction formatTag(tag: string): string {\n const prefix = DataStore.settings.tagPrefix ?? ''\n return `#${prefix}${tag.replaceAll(' ', '_').toLowerCase()}`\n}\n\nasync function fetchCollection(id: number): ?Collection {\n const raw = await requestToRaindrop('GET', `https://api.raindrop.io/rest/v1/collection/${id}`)\n const response = JSON.parse(raw)\n if (!response.result) {\n logError(pluginJson, `An error occurred during fetching collection.`)\n return null\n }\n return response.item\n}\n\nasync function requestToRaindrop(method: string, url: string, init?: RequestInit): Promise<Response> {\n const settings = DataStore.settings\n const accessToken = settings.accessToken ?? ''\n if (accessToken === '') {\n logError(pluginJson, `Please configure your access token first.`)\n }\n\n return await fetch(url, {\n method: method,\n headers: {\n 'Authorization': `Bearer ${accessToken}`,\n },\n ...init\n })\n}\n" }, { "path": "KimMachineGun.Raindrop/src/Raindrop.js", "content": "// @flow\n\ndeclare type RaindropType = 'link' | 'article' | 'image' | 'video' | 'document' | 'audio';\n\ndeclare type RaindropCacheStatus = 'ready' | 'retry' | 'failed' | 'invalid-origin' | 'invalid-timeout' | 'invalid-size';\n\ndeclare type RaindropHighlightColor =\n 'blue'\n | 'brown'\n | 'cyan'\n | 'gray'\n | 'green'\n | 'indigo'\n | 'orange'\n | 'pink'\n | 'purple'\n | 'red'\n | 'teal'\n | 'yellow';\n\ndeclare class Raindrop {\n // Impossible to create Paragraphs manually\n constructor(_: empty): empty;\n /**\n * Unique identifier of raindrop\n */\n _id: string;\n\n /**\n * Collection that the raindrop resides in\n */\n collection: {\n /**\n * Unique identifier of collection\n */\n $id: number;\n };\n\n /**\n * Raindrop cover URL\n */\n cover: string;\n\n /**\n * Creation date\n */\n created: string;\n\n /**\n * Hostname of a link.\n * Files always have `raindrop.io` hostname\n */\n domain: string;\n\n /**\n * Description; max length: 10000\n */\n excerpt: string;\n\n /**\n * Update date\n */\n lastUpdate: string;\n\n /**\n * URL\n */\n link: string;\n\n /**\n * Covers list in format\n */\n media: Array<{\n /**\n * URL of cover\n */\n link: string;\n }>;\n\n /**\n * Tags list\n */\n tags: Array<string>;\n\n /**\n * Title; max length: 1000\n */\n title: string;\n\n /**\n * `link` `article` `image` `video` `document` or `audio`\n */\n type: RaindropType;\n\n /**\n * Raindrop owner\n */\n user: {\n /**\n * Unique Identifier of raindrop owner\n */\n $id: number;\n };\n\n /**\n * Marked as broken (original `link` is not reachable anymore)\n */\n borken: boolean;\n\n /**\n * Permanent copy (cached version) details\n */\n cache: {\n /**\n * `ready` `retry` `failed` `invalid-origin` `invalid-timeout` or `invalid-size`\n */\n status: RaindropCacheStatus;\n\n /**\n * Full size in bytes\n */\n size: number;\n\n /**\n * Date when copy is successfully made\n */\n created: number;\n };\n\n /**\n * Sometime raindrop may belong to other user, not to the one who create it.\n * For example when this raindrop is created in shared collection by other user.\n * This object contains info about original author.\n */\n creatorRef: {\n /**\n * Original author (user ID) of a raindrop\n */\n _id: number;\n\n /**\n * Original author name of a raindrop\n */\n fullName: number;\n };\n\n /**\n * This raindrop uploaded from desktop\n */\n file: {\n /**\n * File name\n */\n name: string;\n\n /**\n * File size in bytes\n */\n size: number;\n\n /**\n * Mime type\n */\n type: string;\n };\n\n /**\n * Marked as \"favorite\"\n */\n important: boolean;\n\n /**\n * Highlights in this raindrop\n */\n highlights: Array<{\n /**\n * Unique id of highlight\n */\n _id: string;\n\n /**\n * Text of highlight (required)\n */\n text: string;\n\n /**\n * Color of highlight.\n * Default `yellow`\n *\n * Can be `blue`, `brown`, `cyan`, `gray`, `green`, `indigo`, `orange`, `pink`, `purple`, `red`, `teal`, `yellow`\n */\n color: RaindropHighlightColor;\n\n\n /**\n * Optional note for highlight\n */\n note: string;\n\n /**\n * Creation date of highlight\n */\n created: string;\n }>;\n\n\n /**\n * Highlight of this raindrop\n * NOT DOCUMENTED IN RAINDROP.IO\n */\n highlight: {\n /**\n * Highlight of this raindrop\n */\n body: string\n }\n}\n\n// TODO: type all fields in [Collections](https://developer.raindrop.io/v1/collections)\ndeclare class Collection {\n // Impossible to create Paragraphs manually\n constructor(_: empty): empty;\n /**\n * The id of the collection\n */\n _id: string;\n\n /**\n * Name of the collection\n */\n title: string;\n}\n" }, { "path": "KimMachineGun.Raindrop/src/index.js", "content": "// @flow\n// Flow typing is important for reducing errors and improving the quality of the code.\n// About Flow: https://flow.org/en/docs/usage/#toc-write-flow-code\n// Getting started with Flow in NotePlan: https://github.com/NotePlan/plugins/blob/main/Flow_Guide.md\n// Note: As you will see in this plugin folder, you can have multiple files -- e.g. one file per command or logical group of commands\n// ...and separate files for helper/support functions that can be tested in isolation\n// The `autowatch` packager combines them all into one script.js file for NotePlan to read\n// From the command line:\n// `noteplan-cli plugin:dev {{pluginId}} --test --watch --coverage`\n// ...will watch for changes and will compile the Plugin script code\n// and copy it to your plugins directory where NotePlan can find it\n// Since NP reloads the Javascript every time you CMD-J to insert a plugin,\n// you can immediately test the new code without restarting NotePlan\n// This index.js file is where the packager starts looking for files to combine into one script.js file\n// So you need to add a line below for each function that you want NP to have access to.\n// Typically, listed below are only the top-level plug-in functions listed in plugin.json\n\nexport { searchAndInsertOrCopy, searchAndCreateNote } from './NPPluginMain' // add one of these for every command specifified in plugin.json (the function could be in any file as long as it's exported)\n\n// Do not change this line. This is here so your plugin will get recompiled every time you change your plugin.json file\nimport pluginJson from '../plugin.json'\n\n/*\n * NOTEPLAN HOOKS\n * The rest of these functions are called by NotePlan automatically under certain conditions\n * It is unlikely you will need to edit/add anything below this line\n */\n\n// eslint-disable-next-line import/order\nimport { updateSettingData, pluginUpdated } from '@helpers/NPConfiguration'\nimport { logError, JSP } from '@helpers/dev'\n/**\n * NotePlan calls this function after the plugin is installed or updated.\n * The `updateSettingData` function looks through the new plugin settings in plugin.json and updates\n * the user preferences to include any new fields\n */\nexport async function onUpdateOrInstall(): Promise<void> {\n await updateSettingData(pluginJson)\n}\n\n/**\n * NotePlan calls this function every time the plugin is run (any command in this plugin)\n * You should not need to edit this function. All work should be done in the commands themselves\n */\n// eslint-disable-next-line require-await\nexport async function init(): Promise<void> {\n try {\n // Check for the latest version of this plugin, and if a minor update is available, install it and show a message\n DataStore.installOrUpdatePluginsByID([pluginJson['plugin.id']], false, false, false).then((r) =>\n pluginUpdated(pluginJson, r),\n )\n } catch (error) {\n logError(pluginJson, JSP(error))\n }\n}\n\n/**\n * NotePlan calls this function settings are updated in the Preferences panel\n * You should not need to edit this function\n */\nexport async function onSettingsUpdated(): Promise<void> {}\n" }, { "path": "LICENSE", "content": "The MIT License (MIT)\n\nCopyright (c) 2021-2022 Eduard Metzger\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "README.md", "content": "# NotePlan Plugins\n\n[![Node.js CI](https://github.com/NotePlan/plugins/actions/workflows/node.js.yml/badge.svg)](https://github.com/NotePlan/plugins/actions/workflows/node.js.yml)\n\n## Overview\n\nNotePlan Plugins provides an extensive API for extending default editing and task management and work across all platforms (macOS and iOS).\n\nEach plugin command can be invoked using the [NotePlan Command Bar](https://help.noteplan.co/article/65-commandbar-plugins), or by entering any of available commands directly in the editor by entering `/<command_name>` (NotePlan will auto update the list of possible commands as you type)\n![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/6081f7f4c9133261f23f4b41/images/608c5886f8c0ef2d98df845c/file-fLVrMGjoZr.png)\n\n## Anatomy of a Plugin\n\nIf you want to develop plugins, Step 1 is to read the [NotePlan Knowledgebase Document](https://help.noteplan.co/article/67-create-command-bar-plugins) describing how plugins work in NotePlan and the basic plugin anatomy. Once you have read that carefully and understand the basics, you should return here to acquire and start using the NotePlan Plugin tooling described below.\n\n## Prerequisite\n\nThe following items are required for NotePlan Plugin Development\n\n- Node 14 or 16 -- **Do Not Use any Node version <14 or >16** (see \"Switching Node Versions\")\n- NotePlan 3.4 or greater\n- macOS Catalina 10.15.2 or greater (strongly recommend macOS Big Sur 11.x or Monterey 12.x)\n- github CLI `gh` is strongly recommended - [how to install gh](https://cli.github.com/)\n\n## Switching Node Versions\n\nThe NotePlan plugin code has not yet been migrated to Node versions >16. If you are developing elsewhere using Node v17+, you will want to switch to Node v16 when you are doing NotePlan Plugin development. The fast/easy way to do that is with a Node version manager [like \"n\"](https://www.npmjs.com/package/n). This way you can flip in and out of Node versions at will.\n\n## Plugin Information\n\nIf you have an idea for a plugin, [submit them here](https://feedback.noteplan.co/plugins-scripting) or inquire in the [NotePlan Discord community](https://discord.gg/D4268MT)'s `#plugin` channel.\n\nIf you are a developer and want to contribute and build your plugins, see the [plugin writing documentation](https://help.noteplan.co/article/67-create-command-bar-plugins) and discuss this with other developers on [Discord](https://discord.gg/D4268MT) `#plugin-dev` channel. You might want to consult this [good modern JavaScript tutorial](https://javascript.info/).\n\n### Getting Started with Plugin Development\n\n**Step 1: Forking/Cloning NotePlan Plugin Repository**\n\nRead [these instructions](GithubFlow.md) for how to fork and clone this code\n\n**Step 1.5 Have a look at the code**\n\nWhen you have cloned this repository, you will not only have the tooling, but you will have the actual source code for every publicly-available NotePlan plugin. This will give you a wealth of material to learn from and borrow from. Speaking of which, there is a `/helpers` directory at the root of the repository that contains a lot of useful functions built upon the NotePlan APIs and will speed up your development. It would be good to familiarize yourself with that code by browsing it. There is a searchable index of the helper code that can be accessed by running this command in a terminal:\n`npm run docs`\n\n**Step 2: Install Node (if not installed)**\n\nMake sure you have the proper version of `node` installed (if you need to install node, `brew install node@16` is the quickest method, or you can follow instructions on [node website](https://nodejs.org/en/download/)).\n\n**Step 3: Initialize Local Development Environment**\n\nRun the following 3 commands from the root of your local GitHub repository for `NotePlan/plugins`.\n\n1) Update node-gyp\n\n```shell\nnpm i -g node-gyp@latest && npm config set node_gyp \"/usr/local/lib/node_modules/node-gyp/bin/node-gyp.js\"\n```\n\n> **Note**: Don't be surprised if this command fails. It is only necessary in certain cases. If it fails, it probably means you didn't need it. Just continue on.\n\n2) Install the node_modules\n\n```shell\nnpm install\n```\n\n> **NOTE**: if you are running node >= 16 and you get failure messages on the vanilla install command above, you will need to use this command instead: `npm install --legacy-peer-deps`\n\n3) Link the files to make them run properly from the command line (especially the `noteplan-cli`)\n\n```shell\nnpm run init\n```\n\nThis will install the necessary npm dependencies and initialize your plugin working directory, including:\n\n- Configuring `eslint` [eslint](https://eslint.org/) (for checking code conventions)\n- Configuring `flow` [flow](https://flow.org/) (for type checking)\n- Configuring `babel` [babel](https://babeljs.io/) (a JS compiler)\n- Configuring `rollup` [rollup](https://rollupjs.org/guide/en/) (for bundling multiple source files into a single release).\n\nEach of these tools have their own configuration files at the root directory (e.g., `.flowconfig` or `.eslintrc`)\n\n_Note: Each of these configuration files can be overridden if needed by placing a project specific configuration file in you project plugin, however, for consistency with other NotePlan plugins, we encourage to use the defaults wherever possible._\n\n### Creating your first NotePlan Plugin\n\nUsing the NotePlan CLI, perform the following actions:\n\n**Step 1: Create your plugin using NotePlan CLI**\nAnswer the prompt questions (or supply all the necessary options from command line (see `noteplan-cli plugin:create --help` for details)\n\n`noteplan-cli plugin:create`\n\n**Step 2: Startup Auto Watch Process**\n\nOpen up a Terminal shell, `cd` to the repository root directory, and issue the command:\n`npc plugin:dev <your_plugin_folder> --watch` from the root directory to build your plugin as you develop so it can be tested in NotePlan. This will compile your code and put it into your NotePlan app directory so you can test your plugin. The `--watch` flag keeps the process looking for changes to your files and will automatically rebuild the plugin for you. (more on that below)\n\n**Step 3: Start your plugin command develop and test locally**\n\nYou can now develop and test your plugin locally,\n\n**Step 4: Create Pull Request (if you wish to make your plugin public)**\n\nAt this point, if you would like to make your plugin available publicly, you can proceed to [creating a Pull Request](https://github.com/NotePlan/plugins/blob/main/GithubFlow.md#submitting-a-pull-request-to-noteplan) to have your code included in the NotePlan Plugin Repository\n\n### Common Development Actions\n\nThese are the most common commands you will use while developing:\n\n#### File Watcher\n\nThe default watch command `npc plugin:dev <your_plugin_folder> --watch`:\n\n`npc plugin:dev` from the root of your local `NotePlan/plugins` repository which will bundle all the files in your `/src` directory into single file `script.js` and will be copied from your repository directory to your Plugins folder in the running NotePlan data directory for testing.\n\nThe `init` script should have detected whether you are using the SetApp or App Store version of NotePlan and set the correct path to your Plugins folder. If it did not, you can manually change it in `.pluginpath`.\n\n*Note: The watcher will remain running, _watching_ the NotePlan directory and re-compile whenever changes have been made to your `<your_plugin>/src` JavaScript files.*\n\n**npc plugin:dev <your_plugin_directory> --watch**\n\nFor example, running `npc plugin:dev dwertheimer.TaskAutomations --watch` will perform the same watching operations for the `dwertheimer.TaskAutomations` plugin only.\n\n### NotePlan CLI Commands\n\nNotePlan includes a suite of CLI commands which you can use during development.\n\n```shell\nnoteplan-cli <command>\nor\nnpc <command>\n```\n\nFor all CLI commands, you can pass the `--help` for available flags\n\n#### npc plugin:dev\n\nThe most common CLI command, this can be used to build plugin, test plugins (wrapper for `npc plugin:test`)\n\n```shell\nnpc plugin:dev <plugin> [options]\n\n# run watcher, compact mode and display notification with build result\nnpc plugin:dev codedungeon.Toolbox --watch --compact --notify\n\n# same as above, using CLI shorthand\nnpc plugin:dev codedungeon.Toolbox -wcn\n\n# run NotePlan test suite in watch mode\n# this is a wrapper for npc plugin:test\nnpc plugin:dev codedungeon.Toolbox -tw\n\n```\n\n#### npc plugin:test\n\nThe `test` command can be used in addition to the `npc plugin:dev <plugin> --test` which will only execute the NotePlan Test Runner\n\n```shell\nnpc plugin:test <plugin> [options]\n\n# execute test running in watch mode, with silent enabled\nnpc plugin:test codedungeon.Toolbox --watch --silent\n\n# as with other plugin commands, youc an use CLI shorthand\n# this will perform the same as above\nnpc plugin:test codedungeon.Toolbox -ws\n```\n\n#### npc plugin:create\n\nCreate new NotePlan Plugin\n\n```shell\nnpc plugin:create [options]\n```\n\n#### npc plugin:pr\n\nCreate NotePlan Plugin Pull Request\n\n```shell\nnpc plugin:pr [options]\n```\n\n#### npc plugin:test\n\nRun test suite for NotePlan Plugin\n\n```shell\nnpc plugin:test <plugin> [options]\n\n# run plugin:test watch\nnpc plugin:test codedungeon.Toolbox --watch\n\n# run plugin:test watch, silent mode\nnpc plugin:test codedungeon.Toolbox --watch --silent\n\n# run plugin:test with CLI shorthand\nnpc plugin:test codedungeon.Toolbox -ws\n\n# run plugin:test with coverage report\nnpc plugin:test codedungeon.Toolbox --coverage\n```\n\n#### Create Pull Request\n\nOnce you are finished editing and testing your plugin, you can [submit a Pull Request](https://github.com/NotePlan/plugins/blob/main/GithubFlow.md#submitting-a-pull-request-to-noteplan) to the NotePlan/plugins repository and it will be reviewed for inclusion. Once it has been approved, it will be available from **NotePlan > Preferences > Plugins** section, enabling it to be installed by other NotePlan users.\n\n### Frequently Used Commands\n\nThe common script you will run `npc plugin:dev <plugin>` however, you may need to use any of the following\n\n- `npc plugin:dev <plugin> --watch --compact --notify` a less verbose version of `autowatch` that might suit more experienced developers\n- `npc plugin:dev <plugin> -wcn` watcher, compact mode, notify using CLI shorthand\n- `npc plugin:dev <plugin> -tw` test mode, watcher using CLI shorthand\n- `npc plugin:test <plugin> -w` test mode, using `test` command\n- `npm run typecheck`: typecheck all javascript files with `Flow`. Only files with a `// @flow` comment are checked.\n- `npm run fix`: lint and auto-format\n- `npm run docs`: build documentation for javascript files\n- `npm run lint`: run ESlint on the entire repo\n- `npm run lint-fix`: run ESlint on the entire repo and fix whatever it can automatically fix\n- `npm run format`: auto-format all Javascript files using `prettier`\n- `gh release delete <release name>`: Will delete the release from the repository, so making it unavailable in NotePlan as well. (Though it won't remove it from anyone who has already downloaded it.)\n\n## Editor Setup\n\nUse the setup guide for your preferred editor (we prefer Visual Studio Code), and then read the section on Working with Multiple Files.\n\n### Visual Studio Code (recommended)\n\n**Install VSCode Extensions**\n\n1. Install the following extensions for the following tools:\n - `flow` \"Flow Language Support\" by flowtype\n - `eslint` \"ESLint\" by Dirk Baeumer\n - `prettier` \"Prettier - Code formatter\" by Prettier\n - (optional) \"TODO Highlight V2\" by wayou/jgclark\n\n**Update Settings**\n\n1. Set `prettier` to be the default formatter for js files.\n - You can open the Command Bar using `CMD+SHIFT+P` and then search for `Format Document`.\n - When you do this, you may get asked for a formatter of choice. Choose \"Prettier\"\n - If it asks you if this should be your default for all JS files, choose Yes.\n2. Restart the editor to ensure the plugins are working.\n - You should see type errors when you make those\n - You should see lint errors when you format code wrong\n - You should see your code get auto formatted when you save\n3. Make sure to open this folder directly in VSCode and not the entire repo as the ESLint plugin can be annoying about that\n\n### Sublime Text 3 and 4\n\n1. Install the following extensions using Package Control\n - `SublimeLinter` This allows various linters to work\n - `SublimeLinter-eslint`\n - `SublimeLinter-flow`\n - `jsPrettier`\n - `Babel` Syntax definitions for ES6 Javascript and React JSX extensions\n2. Configure your packages:\n - Open a `.js` file\n - From the View menu, select Syntax → Open all with current extension as… → Babel → JavaScript (Babel)\n - Open the package settings for `jsPrettier` and add `\"auto_format_on_save\": true,`\n\n### Linting Code\n\nIf you don't have an editor set up to lint as you code, you can run `npm run test` and it will give a list of problems to fix.\n\n### Using Flow\n\nBy practice, NotePlan plugins use [flow](https://flow.org/) for static type checking. You can get more information by referencing [NotePlan Flow Guide](https://github.com/NotePlan/plugins/blob/main/Flow_Guide.md)\n\n## NotePlan Plugin Support\n\nShould you need support for anything related to NotePlan Plugins, you can reach us at the following:\n\n### Email\n\nIf you would prefer email, you can reach us at:\n\n- [NotePlan Info](hello@noteplan.co)\n\n### Discord\n\nPerhaps the fastest method would be at our Discord channel, where you will have access to the widest amount of resources:\n\n- [Discord Plugins Channel](https://discord.com/channels/763107030223290449/784376250771832843)\n\n### Github Issues\n\nThis is a great resource to request assistance, either in the form of a bug report, or feature request for a current or future NotePlan Plugin\n\n- [GitHub Issues](https://github.com/NotePlan/plugins/issues/new/choose)\n\n## Contributing\n\nIf you would like to contribute to the NotePlan Plugin repository, feel free to submit a [Pull Request](https://github.com/NotePlan/plugins/blob/main/GithubFlow.md#submitting-a-pull-request-to-noteplan) for any existing NotePlan Plugin, or any of the support materials.\n" }, { "path": "TasksModule_docs.md", "content": "import Link from 'next/link'\nimport Callout from '@/components/Callout'\n\n# Tasks Module\n\n## Overview\n\nThe Tasks Module provides methods for interacting with tasks within NotePlan.\n\n<Callout\n type=\"info\"\n description={`\nThis module allows you to retrieve and manipulate tasks from your notes, ensuring they are synchronized with block IDs for reliable referencing.\n `}\n/>\n\n## Methods\n\n> namespace: `tasks`\n\nThe following are the methods available in the Tasks Module. They can be used in any `Templating` template; no additional configuration is required.\n\n---\n\n### getSyncedOpenTasksFrom\n\n> #### async getSyncedOpenTasksFrom(sourceIdentifier : string) : Promise<string>\n>\n> Retrieves open tasks (including their sub-tasks/children) from a specified note (daily, weekly, monthly, quarterly, yearly calendar note, or a project note). It ensures each open task paragraph and its children have a block ID and returns a string with each task on a new line.\n\n- `sourceIdentifier` - (string) Specifies the note to retrieve tasks from. This can be:\n - `'<today>'`: Fetches tasks from today's daily note.\n - `'<yesterday>'`: Fetches tasks from yesterday's daily note.\n - An ISO 8601 date string for a specific calendar note:\n - Daily: `\"YYYYMMDD\"` (e.g., `\"20230410\"`) or `\"YYYY-MM-DD\"` (e.g., `\"2023-04-10\"`)\n - Weekly: `\"YYYY-Www\"` (e.g., `\"2023-W24\"`)\n - Monthly: `\"YYYY-MM\"` (e.g., `\"2023-10\"`)\n - Quarterly: `\"YYYY-Qq\"` (e.g., `\"2023-Q4\"`)\n - Yearly: `\"YYYY\"` (e.g., `\"2023\"`)\n - The title of a project note (string).\n\n- `-> result` - (Promise<string>) Returns a promise that resolves to a string containing all open tasks and their sub-tasks from the specified note, each on a new line. If the note is not found or contains no open tasks, it resolves to an empty string.\n\n**Behavior Notes:**\n\n* The method uses `getOpenTasksAndChildren` to identify open tasks and their hierarchical children.\n* It automatically adds block IDs to any open task or child task paragraph that doesn't already have one. This modification happens directly in the NotePlan data store.\n* If multiple project notes match a given title, the method will use the first one found and log a debug message.\n\n**Examples**\n\nThe following example retrieves open tasks from today's daily note:\n\n```javascript\n<%- await tasks.getSyncedOpenTasksFrom('<today>') %>\n```\n\nThe following example retrieves open tasks from a specific weekly note:\n\n```javascript\n<%- await tasks.getSyncedOpenTasksFrom('2023-W42') %>\n```\n\nThe following example retrieves open tasks from a project note titled \"My Project Q4\":\n\n```javascript\n<%- await tasks.getSyncedOpenTasksFrom('My Project Q4') %>\n``` " }, { "path": "__mocks__/Backlink.mock.js", "content": "/* eslint-disable */\n\n/* Backlink mock class\n *\n * Usage: const myBacklink = new Backlink({ param changes here })\n *\n */\n\nexport class Backlink {\n // Properties\n blockId = 'PLACEHOLDER' // TODO: add value\n content = 'PLACEHOLDER' // TODO: add value\n contentRange = 'PLACEHOLDER' // TODO: add value\n date = {} /* new Date(\"Tue Jun 14 2022 00:00:00 GMT-0700 (PDT)\"), */\n filename = 'PLACEHOLDER' // TODO: add value\n heading = 'PLACEHOLDER' // TODO: add value\n headingLevel = 'PLACEHOLDER' // TODO: add value\n headingRange = 'PLACEHOLDER' // TODO: add value\n indents = 'PLACEHOLDER' // TODO: add value\n isRecurring = 'PLACEHOLDER' // TODO: add value\n lineIndex = 'PLACEHOLDER' // TODO: add value\n linkedNoteTitles = []\n note = {} /* {\n\t\t\"filename\": \"20220614.md\",\n\t\t\"type\": \"Calendar\",\n\t\t\"title\": \"2022-06-14\",\n\t\t\"date\": \"2022-06-14T07:00:00.000Z\",\n\t\t\"changedDate\": \"2022-06-15T23:34:12.000Z\",\n\t\t\"createdDate\": \"2022-06-15T23:34:12.000Z\",\n\t\t\"hashtags\": [],\n\t\t\"mentions\": [],\n\t\t\"linkedItems\": [\n\t\t\t\t\"{\\\"type\\\":\\\"open\\\",\\\"content\\\":\\\" >today add filler photo ^mmw6w5\\\",\\\"blockId\\\":\\\"^mmw6w5\\\",\\\"rawContent\\\":\\\"* >today add filler photo ^mmw6w5\\\",\\\"prefix\\\":\\\"* \\\",\\\"contentRange\\\":{},\\\"lineIndex\\\":0,\\\"date\\\":\\\"2022-06-15T07:00:00.000Z\\\",\\\"heading\\\":\\\"\\\",\\\"headingLevel\\\":-1,\\\"isRecurring\\\":false,\\\"indents\\\":0,\\\"filename\\\":\\\"20220614.md\\\",\\\"noteType\\\":\\\"Calendar\\\",\\\"linkedNoteTitles\\\":[],\\\"subItems\\\":[],\\\"referencedBlocks\\\":[{}],\\\"note\\\":{}}\"\n\t\t],\n\t\t\"datedTodos\": [\n\t\t\t\t\"{\\\"type\\\":\\\"open\\\",\\\"content\\\":\\\" >today add filler photo ^mmw6w5\\\",\\\"blockId\\\":\\\"^mmw6w5\\\",\\\"rawContent\\\":\\\"* >today add filler photo ^mmw6w5\\\",\\\"prefix\\\":\\\"* \\\",\\\"contentRange\\\":{},\\\"lineIndex\\\":0,\\\"date\\\":\\\"2022-06-15T07:00:00.000Z\\\",\\\"heading\\\":\\\"\\\",\\\"headingLevel\\\":-1,\\\"isRecurring\\\":false,\\\"indents\\\":0,\\\"filename\\\":\\\"20220614.md\\\",\\\"noteType\\\":\\\"Calendar\\\",\\\"linkedNoteTitles\\\":[],\\\"subItems\\\":[],\\\"referencedBlocks\\\":[{}],\\\"note\\\":{}}\"\n\t\t],\n\t\t\"backlinks\": [],\n\t\t\"frontmatterTypes\": [],\n\t\t\"content\": \"* >today add filler photo ^mmw6w5\\n* \",\n\t\t\"paragraphs\": [\n\t\t\t\t\"{\\\"type\\\":\\\"open\\\",\\\"content\\\":\\\" >today add filler photo ^mmw6w5\\\",\\\"blockId\\\":\\\"^mmw6w5\\\",\\\"rawContent\\\":\\\"* >today add filler photo ^mmw6w5\\\",\\\"prefix\\\":\\\"* \\\",\\\"contentRange\\\":{},\\\"lineIndex\\\":0,\\\"date\\\":\\\"2022-06-15T07:00:00.000Z\\\",\\\"heading\\\":\\\"\\\",\\\"headingLevel\\\":-1,\\\"isRecurring\\\":false,\\\"indents\\\":0,\\\"filename\\\":\\\"20220614.md\\\",\\\"noteType\\\":\\\"Calendar\\\",\\\"linkedNoteTitles\\\":[],\\\"subItems\\\":[],\\\"referencedBlocks\\\":[{}],\\\"note\\\":{}}\",\n\t\t\t\t\"{\\\"type\\\":\\\"open\\\",\\\"content\\\":\\\"\\\",\\\"rawContent\\\":\\\"* \\\",\\\"prefix\\\":\\\"* \\\",\\\"contentRange\\\":{},\\\"lineIndex\\\":1,\\\"heading\\\":\\\"\\\",\\\"headingLevel\\\":-1,\\\"isRecurring\\\":false,\\\"indents\\\":0,\\\"filename\\\":\\\"20220614.md\\\",\\\"noteType\\\":\\\"Calendar\\\",\\\"linkedNoteTitles\\\":[],\\\"subItems\\\":[],\\\"referencedBlocks\\\":[],\\\"note\\\":{}}\"\n\t\t]\n} , */\n noteType = 'PLACEHOLDER' // TODO: add value\n prefix = 'PLACEHOLDER' // TODO: add value\n rawContent = 'PLACEHOLDER' // TODO: add value\n referencedBlocks = []\n subItems = [] /* sample: [{\n \"type\": \"open\",\n \"content\": \" >today add filler photo ^mmw6w5\",\n \"blockId\": \"^mmw6w5\",\n \"rawContent\": \"* >today add filler photo ^mmw6w5\",\n \"prefix\": \"* \",\n \"contentRange\": {},\n \"lineIndex\": 0,\n \"date\": \"2022-06-15T07:00:00.000Z\",\n \"heading\": \"\",\n \"headingLevel\": -1,\n \"isRecurring\": false,\n \"indents\": 0,\n \"filename\": \"20220614.md\",\n \"noteType\": \"Calendar\",\n \"linkedNoteTitles\": [],\n \"subItems\": [],\n \"referencedBlocks\": [\n {}\n ],\n \"note\": {}\n} ] */\n type = 'PLACEHOLDER' // TODO: add value\n\n // Methods\n async children() {\n throw 'Backlink :: children Not implemented yet'\n }\n async duplicate() {\n throw 'Backlink :: duplicate Not implemented yet'\n }\n async init() {\n throw 'Backlink :: init Not implemented yet'\n }\n\n constructor(data?: any = {}) {\n this.__update(data)\n }\n\n __update(data?: any = {}) {\n Object.keys(data).forEach((key) => {\n this[key] = data[key]\n })\n return this\n }\n}\n" }, { "path": "__mocks__/Calendar.mock.js", "content": "/* eslint-disable */\n/*\n * Calendar mocks\n *\n * Note: nested object example data are there for reference only -- will need to be deleted or cleaned up before use (consider using a factory)\n * For functions: check whether async or not & add params & return value\n *\n */\nimport moment from 'moment/min/moment-with-locales'\nimport * as chrono from 'chrono-node'\n\nexport const Calendar = {\n // async add() { return null },\n // async addUnitToDate() { return null },\n availableCalendarTitles(writeOnly: boolean) {\n if (writeOnly) {\n return ['cal1']\n } else {\n return ['cal1', 'cal2']\n }\n },\n // async availableReminderListTitles() { return null },\n // async dateFrom() { return null },\n /* dateUnits: [{ return second }], */\n // async eventByID() { return null },\n // async eventsBetween() { return null },\n // async eventsToday() { return null },\n parseDateText(str) {\n if (str && str.length) {\n const chronoGuesses = chrono.parse(str)\n if (chronoGuesses && chronoGuesses.length) {\n const retObj = {\n start: chronoGuesses[0].start.date(),\n end: chronoGuesses[0].end?.date() || chronoGuesses[0].start.date(),\n text: chronoGuesses[0].text || '',\n index: 2,\n }\n return [retObj]\n }\n throw `Calendar.parseDateText() date string (${str}) not recognized`\n }\n return { start: new Date('2022-01-01 00:00'), end: new Date('2022-01-01 03:00'), text: str, index: 2 }\n },\n // async reminderByID() { return null },\n // async remindersBetween() { return null },\n // async remindersByLists() { return null },\n // async remindersToday() { return null },\n // async remove() { return null },\n // async timeAgoSinceNow() { return null },\n // async unitOf() { return null },\n // async unitsAgoFromNow() { return null },\n // async unitsBetween() { return null },\n // async unitsUntilNow() { return null },\n // async update() { return null },\n endOfWeek(date) {\n return moment(date).endOf('week').toDate() // new Date('2022-01-07 23:59')\n },\n startOfWeek(date) {\n return moment(date).startOf('week').toDate() // new Date('2022-01-01 00:00')\n },\n weekNumber(date) {\n return moment(date).week()\n },\n}\n\n// module.exports = Calendar\n" }, { "path": "__mocks__/CalendarItem.mock.js", "content": "/* eslint-disable */\n/*\n * CalendarItem mock class\n *\n * Usage: const myCalendarItem = new CalendarItem({ param changes here })\n *\n */\n\nexport class CalendarItem {\n // Properties\n attendeeNames = [] /* sample: [Storey Wertheimer Wertheimer ] */\n attendees = [] /* sample: [[Storey Wertheimer Wertheimer](mailto:storey@wertheimer.com) ] */\n availability = 'PLACEHOLDER' // TODO: add value\n calendar = 'PLACEHOLDER' // TODO: add value\n calendarItemLink = 'PLACEHOLDER' // TODO: add value\n date = {} /* new Date(\"Sun May 22 2022 00:00:00 GMT-0700 (PDT)\"), */\n endDate = {} /* new Date(\"Mon Jun 20 2022 00:00:00 GMT-0700 (PDT)\"), */\n id = 'PLACEHOLDER' // TODO: add value\n isAllDay = 'PLACEHOLDER' // TODO: add value\n isCalendarWritable = 'PLACEHOLDER' // TODO: add value\n isCompleted = 'PLACEHOLDER' // TODO: add value\n isRecurring = 'PLACEHOLDER' // TODO: add value\n location = 'PLACEHOLDER' // TODO: add value\n notes = 'PLACEHOLDER' // TODO: add value\n occurences = [] /* sample: [Sun May 22 2022 00:00:00 GMT-0700 (PDT) ] */\n title = 'PLACEHOLDER' // TODO: add value\n type = 'PLACEHOLDER' // TODO: add value\n url = 'PLACEHOLDER' // TODO: add value\n\n // Methods\n\n constructor(data?: any = {}) {\n this.__update(data)\n }\n\n __update(data?: any = {}) {\n Object.keys(data).forEach((key) => {\n this[key] = data[key]\n })\n return this\n }\n}\n" }, { "path": "__mocks__/Clipboard.mock.js", "content": "/* eslint-disable */\n/*\n * Clipboard mocks\n *\n * Note: nested object example data are there for reference only -- will need to be deleted or cleaned up before use (consider using a factory)\n * For functions: check whether async or not & add params & return value\n *\n */\n\nconst Clipboard = {\n // async availableType() { return null },\n // async base64DataStringForType() { return null },\n // async clearContents() { return null },\n // async dataForType() { return null },\n // async setBase64DataStringForType() { return null },\n // async setDataForType() { return null },\n // async setStringForType() { return null },\n string: 'clipString',\n // async stringForType() { return null },\n /* types: [{ return public.utf8-plain-text }], */\n}\n\nmodule.exports = Clipboard\n" }, { "path": "__mocks__/CommandBar.mock.js", "content": "/* eslint-disable */\n/*\n * CommandBar mocks\n *\n * Note: nested object example data are there for reference only -- will need to be deleted or cleaned up before use (consider using a factory)\n * For functions: check whether async or not & add params & return value\n *\n */\n\nconst CommandBar = {\n async hide() {\n return\n },\n async onAsyncThread() {\n return\n },\n async onMainThread() {\n return\n },\n async openURL() {\n return\n },\n placeholder: 'CommandBar placeholder',\n async prompt(title = '', message = '') {\n console.log(`CommandBar prompt: ${title}: ${message}`)\n return `CommandBar.prompt ${title} ${message}`\n },\n searchText: 'some text',\n async showInput(placeholder, submitText) {\n return placeholder //return the placeholder string as input\n },\n\n async showLoading(visible, text, progress) {\n return\n },\n async showOptions(options, placeholder) {\n return { index: 0, value: options[0], keyModifiers: ['cmd', 'opt', 'shift', 'ctrl'] }\n },\n async prompt(title, message, buttons) {\n return message //return the message string as input\n },\n async textPrompt(title, message, defaultText) {\n return message //return the message string as input\n },\n}\n\nmodule.exports = CommandBar\n" }, { "path": "__mocks__/DataStore.mock.js", "content": "/* eslint-disable */\n/*\n * DataStore mocks\n *\n * Note: nested object example data are there for reference only -- will need to be deleted or cleaned up before use (consider using a factory)\n * For functions: check whether async or not & add params & return value\n *\n */\nimport * as samplePlugin from './support/pluginSample.json'\nimport { logDebug } from '@helpers/dev'\nlet __json = samplePlugin //variable used for saving/getting json\n\nexport const DataStore = {\n // async calendarNoteByDate() { return null },\n // async calendarNoteByDateString() { return null },\n /* calendarNotes: [{ return {\n\t\t\"filename\": \"20200202.md\",\n\t\t\"type\": \"Calendar\",\n\t\t\"title\": \"2020-02-02\",\n\t\t\"date\": \"2020-02-02T08:00:00.000Z\",\n\t\t\"changedDate\": \"2022-05-11T14:09:19.432Z\",\n\t\t\"createdDate\": \"2022-05-11T14:09:19.432Z\",\n\t\t\"hashtags\": [],\n\t\t\"mentions\": [],\n\t\t\"linkedItems\": [],\n\t\t\"datedTodos\": [],\n\t\t\"backlinks\": [\n\t\t\t\t\"{\"type\":\"note\",\"content\":\"testt\",\"rawContent\":\"testt\",\"prefix\":\"\",\"lineIndex\":0,\"heading\":\"\",\"headingLevel\":0,\"isRecurring\":false,\"indents\":0,\"filename\":\"Summaries/testt.md\",\"noteType\":\"Notes\",\"linkedNoteTitles\":[],\"subItems\":[\"{\"type\":\"title\",\"content\":\"foo\",\"rawContent\":\"# foo\",\"prefix\":\"# \",\"contentRange\":{},\"lineIndex\":0,\"date\":\"2020-02-02T08:00:00.000Z\",\"heading\":\"testt\",\"headingLevel\":0,\"isRecurring\":false,\"indents\":0,\"filename\":\"Summaries/testt.md\",\"noteType\":\"Notes\",\"linkedNoteTitles\":[],\"subItems\":[],\"referencedBlocks\":[],\"note\":{}}\",\"{\"type\":\"list\",\"content\":\"==foo== >2020-02-02\",\"rawContent\":\"- ==foo== >2020-02-02\",\"prefix\":\"- \",\"contentRange\":{},\"lineIndex\":3,\"date\":\"2020-02-02T08:00:00.000Z\",\"heading\":\"foo\",\"headingRange\":{},\"headingLevel\":3,\"isRecurring\":false,\"indents\":0,\"filename\":\"Summaries/testt.md\",\"noteType\":\"Notes\",\"linkedNoteTitles\":[],\"subItems\":[],\"referencedBlocks\":[],\"note\":{}}\"],\"referencedBlocks\":[],\"note\":{}}\"\n\t\t],\n\t\t\"frontmatterTypes\": [],\n\t\t\"content\": \"\n* foo\",\n\t\t\"paragraphs\": [\n\t\t\t\t\"{\"type\":\"empty\",\"content\":\"\",\"rawContent\":\"\",\"prefix\":\"\",\"contentRange\":{},\"lineIndex\":0,\"heading\":\"\",\"headingLevel\":-1,\"isRecurring\":false,\"indents\":0,\"filename\":\"20200202.md\",\"noteType\":\"Calendar\",\"linkedNoteTitles\":[],\"subItems\":[],\"referencedBlocks\":[],\"note\":{}}\",\n\t\t\t\t\"{\"type\":\"open\",\"content\":\"foo\",\"rawContent\":\"* foo\",\"prefix\":\"* \",\"contentRange\":{},\"lineIndex\":1,\"heading\":\"\",\"headingLevel\":-1,\"isRecurring\":false,\"indents\":0,\"filename\":\"20200202.md\",\"noteType\":\"Calendar\",\"linkedNoteTitles\":[],\"subItems\":[],\"referencedBlocks\":[],\"note\":{}}\"\n\t\t]\n} }], */\n defaultFileExtension: 'md',\n /* folders: [{ return / }], */\n // async installOrUpdatePluginsByID() { return null },\n async installPlugin(pluginObject, showLoading = false) {\n logDebug('DataStore.installPlugin (mock)', `requested install of plugin: ${pluginObject.id}; showLoading: ${showLoading}; returning null`)\n return null\n },\n // async installedPlugins() { return null },\n // async invokePluginCommand() { return null },\n // async invokePluginCommandByName() { return null },\n // async isPluginInstalledByID() { return null },\n // async listPlugins() { return null },\n // async loadData() { return null },\n async loadJSON(str) {\n return __json\n },\n // async moveNote() { return null },\n async newNote(title = '', folder = '') {\n return `# ${title}`\n },\n // async newNoteWithContent() { return null },\n // async noteByFilename() { return null },\n\n preference(key: string = ''): string {\n // let deliberatelyUndefined\n switch (key) {\n case 'timeblockTextMustContainString':\n // return 'at' // to test use of 'must contain string'\n // return deliberatelyUndefined // to test an error case\n return '' // set to blank to mimic no additional NP checking of text strings\n break\n case 'isAsteriskTodo':\n return true\n break\n\n default:\n return ''\n break\n }\n },\n\n // async projectNoteByFilename() { return null },\n // async projectNoteByTitle() { return null },\n // async projectNoteByTitleCaseInsensitive() { return null },\n /* projectNotes: [{ return {\n\t\t\"filename\": \"Migrated/Marlita Hours.md\",\n\t\t\"type\": \"Notes\",\n\t\t\"title\": \"\",\n\t\t\"changedDate\": \"2021-09-07T13:49:41.000Z\",\n\t\t\"createdDate\": \"2021-04-29T20:30:00.000Z\",\n\t\t\"hashtags\": [],\n\t\t\"mentions\": [],\n\t\t\"linkedItems\": [],\n\t\t\"datedTodos\": [],\n\t\t\"backlinks\": [],\n\t\t\"frontmatterTypes\": [],\n\t\t\"content\": \"# \",\n\t\t\"paragraphs\": [\n\t\t\t\t\"{\"type\":\"title\",\"content\":\"\",\"rawContent\":\"# \",\"prefix\":\"# \",\"contentRange\":{},\"lineIndex\":0,\"heading\":\"\",\"headingLevel\":1,\"isRecurring\":false,\"indents\":0,\"filename\":\"Migrated/Marlita Hours.md\",\"noteType\":\"Notes\",\"linkedNoteTitles\":[],\"subItems\":[],\"referencedBlocks\":[],\"note\":{}}\"\n\t\t]\n} }], */\n // async referencedBlocks() { return null },\n // async saveData() { return null },\n async saveJSON(object, filename) {\n __json = object\n return true\n },\n // async search() { return null },\n // async searchCalendarNotes() { return null },\n // async searchProjectNotes() { return null },\n // async setPreference() { return null },\n settings: {\n settingsFieldName: 'Settings field value',\n _logLevel: 'none',\n },\n}\n\n// module.exports = DataStore\n" }, { "path": "__mocks__/Editor.mock.js", "content": "/* eslint-disable */\n/**\n * Editor mocks with Proxy\n *\n * Editor and Note share many of the same properties+methods (CoreNoteFields), so most of them are defined in Note.mock.js and can apply to both.\n *\n * This module uses a JavaScript Proxy to redirect all function calls to the underlying `note` object unless specifically overridden.\n * The `get` trap in the Proxy checks if a property exists on the `Editor` object. If it does, it returns that property.\n * If not, it delegates the call to the `note` object. If the property is not found in either, it throws an error.\n *\n * To override a function that is not in the underlying `note`, simply define it in the `editorOverrides` object.\n *\n * Note: All `open*` functions are specifically overridden to return `this.note`.\n */\n\nimport { Note } from './Note.mock'\nconst noteObject = new Note() // NOTE: try to reference the code in the Note mock wherever possible!\n// NOTE: noteObject is spread into Editor below, so any properties that exist in Note will overwrite the ones in Editor\n\nconst editorOverrides = {\n ...{\n async openNoteByDate(date: Date, newWindow?: boolean, highlightStart?: number, highlightEnd?: number, splitView?: boolean, timeframe?: string): Promise<TNote> {\n return noteObject\n },\n async openNoteByDateString() {\n return noteObject\n },\n async openNoteByFilename() {\n return noteObject\n },\n async openNoteByTitle() {\n return noteObject\n },\n async openNoteByTitleCaseInsensitive() {\n return noteObject\n },\n note: noteObject,\n },\n ...noteObject,\n}\n\nexport const Editor = new Proxy(editorOverrides, {\n get(target, prop) {\n if (prop in target) {\n return target[prop]\n }\n if (prop && target.note && prop in target.note) {\n return target.note[prop]\n }\n // Handle known built-in Symbol properties with sensible defaults\n const symbolProperties = [Symbol.iterator, Symbol.toPrimitive, Symbol.asyncIterator, Symbol.hasInstance, Symbol.toStringTag]\n if (symbolProperties.includes(prop)) {\n if (prop === Symbol.iterator) return undefined\n if (prop === Symbol.toPrimitive) return (hint) => (hint === 'number' ? NaN : String(target.note))\n if (prop === Symbol.asyncIterator) return undefined\n if (prop === Symbol.hasInstance) return undefined\n if (prop === Symbol.toStringTag) return 'Editor'\n }\n // Handle Jest specific methods that are not defined on Note and which should not cause errors\n if (['asymmetricMatch'].includes(prop)) {\n return undefined\n }\n // Throw detailed error if property is not found\n throw new Error(\n `Editor.mock.js: Property \"${String(prop)}\" not found. Editor.${String(prop)} or Note.${String(prop)} does not exist.\\n` +\n `- Check if this property/method should be implemented in Note.mock.js.\\n` +\n `- If it's Editor-specific, consider adding it to Editor.mock.js overrides in editorOverrides.\\n` +\n `- If this is a Jest-specific method (such as 'asymmetricMatch') or a built-in Symbol (e.g., Symbol.iterator, Symbol.toPrimitive), ` +\n `return a sensible default instead.\\n`,\n )\n },\n set(target, prop, value) {\n if (prop === 'note') {\n target.note = value\n // Reinitialize the proxy with the new note\n Object.assign(target, value)\n return true\n }\n target[prop] = value\n return true\n },\n})\n" }, { "path": "__mocks__/Fetch.mock.js", "content": "// @flow\n\n/**\n * Mock the fetch() function to return a specific response for a given URL and options.body\n * You pass in text to the match object and if the url or options.body contain that text, the response is returned\n * Note: match.url is required but match.optionsBody is optional\n * The matches are case-insensitive and are turned into RegExps so you can include regular expressions in the match strings\n * So you could match for \"foo\" (a plain string) or you could match for \"foo.*bar\" (a regular expression) that would be true for \"foo bar\" or \"foo xxx bar\"\n * The matches are done in order of the mockResponses array, so the first match is returned that matches the URL and/or options.body\n * So it's a good idea to put the more complex rules first and the simpler rules later in the array\n * For instance, if two requests are going to have the word \"Mercury\" in them, but one request will have \"concept of Mercury\", you might want to put the more specific rule first\n * It's generally a good idea to put as many words as possible in the match string to avoid false matches\n * If no match is found, the defaultResponse text is returned\n * @param {Array<FetchMockResponse>} mockResponses - Array of mock responses in the form of FetchMockResponse\n * @example\nimport response1 from './mockResponses/response1.json' // a JSON file with a sample server response (you will probably have several of these)\nimport { FetchMock, type FetchMockResponse } from '@mocks/Fetch.mock'\nconst OVERRIDE_FETCH = true // set to true to override the global fetch() function with fake responses passed below\nif (OVERRIDE_FETCH) {\n const fm = new FetchMock([\n { match: { url: 'xxx', optionsBody: \"foo.*bar\" }, response: JSON.stringify(response1) }\n ]) // add one object to array for each mock response\n fetch = async (url, opts) => fm.fetch(url, opts) //override the global fetch\n}\n * ...then wherever the code is using fetch, it will use the mock\n * const result = await fetch('http://xxx.com/api', { body: 'has foo and also has the word bar in it' }) // returns 'fake server response here' (the response text)\n */\nexport class FetchMock {\n responses: Array<FetchMockResponse> = [defaultResponse]\n constructor(mockResponses: Array<FetchMockResponse>) {\n if (mockResponses && !Array.isArray(mockResponses)) throw new Error('Fetch constructor requires an array of mock responses')\n this.responses = [...(mockResponses?.length ? mockResponses : []), ...this.responses]\n }\n fetch(url: string, options: FetchOptions): string {\n const match = this.responses.find((r) => {\n const urlTest = r.match?.url ? new RegExp(r.match.url, 'ig').test(url) : false\n // body options will return true if it's a match or if it's not defined\n const optionsBodyTest = r.match?.optionsBody && options.body ? new RegExp(r.match.optionsBody, 'ig').test(options?.body || '') : r.match?.optionsBody ? false : true\n return urlTest && optionsBodyTest\n })\n // return match ? Promise.resolve(match.response) : Promise.resolve(defaultResponse.response)\n return match ? match.response : defaultResponse.response\n }\n}\n\nexport type FetchMockResponse = {\n match: { url: string /* a string to look for in the URL passed to fetch */, optionsBody?: string /* an (optional) string to look for in the options.body passed to fetch */ },\n response: string /* the response to return if the match is found */,\n}\n\nconst defaultResponse = {\n match: { url: '', optionsBody: '' },\n response:\n 'Fetch call mocking is turned on and received a request, but the request did not match any of the supplied mock responses -- check the spelling and/or RegEx patterns in the URL and optionsBody matchers.',\n}\n" }, { "path": "__mocks__/NP_THEME.mock.js", "content": "export const mockNP_THEME = {\n base: {\n backgroundColor: '#ffffff', // Example color\n textColor: '#000000', // Example color\n altColor: '#f0f0f0', // Example color\n tintColor: '#ff0000', // Example color\n },\n}\n" }, { "path": "__mocks__/Note.mock.js", "content": "// @flow\n\nimport { logDebug } from '../helpers/dev'\nimport { hasFrontMatter, getAttributes } from '@helpers/NPFrontMatter'\n\n/*\n * Note mock class\n *\n * Usage: const myNote = new Note({ param changes here })\n *\n */\nimport { textWithoutSyncedCopyTag } from '@helpers/syncedCopies'\nexport class Note {\n // Explicitly define properties that are dynamically assigned\n content: string\n /** Full note markdown when tests construct notes with `{ rawContent }` only */\n rawContent: string = ''\n // Properties\n backlinks: any[] = [] /* sample: [ SOMETHING ], */\n changedDate: any = {} /* new Date(\"Tue Sep 07 2021 06:49:41 GMT-0700 (PDT)\"), */\n /**\n * @private\n * @type {string}\n */\n _content: string = 'CONTENT_PLACEHOLDER_FROM_NOTE_MOCK' // see setter and getter at the bottom of the file\n createdDate: any = {} /* new Date(\"Thu Apr 29 2021 13:30:00 GMT-0700 (PDT)\"), */\n date: string = 'DATE_PLACEHOLDER_FROM_NOTE_MOCK' // TODO: add value\n datedTodos: any[] = [] /* sample: [ SOMETHING ], */\n filename: string = 'FILENAME_PLACEHOLDER_FROM_NOTE_MOCK' // TODO: add value\n frontmatterTypes: string[] = [] /* sample: [ SOMETHING ], */\n frontmatterAttributes: any = {}\n hashtags: any[] = [] /* sample: [ SOMETHING ], */\n linkedItems: any[] = [] /* sample: [ SOMETHING ], */\n mentions: any[] = [] /* sample: [ SOMETHING ], */\n paragraphs: any[] = [] /* sample: [{\n \"type\": \"Notes\",\n \"content\": \"\",\n \"rawContent\": \"# \",\n \"prefix\": \"# \",\n \"contentRange\": {},\n \"lineIndex\": 0,\n \"heading\": \"\",\n \"headingLevel\": 1,\n \"isRecurring\": false,\n \"indents\": 0,\n \"filename\": \"Migrated/Marlita Hours.md\",\n \"noteType\": \"Notes\",\n \"linkedNoteTitles\": [],\n \"subItems\": [],\n \"referencedBlocks\": [],\n \"note\": {}\n} ], */\n title: string = 'TITLE_PLACEHOLDER_FROM_NOTE_MOCK' // TODO: add value\n type: string = 'Notes'\n\n // Methods\n async addBlockID(p: any) {\n if (!/\\^[a-zA-Z0-9]{6}/.test(p.content)) {\n p.content = `${textWithoutSyncedCopyTag(p.content)} ^123456`\n p.rawContent = `${textWithoutSyncedCopyTag(p.rawContent || p.content)} ^123456`\n p.blockId = '^123456'\n }\n }\n async addParagraphBelowHeadingTitle(content: string, paragraphType: string, headingTitle: string, shouldAppend: boolean, shouldCreate: boolean) {\n // TODO: may need to create actual rawContent for certain tests\n const paras = makeParagraphsFromContent(content)\n const paragraphs = this.paragraphs\n // find paragraph with content === headingTitle\n const headingIndex = paragraphs.findIndex((p) => p.content === headingTitle)\n this.paragraphs.splice(headingIndex + 1, 0, ...paras)\n this.paragraphs.forEach((p, i) => (this.paragraphs[i].lineIndex = i))\n this.resetLineIndexesAndContent()\n }\n async addTodoBelowHeadingTitle(): Promise<void> {\n throw 'Note :: addTodoBelowHeadingTitle Not implemented yet'\n }\n appendParagraph(title: string, type: ParagraphType): void {\n this.paragraphs.push({ content: title, type: type, lineIndex: this.paragraphs.length })\n return\n }\n async appendParagraphBelowHeadingLineIndex(): Promise<void> {\n throw 'Note :: appendParagraphBelowHeadingLineIndex Not implemented yet'\n }\n async appendTodo(): Promise<void> {\n throw 'Note :: appendTodo Not implemented yet'\n }\n async appendTodoBelowHeadingLineIndex(): Promise<void> {\n throw 'Note :: appendTodoBelowHeadingLineIndex Not implemented yet'\n }\n async insertCancelledTodo(): Promise<void> {\n throw 'Note :: insertCancelledTodo Not implemented yet'\n }\n async insertCompletedTodo(): Promise<void> {\n await Promise.resolve()\n throw 'Note :: insertCompletedTodo Not implemented yet'\n }\n insertHeading(content: string, lineIndex: number, headingLevel: number): void {\n // .insertHeading(content, lineIndex, headingLevel)\n const headingMark = '#'.repeat(headingLevel)\n const heading = `${headingMark} ${content}`\n const paras = makeParagraphsFromContent(heading)\n this.paragraphs.splice(lineIndex, 0, ...paras)\n this.paragraphs.forEach((p, i) => (this.paragraphs[i].lineIndex = i))\n this.resetLineIndexesAndContent()\n return\n }\n async insertList(): Promise<void> {\n await Promise.resolve()\n throw 'Note :: insertList Not implemented yet'\n }\n insertParagraph(content: string, lineIndex: number, type: ParagraphType): void {\n //TODO: deal with the lineIndex?\n // .insertParagraph(content, lineIndex, type)\n // if string contains \"\\n\" then split into multiple paragraphs\n const paras = makeParagraphsFromContent(content)\n // if (paras[paras.length - 1].content === '') paras.pop()\n // splice at lineIndex, do not remove any existing paragraphs\n this.paragraphs.splice(lineIndex, 0, ...paras)\n this.paragraphs.forEach((p, i) => (this.paragraphs[i].lineIndex = i))\n this.resetLineIndexesAndContent()\n return\n }\n async insertParagraphAfterParagraph(content: string, otherParagraph: any, paragraphType: string) {\n // .insertParagraphAfterParagraph(content, otherParagraph, paragraphType)\n // TODO: may need to create actual rawContent for certain tests\n const paras = makeParagraphsFromContent(content)\n this.paragraphs.splice(otherParagraph.lineIndex + 1, 0, ...paras)\n this.paragraphs.forEach((p, i) => (this.paragraphs[i].lineIndex = i))\n this.resetLineIndexesAndContent()\n }\n async insertParagraphBeforeParagraph(content: string, otherParagraph: any, type: string) {\n // .insertParagraphBeforeParagraph(content, otherParagraph, paragraphType)\n // TODO: may need to create actual rawContent for certain tests\n const paras = makeParagraphsFromContent(content)\n this.paragraphs.splice(otherParagraph.lineIndex, 0, ...paras)\n this.paragraphs.forEach((p, i) => (this.paragraphs[i].lineIndex = i))\n this.resetLineIndexesAndContent()\n }\n async insertQuote(): Promise<void> {\n throw 'Note :: insertQuote Not implemented yet'\n }\n async insertScheduledTodo(): Promise<void> {\n throw 'Note :: insertScheduledTodo Not implemented yet'\n }\n async insertTextAtCharacterIndex(): Promise<void> {\n throw 'Note :: insertTextAtCharacterIndex Not implemented yet'\n }\n async insertTodo(): Promise<void> {\n throw 'Note :: insertTodo Not implemented yet'\n }\n async insertTodoAfterParagraph(): Promise<void> {\n throw 'Note :: insertTodoAfterParagraph Not implemented yet'\n }\n async insertTodoBeforeParagraph(): Promise<void> {\n throw 'Note :: insertTodoBeforeParagraph Not implemented yet'\n }\n async paragraphRangeAtCharacterIndex(): Promise<void> {\n throw 'Note :: paragraphRangeAtCharacterIndex Not implemented yet'\n }\n async prependParagraph(content: string, type: ParagraphType) {\n this.paragraphs = [{ content, type }, ...this.paragraphs]\n logDebug(`JEST Note: note.prependParagraph() called. but .content is approximated but not exactly correct, because it does not add markdown.`) // TODO(@dwertheimer): Is this now correct for .rawContent? And isn't .content set here?\n this.resetLineIndexesAndContent()\n }\n async prependTodo(): Promise<void> {\n throw 'Note :: prependTodo Not implemented yet'\n }\n async printNote(): Promise<void> {\n throw 'Note :: printNote Not implemented yet'\n }\n async removeBlockID(p: any) {\n p.content = textWithoutSyncedCopyTag(p.content)\n p.rawContent = textWithoutSyncedCopyTag(p.rawContent)\n if (p.blockId) delete p.blockId\n }\n async removeParagraph(para: any) {\n this.paragraphs = this.paragraphs.filter((p) => p.lineIndex !== para.lineIndex)\n this.resetLineIndexesAndContent()\n }\n async removeParagraphAtIndex(): Promise<void> {\n throw 'Note :: removeParagraphAtIndex Not implemented yet'\n }\n async removeParagraphs(paras: any[]) {\n // filter this.paragraphs to remove paragraphs with lineIndex in paras\n this.paragraphs = this.paragraphs.filter((p) => !paras.find((para) => para.lineIndex === p.lineIndex))\n this.resetLineIndexesAndContent()\n }\n async replaceTextInCharacterRange(): Promise<void> {\n throw 'Note :: replaceTextInCharacterRange Not implemented yet'\n }\n async updateParagraph(para: any) {\n this.paragraphs[para.lineIndex] = para\n }\n async updateParagraphs(paras: any[]) {\n paras.forEach((para) => {\n this.paragraphs[para.lineIndex] = para\n this.resetLineIndexesAndContent()\n })\n }\n\n /**\n * HELPERS TO SET UP THE NOTE AFTER PARAGRAPH CHANGES\n */\n resetLineIndexesAndContent() {\n this.paragraphs.forEach((p, i) => (this.paragraphs[i].lineIndex = i))\n this._content = this.paragraphs.map((p) => p.content).join('\\n')\n this.setFrontmatterAttributes()\n }\n\n /**\n * Sets the frontmatter attributes of the note after the note content has been updated\n */\n setFrontmatterAttributes() {\n if (hasFrontMatter(this._content)) {\n this.frontmatterAttributes = getAttributes(this._content) || {}\n this.frontmatterTypes =\n Object.keys(this.frontmatterAttributes).length > 0 ? (this.frontmatterAttributes.type ? this.frontmatterAttributes.type.split(',').map((t) => t.trim()) : []) : []\n }\n }\n\n /**\n * Gets the content of the note.\n * @returns {string} The current content of the note.\n */\n get content(): string {\n return this._content\n }\n\n /**\n * Sets the content of the note and performs additional actions.\n * @param {string} value - The new content value.\n */\n set content(value: string) {\n this._content = value\n this.paragraphs = makeParagraphsFromContent(value)\n this.setFrontmatterAttributes()\n }\n\n __update(data?: any = {}): this {\n Object.keys(data).forEach((key) => {\n const value = data[key]\n if (key === 'content') {\n if (value !== '') {\n this._content = value\n this.paragraphs = makeParagraphsFromContent(this._content)\n }\n } else if (key === 'rawContent') {\n this.rawContent = value\n if (typeof value === 'string' && value !== '' && (data.content === undefined || data.content === '')) {\n this._content = value\n this.paragraphs = makeParagraphsFromContent(this._content)\n }\n } else {\n this[key] = data[key]\n }\n })\n return this\n }\n\n constructor(data?: any = {}) {\n this.__update(data)\n if (!this.paragraphs) this.paragraphs = []\n this.resetLineIndexesAndContent()\n }\n}\n\n// Helper function to determine the type of a line based on its content\nfunction getLineTypeAndContent(content: string, lastHeadingLevel: number = 0): { content: string, type: string, headingLevel: number } {\n const trimmedContent = content.trim()\n let type = 'unknown'\n let lineContent = trimmedContent.replace(/^\\t*/, '')\n let headingLevel = lastHeadingLevel\n if (lineContent === '---') {\n type = 'separator'\n } else if (/^\\s*#{1,} /.test(lineContent)) {\n type = 'title'\n // Extract heading level BEFORE removing the # characters\n const hashMatch = lineContent.match(/^\\s*(#{1,6})/)\n headingLevel = hashMatch ? hashMatch[1].length : 1\n lineContent = lineContent.replace(/^\\s*#{1,} /, '')\n } else if (lineContent.startsWith('- [x]') || lineContent.startsWith('* [x]')) {\n type = 'done'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('- [-]') || lineContent.startsWith('* [-]')) {\n type = 'cancelled'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('- [>]') || lineContent.startsWith('* [>]')) {\n type = 'scheduled'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('- [ ]') || lineContent.startsWith('* [ ]')) {\n type = 'open'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('- ') && !lineContent.startsWith('- [')) {\n type = 'list'\n lineContent = lineContent.slice(2)\n } else if (lineContent.startsWith('+ [x]')) {\n type = 'checklistDone'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('+ [-]')) {\n type = 'checklistCancelled'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('+ [>]')) {\n type = 'checklistScheduled'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('+ [ ]')) {\n type = 'checklist'\n lineContent = lineContent.slice(5)\n } else if (lineContent.startsWith('+ ') && !lineContent.startsWith('+ [')) {\n type = 'checklist'\n lineContent = lineContent.slice(2)\n } else if (lineContent.startsWith('* ')) {\n type = 'open'\n lineContent = lineContent.slice(2)\n } else if (/^\\s*\\d|\\w/.test(lineContent)) {\n type = 'text'\n }\n\n return { content: lineContent.trim(), type, headingLevel }\n}\n\n// Helper function to count leading tabs in a line\nfunction countLeadingTabs(content: string): number {\n const match = content.match(/^\\t*/)\n return match ? match[0].length : 0\n}\n\n// Helper function to create paragraphs from content\nfunction makeParagraphsFromContent(content: string): any[] {\n const lines = content.split('\\n')\n if (lines[lines.length - 1] === '') {\n lines.pop() // Remove the last line if it's empty\n }\n return lines.map((c, i) => {\n let lastHeadingLevel = 0\n const { content: lineContent, type, headingLevel } = getLineTypeAndContent(c, lastHeadingLevel)\n lastHeadingLevel = headingLevel\n return {\n content: lineContent,\n type,\n rawContent: c,\n lineIndex: i,\n indents: countLeadingTabs(c),\n headingLevel,\n }\n })\n}\n" }, { "path": "__mocks__/NotePlan.mock.js", "content": "/*\n * NotePlan mocks\n *\n * NOTE: Unlike the other mocks, this is a class and not an object. So you should use `new NotePlan()` to create an instance.\n * .e.g.\n * beforeAll(() => {\n * global.NotePlan = new NotePlan()\n * })\n *\n * Note: nested object example data are there for reference only -- will need to be deleted or cleaned up before use (consider using a factory)\n * For functions: check whether async or not & add params & return value\n *\n */\n\nexport class NotePlan {\n environment = {\n languageCode: 'en',\n regionCode: 'US',\n is12hFormat: true,\n preferredLanguages: ['en-US'],\n secondsFromGMT: -25200,\n localTimeZoneAbbreviation: 'PDT',\n localTimeZoneIdentifier: 'America/Los_Angeles',\n isDaylightSavingTime: true,\n daylightSavingTimeOffset: 3600,\n nextDaylightSavingTimeTransition: '2022-11-06T09:00:00.000Z',\n platform: 'macOS',\n hasSettings: true,\n version: '3.18.0',\n versionNumber: 3180,\n buildVersion: 1417, // = 3.18.0\n templateFolder: '@Templates',\n }\n // async openURL() { return null },\n // async resetCaches() { return null },\n selectedSidebarFolder = `SelectedFolder`\n // async showConfigurationView() { return null },\n\n /**\n * Mock AI function for testing\n */\n static ai(prompt, filenames = [], useStrictFilenames = false, model = 'gpt-4') {\n // Return a mock AI response for testing\n return Promise.resolve(`Mock AI Analysis: This appears to be a template error. Please check your variable definitions and syntax.`)\n }\n\n constructor(data = {}) {\n this.__update(data)\n }\n\n __update(data = {}) {\n Object.keys(data).forEach((key) => {\n this[key] = data[key]\n })\n return this\n }\n}\n" }, { "path": "__mocks__/Paragraph.mock.js", "content": "/* eslint-disable */\n/*\n * Paragraph mock class\n *\n * Usage: const myParagraph = new Paragraph({ param changes here })\n *\n */\n\nexport class Paragraph {\n // Properties\n blockId = null\n content = 'SET_ME_IN_TEST'\n contentRange = {} /* {\n\t\t\"start\": 0,\n\t\t\"end\": 2,\n\t\t\"length\": 2\n} , */\n date = new Date()\n filename = 'testFile.md'\n heading = ''\n headingLevel = 1\n headingRange = { start: 0, end: 0, length: 0 }\n indents = 0\n isRecurring = false\n lineIndex = 0\n linkedNoteTitles = []\n note = {} /* {\n\t\t\"filename\": \"Migrated/Marlita Hours.md\",\n\t\t\"type\": \"Notes\",\n\t\t\"title\": \"\",\n\t\t\"changedDate\": \"2021-09-07T13:49:41.000Z\",\n\t\t\"createdDate\": \"2021-04-29T20:30:00.000Z\",\n\t\t\"hashtags\": [],\n\t\t\"mentions\": [],\n\t\t\"linkedItems\": [],\n\t\t\"datedTodos\": [],\n\t\t\"backlinks\": [],\n\t\t\"frontmatterTypes\": [],\n\t\t\"content\": \"# \",\n\t\t\"paragraphs\": [\n\t\t\t\t\"{\\\"type\\\":\\\"title\\\",\\\"content\\\":\\\"\\\",\\\"rawContent\\\":\\\"# \\\",\\\"prefix\\\":\\\"# \\\",\\\"contentRange\\\":{},\\\"lineIndex\\\":0,\\\"heading\\\":\\\"\\\",\\\"headingLevel\\\":1,\\\"isRecurring\\\":false,\\\"indents\\\":0,\\\"filename\\\":\\\"Migrated/Marlita Hours.md\\\",\\\"noteType\\\":\\\"Notes\\\",\\\"linkedNoteTitles\\\":[],\\\"subItems\\\":[],\\\"referencedBlocks\\\":[],\\\"note\\\":{}}\"\n\t\t]\n} , */\n noteType = 'Notes'\n prefix = ''\n rawContent = 'SET_ME_IN_TEST'\n referencedBlocks = []\n subItems = []\n type = 'text'\n\n // Methods\n async children() {\n throw 'Paragraph :: children called, but children was not set. You should pass a children function with the paragraph'\n }\n // async duplicate() {\n // return this\n // }\n async init() {\n throw 'Paragraph :: init Not implemented yet'\n }\n\n constructor(data?: any = {}) {\n this.__update(data)\n if (!data.rawContent) {\n // set rawContent from content\n switch (this.type) {\n case 'open':\n this.rawContent = `- [ ] ${this.content}`\n break\n case 'cancelled':\n this.rawContent = `- [-] ${this.content}`\n break\n case 'done':\n this.rawContent = `- [x] ${this.content}`\n break\n case 'scheduled':\n this.rawContent = `- [>] ${this.content}`\n break\n case 'checklist':\n this.rawContent = `+ [ ] ${this.content}`\n break\n case 'checklistCancelled':\n this.rawContent = `+ [-] ${this.content}`\n break\n case 'checklistDone':\n this.rawContent = `+ [x] ${this.content}`\n break\n case 'checklistScheduled':\n this.rawContent = `+ [>] ${this.content}`\n break\n case 'separator':\n this.rawContent = `---`\n break\n case 'empty':\n this.rawContent = ``\n break\n }\n }\n // TODO: is there a way of incrementing lineIndex here?\n }\n\n __update(data?: any = {}) {\n Object.keys(data).forEach((key) => {\n this[key] = data[key]\n })\n return this\n }\n}\n" }, { "path": "__mocks__/PluginCommandObject.mock.js", "content": "/* eslint-disable */\n/*\n * PluginCommandObjectMock mock class\n *\n * Usage: const myPluginCommandObject = new PluginCommandObject({ param changes here })\n *\n */\n\nexport class PluginCommandObject {\n // Properties\n desc = 'PLACEHOLDER' // TODO: add value\n name = 'PLACEHOLDER' // TODO: add value\n pluginID = 'PLACEHOLDER' // TODO: add value\n pluginName = 'PLACEHOLDER' // TODO: add value\n\n // Methods\n\n constructor(data?: any = {}) {\n this.__update(data)\n }\n\n __update(data?: any = {}) {\n Object.keys(data).forEach((key) => {\n this[key] = data[key]\n })\n return this\n }\n}\n" }, { "path": "__mocks__/PluginObject.mock.js", "content": "/* eslint-disable */\n/*\n * PluginObject mock class\n *\n * Usage: const myPluginObject = new PluginObject({ param changes here })\n *\n */\n\nexport class PluginObject {\n // Properties\n author = 'PLACEHOLDER' // TODO: add value\n availableUpdate = 'PLACEHOLDER' // TODO: add value\n commands = [] /* sample: [{\n \"name\": \"atb - Create AutoTimeBlocks for >today's Tasks\",\n \"desc\": \"Read >today todos and insert them into today's calendar note as timeblocks\",\n \"pluginID\": \"dwertheimer.EventAutomations\",\n \"pluginName\": \"🗓 AutoTimeBlocking & Synced Today Todos\"\n} ] */\n desc = 'PLACEHOLDER' // TODO: add value\n id = 'PLACEHOLDER' // TODO: add value\n isOnline = 'PLACEHOLDER' // TODO: add value\n name = 'PLACEHOLDER' // TODO: add value\n releaseUrl = 'PLACEHOLDER' // TODO: add value\n repoUrl = 'PLACEHOLDER' // TODO: add value\n script = 'PLACEHOLDER' // TODO: add value\n version = 'PLACEHOLDER' // TODO: add value\n\n // Methods\n\n constructor(data?: any = {}) {\n this.__update(data)\n }\n\n __update(data?: any = {}) {\n Object.keys(data).forEach((key) => {\n this[key] = data[key]\n })\n return this\n }\n}\n" }, { "path": "__mocks__/Range.mock.js", "content": "/* eslint-disable */\n/*\n * Range mock class\n *\n * Usage: const myRange = new Range({ param changes here })\n *\n */\n\nexport class Range {\n // Properties\n start = 0\n end = 1\n length = 1\n\n // Methods\n\n constructor(data?: any = {}) {\n this.__update(data)\n }\n\n __update(data?: any = {}) {\n Object.keys(data).forEach((key) => {\n this[key] = data[key]\n })\n return this\n }\n}\n" }, { "path": "__mocks__/_README-Mocks.md", "content": "# Mocking NotePlan objects in your Jest testing files:\n\nThe best/fastest/easiest/most-reliable thing to do when writing plugins is to minimize the amount of code in the plugin entrypoint functions and rely on pure-JS support functions to do the heavy lifting. This is preferable, because those pure functions can be easily tested using Jest without relying on NotePlan's APIs.\n\nThat said, we have a goal of fully mocking the NotePlan APIs so that plugins can not only can have functional unit tests, but can also have integration tests which confirm that your plugin code is working end-to-end (and remains working as the codebase changes). \n\n> **The API-mocking is a work in progress and will take some time to get fully fleshed out. Many of the API functions are stubbed or commented out. You may need to implement a function in the mock you're using along the way (PRs are welcome!).** \n\nThat said, here's how the testing of NotePlan APIs in your plugin works:\n## Steps:\n**In your test file:**\n1. Import the mocks you need\n2. Hoist the relevant mocks up to global scope in the beforeAll() method of your test file\n3. Create sub-object content mocks (if necessary) to populate top level objects with Notes, Paragraphs, etc.\n \n\n## Testing using mocked-out data\nThe most basic example is: you have a function with a call to a NotePlan API that retrieves a piece of data. You want to test the function, but the test will fail without that data from NotePlan. In this case, we can use a Mock simply to return a fake piece of data from a simulated NotePlan API.\n\nThe following example is an actual example from the code base: tests whether the `isTimeBlockLine()` function returns expected values, using one field of mocked out data from the API (the `DataStore.preference(...)` function). This function cannot be tested without a mock because it contains this one line:\n```js\n const mustContainString = checkString(DataStore.preference(\"timeblockTextMustContainString\"))\n```\nThat call to DataStore will make a typical Jest test die. So we can just mock that DataStore function to return a value to our test:\n\n```js\n/* globals describe, expect, it, test, beforeAll */\nimport * as tb from '../timeblocks'\nimport DataStore from '@mocks/index'\n\nbeforeAll(() => {\n global.DataStore = DataStore\n})\n\ndescribe('helpers/timeblocks.js', () => { // file\n describe('isTimeBlockLine SHOULD MATCH', () => { // function\n test('should match: - @done(2021-12-12) 2:30-3:45', () => {\n expect(tb.isTimeBlockLine('- @done(2021-12-12) 2:30-3:45')).toEqual(true)\n })\n })\n})\n```\nThis now works because the DataStore mock returns '' for `DataStore.preference(\"timeblockTextMustContainString\")` and thus, our tests can continue.\n\n## Testing a call from your plugin to an NP API\nA slightly more complex example: We want to make sure that our plugin is writing the proper value to NotePlan editor. In this case, we need to listen in to writes to the Editor api to ensure the correct value is being passed.\n\nThe following example tests whether `Editor.insertTextAtCursor()` is called from the 'JestHelpers' plugin's `sayHello` function:\n```js\n/* global describe, test, it, jest, expect, beforeAll */\nimport * as NPfile from '../src/NPPluginMain' // import everything for this plugin\nimport { DataStore } from '@mocks/index' // import mock(s)\n\nbeforeAll(() => {\n global.Editor = Editor\n})\n\ndescribe('dwertheimer.JestHelpers' /*my plugin id*/, () => {\n describe('NPPluginMain' /* file */, () => {\n describe('sayHello' /* function */, () => {\n test('should insert text if called with a string param', async () => {\n const spy = jest.spyOn(Editor, 'insertTextAtCursor') // assuming my plugin calls this one NP command\n const result = await NPfile.sayHello('myText')\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenNthCalledWith(\n 1,\n `myText`,\n )\n // So we know that Editor.insertTextAtCursor was called with `myText` which was passed to the plugin entry point (e.g. from an xcallbackurl)\n spy.mockRestore()\n })\n })\n })\n})\n```\n\n## Mocking sub-objects\nThe top-level NP objects: `Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan` all have sub-objects that will likely need to be mocked as well,depending on what your plugin is doing. For example, `Editor` has a property called `note`. You can create that mock note using the `Note` factory:\n```js\n Editor.note = new Note({ filename: 'testingFile' })\n```\nEditor.note now has some basic properties, but to look like a real NotePlan `Note` object, a Note needs to have some paragraphs, and those paragraphs have some properties/methods also. You can mock the paragraphs with the `Paragraph` mock factory:\n```js\n Editor.note.paragraphs = [new Paragraph({ content: 'paraContent1' }),new Paragraph({ content: 'paraContent2' })]\n```\n\n**Note: as you can see, when you instantiate a new factory instance, you can pass through any variables you want to override (e.g. `.content` in the above example)**\n\n## A Full Example (from the \"plugin:create\" skeleton)\n\n```js\n// Jest testing docs: https://jestjs.io/docs/using-matchers\n/* global describe, test, jest, expect */\n\nimport * as mainFile from '../src/NPPluginMain'\nimport { copyObject } from '@helpers/dev'\n\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, Note, Paragraph, Backlink, Range, CalendarItem, PluginObject, PluginCommandObject } from '@mocks/index'\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = NotePlan\n})\n\ndescribe('{{pluginId}}' /* pluginID */, () => {\n describe('NPPluginMain' /* file */, () => {\n describe('sayHello' /* function */, () => {\n test('should insert text if called with a string param', async () => {\n // tests start with \"should\" to describe the expected behavior\n const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n const result = await mainFile.sayHello('Testing...')\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenNthCalledWith(\n 1,\n `***You clicked the link!*** The message at the end of the link is \"Testing...\". Now the rest of the plugin will run just as before...\\n\\n`,\n )\n spy.mockRestore()\n })\n test('should write result to console', async () => {\n // tests start with \"should\" to describe the expected behavior\n const spy = jest.spyOn(console, 'log')\n const result = await mainFile.sayHello()\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenNthCalledWith(1, expect.stringMatching(/The plugin says: HELLO WORLD FROM TEST PLUGIN!/))\n spy.mockRestore()\n })\n test('should call DataStore.settings', async () => {\n // tests start with \"should\" to describe the expected behavior\n const oldValue = DataStore.settings\n DataStore.settings = { settingsString: 'settingTest' }\n const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n const _ = await mainFile.sayHello()\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenNthCalledWith(1, expect.stringMatching(/settingTest/))\n DataStore.settings = oldValue\n spy.mockRestore()\n })\n test('should call DataStore.settings if no value set', async () => {\n // tests start with \"should\" to describe the expected behavior\n const oldValue = DataStore.settings\n DataStore.settings = { settingsString: undefined }\n const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n const _ = await mainFile.sayHello()\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenNthCalledWith(1, expect.stringMatching(/\\*\\*\\\"\\\"\\*\\*/))\n DataStore.settings = oldValue\n spy.mockRestore()\n })\n test('should CLO write note.paragraphs to console', async () => {\n // tests start with \"should\" to describe the expected behavior\n const prevEditorNoteValue = copyObject(Editor.note || {})\n Editor.note = new Note({ filename: 'testingFile' })\n Editor.note.paragraphs = [new Paragraph({ content: 'testingParagraph' })]\n const spy = jest.spyOn(console, 'log')\n const result = await mainFile.sayHello()\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenNthCalledWith(2, expect.stringMatching(/\\\"content\\\": \\\"testingParagraph\\\"/))\n Editor.note = prevEditorNoteValue\n spy.mockRestore()\n })\n test('should insert a link if not called with a string param', async () => {\n // tests start with \"should\" to describe the expected behavior\n const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n const result = await mainFile.sayHello('')\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenLastCalledWith(expect.stringMatching(/noteplan:\\/\\/x-callback-url\\/runPlugin/))\n spy.mockRestore()\n })\n test('should write an error to console on throw', async () => {\n // tests start with \"should\" to describe the expected behavior\n const spy = jest.spyOn(console, 'log')\n const oldValue = Editor.insertTextAtCursor\n delete Editor.insertTextAtCursor\n const result = await mainFile.sayHello()\n expect(spy).toHaveBeenCalled()\n expect(spy).toHaveBeenNthCalledWith(2, expect.stringMatching(/ERROR/))\n Editor.insertTextAtCursor = oldValue\n spy.mockRestore()\n })\n })\n })\n})\n```\n" }, { "path": "__mocks__/__tests__/fetch.mock.test.js", "content": "/* global jest, describe, test, expect, beforeAll */\nimport { CustomConsole } from '@jest/console' // see note below\nimport { DataStore, Editor, CommandBar, NotePlan } from '@mocks/index'\nimport { FetchMock } from '../Fetch.mock'\nimport { simpleFormatter } from '@mocks/index'\n\n// Make DataStore and Editor available globally for the source code\nglobal.DataStore = DataStore\nglobal.Editor = Editor\nglobal.CommandBar = CommandBar\nglobal.NotePlan = NotePlan\n\nconst PLUGIN_NAME = `Fetch.mock`\nconst FILENAME = ``\n\nbeforeAll(() => {\n global.console = new CustomConsole(process.stdout, process.stderr, simpleFormatter) // minimize log footprint\n})\n\n/* Samples:\nexpect(result).toMatch(/someString/)\nexpect(result).not.toMatch(/someString/)\nexpect(result).toEqual([])\nimport { mockWasCalledWith } from '@mocks/mockHelpers'\n const spy = jest.spyOn(console, 'log')\n const result = mainFile.getConfig()\n expect(mockWasCalledWith(spy, /config was empty/)).toBe(true)\n spy.mockRestore()\n\n test('should return the command object', () => {\n const result = f.getPluginCommands({ 'plugin.commands': [{ a: 'foo' }] })\n expect(result).toEqual([{ a: 'foo' }])\n })\n*/\n\ndescribe(`${PLUGIN_NAME}`, () => {\n describe(`${FILENAME}`, () => {\n //functions go here using jfunc command\n /*\n * constructor()\n */\n describe('constructor()' /* function */, () => {\n test('should create fetch with default response', () => {\n const f = new FetchMock()\n expect(f.responses.length).toEqual(1)\n expect(f.responses[0].response).toMatch(/did not match/)\n })\n test('should create fetch with supplied response', () => {\n const f = new FetchMock([{ match: { url: 'foo', optionsBody: 'bar' }, response: 'baz' }])\n expect(f.responses.length).toEqual(2)\n expect(f.responses[0].response).toMatch(/baz/)\n expect(f.responses[1].response).toMatch(/did not match/)\n })\n test('should return default response with no match', async () => {\n const f = new FetchMock()\n const result = await f.fetch()\n expect(result).toMatch(/did not match/)\n })\n test('should return match if both url and body match', async () => {\n const f = new FetchMock([{ match: { url: 'foo', optionsBody: 'bar' }, response: 'baz' }])\n const result = await f.fetch('http://foo', { body: 'does it include bar' })\n expect(result).toMatch(/baz/)\n })\n test('should return match if both url and body match (case insensitive)', async () => {\n const f = new FetchMock([{ match: { url: 'FOO', optionsBody: 'Bar' }, response: 'baz' }])\n const result = await f.fetch('http://foo', { body: 'does it include bar' })\n expect(result).toMatch(/baz/)\n })\n test('should return default if url matches but not body', async () => {\n const f = new FetchMock([{ match: { url: 'foo', optionsBody: 'bar' }, response: 'baz' }])\n const result = await f.fetch('http://foo', { body: 'does it include xxx' })\n expect(result).toMatch(/did not match/)\n })\n test('should return default if body matches but not url', async () => {\n const f = new FetchMock([{ match: { url: 'fun', optionsBody: 'bar' }, response: 'baz' }])\n const result = await f.fetch('http://foo', { body: 'does it include bar' })\n expect(result).toMatch(/did not match/)\n })\n test('should return match if url matches and body is blank', async () => {\n const f = new FetchMock([{ match: { url: 'foo', optionsBody: '' }, response: 'baz' }])\n const result = await f.fetch('http://foo', { body: 'does it include bar' })\n expect(result).toMatch(/baz/)\n })\n test('should return match if url matches and body is not passed', async () => {\n const f = new FetchMock([{ match: { url: 'foo' }, response: 'baz' }])\n const result = await f.fetch('http://foo', { body: 'does it include bar' })\n expect(result).toMatch(/baz/)\n })\n })\n })\n})\n" }, { "path": "__mocks__/index.js", "content": "export { Calendar } from './Calendar.mock'\nexport { default as Clipboard } from './Clipboard.mock'\nexport { default as CommandBar } from './CommandBar.mock'\nexport { DataStore } from './DataStore.mock'\nexport { Editor } from './Editor.mock'\nexport { NotePlan } from './NotePlan.mock'\nexport { Note } from './Note.mock'\nexport { Paragraph } from './Paragraph.mock'\nexport { CalendarItem } from './CalendarItem.mock'\nexport { Backlink } from './Backlink.mock'\nexport { Range } from './Range.mock'\nexport { PluginObject } from './PluginObject.mock'\nexport { PluginCommandObject } from './PluginCommandObject.mock'\nexport { simpleFormatter, mockWasCalledWithString, loadFactoryFile } from './jestHelpers'\n" }, { "path": "__mocks__/jestHelpers.js", "content": "// @flow\nimport path from 'path'\nimport { existsSync, promises as fs } from 'fs'\n\n/**\n * Check if a spy was called (at any point) with a string parameter matching the given string/regex\n * Mostly used for checking a console.log call when you don't know when in the sequence that log may have been called\n * Assumes that the parameter to the mock was a string (e.g. console.log(xxx))\n * @param { JestSpyType } spy\n * @param {regexp|string} testStrRegex - a string or regex to match the spy call's arguments\n * @returns {boolean} was called or not\n * @example usage:\n const spy = jest.spyOn(console, 'log')\n const result = mainFile.getConfig()\n expect(mockWasCalledWithString(spy, /config was empty/)).toBe(true)\n */\nexport const mockWasCalledWithString = (spy: any, testStrRegex: RegExp | string): boolean => {\n let found: any = []\n const regex = typeof testStrRegex === 'string' ? new RegExp(testStrRegex) : testStrRegex\n if (spy?.mock?.calls?.length) {\n const calls = spy.mock.calls\n found = calls.filter((call) => call.find((arg) => regex.test(arg)))\n }\n return found.length > 0\n}\n\n/**\n * Minimize console.log output during test runs\n * (way to much wasted whitespace in the jest default output)\n * per: https://stackoverflow.com/questions/51555568/remove-logging-the-origin-line-in-jest/57443150#57443150\n * @param {*} type\n * @param {*} message\n * @returns\n */\nexport function simpleFormatter(_type: string, message: string): string {\n const TITLE_INDENT = ' '\n const CONSOLE_INDENT = `${TITLE_INDENT} `\n\n return message\n .split(/\\n/)\n .map((line) => CONSOLE_INDENT + line)\n .join('\\n')\n}\n\n/**\n * Load a factory file for use in Jest debugging\n * Factory files are in the /factories subfolder of the calling function\n * @param {string} factoryName\n * @returns\n */\nexport async function loadFactoryFile(factoryName: string = ''): Promise<string> {\n const factoryFilename = path.join(__dirname, 'factories', factoryName)\n if (existsSync(factoryFilename)) {\n return await fs.readFile(factoryFilename, 'utf-8')\n }\n return `FACTORY_NOT_FOUND - ${factoryFilename}`\n}\n" }, { "path": "__mocks__/support/pluginSample.json", "content": "{\n \"noteplan.minAppVersion\": \"3.0.21\",\n \"macOS.minVersion\": \"10.15.7\",\n \"iOS.minVersion\": \"14\",\n \"plugin.id\": \"test.plugin.id\",\n \"plugin.name\": \"Move selected note to another folder\",\n \"plugin.description\": \"Move a note from the current folder into another.\",\n \"plugin.author\": \"Eduard Metzger\",\n \"plugin.url\": \"https://…\",\n \"plugin.version\": \"0.0.2\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.commands\": [\n {\n \"name\": \"move\",\n \"alias\": [\n \"m\",\n \"mv\"\n ],\n \"description\": \"Moves note to another folder\",\n \"jsFunction\": \"moveNote\",\n \"arguments\": [\n \"note title\",\n \"heading\"\n ]\n },\n {\n \"name\": \"command1Name\",\n \"jsFunction\": \"command1\",\n \"description\": \"\",\n \"isPreset\": true\n },\n {\n \"name\": \"command2Name\",\n \"jsFunction\": \"command2\",\n \"description\": \"\",\n \"data\": \"foos\",\n \"isPreset\": true\n },\n {\n \"name\": \"run preset sample\",\n \"jsFunction\": \"runPreset01\",\n \"description\": \"run preset desc\",\n \"isPreset\": true\n }\n ],\n \"plugin.settings\": [\n {\n \"type\": \"hidden\",\n \"key\": \"hiddenKey\",\n \"title\": \"String Setting\",\n \"description\": \"An example of a string setting.\",\n \"default\": \"hello world\"\n },\n {\n \"type\": \"string\",\n \"key\": \"someString\",\n \"title\": \"String Setting\",\n \"description\": \"An example of a string setting.\",\n \"default\": \"What a value\",\n \"required\": true\n },\n {\n \"type\": \"number\",\n \"key\": \"someNumber\",\n \"title\": \"Number Setting\",\n \"description\": \"An example of a number setting.\"\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Heading\"\n },\n {\n \"type\": \"bool\",\n \"key\": \"someBool\",\n \"title\": \"Boolean Setting\",\n \"description\": \"An example of a boolean setting.\"\n },\n {\n \"type\": \"date\",\n \"key\": \"someDate\",\n \"title\": \"Date Setting\",\n \"description\": \"An example of a date setting.\",\n \"format\": \"YYYY-MM-dd\"\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Heading\"\n },\n {\n \"type\": \"[string]\",\n \"key\": \"someStringArray\",\n \"title\": \"String Array Setting\",\n \"description\": \"An example of a string array setting.\",\n \"default\": [\n \"one\",\n \"two\",\n \"three\"\n ]\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"string\",\n \"key\": \"someStringEnum\",\n \"title\": \"String Setting With Choices\",\n \"description\": \"An example of a string setting with choices.\",\n \"choices\": [\n \"one\",\n \"two\",\n \"three\"\n ]\n },\n {\n \"type\": \"json\",\n \"key\": \"shortcutExpenses\",\n \"title\": \"Shortcut Expenses\",\n \"description\": \"Just some example shortcut expenses - please adapt to your needs. You can also add an amount, then you can insert the shortcut without any question.\",\n \"default\": \"[\\n\\t{\\n\\thello: \\\"world\\\"\\n\\t}\\n]\",\n \"required\": true,\n \"boxHeight\": 300\n }\n ]\n}" }, { "path": "aaronpoweruser.ReadwiseUnofficial/CHANGELOG.md", "content": "# aaronpoweruser.ReadwiseUnofficial Changelog\n\n## About aaronpoweruser.ReadwiseUnofficial Plugin\n\nSee Plugin [README](https://github.com/NotePlan/plugins/blob/main/aaronpoweruser.ReadwiseUnofficial/README.md) for details on available commands and use case.\n\n## [1.1.4] Readwise 2024-05-28 (@aaronpoweruser)\n\n- Add a setting for paragraph type.\n\n## [1.1.3] Readwise 2024-05-22 (@aaronpoweruser)\n\n- Ignore leading escaped quotes\n- Code cleanup\n- Remove illegal characters in daily review titles.\n- Switch book highlight links to Kindle web reader as deep links are [deprecated](https://help.readwise.io/article/40-can-i-jump-to-a-highlight-directly-in-the-kindle-app).\n\n## [1.1.2] Readwise 2024-04-22 (aaronpoweruser)\n\n- Fix Sync log dates not respecting time zones.\n\n## [1.1.1] Readwise 2024-04-20 (aaronpoweruser)\n\n- Fix internal links in daily reviews.\n\n## [1.1.0] Readwise 2024-04-19 (aaronpoweruser)\n\n- Refactor\n- Added a sync log see [README](https://github.com/NotePlan/plugins/blob/main/aaronpoweruser.ReadwiseUnofficial/README.md).\n- Fixed alert dialog count being wrong sometimes.\n- Fixed illegal characters and newlines in titles.\n- Add support for daily reviews via template.\n\n## [1.0.1] Readwise 2023-08-20 (aaronpoweruser)\n\n- [#452] Fix pagination issue for users with large libraries thanks @TobiasMende\n\n## [1.0.0] Readwise 2023-02-07 (aaronpoweruser)\n\n- public release\n\n## [0.1.8] Readwise 2023-02-07 (aaronpoweruser)\n\n- Show user notes\n- Add support for highlight headings\n\n## [0.1.7] Readwise 2023-01-25 (aaronpoweruser)\n\n- Settings description clean up\n- Fix null highlight links\n- Fix unneeded long titles\n\n## [0.1.6] - 2023-01-12 (aaronpoweruser)\n\n- Fix access token dialog\n- Use readable titles to make linking to notes easier\n- Add long title field\n- Allow Supplemental(readwise generated) notes to be grouped with main notes\n- Change highlights from list to quotes\n\n## [0.1.5] - 2023-01-12 (aaronpoweruser)\n\n- Fix metadata not being created\n- Fixed double metadata when not using group by type\n- Allow empty tag prefixes\n\nKnown issues:\n\n- \"Don’t Set Goals… Do This Instead\" causes a new note to be created\n- Using heading as metadata does not support tag updates\n- Images are not handled gracefully\n\n## [0.1.4] - 2023-01-09 (aaronpoweruser)\n\n- Clean up new lines in notes\n- add success message\n- Fix rebuild\n\n## [0.1.3] - 2023-01-03 (aaronpoweruser)\n\n- Add front matter support\n- Add optional tag prefix\n- Clean up settings\n- Code cleanup\n\n## [0.1.2] - 2023-01-02 (aaronpoweruser)\n\n- Add missing highlight header\n- Increase timeout when checking for new note\n\n## [0.1.1] - 2022-12-29 (aaronpoweruser)\n\n- Enabled only syncing new highlights (added a hidden setting to override)\n- Clean up plugin settings description\n- Only add metadata once (need to handle tag updates)\n- Add link to kindle for books (fixes links being null)\n\n## [0.1.0] - 2022-12-28 (aaronpoweruser)\n\nFirst release\n\n## Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## Plugin Versioning Uses Semver\n\nAll NotePlan plugins follow `semver` versioning. For details, please refer to [semver website](https://semver.org/)\n" }, { "path": "aaronpoweruser.ReadwiseUnofficial/README.md", "content": "# Readwise Unofficial Noteplan Plugin\n\n## About This Plugin\n\nA sync engine for readwise\n\n### Features\n\n- Daily review's via templates\n- Full highlight download\n- Highlight updates\n- Tags\n- Group be content type\n- Set download folder\n- Front matter support\n- NotePlan tags\n\n![General features](docs/ReadwiseSync.png)\n\n### Todo\n\n- Index note\n- Image support (needs Noteplan API update)\n\n### Known issues\n\n- Using heading as metadata does not support tag updates\n- Images are not handled gracefully\n\n## Commands\n\n### //Readwise sync\n\nDownloads new highlights since last sync\n\n### //Readwise rebuild\n\n**Only needs to be used if highlights are deleted**\nDownloads all highlights (if they already exist they will be duplicated)\n\n### //Readwise Daily review\n\nDownloads daily reviews (does not mark as read) with links to note and author.\nCan be added to a note with templates using\n\n``` javascript\n<%- await DataStore.invokePluginCommandByName(\"Readwise Daily Review\",\"aaronpoweruser.ReadwiseUnofficial\") %>\n```\n\n![Daily review](docs/dailyReview.png)\n\n## Settings\n\nThese commands require configuration.\n\n### Access Token (*required*)\n\n1. Go to the [Readwise](readwise.io/access_token).\n2. Copy and paste that token to plugin settings.\n\n### Note Folder\n\nThis setting specifies the folder to which this plugin will create a note.\n\n### Tag Prefix (optional)\n\nThis setting specifies the prefix of the tag imported from Readwise.\n\n### Metadata format\n\nFrontMatter will store the metadata in the front matter of the note. Heading will store the metadata in a heading at the start of the note.\n\n### Group by type\n\nGroup all highlights in under the readwise folder or having them separated by content type ie readwise/books, readwise/articles.\n\n### Group supplemental highlights separately\n\n**Ignored if group by type is disabled**\nGroup all highlights together or keep supplemental (readwise generated) highlights separate.\n\n### Sync log\n\nA note that has all highlights synced during a sync with dated references.\n\n![Sync log](docs/syncLog.png)\n\n## Latest Updates\n\nSee [CHANGELOG](https://github.com/NotePlan/plugins/blob/main/aaronpoweruser.ReadwiseUnofficial/CHANGELOG.md) for latest updates/changes to this plugin.\n" }, { "path": "aaronpoweruser.ReadwiseUnofficial/plugin.json", "content": "{\n \"COMMENT\": \"Details on these fields: https://help.noteplan.co/article/67-create-command-bar-plugins\",\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.4.0\",\n \"plugin.id\": \"aaronpoweruser.ReadwiseUnofficial\",\n \"plugin.name\": \"📚 Readwise Unofficial\",\n \"plugin.version\": \"1.1.4\",\n \"plugin.lastUpdateInfo\": \"Added paragraph type setting. Fixed links to highlights on web.\\nFix sync log dates being wrong.\\nAdd a sync log note. \\nAdd support for daily reviews via templates\",\n \"plugin.description\": \"A sync plugin for Readwise\",\n \"plugin.author\": \"aaronpoweruser\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.url\": \"https://github.com/NotePlan/plugins/blob/main/aaronpoweruser.ReadwiseUnofficial/README.md\",\n \"plugin.changelog\": \"https://github.com/NotePlan/plugins/blob/main/aaronpoweruser.ReadwiseUnofficial/CHANGELOG.md\",\n \"plugin.commands\": [\n {\n \"name\": \"Readwise sync\",\n \"description\": \"Sync Readwise highlights\",\n \"jsFunction\": \"readwiseSync\"\n },\n {\n \"name\": \"Readwise Daily Review\",\n \"description\": \"Sync Readwise highlights\",\n \"jsFunction\": \"readwiseDailyReview\"\n },\n {\n \"name\": \"Readwise rebuild\",\n \"description\": \"Force sync Readwise highlights\",\n \"jsFunction\": \"readwiseRebuild\",\n \"alias\": [\n \"rwfs\"\n ],\n \"hidden\": false\n },\n {\n \"name\": \"onOpen\",\n \"description\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"jsFunction\": \"onOpen\",\n \"hidden\": true\n },\n {\n \"name\": \"onEditorWillSave\",\n \"description\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"jsFunction\": \"onEditorWillSave\",\n \"hidden\": true\n }\n ],\n \"plugin.settings\": [\n {\n \"COMMENT\": \"Plugin settings documentation: https://help.noteplan.co/article/123-plugin-configuration\",\n \"type\": \"heading\",\n \"title\": \"Readwise Unofficial Settings\"\n },\n {\n \"title\": \"Access token\",\n \"key\": \"accessToken\",\n \"required\": true,\n \"type\": \"string\",\n \"description\": \"Enter your readwise access token from readwise.io/access_token\",\n \"default\": \"\"\n },\n {\n \"title\": \"Note folder\",\n \"key\": \"baseFolder\",\n \"type\": \"string\",\n \"description\": \"The folder to store all highlights in\",\n \"default\": \"Readwise\"\n },\n {\n \"title\": \"Tag Prefix\",\n \"key\": \"tagPrefix\",\n \"type\": \"string\",\n \"description\": \"Prefix for Readwise tags\",\n \"default\": \"Readwise\"\n },\n {\n \"title\": \"Metadata format\",\n \"key\": \"useFrontMatter\",\n \"type\": \"string\",\n \"description\": \"FrontMatter will store the metadata in the front matter of the note. Heading will store the metadata in a heading in the note.\",\n \"choices\": [\n \"FrontMatter\",\n \"Heading\"\n ],\n \"default\": \"FrontMatter\",\n \"required\": true\n },\n {\n \"title\": \"Highlight paragraph type\",\n \"key\": \"paragraphType\",\n \"type\": \"string\",\n \"description:\": \"The type of paragraph to use for the highlight. quote: Use a blockquote for the highlight, list: Use a bullet for the highlight\",\n \"choices\": [\n \"quote\",\n \"list\"\n ],\n \"default\": \"quote\",\n \"required\": true\n },\n {\n \"title\": \"Group by type\",\n \"key\": \"groupByType\",\n \"type\": \"bool\",\n \"description\": \"Group all highlights in under the readwise folder or having them separated by content type ie readwise/books, readwise/articles.\",\n \"default\": true,\n \"required\": true\n },\n {\n \"title\": \"Group supplemental highlights separately\",\n \"key\": \"ignoreSupplementals\",\n \"type\": \"bool\",\n \"description\": \"** Ignored if group by type is disabled **\\nGroup all highlights together or keep supplemental (readwise generated) highlights seperate.\",\n \"default\": true,\n \"required\": true\n },\n {\n \"title\": \"Add a link to highlight\",\n \"key\": \"showLinkToHighlight\",\n \"type\": \"bool\",\n \"description\": \"Include a link to the source of the highlight in the note.\",\n \"default\": false,\n \"required\": true\n },\n {\n \"title\": \"Create a sync log\",\n \"key\": \"writeSyncLog\",\n \"type\": \"bool\",\n \"description\": \"Include a log of the synced highlights.\",\n \"default\": false,\n \"required\": true\n },\n {\n \"COMMENT\": \"Enable to force a resync of all highlights\",\n \"title\": \"Force sync all highlights\",\n \"key\": \"forceSync\",\n \"type\": \"hidden\",\n \"description\": \"Debug setting to always recreate all highlights\",\n \"default\": \"false\",\n \"required\": false\n },\n {\n \"NOTE\": \"DO NOT CHANGE THE FOLLOWING SETTINGS; ADD YOUR SETTINGS ABOVE ^^^\",\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"INFO\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much logging output will be displayed when executing Readwise Unofficial commands in NotePlan Plugin Console Logs (NotePlan -> Help -> Plugin Console)\\n\\n - DEBUG: Show All Logs\\n - INFO: Only Show Info, Warnings, and Errors\\n - WARN: Only Show Errors or Warnings\\n - ERROR: Only Show Errors\\n - none: Don't show any logs\",\n \"default\": \"INFO\",\n \"required\": true\n }\n ]\n}" }, { "path": "aaronpoweruser.ReadwiseUnofficial/src/NPReadwise.js", "content": "// @flow\nimport { showMessage } from '../../helpers/userInput'\nimport pluginJson from '../plugin.json'\nimport { checkAccessToken, escapeTwitterHandle, getParagraphTypeChar, removeInvalidChars, removeNewlines } from './NPReadwiseHelpers'\nimport { parseHighlightsAndWriteToNote } from './NPReadwiseNotes'\nimport { startReadwiseSyncLog, finishReadwiseSyncLog } from './NPReadwiseSyncLog'\nimport { log, logDebug, logError } from '@helpers/dev'\n\nconst LAST_SYNC_TIME = 'last_sync_time'\n\n/**\n * Syncs new readwise highlights\n */\nexport async function readwiseSync(): Promise<void> {\n checkAccessToken()\n const response = await getReadwise(false)\n await handleReadwiseSync(response)\n}\n\n/**\n * Rebuilds all readwise highlights\n */\nexport async function readwiseRebuild(): Promise<void> {\n checkAccessToken()\n const response = await getReadwise(true)\n await handleReadwiseSync(response)\n}\n\n/**\n * Gets the daily review highlights from Readwise\n * @returns {string} - the highlights as a string\n */\nexport async function readwiseDailyReview(): Promise<string> {\n checkAccessToken()\n return await getReadwiseDailyReview()\n}\n\nasync function handleReadwiseSync(response: any): Promise<void> {\n let downloadHighlightCount = 0,\n updatedSourceCount = 0\n await startReadwiseSyncLog()\n response.forEach((highlightSource) => {\n updatedSourceCount++\n downloadHighlightCount += highlightSource.highlights.length\n parseHighlightsAndWriteToNote(highlightSource)\n })\n log(pluginJson, `Downloaded ${downloadHighlightCount} highlights from Readwise. Updated ${updatedSourceCount} notes.`)\n await showMessage(`Downloaded ${downloadHighlightCount} highlights from Readwise. Updated ${updatedSourceCount} notes.`)\n await finishReadwiseSyncLog(downloadHighlightCount, updatedSourceCount)\n}\n\n/**\n * Gets the readwise data from the API\n * @param {boolean} force - if true, will ignore the last sync time and get all data\n * @returns {*} - the readwise data as a JSON object\n * @see https://readwise.io/api_deets\n */\nasync function getReadwise(force: boolean): Promise<any> {\n const accessToken = DataStore.settings.accessToken ?? ''\n let lastFetchTime = DataStore.loadData(LAST_SYNC_TIME, true) ?? ''\n if (DataStore.settings.forceSync === 'true' || force === true) {\n lastFetchTime = ''\n }\n log(pluginJson, `last fetch time is : ${lastFetchTime}`)\n logDebug(pluginJson, `base folder is : ${DataStore.settings.baseFolder}`)\n\n return await doReadWiseFetch(accessToken, lastFetchTime, 0, '')\n}\n\n/*\n * Recursively fetches readwise data\n * @param {string} accessToken - the readwise access token\n * @param {string} lastFetchTime - the last time the data was fetched\n * @param {int} downloadCount - the number of highlights downloaded\n * @param {string} nextPageCursor - the cursor for the next page of data\n * @returns {*} - the readwise data as a JSON object\n * @see https://readwise.io/api_deets\n */\nasync function doReadWiseFetch(accessToken: string, lastFetchTime: string, downloadCount: number, nextPageCursor: string): Promise<any> {\n try {\n const url = `https://readwise.io/api/v2/export/?updatedAfter=${lastFetchTime}&pageCursor=${nextPageCursor}`\n\n const options = {\n method: 'GET',\n headers: {\n Authorization: `token ${accessToken}`,\n },\n }\n const response = await fetch(url, options)\n DataStore.saveData(new Date().toISOString(), LAST_SYNC_TIME, true)\n\n const parsedJson = JSON.parse(response)\n const pageCursor = parsedJson.nextPageCursor\n logDebug(pluginJson, `page cursor is : ${pageCursor}`)\n\n let data: any = []\n const count = parsedJson.count + downloadCount\n if (pageCursor !== null && pageCursor !== '') {\n data = await doReadWiseFetch(accessToken, lastFetchTime, count, pageCursor)\n }\n const result = parsedJson.results.concat(data)\n // DataStore.saveData(JSON.stringify(result), 'readwise_data.json', true)\n return result\n } catch (error) {\n logError(pluginJson, error)\n }\n}\n/*\n * Gets the users Daily review from the readwise api\n * @returns {string} - the daily review highlights\n */\nasync function getReadwiseDailyReview(): Promise<string> {\n const accessToken = DataStore.settings.accessToken ?? ''\n let highlightString = ''\n try {\n const url = `https://readwise.io/api/v2/review/`\n\n const options = {\n method: 'GET',\n headers: {\n Authorization: `token ${accessToken}`,\n },\n }\n const response = await fetch(url, options)\n const highlights = JSON.parse(response).highlights\n\n await highlights.map((highlight) => {\n const formattedHighlight = `${removeNewlines(highlight.text)} [ [[${removeInvalidChars(highlight.title)}]], [[${escapeTwitterHandle(highlight.author)}]] ]`\n highlightString += `${getParagraphTypeChar()} ${formattedHighlight}\\n`\n })\n if (highlightString.endsWith('\\n')) {\n // remove the last newline\n highlightString = highlightString.substring(0, highlightString.length - 1)\n }\n logDebug(pluginJson, `Daily review highlights are\\n\\n ${highlightString}`)\n } catch (error) {\n logError(pluginJson, error)\n }\n return highlightString\n}\n" }, { "path": "aaronpoweruser.ReadwiseUnofficial/src/NPReadwiseHelpers.js", "content": "// @flow\nimport { showMessage } from '../../helpers/userInput'\nimport pluginJson from '../plugin.json'\nimport { logDebug } from '@helpers/dev'\n\nconst READWISE_API_KEY_LENGTH = 50\n\n/**\n * Checks if the readwise access token is valid\n */\nexport async function checkAccessToken(): Promise<void> {\n const accessToken = DataStore.settings.accessToken ?? ''\n logDebug(pluginJson, `access token is : ${accessToken}`)\n\n if (accessToken === '') {\n await showMessage('No access token found. Please add your Readwise access token in the plugin settings.')\n } else if (accessToken.length !== READWISE_API_KEY_LENGTH) {\n await showMessage('Invalid access token. Please check your Readwise access token in the plugin settings.')\n }\n}\n\n/**\n * @param {*} source Readwise data as a JSON object\n * @returns Note title\n */\nexport function buildReadwiseNoteTitle(source: any): string {\n if (source.readable_title !== '') {\n return removeInvalidChars(source.readable_title)\n } else if (source.title !== '') {\n return removeInvalidChars(source.title)\n } else {\n return removeInvalidChars(source.author)\n }\n}\n\n/**\n * Sanitize the string by removing invalid characters\n * @param {string} string - the string to sanitize\n * @returns {string} - the sanitized string\n */\nexport function removeInvalidChars(string: string): string {\n return removeNewlines(\n string\n .replace(/^\"/, '') // remove leading double quote\n .trim(),\n )\n}\n\n/**\n * Parse readwise data and generate front matter\n * @param {*} source - the readwise data as a JSON object\n * @returns\n */\nexport function buildReadwiseFrontMatter(source: any): any {\n const frontMatter = {}\n // $FlowIgnore[prop-missing] - intentionally setting properties dynamically as frontMatter keys are dynamic\n frontMatter.author = `[[${escapeTwitterHandle(source.author)}]]`\n if (source.readable_title.toLowerCase().trim() !== source.title.toLowerCase().trim()) {\n // $FlowIgnore[prop-missing] - intentionally setting properties dynamically as frontMatter keys are dynamic\n frontMatter.long_title = removeInvalidChars(source.title)\n }\n if (source.book_tags !== null && source.book_tags.length > 0) {\n // $FlowIgnore[prop-missing] - intentionally setting properties dynamically as frontMatter keys are dynamic\n frontMatter.tags = source.book_tags.map((tag) => `${formatTag(tag.name)}`).join(', ')\n }\n if (source.unique_url !== null) {\n // $FlowIgnore[prop-missing] - we are intentionally setting properties dynamically\n frontMatter.url = source.unique_url\n }\n return frontMatter\n}\n\n/**\n * Creates the metadata heading for the note\n * @param {*} source - the readwise data as a JSON object\n * @returns {string} - the formatted heading\n */\nexport function buildReadwiseMetadataHeading(source: any): string {\n let metadata = `author: [[${escapeTwitterHandle(source.author)}]]\\n`\n if (source.book_tags !== null && source.book_tags.length > 0) {\n metadata += `tags: ${source.book_tags.map((tag) => `${formatTag(tag.name)}`).join(', ')}\\n`\n }\n if (source.unique_url !== null) {\n metadata += `url: ${source.unique_url}`\n }\n if (source.readable_title.toLowerCase().trim() !== source.title.toLowerCase().trim()) {\n metadata += `long_title: ${removeInvalidChars(source.title)}`\n }\n return metadata\n}\n\n/**\n * Formats the note tag using the prefix from plugin settings\n * @param {string} tag - the tag to format\n * @returns {string} - the formatted tag\n */\nfunction formatTag(tag: string): string {\n const prefix = DataStore.settings.tagPrefix ?? ''\n if (prefix === '') {\n return `#${tag}`\n } else {\n return `#${prefix}/${tag}`\n }\n}\n\n/**\n * Remove all newline characters from a string\n * @param {string} text - the text to remove newline characters from\n * @returns {string} - the text with newline characters removed\n */\nexport function removeNewlines(text: string): string {\n return text.replaceAll(/\\n/g, ' ')\n}\n\n/**\n * Escapes Twitter handles by adding 'Twitter/' before the '@' symbol\n * to avoid creating a mention in Noteplan\n * and removing 'on Twitter' from the handle\n * @param {string} handle - the Twitter handle to escape\n * @returns {string} - the escaped Twitter handle\n */\nexport function escapeTwitterHandle(handle: string): string {\n if (handle.startsWith('@') && handle.endsWith(' on Twitter')) {\n return handle.replace('@', 'Twitter/@').replace(' on Twitter', '')\n }\n return handle\n}\n\n/**\n * Gets the date in iso format with the local timezone\n * @returns {string} - the local date\n */\nexport function getLocalDate(): string {\n const local_dateTime_in_mills = new Date().setHours(new Date().getHours() - new Date().getTimezoneOffset() / 60)\n const local_dateTime = new Date(local_dateTime_in_mills).toISOString()\n return local_dateTime.split('T')[0]\n}\n\n/**\n * Get the paragraph type character based on settings\n * @returns {string} - the paragraph type character\n */\nexport function getParagraphTypeChar(): string {\n const paragraphType = DataStore.settings.paragraphType ?? 'quote'\n let paragraphChar = '>'\n if (paragraphType === 'quote') {\n paragraphChar = '>'\n } else if (paragraphType === 'list') {\n paragraphChar = '-'\n }\n return paragraphChar\n}\n" }, { "path": "aaronpoweruser.ReadwiseUnofficial/src/NPReadwiseNotes.js", "content": "// @flow\nimport pluginJson from '../plugin.json'\nimport { updateFrontMatterVars } from '../../helpers/NPFrontMatter'\nimport { findEndOfActivePartOfNote } from '../../helpers/paragraph'\nimport { buildReadwiseFrontMatter, buildReadwiseMetadataHeading, buildReadwiseNoteTitle, removeNewlines } from './NPReadwiseHelpers'\nimport { writeReadwiseSyncLogLine } from './NPReadwiseSyncLog'\nimport { logDebug, logError } from '@helpers/dev'\nimport { getOrMakeRegularNoteInFolder } from '@helpers/NPnote'\n\n/**\n * Gets or creates the note for the readwise data\n * @param {string} title - the title of the note\n * @param {string} category - the category of the note\n * @returns {TNote} - the note\n */\nasync function getOrCreateReadwiseNote(title: string, category: string): Promise<?TNote> {\n const rootFolder = DataStore.settings.baseFolder ?? 'Readwise'\n let baseFolder = rootFolder\n let outputNote: ?TNote\n if (DataStore.settings.groupByType === true) {\n // Note: supplementals are not guaranteed to have user generated highlights\n if (DataStore.settings.ignoreSupplementals === true && category === 'supplementals') {\n baseFolder = `${rootFolder}/books`\n } else {\n baseFolder = `${rootFolder}/${category}`\n }\n }\n try {\n outputNote = await getOrMakeRegularNoteInFolder(title, baseFolder, '')\n } catch (error) {\n logError(pluginJson, error)\n }\n return outputNote\n}\n\n/**\n * Parses the readwise data and writes it to a note\n * @param {*} source - the readwise data as a JSON object\n */\nexport async function parseHighlightsAndWriteToNote(highlightSource: any): Promise<any> {\n try {\n const noteTitle: string = buildReadwiseNoteTitle(highlightSource)\n const outputNote: ?TNote = await getOrCreateReadwiseNote(noteTitle, highlightSource.category)\n const useFrontMatter = DataStore.settings.useFrontMatter === 'FrontMatter'\n if (outputNote) {\n if (!useFrontMatter) {\n //TODO: Support updating metadata (tags)\n if (!outputNote?.content?.includes('## Metadata')) {\n outputNote?.addParagraphBelowHeadingTitle(buildReadwiseMetadataHeading(highlightSource), 'text', 'Metadata', true, true)\n }\n } else {\n updateFrontMatterVars(outputNote, buildReadwiseFrontMatter(highlightSource))\n }\n if (!outputNote?.content?.includes('# Highlights')) {\n outputNote.insertHeading('Highlights', findEndOfActivePartOfNote(outputNote) + 1, 1)\n }\n }\n if (outputNote) {\n await writeReadwiseSyncLogLine(noteTitle, highlightSource.highlights.length)\n await highlightSource.highlights.map((highlight) => appendHighlightToNote(outputNote, highlight, highlightSource.source, highlightSource.asin))\n }\n } catch (error) {\n logError(pluginJson, error)\n }\n}\n\n/**\n * Appends the highlight with a link to the note\n * @param {TNote} outputNote - the note to append to\n * @param {*} highlight - the readwise highlight as a JSON object\n * @param {string} category - the source of the highlight\n * @param {string} asin - the asin of the book\n */\nfunction appendHighlightToNote(outputNote: TNote, highlight: any, category: string, asin: string): void {\n let linkToHighlightOnWeb = ''\n let userNote = ''\n\n if (highlight.tags !== null && highlight.tags !== '') {\n for (const tag of highlight.tags) {\n if (tag.name !== null && tag.name !== '' && tag.name.toLowerCase().startsWith('h') && tag.name.length === 2) {\n const headingLevel = parseInt(tag.name.substring(1)) + 1\n if (headingLevel <= 8) {\n outputNote.insertHeading(removeNewlines(highlight.text), findEndOfActivePartOfNote(outputNote) + 1, headingLevel)\n }\n }\n }\n }\n\n if (highlight.note !== null && highlight.note !== '') {\n userNote = `(${highlight.note})`\n }\n\n if (DataStore.settings.showLinkToHighlight === true) {\n if (category === 'supplemental') {\n linkToHighlightOnWeb = ` [View highlight](${highlight.readwise_url})`\n } else if (asin !== null && highlight.location !== null) {\n linkToHighlightOnWeb = ` [Location ${highlight.location}](https://read.amazon.com/?asin=${asin})`\n } else if (highlight.url !== null) {\n linkToHighlightOnWeb = ` [View highlight](${highlight.url})`\n }\n }\n const paragraphType = DataStore.settings.paragraphType ?? 'quote'\n outputNote.appendParagraph(removeNewlines(highlight.text) + userNote + linkToHighlightOnWeb, paragraphType)\n}\n" }, { "path": "aaronpoweruser.ReadwiseUnofficial/src/NPReadwiseSyncLog.js", "content": "// @flow\nimport { getLocalDate } from './NPReadwiseHelpers'\nimport { getOrMakeRegularNoteInFolder } from '@helpers/NPnote'\n\nconst SYNC_LOG_TOKEN = 'readWiseToken'\nconst SYNC_NOTE_TITLE = 'Readwise Syncs'\n\nexport async function startReadwiseSyncLog(): Promise<void> {\n if (DataStore.settings.writeSyncLog === true) {\n const outputNote = await getOrMakeRegularNoteInFolder(SYNC_NOTE_TITLE, DataStore.settings.baseFolder)\n await outputNote?.insertHeading(SYNC_LOG_TOKEN, 1, 2)\n }\n}\n\nexport async function writeReadwiseSyncLogLine(title: string, count: number): Promise<void> {\n if (DataStore.settings.writeSyncLog === true) {\n const outputNote = await getOrMakeRegularNoteInFolder(SYNC_NOTE_TITLE, DataStore.settings.baseFolder)\n await outputNote?.addParagraphBelowHeadingTitle(`${count} highlight${count !== 1 ? 's' : ''} from [[${title}]]`, 'list', SYNC_LOG_TOKEN, true, false)\n }\n}\n\nexport async function finishReadwiseSyncLog(downloadHighlightCount: number, updatedSourceCount: number): Promise<void> {\n if (DataStore.settings.writeSyncLog === true) {\n const outputNote = await getOrMakeRegularNoteInFolder(SYNC_NOTE_TITLE, DataStore.settings.baseFolder, '')\n const dateString =\n `[[${getLocalDate()}]] ${new Date().toLocaleTimeString([], { timeStyle: 'short' })} ` +\n `— synced ${downloadHighlightCount} highlight${downloadHighlightCount !== 1 ? 's' : ''} from ${updatedSourceCount} documents.`\n if (outputNote) {\n outputNote.content = outputNote.content?.replace(SYNC_LOG_TOKEN, dateString)\n }\n }\n}\n" }, { "path": "aaronpoweruser.ReadwiseUnofficial/src/NPTriggers-Hooks.js", "content": "/* eslint-disable require-await */\n// @flow\n\nimport pluginJson from '../plugin.json' // gives you access to the contents of plugin.json\nimport { log, logError, logDebug, timer, clo, JSP } from '@helpers/dev'\nimport { updateSettingData, pluginUpdated } from '@helpers/NPConfiguration'\n\n/**\n * NOTEPLAN PER-NOTE TRIGGERS\n *\n * The following functions are called by NotePlan automatically\n * if a note has a triggers: section in its frontmatter\n * See the documentation: https://help.noteplan.co/article/173-plugin-note-triggers\n */\n\n/**\n * onOpen\n * Plugin entrypoint for command: \"/onOpen\"\n * Called when a note is opened and that note\n * has a triggers: onOpen in its frontmatter\n * @param {TNote} note - current note in Editor\n */\nexport async function onOpen(note: TNote): Promise<void> {\n try {\n logDebug(pluginJson, `onOpen running for note:\"${String(note.filename)}\"`)\n // Try to guard against infinite loops of opens/refreshing\n // You can delete this code if you are sure that your onOpen trigger will not cause an infinite loop\n // But the safest thing to do is put your code inside the if loop below to ensure it runs no more than once every 15s\n const now = new Date()\n if (Editor?.note?.changedDate) {\n const lastEdit = new Date(Editor?.note?.changedDate)\n if (now - lastEdit > 15000) {\n logDebug(pluginJson, `onOpen ${timer(lastEdit)} since last edit`)\n // Put your code here or call a function that does the work\n } else {\n logDebug(pluginJson, `onOpen: Only ${timer(lastEdit)} since last edit (hasn't been 15s)`)\n }\n }\n } catch (error) {\n logError(pluginJson, `onOpen: ${JSP(error)}`)\n }\n}\n\n/**\n * onEditorWillSave\n * Plugin entrypoint for command: \"/onEditorWillSave\"\n */\nexport async function onEditorWillSave() {\n try {\n logDebug(pluginJson, `onEditorWillSave running with note in Editor:\"${String(Editor.filename)}\"`)\n // Put your code here or call a function that does the work\n // Note: as stated in the documentation, if you want to change any content in the Editor\n // before the file is written, you should NOT use the *note* variable here to change content\n // Instead, use Editor.* commands (e.g. Editor.insertTextAtCursor()) or Editor.updateParagraphs()\n } catch (error) {\n logError(pluginJson, `onEditorWillSave: ${JSP(error)}`)\n }\n}\n\n/*\n * NOTEPLAN GLOBAL PLUGIN HOOKS\n *\n * The rest of these functions are called by NotePlan automatically under certain conditions\n * It is unlikely you will need to edit/add anything below this line\n *\n */\n\n/**\n * NotePlan calls this function after the plugin is installed or updated.\n * The `updateSettingData` function looks through the new plugin settings in plugin.json and updates\n * the user preferences to include any new fields\n */\nexport async function onUpdateOrInstall(): Promise<void> {\n log(pluginJson, 'NPThemeChooser::onUpdateOrInstall running')\n await updateSettingData(pluginJson)\n}\n\n/**\n * NotePlan calls this function every time the plugin is run (any command in this plugin, including triggers)\n * You should not need to edit this function. All work should be done in the commands themselves\n */\nexport function init(): void {\n logDebug(pluginJson, `${pluginJson['plugin.id']} :: init running`)\n // clo(DataStore.settings, `${pluginJson['plugin.id']} Plugin Settings`)\n DataStore.installOrUpdatePluginsByID([pluginJson['plugin.id']], true, false, false).then((r) => pluginUpdated(pluginJson, r))\n}\n\n/**\n * NotePlan calls this function settings are updated in the Preferences panel\n * You should not need to edit this function\n */\nexport async function onSettingsUpdated(): Promise<void> {\n logDebug(pluginJson, `${pluginJson['plugin.id']} :: onSettingsUpdated running`)\n}\n" }, { "path": "aaronpoweruser.ReadwiseUnofficial/src/index.js", "content": "// @flow\n\nexport { readwiseSync, readwiseRebuild, readwiseDailyReview } from './NPReadwise'\n\n// FETCH mocking for offline testing\n// If you want to use external server calls in your plugin, it can be useful to mock the server responses\n// while you are developing the plugin. This allows you to test the plugin without having to\n// have a server running or having to have a network connection (or wait/pay for the server calls)\n// Comment the following import line out if you want to use live fetch/server endpoints (normal operation)\n// Uncomment it for using server mocks (fake/canned responses) you define in support/fetchOverrides.js\n// import './support/fetchOverrides'\n\n/**\n * Other imports/exports - you will normally not need to edit these\n */\n// eslint-disable-next-line import/order\nexport { onUpdateOrInstall, init, onSettingsUpdated } from './NPTriggers-Hooks'\nexport { onOpen, onEditorWillSave } from './NPTriggers-Hooks'\n" }, { "path": "babel.config.js", "content": "// babel.config.js\nmodule.exports = (api) => {\n const isTest = api.env('test')\n return {\n presets: [\n '@babel/preset-flow',\n '@babel/preset-react',\n [\n '@babel/preset-env',\n {\n targets: {\n node: 'current',\n },\n modules: isTest ? 'commonjs' : false, // Use CommonJS for Jest, ES modules for Rollup\n },\n ],\n ],\n }\n}\n" }, { "path": "buildDashboard.sh", "content": "#!/bin/sh\n# Build Dashboard, and then run it. Needs to run from local GH root directory.\nnode ./jgclark.Dashboard/src/react/support/performRollup.node.js\nnpc plugin:dev jgclark.Dashboard -nc\necho \"Running Dashboard...\"\nopen \"noteplan://x-callback-url/runPlugin?pluginID=jgclark.Dashboard&command=showDashboard\"\n" }, { "path": "buildShared.sh", "content": "#!/bin/sh\n# Build Dashboard, and then run it. Needs to run from local GH root directory.\nnode ./np.Shared/src/react/support/performRollup.node.js\nnpc plugin:dev np.Shared -nc\n" }, { "path": "codedungeon.Toolbox/CHANGELOG.md", "content": "# codedungeon.Toolbox Changelog\n\n## About codedungeon.Toolbox Plugin\n\nSee Plugin [README](https://github.com/NotePlan/plugins/blob/main/codedungeon.Toolbox/README.md) for details on available commands and use case.\n\n## [1.5.0] - 2022-07-29 (@mikeerickson)\n\n- Added Plugin Console Setting\n\n## [1.4.1] - 2022-07-07 (@mikeerickson)\n\n- No changes, forcing version update\n\n## [1.4.0] - 2022-07-07 (@mikeerickson)\n\n- Removed dead code\n- Fixed linting errors\n\n## [1.3.1] - 2022-05-24 (@mikeerickson)\n\n- Removed `convertToRtf` as it has been added to NotePlan\n\n## [1.3.0] - 2021-09-26 (@mikeerickson)\n\n- Modified `convertToHtml` to remove attributes by default\n- Modified `convertSelectionToHtml` to remove attributes by default\n\n## [1.2.1] - 2021-09-04 (@mikeerickson)\n\n### Added\n- Updated to use new NotePlan helper modules\n\n## [1.1.0] - 2021-08-29 (@mikeerickson)\n\n### Added\n**convertToRtf** - Converts current note to RTF and copies to clipboard\n**reorderList** - Reorders an `ordered list` (select list items which you wish to reorder)\n\n## [1.0.1..1.0.2] - 2021-08-28 (@mikeerickson)\n\n### Fixed\n- fixed link to project readme\n-\thttps://github.com/NotePlan/plugins/blob/main/codedungeon.Toolbox/README.md\n\n## [1.0.0] - 2021-08-26 (@mikeerickson)\n### **Initial Release**\n\n### Added\n\n**covertToHtml** - Convert current note to html and copies to clipboard\n**convertSelectionToHtml** - Convert current selection to html and copies to clipboard\n\n## Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## Plugin Versioning Uses Semver\n\nAll NotePlan plugins follow `semver` versioning. For details, please refer to [semver website](https://semver.org/)\n" }, { "path": "codedungeon.Toolbox/LICENSE", "content": "The MIT License (MIT)\n\nCopyright (c) 2021 Mike Erickson\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "codedungeon.Toolbox/README.md", "content": "# 🧩 Codedungeon Toolbox for Noteplan\n\n## Overview\n**Codedungeon Toolbox for NotePlan** is a plugin for NotePlan that provides a suite of utility methods, which can be used across all platforms (unless specifically noted in each command)\n\n<h1 align=\"center\">\n <img src=\"docs/images/toolbox-logo.png\" width=\"15%\" height=\"15%\" alt=\"codedungeon.Toolbox\">\n</h1>\n\n## Commands\nAll commands can be invoked using the _NotePlan Command Bar_ (`Command-J` then ` / `) which NotePlan has reserved for plugin activation. Or by selecting `🧩 Codedungeon Toolbox` from the **Plugins** menu)\n\n<h1 align=\"center\">\n <img src=\"docs/images/command-bar.png\" alt=\"codedungeon.Toolbox\">\n</h1>\n\nOnce the command bar is displayed, you can continue typing any of the following commands to invoke the appropriate plugin command. In some case where specifically noted, you can alternately invoke the plugin command at the current insertion pointer within your document.\n\n| Command | Available Inline | Description |\n| ----------------------- | ---------------- | ------------------------------------------------------------------------------------------------- |\n| convertToHtml | Yes [^1] | Converts the current note to HTML and places on clipboard |\n| convertSelectionToHtml | No | Converts the current selection to HTML and places on clipboard |\n| convertToRtf | Yes [^1] | Converts the current note to RTF and places on clipboard |\n| reorderList | No | Reorders selected unordered list items (starting at **1** and increase each line at same level) |\n\n[^1]: Can be triggered inline but contents will appear in converted HTML document\n\n## License\n\nCopyright © 2021-2022 Mike Erickson\nReleased under the MIT license\n\n## Credits\n\n**Codedugeon Toolbox for NotePlan** written by **Mike Erickson**\n\nE-Mail: [codedungeon@gmail.com](mailto:codedungeon@gmail.com)\n\nSupport: [https://github.com/NotePlan/plugins/issues](https://github.com/NotePlan/plugins/issues)\n\nTwitter: [@codedungeon](http://twitter.com/codedungeon)\n\nWebsite: [codedungeon.io](http://codedungeon.io)\n" }, { "path": "codedungeon.Toolbox/__tests__/convertSelectionToHtml.test.js", "content": "/* eslint-disable */\n\n/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport { DataStore, Editor, CommandBar, NotePlan } from '@mocks/index'\nimport CodedungeonToolbox from '../src/support/CodedungeonToolbox'\n\n// Make DataStore and Editor available globally for the source code\nglobal.DataStore = DataStore\nglobal.Editor = Editor\nglobal.CommandBar = CommandBar\nglobal.NotePlan = NotePlan\n\nlet toolbox\nbeforeEach(() => {\n toolbox = new CodedungeonToolbox()\n})\n\ntest('codedungeon.Toolbox convertToHtml - headings', () => {\n const markdown = `#Heading1\\n##Heading2\\n###Heading3\\n####Heading4\\n**TODO Items:**\\n* Item 1\\n*Item 2`\n\n const html = toolbox.markdownToHtml(markdown, { removeAttributes: false })\n\n expect(html).toContain('<h1 id=\"heading1\">Heading1</h1>')\n expect(html).toContain('<h2 id=\"heading2\">Heading2</h2>')\n expect(html).toContain('<h3 id=\"heading3\">Heading3</h3>')\n expect(html).toContain('<h4 id=\"heading4\">Heading4</h4>')\n\n expect(html).toContain('<h4 id=\"heading4\">Heading4</h4>')\n})\n\ntest('codedungeon.Toolbox convertToHtml - bold, italic', () => {\n const markdown = `**Bold Item**\n*Italic Item*\n~~Striketrough~~`\n\n const html = toolbox.markdownToHtml(markdown)\n\n expect(html).toContain('<strong>Bold Item</strong>')\n expect(html).toContain('<em>Italic Item</em>')\n})\n\ntest('codedungeon.Toolbox convertToHtml - tasks', () => {\n const markdown = `**TODO Items:**\n* Item 1\n* Item 2`\n\n const html = toolbox.markdownToHtml(markdown)\n\n expect(html).toContain('<strong>TODO Items:</strong>')\n expect(html).toContain('<li>Item 1</li>')\n expect(html).toContain('<li>Item 2</li>')\n})\n\ntest('codedungeon.Toolbox convertToHtml - unordered lists', () => {\n const toolbox = new CodedungeonToolbox()\n\n const markdown = `**Lists:**\n- Item 1\n- Item 2\n- Item 3`\n\n const html = toolbox.markdownToHtml(markdown)\n\n expect(html).toContain('<strong>Lists:</strong>')\n expect(html).toContain('<ul>')\n expect(html).toContain('<li>Item 1</li>')\n expect(html).toContain('<li>Item 2</li>')\n expect(html).toContain('</ul>')\n})\n" }, { "path": "codedungeon.Toolbox/__tests__/convertToHtml.test.js", "content": "/* eslint-disable */\n\n/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport { DataStore, Editor, CommandBar, NotePlan } from '@mocks/index'\nimport CodedungeonToolbox from '../src/support/CodedungeonToolbox'\n\n// Make DataStore and Editor available globally for the source code\nglobal.DataStore = DataStore\nglobal.Editor = Editor\nglobal.CommandBar = CommandBar\nglobal.NotePlan = NotePlan\n\nlet toolbox\nbeforeEach(() => {\n toolbox = new CodedungeonToolbox()\n})\n\ntest('codedungeon.Toolbox convertToHtml - headings dont remove attributes', () => {\n const markdown = `#Heading1\\n##Heading2\\n###Heading3\\n####Heading4\\n**TODO Items:**\\n* Item 1\\n*Item 2`\n\n const html = toolbox.markdownToHtml(markdown, { removeAttributes: false })\n\n expect(html).toContain('<h1 id=\"heading1\">Heading1</h1>')\n expect(html).toContain('<h2 id=\"heading2\">Heading2</h2>')\n expect(html).toContain('<h3 id=\"heading3\">Heading3</h3>')\n expect(html).toContain('<h4 id=\"heading4\">Heading4</h4>')\n\n expect(html).toContain('<h4 id=\"heading4\">Heading4</h4>')\n})\n\ntest('codedungeon.Toolbox convertToHtml - bold, italic', () => {\n const markdown = `**Bold Item**\n*Italic Item*\n~~Striketrough~~`\n\n const html = toolbox.markdownToHtml(markdown)\n\n expect(html).toContain('<strong>Bold Item</strong>')\n expect(html).toContain('<em>Italic Item</em>')\n})\n\ntest('codedungeon.Toolbox convertToHtml - tasks', () => {\n const markdown = `**TODO Items:**\n* Item 1\n* Item 2`\n\n const html = toolbox.markdownToHtml(markdown)\n\n expect(html).toContain('<strong>TODO Items:</strong>')\n expect(html).toContain('<li>Item 1</li>')\n expect(html).toContain('<li>Item 2</li>')\n})\n\ntest('codedungeon.Toolbox convertToHtml - unordered lists', () => {\n const markdown = `**Lists:**\n- Item 1\n- Item 2\n- Item 3`\n\n const html = toolbox.markdownToHtml(markdown)\n\n expect(html).toContain('<strong>Lists:</strong>')\n expect(html).toContain('<ul>')\n expect(html).toContain('<li>Item 1</li>')\n expect(html).toContain('<li>Item 2</li>')\n expect(html).toContain('</ul>')\n})\n\ntest('codedungeon.Toolbox convertToHtml - remove attributes', () => {\n const markdown = `# Heading 1\\n\\n## Heading 2\\n### Heading 3\\n#### Heading 4`\n\n const html = toolbox.markdownToHtml(markdown, { removeAttributes: true })\n\n expect(html).toEqual('<h1>Heading 1</h1>\\n<h2>Heading 2</h2>\\n<h3>Heading 3</h3>\\n<h4>Heading 4</h4>')\n})\n" }, { "path": "codedungeon.Toolbox/__tests__/reorderList.test.js", "content": "/* eslint-disable */\n\n/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport { DataStore, Editor, CommandBar, NotePlan } from '@mocks/index'\nimport CodedungeonToolbox from '../src/support/CodedungeonToolbox'\n\n// Make DataStore and Editor available globally for the source code\nglobal.DataStore = DataStore\nglobal.Editor = Editor\nglobal.CommandBar = CommandBar\nglobal.NotePlan = NotePlan\n\nlet toolbox\nbeforeEach(() => {\n toolbox = new CodedungeonToolbox()\n})\n\ntest('codedungeon.Toolbox reorderList', async () => {\n let list = ['1. item 1', '\\t1. subitem 1', '\\t2. subitem 1', '2. item 2', '3. item 3', '3. item 4', '4. item 5']\n\n let result = await toolbox.reorderList(list)\n\n expect(result[0]).toBe('1. item 1')\n expect(result[3]).toBe('2. item 2')\n expect(result[4]).toBe('3. item 3')\n expect(result[5]).toBe('4. item 4')\n expect(result[6]).toBe('5. item 5')\n})\n" }, { "path": "codedungeon.Toolbox/plugin.json", "content": "{\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.0.21\",\n \"plugin.id\": \"codedungeon.Toolbox\",\n \"plugin.name\": \"🧩 Codedungeon Toolbox\",\n \"plugin.description\": \"General Purpose Utility Commands\",\n \"plugin.author\": \"codedungeon\",\n \"plugin.version\": \"1.5.0\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.url\": \"https://github.com/NotePlan/plugins/blob/main/codedungeon.Toolbox/README.md\",\n \"plugin.commands\": [\n {\n \"name\": \"convertToHtml\",\n \"description\": \"Convert current note to HTML\",\n \"jsFunction\": \"convertToHtml\"\n },\n {\n \"name\": \"convertSelectionToHtml\",\n \"description\": \"Convert current selection to HTML\",\n \"jsFunction\": \"convertSelectionToHtml\"\n },\n {\n \"name\": \"reorderList\",\n \"description\": \"Reorder current ordered list\",\n \"jsFunction\": \"reorderList\"\n }\n ],\n \"plugin.settings\": [\n {\n \"type\": \"heading\",\n \"title\": \"codedungeon.Toolbox Settings\"\n },\n {\n \"key\": \"version\",\n \"type\": \"hidden\",\n \"title\": \"codedungeon.Toolbox Settings Version\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"INFO\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much loggin output will be displayed when executing codedungeon.Toolbox commands in NotePlan Plugin Console Logs (NotePlan -> Help -> Plugin Console)\\n\\n - DEBUG: Show All Logs\\n - INFO: Only Show Info, Warnings, and Errors\\n - WARN: Only Show Errors or Warnings\\n - ERROR: Only Show Errors\\n - none: Silence Logs\",\n \"default\": \"INFO\",\n \"required\": true\n }\n ]\n}\n" }, { "path": "codedungeon.Toolbox/src/convertSelectionToHtml.js", "content": "// @flow\n/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport { showMessage } from '../../helpers/userInput'\nimport CodedungeonToolbox from './support/CodedungeonToolbox'\n\nexport async function convertSelectionToHtml(): Promise<void> {\n const toolbox = new CodedungeonToolbox()\n\n const note = Editor.selectedLinesText.join('\\n') || ''\n\n const html = toolbox.markdownToHtml(note)\n\n Clipboard.string = html\n\n if (html.length > 0) {\n await showMessage('Content Copied To Clipboard')\n } else {\n await showMessage('An error occured converting content to HTML')\n }\n}\n" }, { "path": "codedungeon.Toolbox/src/convertToHtml.js", "content": "// @flow\n/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021-2022 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport { showMessage } from '../../helpers/userInput'\nimport CodedungeonToolbox from './support/CodedungeonToolbox'\n\nexport async function convertToHtml(): Promise<void> {\n const toolbox = new CodedungeonToolbox()\n\n const note = Editor.content || ''\n\n const html = toolbox.markdownToHtml(note)\n\n Clipboard.string = html\n\n if (html.length > 0) {\n await showMessage('Content Copied To Clipboard')\n } else {\n await showMessage('An error occured converting content to HTML')\n }\n}\n" }, { "path": "codedungeon.Toolbox/src/convertToRtf.js", "content": "// @flow\n/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021-2022 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport { showMessage } from '../../helpers/userInput'\nimport CodedungeonToolbox from './support/CodedungeonToolbox'\n\nexport async function convertToRtf(): Promise<void> {\n const toolbox = new CodedungeonToolbox()\n\n const note = Editor.content || ''\n\n const rtf = await toolbox.markdownToRtf(note)\n\n Clipboard.string = rtf\n\n if (rtf.length > 0) {\n await showMessage('Content Copied To Clipboard')\n } else {\n await showMessage('An error occured converting content to RTF')\n }\n}\n" }, { "path": "codedungeon.Toolbox/src/index.js", "content": "/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021-2022 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nexport { convertToHtml } from './convertToHtml'\nexport { convertSelectionToHtml } from './convertSelectionToHtml'\nexport { reorderList } from './reorderList'\n" }, { "path": "codedungeon.Toolbox/src/reorderList.js", "content": "// @flow\n/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport CodedungeonToolbox from './support/CodedungeonToolbox'\n\nexport async function reorderList(): Promise<void> {\n const toolbox = new CodedungeonToolbox()\n\n const listData = Editor.selectedLinesText\n\n const newList = await toolbox.reorderList(listData)\n\n Editor.replaceSelectionWithText(newList.join('\\n'))\n}\n" }, { "path": "codedungeon.Toolbox/src/support/CodedungeonToolbox.js", "content": "/*-------------------------------------------------------------------------------------------\n * Copyright (c) 2021 Mike Erickson / Codedungeon. All rights reserved.\n * Licensed under the MIT license. See LICENSE in the project root for license information.\n * -----------------------------------------------------------------------------------------*/\n\nimport showdown from 'showdown'\n\nconst removeAttributes = (str = '', attrs = []) => {\n if (str.length === 0) {\n return ''\n }\n\n const reg = /<\\s*(\\w+).*?>/gm\n const reg2 = /\\s*(\\w+)=\\\"[^\\\"]+\\\"/gm\n\n str = str.replace(reg, (match) => {\n const result = match.replace(reg2, (match_) => {\n const matchFound = reg2.exec(match_)\n if (matchFound) {\n return attrs.indexOf(matchFound[1]) >= 0 ? match_ : ''\n }\n return ''\n })\n return result\n })\n return str\n}\n\nexport default class CodedungeonToolbox {\n markdownToHtml(text = '', options = { removeAttributes: true }) {\n const showdownConverter = new showdown.Converter()\n\n let html = showdownConverter.makeHtml(text)\n if (options?.removeAttributes && options.removeAttributes) {\n html = removeAttributes(html, [])\n }\n return html\n }\n\n async markdownToRtf(markdownText = '') {\n if (!(typeof markdownText === 'string' && markdownText)) {\n return null\n }\n\n let html = await this.markdownToHtml(markdownText)\n html = html.replace(/\\n/g, '<br />')\n html = html\n .replace(/^\\s{8}|\\s+$/gm, '')\n .replace(/^\\s+/, '')\n .replace(/[ ]{4}/g, ' ')\n\n let richText = html\n\n // Singleton tags\n richText = richText.replace(/<(?:hr)(?:\\s+[^>]*)?\\s*[\\/]?>/gi, '{\\\\pard \\\\brdrb \\\\brdrs \\\\brdrw10 \\\\brsp20 \\\\par}\\n{\\\\pard\\\\par}\\n')\n richText = richText.replace(/<(?:br)(?:\\s+[^>]*)?\\s*[\\/]?>/gi, '{\\\\pard\\\\par}\\n')\n\n // Empty tags\n richText = richText.replace(/<(?:p|div|section|article)(?:\\s+[^>]*)?\\s*[\\/]>/gi, '{\\\\pard\\\\par}\\n')\n richText = richText.replace(/<(?:[^>]+)\\/>/g, '')\n\n // Hyperlinks\n richText = richText.replace(/<a(?:\\s+[^>]*)?(?:\\s+href=([\"'])(?:javascript:void\\(0?\\);?|#|return false;?|void\\(0?\\);?|)\\1)(?:\\s+[^>]*)?>/gi, '{{{\\n')\n const tmpRichText = richText\n richText = richText.replace(/<a(?:\\s+[^>]*)?(?:\\s+href=([\"'])(.+)\\1)(?:\\s+[^>]*)?>/gi, '{\\\\field{\\\\*\\\\fldinst{HYPERLINK\\n \"$2\"\\n}}{\\\\fldrslt{\\\\ul\\\\cf1\\n')\n const hasHyperlinks = richText !== tmpRichText\n richText = richText.replace(/<a(?:\\s+[^>]*)?>/gi, '{{{\\n')\n richText = richText.replace(/<\\/a(?:\\s+[^>]*)?>/gi, '\\n}}}')\n\n // Start tags\n richText = richText.replace(/<(?:b|strong)(?:\\s+[^>]*)?>/gi, '{\\\\b\\n')\n richText = richText.replace(/<(?:i|em)(?:\\s+[^>]*)?>/gi, '{\\\\i\\n')\n richText = richText.replace(/<(?:u|ins)(?:\\s+[^>]*)?>/gi, '{\\\\ul\\n')\n richText = richText.replace(/<(?:strike|del)(?:\\s+[^>]*)?>/gi, '{\\\\strike\\n')\n richText = richText.replace(/<sup(?:\\s+[^>]*)?>/gi, '{\\\\super\\n')\n richText = richText.replace(/<sub(?:\\s+[^>]*)?>/gi, '{\\\\sub\\n')\n richText = richText.replace(/<(?:p|div|section|article)(?:\\s+[^>]*)?>/gi, '{\\\\pard\\n')\n\n // End tags\n richText = richText.replace(/<\\/(?:p|div|section|article)(?:\\s+[^>]*)?>/gi, '\\n\\\\par}\\n')\n richText = richText.replace(/<\\/(?:b|strong|i|em|u|ins|strike|del|sup|sub)(?:\\s+[^>]*)?>/gi, '\\n}')\n\n // Strip any other remaining HTML tags [but leave their contents]\n richText = richText.replace(/<(?:[^>]+)>/g, '')\n\n // Prefix and suffix the rich text with the necessary syntax\n /* eslint-disable prefer-template*/\n richText = '{\\\\rtf1\\\\ansi\\n' + (hasHyperlinks ? '{\\\\colortbl\\n;\\n\\\\red0\\\\green0\\\\blue255;\\n}\\n' : '') + richText + '\\n}'\n\n return richText\n }\n\n reorderList(listData = '') {\n const workingData = [...listData]\n\n let lineItem = 0\n for (let index = 0; index < workingData.length; index++) {\n if (workingData[index].charCodeAt(0) !== 9) {\n const startsWithIndex = new RegExp('[0-9]+.')\n if (startsWithIndex.test(workingData[index])) {\n const starting = workingData[index].indexOf('.')\n if (starting >= 0) {\n lineItem++\n const numberIndex = workingData[index].substring(0, starting)\n workingData[index] = workingData[index].replace(numberIndex, `${lineItem}`)\n }\n }\n }\n }\n\n return workingData\n }\n}\n" }, { "path": "community-plugins.json", "content": "[\n {\n \"id\": \"np.stockTicker\",\n \"name\": \"Stock Ticker\",\n \"author\": \"EduardMe\",\n \"description\": \"Live stock portfolio tracker with real-time quotes and daily performance\",\n \"repo\": \"EduardMe/noteplan-stock-ticker-plugin\"\n },\n {\n \"id\": \"asktru.WeeklyReview\",\n \"name\": \"Weekly Review Dashboard\",\n \"author\": \"asktru\",\n \"description\": \"Dashboard for reviewing projects and areas on a schedule with status tracking and inline task management\",\n \"repo\": \"asktru/noteplan-weekly-review\"\n },\n {\n \"id\": \"asktru.TaskZoom\",\n \"name\": \"Task Zoom\",\n \"author\": \"asktru\",\n \"description\": \"Todoist-inspired task filtering dashboard with query language, saveable filters, and multiple grouping modes\",\n \"repo\": \"asktru/noteplan-task-zoom\"\n },\n {\n \"id\": \"asktru.Reflect\",\n \"name\": \"Reflect\",\n \"author\": \"asktru\",\n \"description\": \"Sunsama-like daily planning workflow with focus, planning, shutdown, and highlights tabs\",\n \"repo\": \"asktru/noteplan-reflect\"\n },\n {\n \"id\": \"asktru.NoteGraph\",\n \"name\": \"Note Graph\",\n \"author\": \"asktru\",\n \"description\": \"Interactive force-directed graph visualization of note connections via wiki links and backlinks\",\n \"repo\": \"asktru/noteplan-notegraph\"\n },\n {\n \"id\": \"asktru.Donote\",\n \"name\": \"Donote\",\n \"author\": \"asktru\",\n \"description\": \"Note viewer with three-panel layout, full markdown rendering, task management, and smart filters\",\n \"repo\": \"asktru/noteplan-donote\"\n },\n {\n \"id\": \"asktru.Clarity\",\n \"name\": \"Clarity\",\n \"author\": \"asktru\",\n \"description\": \"Things 3-inspired task clarity layer. Smart views for Inbox, Today, Upcoming, Anytime, Someday with inline task editing.\",\n \"repo\": \"asktru/noteplan-clarity\"\n },\n {\n \"id\": \"MarcoBarna.CRMDashboard\",\n \"name\": \"CRM Dashboard\",\n \"author\": \"MarcoBarna\",\n \"description\": \"Lightweight CRM for managing contacts, logging interactions, and scheduling follow-up reminders\",\n \"repo\": \"MarcoBarna/noteplan-crm-dashboard\"\n }\n]\n" }, { "path": "dbludeau.TodoistNoteplanSync/CHANGELOG.md", "content": "# Todoist Noteplan Sync Changelog\n\n## About this Plugin\n\nSee Plugin [README](https://github.com/NotePlan/plugins/blob/main/dbludeau.TodoistNoteplanSync/README.md) for details on available commands and use cases.\n\n## [0.4.1] - 2026-01-22 (dbludeau)\n- Fix for issue pulling todays tasks from Todoist.\n\n## [0.4.0] - 2025-09-15 (dbludeau)\n- Updated plugin to use new Todoist V1 API.\n\n## [0.3.0] - 2024-09-01 (dbludeau)\n- Fixed issue caused by \"Folder\" setting for Sync Everything command.\n - If leading or trailing slash was included, the plugin would not recognize the folder as already existing, leading to duplication of notes.\n\n## [0.2.0] - 2024-08-30 (dbludeau)\n- Added settings to account for Todoist Teams accounts\n- Fixed duplication issue that was caused by URL changes in the todoist tasks.\n\n## [0.1.0] - 2023-08-18 (dbludeau)\n- Initial version with \"/todoist sync today\", \"/todoist sync everything\", \"/todoist sync project\", \"/todoist sync all projects\" and \"/todoist sync all projects and today\" commands\n" }, { "path": "dbludeau.TodoistNoteplanSync/README.md", "content": "# Todoist Noteplan Sync Plugin\n\n## Latest Updates\n\nSee [CHANGELOG](https://github.com/NotePlan/plugins/blob/main/dbludeau.TodoistNoteplanSync/CHANGELOG.md) for latest updates/changes to this plugin.\n\n## About\nCommands to sync tasks in Todoist to Noteplan. Todoist has great quick entry capabilities for all platforms and now you can leverage that to quickly get your thoughts to Noteplan. You do not need to be on an Apple product or have Noteplan open to quickly add a task anymore. Todoist has an excellent API that allows for easy integration. This will work with both the free and paid version of Todoist (I have not paid and was able to do everything in this plugin). \n\n### Current Sync Actions\nNOTE: All sync actions (other then content and status) can be turned on and off in settings. Everything not in this list such as task descriptions, location reminders and times will be ignored (dates can be synced, but times will be ignored).\n- From Todoist to Noteplan\n - Task content\n - Due date\n - Priority\n - Status (open/closed)\n - Tags\n- From Noteplan to Todoist\n - Status (open/closed)\n\n\n## Available Commands\n- **/todoist sync everything** (alias **/tosa**): sync everything in Todoist to a folder in Noteplan. Every list in todoist will become a note in Noteplan. Use this if you want to use Todoist just as a conduit to get tasks into Noteplan. The folder used in Noteplan can be configured in settings.\n- **/todoist sync today** (alias **/tost**): sync tasks due today from Todoist to your daily note in Noteplan. A header can be configured in settings.\n- **/todoist sync project** (alias **/tosp**): link a single list from Todoist to a note in Note plan using frontmatter. This command will sync the current project you have open.\n- **/todoist sync all projects** (alias **/tosa**): this will sync all projects that have been linked using frontmatter.\n- **/todoist sync all projects and today** (alias **/tosat** **/toast**): this will sync all projects and the today note. Running it as one comand instead of individually will check for duplicates. This command will sync all tasks from projects to their linked note, including tasks due today. It will sync all tasks from all projects in Todoist that are due today except for those already in the project notes to avoid duplication.\n\n## Configuration\n- This plug in requires an API token from Todoist. These are available on both the free and paid plans. To get the token follow the instructions [here](https://todoist.com/help/articles/find-your-api-token)\n- You can configure a folder to use for syncing everything, headings that tasks will fall under and what details are synced.\n- Sections in Todoist will become headers in Noteplan. See [here](https://todoist.com/help/articles/introduction-to-sections) to learn about sections in Todoist. \n- Currently the API token is required, everything else is optional.\n- To link a Todoist list to a Noteplan note, you need the list ID from Todoist. To get the ID, open www.todoist.com in a web browser and sign in so you can see your lists. Open the list you want to link to a Noteplan note. The list ID is at the end of the URL. For example, if the end of the Todoist.com URL is /app/project/2317353827, then you want the list ID of 2317353827. You would add frontmatter to the top of your note that would look like (see https://help.noteplan.co/article/136-templates for more information on frontmatter):\n```\n---\ntodoist_id: 2317353827\n---\n```\n\n## Caveats, Warnings and Notes\n- All synced tasks in Noteplan rely on the Todoist ID being present and associated with the task. This is stored at the end of a synced task in the form of a link to www.todoist.com.\n - These links can be used to view the Todoist task on the web.\n - WARNING: if the link is modified or deleted, the ability to sync will be lost.\n- There is no automated clean up of completed tasks in Noteplan. They are just marked as completed. We can see what people think is best and enhance clean up in the future.\n- Subtasks in Todoist will show up as first level tasks in Noteplan. This can probably be fixed in an update if there is enough interest.\n- As of version 0.3.0 this plugin should work if you are on a Todoist Teams plan. NOTE: this has not been extensively tested.\n\n\n## Coming Next\n- Possible detailed sync back to Todoist. Currently will only sync closed (or cancelled) status. If demand is there, can sync back changes in priorities, due dates, tags. Will need to have a setting to decide which application is the source of truth.\n" }, { "path": "dbludeau.TodoistNoteplanSync/__tests__/NPPluginMain.NOTACTIVE.js", "content": "/*\n * THIS FILE SHOULD BE RENAMED WITH \".test.js\" AT THE END SO JEST WILL FIND AND RUN IT\n * It is included here as an example/starting point for your own tests\n */\n\n/* global jest, describe, test, expect, beforeAll, afterAll, beforeEach, afterEach */\n// Jest testing docs: https://jestjs.io/docs/using-matchers\n/* eslint-disable */\n\n// import * as f from '../src/sortTasks'\n// import { CustomConsole, LogType, LogMessage } from '@jest/console' // see note below\n// import { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, simpleFormatter /* Note, mockWasCalledWithString, Paragraph */ } from '@mocks/index'\n\n// const PLUGIN_NAME = `{{pluginID}}`\n// const FILENAME = `NPPluginMain`\n\n// beforeAll(() => {\n// global.Calendar = Calendar\n// global.Clipboard = Clipboard\n// global.CommandBar = CommandBar\n// global.DataStore = DataStore\n// global.Editor = Editor\n// global.NotePlan = NotePlan\n// global.console = new CustomConsole(process.stdout, process.stderr, simpleFormatter) // minimize log footprint\n// DataStore.settings['_logLevel'] = 'DEBUG' //change this to DEBUG to get more logging (or 'none' for none)\n// })\n\n/* Samples:\nexpect(result).toMatch(/someString/)\nexpect(result).not.toMatch(/someString/)\nexpect(result).toEqual([])\nimport { mockWasCalledWith } from '@mocks/mockHelpers'\n const spy = jest.spyOn(console, 'log')\n const result = mainFile.getConfig()\n expect(mockWasCalledWith(spy, /config was empty/)).toBe(true)\n spy.mockRestore()\n\n test('should return the command object', () => {\n const result = f.getPluginCommands({ 'plugin.commands': [{ a: 'foo' }] })\n expect(result).toEqual([{ a: 'foo' }])\n })\n*/\n\ndescribe('Placeholder', () => {\n test('Placeholder', async () => {\n expect(true).toBe(true)\n })\n})\n\n// describe.skip('dbludeau.TodoistNoteplanSync' /* pluginID */, () => {\n// describe('NPPluginMain' /* file */, () => {\n// describe('sayHello' /* function */, () => {\n// test('should insert text if called with a string param', async () => {\n// // tests start with \"should\" to describe the expected behavior\n// const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n// const result = await mainFile.sayHello('Testing...')\n// expect(spy).toHaveBeenCalled()\n// expect(spy).toHaveBeenNthCalledWith(\n// 1,\n// `***You clicked the link!*** The message at the end of the link is \"Testing...\". Now the rest of the plugin will run just as before...\\n\\n`,\n// )\n// spy.mockRestore()\n// })\n// test('should write result to console', async () => {\n// // tests start with \"should\" to describe the expected behavior\n// const spy = jest.spyOn(console, 'log')\n// const result = await mainFile.sayHello()\n// expect(spy).toHaveBeenCalled()\n// expect(spy).toHaveBeenNthCalledWith(1, expect.stringMatching(/The plugin says: HELLO WORLD FROM TEST PLUGIN!/))\n// spy.mockRestore()\n// })\n// test('should call DataStore.settings', async () => {\n// // tests start with \"should\" to describe the expected behavior\n// const oldValue = DataStore.settings\n// DataStore.settings = { settingsString: 'settingTest' }\n// const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n// const _ = await mainFile.sayHello()\n// expect(spy).toHaveBeenCalled()\n// expect(spy).toHaveBeenNthCalledWith(1, expect.stringMatching(/settingTest/))\n// DataStore.settings = oldValue\n// spy.mockRestore()\n// })\n// test('should call DataStore.settings if no value set', async () => {\n// // tests start with \"should\" to describe the expected behavior\n// const oldValue = DataStore.settings\n// DataStore.settings = { settingsString: undefined }\n// const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n// const _ = await mainFile.sayHello()\n// expect(spy).toHaveBeenCalled()\n// expect(spy).toHaveBeenNthCalledWith(1, expect.stringMatching(/\\*\\*\\\"\\\"\\*\\*/))\n// DataStore.settings = oldValue\n// spy.mockRestore()\n// })\n// test('should CLO write note.paragraphs to console', async () => {\n// // tests start with \"should\" to describe the expected behavior\n// const prevEditorNoteValue = copyObject(Editor.note || {})\n// Editor.note = new Note({ filename: 'testingFile' })\n// Editor.note.paragraphs = [new Paragraph({ content: 'testingParagraph' })]\n// const spy = jest.spyOn(console, 'log')\n// const result = await mainFile.sayHello()\n// expect(spy).toHaveBeenCalled()\n// expect(spy).toHaveBeenNthCalledWith(2, expect.stringMatching(/\\\"content\\\": \\\"testingParagraph\\\"/))\n// Editor.note = prevEditorNoteValue\n// spy.mockRestore()\n// })\n// test('should insert a link if not called with a string param', async () => {\n// // tests start with \"should\" to describe the expected behavior\n// const spy = jest.spyOn(Editor, 'insertTextAtCursor')\n// const result = await mainFile.sayHello('')\n// expect(spy).toHaveBeenCalled()\n// expect(spy).toHaveBeenLastCalledWith(expect.stringMatching(/noteplan:\\/\\/x-callback-url\\/runPlugin/))\n// spy.mockRestore()\n// })\n// test('should write an error to console on throw', async () => {\n// // tests start with \"should\" to describe the expected behavior\n// const spy = jest.spyOn(console, 'log')\n// const oldValue = Editor.insertTextAtCursor\n// delete Editor.insertTextAtCursor\n// try {\n// const result = await mainFile.sayHello()\n// } catch (e) {\n// expect(e.message).stringMatching(/ERROR/)\n// }\n// expect(spy).toHaveBeenCalledWith(expect.stringMatching(/ERROR/))\n// Editor.insertTextAtCursor = oldValue\n// spy.mockRestore()\n// })\n// })\n// })\n// })\n" }, { "path": "dbludeau.TodoistNoteplanSync/plugin.json", "content": "{\n \"COMMENT\": \"Details on these fields: https://help.noteplan.co/article/67-create-command-bar-plugins\",\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.4.0\",\n \"plugin.id\": \"dbludeau.TodoistNoteplanSync\",\n \"plugin.name\": \"🧩 Todoist Noteplan Sync\",\n \"plugin.version\": \"0.4.1\",\n \"plugin.lastUpdateInfo\": \"Fix to issue with pulling todays tasks from Todoist\",\n \"plugin.description\": \"Import and sync tasks between Todoist and Noteplan\",\n \"plugin.author\": \"dbludeau\",\n \"plugin.requiredFiles-EDIT_ME\": [\n \"html-plugin-comms.js\"\n ],\n \"plugin.requiredFiles-NOTE\": \"If you want to use HTML windows, remove the '-EDIT_ME' ABOVE\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.url\": \"https://github.com/NotePlan/plugins/blob/main/dbludeau.TodoistNoteplanSync/README.md\",\n \"plugin.changelog\": \"https://github.com/NotePlan/plugins/blob/main/dbludeau.TodoistNoteplanSync/CHANGELOG.md\",\n \"plugin.commands\": [\n {\n \"note\": \"================== COMMMANDS ========================\"\n },\n {\n \"name\": \"todoist sync everything\",\n \"alias\": [\n \"tose\"\n ],\n \"description\": \"Sync all tasks in Todoist to a Noteplan folder set in settings\",\n \"jsFunction\": \"syncEverything\",\n \"arguments\": [\n \"\"\n ]\n },\n {\n \"name\": \"todoist sync today\",\n \"alias\": [\n \"tost\"\n ],\n \"description\": \"Sync Todoist tasks due today to the Noteplan daily note\",\n \"jsFunction\": \"syncToday\",\n \"arguments\": [\n \"\"\n ]\n },\n {\n \"name\": \"todoist sync project\",\n \"alias\": [\n \"tosp\"\n ],\n \"description\": \"Sync Todoist project (list) linked to the current Noteplan note using frontmatter\",\n \"jsFunction\": \"syncProject\",\n \"arguments\": [\n \"\"\n ]\n },\n {\n \"name\": \"todoist sync all linked projects\",\n \"alias\": [\n \"tosa\"\n ],\n \"description\": \"Sync all Todoist projects (lists) to linked Noteplan notes using frontmatter\",\n \"jsFunction\": \"syncAllProjects\",\n \"arguments\": [\n \"\"\n ]\n },\n {\n \"name\": \"todoist sync all linked projects and today\",\n \"alias\": [\n \"tosat, toast\"\n ],\n \"description\": \"Sync all linked projects as well as populate Todoist tasks due today to the today note. This command avoids duplicating tasks in the daily note\",\n \"jsFunction\": \"syncAllProjectsAndToday\",\n \"arguments\": [\n \"\"\n ]\n },\n {\n \"NOTE\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"Todoist Noteplan Sync: Version\",\n \"description\": \"Update + Check Version\",\n \"jsFunction\": \"versionCheck\"\n },\n {\n \"description\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"onOpen\",\n \"jsFunction\": \"onOpen\",\n \"hidden\": true\n },\n {\n \"description\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"onEditorWillSave\",\n \"jsFunction\": \"onEditorWillSave\",\n \"hidden\": true\n },\n {\n \"NOTE\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"onMessageFromHTMLView\",\n \"description\": \"dbludeau.TodoistNoteplanSync: Callback function to receive messages from HTML view\",\n \"jsFunction\": \"onMessageFromHTMLView\",\n \"hidden\": true\n },\n {\n \"NOTE\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"Todoist Noteplan Sync: Update Plugin Settings\",\n \"description\": \"Preferences\",\n \"jsFunction\": \"editSettings\"\n }\n ],\n \"plugin.settings\": [\n {\n \"note\": \"================== SETTINGS ========================\"\n },\n {\n \"COMMENT\": \"Plugin settings documentation: https://help.noteplan.co/article/123-plugin-configuration\",\n \"type\": \"heading\",\n \"title\": \"Todoist Noteplan Sync Settings\"\n },\n {\n \"type\": \"hidden\",\n \"key\": \"pluginID\",\n \"default\": \"dbludeau.TodoistNoteplanSync\",\n \"COMMENT\": \"This is for use by the editSettings helper function. PluginID must match the plugin.id in the top of this file\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Syncing Options\"\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"string\",\n \"key\": \"apiToken\",\n \"title\": \"Todoist API token\",\n \"description\": \"API token for your Todoist account. See https://todoist.com/help/articles/find-your-api-token for more information.\",\n \"required\": false\n },\n {\n \"type\": \"string\",\n \"key\": \"headerToUse\",\n \"title\": \"Header to use for tasks without Todoist section\",\n \"description\": \"Todoist tasks that are note part of a section will be written under this heading. If you leave it blank, they will be prepended to the top of the note.\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Sync Everything Options\"\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"string\",\n \"key\": \"folderToUse\",\n \"title\": \"Folder to use for syncing everything\",\n \"description\": \"OPTIONAL. Folder where Todoist projects will sync to notes of same name when you run [/todoist sync everything]. If omitted, plugin will look for a folder named Todoist and create it if it does not exist\",\n \"required\": false\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Task Details\"\n },\n {\n \"type\": \"bool\",\n \"key\": \"syncDue\",\n \"title\": \"Sync due dates\",\n \"default\": true\n },\n {\n \"type\": \"bool\",\n \"key\": \"syncPriorities\",\n \"title\": \"Sync priorities\",\n \"default\": true\n },\n {\n \"type\": \"bool\",\n \"key\": \"syncTags\",\n \"title\": \"Sync Tags\",\n \"default\": false\n },\n {\n \"type\": \"separator\"\n },\n {\n \"note\": \"================== TODOIST TEAMS SETTINGS ========================\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Todoist Teams Settings\"\n },\n {\n \"type\": \"bool\",\n \"key\": \"teamAccount\",\n \"title\": \"Are you part of a Todoist Team account?\",\n \"description\": \"FOR USERS OF TODOIST TEAMS PLANS ONLY. Check this box if you use Todoist Teams accounts and tasks are assigned to you. Leave unchecked if you only use a personal Todoist account.\",\n \"default\": false\n },\n {\n \"type\": \"bool\",\n \"key\": \"syncUnassigned\",\n \"title\": \"Sync unassigned tasks\",\n \"description\": \"By default the sync will pull only tasks assigned to you. If you want to sync all unassigned tasks as well, check this box.\",\n \"default\": false\n },\n {\n \"note\": \"================== DEBUGGING SETTINGS ========================\"\n },\n {\n \"NOTE\": \"DO NOT CHANGE THE FOLLOWING SETTINGS; ADD YOUR SETTINGS ABOVE ^^^\",\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"INFO\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much logging output will be displayed when executing Todoist Noteplan Sync commands in NotePlan Plugin Console Logs (NotePlan -> Help -> Plugin Console)\\n\\n - DEBUG: Show All Logs\\n - INFO: Only Show Info, Warnings, and Errors\\n - WARN: Only Show Errors or Warnings\\n - ERROR: Only Show Errors\\n - none: Don't show any logs\",\n \"default\": \"INFO\",\n \"required\": true\n }\n ]\n}" }, { "path": "dbludeau.TodoistNoteplanSync/requiredFiles/html-plugin-comms.js", "content": "/**\n * html-PluginComms.js - HTML Window: process data to/from the plugin\n * This file is loaded by the browser via <script> tag in the HTML file\n * IMPORTANT NOTE: you can use flow and eslint to give you feedback but DO NOT put any type annotations in the actual code\n * the file will fail silently and you will be scratching your head for why it doesn't work\n *\n * USAGE:\n * 1) Make sure your plugin.json has the following field:\n * \"plugin-requiredFiles\": [\"html-plugin-comms.js\"],\n * 2) Import this file (and the shared bridge functions) into your HTML window when you generate it:\n <script type=\"text/javascript\" src=\"../np.Shared/pluginToHTMLErrorBridge.js\"></script>\n <script>const receivingPluginID = \"dbludeau.TodoistNoteplanSync\"</script>\n <script type=\"text/javascript\" src=\"./html-plugin-comms.js\"></script>\n <script type=\"text/javascript\" src=\"../np.Shared/pluginToHTMLCommsBridge.js\"></script>\n * 3) onMessageFromPlugin() below will receive your data from the plugin and route it to the appropriate function\n * 4) Call sendMessageToPlugin(type:string, data:any) from your HTML window to send data back to the plugin asynchronously\n */\n\n/* eslint-disable no-undef */\n/* eslint-disable no-unused-vars */\n\n/**\n * onMessageFromPlugin is a router where you route the data returned from the plugin\n * the plugin will send a 'type' and 'data' object\n * this function is just a switch/router. Based on the type, call a function to process the data.\n * do not do any processing here, just call the function to do the processing\n * @param {string} type\n * @param {any} data\n */\nfunction onMessageFromPlugin(type, data) {\n switch (type) {\n case 'updateDiv':\n onUpdateDivReceived(data)\n break\n default:\n console.log(`onMessageFromPlugin: unknown type: ${type}`)\n showError(`onMessageFromPlugin: received unknown type: ${type}`)\n // ...call other functions to process the data for other types of messages from the plugin\n }\n}\n\n/****************************************************************************************************************************\n * DATA PROCESSING FUNCTIONS FOR RETURNED DATA FROM THE PLUGIN\n ****************************************************************************************************************************/\n// these are the functions called in the onMessageFromPlugin function above\n\n/**\n * Plugin wants to replace a div with some HTML (or plain text if innerText is true)\n * @param { { divID: string, html: string, innerText:boolean } } data\n */\nfunction onUpdateDivReceived(data) {\n const { divID, html, innerText } = data\n console.log(`onUpdateDivReceived: divID: ${divID}, html: ${html}`)\n replaceHTML(divID, html, innerText)\n}\n\n/****************************************************************************************************************************\n * EVENT HANDLERS FOR THE HTML VIEW\n ****************************************************************************************************************************/\n// These event handlers are called by the HTML view when the user clicks on something\n// It's a good idea to have a separate function for each event handler so that you can easily see what's going on\n// And have the receiving function on the plugin side named the same thing as the event handler\n// So it's easy to match them all up\n// You could call sendMessageToPlugin directly from the HTML onClick event handler, but I prefer to have a separate function\n// so you can do error checking, logging, etc.\n\n/**\n * Event handler for the 'click' event on the status icon\n * @param {string} filename\n * @param {number} lineIndex\n * @param {string} statusWas\n */\nfunction onClickStatus(filename, lineIndex, statusWas, lineID) {\n if (!filename || typeof lineIndex !== 'number' || !statusWas || !lineID) {\n const msg = `onClickStatus: invalid data: filename: ${filename}, lineIndex: ${lineIndex}, statusWas: ${statusWas}, lineID: ${lineID}`\n console.log(msg)\n showError(msg) // you should have a div with id='error' in your HTML\n } else {\n console.log(`onClickStatus received click on: filename: ${filename}, lineIndex: ${lineIndex}, status: ${status}; sending 'onClickStatus' to plugin`)\n const data = { filename, lineIndex: lineIndex, statusWas, lineID }\n sendMessageToPlugin('onClickStatus', data) // actionName, data\n }\n}\n\n/****************************************************************************************************************************\n * HELPER FUNCTIONS\n ****************************************************************************************************************************/\n\nfunction replaceHTML(divID, html, innerText) {\n console.log(`replaceHTML: divID: ${divID}, html: ${html}`)\n const div = document.getElementById(divID)\n if (div) {\n if (innerText) {\n div.innerText = html\n } else {\n div.innerHTML = html\n }\n }\n}\n\nfunction showError(message) {\n const div = document.getElementById('error')\n if (div) {\n div.innerText = message\n }\n}\n" }, { "path": "dbludeau.TodoistNoteplanSync/src/NPPluginMain.js", "content": "// @flow\n// Plugin code goes in files like this. Can be one per command, or several in a file.\n// `export async function [name of jsFunction called by Noteplan]`\n// then include that function name as an export in the index.js file also\n// About Flow: https://flow.org/en/docs/usage/#toc-write-flow-code\n// Getting started with Flow in NotePlan: https://github.com/NotePlan/plugins/blob/main/Flow_Guide.md\n\n// NOTE: This file is named NPPluginMain.js (you could change that name and change the reference to it in index.js)\n// As a matter of convention, we use NP at the beginning of files which contain calls to NotePlan APIs (Editor, DataStore, etc.)\n// Because you cannot easily write tests for code that calls NotePlan APIs, we try to keep the code in the NP files as lean as possible\n// and put the majority of the work in the /support folder files which have Jest tests for each function\n// support/helpers is an example of a testable file that is used by the plugin command\n// REMINDER, to build this plugin as you work on it:\n// From the command line:\n// `noteplan-cli plugin:dev dbludeau.TodoistNoteplanSync --test --watch --coverage`\n// IMPORTANT: It's a good idea for you to open the settings ASAP in NotePlan Preferences > Plugins and set your plugin's logging level to DEBUG\n\n/**\n * LOGGING\n * A user will be able to set their logging level in the plugin's settings (if you used the plugin:create command)\n * As a general rule, you should use logDebug (see below) for messages while you're developing. As developer,\n * you will set your log level in your plugin preferences to DEBUG and you will see these messages but\n * an ordinary user will not. When you want to output a message,you can use the following.\n * logging level commands for different levels of messages:\n *\n * logDebug(pluginJson,\"Only developers or people helping debug will see these messages\")\n * log(pluginJson,\"Ordinary users will see these informational messages\")\n * logWarn(pluginJson,\"All users will see these warning/non-fatal messages\")\n * logError(pluginJson,\"All users will see these fatal/error messages\")\n */\n\nimport { getFrontmatterAttributes } from '../../helpers/NPFrontMatter'\nimport { getTodaysDateAsArrowDate, getTodaysDateUnhyphenated } from '../../helpers/dateTime'\nimport pluginJson from '../plugin.json'\nimport { log, logInfo, logDebug, logError, logWarn, clo, JSP } from '@helpers/dev'\n\nconst todo_api: string = 'https://api.todoist.com/api/v1'\n\n// set some defaults that can be changed in settings\nconst setup: {\n token: string,\n folder: string,\n addDates: boolean,\n addPriorities: boolean,\n addTags: boolean,\n teamAccount: boolean,\n addUnassigned: boolean,\n header: string,\n newFolder: any,\n newToken: any,\n useTeamAccount: any,\n syncDates: any,\n syncPriorities: any,\n syncTags: any,\n syncUnassigned: any,\n newHeader: any,\n} = {\n token: '',\n folder: 'Todoist',\n addDates: false,\n addPriorities: false,\n addTags: false,\n teamAccount: false,\n addUnassigned: false,\n header: '',\n\n /**\n * @param {string} passedToken\n */\n set newToken(passedToken: string) {\n setup.token = passedToken\n },\n /**\n * @param {string} passedFolder\n */\n set newFolder(passedFolder: string) {\n // remove leading and tailing slashes\n passedFolder = passedFolder.replace(/\\/+$/, '')\n passedFolder = passedFolder.replace(/^\\/+/, '')\n this.folder = passedFolder\n },\n /**\n * @param {boolean} passedSyncDates\n */\n set syncDates(passedSyncDates: boolean) {\n setup.addDates = passedSyncDates\n },\n /**\n * @param {boolean} passedSyncPriorities\n */\n set syncPriorities(passedSyncPriorities: true) {\n setup.addPriorities = passedSyncPriorities\n },\n /**\n * @param {boolean} passedSyncTags\n */\n set syncTags(passedSyncTags: boolean) {\n setup.addTags = passedSyncTags\n },\n /**\n * @param {boolean} passedTeamAccount\n */\n set teamAccount(passedTeamAccount: boolean) {\n this.useTeamAccount = passedTeamAccount\n },\n /**\n * @param {boolean} passedSyncUnassigned\n */\n set syncUnassigned(passedSyncUnassigned: boolean) {\n this.addUnassigned = passedSyncUnassigned\n },\n /**\n * @param {string} passedHeader\n */\n set newHeader(passedHeader: string) {\n setup.header = passedHeader\n },\n}\n\nconst closed: Array<any> = []\nconst just_written: Array<any> = []\nconst existing: Array<any> = []\nconst existingHeader: {\n exists: boolean,\n headerExists: string | boolean,\n} = {\n exists: false,\n /**\n * @param {boolean} passedHeaderExists\n */\n set headerExists(passedHeaderExists: string) {\n existingHeader.exists = !!passedHeaderExists\n },\n}\n\n/**\n * Synchronizes everything.\n *\n * @returns {Promise<void>} A promise that resolves once synchronization is complete.\n */\n// eslint-disable-next-line require-await\nexport async function syncEverything() {\n setSettings()\n\n logDebug(pluginJson, `Folder for everything notes: ${setup.folder}`)\n const folders: Array<any> = DataStore.folders.filter((f) => f.startsWith(setup.folder)) ?? []\n\n // if we can't find a matching folder, create it\n if (folders.length === 0) {\n try {\n DataStore.createFolder(setup.folder)\n logDebug(pluginJson, `New folder has been created (${setup.folder})`)\n } catch (error) {\n logError(pluginJson, `Unable to create new folder (${setup.folder}) in Noteplan (${JSON.stringify(error)})`)\n process.exit(1)\n }\n }\n\n // get the todoist projects and write out the new ones\n // needs to be broken into smaller functions, but could not get it to return correctly\n const projects: Array<Object> = await getTodoistProjects()\n\n if (projects.length > 0) {\n for (let i = 0; i < projects.length; i++) {\n // see if there is an existing note or create it if not\n const note_info: ?Object = getExistingNote(projects[i].project_name)\n if (note_info) {\n //console.log(note_info.title)\n const note: ?TNote = DataStore.projectNoteByFilename(note_info.filename)\n //console.log(note?.filename)\n if (note) {\n // get the completed tasks in Noteplan and close them in Todoist\n reviewExistingNoteplanTasks(note)\n\n // grab the tasks and write them out with sections\n const id: string = projects[i].project_id\n await projectSync(note, id)\n }\n }\n\n //close the tasks in Todoist if they are complete in Noteplan`\n closed.forEach(async (t) => {\n await closeTodoistTask(t)\n })\n }\n }\n // completed correctly (in theory)\n logDebug(pluginJson, 'Plugin completed without errors')\n}\n\n/**\n * Synchronize the current linked project.\n *\n * @returns {Promise<void>} A promise that resolves once synchronization is complete\n */\n// eslint-disable-next-line require-await\nexport async function syncProject() {\n setSettings()\n const note: ?TNote = Editor.note\n if (note) {\n // check to see if this has any frontmatter\n const frontmatter: ?Object = getFrontmatterAttributes(note)\n clo(frontmatter)\n let check: boolean = true\n if (frontmatter) {\n if ('todoist_id' in frontmatter) {\n logDebug(pluginJson, `Frontmatter has link to Todoist project -> ${frontmatter.todoist_id}`)\n\n const paragraphs: ?$ReadOnlyArray<TParagraph> = note.paragraphs\n if (paragraphs) {\n paragraphs.forEach((paragraph) => {\n checkParagraph(paragraph)\n })\n }\n\n await projectSync(note, frontmatter.todoist_id)\n\n //close the tasks in Todoist if they are complete in Noteplan`\n closed.forEach(async (t) => {\n await closeTodoistTask(t)\n })\n } else {\n check = false\n }\n } else {\n check = false\n }\n if (!check) {\n logWarn(pluginJson, 'Current note has no Todoist project linked currently')\n }\n }\n}\n\n/**\n * Syncronize all linked projects.\n *\n * @returns {Promise<void>} A promise that resolves once synchronization is complete\n */\nexport async function syncAllProjects() {\n setSettings()\n\n // sync all projects\n await syncThemAll()\n}\n\n/**\n * Syncronize all linked projects and today note.\n * This will check for duplication between the projects and today.\n *\n * @returns {Promise<void}\n */\nexport async function syncAllProjectsAndToday() {\n setSettings()\n\n // sync all projects\n await syncThemAll()\n\n // sync todays tasks\n await syncTodayTasks()\n}\n\n/**\n * do the actual work of syncronizing all linked projects\n *\n * @returns {Promise<void>}\n */\nasync function syncThemAll() {\n const search_string = 'todoist_id:'\n const paragraphs: ?$ReadOnlyArray<TParagraph> = await DataStore.searchProjectNotes(search_string)\n\n if (paragraphs) {\n for (let i = 0; i < paragraphs.length; i++) {\n const filename = paragraphs[i].filename\n if (filename) {\n logInfo(pluginJson, `Working on note: ${filename}`)\n const note: ?TNote = DataStore.projectNoteByFilename(filename)\n\n if (note) {\n const paragraphs_to_check: $ReadOnlyArray<TParagraph> = note?.paragraphs\n if (paragraphs_to_check) {\n paragraphs_to_check.forEach((paragraph_to_check) => {\n checkParagraph(paragraph_to_check)\n })\n }\n\n // get the ID\n let id: string = paragraphs[i].content.split(':')[1]\n id = id.trim()\n\n logInfo(pluginJson, `Matches up to Todoist project id: ${id}`)\n await projectSync(note, id)\n\n //close the tasks in Todoist if they are complete in Noteplan`\n closed.forEach(async (t) => {\n await closeTodoistTask(t)\n })\n } else {\n logError(pluginJson, `Unable to open note asked requested by script (${filename})`)\n }\n } else {\n logError(pluginJson, `Unable to find filename associated with search results`)\n }\n }\n } else {\n logInfo(pluginJson, `No results found in notes for term: todoist_id. Make sure frontmatter is set according to plugin instructions`)\n }\n}\n\n/**\n * Synchronize tasks for today.\n *\n * @returns {Promise<void>} A promise that resolves once synchronization is complete.\n */\n// eslint-disable-next-line require-await\nexport async function syncToday() {\n setSettings()\n\n // sync today tasks\n await syncTodayTasks()\n}\n\n/**\n * Do the actual work of getting and syncing today tasks\n *\n * @returns {Promise<void>}\n */\nasync function syncTodayTasks() {\n console.log(existing)\n // get todays date in the correct format\n const date: string = getTodaysDateUnhyphenated() ?? ''\n const date_string: string = getTodaysDateAsArrowDate() ?? ''\n logInfo(pluginJson, `Todays date is: ${date_string}`)\n\n if (date) {\n const note: ?TNote = DataStore?.calendarNoteByDateString(date)\n if (note === null) {\n logError(pluginJson, 'unable to find todays note in Noteplan')\n HTMLView.showSheet(`<html><body><p>Unable to find daily note for ${date_string}</p></body></html>`, 450, 50)\n process.exit(1)\n }\n // check to see if that heading already exists and tab what tasks already exist\n const paragraphs: ?$ReadOnlyArray<TParagraph> = note?.paragraphs\n if (paragraphs) {\n paragraphs.forEach((paragraph) => {\n checkParagraph(paragraph)\n })\n }\n\n logInfo(pluginJson, `Todays note was found, pulling Today Todoist tasks...`)\n const response = await pullTodoistTasksForToday()\n const tasks: Array<Object> = JSON.parse(response)\n\n if (tasks.results && note) {\n tasks.results.forEach(async (t) => {\n await writeOutTask(note, t)\n })\n\n // close the tasks in Todoist if they are complete in Noteplan`\n closed.forEach(async (t) => {\n await closeTodoistTask(t)\n })\n }\n }\n}\n\n/**\n * Get Todoist project tasks and write them out one by one\n *\n * @param {TNote} note - note that will be written to\n * @param {string} id - Todoist project ID\n * @returns {Promise<void>}\n */\nasync function projectSync(note: TNote, id: string): Promise<void> {\n const task_result = await pullTodoistTasksByProject(id)\n const tasks: Array<Object> = JSON.parse(task_result)\n \n tasks.results.forEach(async (t) => { \n await writeOutTask(note, t)\n })\n}\n\n/**\n * Pull todoist tasks from list matching the ID provided\n *\n * @param {string} project_id - the id of the Todoist project\n * @returns {Promise<any>} - promise that resolves into array of task objects or null\n */\nasync function pullTodoistTasksByProject(project_id: string): Promise<any> {\n if (project_id !== '') {\n let filter = ''\n if (setup.useTeamAccount) {\n if (setup.addUnassigned) {\n filter = '& filter=!assigned to: others'\n } else {\n filter = '& filter=assigned to: me'\n }\n }\n const result = await fetch(`${todo_api}/tasks?project_id=${project_id}${filter}`, getRequestObject())\n return result\n }\n return null\n}\n\n/**\n * Pull todoist tasks with a due date of today\n *\n * @returns {Promise<any>} - promise that resolves into array of task objects or null\n */\nasync function pullTodoistTasksForToday(): Promise<any> {\n let filter = '?query=today'\n if (setup.useTeamAccount) {\n if (setup.addUnassigned) {\n filter = `${filter} & !assigned to: others`\n } else {\n filter = `${filter} & assigned to: me`\n }\n }\n logInfo(pluginJson, `Fetching Todoist tasks with filter: ${todo_api}/tasks/filter${filter}`)\n const result = await fetch(`${todo_api}/tasks/filter${filter}`, getRequestObject())\n if (result) {\n return result\n }\n return null\n}\n\n/**\n * Check a paragraph for specific conditions and update the state accordingly.\n *\n * @param {TParagraph} paragraph - The paragraph to check.\n * @returns {void}\n */\nfunction checkParagraph(paragraph: TParagraph) {\n const string: string = `### ${setup.header}`\n const regex: any = new RegExp(string)\n if (paragraph.rawContent.match(regex)) {\n existingHeader.headerExists = true\n }\n\n if (paragraph.type === 'done' || paragraph.type === 'cancelled') {\n const content: string = paragraph.content\n logDebug(pluginJson, `Done or Cancelled Task content: ${content}`)\n\n // close these ones in Todoist if they are closed in Noteplan and are todoist tasks\n const found: ?Array<string> = content.match(/app\\/task\\/(.*?)\\)/)\n if (found && found.length > 1) {\n logInfo(pluginJson, `Todoist ID found in Noteplan note (${found[1]})`)\n closed.push(found[1])\n // add to existing as well so they do not get rewritten if the timing on closing them is slow\n existing.push(found[1])\n }\n } else if (paragraph.type === 'open') {\n const content: string = paragraph.content\n logDebug(pluginJson, `Open Task content: ${content}`)\n const found: ?Array<string> = content.match(/app\\/task\\/(.*?)\\)/)\n if (found && found.length > 1) {\n logInfo(pluginJson, `Todoist ID found in Noteplan note (${found[1]})`)\n // check to see if it is already closed in Todoist.\n fetch(`${todo_api}/tasks/${found[1]}`, getRequestObject()).then((task_info: Object) => {\n const completed: boolean = task_info?.is_completed ?? false\n if (completed === true) {\n logDebug(pluginJson, `Going to mark this one closed in Noteplan: ${task_info.content}`)\n paragraph.type = 'done'\n }\n })\n existing.push(found[1])\n }\n }\n}\n\n/**\n * Format task details for display.\n *\n * @param {Object} task - The task object to format.\n * @returns {string} The formatted task details.\n */\nfunction formatTaskDetails(task: Object): string {\n let task_write: string = ''\n\n // get the priority\n let priorities: string = ''\n if (setup.addPriorities) {\n if (task.priority === 4) {\n priorities = '!!! '\n } else if (task.priority === 3) {\n priorities = '!! '\n } else if (task.priority === 2) {\n priorities = '! '\n }\n }\n\n // concat the priorities to the front of the string\n task_write = `${priorities}${task.content}`\n\n // add the Todoist URL to the end of the string\n task_write = `${task_write}[^](https://app.todoist.com/app/task/${task.id})`\n\n // add the lables after the URL\n if (setup.addTags) {\n task.labels.forEach((label) => {\n task_write = `${task_write} #${label}`\n })\n }\n\n // finnally add the due dates at the very end\n if (setup.addDates && task.due !== null) {\n task_write = `${task_write} >${task.due.date}`\n }\n\n logDebug(pluginJson, `Formatted task details: ${task_write}`)\n return task_write\n}\n\n/**\n * Parse the settings set by the user for use throughout the script.\n *\n * @returns {void}\n */\nfunction setSettings() {\n const settings: Object = DataStore.settings ?? {}\n logDebug(pluginJson, JSON.stringify(settings))\n\n if (settings) {\n // required options that should kill the script if not set\n if ('apiToken' in settings && settings.apiToken !== '') {\n setup.newToken = settings.apiToken\n } else {\n logError(pluginJson, 'Missing API Token')\n HTMLView.showSheet(`<html><body><p>Missing API token. Must be set in settings options</p></body></html>`, 450, 50)\n process.exit(1)\n }\n\n // optional settings\n if ('folderToUse' in settings && settings.folderToUse !== '') {\n setup.newFolder = settings.folderToUse\n }\n\n if ('syncDue' in settings) {\n setup.syncDates = settings.syncDue\n }\n\n if ('syncPriorities' in settings) {\n setup.syncPriorities = settings.syncPriorities\n }\n\n if ('syncTags' in settings) {\n setup.syncTags = settings.syncTags\n }\n\n if ('teamAccount' in settings) {\n setup.useTeamAccount = settings.teamAccount\n }\n\n if ('syncUnassigned' in settings) {\n setup.syncUnassigned = settings.syncUnassigned\n }\n\n if ('headerToUse' in settings && settings.headerToUse !== '') {\n setup.newHeader = settings.headerToUse\n }\n }\n}\n\n/**\n * Format and write task to correct noteplan note\n *\n * @param {TNote} note - the note object that will get the task\n * @param {Object} task - the task object that will be written\n */\nasync function writeOutTask(note: TNote, task: Object) {\n if (note) {\n //console.log(note.content)\n logDebug(pluginJson, task)\n const formatted = formatTaskDetails(task)\n if (task.section_id !== null) {\n let section = await fetch(`${todo_api}/sections/${task.section_id}`, getRequestObject())\n section = JSON.parse(section)\n if (section) {\n if (!existing.includes(task.id) && !just_written.includes(task.id)) {\n logInfo(pluginJson, `1. Task will be added to ${note.title} below ${section.name} (${formatted})`)\n note.addTodoBelowHeadingTitle(formatted, section.name, true, true)\n\n // add to just_written so they do not get duplicated in the Today note when updating all projects and today\n just_written.push(task.id)\n } else {\n logInfo(pluginJson, `Task is already in Noteplan ${task.id}`)\n }\n } else {\n // this one has a section ID but Todoist will not return a name\n // Put it in with no heading\n logWarn(pluginJson, `Section ID ${task.section_id} did not return a section name`)\n if (!existing.includes(task.id) && !just_written.includes(task.id)) {\n logInfo(pluginJson, `2. Task will be added to ${note.title} (${formatted})`)\n note.appendTodo(formatted)\n\n // add to just_written so they do not get duplicated in the Today note when updating all projects and today\n just_written.push(task.id)\n } else {\n logInfo(pluginJson, `Task is already in Noteplan (${formatted})`)\n }\n }\n } else {\n // check for a default heading\n // if there is a predefined header in settings\n if (setup.header !== '') {\n if (!existing.includes(task.id) && !just_written.includes(task.id)) {\n logInfo(pluginJson, `3. Task will be added to ${note.title} below ${setup.header} (${formatted})`)\n note.addTodoBelowHeadingTitle(formatted, setup.header, true, true)\n\n // add to just_written so they do not get duplicated in the Today note when updating all projects and today\n just_written.push(task.id)\n }\n } else {\n if (!existing.includes(task.id) && !just_written.includes(task.id)) {\n logInfo(pluginJson, `4. Task will be added to ${note.title} (${formatted})`)\n note.appendTodo(formatted)\n\n // add to just_written so they do not get duplicated in the Today note when updating all projects and today\n just_written.push(task.id)\n }\n }\n }\n }\n}\n\n/**\n * Create the fetch parameters for a GET operation\n *\n * @returns {Object}\n */\nfunction getRequestObject() {\n const obj: Object = {\n method: 'GET',\n headers: {\n Authorization: `Bearer ${setup.token}`,\n 'Content-Type': 'application/json',\n },\n }\n return obj\n}\n\n/**\n * Create the fetch parameters for a POST operation\n *\n * @returns {Object}\n */\nfunction postRequestObject() {\n const obj: Object = {\n method: 'POST',\n headers: {\n Authorization: `Bearer ${setup.token}`,\n },\n }\n return obj\n}\n\n/**\n * Will search Noteplan in the set folder for a note that matches the Todoist project name.\n * Will create if it does not exist\n * @param {string} project_name\n * @return {Object}\n */\nfunction getExistingNote(project_name: string): Object {\n let filename = ''\n const existing_notes = DataStore.projectNotes.filter((n) => n.filename.startsWith(`${setup.folder}/${project_name}`))\n if (existing_notes.length > 0) {\n logDebug(pluginJson, `Pulling existing note matching project: ${project_name}. Note found: ${existing_notes[0].filename}`)\n filename = existing_notes[0].filename\n } else {\n logDebug(pluginJson, `Creating note: ${project_name} in: ${setup.folder}`)\n try {\n filename = DataStore.newNote(project_name, setup.folder)\n } catch (error) {\n logError(pluginJson, `Unable to create new note (${JSON.stringify(error)}`)\n }\n }\n return { filename: filename }\n}\n\n/**\n * Review existing tasks in Noteplan.\n *\n * @param {TNote} note - The note to review tasks for.\n * @returns {void}\n */\nfunction reviewExistingNoteplanTasks(note: TNote) {\n // we only need to work on the ones that have a page associated with them\n const paragraphs: $ReadOnlyArray<TParagraph> = note.paragraphs ?? []\n if (paragraphs) {\n paragraphs.forEach((paragraph) => {\n checkParagraph(paragraph)\n })\n }\n}\n\n/**\n * Get Todoist projects and synchronize tasks.\n *\n * @returns {Array<Object>}\n */\nasync function getTodoistProjects() {\n const project_list = []\n const results = await fetch(`${todo_api}/projects`, getRequestObject())\n const projects: ?Array<Object> = JSON.parse(results)\n if (projects) {\n projects.forEach((project) => {\n logDebug(pluginJson, `Project name: ${project.name} Project ID: ${project.id}`)\n project_list.push({ project_name: project.name, project_id: project.id })\n })\n }\n return project_list\n}\n\n/**\n * Close a Todoist task.\n *\n * @param {string} task_id - The ID of the task to close.\n * @returns {Promise<void>} A promise that resolves once the task is closed.\n */\nasync function closeTodoistTask(task_id: string) {\n try {\n await fetch(`${todo_api}/tasks/${task_id}/close`, postRequestObject())\n logInfo(pluginJson, `Closed task (${task_id}) in Todoist`)\n } catch (error) {\n logError(pluginJson, `Unable to close task (${task_id}) ${JSON.stringify(error)}`)\n }\n}\n" }, { "path": "dbludeau.TodoistNoteplanSync/src/NPTriggers-Hooks.js", "content": "/* eslint-disable require-await */\n// @flow\n\nimport pluginJson from '../plugin.json' // gives you access to the contents of plugin.json\nimport { log, logError, logDebug, timer, clo, JSP } from '@helpers/dev'\nimport { updateSettingData, pluginUpdated } from '@helpers/NPConfiguration'\n\n/**\n * NOTEPLAN PER-NOTE TRIGGERS\n *\n * The following functions are called by NotePlan automatically\n * if a note has a triggers: section in its frontmatter\n * See the documentation: https://help.noteplan.co/article/173-plugin-note-triggers\n */\n\n/**\n * onOpen\n * Plugin entrypoint for command: \"/onOpen\"\n * Called when a note is opened and that note\n * has a triggers: onOpen in its frontmatter\n * @param {TNote} note - current note in Editor\n */\nexport async function onOpen(note: TNote): Promise<void> {\n try {\n logDebug(pluginJson, `onOpen running for note:\"${String(note.filename)}\"`)\n // Try to guard against infinite loops of opens/refreshing\n // You can delete this code if you are sure that your onOpen trigger will not cause an infinite loop\n // But the safest thing to do is put your code inside the if loop below to ensure it runs no more than once every 15s\n const now = new Date()\n if (Editor?.note?.changedDate) {\n const lastEdit = new Date(Editor?.note?.changedDate)\n if (now.getTime() - lastEdit.getTime() > 15000) {\n logDebug(pluginJson, `onOpen ${timer(lastEdit)} since last edit`)\n // Put your code here or call a function that does the work\n } else {\n logDebug(pluginJson, `onOpen: Only ${timer(lastEdit)} since last edit (hasn't been 15s)`)\n }\n }\n } catch (error) {\n logError(pluginJson, `onOpen: ${JSP(error)}`)\n }\n}\n\n/**\n * onEditorWillSave\n * Plugin entrypoint for command: \"/onEditorWillSave\"\n */\nexport async function onEditorWillSave() {\n try {\n logDebug(pluginJson, `onEditorWillSave running with note in Editor:\"${String(Editor.filename)}\"`)\n // Put your code here or call a function that does the work\n // Note: as stated in the documentation, if you want to change any content in the Editor\n // before the file is written, you should NOT use the *note* variable here to change content\n // Instead, use Editor.* commands (e.g. Editor.insertTextAtCursor()) or Editor.updateParagraphs()\n } catch (error) {\n logError(pluginJson, `onEditorWillSave: ${JSP(error)}`)\n }\n}\n\n/*\n * NOTEPLAN GLOBAL PLUGIN HOOKS\n *\n * The rest of these functions are called by NotePlan automatically under certain conditions\n * It is unlikely you will need to edit/add anything below this line\n *\n */\n\n/**\n * NotePlan calls this function after the plugin is installed or updated.\n * The `updateSettingData` function looks through the new plugin settings in plugin.json and updates\n * the user preferences to include any new fields\n */\nexport async function onUpdateOrInstall(): Promise<void> {\n log(pluginJson, 'NPThemeChooser::onUpdateOrInstall running')\n await updateSettingData(pluginJson)\n}\n\n/**\n * NotePlan calls this function every time the plugin is run (any command in this plugin, including triggers)\n * You should not need to edit this function. All work should be done in the commands themselves\n */\nexport function init(): void {\n logDebug(pluginJson, `${pluginJson['plugin.id']} :: init running`)\n // clo(DataStore.settings, `${pluginJson['plugin.id']} Plugin Settings`)\n DataStore.installOrUpdatePluginsByID([pluginJson['plugin.id']], true, false, false).then((r) => pluginUpdated(pluginJson, r))\n}\n\n/**\n * NotePlan calls this function settings are updated in the Preferences panel\n * You should not need to edit this function\n */\nexport async function onSettingsUpdated(): Promise<void> {\n logDebug(pluginJson, `${pluginJson['plugin.id']} :: onSettingsUpdated running`)\n}\n" }, { "path": "dbludeau.TodoistNoteplanSync/src/index.js", "content": "// @flow\n// Flow typing is important for reducing errors and improving the quality of the code.\n// About Flow: https://flow.org/en/docs/usage/#toc-write-flow-code\n// Getting started with Flow in NotePlan: https://github.com/NotePlan/plugins/blob/main/Flow_Guide.md\n// Note: As you will see in this plugin folder, you can have multiple files -- e.g. one file per command or logical group of commands\n// ...and separate files for helper/support functions that can be tested in isolation\n// The `autowatch` packager combines them all into one script.js file for NotePlan to read\n// From the command line:\n// `noteplan-cli plugin:dev {{pluginId}} --test --watch --coverage`\n// ...will watch for changes and will compile the Plugin script code\n// and copy it to your plugins directory where NotePlan can find it\n// Since NP reloads the Javascript every time you CMD-J to insert a plugin,\n// you can immediately test the new code without restarting NotePlan\n// This index.js file is where the packager starts looking for files to combine into one script.js file\n// So you need to add a line below for each function that you want NP to have access to.\n// Typically, listed below are only the top-level plug-in functions listed in plugin.json\n\nexport { syncToday, syncEverything, syncProject, syncAllProjects, syncAllProjectsAndToday } from './NPPluginMain' \n\n// FETCH mocking for offline testing\n// If you want to use external server calls in your plugin, it can be useful to mock the server responses\n// while you are developing the plugin. This allows you to test the plugin without having to\n// have a server running or having to have a network connection (or wait/pay for the server calls)\n// Comment the following import line out if you want to use live fetch/server endpoints (normal operation)\n// Uncomment it for using server mocks (fake/canned responses) you define in support/fetchOverrides.js\n// import './support/fetchOverrides'\n\n/**\n * Other imports/exports - you will normally not need to edit these\n */\n// eslint-disable-next-line import/order\nexport { editSettings } from '@helpers/NPSettings'\nexport { onUpdateOrInstall, init, onSettingsUpdated } from './NPTriggers-Hooks'\nexport { onOpen, onEditorWillSave } from './NPTriggers-Hooks'\n" }, { "path": "dbludeau.TodoistNoteplanSync/src/support/fetchOverrides.js", "content": "// @flow\n\n// This file is only loaded and fetch is overridden if the import is enabled in the index file\n\n/**\n * FETCH MOCKING\n * This file is used to override the fetch function (calls to an external server) with a fake response\n * This allows you to test your plugin without having to have a server running or having to have a network connection\n * or wait/pay for the server calls\n * You can define your fake responses in this file or in a separate file (see below)\n * ...and when your code makes a fetch call to a server, it will get (an appropriate) fake response instead\n * You define the responses and the text that must be in the fetch call to yield a particular response\n * (see the mockResponses array below)\n */\n\n/**\n * 1) Import any of your fake responses that are saved as files here (or see below for defining them as strings)\n * The file should contain the exact response that the live server would return\n * You can save the response as a JSON file (like sampleFileResponse below) or as a string (like sampleTextResponse below)\n */\nimport sampleFileResponse from './fetchResponses/google.search-for-something.json' // a sample fake response saved as a JSON file\n\n// Other necessary imports\nimport { FetchMock, type FetchMockResponse } from '@mocks/Fetch.mock'\nimport { logDebug } from '@helpers/dev'\n\n/**\n * 2) Or you can define your fake responses as strings in this file:\n */\n// You could also just put all the fake responses here in this file\n// A little messier, but if you don't have very many responses, or they are small/strings, it's fine\nconst sampleTextWeatherResponse = `Nuremberg: ☀️ +9°F`\n\n// 3) So the mock knows when to send back which response, you need to define the match and response for each mock response\n// Fill in the match and response for each mock response you want to use\n// The match object hast following properties:\n// url: string - the url to match (can be a partial string, or can even be a string that includes regex)\n// optionsBody: string - a partial string or string/regex included in the POST body of the request to match (sent in options.body to fetch)\n// optionsBody is optional. If you don't need to match on the POST body (matching URL is enough), just leave it out\n// The response MUST BE A STRING. So either use a string response (like sampleTextWeatherResponse above) or\n// JSON.stringify your response object (like sampleFileResponse above)\nconst mockResponses: Array<FetchMockResponse> = [\n // the first mock below will match a POST request to google.com with the words \"search for something\" in the POST body\n { match: { url: 'google.com', optionsBody: 'search for something' }, response: JSON.stringify(sampleFileResponse) },\n // the mock below will match any GET or POST request to \"wttr.in/Nuremberg?format=3\" regardless of the body\n { match: { url: 'wttr.in/Nuremberg?format=3' }, response: sampleTextWeatherResponse },\n]\n\n/**\n * DO NOT TOUCH ANYTHING BELOW THIS LINE\n */\n\nconst fm = new FetchMock(mockResponses) // add one object to array for each mock response\nfetch = async (url, opts) => {\n logDebug(`fetchOverrides.js`, `FetchMock faking response from: \"${url}\" (turn on/off in index.js)`)\n return await fm.fetch(url, opts)\n} //override the global fetch\n" }, { "path": "dbludeau.TodoistNoteplanSync/src/support/fetchResponses/google.search-for-something.json", "content": "{\n \"someKey\": \"Some Value\",\n \"youGet\": \"The Idea\"\n}" }, { "path": "dbludeau.TodoistNoteplanSync/src/support/helpers.js", "content": "// @flow\n// Here's an example function that can be imported and used in the plugin code\n// More importantly, this function is pure (no NotePlan API calls), which means it can be tested\n// This is a good way to do much of your plugin work in isolation, with tests, and then the NPxxx files can be smaller\n// And just focus on NotePlan input/output, with the majority of the work happening here\n// Reminder:\n// About Flow: https://flow.org/en/docs/usage/#toc-write-flow-code\n// Getting started with Flow in NotePlan: https://github.com/NotePlan/plugins/blob/main/Flow_Guide.md\nexport function uppercase(str: string = ''): string {\n return str.toUpperCase()\n}\n" }, { "path": "deleteme.testPluginDownload/README.md", "content": "# PLUGIN DOWNLOAD TEST Noteplan Plugin\n\n## Latest Updates\n\nSee [CHANGELOG](https://github.com/NotePlan/plugins/blob/main/deleteme.testPluginDownload/CHANGELOG.md) for latest updates/changes to this plugin.\n\n## About This Plugin \n\nMy Plugin for NotePlan\n\n[You will delete this text and replace it with a readme about your plugin -- not ever seen by users, but good for people looking at your code. Before you delete though, you should know:]\n\nYou do not need all of this scaffolding for a basic NP plugin. As the instructions state [Creating Plugins](https://help.noteplan.co/article/65-commandbar-plugins), you can create a plugin with just two files: `plugin.json` and `script.js`. Please read that whole page before proceeding here.\n\nHowever, for more complex plugins, you may find that it's easier to write code in multiple files, incorporating code (helper functions, etc.) written (and *TESTED*) previously by others. We strongly recommend type checking (e.g. [Flow.io](https://flow.io)) to help validate the code you write. If either of those is interesting to you, you're in the right place. Before going any further, make sure you follow the development environment [setup instructions](https://github.com/NotePlan/plugins).\n\n## Creating NotePlan Plugin\n\nYou can create a NotePlan plugin by executing:\n\n```bash\nnoteplan-cli plugin:create\n```\n\nOpen up a terminal folder and change directory to the plugins repository root. Run the command `npm run autowatch` which will keep looking for changes to all plugin files and will re-compile when JavaScript changes are made. It will also transpile ES6 and ES7 code to ES5 which will run on virtually all Macs, and will copy the file(s) to the NotePlan Plugins folder, so you can immediately test in Noteplan.\n\n### NotePlan Plugins Directory\nYou can find all your currently installed NotePlan Plugins here (for AppStore version of NotePlan):\n\n```bash\n/Users/<user>/Library/Containers/co.noteplan.NotePlan3/Data/Library/Application Support/co.noteplan.NotePlan3/Plugins\n```\n\nKeep in mind that you can code/test without updating the plugin version property in `plugin.json`, however when you push the code to the Plugins repository (or create a PR), you should update the version number so that other NotePlan users who have installed your plugin will know that an updated version is available.\n\nFurther to that point, you can use your plugin locally, or you can use `git` to create a Pull Request to get it merged in the Noteplan/plugins repository and potentially available for all users through the `NotePlan > Preferences > Plugins` tab.\n\nThat's it. Happy coding!\n\n## NotePlan Plugin Team\nHat-tip to @eduard, @nmn, @jgclark, @dwertheimer and @codedungeon, who made all this fancy cool stuff.\n" }, { "path": "deleteme.testPluginDownload/plugin.json", "content": "{\n \"plugin.id\": \"deleteme.testPluginDownload\",\n \"plugin.name\": \"🧩 PLUGIN DOWNLOAD TEST\",\n \"plugin.hidden\": true,\n \"COMMENT\": \"Details on these fields: https://help.noteplan.co/article/67-create-command-bar-plugins\",\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.4.0\",\n \"plugin.version\": \"0.1.0\",\n \"plugin.lastUpdateInfo\": \"If you are seeing this, the plugin was installed/updated and onInstallOrUpdate is running. You can click 'No' below\",\n \"plugin.description\": \"My Plugin for NotePlan\",\n \"plugin.author\": \"dwertheimer\",\n \"plugin.requiredFiles-EDIT_ME\": [\"html-plugin-comms.js\"],\n \"plugin.requiredFiles-NOTE\": \"If you want to use HTML windows, remove the '-EDIT_ME' ABOVE\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.changelog\": \"https://github.com/NotePlan/plugins/blob/main/deleteme.testPluginDownload/CHANGELOG.md\",\n \"offerToDownloadPlugin\": {\"id\": \"dwertheimer.TaskSorting\", \"minVersion\": \"1.0.0\"},\n \"commandMigrationMessage\": \"@eduard we are pretending commands from this plugin have been migrated to the Task Sorting plugin. You should click 'Yes' below. The plugin will install, but this script execution will crash, so you won't see anything after you click the 'Yes' button, though you can see the new plugin (Task Sorting) has been installed.\",\n \"plugin.commands\": [\n {\n \"note\": \"================== COMMMANDS ========================\"\n },\n {\n \"name\": \"Test onInstallOrUpdate\",\n \"description\": \"\",\n \"jsFunction\": \"runOnInstallOrUpdate\"\n }\n ],\n \"plugin.settings\": [\n {\n \"note\": \"================== SETTINGS ========================\"\n },\n {\n \"COMMENT\": \"Plugin settings documentation: https://help.noteplan.co/article/123-plugin-configuration\",\n \"type\": \"heading\",\n \"title\": \"PLUGIN DOWNLOAD TEST Settings\"\n },\n {\n \"type\": \"hidden\",\n \"key\": \"pluginID\",\n \"default\": \"deleteme.testPluginDownload\",\n \"COMMENT\": \"This is for use by the editSettings helper function. PluginID must match the plugin.id in the top of this file\"\n },\n {\n \"note\": \"================== DEBUGGING SETTINGS ========================\"\n },\n {\n \"NOTE\": \"DO NOT CHANGE THE FOLLOWING SETTINGS; ADD YOUR SETTINGS ABOVE ^^^\",\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"INFO\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much logging output will be displayed when executing PLUGIN DOWNLOAD TEST commands in NotePlan Plugin Console Logs (NotePlan -> Help -> Plugin Console)\\n\\n - DEBUG: Show All Logs\\n - INFO: Only Show Info, Warnings, and Errors\\n - WARN: Only Show Errors or Warnings\\n - ERROR: Only Show Errors\\n - none: Don't show any logs\",\n \"default\": \"DEBUG\",\n \"required\": true\n }\n ]\n}" }, { "path": "deleteme.testPluginDownload/src/index.js", "content": "// @flow\nimport pluginJson from '../plugin.json' // gives you access to the contents of plugin.json\nimport { updateSettingData, pluginUpdated } from '@helpers/NPConfiguration'\nimport { log, logError, logDebug, timer, clo, JSP } from '@helpers/dev'\n\n/**\n * NotePlan calls this function after the plugin is installed or updated.\n * The `updateSettingData` function looks through the new plugin settings in plugin.json and updates\n * the user preferences to include any new fields\n */\nexport async function onUpdateOrInstall(): Promise<void> {\n try {\n logDebug(pluginJson, `${pluginJson['plugin.id']} :: onUpdateOrInstall running`)\n await updateSettingData(pluginJson)\n } catch (error) {\n logError(pluginJson, `onUpdateOrInstall: ${JSP(error)}`)\n }\n}\n\nexport async function runOnInstallOrUpdate(): Promise<void> {\n try {\n logDebug(pluginJson, `runOnInstallOrUpdate running`)\n // test as after the plugin is installed or updated. the following command updates the plugin's settings data\n const r = { code: 1 /* updated */, message: 'plugin updated message' }\n await pluginUpdated(pluginJson, r)\n } catch (error) {\n logError(pluginJson, `runOnInstallOrUpdate: ${JSP(error)}`)\n }\n}\n" }, { "path": "docs/custom_theme/README.md", "content": "# the default theme\n\n![](screenshot.png)\n\nThis is the default theme for [documentationjs](https://github.com/documentationjs):\nit consists of underscore templates and a few assets: a [highlight.js](https://highlightjs.org/)\ntheme and [basscss](https://basscss.com/) as a basic CSS framework.\n\nThis is bundled by default in documentation: it is the default theme.\n\nThe contents are the following:\n\n* `index._`, the main template that defines the document structure\n* `section._`, a partial used to render each chunk of documentation\n* `assets/*`, any assets, including CSS & JS\n" }, { "path": "docs/custom_theme/assets/anchor.js", "content": "/*!\n * AnchorJS - v4.0.0 - 2017-06-02\n * https://github.com/bryanbraun/anchorjs\n * Copyright (c) 2017 Bryan Braun; Licensed MIT\n */\n/* eslint-env amd, node */\n\n// https://github.com/umdjs/umd/blob/master/templates/returnExports.js\n(function (root, factory) {\n 'use strict';\n if (typeof define === 'function' && define.amd) {\n // AMD. Register as an anonymous module.\n define([], factory);\n } else if (typeof module === 'object' && module.exports) {\n // Node. Does not work with strict CommonJS, but\n // only CommonJS-like environments that support module.exports,\n // like Node.\n module.exports = factory();\n } else {\n // Browser globals (root is window)\n root.AnchorJS = factory();\n root.anchors = new root.AnchorJS();\n }\n})(this, function () {\n 'use strict';\n function AnchorJS(options) {\n this.options = options || {};\n this.elements = [];\n\n /**\n * Assigns options to the internal options object, and provides defaults.\n * @param {Object} opts - Options object\n */\n function _applyRemainingDefaultOptions(opts) {\n opts.icon = opts.hasOwnProperty('icon') ? opts.icon : '\\ue9cb'; // Accepts characters (and also URLs?), like '#', '¶', '❡', or '§'.\n opts.visible = opts.hasOwnProperty('visible') ? opts.visible : 'hover'; // Also accepts 'always' & 'touch'\n opts.placement = opts.hasOwnProperty('placement')\n ? opts.placement\n : 'right'; // Also accepts 'left'\n opts.class = opts.hasOwnProperty('class') ? opts.class : ''; // Accepts any class name.\n // Using Math.floor here will ensure the value is Number-cast and an integer.\n opts.truncate = opts.hasOwnProperty('truncate')\n ? Math.floor(opts.truncate)\n : 64; // Accepts any value that can be typecast to a number.\n }\n\n _applyRemainingDefaultOptions(this.options);\n\n /**\n * Checks to see if this device supports touch. Uses criteria pulled from Modernizr:\n * https://github.com/Modernizr/Modernizr/blob/da22eb27631fc4957f67607fe6042e85c0a84656/feature-detects/touchevents.js#L40\n * @returns {Boolean} - true if the current device supports touch.\n */\n this.isTouchDevice = function () {\n return !!(\n 'ontouchstart' in window ||\n (window.DocumentTouch && document instanceof DocumentTouch)\n );\n };\n\n /**\n * Add anchor links to page elements.\n * @param {String|Array|Nodelist} selector - A CSS selector for targeting the elements you wish to add anchor links\n * to. Also accepts an array or nodeList containing the relavant elements.\n * @returns {this} - The AnchorJS object\n */\n this.add = function (selector) {\n var elements,\n elsWithIds,\n idList,\n elementID,\n i,\n index,\n count,\n tidyText,\n newTidyText,\n readableID,\n anchor,\n visibleOptionToUse,\n indexesToDrop = [];\n\n // We reapply options here because somebody may have overwritten the default options object when setting options.\n // For example, this overwrites all options but visible:\n //\n // anchors.options = { visible: 'always'; }\n _applyRemainingDefaultOptions(this.options);\n\n visibleOptionToUse = this.options.visible;\n if (visibleOptionToUse === 'touch') {\n visibleOptionToUse = this.isTouchDevice() ? 'always' : 'hover';\n }\n\n // Provide a sensible default selector, if none is given.\n if (!selector) {\n selector = 'h2, h3, h4, h5, h6';\n }\n\n elements = _getElements(selector);\n\n if (elements.length === 0) {\n return this;\n }\n\n _addBaselineStyles();\n\n // We produce a list of existing IDs so we don't generate a duplicate.\n elsWithIds = document.querySelectorAll('[id]');\n idList = [].map.call(elsWithIds, function assign(el) {\n return el.id;\n });\n\n for (i = 0; i < elements.length; i++) {\n if (this.hasAnchorJSLink(elements[i])) {\n indexesToDrop.push(i);\n continue;\n }\n\n if (elements[i].hasAttribute('id')) {\n elementID = elements[i].getAttribute('id');\n } else if (elements[i].hasAttribute('data-anchor-id')) {\n elementID = elements[i].getAttribute('data-anchor-id');\n } else {\n tidyText = this.urlify(elements[i].textContent);\n\n // Compare our generated ID to existing IDs (and increment it if needed)\n // before we add it to the page.\n newTidyText = tidyText;\n count = 0;\n do {\n if (index !== undefined) {\n newTidyText = tidyText + '-' + count;\n }\n\n index = idList.indexOf(newTidyText);\n count += 1;\n } while (index !== -1);\n index = undefined;\n idList.push(newTidyText);\n\n elements[i].setAttribute('id', newTidyText);\n elementID = newTidyText;\n }\n\n readableID = elementID.replace(/-/g, ' ');\n\n // The following code builds the following DOM structure in a more effiecient (albeit opaque) way.\n // '<a class=\"anchorjs-link ' + this.options.class + '\" href=\"#' + elementID + '\" aria-label=\"Anchor link for: ' + readableID + '\" data-anchorjs-icon=\"' + this.options.icon + '\"></a>';\n anchor = document.createElement('a');\n anchor.className = 'anchorjs-link ' + this.options.class;\n anchor.href = '#' + elementID;\n anchor.setAttribute('aria-label', 'Anchor link for: ' + readableID);\n anchor.setAttribute('data-anchorjs-icon', this.options.icon);\n\n if (visibleOptionToUse === 'always') {\n anchor.style.opacity = '1';\n }\n\n if (this.options.icon === '\\ue9cb') {\n anchor.style.font = '1em/1 anchorjs-icons';\n\n // We set lineHeight = 1 here because the `anchorjs-icons` font family could otherwise affect the\n // height of the heading. This isn't the case for icons with `placement: left`, so we restore\n // line-height: inherit in that case, ensuring they remain positioned correctly. For more info,\n // see https://github.com/bryanbraun/anchorjs/issues/39.\n if (this.options.placement === 'left') {\n anchor.style.lineHeight = 'inherit';\n }\n }\n\n if (this.options.placement === 'left') {\n anchor.style.position = 'absolute';\n anchor.style.marginLeft = '-1em';\n anchor.style.paddingRight = '0.5em';\n elements[i].insertBefore(anchor, elements[i].firstChild);\n } else {\n // if the option provided is `right` (or anything else).\n anchor.style.paddingLeft = '0.375em';\n elements[i].appendChild(anchor);\n }\n }\n\n for (i = 0; i < indexesToDrop.length; i++) {\n elements.splice(indexesToDrop[i] - i, 1);\n }\n this.elements = this.elements.concat(elements);\n\n return this;\n };\n\n /**\n * Removes all anchorjs-links from elements targed by the selector.\n * @param {String|Array|Nodelist} selector - A CSS selector string targeting elements with anchor links,\n * OR a nodeList / array containing the DOM elements.\n * @returns {this} - The AnchorJS object\n */\n this.remove = function (selector) {\n var index,\n domAnchor,\n elements = _getElements(selector);\n\n for (var i = 0; i < elements.length; i++) {\n domAnchor = elements[i].querySelector('.anchorjs-link');\n if (domAnchor) {\n // Drop the element from our main list, if it's in there.\n index = this.elements.indexOf(elements[i]);\n if (index !== -1) {\n this.elements.splice(index, 1);\n }\n // Remove the anchor from the DOM.\n elements[i].removeChild(domAnchor);\n }\n }\n return this;\n };\n\n /**\n * Removes all anchorjs links. Mostly used for tests.\n */\n this.removeAll = function () {\n this.remove(this.elements);\n };\n\n /**\n * Urlify - Refine text so it makes a good ID.\n *\n * To do this, we remove apostrophes, replace nonsafe characters with hyphens,\n * remove extra hyphens, truncate, trim hyphens, and make lowercase.\n *\n * @param {String} text - Any text. Usually pulled from the webpage element we are linking to.\n * @returns {String} - hyphen-delimited text for use in IDs and URLs.\n */\n this.urlify = function (text) {\n // Regex for finding the nonsafe URL characters (many need escaping): & +$,:;=?@\"#{}|^~[`%!'<>]./()*\\\n var nonsafeChars = /[& +$,:;=?@\"#{}|^~[`%!'<>\\]\\.\\/\\(\\)\\*\\\\]/g,\n urlText;\n\n // The reason we include this _applyRemainingDefaultOptions is so urlify can be called independently,\n // even after setting options. This can be useful for tests or other applications.\n if (!this.options.truncate) {\n _applyRemainingDefaultOptions(this.options);\n }\n\n // Note: we trim hyphens after truncating because truncating can cause dangling hyphens.\n // Example string: // \" ⚡⚡ Don't forget: URL fragments should be i18n-friendly, hyphenated, short, and clean.\"\n urlText = text\n .trim() // \"⚡⚡ Don't forget: URL fragments should be i18n-friendly, hyphenated, short, and clean.\"\n .replace(/\\'/gi, '') // \"⚡⚡ Dont forget: URL fragments should be i18n-friendly, hyphenated, short, and clean.\"\n .replace(nonsafeChars, '-') // \"⚡⚡-Dont-forget--URL-fragments-should-be-i18n-friendly--hyphenated--short--and-clean-\"\n .replace(/-{2,}/g, '-') // \"⚡⚡-Dont-forget-URL-fragments-should-be-i18n-friendly-hyphenated-short-and-clean-\"\n .substring(0, this.options.truncate) // \"⚡⚡-Dont-forget-URL-fragments-should-be-i18n-friendly-hyphenated-\"\n .replace(/^-+|-+$/gm, '') // \"⚡⚡-Dont-forget-URL-fragments-should-be-i18n-friendly-hyphenated\"\n .toLowerCase(); // \"⚡⚡-dont-forget-url-fragments-should-be-i18n-friendly-hyphenated\"\n\n return urlText;\n };\n\n /**\n * Determines if this element already has an AnchorJS link on it.\n * Uses this technique: http://stackoverflow.com/a/5898748/1154642\n * @param {HTMLElemnt} el - a DOM node\n * @returns {Boolean} true/false\n */\n this.hasAnchorJSLink = function (el) {\n var hasLeftAnchor =\n el.firstChild &&\n (' ' + el.firstChild.className + ' ').indexOf(' anchorjs-link ') > -1,\n hasRightAnchor =\n el.lastChild &&\n (' ' + el.lastChild.className + ' ').indexOf(' anchorjs-link ') > -1;\n\n return hasLeftAnchor || hasRightAnchor || false;\n };\n\n /**\n * Turns a selector, nodeList, or array of elements into an array of elements (so we can use array methods).\n * It also throws errors on any other inputs. Used to handle inputs to .add and .remove.\n * @param {String|Array|Nodelist} input - A CSS selector string targeting elements with anchor links,\n * OR a nodeList / array containing the DOM elements.\n * @returns {Array} - An array containing the elements we want.\n */\n function _getElements(input) {\n var elements;\n if (typeof input === 'string' || input instanceof String) {\n // See https://davidwalsh.name/nodelist-array for the technique transforming nodeList -> Array.\n elements = [].slice.call(document.querySelectorAll(input));\n // I checked the 'input instanceof NodeList' test in IE9 and modern browsers and it worked for me.\n } else if (Array.isArray(input) || input instanceof NodeList) {\n elements = [].slice.call(input);\n } else {\n throw new Error('The selector provided to AnchorJS was invalid.');\n }\n return elements;\n }\n\n /**\n * _addBaselineStyles\n * Adds baseline styles to the page, used by all AnchorJS links irregardless of configuration.\n */\n function _addBaselineStyles() {\n // We don't want to add global baseline styles if they've been added before.\n if (document.head.querySelector('style.anchorjs') !== null) {\n return;\n }\n\n var style = document.createElement('style'),\n linkRule =\n ' .anchorjs-link {' +\n ' opacity: 0;' +\n ' text-decoration: none;' +\n ' -webkit-font-smoothing: antialiased;' +\n ' -moz-osx-font-smoothing: grayscale;' +\n ' }',\n hoverRule =\n ' *:hover > .anchorjs-link,' +\n ' .anchorjs-link:focus {' +\n ' opacity: 1;' +\n ' }',\n anchorjsLinkFontFace =\n ' @font-face {' +\n ' font-family: \"anchorjs-icons\";' + // Icon from icomoon; 10px wide & 10px tall; 2 empty below & 4 above\n ' src: url(data:n/a;base64,AAEAAAALAIAAAwAwT1MvMg8yG2cAAAE4AAAAYGNtYXDp3gC3AAABpAAAAExnYXNwAAAAEAAAA9wAAAAIZ2x5ZlQCcfwAAAH4AAABCGhlYWQHFvHyAAAAvAAAADZoaGVhBnACFwAAAPQAAAAkaG10eASAADEAAAGYAAAADGxvY2EACACEAAAB8AAAAAhtYXhwAAYAVwAAARgAAAAgbmFtZQGOH9cAAAMAAAAAunBvc3QAAwAAAAADvAAAACAAAQAAAAEAAHzE2p9fDzz1AAkEAAAAAADRecUWAAAAANQA6R8AAAAAAoACwAAAAAgAAgAAAAAAAAABAAADwP/AAAACgAAA/9MCrQABAAAAAAAAAAAAAAAAAAAAAwABAAAAAwBVAAIAAAAAAAIAAAAAAAAAAAAAAAAAAAAAAAMCQAGQAAUAAAKZAswAAACPApkCzAAAAesAMwEJAAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAAAAAAAAAAAAAQAAg//0DwP/AAEADwABAAAAAAQAAAAAAAAAAAAAAIAAAAAAAAAIAAAACgAAxAAAAAwAAAAMAAAAcAAEAAwAAABwAAwABAAAAHAAEADAAAAAIAAgAAgAAACDpy//9//8AAAAg6cv//f///+EWNwADAAEAAAAAAAAAAAAAAAAACACEAAEAAAAAAAAAAAAAAAAxAAACAAQARAKAAsAAKwBUAAABIiYnJjQ3NzY2MzIWFxYUBwcGIicmNDc3NjQnJiYjIgYHBwYUFxYUBwYGIwciJicmNDc3NjIXFhQHBwYUFxYWMzI2Nzc2NCcmNDc2MhcWFAcHBgYjARQGDAUtLXoWOR8fORYtLTgKGwoKCjgaGg0gEhIgDXoaGgkJBQwHdR85Fi0tOAobCgoKOBoaDSASEiANehoaCQkKGwotLXoWOR8BMwUFLYEuehYXFxYugC44CQkKGwo4GkoaDQ0NDXoaShoKGwoFBe8XFi6ALjgJCQobCjgaShoNDQ0NehpKGgobCgoKLYEuehYXAAAADACWAAEAAAAAAAEACAAAAAEAAAAAAAIAAwAIAAEAAAAAAAMACAAAAAEAAAAAAAQACAAAAAEAAAAAAAUAAQALAAEAAAAAAAYACAAAAAMAAQQJAAEAEAAMAAMAAQQJAAIABgAcAAMAAQQJAAMAEAAMAAMAAQQJAAQAEAAMAAMAAQQJAAUAAgAiAAMAAQQJAAYAEAAMYW5jaG9yanM0MDBAAGEAbgBjAGgAbwByAGoAcwA0ADAAMABAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAH//wAP) format(\"truetype\");' +\n ' }',\n pseudoElContent =\n ' [data-anchorjs-icon]::after {' +\n ' content: attr(data-anchorjs-icon);' +\n ' }',\n firstStyleEl;\n\n style.className = 'anchorjs';\n style.appendChild(document.createTextNode('')); // Necessary for Webkit.\n\n // We place it in the head with the other style tags, if possible, so as to\n // not look out of place. We insert before the others so these styles can be\n // overridden if necessary.\n firstStyleEl = document.head.querySelector('[rel=\"stylesheet\"], style');\n if (firstStyleEl === undefined) {\n document.head.appendChild(style);\n } else {\n document.head.insertBefore(style, firstStyleEl);\n }\n\n style.sheet.insertRule(linkRule, style.sheet.cssRules.length);\n style.sheet.insertRule(hoverRule, style.sheet.cssRules.length);\n style.sheet.insertRule(pseudoElContent, style.sheet.cssRules.length);\n style.sheet.insertRule(anchorjsLinkFontFace, style.sheet.cssRules.length);\n }\n }\n\n return AnchorJS;\n});\n" }, { "path": "docs/custom_theme/assets/bass-addons.css", "content": ".input {\n font-family: inherit;\n display: block;\n width: 100%;\n height: 2rem;\n padding: .5rem;\n margin-bottom: 1rem;\n border: 1px solid #ccc;\n font-size: .875rem;\n border-radius: 3px;\n box-sizing: border-box;\n}\n" }, { "path": "docs/custom_theme/assets/bass.css", "content": "/*! Basscss | http://basscss.com | MIT License */\n\n.h1{ font-size: 2rem }\n.h2{ font-size: 1.5rem }\n.h3{ font-size: 1.25rem }\n.h4{ font-size: 1rem }\n.h5{ font-size: .875rem }\n.h6{ font-size: .75rem }\n\n.font-family-inherit{ font-family:inherit }\n.font-size-inherit{ font-size:inherit }\n.text-decoration-none{ text-decoration:none }\n\n.bold{ font-weight: bold; font-weight: bold }\n.regular{ font-weight:normal }\n.italic{ font-style:italic }\n.caps{ text-transform:uppercase; letter-spacing: .2em; }\n\n.left-align{ text-align:left }\n.center{ text-align:center }\n.right-align{ text-align:right }\n.justify{ text-align:justify }\n\n.nowrap{ white-space:nowrap }\n.break-word{ word-wrap:break-word }\n\n.line-height-1{ line-height: 1 }\n.line-height-2{ line-height: 1.125 }\n.line-height-3{ line-height: 1.25 }\n.line-height-4{ line-height: 1.5 }\n\n.list-style-none{ list-style:none }\n.underline{ text-decoration:underline }\n\n.truncate{\n max-width:100%;\n overflow:hidden;\n text-overflow:ellipsis;\n white-space:nowrap;\n}\n\n.list-reset{\n list-style:none;\n padding-left:0;\n}\n\n.inline{ display:inline }\n.block{ display:block }\n.inline-block{ display:inline-block }\n.table{ display:table }\n.table-cell{ display:table-cell }\n\n.overflow-hidden{ overflow:hidden }\n.overflow-scroll{ overflow:scroll }\n.overflow-auto{ overflow:auto }\n\n.clearfix:before,\n.clearfix:after{\n content:\" \";\n display:table\n}\n.clearfix:after{ clear:both }\n\n.left{ float:left }\n.right{ float:right }\n\n.fit{ max-width:100% }\n\n.max-width-1{ max-width: 24rem }\n.max-width-2{ max-width: 32rem }\n.max-width-3{ max-width: 48rem }\n.max-width-4{ max-width: 64rem }\n\n.border-box{ box-sizing:border-box }\n\n.align-baseline{ vertical-align:baseline }\n.align-top{ vertical-align:top }\n.align-middle{ vertical-align:middle }\n.align-bottom{ vertical-align:bottom }\n\n.m0{ margin:0 }\n.mt0{ margin-top:0 }\n.mr0{ margin-right:0 }\n.mb0{ margin-bottom:0 }\n.ml0{ margin-left:0 }\n.mx0{ margin-left:0; margin-right:0 }\n.my0{ margin-top:0; margin-bottom:0 }\n\n.m1{ margin: .5rem }\n.mt1{ margin-top: .5rem }\n.mr1{ margin-right: .5rem }\n.mb1{ margin-bottom: .5rem }\n.ml1{ margin-left: .5rem }\n.mx1{ margin-left: .5rem; margin-right: .5rem }\n.my1{ margin-top: .5rem; margin-bottom: .5rem }\n\n.m2{ margin: 1rem }\n.mt2{ margin-top: 1rem }\n.mr2{ margin-right: 1rem }\n.mb2{ margin-bottom: 1rem }\n.ml2{ margin-left: 1rem }\n.mx2{ margin-left: 1rem; margin-right: 1rem }\n.my2{ margin-top: 1rem; margin-bottom: 1rem }\n\n.m3{ margin: 2rem }\n.mt3{ margin-top: 2rem }\n.mr3{ margin-right: 2rem }\n.mb3{ margin-bottom: 2rem }\n.ml3{ margin-left: 2rem }\n.mx3{ margin-left: 2rem; margin-right: 2rem }\n.my3{ margin-top: 2rem; margin-bottom: 2rem }\n\n.m4{ margin: 4rem }\n.mt4{ margin-top: 4rem }\n.mr4{ margin-right: 4rem }\n.mb4{ margin-bottom: 4rem }\n.ml4{ margin-left: 4rem }\n.mx4{ margin-left: 4rem; margin-right: 4rem }\n.my4{ margin-top: 4rem; margin-bottom: 4rem }\n\n.mxn1{ margin-left: -.5rem; margin-right: -.5rem; }\n.mxn2{ margin-left: -1rem; margin-right: -1rem; }\n.mxn3{ margin-left: -2rem; margin-right: -2rem; }\n.mxn4{ margin-left: -4rem; margin-right: -4rem; }\n\n.ml-auto{ margin-left:auto }\n.mr-auto{ margin-right:auto }\n.mx-auto{ margin-left:auto; margin-right:auto; }\n\n.p0{ padding:0 }\n.pt0{ padding-top:0 }\n.pr0{ padding-right:0 }\n.pb0{ padding-bottom:0 }\n.pl0{ padding-left:0 }\n.px0{ padding-left:0; padding-right:0 }\n.py0{ padding-top:0; padding-bottom:0 }\n\n.p1{ padding: .5rem }\n.pt1{ padding-top: .5rem }\n.pr1{ padding-right: .5rem }\n.pb1{ padding-bottom: .5rem }\n.pl1{ padding-left: .5rem }\n.py1{ padding-top: .5rem; padding-bottom: .5rem }\n.px1{ padding-left: .5rem; padding-right: .5rem }\n\n.p2{ padding: 1rem }\n.pt2{ padding-top: 1rem }\n.pr2{ padding-right: 1rem }\n.pb2{ padding-bottom: 1rem }\n.pl2{ padding-left: 1rem }\n.py2{ padding-top: 1rem; padding-bottom: 1rem }\n.px2{ padding-left: 1rem; padding-right: 1rem }\n\n.p3{ padding: 2rem }\n.pt3{ padding-top: 2rem }\n.pr3{ padding-right: 2rem }\n.pb3{ padding-bottom: 2rem }\n.pl3{ padding-left: 2rem }\n.py3{ padding-top: 2rem; padding-bottom: 2rem }\n.px3{ padding-left: 2rem; padding-right: 2rem }\n\n.p4{ padding: 4rem }\n.pt4{ padding-top: 4rem }\n.pr4{ padding-right: 4rem }\n.pb4{ padding-bottom: 4rem }\n.pl4{ padding-left: 4rem }\n.py4{ padding-top: 4rem; padding-bottom: 4rem }\n.px4{ padding-left: 4rem; padding-right: 4rem }\n\n.col{\n float:left;\n box-sizing:border-box;\n}\n\n.col-right{\n float:right;\n box-sizing:border-box;\n}\n\n.col-1{\n width:8.33333%;\n}\n\n.col-2{\n width:16.66667%;\n}\n\n.col-3{\n width:25%;\n}\n\n.col-4{\n width:33.33333%;\n}\n\n.col-5{\n width:41.66667%;\n}\n\n.col-6{\n width:50%;\n}\n\n.col-7{\n width:58.33333%;\n}\n\n.col-8{\n width:66.66667%;\n}\n\n.col-9{\n width:75%;\n}\n\n.col-10{\n width:83.33333%;\n}\n\n.col-11{\n width:91.66667%;\n}\n\n.col-12{\n width:100%;\n}\n@media (min-width: 40em){\n\n .sm-col{\n float:left;\n box-sizing:border-box;\n }\n\n .sm-col-right{\n float:right;\n box-sizing:border-box;\n }\n\n .sm-col-1{\n width:8.33333%;\n }\n\n .sm-col-2{\n width:16.66667%;\n }\n\n .sm-col-3{\n width:25%;\n }\n\n .sm-col-4{\n width:33.33333%;\n }\n\n .sm-col-5{\n width:41.66667%;\n }\n\n .sm-col-6{\n width:50%;\n }\n\n .sm-col-7{\n width:58.33333%;\n }\n\n .sm-col-8{\n width:66.66667%;\n }\n\n .sm-col-9{\n width:75%;\n }\n\n .sm-col-10{\n width:83.33333%;\n }\n\n .sm-col-11{\n width:91.66667%;\n }\n\n .sm-col-12{\n width:100%;\n }\n\n}\n@media (min-width: 52em){\n\n .md-col{\n float:left;\n box-sizing:border-box;\n }\n\n .md-col-right{\n float:right;\n box-sizing:border-box;\n }\n\n .md-col-1{\n width:8.33333%;\n }\n\n .md-col-2{\n width:16.66667%;\n }\n\n .md-col-3{\n width:25%;\n }\n\n .md-col-4{\n width:33.33333%;\n }\n\n .md-col-5{\n width:41.66667%;\n }\n\n .md-col-6{\n width:50%;\n }\n\n .md-col-7{\n width:58.33333%;\n }\n\n .md-col-8{\n width:66.66667%;\n }\n\n .md-col-9{\n width:75%;\n }\n\n .md-col-10{\n width:83.33333%;\n }\n\n .md-col-11{\n width:91.66667%;\n }\n\n .md-col-12{\n width:100%;\n }\n\n}\n@media (min-width: 64em){\n\n .lg-col{\n float:left;\n box-sizing:border-box;\n }\n\n .lg-col-right{\n float:right;\n box-sizing:border-box;\n }\n\n .lg-col-1{\n width:8.33333%;\n }\n\n .lg-col-2{\n width:16.66667%;\n }\n\n .lg-col-3{\n width:25%;\n }\n\n .lg-col-4{\n width:33.33333%;\n }\n\n .lg-col-5{\n width:41.66667%;\n }\n\n .lg-col-6{\n width:50%;\n }\n\n .lg-col-7{\n width:58.33333%;\n }\n\n .lg-col-8{\n width:66.66667%;\n }\n\n .lg-col-9{\n width:75%;\n }\n\n .lg-col-10{\n width:83.33333%;\n }\n\n .lg-col-11{\n width:91.66667%;\n }\n\n .lg-col-12{\n width:100%;\n }\n\n}\n.flex{ display:-webkit-box; display:-webkit-flex; display:-ms-flexbox; display:flex }\n\n@media (min-width: 40em){\n .sm-flex{ display:-webkit-box; display:-webkit-flex; display:-ms-flexbox; display:flex }\n}\n\n@media (min-width: 52em){\n .md-flex{ display:-webkit-box; display:-webkit-flex; display:-ms-flexbox; display:flex }\n}\n\n@media (min-width: 64em){\n .lg-flex{ display:-webkit-box; display:-webkit-flex; display:-ms-flexbox; display:flex }\n}\n\n.flex-column{ -webkit-box-orient:vertical; -webkit-box-direction:normal; -webkit-flex-direction:column; -ms-flex-direction:column; flex-direction:column }\n.flex-wrap{ -webkit-flex-wrap:wrap; -ms-flex-wrap:wrap; flex-wrap:wrap }\n\n.items-start{ -webkit-box-align:start; -webkit-align-items:flex-start; -ms-flex-align:start; -ms-grid-row-align:flex-start; align-items:flex-start }\n.items-end{ -webkit-box-align:end; -webkit-align-items:flex-end; -ms-flex-align:end; -ms-grid-row-align:flex-end; align-items:flex-end }\n.items-center{ -webkit-box-align:center; -webkit-align-items:center; -ms-flex-align:center; -ms-grid-row-align:center; align-items:center }\n.items-baseline{ -webkit-box-align:baseline; -webkit-align-items:baseline; -ms-flex-align:baseline; -ms-grid-row-align:baseline; align-items:baseline }\n.items-stretch{ -webkit-box-align:stretch; -webkit-align-items:stretch; -ms-flex-align:stretch; -ms-grid-row-align:stretch; align-items:stretch }\n\n.self-start{ -webkit-align-self:flex-start; -ms-flex-item-align:start; align-self:flex-start }\n.self-end{ -webkit-align-self:flex-end; -ms-flex-item-align:end; align-self:flex-end }\n.self-center{ -webkit-align-self:center; -ms-flex-item-align:center; align-self:center }\n.self-baseline{ -webkit-align-self:baseline; -ms-flex-item-align:baseline; align-self:baseline }\n.self-stretch{ -webkit-align-self:stretch; -ms-flex-item-align:stretch; align-self:stretch }\n\n.justify-start{ -webkit-box-pack:start; -webkit-justify-content:flex-start; -ms-flex-pack:start; justify-content:flex-start }\n.justify-end{ -webkit-box-pack:end; -webkit-justify-content:flex-end; -ms-flex-pack:end; justify-content:flex-end }\n.justify-center{ -webkit-box-pack:center; -webkit-justify-content:center; -ms-flex-pack:center; justify-content:center }\n.justify-between{ -webkit-box-pack:justify; -webkit-justify-content:space-between; -ms-flex-pack:justify; justify-content:space-between }\n.justify-around{ -webkit-justify-content:space-around; -ms-flex-pack:distribute; justify-content:space-around }\n\n.content-start{ -webkit-align-content:flex-start; -ms-flex-line-pack:start; align-content:flex-start }\n.content-end{ -webkit-align-content:flex-end; -ms-flex-line-pack:end; align-content:flex-end }\n.content-center{ -webkit-align-content:center; -ms-flex-line-pack:center; align-content:center }\n.content-between{ -webkit-align-content:space-between; -ms-flex-line-pack:justify; align-content:space-between }\n.content-around{ -webkit-align-content:space-around; -ms-flex-line-pack:distribute; align-content:space-around }\n.content-stretch{ -webkit-align-content:stretch; -ms-flex-line-pack:stretch; align-content:stretch }\n.flex-auto{\n -webkit-box-flex:1;\n -webkit-flex:1 1 auto;\n -ms-flex:1 1 auto;\n flex:1 1 auto;\n min-width:0;\n min-height:0;\n}\n.flex-none{ -webkit-box-flex:0; -webkit-flex:none; -ms-flex:none; flex:none }\n.fs0{ flex-shrink: 0 }\n\n.order-0{ -webkit-box-ordinal-group:1; -webkit-order:0; -ms-flex-order:0; order:0 }\n.order-1{ -webkit-box-ordinal-group:2; -webkit-order:1; -ms-flex-order:1; order:1 }\n.order-2{ -webkit-box-ordinal-group:3; -webkit-order:2; -ms-flex-order:2; order:2 }\n.order-3{ -webkit-box-ordinal-group:4; -webkit-order:3; -ms-flex-order:3; order:3 }\n.order-last{ -webkit-box-ordinal-group:100000; -webkit-order:99999; -ms-flex-order:99999; order:99999 }\n\n.relative{ position:relative }\n.absolute{ position:absolute }\n.fixed{ position:fixed }\n\n.top-0{ top:0 }\n.right-0{ right:0 }\n.bottom-0{ bottom:0 }\n.left-0{ left:0 }\n\n.z1{ z-index: 1 }\n.z2{ z-index: 2 }\n.z3{ z-index: 3 }\n.z4{ z-index: 4 }\n\n.border{\n border-style:solid;\n border-width: 1px;\n}\n\n.border-top{\n border-top-style:solid;\n border-top-width: 1px;\n}\n\n.border-right{\n border-right-style:solid;\n border-right-width: 1px;\n}\n\n.border-bottom{\n border-bottom-style:solid;\n border-bottom-width: 1px;\n}\n\n.border-left{\n border-left-style:solid;\n border-left-width: 1px;\n}\n\n.border-none{ border:0 }\n\n.rounded{ border-radius: 3px }\n.circle{ border-radius:50% }\n\n.rounded-top{ border-radius: 3px 3px 0 0 }\n.rounded-right{ border-radius: 0 3px 3px 0 }\n.rounded-bottom{ border-radius: 0 0 3px 3px }\n.rounded-left{ border-radius: 3px 0 0 3px }\n\n.not-rounded{ border-radius:0 }\n\n.hide{\n position:absolute !important;\n height:1px;\n width:1px;\n overflow:hidden;\n clip:rect(1px, 1px, 1px, 1px);\n}\n\n@media (max-width: 40em){\n .xs-hide{ display:none !important }\n}\n\n@media (min-width: 40em) and (max-width: 52em){\n .sm-hide{ display:none !important }\n}\n\n@media (min-width: 52em) and (max-width: 64em){\n .md-hide{ display:none !important }\n}\n\n@media (min-width: 64em){\n .lg-hide{ display:none !important }\n}\n\n.display-none{ display:none !important }\n\n" }, { "path": "docs/custom_theme/assets/fonts/LICENSE.txt", "content": "Copyright 2010, 2012 Adobe Systems Incorporated (http://www.adobe.com/), with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe Systems Incorporated in the United States and/or other countries.\r\n\r\nThis Font Software is licensed under the SIL Open Font License, Version 1.1.\r\n\r\nThis license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL\r\n\r\n\r\n-----------------------------------------------------------\r\nSIL OPEN FONT LICENSE Version 1.1 - 26 February 2007\r\n-----------------------------------------------------------\r\n\r\nPREAMBLE\r\nThe goals of the Open Font License (OFL) are to stimulate worldwide\r\ndevelopment of collaborative font projects, to support the font creation\r\nefforts of academic and linguistic communities, and to provide a free and\r\nopen framework in which fonts may be shared and improved in partnership\r\nwith others.\r\n\r\nThe OFL allows the licensed fonts to be used, studied, modified and\r\nredistributed freely as long as they are not sold by themselves. The\r\nfonts, including any derivative works, can be bundled, embedded, \r\nredistributed and/or sold with any software provided that any reserved\r\nnames are not used by derivative works. The fonts and derivatives,\r\nhowever, cannot be released under any other type of license. The\r\nrequirement for fonts to remain under this license does not apply\r\nto any document created using the fonts or their derivatives.\r\n\r\nDEFINITIONS\r\n\"Font Software\" refers to the set of files released by the Copyright\r\nHolder(s) under this license and clearly marked as such. This may\r\ninclude source files, build scripts and documentation.\r\n\r\n\"Reserved Font Name\" refers to any names specified as such after the\r\ncopyright statement(s).\r\n\r\n\"Original Version\" refers to the collection of Font Software components as\r\ndistributed by the Copyright Holder(s).\r\n\r\n\"Modified Version\" refers to any derivative made by adding to, deleting,\r\nor substituting -- in part or in whole -- any of the components of the\r\nOriginal Version, by changing formats or by porting the Font Software to a\r\nnew environment.\r\n\r\n\"Author\" refers to any designer, engineer, programmer, technical\r\nwriter or other person who contributed to the Font Software.\r\n\r\nPERMISSION & CONDITIONS\r\nPermission is hereby granted, free of charge, to any person obtaining\r\na copy of the Font Software, to use, study, copy, merge, embed, modify,\r\nredistribute, and sell modified and unmodified copies of the Font\r\nSoftware, subject to the following conditions:\r\n\r\n1) Neither the Font Software nor any of its individual components,\r\nin Original or Modified Versions, may be sold by itself.\r\n\r\n2) Original or Modified Versions of the Font Software may be bundled,\r\nredistributed and/or sold with any software, provided that each copy\r\ncontains the above copyright notice and this license. These can be\r\nincluded either as stand-alone text files, human-readable headers or\r\nin the appropriate machine-readable metadata fields within text or\r\nbinary files as long as those fields can be easily viewed by the user.\r\n\r\n3) No Modified Version of the Font Software may use the Reserved Font\r\nName(s) unless explicit written permission is granted by the corresponding\r\nCopyright Holder. This restriction only applies to the primary font name as\r\npresented to the users.\r\n\r\n4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font\r\nSoftware shall not be used to promote, endorse or advertise any\r\nModified Version, except to acknowledge the contribution(s) of the\r\nCopyright Holder(s) and the Author(s) or with their explicit written\r\npermission.\r\n\r\n5) The Font Software, modified or unmodified, in part or in whole,\r\nmust be distributed entirely under this license, and must not be\r\ndistributed under any other license. The requirement for fonts to\r\nremain under this license does not apply to any document created\r\nusing the Font Software.\r\n\r\nTERMINATION\r\nThis license becomes null and void if any of the above conditions are\r\nnot met.\r\n\r\nDISCLAIMER\r\nTHE FONT SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\r\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF\r\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT\r\nOF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE\r\nCOPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\r\nINCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL\r\nDAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\r\nFROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM\r\nOTHER DEALINGS IN THE FONT SOFTWARE.\r\n" }, { "path": "docs/custom_theme/assets/fonts/source-code-pro.css", "content": "@font-face{\n font-family: 'Source Code Pro';\n font-weight: 400;\n font-style: normal;\n font-stretch: normal;\n src: url('EOT/SourceCodePro-Regular.eot') format('embedded-opentype'),\n url('WOFF2/TTF/SourceCodePro-Regular.ttf.woff2') format('woff2'),\n url('WOFF/OTF/SourceCodePro-Regular.otf.woff') format('woff'),\n url('OTF/SourceCodePro-Regular.otf') format('opentype'),\n url('TTF/SourceCodePro-Regular.ttf') format('truetype');\n}\n\n@font-face{\n font-family: 'Source Code Pro';\n font-weight: 700;\n font-style: normal;\n font-stretch: normal;\n src: url('EOT/SourceCodePro-Bold.eot') format('embedded-opentype'),\n url('WOFF2/TTF/SourceCodePro-Bold.ttf.woff2') format('woff2'),\n url('WOFF/OTF/SourceCodePro-Bold.otf.woff') format('woff'),\n url('OTF/SourceCodePro-Bold.otf') format('opentype'),\n url('TTF/SourceCodePro-Bold.ttf') format('truetype');\n}\n" }, { "path": "docs/custom_theme/assets/github.css", "content": "/*\n\ngithub.com style (c) Vasily Polovnyov <vast@whiteants.net>\n\n*/\n\n.hljs {\n display: block;\n overflow-x: auto;\n padding: 0.5em;\n color: #333;\n background: #f8f8f8;\n -webkit-text-size-adjust: none;\n}\n\n.hljs-comment,\n.diff .hljs-header,\n.hljs-javadoc {\n color: #998;\n font-style: italic;\n}\n\n.hljs-keyword,\n.css .rule .hljs-keyword,\n.hljs-winutils,\n.nginx .hljs-title,\n.hljs-subst,\n.hljs-request,\n.hljs-status {\n color: #1184CE;\n}\n\n.hljs-number,\n.hljs-hexcolor,\n.ruby .hljs-constant {\n color: #ed225d;\n}\n\n.hljs-string,\n.hljs-tag .hljs-value,\n.hljs-phpdoc,\n.hljs-dartdoc,\n.tex .hljs-formula {\n color: #ed225d;\n}\n\n.hljs-title,\n.hljs-id,\n.scss .hljs-preprocessor {\n color: #900;\n font-weight: bold;\n}\n\n.hljs-list .hljs-keyword,\n.hljs-subst {\n font-weight: normal;\n}\n\n.hljs-class .hljs-title,\n.hljs-type,\n.vhdl .hljs-literal,\n.tex .hljs-command {\n color: #458;\n font-weight: bold;\n}\n\n.hljs-tag,\n.hljs-tag .hljs-title,\n.hljs-rules .hljs-property,\n.django .hljs-tag .hljs-keyword {\n color: #000080;\n font-weight: normal;\n}\n\n.hljs-attribute,\n.hljs-variable,\n.lisp .hljs-body {\n color: #008080;\n}\n\n.hljs-regexp {\n color: #009926;\n}\n\n.hljs-symbol,\n.ruby .hljs-symbol .hljs-string,\n.lisp .hljs-keyword,\n.clojure .hljs-keyword,\n.scheme .hljs-keyword,\n.tex .hljs-special,\n.hljs-prompt {\n color: #990073;\n}\n\n.hljs-built_in {\n color: #0086b3;\n}\n\n.hljs-preprocessor,\n.hljs-pragma,\n.hljs-pi,\n.hljs-doctype,\n.hljs-shebang,\n.hljs-cdata {\n color: #999;\n font-weight: bold;\n}\n\n.hljs-deletion {\n background: #fdd;\n}\n\n.hljs-addition {\n background: #dfd;\n}\n\n.diff .hljs-change {\n background: #0086b3;\n}\n\n.hljs-chunk {\n color: #aaa;\n}\n" }, { "path": "docs/custom_theme/assets/site.js", "content": "/* global anchors */\n\n// add anchor links to headers\nanchors.options.placement = 'left';\nanchors.add('h3');\n\n// Filter UI\nvar tocElements = document.getElementById('toc').getElementsByTagName('li');\n\ndocument.getElementById('filter-input').addEventListener('keyup', function (e) {\n var i, element, children;\n\n // enter key\n if (e.keyCode === 13) {\n // go to the first displayed item in the toc\n for (i = 0; i < tocElements.length; i++) {\n element = tocElements[i];\n if (!element.classList.contains('display-none')) {\n location.replace(element.firstChild.href);\n return e.preventDefault();\n }\n }\n }\n\n var match = function () {\n return true;\n };\n\n var value = this.value.toLowerCase();\n\n if (!value.match(/^\\s*$/)) {\n match = function (element) {\n var html = element.firstChild.innerHTML;\n return html && html.toLowerCase().indexOf(value) !== -1;\n };\n }\n\n for (i = 0; i < tocElements.length; i++) {\n element = tocElements[i];\n children = Array.from(element.getElementsByTagName('li'));\n if (match(element) || children.some(match)) {\n element.classList.remove('display-none');\n } else {\n element.classList.add('display-none');\n }\n }\n});\n\nvar items = document.getElementsByClassName('toggle-sibling');\nfor (var j = 0; j < items.length; j++) {\n items[j].addEventListener('click', toggleSibling);\n}\n\nfunction toggleSibling() {\n var stepSibling = this.parentNode.getElementsByClassName('toggle-target')[0];\n var icon = this.getElementsByClassName('icon')[0];\n var klass = 'display-none';\n if (stepSibling.classList.contains(klass)) {\n stepSibling.classList.remove(klass);\n icon.innerHTML = '▾';\n } else {\n stepSibling.classList.add(klass);\n icon.innerHTML = '▸';\n }\n}\n\nfunction showHashTarget(targetId) {\n if (targetId) {\n var hashTarget = document.getElementById(targetId);\n // new target is hidden\n if (\n hashTarget &&\n hashTarget.offsetHeight === 0 &&\n hashTarget.parentNode.parentNode.classList.contains('display-none')\n ) {\n hashTarget.parentNode.parentNode.classList.remove('display-none');\n }\n }\n}\n\nfunction scrollIntoView(targetId) {\n // Only scroll to element if we don't have a stored scroll position.\n if (targetId && !history.state) {\n var hashTarget = document.getElementById(targetId);\n if (hashTarget) {\n hashTarget.scrollIntoView();\n }\n }\n}\n\nfunction gotoCurrentTarget() {\n showHashTarget(location.hash.substring(1));\n scrollIntoView(location.hash.substring(1));\n}\n\nwindow.addEventListener('hashchange', gotoCurrentTarget);\ngotoCurrentTarget();\n\nvar toclinks = document.getElementsByClassName('pre-open');\nfor (var k = 0; k < toclinks.length; k++) {\n toclinks[k].addEventListener('mousedown', preOpen, false);\n}\n\nfunction preOpen() {\n showHashTarget(this.hash.substring(1));\n}\n\nvar split_left = document.querySelector('#split-left');\nvar split_right = document.querySelector('#split-right');\nvar split_parent = split_left.parentNode;\nvar cw_with_sb = split_left.clientWidth;\nsplit_left.style.overflow = 'hidden';\nvar cw_without_sb = split_left.clientWidth;\nsplit_left.style.overflow = '';\n\nSplit(['#split-left', '#split-right'], {\n elementStyle: function (dimension, size, gutterSize) {\n return {\n 'flex-basis': 'calc(' + size + '% - ' + gutterSize + 'px)'\n };\n },\n gutterStyle: function (dimension, gutterSize) {\n return {\n 'flex-basis': gutterSize + 'px'\n };\n },\n gutterSize: 20,\n sizes: [33, 67]\n});\n\n// Chrome doesn't remember scroll position properly so do it ourselves.\n// Also works on Firefox and Edge.\n\nfunction updateState() {\n history.replaceState(\n {\n left_top: split_left.scrollTop,\n right_top: split_right.scrollTop\n },\n document.title\n );\n}\n\nfunction loadState(ev) {\n if (ev) {\n // Edge doesn't replace change history.state on popstate.\n history.replaceState(ev.state, document.title);\n }\n if (history.state) {\n split_left.scrollTop = history.state.left_top;\n split_right.scrollTop = history.state.right_top;\n }\n}\n\nwindow.addEventListener('load', function () {\n // Restore after Firefox scrolls to hash.\n setTimeout(function () {\n loadState();\n // Update with initial scroll position.\n updateState();\n // Update scroll positions only after we've loaded because Firefox\n // emits an initial scroll event with 0.\n split_left.addEventListener('scroll', updateState);\n split_right.addEventListener('scroll', updateState);\n }, 1);\n});\n\nwindow.addEventListener('popstate', loadState);\n" }, { "path": "docs/custom_theme/assets/split.css", "content": ".gutter {\n background-color: #f5f5f5;\n background-repeat: no-repeat;\n background-position: 50%;\n}\n\n.gutter.gutter-vertical {\n background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB4AAAAFAQMAAABo7865AAAABlBMVEVHcEzMzMzyAv2sAAAAAXRSTlMAQObYZgAAABBJREFUeF5jOAMEEAIEEFwAn3kMwcB6I2AAAAAASUVORK5CYII=');\n cursor: ns-resize;\n}\n\n.gutter.gutter-horizontal {\n background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAeCAYAAADkftS9AAAAIklEQVQoU2M4c+bMfxAGAgYYmwGrIIiDjrELjpo5aiZeMwF+yNnOs5KSvgAAAABJRU5ErkJggg==');\n cursor: ew-resize;\n}\n" }, { "path": "docs/custom_theme/assets/split.js", "content": "/*! Split.js - v1.5.11 */\n\n(function (global, factory) {\n typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :\n typeof define === 'function' && define.amd ? define(factory) :\n (global.Split = factory());\n}(this, (function () { 'use strict';\n\n // The programming goals of Split.js are to deliver readable, understandable and\n // maintainable code, while at the same time manually optimizing for tiny minified file size,\n // browser compatibility without additional requirements, graceful fallback (IE8 is supported)\n // and very few assumptions about the user's page layout.\n var global = window;\n var document = global.document;\n\n // Save a couple long function names that are used frequently.\n // This optimization saves around 400 bytes.\n var addEventListener = 'addEventListener';\n var removeEventListener = 'removeEventListener';\n var getBoundingClientRect = 'getBoundingClientRect';\n var gutterStartDragging = '_a';\n var aGutterSize = '_b';\n var bGutterSize = '_c';\n var HORIZONTAL = 'horizontal';\n var NOOP = function () { return false; };\n\n // Figure out if we're in IE8 or not. IE8 will still render correctly,\n // but will be static instead of draggable.\n var isIE8 = global.attachEvent && !global[addEventListener];\n\n // Helper function determines which prefixes of CSS calc we need.\n // We only need to do this once on startup, when this anonymous function is called.\n //\n // Tests -webkit, -moz and -o prefixes. Modified from StackOverflow:\n // http://stackoverflow.com/questions/16625140/js-feature-detection-to-detect-the-usage-of-webkit-calc-over-calc/16625167#16625167\n var calc = (['', '-webkit-', '-moz-', '-o-']\n .filter(function (prefix) {\n var el = document.createElement('div');\n el.style.cssText = \"width:\" + prefix + \"calc(9px)\";\n\n return !!el.style.length\n })\n .shift()) + \"calc\";\n\n // Helper function checks if its argument is a string-like type\n var isString = function (v) { return typeof v === 'string' || v instanceof String; };\n\n // Helper function allows elements and string selectors to be used\n // interchangeably. In either case an element is returned. This allows us to\n // do `Split([elem1, elem2])` as well as `Split(['#id1', '#id2'])`.\n var elementOrSelector = function (el) {\n if (isString(el)) {\n var ele = document.querySelector(el);\n if (!ele) {\n throw new Error((\"Selector \" + el + \" did not match a DOM element\"))\n }\n return ele\n }\n\n return el\n };\n\n // Helper function gets a property from the properties object, with a default fallback\n var getOption = function (options, propName, def) {\n var value = options[propName];\n if (value !== undefined) {\n return value\n }\n return def\n };\n\n var getGutterSize = function (gutterSize, isFirst, isLast, gutterAlign) {\n if (isFirst) {\n if (gutterAlign === 'end') {\n return 0\n }\n if (gutterAlign === 'center') {\n return gutterSize / 2\n }\n } else if (isLast) {\n if (gutterAlign === 'start') {\n return 0\n }\n if (gutterAlign === 'center') {\n return gutterSize / 2\n }\n }\n\n return gutterSize\n };\n\n // Default options\n var defaultGutterFn = function (i, gutterDirection) {\n var gut = document.createElement('div');\n gut.className = \"gutter gutter-\" + gutterDirection;\n return gut\n };\n\n var defaultElementStyleFn = function (dim, size, gutSize) {\n var style = {};\n\n if (!isString(size)) {\n if (!isIE8) {\n style[dim] = calc + \"(\" + size + \"% - \" + gutSize + \"px)\";\n } else {\n style[dim] = size + \"%\";\n }\n } else {\n style[dim] = size;\n }\n\n return style\n };\n\n var defaultGutterStyleFn = function (dim, gutSize) {\n var obj;\n\n return (( obj = {}, obj[dim] = (gutSize + \"px\"), obj ));\n };\n\n // The main function to initialize a split. Split.js thinks about each pair\n // of elements as an independant pair. Dragging the gutter between two elements\n // only changes the dimensions of elements in that pair. This is key to understanding\n // how the following functions operate, since each function is bound to a pair.\n //\n // A pair object is shaped like this:\n //\n // {\n // a: DOM element,\n // b: DOM element,\n // aMin: Number,\n // bMin: Number,\n // dragging: Boolean,\n // parent: DOM element,\n // direction: 'horizontal' | 'vertical'\n // }\n //\n // The basic sequence:\n //\n // 1. Set defaults to something sane. `options` doesn't have to be passed at all.\n // 2. Initialize a bunch of strings based on the direction we're splitting.\n // A lot of the behavior in the rest of the library is paramatized down to\n // rely on CSS strings and classes.\n // 3. Define the dragging helper functions, and a few helpers to go with them.\n // 4. Loop through the elements while pairing them off. Every pair gets an\n // `pair` object and a gutter.\n // 5. Actually size the pair elements, insert gutters and attach event listeners.\n var Split = function (idsOption, options) {\n if ( options === void 0 ) options = {};\n\n var ids = idsOption;\n var dimension;\n var clientAxis;\n var position;\n var positionEnd;\n var clientSize;\n var elements;\n\n // Allow HTMLCollection to be used as an argument when supported\n if (Array.from) {\n ids = Array.from(ids);\n }\n\n // All DOM elements in the split should have a common parent. We can grab\n // the first elements parent and hope users read the docs because the\n // behavior will be whacky otherwise.\n var firstElement = elementOrSelector(ids[0]);\n var parent = firstElement.parentNode;\n var parentStyle = getComputedStyle ? getComputedStyle(parent) : null;\n var parentFlexDirection = parentStyle ? parentStyle.flexDirection : null;\n\n // Set default options.sizes to equal percentages of the parent element.\n var sizes = getOption(options, 'sizes') || ids.map(function () { return 100 / ids.length; });\n\n // Standardize minSize to an array if it isn't already. This allows minSize\n // to be passed as a number.\n var minSize = getOption(options, 'minSize', 100);\n var minSizes = Array.isArray(minSize) ? minSize : ids.map(function () { return minSize; });\n\n // Get other options\n var expandToMin = getOption(options, 'expandToMin', false);\n var gutterSize = getOption(options, 'gutterSize', 10);\n var gutterAlign = getOption(options, 'gutterAlign', 'center');\n var snapOffset = getOption(options, 'snapOffset', 30);\n var dragInterval = getOption(options, 'dragInterval', 1);\n var direction = getOption(options, 'direction', HORIZONTAL);\n var cursor = getOption(\n options,\n 'cursor',\n direction === HORIZONTAL ? 'col-resize' : 'row-resize'\n );\n var gutter = getOption(options, 'gutter', defaultGutterFn);\n var elementStyle = getOption(\n options,\n 'elementStyle',\n defaultElementStyleFn\n );\n var gutterStyle = getOption(options, 'gutterStyle', defaultGutterStyleFn);\n\n // 2. Initialize a bunch of strings based on the direction we're splitting.\n // A lot of the behavior in the rest of the library is paramatized down to\n // rely on CSS strings and classes.\n if (direction === HORIZONTAL) {\n dimension = 'width';\n clientAxis = 'clientX';\n position = 'left';\n positionEnd = 'right';\n clientSize = 'clientWidth';\n } else if (direction === 'vertical') {\n dimension = 'height';\n clientAxis = 'clientY';\n position = 'top';\n positionEnd = 'bottom';\n clientSize = 'clientHeight';\n }\n\n // 3. Define the dragging helper functions, and a few helpers to go with them.\n // Each helper is bound to a pair object that contains its metadata. This\n // also makes it easy to store references to listeners that that will be\n // added and removed.\n //\n // Even though there are no other functions contained in them, aliasing\n // this to self saves 50 bytes or so since it's used so frequently.\n //\n // The pair object saves metadata like dragging state, position and\n // event listener references.\n\n function setElementSize(el, size, gutSize, i) {\n // Split.js allows setting sizes via numbers (ideally), or if you must,\n // by string, like '300px'. This is less than ideal, because it breaks\n // the fluid layout that `calc(% - px)` provides. You're on your own if you do that,\n // make sure you calculate the gutter size by hand.\n var style = elementStyle(dimension, size, gutSize, i);\n\n Object.keys(style).forEach(function (prop) {\n // eslint-disable-next-line no-param-reassign\n el.style[prop] = style[prop];\n });\n }\n\n function setGutterSize(gutterElement, gutSize, i) {\n var style = gutterStyle(dimension, gutSize, i);\n\n Object.keys(style).forEach(function (prop) {\n // eslint-disable-next-line no-param-reassign\n gutterElement.style[prop] = style[prop];\n });\n }\n\n function getSizes() {\n return elements.map(function (element) { return element.size; })\n }\n\n // Supports touch events, but not multitouch, so only the first\n // finger `touches[0]` is counted.\n function getMousePosition(e) {\n if ('touches' in e) { return e.touches[0][clientAxis] }\n return e[clientAxis]\n }\n\n // Actually adjust the size of elements `a` and `b` to `offset` while dragging.\n // calc is used to allow calc(percentage + gutterpx) on the whole split instance,\n // which allows the viewport to be resized without additional logic.\n // Element a's size is the same as offset. b's size is total size - a size.\n // Both sizes are calculated from the initial parent percentage,\n // then the gutter size is subtracted.\n function adjust(offset) {\n var a = elements[this.a];\n var b = elements[this.b];\n var percentage = a.size + b.size;\n\n a.size = (offset / this.size) * percentage;\n b.size = percentage - (offset / this.size) * percentage;\n\n setElementSize(a.element, a.size, this[aGutterSize], a.i);\n setElementSize(b.element, b.size, this[bGutterSize], b.i);\n }\n\n // drag, where all the magic happens. The logic is really quite simple:\n //\n // 1. Ignore if the pair is not dragging.\n // 2. Get the offset of the event.\n // 3. Snap offset to min if within snappable range (within min + snapOffset).\n // 4. Actually adjust each element in the pair to offset.\n //\n // ---------------------------------------------------------------------\n // | | <- a.minSize || b.minSize -> | |\n // | | | <- this.snapOffset || this.snapOffset -> | | |\n // | | | || | | |\n // | | | || | | |\n // ---------------------------------------------------------------------\n // | <- this.start this.size -> |\n function drag(e) {\n var offset;\n var a = elements[this.a];\n var b = elements[this.b];\n\n if (!this.dragging) { return }\n\n // Get the offset of the event from the first side of the\n // pair `this.start`. Then offset by the initial position of the\n // mouse compared to the gutter size.\n offset =\n getMousePosition(e) -\n this.start +\n (this[aGutterSize] - this.dragOffset);\n\n if (dragInterval > 1) {\n offset = Math.round(offset / dragInterval) * dragInterval;\n }\n\n // If within snapOffset of min or max, set offset to min or max.\n // snapOffset buffers a.minSize and b.minSize, so logic is opposite for both.\n // Include the appropriate gutter sizes to prevent overflows.\n if (offset <= a.minSize + snapOffset + this[aGutterSize]) {\n offset = a.minSize + this[aGutterSize];\n } else if (\n offset >=\n this.size - (b.minSize + snapOffset + this[bGutterSize])\n ) {\n offset = this.size - (b.minSize + this[bGutterSize]);\n }\n\n // Actually adjust the size.\n adjust.call(this, offset);\n\n // Call the drag callback continously. Don't do anything too intensive\n // in this callback.\n getOption(options, 'onDrag', NOOP)();\n }\n\n // Cache some important sizes when drag starts, so we don't have to do that\n // continously:\n //\n // `size`: The total size of the pair. First + second + first gutter + second gutter.\n // `start`: The leading side of the first element.\n //\n // ------------------------------------------------\n // | aGutterSize -> ||| |\n // | ||| |\n // | ||| |\n // | ||| <- bGutterSize |\n // ------------------------------------------------\n // | <- start size -> |\n function calculateSizes() {\n // Figure out the parent size minus padding.\n var a = elements[this.a].element;\n var b = elements[this.b].element;\n\n var aBounds = a[getBoundingClientRect]();\n var bBounds = b[getBoundingClientRect]();\n\n this.size =\n aBounds[dimension] +\n bBounds[dimension] +\n this[aGutterSize] +\n this[bGutterSize];\n this.start = aBounds[position];\n this.end = aBounds[positionEnd];\n }\n\n function innerSize(element) {\n // Return nothing if getComputedStyle is not supported (< IE9)\n // Or if parent element has no layout yet\n if (!getComputedStyle) { return null }\n\n var computedStyle = getComputedStyle(element);\n\n if (!computedStyle) { return null }\n\n var size = element[clientSize];\n\n if (size === 0) { return null }\n\n if (direction === HORIZONTAL) {\n size -=\n parseFloat(computedStyle.paddingLeft) +\n parseFloat(computedStyle.paddingRight);\n } else {\n size -=\n parseFloat(computedStyle.paddingTop) +\n parseFloat(computedStyle.paddingBottom);\n }\n\n return size\n }\n\n // When specifying percentage sizes that are less than the computed\n // size of the element minus the gutter, the lesser percentages must be increased\n // (and decreased from the other elements) to make space for the pixels\n // subtracted by the gutters.\n function trimToMin(sizesToTrim) {\n // Try to get inner size of parent element.\n // If it's no supported, return original sizes.\n var parentSize = innerSize(parent);\n if (parentSize === null) {\n return sizesToTrim\n }\n\n if (minSizes.reduce(function (a, b) { return a + b; }, 0) > parentSize) {\n return sizesToTrim\n }\n\n // Keep track of the excess pixels, the amount of pixels over the desired percentage\n // Also keep track of the elements with pixels to spare, to decrease after if needed\n var excessPixels = 0;\n var toSpare = [];\n\n var pixelSizes = sizesToTrim.map(function (size, i) {\n // Convert requested percentages to pixel sizes\n var pixelSize = (parentSize * size) / 100;\n var elementGutterSize = getGutterSize(\n gutterSize,\n i === 0,\n i === sizesToTrim.length - 1,\n gutterAlign\n );\n var elementMinSize = minSizes[i] + elementGutterSize;\n\n // If element is too smal, increase excess pixels by the difference\n // and mark that it has no pixels to spare\n if (pixelSize < elementMinSize) {\n excessPixels += elementMinSize - pixelSize;\n toSpare.push(0);\n return elementMinSize\n }\n\n // Otherwise, mark the pixels it has to spare and return it's original size\n toSpare.push(pixelSize - elementMinSize);\n return pixelSize\n });\n\n // If nothing was adjusted, return the original sizes\n if (excessPixels === 0) {\n return sizesToTrim\n }\n\n return pixelSizes.map(function (pixelSize, i) {\n var newPixelSize = pixelSize;\n\n // While there's still pixels to take, and there's enough pixels to spare,\n // take as many as possible up to the total excess pixels\n if (excessPixels > 0 && toSpare[i] - excessPixels > 0) {\n var takenPixels = Math.min(\n excessPixels,\n toSpare[i] - excessPixels\n );\n\n // Subtract the amount taken for the next iteration\n excessPixels -= takenPixels;\n newPixelSize = pixelSize - takenPixels;\n }\n\n // Return the pixel size adjusted as a percentage\n return (newPixelSize / parentSize) * 100\n })\n }\n\n // stopDragging is very similar to startDragging in reverse.\n function stopDragging() {\n var self = this;\n var a = elements[self.a].element;\n var b = elements[self.b].element;\n\n if (self.dragging) {\n getOption(options, 'onDragEnd', NOOP)(getSizes());\n }\n\n self.dragging = false;\n\n // Remove the stored event listeners. This is why we store them.\n global[removeEventListener]('mouseup', self.stop);\n global[removeEventListener]('touchend', self.stop);\n global[removeEventListener]('touchcancel', self.stop);\n global[removeEventListener]('mousemove', self.move);\n global[removeEventListener]('touchmove', self.move);\n\n // Clear bound function references\n self.stop = null;\n self.move = null;\n\n a[removeEventListener]('selectstart', NOOP);\n a[removeEventListener]('dragstart', NOOP);\n b[removeEventListener]('selectstart', NOOP);\n b[removeEventListener]('dragstart', NOOP);\n\n a.style.userSelect = '';\n a.style.webkitUserSelect = '';\n a.style.MozUserSelect = '';\n a.style.pointerEvents = '';\n\n b.style.userSelect = '';\n b.style.webkitUserSelect = '';\n b.style.MozUserSelect = '';\n b.style.pointerEvents = '';\n\n self.gutter.style.cursor = '';\n self.parent.style.cursor = '';\n document.body.style.cursor = '';\n }\n\n // startDragging calls `calculateSizes` to store the inital size in the pair object.\n // It also adds event listeners for mouse/touch events,\n // and prevents selection while dragging so avoid the selecting text.\n function startDragging(e) {\n // Right-clicking can't start dragging.\n if ('button' in e && e.button !== 0) {\n return\n }\n\n // Alias frequently used variables to save space. 200 bytes.\n var self = this;\n var a = elements[self.a].element;\n var b = elements[self.b].element;\n\n // Call the onDragStart callback.\n if (!self.dragging) {\n getOption(options, 'onDragStart', NOOP)(getSizes());\n }\n\n // Don't actually drag the element. We emulate that in the drag function.\n e.preventDefault();\n\n // Set the dragging property of the pair object.\n self.dragging = true;\n\n // Create two event listeners bound to the same pair object and store\n // them in the pair object.\n self.move = drag.bind(self);\n self.stop = stopDragging.bind(self);\n\n // All the binding. `window` gets the stop events in case we drag out of the elements.\n global[addEventListener]('mouseup', self.stop);\n global[addEventListener]('touchend', self.stop);\n global[addEventListener]('touchcancel', self.stop);\n global[addEventListener]('mousemove', self.move);\n global[addEventListener]('touchmove', self.move);\n\n // Disable selection. Disable!\n a[addEventListener]('selectstart', NOOP);\n a[addEventListener]('dragstart', NOOP);\n b[addEventListener]('selectstart', NOOP);\n b[addEventListener]('dragstart', NOOP);\n\n a.style.userSelect = 'none';\n a.style.webkitUserSelect = 'none';\n a.style.MozUserSelect = 'none';\n a.style.pointerEvents = 'none';\n\n b.style.userSelect = 'none';\n b.style.webkitUserSelect = 'none';\n b.style.MozUserSelect = 'none';\n b.style.pointerEvents = 'none';\n\n // Set the cursor at multiple levels\n self.gutter.style.cursor = cursor;\n self.parent.style.cursor = cursor;\n document.body.style.cursor = cursor;\n\n // Cache the initial sizes of the pair.\n calculateSizes.call(self);\n\n // Determine the position of the mouse compared to the gutter\n self.dragOffset = getMousePosition(e) - self.end;\n }\n\n // adjust sizes to ensure percentage is within min size and gutter.\n sizes = trimToMin(sizes);\n\n // 5. Create pair and element objects. Each pair has an index reference to\n // elements `a` and `b` of the pair (first and second elements).\n // Loop through the elements while pairing them off. Every pair gets a\n // `pair` object and a gutter.\n //\n // Basic logic:\n //\n // - Starting with the second element `i > 0`, create `pair` objects with\n // `a = i - 1` and `b = i`\n // - Set gutter sizes based on the _pair_ being first/last. The first and last\n // pair have gutterSize / 2, since they only have one half gutter, and not two.\n // - Create gutter elements and add event listeners.\n // - Set the size of the elements, minus the gutter sizes.\n //\n // -----------------------------------------------------------------------\n // | i=0 | i=1 | i=2 | i=3 |\n // | | | | |\n // | pair 0 pair 1 pair 2 |\n // | | | | |\n // -----------------------------------------------------------------------\n var pairs = [];\n elements = ids.map(function (id, i) {\n // Create the element object.\n var element = {\n element: elementOrSelector(id),\n size: sizes[i],\n minSize: minSizes[i],\n i: i,\n };\n\n var pair;\n\n if (i > 0) {\n // Create the pair object with its metadata.\n pair = {\n a: i - 1,\n b: i,\n dragging: false,\n direction: direction,\n parent: parent,\n };\n\n pair[aGutterSize] = getGutterSize(\n gutterSize,\n i - 1 === 0,\n false,\n gutterAlign\n );\n pair[bGutterSize] = getGutterSize(\n gutterSize,\n false,\n i === ids.length - 1,\n gutterAlign\n );\n\n // if the parent has a reverse flex-direction, switch the pair elements.\n if (\n parentFlexDirection === 'row-reverse' ||\n parentFlexDirection === 'column-reverse'\n ) {\n var temp = pair.a;\n pair.a = pair.b;\n pair.b = temp;\n }\n }\n\n // Determine the size of the current element. IE8 is supported by\n // staticly assigning sizes without draggable gutters. Assigns a string\n // to `size`.\n //\n // IE9 and above\n if (!isIE8) {\n // Create gutter elements for each pair.\n if (i > 0) {\n var gutterElement = gutter(i, direction, element.element);\n setGutterSize(gutterElement, gutterSize, i);\n\n // Save bound event listener for removal later\n pair[gutterStartDragging] = startDragging.bind(pair);\n\n // Attach bound event listener\n gutterElement[addEventListener](\n 'mousedown',\n pair[gutterStartDragging]\n );\n gutterElement[addEventListener](\n 'touchstart',\n pair[gutterStartDragging]\n );\n\n parent.insertBefore(gutterElement, element.element);\n\n pair.gutter = gutterElement;\n }\n }\n\n setElementSize(\n element.element,\n element.size,\n getGutterSize(\n gutterSize,\n i === 0,\n i === ids.length - 1,\n gutterAlign\n ),\n i\n );\n\n // After the first iteration, and we have a pair object, append it to the\n // list of pairs.\n if (i > 0) {\n pairs.push(pair);\n }\n\n return element\n });\n\n function adjustToMin(element) {\n var isLast = element.i === pairs.length;\n var pair = isLast ? pairs[element.i - 1] : pairs[element.i];\n\n calculateSizes.call(pair);\n\n var size = isLast\n ? pair.size - element.minSize - pair[bGutterSize]\n : element.minSize + pair[aGutterSize];\n\n adjust.call(pair, size);\n }\n\n elements.forEach(function (element) {\n var computedSize = element.element[getBoundingClientRect]()[dimension];\n\n if (computedSize < element.minSize) {\n if (expandToMin) {\n adjustToMin(element);\n } else {\n // eslint-disable-next-line no-param-reassign\n element.minSize = computedSize;\n }\n }\n });\n\n function setSizes(newSizes) {\n var trimmed = trimToMin(newSizes);\n trimmed.forEach(function (newSize, i) {\n if (i > 0) {\n var pair = pairs[i - 1];\n\n var a = elements[pair.a];\n var b = elements[pair.b];\n\n a.size = trimmed[i - 1];\n b.size = newSize;\n\n setElementSize(a.element, a.size, pair[aGutterSize], a.i);\n setElementSize(b.element, b.size, pair[bGutterSize], b.i);\n }\n });\n }\n\n function destroy(preserveStyles, preserveGutter) {\n pairs.forEach(function (pair) {\n if (preserveGutter !== true) {\n pair.parent.removeChild(pair.gutter);\n } else {\n pair.gutter[removeEventListener](\n 'mousedown',\n pair[gutterStartDragging]\n );\n pair.gutter[removeEventListener](\n 'touchstart',\n pair[gutterStartDragging]\n );\n }\n\n if (preserveStyles !== true) {\n var style = elementStyle(\n dimension,\n pair.a.size,\n pair[aGutterSize]\n );\n\n Object.keys(style).forEach(function (prop) {\n elements[pair.a].element.style[prop] = '';\n elements[pair.b].element.style[prop] = '';\n });\n }\n });\n }\n\n if (isIE8) {\n return {\n setSizes: setSizes,\n destroy: destroy,\n }\n }\n\n return {\n setSizes: setSizes,\n getSizes: getSizes,\n collapse: function collapse(i) {\n adjustToMin(elements[i]);\n },\n destroy: destroy,\n parent: parent,\n pairs: pairs,\n }\n };\n\n return Split;\n\n})));\n" }, { "path": "docs/custom_theme/assets/style.css", "content": ".documentation {\n font-family: Helvetica, sans-serif;\n color: #666;\n line-height: 1.5;\n background: #f5f5f5;\n}\n\n.black {\n color: #666;\n}\n\n.bg-white {\n background-color: #fff;\n}\n\nh4 {\n margin: 20px 0 10px 0;\n}\n\n.documentation h3 {\n color: #000;\n}\n\n.border-bottom {\n border-color: #ddd;\n}\n\na {\n color: #1184ce;\n text-decoration: none;\n}\n\n.documentation a[href]:hover {\n text-decoration: underline;\n}\n\na:hover {\n cursor: pointer;\n}\n\n.py1-ul li {\n padding: 5px 0;\n}\n\n.max-height-100 {\n max-height: 100%;\n}\n\n.height-viewport-100 {\n height: 100vh;\n}\n\nsection:target h3 {\n font-weight: 700;\n}\n\n.documentation td,\n.documentation th {\n padding: 0.25rem 0.25rem;\n}\n\nh1:hover .anchorjs-link,\nh2:hover .anchorjs-link,\nh3:hover .anchorjs-link,\nh4:hover .anchorjs-link {\n opacity: 1;\n}\n\n.fix-3 {\n width: 25%;\n max-width: 244px;\n}\n\n.fix-3 {\n width: 25%;\n max-width: 244px;\n}\n\n@media (min-width: 52em) {\n .fix-margin-3 {\n margin-left: 25%;\n }\n}\n\n.pre,\npre,\ncode,\n.code {\n font-family: Source Code Pro, Menlo, Consolas, Liberation Mono, monospace;\n font-size: 14px;\n}\n\n.fill-light {\n background: #f9f9f9;\n}\n\n.width2 {\n width: 1rem;\n}\n\n.input {\n font-family: inherit;\n display: block;\n width: 100%;\n height: 2rem;\n padding: 0.5rem;\n margin-bottom: 1rem;\n border: 1px solid #ccc;\n font-size: 0.875rem;\n border-radius: 3px;\n box-sizing: border-box;\n}\n\ntable {\n border-collapse: collapse;\n}\n\n.prose table th,\n.prose table td {\n text-align: left;\n padding: 8px;\n border: 1px solid #ddd;\n}\n\n.prose table th:nth-child(1) {\n border-right: none;\n}\n.prose table th:nth-child(2) {\n border-left: none;\n}\n\n.prose table {\n border: 1px solid #ddd;\n}\n\n.prose-big {\n font-size: 18px;\n line-height: 30px;\n}\n\n.quiet {\n opacity: 0.7;\n}\n\n.minishadow {\n box-shadow: 2px 2px 10px #f3f3f3;\n}\n" }, { "path": "docs/custom_theme/index._", "content": "<!doctype html>\n<html lang=\"en\">\n<head>\n <meta charset='utf-8'>\n <title><%- config['project-name'] %> <%- config['project-version'] %> | Documentation<% if (config['project-description']) { %>\n '><% } %>\n \n \n \n \n <% if (config['favicon']) { %>\n ' rel='icon' ><% } %>\n\n\n
\n
\n
\n

<%- config['project-name'] %>

\n
<%- config['project-version'] %>
\n \n
\n
    \n <% docs.forEach(function(doc) { %>\n <% var hasMembers = doc.members.static.length || doc.members.instance.length %>\n
  • h5 bold black caps<% } %><% if (hasMembers) { %> toggle-sibling<% } %>\">\n <%- doc.name %>\n <% if (hasMembers) { %>▸<% } %>\n \n <% if (hasMembers) { %>\n \n <% } %>\n
    • \n <% }) %>\n
\n
\n
\n Need help reading this?\n
\n
\n
\n
\n <% docs.forEach(function(s) { %>\n <% if (s.kind === 'note' && !s.children) { %>\n
<%=renderNote({ note: s })%>
\n <% } else { %>\n <%= renderSection({\n section: s,\n renderSection: renderSection,\n renderSectionList: renderSectionList,\n renderParamProperty: renderParamProperty\n }) %>\n <% } %>\n <% }) %>\n
\n
\n \n \n \n\n\n" }, { "path": "docs/custom_theme/index.js", "content": "import fs from 'fs/promises'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\nimport template from 'lodash/template.js'\nimport GithubSlugger from 'github-slugger'\nimport hljs from 'highlight.js'\nimport { util } from '../../node_modules/documentation/src/index.js'\n\nconst __filename = fileURLToPath(import.meta.url)\nconst __dirname = path.dirname(__filename)\n\nconst { LinkerStack, createFormatters } = util\n\nasync function copyDir(sorce, dest) {\n await fs.mkdir(dest, { recursive: true })\n const entries = await fs.readdir(sorce, { withFileTypes: true })\n\n for (const entry of entries) {\n const srcPath = path.join(sorce, entry.name)\n const destPath = path.join(dest, entry.name)\n\n entry.isDirectory() ? await copyDir(srcPath, destPath) : await fs.copyFile(srcPath, destPath)\n }\n}\n\nfunction isFunction(section) {\n return section.kind === 'function' || (section.kind === 'typedef' && section.type && section.type.type === 'NameExpression' && section.type.name === 'Function')\n}\n\nconst slugger = new GithubSlugger()\nconst slugs = {}\n\nfunction getSlug(str) {\n if (slugs[str] === undefined) {\n slugs[str] = slugger.slug(str)\n }\n return slugs[str]\n}\n\nexport default async function (comments, config) {\n const linkerStack = new LinkerStack(config).namespaceResolver(comments, function (namespace) {\n return `#${getSlug(namespace)}`\n })\n\n const formatters = createFormatters(linkerStack.link)\n\n hljs.configure(config.hljs || {})\n\n const sharedImports = {\n imports: {\n slug(str) {\n return getSlug(str)\n },\n shortSignature(section) {\n let prefix = ''\n if (section.kind === 'class') {\n prefix = 'new '\n } else if (!isFunction(section)) {\n return section.name\n }\n return prefix + section.name + formatters.parameters(section, true)\n },\n signature(section) {\n let returns = ''\n let prefix = ''\n if (section.kind === 'class') {\n prefix = 'new '\n } else if (!isFunction(section)) {\n return section.name\n }\n if (section.returns.length) {\n returns = `: ${formatters.type(section.returns[0].type)}`\n }\n return prefix + section.name + formatters.parameters(section) + returns\n },\n md(ast, inline) {\n if (inline && ast && ast.children.length && ast.children[0].type === 'paragraph') {\n ast = {\n type: 'root',\n children: ast.children[0].children.concat(ast.children.slice(1)),\n }\n }\n return formatters.markdown(ast)\n },\n formatType: formatters.type,\n autolink: formatters.autolink,\n highlight(example) {\n if (config.hljs && config.hljs.highlightAuto) {\n return hljs.highlightAuto(example).value\n }\n return hljs.highlight(example, { language: 'js' }).value\n },\n },\n }\n\n sharedImports.imports.renderSectionList = template(await fs.readFile(path.join(__dirname, 'section_list._'), 'utf8'), sharedImports)\n sharedImports.imports.renderSection = template(await fs.readFile(path.join(__dirname, 'section._'), 'utf8'), sharedImports)\n sharedImports.imports.renderNote = template(await fs.readFile(path.join(__dirname, 'note._'), 'utf8'), sharedImports)\n sharedImports.imports.renderParamProperty = template(await fs.readFile(path.join(__dirname, 'paramProperty._'), 'utf8'), sharedImports)\n\n const pageTemplate = template(await fs.readFile(path.join(__dirname, 'index._'), 'utf8'), sharedImports)\n\n const string = pageTemplate({ docs: comments, config })\n\n if (!config.output) {\n return string\n }\n\n await copyDir(`${__dirname}/assets/`, `${config.output}/assets/`)\n await fs.writeFile(`${config.output}/index.html`, string, 'utf8')\n}\n" }, { "path": "docs/custom_theme/note._", "content": "
\n\n

\n <%- note.name %>\n

\n\n <% if (note.description) { %>\n <%= md(note.description) %>\n <% } %>\n
" }, { "path": "docs/custom_theme/paramProperty._", "content": "\n <%- property.name %> <%= formatType(property.type) %>\n <% if (property.default) { %>\n (default <%- property.default %>)\n <% } %>\n <%= md(property.description, true) %>\n\n<% if(property.properties && property.properties.length) { %>\n <% property.properties.forEach(function(childProperty) { %>\n <%= renderParamProperty({\n property: childProperty,\n renderParamProperty: renderParamProperty\n }) %>\n <% }) %>\n<% } %>\n" }, { "path": "docs/custom_theme/section._", "content": "
\n\n <% if (typeof nested === 'undefined' || (section.context && section.context.github)) { %>\n
\n <% if (typeof nested === 'undefined') { %>\n

\n <%- section.name %>\n

\n <% } %>\n <% if (section.context && section.context.github) { %>\n \n <%= section.context.github.path %>\n \n <% } %>\n
\n <% } %>\n\n <%= md(section.description) %>\n
<%= signature(section) %>
\n <% if (section.type) { %>\n

\n Type:\n <%= formatType(section.type) %>\n

\n <% } %>\n <% if (section.augments && section.augments.length) { %>\n

\n Extends\n <% if (section.augments) { %>\n <%= section.augments.map(function(tag) {\n\t return autolink(tag.name);\n\t}).join(', ') %>\n <% } %>\n

\n <% } %>\n\n <% if (section.deprecated) { %>
Deprecated: <%= md(section.deprecated, true) %>
<% }%>\n <% if (section.version) { %>
Version: <%- section.version %>
<% }%>\n <% if (section.license) { %>
License: <%- section.license %>
<% }%>\n <% if (section.author) { %>
Author: <%- section.author %>
<% }%>\n <% if (section.copyright) { %>
Copyright: <%= md(section.copyright, true) %>
<% }%>\n <% if (section.since) { %>
Since: <%- section.since %>
<% }%>\n\n <% if (section.params && section.params.length) { %>\n
Parameters
\n
\n <% section.params.forEach(function(param) { %>\n
\n
\n <%- param.name%> (<%= formatType(param.type) %><% if (param.default) { %>\n = <%- param.default %><% } %>)\n\t <%= md(param.description, true) %>\n
\n <% if (param.properties && param.properties.length) { %>\n \n \n \n \n \n \n \n \n \n \n \n \n <% param.properties.forEach(function(property) { %>\n <%= renderParamProperty({\n property: property,\n renderParamProperty: renderParamProperty\n }) %>\n <% }) %>\n \n
NameDescription
\n <% } %>\n
\n <% }) %>\n
\n <% } %>\n\n <% if (section.properties && section.properties.length) { %>\n
Properties
\n
\n <% section.properties.forEach(function(property) { %>\n
\n <%- property.name%> (<%= formatType(property.type) %>)\n <% if (property.default) { %>\n (default <%- property.default %>)\n <% } %><% if (property.description) {\n\t %>: <%= md(property.description, true) %><%\n\t } %>\n <% if (property.properties && property.properties.length) { %>\n
    \n <% property.properties.forEach(function(property) { %>\n
  • <%- property.name %> <%= formatType(property.type) %>\n <% if (property.default) { %>\n (default <%- property.default %>)\n <% } %>\n <%= md(property.description) %>
    • \n <% }) %>\n
\n <% } %>\n
\n <% }) %>\n
\n <% } %>\n\n <% if (section.returns && section.returns.length) { %>\n <% section.returns.forEach(function(ret) { %>\n
Returns
\n <%= formatType(ret.type) %><% if (ret.description) { %>:\n <%= md(ret.description, true) %>\n <% }%>\n <% }) %>\n <% } %>\n\n <% if (section.sees && section.sees.length) { %>\n
Related
\n <% section.sees.forEach(function(see) { %>\n <% if (see.description) { %>\n <%= md(see.description, true) %>\n <% }%>\n <% }) %>\n <% } %>\n\n <% if (section.throws && section.throws.length) { %>\n
Throws
\n
    \n <% section.throws.forEach(function(throws) { %>\n
  • <%= formatType(throws.type) %>: <%= md(throws.description, true) %>
    • \n <% }); %>\n
\n <% } %>\n\n <% if (section.examples && section.examples.length) { %>\n
Example
\n <% section.examples.forEach(function(example) { %>\n <% if (example.caption) { %>

<%= md(example.caption) %>

<% } %>\n 
<%= highlight(example.description) %>
\n <% }) %>\n <% } %>\n\n <% if (section.members.static && section.members.static.length) { %>\n
Static Members
\n <%= renderSectionList({ members: section.members.static, renderSection: renderSection, renderParamProperty: renderParamProperty, noun: 'Static Member' }) %>\n <% } %>\n\n <% if (section.members.instance && section.members.instance.length) { %>\n
Instance Members
\n <%= renderSectionList({ members: section.members.instance, renderSection: renderSection, renderParamProperty: renderParamProperty, noun: 'Instance Member' }) %>\n <% } %>\n\n <% if (section.members.inner && section.members.inner.length) { %>\n
Inner Members
\n <%= renderSectionList({ members: section.members.inner, renderSection: renderSection, renderParamProperty: renderParamProperty, noun: 'Inner Member' }) %>\n <% } %>\n\n <% if (section.members.events && section.members.events.length) { %>\n
Events
\n <%= renderSectionList({ members: section.members.events, renderSection: renderSection, renderParamProperty: renderParamProperty, noun: 'Event' }) %>\n <% } %>\n\n
\n <% const fna = section.context.file.split(\"/\") %>\n
Source File
\n 
<%- fna[fna.length-1] %>
\n
\n \n
\n" }, { "path": "docs/custom_theme/section_list._", "content": "
\n <% members.forEach(function(member) { %>\n
\n
\n
\n ▸\n <%= shortSignature(member) %>\n
\n
\n
\n <%= renderSection({\n section: member,\n renderSection: renderSection,\n renderParamProperty: renderParamProperty,\n \t nested: true\n }) %>\n
\n
\n <% }) %>\n
\n" }, { "path": "docs/documentation.cfg.json", "content": "{\n \"noPackage\": true,\n \"project-name\":\"NotePlan API+@helpers shared files\",\n \"project-homepage\": \"https://help.noteplan.co/article/70-javascript-plugin-api\",\n \"project-version\": \"1.0.0\",\n \"project-description\": \"An attempt to help find @helper functions\",\n \"sort-order\":\"alpha\"\n}\n" }, { "path": "dwertheimer.DateAutomations/README.md", "content": "# DateAutomations\nDateAutomations includes a number of commands for inserting date/time values into your NotePlan notes\n\n## Commands\n\n### /dp - Date Picker - Choose format/date from Command Bar\nTRY THIS FIRST! Choose from a variety of date/time formats from a menu. This also shows you in parentheses the dateStyle and timeStyle to yield this result (which you could enter into your Template plugin date defaults). This is also a good way to see what you want some of your settings to be.\nNote: uses `locale` from settings as a base and provides lots of variations\n\n### /ldn - Link Daily Note\ne.g. [[2022-04-16]]\nCreate a link to the daily Calendar Note and insert it at the cursor\n\n### /now - Insert date and time at cursor\ne.g. `6/19/2021 06:55:22` \nNote: uses `dateStyle`, `timeStyle`, `locale` from settings; run `/dp` command to see your options\n\n### /now - ISO-8601 standard -- Insert ISO-8601 date+time at cursor\ne.g. `2021-08-06 17:20`\nNote: does not use any settings. If you want another format, use `/formatted` command and setting.\n\n### /date - Insert Date at cursor\ne.g. `6/19/2021` \nNote: uses `locale` in plugin settings; run `/dp` command to see your options\n\n### /time - Insert time at cursor\ne.g. `06:55:22` \nNote: uses `timeStyle`, `locale`, `use12hour` from settings; run `/dp` command to see your options\n\n### /iso - Insert ISO date/time at cursor\ne.g. `6/19/2021T18:55:46.101Z` (date/time is in GMT)\n\n### /formatted - Insert custom formatted (format) date/time\ne.g. `2021-08-14 10:30:00 am` \nNote: uses `format` from settings. See for details on the formatting codes\n\n### /wd (insertWeekDates)\ne.g. Mon 2022-04-11 - Sun 2022-04-17\nNote: currently cannot be customized. If you desperately need it to be customizable, let @dwertheimer know in Discord. However, know that you can use the Templating plugin and create a template to insert your custom date.\n\n## Notes Regarding Date/Time Formats\n- By default, the format of dates and times is \"en-US\" format.\n- By default, the `/formatted` command uses `%Y-%m-%d %I:%M:%S %P` (see `Templates` use below)\n\n*Note: You can create your own formats in templates installing the `Templating` plugin and [following the directions](https://noteplan.co/templates/docsdocs/templating-modules/date-module)*\n\nIf you install this plugin and run `/dp` command, you will get some ideas for dateStyle and timeStyle settings\n\n## References\nThe following are some useful references which provide more information about formatting date/time values\n\n[Formatting Dates Using strftime](https://www.strfti.me/) for more information about formatting `formatted` date/time value\n\n[Date Time Formats](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat) for more choices/details\n" }, { "path": "dwertheimer.DateAutomations/changelog.md", "content": "# dwertheimer.DatAutomations Changelog\n\n## Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [1.3.3] - 2024-04-26 (@dwertheimer)\n\n- bump just to re-release same plugin\n\n## [1.3.2] 2022-05-17 @dwertheimer (thx to @mattcito)\n- Fix en-GB in settings instructions\n\n## [1.3.1] 2022-04-16 @dwertheimer (thx to @oschrenk)\n- Fixed bug in /now-8601 (wasn't showing the time)\n- Added more to the readme\n\n## [1.3.0] 2022-04-15 @dwertheimer (thx to @oschrenk)\n- Removed reliance on _configuration file\n- Added plugin-specific settings\n\n## [1.2.0] - 2021-09-03 (dwertheimer) added date8601 back in for templates -- got dropped along the way\n\n## [1.1.1] - 2021-08-22 (mikeerickson)\n\n### Fixed\n- fixed `/formatted` direct call, was forcing default instead of using `_configuration`\n\n## [1.1.0] - 2021-08-21 (mikeerickson)\n\n### Added\n- Added `formatted` option (using /formatted) and selecting `formatted` from `/dp` choice\n\n## 1.0.9 Now compiled for macOS versions back to 10.13.0.\n\n## 1.0.1 Removing \"macOS.minVersion\" - no longer necessary with transpiling\n\n## 1.0.0 Adding /now - ISO 8601 standard\n Fix bug in /time\n\n## 0.0.2 Adding \t\"macOS.minVersion\": \"10.15.7\"\n\n## 0.0.1 Initial version\n" }, { "path": "dwertheimer.DateAutomations/plugin.json", "content": "{\n \"noteplan.minAppVersion\": \"3.3.2\",\n \"macOS.minVersion\": \"10.13.0\",\n \"plugin.id\": \"dwertheimer.DateAutomations\",\n \"plugin.name\": \"📅 Date Automations\",\n \"plugin.description\": \"Helping you move faster with dates and times\",\n \"plugin.author\": \"David Wertheimer\",\n \"plugin.url\": \"https://github.com/NotePlan/plugins/blob/main/dwertheimer.DateAutomations/README.md\",\n \"plugin.version\": \"1.3.3\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.commands\": [\n {\n \"name\": \"ldn\",\n \"description\": \"Create link to today's Calendar Note at cursor (e.g. [[2022-04-16]])\",\n \"jsFunction\": \"insertCalendarNoteLink\"\n },\n {\n \"name\": \"date\",\n \"description\": \"Insert date (without time) at cursor (uses your locale setting), e.g. Saturday, April 16, 2022 (or shorter)\",\n \"jsFunction\": \"insertDate\"\n },\n {\n \"name\": \"iso\",\n \"description\": \"Insert date+time (in ISO format, GMT) at cursor, e.g. 2022-04-16T17:28:14.662Z\",\n \"jsFunction\": \"insertISODate\"\n },\n {\n \"name\": \"now\",\n \"description\": \"Insert (human readable) date+time at cursor, e.g. Saturday, April 16, 2022, 13:29\",\n \"jsFunction\": \"insertDateTime\"\n },\n {\n \"name\": \"now - ISO-8601 standard\",\n \"description\": \"Insert ISO-8601 date+time at cursor, e.g. 2021-08-06 17:20\",\n \"jsFunction\": \"insertDateTime8601\",\n \"alias\": [\n \"date\",\n \"8601\",\n \"t\"\n ]\n },\n {\n \"name\": \"time\",\n \"description\": \"Insert (human readable) time at cursor, e.g. 06:55:22\",\n \"jsFunction\": \"insertTime\"\n },\n {\n \"name\": \"dp\",\n \"description\": \"(Date Picker) Choose format and insert date/time time at cursor\",\n \"jsFunction\": \"dateFormatPicker\",\n \"alias\": [\n \"locale\"\n ]\n },\n {\n \"name\": \"formatted\",\n \"description\": \"Insert custom formatted (format) date/time per your settings\",\n \"jsFunction\": \"insertStrftime\",\n \"alias\": [\n \"strftime\"\n ]\n },\n {\n \"name\": \"wd\",\n \"description\": \"Insert dates of current week, e.g. Mon 2022-04-11 - Sun 2022-04-17\",\n \"jsFunction\": \"insertWeekDates\",\n \"alias\": [\n \"weekDates\",\n \"week\"\n ]\n },\n {\n \"name\": \"date8601\",\n \"description\": \"Inserts current date in 8601 format\",\n \"jsFunction\": \"get8601String\",\n \"hidden\": true\n },\n {\n \"name\": \"getWeekDates\",\n \"description\": \"Inserts week dates using supplied format\",\n \"jsFunction\": \"getWeekDates\",\n \"hidden\": true\n }\n ],\n \"plugin.settings\": [\n {\n \"type\": \"string\",\n \"key\": \"format\",\n \"title\": \"Custom Time String Format\",\n \"description\": \"Used in /formatted command. See https://www.strfti.me/ for details on the formatting codes\",\n \"default\": \"%Y-%m-%d %H:%M\",\n \"required\": true\n },\n {\n \"type\": \"string\",\n \"key\": \"locale\",\n \"title\": \"Time/Date Locale Setting\",\n \"description\": \"Geographic locale for date/time formatting. e.g. en-US, en-GB, etc. e.g. en-US will result in mm/dd/yyyy, while en-GB will be dd/mm/yyyy. See https://www.ibm.com/docs/en/datacap/9.1.8?topic=support-supported-language-codes for a list of available locales.\",\n \"default\": \"en-US\",\n \"required\": true\n },\n {\n \"type\": \"string\",\n \"key\": \"dateStyle\",\n \"title\": \"Date Style (in your locale)\",\n \"description\": \"Used in commands like /now, /time, etc. Can be 'short', 'medium', 'long' or 'full'. Run the /dp command for help choosing the setting you want.\",\n \"default\": \"full\",\n \"required\": true\n },\n {\n \"type\": \"string\",\n \"key\": \"timeStyle\",\n \"title\": \"Time Style (in your locale)\",\n \"description\": \"Used in commands like /now, /time, etc. Can be 'short', 'medium', 'long' or 'full'. Run the /dp command for help choosing the setting you want.\",\n \"default\": \"short\",\n \"required\": true\n },\n {\n \"type\": \"bool\",\n \"key\": \"hour12\",\n \"title\": \"Use 12 hour format (with AM/PM)\",\n \"description\": \"You can force 24 hour time format on/off, even in America!\",\n \"default\": false,\n \"required\": true\n },\n {\n \"type\": \"string\",\n \"key\": \"timezone\",\n \"title\": \"Timezone Override\",\n \"description\": \"Usually 'automatic' is fine (will get timezone from your system).\",\n \"default\": \"automatic\",\n \"required\": true\n }\n ]\n}" }, { "path": "dwertheimer.DateAutomations/src/dateFunctions.js", "content": "// @noflow\n// TODO: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat\n\nimport strftime from 'strftime'\nimport { format as dateFormat, startOfWeek, endOfWeek } from 'date-fns'\nimport { hyphenatedDateString, getFormattedTime } from '../../helpers/dateTime'\nimport { getTagParamsFromString } from '../../helpers/general'\nimport { showMessage } from '../../helpers/userInput'\n\ntype DateConfig = $ReadOnly<{\n timezone: string,\n locale: string,\n dateStyle?: string,\n timeStyle?: string,\n hour12?: boolean,\n format?: string,\n ...\n}>\n// This is a function that verifies that an object is of the type\n// DateConfig. If it is, it returns an object with the correct type\n// If it's not, it returns undefined.\nfunction asDateConfig(obj: mixed): ?DateConfig {\n if (typeof obj === 'object' && obj != null && typeof obj.timezone === 'string' && typeof obj.locale === 'string') {\n const { format, timezone, locale, dateStyle, timeStyle, hour12, ...other } = obj\n return {\n ...other,\n timezone,\n locale,\n format: typeof format === 'string' ? format : undefined,\n dateStyle: typeof dateStyle === 'string' ? dateStyle : undefined,\n timeStyle: typeof timeStyle === 'string' ? timeStyle : undefined,\n hour12: typeof hour12 === 'boolean' ? hour12 : undefined,\n }\n }\n}\n\nfunction getDateConfig(): DateConfig {\n const config = DataStore.settings\n const dateConfig = asDateConfig(config)\n if (dateConfig) {\n return dateConfig\n } else {\n return {\n // Default timezone for date and time.\n timezone: 'automatic',\n // Default locale to format date and time.\n // e.g. en-US will result in mm/dd/yyyy, while en_GB will be dd/mm/yyyy\n locale: 'en-US',\n // can be \"short\", \"medium\", \"long\" or \"full\"\n dateStyle: 'full',\n // optional key, can be \"short\", \"medium\", \"long\" or \"full\"\n timeStyle: 'short',\n // can force 24 hour time format, even in america!\n hour12: true,\n // custom format using strftime\n format: '%Y-%m-%d %I:%M:%S %P',\n }\n }\n}\n\n/**\n * Create a list of options for combinations of date & time formats\n * @returns [{allDateOptions}] props: dateStyle, timeStyle, label, text (to be inserted if chosen)\n */\nfunction getFormattedDateTime() {\n // pull options and create options for various dateStyles and timeStyles\n const dateConfig = getDateConfig()\n const dateStyles = ['short', 'medium', 'long'] // pulling out 'full' for now\n const timeStyles = ['', 'short', 'medium', 'long'] // pulling out 'full' for now\n const hour12 = [false, true]\n\n const format = dateConfig?.format ? dateConfig.format : '%Y-%m-%d %I:%M:%S %P'\n\n // Pluck all values except `dateStyle` and `timeStyle`\n // eslint-disable-next-line no-unused-vars\n const { dateStyle: _1, timeStyle: _2, ...config } = { ...dateConfig }\n\n // Get user default locale\n const locales = []\n locales.push((dateConfig && dateConfig.locale) || 'en-US')\n // if (dateConfig.locale !== 'sv-SE') locales.push('sv-SE')\n const str8601 = get8601String()\n\n const formatted = strftime(format)\n\n const options = [\n {\n dateStyle: 'formatted',\n timeStyle: '',\n label: `${formatted} (formatted date/time)`,\n text: formatted,\n },\n {\n dateStyle: 'sv-SE',\n timeStyle: 'medium',\n label: `${str8601} (sv-SE,short,medium,[not set])`,\n text: `${str8601}`,\n },\n ]\n locales.forEach((loc) => {\n dateStyles.forEach((ds) =>\n timeStyles.forEach((ts) => {\n hour12.forEach((h12) => {\n // conditionall add those keys to config\n if (ds !== '') {\n // Ignore type error for now\n // $FlowFixMe\n config.dateStyle = ds\n }\n if (ts !== '') {\n // $FlowFixMe\n config.timeStyle = ts\n }\n config.hour12 = h12\n\n const text = new Intl.DateTimeFormat(\n loc,\n // $FlowFixMe\n config,\n ).format()\n\n options.push({\n dateStyle: ds !== '' ? ds : null,\n timeStyle: ts !== '' ? ds : null,\n label: `${text} (${loc}/${ds ? ds : '[not set]'}/${ts ? ts : '[not-set]'}/${String(h12)})`,\n text: `${text}`,\n })\n })\n }),\n )\n })\n\n return options\n}\n\n// /iso\nexport function insertISODate() {\n const nowISO = new Date().toISOString()\n Editor.insertTextAtCursor(nowISO)\n}\n\n// /date\nexport function insertDate() {\n // eslint-disable-next-line no-unused-vars\n const { timeStyle: _, ...dateConfig } = getDateConfig()\n const dateText = new Intl.DateTimeFormat(dateConfig.locale, dateConfig).format()\n Editor.insertTextAtCursor(dateText)\n}\n\n// /now\nexport function insertDateTime() {\n const _dateConfig = getDateConfig()\n const dateConfig = {\n ..._dateConfig,\n dateStyle: _dateConfig.dateStyle ?? 'full',\n timeStyle: _dateConfig.timeStyle ?? 'short',\n }\n const dateText = new Intl.DateTimeFormat(dateConfig.locale, dateConfig).format()\n Editor.insertTextAtCursor(`${dateText}`)\n}\n\nexport function get8601String(): string {\n return strftime(`%Y-%m-%d`)\n}\n\n// /now\nexport function insertDateTime8601() {\n Editor.insertTextAtCursor(`${strftime(`%Y-%m-%d %H:%M`)}`)\n}\n\n// /time\nexport function insertTime() {\n // eslint-disable-next-line no-unused-vars\n const { dateStyle: _, ...dateConfig } = getDateConfig()\n const editableConfig = { ...dateConfig }\n if (!editableConfig.timeStyle) editableConfig.timeStyle = 'medium'\n\n const timeText = new Intl.DateTimeFormat(dateConfig.locale, editableConfig).format()\n Editor.insertTextAtCursor(timeText)\n}\n\n// /ldn\nexport function insertCalendarNoteLink() {\n Editor.insertTextAtCursor(`[[${hyphenatedDateString(new Date())}]]`)\n}\n\n// /dp\nexport async function dateFormatPicker() {\n const dateChoices = getFormattedDateTime()\n\n const re = await CommandBar.showOptions(\n dateChoices.map((d) => d.label),\n 'Choose format (locale/dateStyle/timeStyle/hour12)',\n )\n Editor.insertTextAtCursor(dateChoices[re.index].text)\n}\n\n// /formatted\nexport function insertStrftime() {\n const dateConfig = DataStore.settings\n const format = dateConfig?.format ? dateConfig.format : '%Y-%m-%d %I:%M:%S %P'\n const strftimeFormatted = strftime(format)\n Editor.insertTextAtCursor(strftimeFormatted)\n}\n\nexport async function formattedDateTimeTemplate(paramStr: string = ''): Promise {\n let retVal = ''\n if (paramStr === '') {\n retVal = getFormattedTime() // default\n } else {\n const format = await getTagParamsFromString(paramStr, 'format', '')\n retVal = getFormattedTime(format ? String(format) : undefined)\n }\n return retVal\n}\n\n//TODO FIXME: figure out formats and locales - WIP because the startMondy doesn't work\n// {weekStartsOn:1, format:`'EEE yyyy-MM-dd'} // see [date-fns format](https://date-fns.org/v2.23.0/docs/format)\nexport async function getWeekDates(paramStr: string = ''): Promise {\n const weekStartsOn = Number(await getTagParamsFromString(paramStr, 'weekStartsOn', 1))\n const format = String(await getTagParamsFromString(paramStr, 'format', 'EEE yyyy-MM-dd'))\n // $FlowFixme complains about number literals even though I am checking them as numbers in arange\n if (weekStartsOn >= 0 && weekStartsOn <= 6) {\n // $FlowIgnore\n console.log(dateFormat(new Date(startOfWeek(new Date(), { weekStartsOn: weekStartsOn })), 'yyyy-MM-dd'))\n // $FlowIgnore\n const start = dateFormat(new Date(startOfWeek(new Date(), { weekStartsOn: weekStartsOn })), format)\n // $FlowIgnore\n const end = dateFormat(new Date(endOfWeek(new Date(), { weekStartsOn: weekStartsOn })), format)\n return `${start} - ${end}`\n } else {\n showMessage('Error in your format string')\n return ''\n }\n}\n\nexport async function insertWeekDates() {\n await Editor.insertTextAtCursor(await getWeekDates())\n}\n" }, { "path": "dwertheimer.DateAutomations/src/index.js", "content": "// @flow\nimport pluginJson from '../plugin.json'\nimport { updateSettingData } from '../../helpers/NPConfiguration'\n\nexport { insertDate } from './dateFunctions'\nexport { insertDateTime } from './dateFunctions'\nexport { insertDateTime8601 } from './dateFunctions'\nexport { insertISODate } from './dateFunctions'\nexport { insertCalendarNoteLink } from './dateFunctions'\nexport { insertTime } from './dateFunctions'\nexport { dateFormatPicker } from './dateFunctions'\nexport { insertStrftime } from './dateFunctions'\nexport { insertWeekDates } from './dateFunctions'\n\nexport { get8601String, getWeekDates } from './dateFunctions'\n\nconst PLUGIN_ID = 'date' // the key that's used in _configuration note\nexport async function onUpdateOrInstall(config: any = { silent: false }): Promise {\n try {\n console.log(`${PLUGIN_ID}: onUpdateOrInstall running`)\n const updateSettings = updateSettingData(pluginJson)\n console.log(`${PLUGIN_ID}: onUpdateOrInstall updateSettingData code: ${updateSettings}`)\n } catch (error) {\n console.log(error)\n }\n console.log(`${PLUGIN_ID}: onUpdateOrInstall finished`)\n}\n" }, { "path": "dwertheimer.EventAutomations/CHANGELOG.md", "content": "# AutoTimeBlocking Change Log\n\nREADME: [How to use AutoTimeBlocking](https://noteplan.co/n/#/1EF12392-B544-4044-AC7A-428F57EB2DFC)\n\n## What's New in AutoTimeBlocking\n\n## [1.22.0] 2025-11-29 @dwertheimer\n- Add setting to leave completed timeblocks in the note for posterity (thx @DrawingTheSun https://discord.com/channels/763107030223290449/1111377061148368968/1443638522954383402)\n\n## [1.21.2] 2025-08-08 @dwertheimer\n- Fix with changes in trigger logic\n- Minor change to heading logic\n- Don't quote triggers in frontmatter\n- Fixed bug where adding trigger adds extra lines to top of note (using Editor.frontmatterAttributes setter)\n- Fixed bug in helpers/NPnote.js getReferencedParagraphs where it was not including tasks with headings\n- Fixed bug where timeblockTextMustContainString was being doubled up in the TB line, keeping the checkboxes from working properly\n\n## [1.21.0] 2024-05-26 @dwertheimer\n\n- added MANUAL_ORDERING mode (for @Thor)\n\n## [1.20.0] 2024-02-23 @dwertheimer - thx @Werwowolf\n\n- Feature: add named timeframes in settings (e.g. \"morning\", \"early\", \"afternoon\") and a task tagged with #afternoon will get placed there\n- Sort todos by priority then date (oldest to newest), then duration\n- Do not include backlinks which are not todos as todos\n\n## [1.19.1] 2024-02-14 @dwertheimer\n\n- Remove calendar writing in /atb (now that it is included in NP)\n- Allow any character (e.g. emoji) to be your TB char (used to be #hashtag something only)\n- Fix: Remove synced blockId from \"No time available\" line\n\n## [1.18.3] 2024-02-02 @dwertheimer\n\n- Added ability for BY_TIMEBLOCK_TAG to work for multiple sessions in a day of the same name, e.g. HighEnergy. Thx @Crambeary\n- Fix /atb to work with NP's new auto-writing Timeblocks to Calendar\n\n## [1.18.2] 2024-02-01 @dwertheimer\n\n- Added more logging to help find a bug\n\n## [1.18.1] 2024-01-04 @dwertheimer\n\n- Update language around Synced Copies preference (thanks @dutcheness)\n- Fix bug where synced copies didn't write if the Editor was not saved yet\n\n\n## [1.18.0] 2023-10-16 @dwertheimer\n\n- Add Named Timeblocks Mode (BY_TIMEBLOCK_TAG mode)\n- Minor calendar event improvement to deal with \"today\" and \"tomorrow\" text better in event creation\n\n\n## [1.17.3] 2023-10-11 @dwertheimer\n\n- EventBlocks: minor change to xcallback support]\n## [1.17.2] 2023-09-16 @dwertheimer\n\n- EventBlocks - work around NP limitation that doesn't process \"today at 5pm\" correctly\n\n## [1.17.1] 2023-09-06 @dwertheimer 2023-09-06\n\n- Add argument for heading to put it under\n\n## [1.17.0] 2023-09-06 @dwertheimer 2023-09-06\n\n- Add interactive plugin settings for iOS\n- Added /pevt command for creating a single task using natural language\n\n## [1.16.3] 2023-08-24\n\n- Fix bug where synced lines in today's note were not being timeblocked. Thx @tiffsunbacon\n\n## [1.16.2] 2023-07-13\n\n- Fix bug in non-ATB timeblocks getting deleted\n- Allow time to be '1hr or '5min instead of just \"h\" and \"m\"\n\n## [1.16.1] 2023-07-05 @dwertheimer\n\n- bump to chase onSettingsUpdated NP bug\n\n## [1.16.0] 2023-07-05 @dwertheimer\n\n- Create Tasks within named Timeblocks (e.g. #home) - aka BY_TIMEBLOCK_TAG mode (see the README ^^^)\n- Change Plugin Name to AutoTimeBlocking/Events\n- Add output/notification for tasks that were unable to fit\n\n## [1.15.1] 2023-04-20\n\n- Fix bug in tasks open in today's note.\n\n## [1.15.0] 2023-01-18 @dwertheimer\n\n- Added new preference: when using checklist (+) for your timeblocks, checking the timeblock will find and check the original item\n\n## [1.14.0] 2023-01-17 @dwertheimer\n\n- Checklist support for todo char\n\n## [1.13.5] 2022-12-13 @dwertheimer\n\n- Suppress dialog when no synced tasks to output\n\n## [1.13.4] - 2022-12-08 @dwertheimer\n\n- Fix nasty bug when prefs fields were empty (was deleting all lines in a note). Thx @akra5ia\n\n## [1.13.1] - 2022-11-26 @dwertheimer\n\n- Fix bug when timeblock character is a todo (duplicating time blocks)\n- Change default synced copies title to be the link to run it again\n\n## [1.13.0] - 2022-11-11 @dwertheimer\n\n- Added undocumented feature for a template to remove previous days paragraphs under any heading (dbw using to remove \"Daily Recurring Tasks\" after the day has passed)\n\n## [1.12.0] - TBD @dwertheimer\n\n- Added /mdatb - Mark Done and run ATB command\n\n## [1.11.0] - 2022-10-28 @dwertheimer\n\n- Added setting to create timeblocks for undated tasks in today's note\n- Added line-level links to tasks from timeblocks\n\n## [1.10.4] - 2022-10-19 @dwertheimer\n\n- Minor fix to ignore calendar items which are marked as \"free\" time in Google calendar\n\n## [1.10.3] - 2022-09-29 @dwertheimer\n\n- Bug fix to keep today todos from becoming synced copies\n\n## [1.10.2] - 2022-09-07 @dwertheimer\n\n- Name change (back to EventAutomations) and code clean up\n\n## [1.10.1] - 2022-09-07 @dwertheimer\n\n- Fixed minor bug: datePlusOpenOnly setting missing\n\n## [1.10.0] - 2022-09-02 @dwertheimer\n\n- Moved >date+ functionality to TaskAutomations plugin (and expanded it)\n\n## [1.9.0] - 2022-09-01 @dwertheimer\n\n- Added ability to convert all overdue tasks to >today tasks (when preference setting is off)\n\n## [1.8.0] - 2022-08-22 @dwertheimer\n\n- Ask for calendar selection in Event Blocks Creation\n- Work around all-day event bug in CalendarItem API\n\n## [1.7.0] 2022-08-04 @dwertheimer\n\n- Event Blocks: Added temporary display of start time for event\n- Fix bug where last event wasn't picked up\n\n## [1.6.0] 2022-07-21 @dwertheimer\n\n- Added Create Events from Text Block capability (/cevt - Create Events from Text)\n- Added Log Level Settings in Preferences\n- Renamed plugin to AutoTimeBlocking & Event Automations\n\n## [1.5.0] 2022-07-21 @dwertheimer\n\n- Added Log Level Settings in Preferences\n\n## [1.4.0] 2022-07-03 @dwertheimer\n\n- added command \"/Update >date+ tags in Notes\" (including foldersToIgnore config setting)\n- added autoupdater code\n- change default TimeBlocks heading to the \"button\" [Time Blocks](noteplan://runPlugin?pluginID=dwertheimer.EventAutomations&command=atb%20-%20Create%20AutoTimeBlocks%20for%20%3Etoday%27s%20Tasks)\n\n## [1.3.4] 2022-06-24 @dwertheimer\n\n- Fix race condition calling DataStore.preference too many times quickly on \"Remove All Previous...\" commands\n\n## [1.3.3] 2022-06-23 @dwertheimer\n\n- Add check for pre-existing timeblocks including the \"mustInclude\" string (thx @jgclark)\n\n## [1.3.2] 2022-06-21 @dwertheimer\n\n- Fix calendar changeover (00:00) bug\n\n## [1.3.0] 2022-06-21 @dwertheimer\n\n- Added cleanup commands:\n - Remove Synced Todos for Open Calendar Note\n - Remove Time Blocks for Open Calendar Note\n - Remove All Previous Synced Copies Written by this Plugin\n\n## [1.2.1] 2022-07-10 @dwertheimer\n\n- Remove the requirement for Synced lines to run only on today's note (@Stacey's suggestion)\n\n- added: added command \"/Insert Synced Today Todos at Cursor\" to add synced lines without timeblocks\n\n## [1.2.0] 2022-07-10 @dwertheimer\n\n- added: added command \"/Insert Synced Today Todos at Cursor\" to add synced lines without timeblocks\n- changed plugin name to \"AutoTimeBlocking & Synced Today Todos\"\n\n## [1.1.6] 2022-07-10 @dwertheimer\n\n- fix: added loading screen during delete/add events to calendar\n\n## [1.1.5] 2022-07-10 @dwertheimer\n\n- fix: made TB tag addition more robust\n\n## [1.1.4] 2022-07-10 @dwertheimer\n\n- fix: pull timeblock string from prefs (DataStore.preference(\"timeblockTextMustContainString\")) and append it\n \n## [1.1.3] 2022-07-10 @dwertheimer\n\n- fix: read calendar name after it gets changed by user\n\n## [1.1.2] 2022-07-09 @dwertheimer\n\n- fix: crasher bug in removing items from calendar\n\n## [1.1.1] 2022-07-09 @dwertheimer\n\n- fixed bug found by @atlgc where same text in diff files wouldn't create synced line\n\n## [1.1.0] 2022-05-26 @dwertheimer\n\n- added duplicate removal to eliminate multiple copies of synced lines + tests\n- added folding using API\n- improved messaging for when /ATB encounters nothing\n\n## [1.0.0] 2022-05-18 @dwertheimer\n\n- added config setting for write synced copy\n- moving to 1.0.0 release because /atb has been stable\n\n[0.6.0] 2022-05-06\n\n- remove event note creation functions (they have been superseded by NotePlan Event Templates)\n- fix bug that is finding embedded event links and treating them like timeblocks\n\n[0.5.3] 2022-04-02\n\n- fix bug in task exclusion patterns (thx @lt#0807)\n\n[0.5.2] 2022-03-17\n\n- fix done task still showing up (thx @pan)\n\n[0.5.1] 2022-03-15\n\n- add support for items in today's note which are not tasks\n- remove a slew of console.logs\n\n[0.5.0] 2022-03-12\n\n- add setting for appending link to task note\n\n[0.4.7] 2022-02-18\n\n- changed default timeblock line to \"-\" from \"*\"\n\n[0.4.6] 2022-02-18\n\n- fixing editor open bug\n\n[0.4.5] 2022-02-04\n\n- refactor calendar code under the hood + Eduard fixed some underlying migration code\n\n[0.4.4] 2022-02-04\n\n- add configuration migration\n\n[0.4.3]\n\n- change config to make includeTasksWithText etc. not required\n\n[0.4.2] 2022-01-02 @dwertheimer (in response to great feedback from @stacey)\n\n- change default config to allow for timeblocks all day long (no workDay[Start/End]) sections]\n- change preset to do the opposite (allow for workday)\n\n[0.4.0] 2021-12-25 @dwertheimer\n\n- Search today's note for items tagged as >today or >dated\n\n[0.3.4] 2021-12-25 @dwertheimer\n\n- Fixed include/exclude bug thanks to @stacey and @4nd3rs for helping me find it\n\n[0.3.3] 2021-12-24 @dwertheimer\n\n- Added tons of console.logging to help with debugging in NP\n\n[0.3.0] 2021-12-24 @dwertheimer\n\n- Fixed Catalina (and previous OS) date math inconsistency\n\n[0.1.0] 2021-11-04 @dwertheimer\n\n- Initial release\n- \"Create Note From Calendar Item\" command (asks you for a template)\n- \"Create Note From Calendar Item w/QuickTemplate\" command (uses a preset template you established in the _configuration file / quickNotes field)\n" }, { "path": "dwertheimer.EventAutomations/README.md", "content": "# Event Automations\n\n## \"atb - Create AutoTimeBlocks for >today's Tasks\" command\n[How to use AutoTimeBlocking](https://noteplan.co/n/1EF12392-B544-4044-AC7A-428F57EB2DFC)\n" }, { "path": "dwertheimer.EventAutomations/__tests__/NPEventBlocks.test.js", "content": "// Jest testing docs: https://jestjs.io/docs/using-matchers\n/* global describe, test, beforeEach, beforeAll */\n\n// import * as mainFile from '../src/NPEventBlocks'\n\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, Note, Paragraph } from '@mocks/index'\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = NotePlan\n DataStore.settings['_logLevel'] = 'none' //change this to DEBUG to get more logging\n})\n\nbeforeEach(() => {\n const paragraphs = [\n new Paragraph({ type: 'title', content: 'theTitle', headingLevel: 1, indents: 0, lineIndex: 0 }),\n new Paragraph({ type: 'text', content: 'line 2', headingLevel: 1, indents: 0, lineIndex: 1 }),\n new Paragraph({ type: 'empty', content: '', headingLevel: 1, indents: 0, lineIndex: 2 }),\n new Paragraph({ type: 'text', content: 'line 3', headingLevel: 1, indents: 0, lineIndex: 3 }),\n ]\n Editor.note = new Note({ paragraphs })\n})\n\ndescribe('dwertheimer.EventBlocks' /* pluginID */, () => {\n describe('NPPluginMain' /* file */, () => {\n describe('createEvents' /* function */, () => {\n test.skip('should create events', () => {\n // const ret = mainFile.createEvents('theTitle', 'no')\n })\n })\n })\n})\n" }, { "path": "dwertheimer.EventAutomations/__tests__/NPTimeblocking.Integration.test.js", "content": "// @flow\n// Jest testing docs: https://jestjs.io/docs/using-matchers\n/* global describe, test, jest, expect, beforeAll */\n\n// Note: expect(spy).toHaveBeenNthCalledWith(2, expect.stringMatching(/ERROR/))\n\nimport moment from 'moment'\nimport * as mainFile from '../src/NPTimeblocking'\nimport * as configFile from '../src/config'\nimport { filenameDateString } from '@helpers/dateTime'\n\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, Note, Paragraph /*, mockWasCalledWithString */ } from '@mocks/index'\n\nconst unhyphenatedDate = (date: Date) => moment(date).format('YYYYMMDD')\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = NotePlan\n global.console = {\n log: jest.fn(),\n // eslint-disable-next-line no-console\n debug: console.debug, //these will pass through\n // eslint-disable-next-line no-console\n trace: console.trace,\n // map other methods that you want to use like console.table\n }\n DataStore.settings['_logLevel'] = 'none' // change to DEBUG to see more output\n DataStore.preference = () => '🕑' // 'timeblockTextMustContainString'\n})\n\nconst ISOToday = moment().format('YYYY-MM-DD')\nconst filenameToday = `${filenameDateString(new Date())}.md`\n\nconst paragraphs = [new Paragraph({ content: 'line1' }), new Paragraph({ content: 'line2' })]\nconst note = new Note({ paragraphs })\nnote.filename = `${unhyphenatedDate(new Date())}.md`\nEditor.note = note\nEditor.filename = note.filename\n\ndescribe('dwertheimer.EventAutomations' /* pluginID */, () => {\n /*\n * insertTodosAsTimeblocks()\n */\n describe('insertTodosAsTimeblocks() Integration Test' /* function */, () => {\n // INTEGRATION TEST\n test('should pe', async () => {\n const oldSettings = DataStore.settings\n let config = configFile.getTimeBlockingDefaults()\n config = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 5,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '🕑',\n includeLinks: 'OFF',\n _logLevel: 'DEBUG',\n }\n const editorNote = new Note({\n title: ISOToday,\n filename: filenameToday,\n type: 'Calendar',\n paragraphs: [\n {\n content: '---',\n rawContent: '---',\n type: 'separator',\n heading: '',\n headingLevel: -1,\n lineIndex: 0,\n isRecurring: false,\n indents: 0,\n noteType: 'Calendar',\n },\n {\n content: 'triggers: onEditorWillSave => dwertheimer.EventAutomations.onEditorWillSave',\n rawContent: 'triggers: onEditorWillSave => dwertheimer.EventAutomations.onEditorWillSave',\n type: 'text',\n heading: '',\n headingLevel: -1,\n lineIndex: 1,\n isRecurring: false,\n indents: 0,\n noteType: 'Calendar',\n },\n {\n content: '---',\n rawContent: '---',\n type: 'separator',\n heading: '',\n headingLevel: -1,\n lineIndex: 2,\n isRecurring: false,\n indents: 0,\n noteType: 'Calendar',\n },\n {\n content: '',\n rawContent: '',\n type: 'empty',\n heading: '',\n headingLevel: -1,\n lineIndex: 3,\n isRecurring: false,\n indents: 0,\n noteType: 'Calendar',\n },\n {\n content: 'Do something #home ',\n rawContent: '* Do something #home ',\n type: 'open',\n heading: '',\n headingLevel: -1,\n lineIndex: 4,\n isRecurring: false,\n indents: 0,\n noteType: 'Calendar',\n },\n {\n content: '5-6:30pm #home 🕑',\n rawContent: '+ 5-6:30pm #home 🕑',\n type: 'checklist',\n heading: '',\n headingLevel: -1,\n lineIndex: 5,\n isRecurring: false,\n indents: 0,\n noteType: 'Calendar',\n },\n {\n content: '',\n rawContent: '',\n type: 'empty',\n heading: '',\n headingLevel: -1,\n lineIndex: 6,\n isRecurring: false,\n indents: 0,\n noteType: 'Calendar',\n },\n ],\n })\n global.Editor = { ...global.Editor, ...editorNote }\n DataStore.settings = config\n global.Editor.note = global.Editor\n const backlinksNote = new Note({\n type: 'note',\n content: '20230516.md',\n rawContent: '20230516.md',\n prefix: '',\n lineIndex: 0,\n date: '2023-05-16T07:00:00.000Z',\n heading: '',\n headingLevel: 0,\n isRecurring: false,\n indents: 0,\n filename: '20230516.md',\n noteType: 'Calendar',\n linkedNoteTitles: [],\n subItems: [\n {\n type: 'title',\n content: '>⭐️ Tasks<',\n rawContent: '# >⭐️ Tasks<',\n prefix: '# ',\n contentRange: {},\n lineIndex: 6,\n date: `${ISOToday}T07:00:00.000Z`,\n heading: '',\n headingLevel: 0,\n isRecurring: false,\n indents: 0,\n filename: '20230516.md',\n noteType: 'Calendar',\n linkedNoteTitles: [],\n subItems: [],\n referencedBlocks: [],\n note: {},\n },\n {\n type: 'open',\n content: `Make bible video samples >${ISOToday} ^0v7523`,\n blockId: '^0v7523',\n rawContent: `* Make bible video samples >${ISOToday} ^0v7523`,\n prefix: '* ',\n contentRange: {},\n lineIndex: 7,\n date: `${ISOToday}T07:00:00.000Z`,\n heading: '>⭐️ Tasks<',\n headingRange: {},\n headingLevel: 2,\n isRecurring: false,\n indents: 0,\n filename: '20230516.md',\n noteType: 'Calendar',\n linkedNoteTitles: [],\n subItems: [],\n referencedBlocks: [],\n note: {},\n },\n ],\n referencedBlocks: [],\n })\n backlinksNote.note = backlinksNote\n global.Editor.note.backlinks = [backlinksNote]\n // const spy = jest.spyOn(global.Editor, 'insertParagraph')\n await mainFile.insertTodosAsTimeblocks()\n // insertParagraph doesn't work properly because it happens in the mock\n // $FlowIgnore - jest doesn't know about this param\n // expect(spy.mock.lastCall[1]).toEqual(`No todos/references marked for this day!`)\n // spy.mockRestore()\n DataStore.settings = oldSettings\n })\n })\n})\n" }, { "path": "dwertheimer.EventAutomations/__tests__/NPTimeblocking.test.js", "content": "// @flow\n// Jest testing docs: https://jestjs.io/docs/using-matchers\n/* global describe, test, jest, expect, beforeAll */\n\n// Note: expect(spy).toHaveBeenNthCalledWith(2, expect.stringMatching(/ERROR/))\n\nimport moment from 'moment/min/moment-with-locales'\nimport * as mainFile from '../src/NPTimeblocking'\nimport * as timeBlockingShared from '../src/timeblocking-shared'\nimport * as configFile from '../src/config'\n\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, Note, Paragraph, mockWasCalledWithString } from '@mocks/index'\n\nconst unhyphenatedDate = (date: Date) => moment(date).format('YYYYMMDD')\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = NotePlan\n global.console = {\n log: jest.fn(),\n // eslint-disable-next-line no-console\n debug: console.debug, //these will pass through\n // eslint-disable-next-line no-console\n trace: console.trace,\n // map other methods that you want to use like console.table\n }\n DataStore.settings['_logLevel'] = 'none' // change to DEBUG to see more output\n})\n\nconst paragraphs = [new Paragraph({ content: 'line1' }), new Paragraph({ content: 'line2' })]\nconst note = new Note({ paragraphs })\nnote.filename = `${unhyphenatedDate(new Date())}.md`\nEditor.note = note\nEditor.filename = note.filename\n\ndescribe('dwertheimer.EventAutomations' /* pluginID */, () => {\n describe('NPTimeblocking.js' /* file */, () => {\n /*\n * getConfig()\n */\n describe('getConfig()' /* function */, () => {\n // test('should XXX', () => {\n // const result = mainFile.getConfig()\n // expect(result).toEqual(true)\n // })\n test('should return default config if getting config fails', () => {\n const result = timeBlockingShared.getConfig()\n expect(Object.keys(result).length).toBeGreaterThan(1)\n })\n test('should return default config if no settings set', () => {\n const oldSettings = DataStore.settings\n global.DataStore.settings = { _logLevel: 'DEBUG' } // no plugin settings\n const spy = jest.spyOn(console, 'log')\n const result = timeBlockingShared.getConfig()\n expect(mockWasCalledWithString(spy, /config was empty/)).toBe(true)\n expect(Object.keys(result).length).toBeGreaterThan(1)\n spy.mockRestore()\n DataStore.settings = oldSettings\n })\n test('should return default config', () => {\n const result = timeBlockingShared.getConfig()\n expect(Object.keys(result).length).toBeGreaterThan(1)\n })\n test.skip('should complain about improper config', () => {\n //skipping for console noise\n const oldSettings = { ...DataStore.settings }\n DataStore.settings = { improper: 'key', _logLevel: 'DEBUG' }\n const spy = jest.spyOn(console, 'log')\n timeBlockingShared.getConfig()\n expect(mockWasCalledWithString(spy, /Running with default settings/)).toBe(true)\n spy.mockRestore()\n DataStore.settings = oldSettings\n })\n test('should return a proper config', () => {\n const oldSettings = DataStore.settings\n DataStore.settings = { ...oldSettings, ...configFile.getTimeBlockingDefaults() }\n const c = timeBlockingShared.getConfig()\n expect(c).toEqual(DataStore.settings)\n DataStore.settings = oldSettings\n })\n })\n /*\n * editorIsOpenToToday()\n */\n describe('editorIsOpenToToday()' /* function */, () => {\n /* template:\n test('should XXX', () => {\n const result = mainFile.editorIsOpenToToday()\n expect(result).toEqual(true)\n })\n */\n test('should return false if filename is null', () => {\n Editor.filename = null\n const result = mainFile.editorIsOpenToToday()\n expect(result).toEqual(false)\n })\n test('should return false if Editor is open to another day', () => {\n Editor.filename = `${unhyphenatedDate(new Date('2020-01-01'))}.md`\n const result = mainFile.editorIsOpenToToday()\n expect(result).toEqual(false)\n })\n test('should return true if Editor is open to is today', () => {\n Editor.filename = `${unhyphenatedDate(new Date())}.md`\n const result = mainFile.editorIsOpenToToday()\n expect(result).toEqual(true)\n })\n })\n\n /*\n * insertTodosAsTimeblocks()\n */\n describe('insertTodosAsTimeblocks()' /* function */, () => {\n test.skip('should tell user there was a problem with config', async () => {\n const spy = jest.spyOn(CommandBar, 'prompt')\n await mainFile.insertTodosAsTimeblocks()\n expect(spy.mock.calls[0][1]).toMatch(/Plugin Settings Error/)\n spy.mockRestore()\n })\n test.skip('should do nothing if there are no backlinks', async () => {\n // DataStore.settings = {} //should get default settings\n Editor.note.backlinks = []\n const spy = jest.spyOn(CommandBar, 'prompt')\n await mainFile.insertTodosAsTimeblocks()\n // $FlowIgnore - jest doesn't know about this param\n expect(mockWasCalledWithString(spy, /No todos\\/references marked for >today/)).toBe(true)\n spy.mockRestore()\n })\n // [WIP]\n test.skip('should do something if there are backlinks', async () => {\n Editor.note.backlinks = [{ subItems: [{ content: 'line1' }] }]\n const spy = jest.spyOn(CommandBar, 'prompt')\n await mainFile.insertTodosAsTimeblocks()\n // $FlowIgnore - jest doesn't know about this param\n expect(spy.mock.lastCall[1]).toEqual(`No todos/references marked for >today`)\n spy.mockRestore()\n })\n })\n })\n})\n" }, { "path": "dwertheimer.EventAutomations/__tests__/by_timeblock_tag.test.js", "content": "/* eslint-disable no-unused-vars */\n/* eslint-disable import/order */\n/* global jest, describe, test, expect, beforeAll, afterAll, beforeEach, afterEach */\n\nimport { CustomConsole, LogType, LogMessage } from '@jest/console' // see note below\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, simpleFormatter /* Note, mockWasCalledWithString, Paragraph */ } from '@mocks/index'\n\nimport { splitItemsByTags } from '../src/timeblocking-helpers.js'\n\nconst PLUGIN_NAME = `dwertheimer.EventAutomations`\nconst FILENAME = `timeblocking-helpers.js`\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = new NotePlan()\n global.console = new CustomConsole(process.stdout, process.stderr, simpleFormatter) // minimize log footprint\n DataStore.settings['_logLevel'] = 'none' //change this to DEBUG to get more logging (or 'none' for none)\n})\n\n/* Samples:\nTo use factories (from the factories folder inside of __tests__):\nconst testFile = new Note(JSON.parse(await loadFactoryFile(__dirname, 'jgclarksSortTest.json')))\n // load a factory file from the __tests__/factories folder\nexpect(result).toMatch(/someString/)\nexpect(result).not.toMatch(/someString/)\nexpect(() => compileAndroidCode()).toThrow(/JDK/);\nexpect(result).toEqual([])\n// object matching - important to not use exact match because you may add fields later\n expect(result).toEqual(expect.objectContaining({ field1: true, field2: 'someString'}))\n// or if you want to check if an array has objects in it with certain fields:\ntest('we should have name 1 and 2', () => {\n expect(users).toEqual(\n expect.arrayContaining([\n expect.objectContaining({name: 1}),\n expect.objectContaining({name: 2})\n ])\n );\n});\n\nimport { mockWasCalledWith } from '@mocks/mockHelpers'\n const spy = jest.spyOn(console, 'log')\n const result = mainFile.getConfig()\n expect(mockWasCalledWith(spy, /config was empty/)).toBe(true)\n spy.mockRestore()\n\n test('should return the command object', () => {\n const result = f.getPluginCommands({ 'plugin.commands': [{ a: 'foo' }] })\n expect(result).toEqual([{ a: 'foo' }])\n })\n*/\n\ndescribe(`${PLUGIN_NAME}`, () => {\n describe(`${FILENAME}`, () => {\n //functions go here using jfunc command\n\n describe('splitItemsByTags', () => {\n test('correctly groups items by matching tags', () => {\n const arrayOfItems = [\n { content: 'Item with #foo and #bar', duration: 10 }, // Matches foo and bar\n { content: 'Item with #foo', duration: 5 }, // Matches foo\n { content: 'Item without hashtags', duration: 3 }, // Matches none\n { content: 'Item with #bar', duration: 7 }, // Matches bar\n ]\n\n const tags = {\n foo: true,\n bar: true,\n }\n\n const result = splitItemsByTags(arrayOfItems, tags)\n const { matched, unmatched } = result\n\n // Assert the grouping is correct based on the content structure\n expect(matched.foo).toEqual(expect.arrayContaining([\n { content: 'Item with #foo and #bar', duration: 10 },\n { content: 'Item with #foo', duration: 5 }\n ]))\n expect(matched.bar).toEqual(expect.arrayContaining([\n { content: 'Item with #foo and #bar', duration: 10 },\n { content: 'Item with #bar', duration: 7 }\n ]))\n expect(unmatched).toEqual(expect.arrayContaining([\n { content: 'Item without hashtags', duration: 3 }\n ]))\n })\n\n test('handles empty arrayOfItems and tags correctly', () => {\n const arrayOfItems = []\n const tags = {}\n\n const { matched, unmatched } = splitItemsByTags(arrayOfItems, tags)\n\n expect(matched).toEqual({})\n expect(unmatched).toEqual([])\n })\n\n test('handles case where no items match any tags', () => {\n const arrayOfItems = [{ hashtags: ['x', 'y'] }, { hashtags: ['z'] }]\n const tags = { foo: ['09:00', '12:00'] }\n\n const { matched, unmatched } = splitItemsByTags(arrayOfItems, tags)\n\n expect(matched).toEqual({})\n expect(unmatched).toEqual(expect.arrayContaining(arrayOfItems))\n })\n describe('splitItemsByTags handling multiple matches', () => {\n test('places an item with two matching hashtags under both properties in matched', () => {\n // Assuming getTagsFromString can extract hashtags from the content string\n const arrayOfItems = [\n { content: 'This item matches #multiMatch1 and #multiMatch2', duration: 10 }, // This item matches two tags\n { content: 'This item matches #singleMatch', duration: 5 }, // This item matches only one tag\n { content: 'This item does not match any tag', duration: 3 }, // This item does not match any tag\n ]\n\n // Define tags with two matching tags and one additional tag that won't match\n const tags = {\n multiMatch1: true,\n multiMatch2: true,\n singleMatch: true,\n unmatchedTag: true,\n }\n\n const { matched, unmatched } = splitItemsByTags(arrayOfItems, tags)\n\n // Assert the item is under both matching tag properties in 'matched'\n // The expected objects in the assertions have to match the input structure of arrayOfItems\n expect(matched.multiMatch1).toEqual(expect.arrayContaining([{ content: 'This item matches #multiMatch1 and #multiMatch2', duration: 10 }]))\n expect(matched.multiMatch2).toEqual(expect.arrayContaining([{ content: 'This item matches #multiMatch1 and #multiMatch2', duration: 10 }]))\n\n // Assert the single match is correctly placed\n expect(matched.singleMatch).toEqual(expect.arrayContaining([{ content: 'This item matches #singleMatch', duration: 5 }]))\n\n // Assert that 'unmatched' contains the item without any matching tags\n expect(unmatched).toEqual(expect.arrayContaining([{ content: 'This item does not match any tag', duration: 3 }]))\n\n // Assert the unmatchedTag key does not exist in the matched object\n expect(matched).not.toHaveProperty('unmatchedTag')\n })\n })\n })\n\n // end of function tests\n }) // end of describe(`${FILENAME}`\n}) // // end of describe(`${PLUGIN_NAME}`\n" }, { "path": "dwertheimer.EventAutomations/__tests__/config.test.js", "content": "/* global jest, describe, test, expect, beforeAll, afterAll, beforeEach, afterEach */\n\nimport * as c from '../src/config'\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, simpleFormatter /* Note, mockWasCalledWithString, Paragraph */ } from '@mocks/index'\n\nbeforeAll(() => {\n global.DataStore = DataStore\n DataStore.settings['_logLevel'] = 'none' //change this to DEBUG to get more logging (or 'none' for none)\n})\n\ndescribe('dwertheimer.EventAutomations AutoTimeBlocking', () => {\n describe('config', () => {\n describe('getTimeBlockingDefaults', () => {\n test('should return timeblocks config', () => {\n const keys = Object.keys(c.getTimeBlockingDefaults())\n expect(keys.length).toBeGreaterThan(1)\n })\n })\n describe('validateAutoTimeBlockingConfig', () => {\n test('should be a function', () => {\n const config = c.getTimeBlockingDefaults()\n expect(c.validateAutoTimeBlockingConfig(config)).toEqual(config)\n })\n test('should throw an error on a bad config', () => {\n const config = c.getTimeBlockingDefaults()\n config.timeBlockTag = false\n expect(() => c.validateAutoTimeBlockingConfig(config)).toThrow(/timeBlockTag/)\n })\n })\n describe('arrayToCSV', () => {\n test('should convert an array to a CSV string', () => {\n const arr = ['a', 'b', 'c']\n const csv = c.arrayToCSV(arr)\n expect(csv).toEqual('a, b, c')\n })\n test('should pass through a string as a string', () => {\n const string = 'abc'\n const csv = c.arrayToCSV(string)\n expect(csv).toEqual('abc')\n })\n })\n })\n})\n" }, { "path": "dwertheimer.EventAutomations/__tests__/presets.test.js", "content": "/* globals describe, expect, test */\nimport { DataStore, Editor, CommandBar, NotePlan } from '@mocks/index'\nimport * as p from '../src/presets'\n\n// Make DataStore and Editor available globally for the source code\nglobal.DataStore = DataStore\nglobal.Editor = Editor\nglobal.CommandBar = CommandBar\nglobal.NotePlan = NotePlan\n\ndescribe('dwertheimer.EventAutomations AutoTimeBlocking', () => {\n describe('presets', () => {\n // getPresetOptions\n describe('getPresetOptions', () => {\n test('should create proper options', () => {\n expect(p.getPresetOptions([{ label: 'foo' }])).toEqual([{ label: 'foo', value: 0 }])\n })\n })\n describe('setConfigForPreset', () => {\n test('should overwrite config value with preset value and leave the rest', () => {\n const preset = { label: 'foo', todoChar: 'x' }\n const config = { todoChar: 'y', value: 'untouched' }\n expect(p.setConfigForPreset(config, preset)).toEqual({ todoChar: 'x', value: 'untouched' })\n })\n })\n })\n})\n" }, { "path": "dwertheimer.EventAutomations/__tests__/timeblocking-helpers.test.js", "content": "/* globals describe, expect, test, beforeAll, afterAll */\n// import colors from 'chalk'\n// import /* differenceInCalendarDays, endOfDay, startOfDay, eachMinuteOfInterval, */ 'date-fns'\nimport * as tb from '../src/timeblocking-helpers'\nimport * as byTagMode from '../src/timeblocking-helpers'\nimport { getTasksByType } from '@helpers/sorting'\n\nimport { JSP } from '@helpers/dev'\n\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, Note /* Paragraph */ } from '@mocks/index'\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = NotePlan\n DataStore.settings['_logLevel'] = 'none' //change this to DEBUG to get more logging\n})\n\nconst PLUGIN_NAME = `dwertheimer.EventAutomations`\n// const section = colors.blue\n\nconst config = {\n todoChar: '*' /* character at the front of a timeblock line - can be *,-,or a heading, e.g. #### */,\n timeBlockTag: `#🕑` /* placed at the end of the timeblock to show it was created by this plugin */,\n timeBlockHeading: 'Time Blocks' /* if this heading exists in the note, timeblocks will be placed under it */,\n workDayStart: '08:00' /* needs to be in 24 hour format (two digits, leading zero) */,\n workDayEnd: '18:00' /* needs to be in 24 hour format (two digits, leading zero) */,\n durationMarker: \"'\" /* signifies how long a task is, e.g. apostrophe: '2h5m or use another character, e.g. tilde: ~2h5m */,\n intervalMins: 5 /* inverval on which to calculate time blocks */,\n removeDuration: true /* remove duration when creating timeblock text */,\n nowStrOverride: '00:00' /* for testing */,\n defaultDuration: 10 /* default duration of a task that has no duration/end time */,\n includeLinks: '[[internal#links]]',\n}\n\n// import { isNullableTypeAnnotation } from '@babel/types'\n\n// Jest suite\ndescribe(`${PLUGIN_NAME}`, () => {\n describe('timeblocking-helpers.js', () => {\n describe('createIntervalMap ', () => {\n test('should create timeMap of 5min intervals all day ', () => {\n const result = tb.createIntervalMap({ start: new Date('2020-01-01 08:00:00'), end: new Date('2020-01-01 24:00:00') }, 'isSet', {\n step: 5,\n })\n expect(result[0]).toEqual({ start: '08:00', busy: 'isSet', index: 0 })\n expect(result[191]).toEqual({ start: '23:55', busy: 'isSet', index: 191 })\n expect(result.length).toEqual(193)\n })\n test('should create timeMap of 3min intervals all day ', () => {\n const result = tb.createIntervalMap({ start: new Date('2020-01-01 00:00:00'), end: new Date('2020-01-01 23:59:59') }, null, {\n step: 3,\n })\n expect(result[0]).toEqual({ start: '00:00', busy: null, index: 0 })\n expect(result[479]).toEqual({ start: '23:57', busy: null, index: 479 })\n expect(result.length).toEqual(480)\n })\n test('should return null when params are null', () => {\n const result = tb.createIntervalMap({ start: new Date('2020-01-01 00:00:00'), end: new Date('2020-01-01 23:59:59') }, null, {})\n expect(result).toEqual([])\n })\n })\n test('getBlankDayMap(5) returns all-day map of 5 min intervals ', () => {\n const result = tb.getBlankDayMap(5)\n expect(result[0]).toEqual({ start: '00:00', busy: false, index: 0 })\n expect(result[287]).toEqual({ start: '23:55', busy: false, index: 287 })\n expect(result.length).toEqual(288)\n })\n describe('blockTimeFor ', () => {\n test('should mark time map slots as busy (with title) for time of event in 2nd param', () => {\n const map = tb.getBlankDayMap(5)\n const result = tb.blockTimeFor(map, { start: '08:00', end: '09:00', title: 'testing' }, config)\n expect(result.newMap[0]).toEqual({ start: '00:00', busy: false, index: 0 })\n expect(result.newMap[95]).toEqual({ start: '07:55', busy: false, index: 95 })\n expect(result.newMap[96]).toEqual({ start: '08:00', busy: 'testing', index: 96 })\n expect(result.newMap[107]).toEqual({ start: '08:55', busy: 'testing', index: 107 })\n expect(result.newMap[108]).toEqual({ start: '09:00', busy: false, index: 108 })\n expect(result.newMap[287]).toEqual({ start: '23:55', busy: false, index: 287 })\n })\n test('should mark time map as busy: true for item without name ', () => {\n const map = tb.getBlankDayMap(5)\n const result = tb.blockTimeFor(map, { start: '08:00', end: '09:00' }, config)\n expect(result.itemText).toEqual('')\n expect(result.newMap[0]).toEqual({ start: '00:00', busy: false, index: 0 })\n expect(result.newMap[96]).toEqual({ start: '08:00', busy: true, index: 96 })\n expect(result.newMap[107]).toEqual({ start: '08:55', busy: true, index: 107 })\n expect(result.newMap[108]).toEqual({ start: '09:00', busy: false, index: 108 })\n })\n })\n describe('attachTimeblockTag', () => {\n test('should attach the given timeblock tag to a line of text', () => {\n expect(tb.attachTimeblockTag('test', '#tag')).toEqual('test #tag')\n })\n test('should not duplicate tag when attaching to a line which already has the tag', () => {\n expect(tb.attachTimeblockTag('test #tag', '#tag')).toEqual('test #tag')\n })\n })\n describe('createTimeBlockLine ', () => {\n test('should create timeblock text in form \"* HH:MM-HH:MM [name] #timeblocktag\" ', () => {\n const cfg = { ...config, timeBlockTag: '#tag', removeDuration: true }\n expect(tb.createTimeBlockLine({ title: 'foo', start: '08:00', end: '09:00' }, cfg)).toEqual('* 08:00-09:00 foo #tag')\n })\n test('should return empty string if title is empty', () => {\n const cfg = { ...config, timeBlockTag: '#tag', removeDuration: true }\n expect(tb.createTimeBlockLine({ title: '', start: '08:00', end: '09:00' }, cfg)).toEqual('')\n })\n test(\"should not remove duration time signature ('2h22m) from text when removeDuration config is false\", () => {\n const cfg = { ...config, timeBlockTag: '#tag', removeDuration: false }\n expect(tb.createTimeBlockLine({ title: \"foo bar '2h22m\", start: '08:00', end: '09:00' }, cfg)).toEqual(\"* 08:00-09:00 foo bar '2h22m #tag\")\n })\n test(\"should remove duration time signature ('2h22m) from text when removeDuration config is true\", () => {\n const cfg = { ...config, timeBlockTag: '#tag', removeDuration: true }\n expect(tb.createTimeBlockLine({ title: \"foo bar '2h22m\", start: '08:00', end: '09:00' }, cfg)).toEqual('* 08:00-09:00 foo bar #tag')\n })\n test('should add tb text when timeblockTextMustContainString is set', () => {\n const cfg = { ...config, timeblockTextMustContainString: '#tb', removeDuration: true }\n expect(tb.createTimeBlockLine({ title: \"foo bar '2h22m\", start: '08:00', end: '09:00' }, cfg)).toEqual('* 08:00-09:00 foo bar #🕑 #tb')\n })\n test('should not add tb text when timeblockTextMustContainString is set and tb text is already in the string', () => {\n const cfg = { ...config, timeblockTextMustContainString: '#tb', removeDuration: true }\n expect(tb.createTimeBlockLine({ title: \"foo bar#tb '2h22m\", start: '08:00', end: '09:00' }, cfg)).toEqual('* 08:00-09:00 foo bar#tb #🕑')\n })\n })\n describe('blockOutEvents ', () => {\n test('should block (only) times on the time map for the event given', () => {\n const map = tb.getBlankDayMap(5)\n const events = [{ date: new Date('2021-01-01 00:10'), endDate: new Date('2021-01-01 00:21'), title: 'event1' }]\n const returnVal = tb.blockOutEvents(events, map, config)\n expect(returnVal[1].busy).toEqual(false)\n expect(returnVal[2].busy).toEqual('event1')\n expect(returnVal[5].busy).toEqual(false)\n })\n test('should not block times for an event if availability flag is 1 (free)', () => {\n const map = tb.getBlankDayMap(5)\n const events = [{ date: new Date('2021-01-01 00:10'), endDate: new Date('2021-01-01 00:21'), title: 'event1', availability: 1 }]\n const returnVal = tb.blockOutEvents(events, map, config)\n expect(returnVal[1].busy).toEqual(false)\n expect(returnVal[2].busy).toEqual(false)\n expect(returnVal[5].busy).toEqual(false)\n })\n test('overlapping events should get blocked with the later events reflected in the busy field', () => {\n const map = tb.getBlankDayMap(5)\n const events = [{ date: new Date('2021-01-01 00:10'), endDate: new Date('2021-01-01 00:21'), title: 'event1' }]\n events.push({\n date: new Date('2021-01-01 00:20'),\n endDate: new Date('2021-01-01 00:30'),\n title: 'event2',\n })\n const returnVal = tb.blockOutEvents(events, map, config)\n expect(returnVal[4].busy).toEqual('event2')\n expect(returnVal[6].busy).toEqual(false)\n })\n test('If calendar items have no endDate, they are ignored', () => {\n const map = tb.getBlankDayMap(5)\n const events = [{ date: new Date('2021-01-01 00:20'), title: 'event3' }]\n const returnVal = tb.blockOutEvents(events, map, config)\n expect(returnVal.filter((t) => t.busy === 'event3')).toEqual([])\n })\n })\n\n test('removeDurationParameter ', () => {\n // hours and mins\n expect(tb.removeDurationParameter('this is foo ~2h22m', '~')).toEqual('this is foo')\n // minutes only\n expect(tb.removeDurationParameter('this is foo ~22m', '~')).toEqual('this is foo')\n // multiple splits (after the duration)\n expect(tb.removeDurationParameter('this is foo ~22m (2)', '~')).toEqual('this is foo (2)')\n // multiple splits (before the duration)\n expect(tb.removeDurationParameter('this is foo (2) ~22m', '~')).toEqual('this is foo (2)')\n })\n\n test('getDurationFromLine ', () => {\n expect(tb.getDurationFromLine('', \"'\")).toEqual(0)\n expect(tb.getDurationFromLine('no time sig', \"'\")).toEqual(0)\n expect(tb.getDurationFromLine(\" '2m\", \"'\")).toEqual(2)\n expect(tb.getDurationFromLine(\" '2h\", \"'\")).toEqual(120)\n expect(tb.getDurationFromLine(\" '2.5h\", \"'\")).toEqual(150)\n expect(tb.getDurationFromLine(\" '2.5m\", \"'\")).toEqual(3)\n expect(tb.getDurationFromLine(\" '2h5m\", \"'\")).toEqual(125)\n // Numbered capture groups (not (?…)) — older JavaScriptCore\n expect(tb.getDurationFromLine(\" '1h30m\", \"'\")).toEqual(90)\n expect(tb.getDurationFromLine(\" '.5h\", \"'\")).toEqual(30)\n expect(tb.getDurationFromLine(\" '1h\", \"'\")).toEqual(60)\n })\n\n test('addDurationToTasks ', () => {\n const res = tb.addDurationToTasks([{ content: `foo '1h4m` }], config)\n expect(res[0].duration).toEqual(64)\n })\n\n test('removeDateTagsFromArray ', () => {\n const inputArray = [\n { indents: 1, type: 'open', content: 'thecontent >today', rawContent: '* thecontent >today' },\n { indents: 0, type: 'scheduled', content: '2thecontent >2021-01-01', rawContent: '* 2thecontent >2021-01-01' },\n { indents: 0, type: 'scheduled', content: '', rawContent: '' },\n ]\n const returnval = tb.removeDateTagsFromArray(inputArray)\n expect(returnval[0].content).toEqual('thecontent')\n expect(returnval[1].rawContent).toEqual('* 2thecontent')\n expect(returnval[2].content).toEqual('')\n })\n\n describe('timeIsAfterWorkHours', () => {\n const config = { workDayStart: '08:00', workDayEnd: '17:00' }\n test('should be true when now is >= workdayEnd', () => {\n expect(tb.timeIsAfterWorkHours('17:00', config)).toEqual(true)\n })\n test('should be false when now is < workdayEnd', () => {\n expect(tb.timeIsAfterWorkHours('16:59', config)).toEqual(false)\n })\n })\n\n describe('filterTimeMapToOpenSlots', () => {\n test('filterTimeMapToOpenSlots ', () => {\n const timeMap = [\n { start: '00:00', busy: false },\n { start: '00:05', busy: false },\n ]\n let cfg = { ...config, workDayStart: '00:00', workDayEnd: '23:59', nowStrOverride: '00:02 ' }\n // expect(tb.filterTimeMapToOpenSlots(timeMap, nowStr, workDayStart, workDayEnd)).toEqual(true)\n expect(tb.filterTimeMapToOpenSlots(timeMap, cfg)).toEqual(timeMap.slice(1, 2)) // now is after first item\n cfg.nowStrOverride = '00:00'\n expect(tb.filterTimeMapToOpenSlots(timeMap, cfg)).toEqual(timeMap) // now is equal to first item\n cfg = { ...cfg, workDayStart: '00:01' }\n expect(tb.filterTimeMapToOpenSlots(timeMap, cfg)).toEqual(timeMap.slice(1, 2)) // workDayStart is after first item\n cfg = { ...cfg, workDayStart: '00:05' }\n expect(tb.filterTimeMapToOpenSlots(timeMap, cfg)).toEqual(timeMap.slice(1, 2)) // workDayStart is equal to 2nd item\n cfg = { ...config, workDayEnd: '00:00', nowStrOverride: '00:00' }\n expect(tb.filterTimeMapToOpenSlots(timeMap, cfg)).toEqual([]) // workDayEnd is before 1st item\n cfg = { ...config, workDayStart: '00:00', workDayEnd: '00:03', nowStrOverride: '00:00' }\n expect(tb.filterTimeMapToOpenSlots(timeMap, cfg, '00:00')).toEqual(timeMap.slice(0, 1)) // workDayEnd is before 2st item\n cfg = { ...config, workDayStart: '00:00', workDayEnd: '00:30', nowStrOverride: '00:00', timeblockTextMustContainString: '#tb', mode: 'BY_TIMEBLOCK_TAG' }\n timeMap.push({ start: '00:10', busy: 'work #tb' })\n const result = tb.filterTimeMapToOpenSlots(timeMap, cfg, '00:00')\n expect(result[2]).toEqual(timeMap[2]) // does not screen out timeblocks\n })\n })\n\n test('makeAllItemsTodos ', () => {\n const types = ['open', 'done', 'scheduled', 'cancelled', 'title', 'quote', 'list', 'text']\n const expec = ['open', 'done', 'scheduled', 'cancelled', 'title', 'quote', 'open', 'open']\n const paras = types.map((type) => ({ type, content: `was:${type}` }))\n const res = tb.makeAllItemsTodos(paras)\n res.forEach((item, i) => {\n expect(item.type).toEqual(expec[i])\n })\n })\n\n test('createOpenBlockObject ', () => {\n const cfg = { ...config, intervalMins: 2 }\n expect(tb.createOpenBlockObject({ start: '00:00', end: '00:10' }, cfg, false).minsAvailable).toEqual(10)\n expect(tb.createOpenBlockObject({ start: '00:00', end: '00:10' }, cfg, true).minsAvailable).toEqual(12)\n expect(tb.createOpenBlockObject({ start: '00:00', end: '02:10' }, cfg, false).minsAvailable).toEqual(130)\n expect(tb.createOpenBlockObject({ start: '00:00', end: '02:10' }, cfg, false)).toEqual({\n start: '00:00',\n end: '02:10',\n minsAvailable: 130,\n })\n expect(tb.createOpenBlockObject({ start: '00:00', end: '02:10' }, cfg, true)).toEqual({\n start: '00:00',\n end: '02:12',\n minsAvailable: 132,\n })\n expect(tb.createOpenBlockObject({ start: new Date(), end: '02:10' }, cfg, true)).toEqual(null)\n })\n\n test('findTimeBlocks ', () => {\n // empty map should return empty array\n expect(tb.findTimeBlocks([])).toEqual([])\n let timeMap = [\n { start: '00:05', busy: false, index: 0 },\n { start: '00:15', busy: false, index: 2 } /* this one should cause a break */,\n { start: '00:20', busy: false, index: 3 },\n { start: '00:30', busy: false, index: 5 } /* this one should cause a break */,\n ]\n let timeBlocks = tb.findTimeBlocks(timeMap, config)\n expect(timeBlocks[0]).toEqual({ start: '00:05', end: '00:10', minsAvailable: 5, title: '' })\n expect(timeBlocks[1]).toEqual({ start: '00:15', end: '00:25', minsAvailable: 10, title: '' })\n expect(timeBlocks[2]).toEqual({ start: '00:30', end: '00:35', minsAvailable: 5, title: '' })\n\n timeMap = [\n // test the whole map is available/contiguous\n { start: '00:15', busy: false, index: 2 },\n { start: '00:20', busy: false, index: 3 },\n { start: '00:25', busy: false, index: 4 },\n ]\n timeBlocks = tb.findTimeBlocks(timeMap, config)\n expect(timeBlocks.length).toEqual(1)\n expect(timeBlocks[0]).toEqual({ start: '00:15', end: '00:30', minsAvailable: 15, title: '' })\n timeMap = [\n // one item and one contiguous block\n { start: '00:00', busy: false, index: 0 },\n { start: '00:15', busy: false, index: 2 },\n { start: '00:20', busy: false, index: 3 },\n { start: '00:25', busy: false, index: 4 },\n ]\n timeBlocks = tb.findTimeBlocks(timeMap, config)\n expect(timeBlocks.length).toEqual(2)\n expect(timeBlocks[0]).toEqual({ start: '00:00', end: '00:05', minsAvailable: 5, title: '' })\n expect(timeBlocks[1]).toEqual({ start: '00:15', end: '00:30', minsAvailable: 15, title: '' })\n timeMap = [\n // one item and one contiguous block\n { start: '23:40', busy: false, index: 0 },\n { start: '23:45', busy: false, index: 1 },\n { start: '23:50', busy: false, index: 2 },\n { start: '23:55', busy: false, index: 3 },\n ]\n timeBlocks = tb.findTimeBlocks(timeMap, config)\n expect(timeBlocks.length).toEqual(1)\n expect(timeBlocks[0]).toEqual({ start: '23:40', end: '23:59', minsAvailable: 20, title: '' }) //FIXME: this doesn't seem right!\n timeMap = [\n // one item and one contiguous block\n { start: '23:40', busy: false, index: 0 },\n { start: '23:45', busy: 'foo #tb', index: 1 },\n { start: '23:50', busy: 'foo #tb', index: 2 },\n { start: '23:55', busy: false, index: 3 },\n ]\n timeBlocks = tb.findTimeBlocks(timeMap, config)\n expect(timeBlocks.length).toEqual(3)\n expect(timeBlocks[1].minsAvailable).toEqual(10)\n expect(timeBlocks[1].title).toEqual('foo #tb')\n })\n\n describe('addMinutesToTimeText', () => {\n test('should add time properly', () => {\n expect(tb.addMinutesToTimeText('00:00', 21)).toEqual('00:21')\n expect(tb.addMinutesToTimeText('00:00', 180)).toEqual('03:00')\n expect(tb.addMinutesToTimeText('00:50', 20)).toEqual('01:10')\n })\n test('should gracefully fail on bad input', () => {\n expect(tb.addMinutesToTimeText(new Date(), 21)).toEqual('')\n })\n })\n\n describe('getTimeBlockTimesForEvents ', () => {\n test('basic PRIORITY_FIRST test', () => {\n const timeMap = [\n // one item and one contiguous block\n { start: '00:00', busy: false, index: 0 },\n { start: '00:15', busy: false, index: 2 },\n { start: '00:20', busy: false, index: 3 },\n { start: '00:25', busy: false, index: 4 },\n ]\n const todos = [\n { content: \"!! line1 '8m\", type: 'open' },\n { content: \"! line2 '1m\", type: 'open' },\n { content: \"!!! line3 '7m\", type: 'open' },\n ]\n const todosByType = getTasksByType(todos)\n const cfg = {\n ...config,\n workDayStart: '00:00',\n workDayEnd: '23:59',\n nowStrOverride: '00:00',\n mode: 'PRIORITY_FIRST',\n allowEventSplits: true,\n }\n // returns {blockList, timeBlockTextList, timeMap}\n const res = tb.getTimeBlockTimesForEvents(timeMap, todosByType['open'], cfg)\n expect(res.timeBlockTextList).toEqual([\n '* 00:00-00:05 !!! line3 (1) #🕑',\n '* 00:15-00:17 !!! line3 (2) #🕑',\n '* 00:20-00:28 !! line1 #🕑',\n /* '* 00:20-00:21 ! line2 #🕑', LINE2 DOES NOT HAVE A SLOT */\n ])\n })\n test(\"should work if it's now later in the day \", () => {\n // test with time later in the day\n const todos = [\n { content: \"!! line1 '8m\", type: 'open' },\n { content: \"! line2 '1m\", type: 'open' },\n { content: \"!!! line3 '7m\", type: 'open' },\n ]\n const todosByType = getTasksByType(todos)\n const cfg = {\n ...config,\n workDayStart: '00:00',\n workDayEnd: '23:59',\n nowStrOverride: '00:19',\n mode: 'PRIORITY_FIRST',\n allowEventSplits: true,\n }\n const timeMap2 = [\n // one item and one contiguous block\n { start: '00:00', busy: false, index: 0 },\n { start: '00:15', busy: false, index: 2 },\n { start: '00:20', busy: false, index: 3 },\n { start: '00:25', busy: false, index: 4 },\n ]\n const res = tb.getTimeBlockTimesForEvents(timeMap2, todosByType['open'], cfg)\n expect(res.timeBlockTextList).toEqual([`* 00:20-00:27 !!! line3 ${config.timeBlockTag}`])\n })\n test('calling options.mode = LARGEST_FIRST', () => {\n // test with calling options.mode = 'LARGEST_FIRST'\n const todos = [\n { content: \"!! line1 '8m\", type: 'open' },\n { content: \"! line2 '1m\", type: 'open' },\n { content: \"!!! line3 '7m\", type: 'open' },\n ]\n const todosByType = getTasksByType(todos)\n const cfg = {\n ...config,\n workDayStart: '00:00',\n workDayEnd: '23:59',\n nowStrOverride: '00:00',\n mode: 'LARGEST_FIRST',\n allowEventSplits: true,\n }\n const res = tb.getTimeBlockTimesForEvents([{ start: '00:00', busy: false, index: 0 }], todosByType['open'], cfg)\n expect(res.timeBlockTextList).toEqual([\n '* 00:00-00:05 !! line1 (1) #🕑',\n /* '* 00:20-00:21 ! line2 #🕑', LINE2 DOES NOT HAVE A SLOT */\n ])\n // test with calling no options.mode (just for coverage of switch statement)\n })\n test('calling options.mode = tests default in switch', () => {\n const todos = [\n { content: \"!! line1 '8m\", type: 'open' },\n { content: \"! line2 '1m\", type: 'open' },\n { content: \"!!! line3 '7m\", type: 'open' },\n ]\n const todosByType = getTasksByType(todos)\n\n const cfg = {\n ...config,\n workDayStart: '00:00',\n workDayEnd: '23:59',\n nowStrOverride: '00:00',\n mode: '',\n allowEventSplits: true,\n }\n const res = tb.getTimeBlockTimesForEvents([{ start: '00:00', busy: false, index: 0 }], todosByType['open'], cfg)\n expect(res.timeBlockTextList).toEqual([])\n })\n test('should place only items that fit in rest of day', () => {\n const timeMap = [\n // one item and one contiguous block\n { start: '23:40', busy: false, index: 0 },\n { start: '23:45', busy: false, index: 1 },\n { start: '23:50', busy: false, index: 2 },\n { start: '23:55', busy: false, index: 4 },\n ]\n const todos = [\n { content: \"!! line1 '8m\", type: 'open' },\n { content: \"! line2 '1m\", type: 'open' },\n { content: \"!!! line3 '7m\", type: 'open' },\n ]\n const todosByType = getTasksByType(todos)\n\n const cfg = {\n ...config,\n workDayStart: '23:00',\n intervalMins: 5,\n workDayEnd: '23:59',\n nowStrOverride: '23:54',\n mode: 'PRIORITY_FIRST',\n allowEventSplits: false,\n }\n const res = tb.getTimeBlockTimesForEvents(timeMap, todosByType['open'], cfg)\n expect(res.timeBlockTextList).toEqual(['* 23:55-23:56 ! line2 #🕑'])\n })\n test('should place single BY_TIMEBLOCK_TAG items inside timeblock of that name', () => {\n const timeMap = [\n // one item and one contiguous block\n { start: '23:45', busy: 'timblock #tb', index: 1 },\n { start: '23:50', busy: 'timblock #tb', index: 2 },\n { start: '23:55', busy: 'timblock #tb', index: 3 },\n ]\n const todos = [{ content: \"! line2 '5m #timblock\", type: 'open' }]\n const todosByType = getTasksByType(todos)\n\n const cfg = {\n ...config,\n workDayStart: '23:00',\n intervalMins: 5,\n workDayEnd: '23:59',\n nowStrOverride: '23:00',\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n allowEventSplits: false,\n }\n const result = tb.getTimeBlockTimesForEvents(timeMap, todosByType['open'], cfg)\n expect(result.timeBlockTextList).toEqual(expect.arrayContaining(['* 23:45-23:50 ! line2 #timblock #🕑 #tb']))\n })\n test('should place BY_TIMEBLOCK_TAG items inside timeblock of that name when there are other blocks', () => {\n const timeMap = [\n // one item and one contiguous block\n { start: '23:40', busy: false, index: 0 },\n { start: '23:45', busy: 'timblock #tb', index: 1 },\n { start: '23:50', busy: 'timblock #tb', index: 2 },\n { start: '23:55', busy: 'timblock #tb', index: 3 },\n { start: '24:00', busy: false, index: 4 },\n { start: '24:05', busy: false, index: 5 },\n ]\n const todos = [\n { content: \"!! line1 '2m\", type: 'open' },\n { content: \"! line2 '5m #timblock\", type: 'open' },\n { content: \"!!! line3 '5m\", type: 'open' },\n ]\n const todosByType = getTasksByType(todos)\n\n const cfg = {\n ...config,\n workDayStart: '23:00',\n intervalMins: 5,\n workDayEnd: '23:59',\n nowStrOverride: '23:00',\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n allowEventSplits: false,\n }\n const result = tb.getTimeBlockTimesForEvents(timeMap, todosByType['open'], cfg)\n expect(result.timeBlockTextList).toEqual(expect.arrayContaining(['* 23:45-23:50 ! line2 #timblock #🕑 #tb']))\n })\n })\n\n test('blockTimeAndCreateTimeBlockText ', () => {\n let timeMap = [\n { start: '00:00', busy: false, index: 0 },\n { start: '00:05', busy: false, index: 1 },\n ]\n let blockList = tb.findTimeBlocks(timeMap, config)\n let block = { start: '00:00', end: '00:05', title: \"test '2m\" }\n const timeBlockTextList = []\n let tbm = { timeMap, blockList, timeBlockTextList }\n const cfg = { ...config, nowStrOverride: '00:00', workDayStart: '00:00' }\n // (1) Base test. Block a time and return proper results\n const result = tb.blockTimeAndCreateTimeBlockText(tbm, block, cfg)\n expect(result).toEqual({\n blockList: [{ end: '00:10', minsAvailable: 5, start: '00:05', title: '' }],\n timeBlockTextList: [`* 00:00-00:05 test ${config.timeBlockTag}`],\n timeMap: [{ busy: false, index: 1, start: '00:05' }],\n })\n // (2) Run a second test on the result of the first test.\n // comes back with empty timeMap and blockList b/c interval is 5m\n block = { start: '00:05', end: '00:07', title: \"test2 '2m\" }\n const result2 = tb.blockTimeAndCreateTimeBlockText(result, block, cfg)\n expect(result2).toEqual({\n blockList: [],\n timeBlockTextList: [`* 00:00-00:05 test ${config.timeBlockTag}`, `* 00:05-00:07 test2 ${config.timeBlockTag}`],\n timeMap: [],\n })\n // (3) Run a third test\n // but with a 2m interval. Should split the block and send back the remainder\n block = { start: '00:00', end: '00:02', title: \"test2 '2m\" }\n timeMap = [\n { start: '00:00', busy: false, index: 0 },\n { start: '00:02', busy: false, index: 1 },\n { start: '00:04', busy: false, index: 2 },\n { start: '00:06', busy: false, index: 3 },\n ]\n cfg.intervalMins = 2\n blockList = tb.findTimeBlocks(timeMap, cfg)\n tbm = { timeMap, blockList, timeBlockTextList: [] }\n const result3 = tb.blockTimeAndCreateTimeBlockText(tbm, block, cfg)\n expect(result3).toEqual({\n blockList: [{ start: '00:02', end: '00:08', minsAvailable: 6, title: '' }],\n timeBlockTextList: [`* 00:00-00:02 test2 ${config.timeBlockTag}`],\n timeMap: [\n { start: '00:02', busy: false, index: 1 },\n { start: '00:04', busy: false, index: 2 },\n { start: '00:06', busy: false, index: 3 },\n ],\n })\n })\n\n describe('matchTasksToSlots ', () => {\n test('should insert content that fits without splitting ', () => {\n const tasks = [{ content: \"line1 '2m\" }, { content: \"line2 '1m\" }]\n const timeMap = [\n { start: '00:02', busy: false, index: 1 },\n { start: '00:04', busy: false, index: 2 },\n { start: '00:06', busy: false, index: 3 },\n /* block[0]: start:00:02 end:00:08 minsAvailable: 6 */\n { start: '00:20', busy: false, index: 10 },\n { start: '00:22', busy: false, index: 11 },\n /* block[1]: start:00:20 end:00:24 minsAvailable: 4 */\n ]\n const timeBlocks = [{ start: '00:02', end: '00:08', minsAvailable: 6 }]\n const cfg = { ...config, nowStrOverride: '00:00', workDayStart: '00:00', intervalMins: 2 }\n // First check that items that fit inside the time block work properly\n const res = tb.matchTasksToSlots(tasks, { blockList: timeBlocks, timeMap }, cfg)\n expect(res.timeBlockTextList[0]).toEqual(`* 00:02-00:04 line1 ${config.timeBlockTag}`)\n expect(res.timeBlockTextList[1]).toEqual(`* 00:04-00:05 line2 ${config.timeBlockTag}`)\n expect(res.blockList[0]).toEqual({ start: '00:06', end: '00:08', minsAvailable: 2, title: '' })\n expect(res.blockList[1]).toEqual({ start: '00:20', end: '00:24', minsAvailable: 4, title: '' })\n expect(res.timeMap[0]).toEqual({ start: '00:06', busy: false, index: 3 })\n expect(res.timeMap[1]).toEqual({ start: '00:20', busy: false, index: 10 })\n expect(res.timeMap[2]).toEqual({ start: '00:22', busy: false, index: 11 })\n })\n test('items that do not fit in slots get split when allowEventSplits = true', () => {\n // Now check that items that don't fit inside the time block get split properly\n // Even if the whole task can't find a slot\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 2,\n allowEventSplits: true,\n }\n const timeMap2 = [\n { start: '00:02', busy: false, index: 1 },\n { start: '00:04', busy: false, index: 2 },\n { start: '00:06', busy: false, index: 3 },\n /* block[0]: start:00:02 end:00:08 minsAvailable: 6 */\n { start: '00:20', busy: false, index: 10 },\n { start: '00:22', busy: false, index: 11 },\n /* block[1]: start:00:20 end:00:24 minsAvailable: 4 */\n ]\n const nonFittingTask = [{ content: \"line3 '12m\" }]\n const timeBlocks = [\n { start: '00:02', end: '00:08', minsAvailable: 6 },\n { start: '00:20', end: '00:24', minsAvailable: 4 },\n ]\n const res = tb.matchTasksToSlots(nonFittingTask, { blockList: timeBlocks, timeMap: timeMap2, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList[0]).toEqual(`* 00:02-00:08 line3 (1) ${config.timeBlockTag}`)\n expect(res.timeBlockTextList[1]).toEqual(`* 00:20-00:24 line3 (2) ${config.timeBlockTag}`)\n expect(res.timeBlockTextList.length).toEqual(2)\n expect(res.timeMap.length).toEqual(0)\n expect(res.blockList.length).toEqual(0)\n })\n test('no time for even one task', () => {\n // Now check that items that don't fit inside the time block get split properly\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n workDayEnd: '00:08',\n intervalMins: 2,\n }\n const timeMap2 = [\n { start: '00:00', busy: false, index: 0 },\n { start: '00:02', busy: false, index: 1 },\n { start: '00:04', busy: false, index: 2 },\n { start: '00:06', busy: false, index: 3 },\n ]\n const nonFittingTasks = [{ content: \"wont get placed '12m\" }]\n const timeBlocks = [] // irrelevant because will be rebuilt\n const res = tb.matchTasksToSlots(nonFittingTasks, { blockList: timeBlocks, timeMap: timeMap2, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList.length).toEqual(0)\n expect(Object.keys(res.noTimeForTasks).length).toEqual(1)\n expect(res.noTimeForTasks['_'].length).toEqual(1)\n expect(res.noTimeForTasks['_'][0]).toEqual({ content: `wont get placed '12m` })\n })\n test('items that do not fit in slots do not get split when allowEventSplits is missing', () => {\n // Now check that items that don't fit inside the time block get split properly\n // Even if the whole task can't find a slot\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 2,\n }\n const timeMap2 = [\n { start: '00:02', busy: false, index: 1 },\n { start: '00:04', busy: false, index: 2 },\n { start: '00:06', busy: false, index: 3 },\n /* block[0]: start:00:02 end:00:08 minsAvailable: 6 */\n { start: '00:20', busy: false, index: 10 },\n { start: '00:22', busy: false, index: 11 },\n { start: '00:24', busy: false, index: 12 },\n { start: '00:26', busy: false, index: 13 },\n { start: '00:28', busy: false, index: 14 },\n /* block[1]: start:00:20 end:00:24 minsAvailable: 4 */\n ]\n const nonFittingTask = [{ content: \"wont get placed '12m\" }]\n const fittingTask = [{ content: \"gets placed '8m\" }]\n const timeBlocks = [] // irrelevant because will be rebuilt\n const res = tb.matchTasksToSlots([...nonFittingTask, ...fittingTask], { blockList: timeBlocks, timeMap: timeMap2, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList.length).toEqual(1)\n expect(res.timeBlockTextList[0]).toEqual(`* 00:20-00:28 gets placed ${config.timeBlockTag}`)\n })\n test('items that do not fit in slots get split', () => {\n // now test line which had no time attached\n const timeBlocks = [{ start: '00:00', end: '00:20', minsAvailable: 20 }]\n const timeMap = [{ start: '00:00', busy: false, index: 1 }]\n const cfg = { ...config, nowStrOverride: '00:00', workDayStart: '00:00', intervalMins: 20, defaultDuration: 13 }\n const res = tb.matchTasksToSlots([{ content: 'line4' }], { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual([`* 00:00-00:13 line4 ${config.timeBlockTag}`])\n })\n // dbw: skipping these tests for now because I think they are well covered elsewhere and this is not actually the path\n // for the BY_TIMEBLOCK_TAG mode. Leaving them in case they are useful later.\n test.skip('Mode: BY_TIMEBLOCK_TAG Put tasks inside timeblocks with their name - single item', () => {\n // now test line which had no time attached\n const timeBlocks = [{ start: '00:00', end: '00:20', minsAvailable: 20, title: 'timblock' }]\n const timeMap = [{ start: '00:00', busy: false, index: 1 }]\n const cfg = { ...config, nowStrOverride: '00:00', workDayStart: '00:00', intervalMins: 20, defaultDuration: 5, mode: 'BY_TIMEBLOCK_TAG' }\n const res = tb.matchTasksToSlots([{ content: 'Do something #timblock' }], { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual(['* 00:00-00:05 Do something #timblock #🕑'])\n })\n test.skip('Mode: BY_TIMEBLOCK_TAG Put tasks inside timeblocks with their name - multi items', () => {\n // now test line which had no time attached\n const timeBlocks = [\n { start: '00:00', end: '00:20', minsAvailable: 20, title: '' },\n { start: '00:40', end: '01:00', minsAvailable: 20, title: 'timblock' },\n { start: '01:30', end: '01:50', minsAvailable: 20, title: '' },\n ]\n const timeMap = [\n { start: '00:00', busy: false, index: 1 },\n { start: '00:40', busy: 'timblock #tb', index: 5 },\n ]\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 20,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n }\n const sortedTaskList = [{ content: 'Do something #timblock' }, { content: 'line2' }, { content: 'line3' }]\n const res = tb.matchTasksToSlots(sortedTaskList, { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual([`* 00:00-00:13 line4 ${config.timeBlockTag}`])\n })\n })\n\n describe('getRegExOrString', () => {\n test('should return items that are a string', () => {\n const res = tb.getRegExOrString('a string')\n expect(res).toEqual('a string')\n expect(typeof res).toEqual('string')\n })\n test('should return Regex for items that are regex', () => {\n const res = tb.getRegExOrString('/a regex/')\n expect(res).toEqual(new RegExp('a regex'))\n })\n test('should work when there are spaces', () => {\n const res = tb.getRegExOrString(' /a regex/ ')\n expect(res).toEqual(new RegExp('a regex'))\n })\n })\n\n describe('includeTasksWithPatterns', () => {\n test('should include only tasks that contain a string', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.includeTasksWithPatterns(tasks, 'ba')\n expect(result.length).toEqual(2)\n expect(result[0].content).toEqual('bar')\n expect(result[1].content).toEqual('baz')\n })\n test('should include only tasks that match a regex', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.includeTasksWithPatterns(tasks, /ba/)\n expect(result.length).toEqual(2)\n expect(result[0].content).toEqual('bar')\n expect(result[1].content).toEqual('baz')\n })\n test('should work when the input string is comma-separated list', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.includeTasksWithPatterns(tasks, 'foo,baz')\n expect(result.length).toEqual(2)\n expect(result[0].content).toEqual('foo')\n expect(result[1].content).toEqual('baz')\n })\n test('should work when the input string is comma-separated list with a regex', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.includeTasksWithPatterns(tasks, '/^f/,baz')\n expect(result.length).toEqual(2)\n expect(result[0].content).toEqual('foo')\n expect(result[1].content).toEqual('baz')\n })\n test('should include tasks that match an array of patterns', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.includeTasksWithPatterns(tasks, ['az', /^f/])\n expect(result.length).toEqual(2)\n expect(result[0].content).toEqual('foo')\n expect(result[1].content).toEqual('baz')\n })\n test('should include tasks that match an array of patterns with spaces', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.includeTasksWithPatterns(tasks, ' foo, baz ')\n expect(result.length).toEqual(2)\n expect(result[0].content).toEqual('foo')\n expect(result[1].content).toEqual('baz')\n })\n })\n describe('excludeTasksWithPatterns', () => {\n test('should include only tasks that do not contain the string/regex', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.excludeTasksWithPatterns(tasks, 'ba')\n expect(result.length).toEqual(1)\n expect(result[0].content).toEqual('foo')\n })\n test('should exclude tasks that match a regex', () => {\n const tasks = [{ content: 'foo' }, { content: 'bar' }, { content: 'baz' }]\n const result = tb.excludeTasksWithPatterns(tasks, '/ba/')\n expect(result[0].content).toEqual('foo')\n })\n test('should exclude tasks with hashtags', () => {\n const tasks = [{ content: 'foo #planning' }, { content: '#lao bar' }, { content: 'baz' }]\n const result = tb.excludeTasksWithPatterns(tasks, '#planning,#lao')\n expect(result.length).toEqual(1)\n expect(result[0].content).toEqual('baz')\n })\n test('should exclude tasks with spaces', () => {\n const tasks = [{ content: 'foo #planning' }, { content: '#lao bar' }, { content: 'baz' }]\n const result = tb.excludeTasksWithPatterns(tasks, '#planning , #lao')\n expect(result.length).toEqual(1)\n expect(result[0].content).toEqual('baz')\n })\n })\n\n describe('dwertheimer.EventAutomations - timeblocking.getFullParagraphsCorrespondingToSortList ', () => {\n const origParas = [\n { content: 'foo', rawContent: 'foo' },\n { content: 'bar', rawContent: 'bar' },\n { content: 'baz', rawContent: 'baz' },\n ]\n const sortList = [\n { content: 'baz', raw: 'baz' },\n { content: 'foo', raw: 'foo' },\n { content: 'bar', raw: 'bar' },\n ]\n test('should match the order', () => {\n const res = tb.getFullParagraphsCorrespondingToSortList(origParas, sortList)\n expect(res.length).toEqual(3)\n expect(res[0]).toEqual(origParas[2])\n })\n test('should exclude tasks with spaces', () => {\n const res = tb.getFullParagraphsCorrespondingToSortList(origParas, sortList)\n expect(res[0]).toEqual(origParas[2])\n })\n })\n\n describe('appendLinkIfNecessary', () => {\n let fname\n beforeAll(() => {\n fname = Editor.filename\n Editor.filename = 'foo.md'\n })\n afterAll(() => {\n Editor.filename = fname\n })\n const paragraphs = [\n { content: 'foo', type: 'done', filename: 'foof.md' },\n { content: 'bar', type: 'open', filename: 'barf.md' },\n { content: 'baz', type: 'list', filename: 'bazf.txt' },\n { content: 'baz', type: 'text', filename: 'bazf.txt' },\n ]\n\n test('should do nothing if includeLinks is OFF', () => {\n const res = tb.appendLinkIfNecessary(paragraphs, { ...config, includeLinks: 'OFF' })\n expect(res).toEqual(paragraphs)\n })\n test('should do nothing if todos array is empty', () => {\n const res = tb.appendLinkIfNecessary([], config)\n expect(res).toEqual([])\n })\n test('should do nothing if todo type is title', () => {\n const p = [{ type: 'title', content: 'foo' }]\n const res = tb.appendLinkIfNecessary(p, config)\n expect(res).toEqual(p)\n })\n test('should add wikilink to content in form of [[title#heading]]', () => {\n const note = new Note({ title: 'foo', filename: Editor.filename })\n const p = [{ type: 'open', content: 'ugh', heading: 'bar', note }]\n note.paragraphs = p\n const res = tb.appendLinkIfNecessary(p, { ...config, includeLinks: '[[internal#links]]' })\n expect(res[0].content).toEqual('ugh [[foo^123456]]')\n })\n test('should add url-style link to content in form of noteplan://', () => {\n const note = new Note({ title: 'foo', filename: Editor.filename })\n const p = [{ type: 'open', content: 'ugh', heading: 'bar', filename: 'baz', note }]\n note.paragraphs = p\n const res = tb.appendLinkIfNecessary(p, { ...config, includeLinks: 'Pretty Links', linkText: '%' })\n expect(res[0].content).toEqual('ugh [%](noteplan://x-callback-url/openNote?noteTitle=foo%5E123456)')\n })\n })\n /*\n * cleanText()\n */\n describe('cleanText()' /* function */, () => {\n test('should do nothing if no text to replace', () => {\n const before = ''\n const after = before\n const replacements = []\n const result = tb.cleanText(before, replacements)\n expect(result).toEqual(after)\n })\n test('should do nothing if matchers to replace', () => {\n const before = 'foo bar baz'\n const after = before\n const replacements = []\n const result = tb.cleanText(before, replacements)\n expect(result).toEqual(after)\n })\n test('should do a basic string replace', () => {\n const before = 'foo bar baz'\n const after = 'foo baz'\n const replacements = ['bar']\n const result = tb.cleanText(before, replacements)\n expect(result).toEqual(after)\n })\n test('should do a basic regex replace', () => {\n const before = 'foo bar baz'\n const after = 'foo baz'\n const replacements = [/bar/]\n const result = tb.cleanText(before, replacements)\n expect(result).toEqual(after)\n })\n test('should clean up double spaces', () => {\n const before = 'foo bar baz'\n const after = 'foo baz'\n const replacements = [/bar/]\n const result = tb.cleanText(before, replacements)\n expect(result).toEqual(after)\n })\n test('should remove timeblock at start', () => {\n const before = '00:01-12:22 foo bar baz'\n const after = 'foo bar baz'\n const replacements = [new RegExp(`^\\\\d{2}:\\\\d{2}-\\\\d{2}:\\\\d{2} `)]\n const result = tb.cleanText(before, replacements)\n expect(result).toEqual(after)\n })\n })\n\n /*\n * cleanTimeBlockLine()\n */\n describe('cleanTimeBlockLine()' /* function */, () => {\n test('should remove time', () => {\n const before = '00:01-12:22 foo bar baz'\n const after = 'foo bar baz'\n const config = { timeBlockTag: '#🕑' }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove ATB tag', () => {\n const before = 'foo bar baz #🕑'\n const after = 'foo bar baz'\n const config = { timeBlockTag: '#🕑' }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove duration 5m', () => {\n const before = \"foo bar baz '5m\"\n const after = 'foo bar baz'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove wiki link', () => {\n const before = 'foo bar baz [[foo]]'\n const after = 'foo bar baz'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove any url', () => {\n const before = 'foo [bar](noteplan://baz)'\n const after = 'foo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('what if there are two urls on a line', () => {\n const before = 'foo [bar](noteplan://baz) zoo [bar](noteplan://baz)'\n const after = 'foo zoo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove today tag', () => {\n const before = 'foo >today'\n const after = 'foo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove date tag', () => {\n const before = 'foo >2022-01-01'\n const after = 'foo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove week tag', () => {\n const before = 'foo >2022-W01'\n const after = 'foo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove month tag', () => {\n const before = 'foo >2022-01'\n const after = 'foo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove quarter tag', () => {\n const before = 'foo >2022-Q1'\n const after = 'foo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n test('should remove year tag', () => {\n const before = 'foo >2022'\n const after = 'foo'\n const config = { timeBlockTag: '🕑', durationMarker: \"'\" }\n const result = tb.cleanTimeBlockLine(before, config)\n expect(result).toEqual(after)\n })\n })\n\n // describe('isAutoTimeBlockLine', () => {\n // test('should return null if there are no ATB lines', () => {\n // const line = '222 no timeblock in here #foo'\n // expect(tb.isAutoTimeBlockLine(line, {})).toEqual(null)\n // })\n // test('should find a standard timeblock line', () => {\n // const line = '- 21:00-21:15 Respond to x.la [–](noteplan://x-callback-url/openNote?filename=20220512.md) #🕑'\n // const exp = 'Respond to x.la'\n // expect(tb.isAutoTimeBlockLine(line, {})).toEqual(exp)\n // })\n // test('should find a * at the front', () => {\n // const line = '* 21:00-21:15 Respond to x.la [–](noteplan://x-callback-url/openNote?filename=20220512.md) #🕑'\n // const exp = 'Respond to x.la'\n // expect(tb.isAutoTimeBlockLine(line, {})).toEqual(exp)\n // })\n // test('should find with nonstandard tag', () => {\n // const line =\n // '* 21:00-21:15 Respond to x.la [–](noteplan://x-callback-url/openNote?filename=20220512.md) #something'\n // const exp = 'Respond to x.la'\n // expect(tb.isAutoTimeBlockLine(line, {})).toEqual(exp)\n // })\n // test('should find with a wiki link', () => {\n // const line = '- 19:20-19:35 Send landing page howto [[yo#something]] #🕑'\n // const exp = `Send landing page howto`\n // expect(tb.isAutoTimeBlockLine(line, {})).toEqual(exp)\n // })\n // })\n })\n})\n\n/*\nappendLinkIfNecessary\n*/\n\n/*\n * processByTimeBlockTag()\n */\ndescribe('processByTimeBlockTag()' /* function */, () => {\n test('When in mode: BY_TIMEBLOCK_TAG, should do exactly the same as matchTaskToSlots if there are no named slots (e.g. you have not specified a matching time block)', () => {\n // now test line which had no time attached\n const timeBlocks = [\n { start: '00:00', end: '00:10', minsAvailable: 10, title: '' },\n { start: '00:40', end: '00:45', minsAvailable: 5, title: '' },\n ]\n const timeMap = [\n { start: '00:00', busy: false, index: 1 },\n { start: '00:05', busy: false, index: 2 },\n { start: '00:40', busy: false, index: 5 },\n ]\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 5,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n }\n const sortedTaskList = [{ content: 'Do something #timblock' }, { content: 'line2' }, { content: 'line3' }]\n const timeBlockTextList = ['* 00:00-00:05 Do something #timblock #🕑 #tb', '* 00:05-00:10 line2 #🕑 #tb', '* 00:40-00:45 line3 #🕑 #tb']\n const res = byTagMode.processByTimeBlockTag(sortedTaskList, { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual(timeBlockTextList)\n })\n test('should place one named item', () => {\n // now test line which had no time attached\n const timeBlocks = [\n { start: '00:00', end: '00:20', minsAvailable: 20, title: '' },\n { start: '00:20', end: '00:30', minsAvailable: 10, title: 'foo' },\n { start: '00:30', end: '00:35', minsAvailable: 5, title: '' },\n ]\n const timeMap = [\n { start: '00:00', busy: false, index: 1 },\n { start: '00:05', busy: false, index: 2 },\n { start: '00:10', busy: false, index: 3 },\n { start: '00:15', busy: false, index: 4 },\n { start: '00:20', busy: 'foo #tb', index: 5 },\n { start: '00:25', busy: 'foo #tb', index: 6 },\n { start: '00:30', busy: false, index: 7 },\n ]\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 20,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n }\n const sortedTaskList = [{ content: 'Do something #foo' }]\n const res = byTagMode.processByTimeBlockTag(sortedTaskList, { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual([`* 00:20-00:25 Do something #foo #🕑 #tb`])\n })\n test('should place two tasks in one named timeblock', () => {\n // now test line which had no time attached\n const timeBlocks = [\n { start: '00:00', end: '00:20', minsAvailable: 20, title: '' },\n { start: '00:20', end: '00:30', minsAvailable: 10, title: 'foo' },\n { start: '00:30', end: '00:35', minsAvailable: 5, title: '' },\n ]\n const timeMap = [\n { start: '00:00', busy: false, index: 1 },\n { start: '00:05', busy: false, index: 2 },\n { start: '00:10', busy: false, index: 3 },\n { start: '00:15', busy: false, index: 4 },\n { start: '00:20', busy: 'foo #tb', index: 5 },\n { start: '00:25', busy: 'foo #tb', index: 6 },\n { start: '00:30', busy: false, index: 7 },\n ]\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 20,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n }\n const sortedTaskList = [{ content: 'Do something #foo' }, { content: 'Do something else #foo' }]\n const res = byTagMode.processByTimeBlockTag(sortedTaskList, { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual(['* 00:20-00:25 Do something #foo #🕑 #tb', '* 00:25-00:30 Do something else #foo #🕑 #tb'])\n })\n test('should place two tasks in one named timeblock but not a third that doesnt fit', () => {\n // now test line which had no time attached\n const timeBlocks = [\n { start: '00:00', end: '00:20', minsAvailable: 20, title: '' },\n { start: '00:25', end: '00:35', minsAvailable: 10, title: 'foo' },\n { start: '00:40', end: '00:45', minsAvailable: 5, title: 'bar' },\n ]\n const timeMap = [\n { start: '00:00', busy: false, index: 1 },\n { start: '00:05', busy: false, index: 2 },\n { start: '00:10', busy: false, index: 3 },\n { start: '00:15', busy: false, index: 4 },\n { start: '00:25', busy: 'foo #tb', index: 10 },\n { start: '00:30', busy: 'foo #tb', index: 11 },\n { start: '00:40', busy: 'bar #tb', index: 20 },\n ]\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 5,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n }\n const sortedTaskList = [{ content: 'Do something #foo' }, { content: 'Do something else #foo' }, { content: 'this wont fit #foo' }]\n const res = byTagMode.processByTimeBlockTag(sortedTaskList, { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual(['* 00:25-00:30 Do something #foo #🕑 #tb', '* 00:30-00:35 Do something else #foo #🕑 #tb'])\n })\n test('should place two tasks in one named timeblock and another in another one', () => {\n // now test line which had no time attached\n const timeBlocks = [\n { start: '00:00', end: '00:05', minsAvailable: 5, title: '' },\n { start: '00:20', end: '00:30', minsAvailable: 10, title: 'foo' },\n { start: '00:40', end: '00:50', minsAvailable: 10, title: 'bar' },\n ]\n const timeMap = [\n { start: '00:00', busy: false, index: 1 },\n { start: '00:20', busy: '#foo #tb', index: 5 },\n { start: '00:25', busy: '#foo #tb', index: 6 },\n { start: '00:40', busy: '#bar #tb', index: 10 },\n { start: '00:45', busy: '#bar #tb', index: 11 },\n ]\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 5,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '#tb',\n }\n const sortedTaskList = [{ content: 'this is another #bar' }, { content: 'Do something #foo' }, { content: 'Do something else #foo' }]\n const res = byTagMode.processByTimeBlockTag(sortedTaskList, { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual(expect.arrayContaining(['* 00:20-00:25 Do something #foo #🕑 #tb']))\n expect(res.timeBlockTextList).toEqual(expect.arrayContaining(['* 00:25-00:30 Do something else #foo #🕑 #tb']))\n expect(res.timeBlockTextList).toEqual(expect.arrayContaining(['* 00:40-00:45 this is another #bar #🕑 #tb']))\n })\n test('should place tasks in a named timeblock and a plain task in a regular open area', () => {\n // now test line which had no time attached\n const timeBlocks = [\n { start: '00:00', end: '00:05', minsAvailable: 5, title: '' },\n { start: '00:20', end: '00:30', minsAvailable: 10, title: 'foo' },\n { start: '00:40', end: '00:50', minsAvailable: 10, title: 'bar' },\n ]\n const timeMap = [\n { start: '00:00', busy: false, index: 1 },\n { start: '00:20', busy: '#foo 🕑', index: 5 },\n { start: '00:25', busy: '#foo 🕑', index: 6 },\n { start: '00:40', busy: '#bar 🕑', index: 10 },\n { start: '00:45', busy: '#bar 🕑', index: 11 },\n ]\n const cfg = {\n ...config,\n nowStrOverride: '00:00',\n workDayStart: '00:00',\n intervalMins: 5,\n defaultDuration: 5,\n mode: 'BY_TIMEBLOCK_TAG',\n timeblockTextMustContainString: '🕑',\n }\n const sortedTaskList = [{ content: 'this is another #bar' }, { content: 'Do something #foo' }, { content: 'Do something outside' }]\n const res = byTagMode.processByTimeBlockTag(sortedTaskList, { blockList: timeBlocks, timeMap: timeMap, timeBlockTextList: [] }, cfg)\n expect(res.timeBlockTextList).toEqual(expect.arrayContaining(['* 00:00-00:05 Do something outside #🕑']))\n expect(res.timeBlockTextList).toEqual(expect.arrayContaining(['* 00:20-00:25 Do something #foo #🕑']))\n expect(res.timeBlockTextList).toEqual(expect.arrayContaining(['* 00:40-00:45 this is another #bar #🕑']))\n })\n})\n" }, { "path": "dwertheimer.EventAutomations/__tests__/timeblocking-shared.test.js", "content": "/* eslint-disable no-unused-vars */\n/* eslint-disable import/order */\n/* global jest, describe, test, expect, beforeAll, afterAll, beforeEach, afterEach */\nimport * as configFile from '../src/config'\nimport { deleteParagraphsContainingString, insertItemsIntoNote } from '../src/timeblocking-shared'\nimport { CustomConsole, LogType, LogMessage } from '@jest/console' // see note below\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, simpleFormatter, Paragraph, Note, mockWasCalledWithString } from '@mocks/index'\n\nconst PLUGIN_NAME = `dwertheimer.EventAutomations`\nconst FILENAME = `timeblocking-shared.js`\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = new NotePlan()\n global.console = new CustomConsole(process.stdout, process.stderr, simpleFormatter) // minimize log footprint\n DataStore.settings['_logLevel'] = 'none' //change this to DEBUG to get more logging (or 'none' for none)\n})\n\n/* Samples:\nTo use factories (from the factories folder inside of __tests__):\nconst testFile = new Note(JSON.parse(await loadFactoryFile(__dirname, 'jgclarksSortTest.json')))\n // load a factory file from the __tests__/factories folder\nexpect(result).toMatch(/someString/)\nexpect(result).not.toMatch(/someString/)\nexpect(() => compileAndroidCode()).toThrow(/JDK/);\nexpect(result).toEqual([])\n// object matching - important to not use exact match because you may add fields later\n expect(result).toEqual(expect.objectContaining({ field1: true, field2: 'someString'}))\n// or if you want to check if an array has objects in it with certain fields:\ntest('we should have name 1 and 2', () => {\n expect(users).toEqual(\n expect.arrayContaining([\n expect.objectContaining({name: 1}),\n expect.objectContaining({name: 2})\n ])\n );\n});\n\nimport { mockWasCalledWith } from '@mocks/mockHelpers'\n const spy = jest.spyOn(console, 'log')\n const result = mainFile.getConfig()\n expect(mockWasCalledWith(spy, /config was empty/)).toBe(true)\n spy.mockRestore()\n\n test('should return the command object', () => {\n const result = f.getPluginCommands({ 'plugin.commands': [{ a: 'foo' }] })\n expect(result).toEqual([{ a: 'foo' }])\n })\n*/\n\ndescribe(`${PLUGIN_NAME}`, () => {\n describe(`${FILENAME}`, () => {\n //functions go here using jfunc command\n /*\n * deleteParagraphsContainingString()\n */\n describe('deleteParagraphsContainingString()' /* function */, () => {\n /* template:\n test('should XXX', () => {\n const result = mainFile.deleteParagraphsContainingString()\n expect(result).toEqual(true)\n })\n */\n test('should not delete anything if no matches', () => {\n const paras = [new Paragraph({ content: 'line1', type: 'open' }), new Paragraph({ content: 'line2', type: 'open' })]\n const note = new Note({ paragraphs: paras })\n const spy = jest.spyOn(note, 'removeParagraphs')\n deleteParagraphsContainingString(note, 'xxx')\n expect(spy).not.toHaveBeenCalled()\n spy.mockRestore()\n })\n test('should call delete with matching line', () => {\n const paras = [new Paragraph({ content: 'line1', type: 'open' }), new Paragraph({ content: 'line2', type: 'open' })]\n const note = new Note({ paragraphs: paras })\n const spy = jest.spyOn(note, 'removeParagraphs')\n deleteParagraphsContainingString(note, 'line1')\n expect(spy).toHaveBeenCalledWith([paras[0]])\n spy.mockRestore()\n })\n })\n /*\n * insertItemsIntoNote()\n */\n describe('insertItemsIntoNote()' /* function */, () => {\n /* template:\n test('should XXX', () => {\n const result = mainFile.insertItemsIntoNote()\n expect(result).toEqual(true)\n })\n */\n test('should fail gracefully with missing list', () => {\n const note = new Note({ type: 'Notes', paragraphs: [new Paragraph({ content: 'line1', type: 'open' })] })\n const list = null\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list)\n expect(spy).not.toHaveBeenCalled() //inserts nothing\n spy.mockRestore()\n })\n test('should fail gracefully with empty list', () => {\n const note = new Note({ type: 'Notes', paragraphs: [new Paragraph({ content: 'line1', type: 'open' })] })\n const list = []\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list)\n expect(spy).not.toHaveBeenCalled() //inserts nothing\n spy.mockRestore()\n })\n test('should work with null/default params and no title', () => {\n const note = new Note({ type: 'Notes', paragraphs: [new Paragraph({ content: 'line1', type: 'open' })] })\n const list = ['line1', 'line2']\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list)\n expect(spy).toHaveBeenCalledWith(list.join('\\n'), 0, 'text')\n spy.mockRestore()\n })\n test('should work with null/default params and a title', () => {\n const note = new Note({ type: 'Notes', paragraphs: [new Paragraph({ content: 'title1', rawContent: '# title1', headingLevel: 1, type: 'title' })] })\n const list = ['line1', 'line2']\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list)\n expect(spy).toHaveBeenCalledWith(list.join('\\n'), 1, 'text')\n spy.mockRestore()\n })\n test('should work with empty heading', () => {\n const note = new Note({ type: 'Notes', paragraphs: [new Paragraph({ content: 'line1', type: 'open' })] })\n const list = ['line1', 'line2']\n const heading = ''\n const config = configFile.getTimeBlockingDefaults()\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list, heading, false, config)\n expect(spy).toHaveBeenCalledWith(list.join('\\n'), 0, 'text')\n spy.mockRestore()\n })\n test('should call insert content under heading', () => {\n const note = new Note({ type: 'Notes', paragraphs: [new Paragraph({ content: 'line1', type: 'open' })] })\n const list = ['line1', 'line2']\n const heading = 'heading'\n const config = configFile.getTimeBlockingDefaults()\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list, heading, false, config)\n const text = `## ${heading}\\n`.concat(list.join('\\n')).concat('\\n')\n expect(spy).toHaveBeenCalledWith(text, 0, 'text')\n spy.mockRestore()\n })\n test('should ignore folding if heading is empty', () => {\n const note = new Note({ paragraphs: [new Paragraph({ content: 'line1', type: 'open' })] })\n const list = ['line1', 'line2']\n const heading = ''\n const config = configFile.getTimeBlockingDefaults()\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list, heading, true, config)\n expect(spy).toHaveBeenCalledWith(list.join('\\n'), 0, 'text') //inserts nothing\n spy.mockRestore()\n })\n //TODO FIXME: stopped working here:\n test.skip('should find heading and insert under it', () => {\n const note = new Note({\n paragraphs: [\n new Paragraph({ content: 'old1head', type: 'title' }),\n new Paragraph({ content: 'old1head', type: 'title' }),\n new Paragraph({ content: 'old2', type: 'open' }),\n ],\n })\n const list = ['new1', 'new2']\n const heading = 'old1head'\n const config = configFile.getTimeBlockingDefaults()\n const spy = jest.spyOn(note, 'insertParagraph')\n insertItemsIntoNote(note, list, heading, true, config)\n expect(spy).toHaveBeenCalledWith(list.join('\\n'), 1, 'text') //inserts nothing\n spy.mockRestore()\n })\n })\n // end of function tests\n }) // end of describe(`${FILENAME}`\n}) // // end of describe(`${PLUGIN_NAME}`\n" }, { "path": "dwertheimer.EventAutomations/__tests__/timeblocking-taskSorting.test.js", "content": "/* globals describe, expect, it, test, DataStore */\n// import { differenceInCalendarDays, endOfDay, startOfDay, eachMinuteOfInterval, formatISO9075 } from 'date-fns'\nimport { DataStore, Editor, CommandBar, NotePlan } from '@mocks/index'\nimport * as tb from '../src/timeblocking-helpers'\nimport { getTasksByType, sortListBy } from '@helpers/sorting'\n\n// Make DataStore and Editor available globally for the source code\nglobal.DataStore = DataStore\nglobal.Editor = Editor\nglobal.CommandBar = CommandBar\nglobal.NotePlan = NotePlan\n// import { isNullableTypeAnnotation } from '@babel/types'\n\n// Jest suite\ndescribe('taskSorting', () => {\n // testing this here because i am using it here and want to be sure it works\n // and the signatures don't change\n test('dwertheimer.TaskAutomations - getTasksByType ', () => {\n const paragraphs = [\n {\n type: 'open',\n indents: 0,\n content: 'test content',\n rawContent: '* test content',\n },\n {\n type: 'scheduled',\n indents: 0,\n content: 'test content',\n rawContent: '* test content',\n },\n ]\n const taskList = getTasksByType(paragraphs)\n expect(taskList['open'].length).toEqual(1)\n expect(taskList['scheduled'].length).toEqual(1)\n expect(taskList['open'][0].content).toEqual(paragraphs[0].content)\n })\n\n test('dwertheimer.TaskAutomations - sortListBy alphabetical', () => {\n const paragraphs = [\n {\n type: 'open',\n indents: 0,\n content: 'test content',\n rawContent: '* test content',\n },\n ]\n let taskList = getTasksByType(paragraphs)\n let sorted = sortListBy(taskList['open'], 'content')\n expect(sorted[0].content).toEqual(paragraphs[0].content)\n //\n paragraphs.push({\n type: 'open',\n indents: 0,\n content: 'a test content',\n rawContent: '* a test content',\n })\n taskList = getTasksByType(paragraphs)\n sorted = sortListBy(taskList['open'], 'content')\n expect(sorted[0].content).toEqual(paragraphs[1].content)\n })\n test('dwertheimer.TaskAutomations - sortListBy priority (!,!!,!!!) if at the front of the line', () => {\n const paragraphs = [\n {\n type: 'open',\n indents: 0,\n content: '! test content',\n rawContent: '* ! test content',\n },\n ]\n paragraphs.push({\n type: 'open',\n indents: 0,\n content: '!!! a test content !!!',\n rawContent: '* !!! a test content',\n })\n paragraphs.push({\n type: 'open',\n indents: 0,\n content: '!! a test content',\n rawContent: '* !! a test content',\n })\n const taskList = getTasksByType(paragraphs)\n const sorted = sortListBy(taskList['open'], 'priority')\n expect(sorted[0].content).toEqual(paragraphs[0].content)\n expect(sorted[1].content).toEqual(paragraphs[2].content)\n })\n test('dwertheimer.TaskAutomations - sortListBy ignores priority if not at the front of the line', () => {\n const paragraphs = [\n {\n type: 'open',\n indents: 0,\n content: 'test content !',\n rawContent: '* test content !',\n },\n ]\n paragraphs.push({\n type: 'open',\n indents: 0,\n content: 'a test content !!!',\n rawContent: '* a test content !!!',\n })\n paragraphs.push({\n type: 'open',\n indents: 0,\n content: 'a test content !!',\n rawContent: '* a test content !!',\n })\n const taskList = getTasksByType(paragraphs)\n const sorted = sortListBy(taskList['open'], 'priority')\n expect(sorted[0].content).toEqual(paragraphs[0].content)\n expect(sorted[1].content).toEqual(paragraphs[1].content)\n expect(sorted[2].content).toEqual(paragraphs[2].content)\n })\n})\n" }, { "path": "dwertheimer.EventAutomations/plugin.json", "content": "{\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.6\",\n \"plugin.id\": \"dwertheimer.EventAutomations\",\n \"plugin.name\": \"🗓 AutoTimeBlocking / Events\",\n \"plugin.description\": \"Various Event Automations:\\n- Automatically find time in your calendar and create Time Blocks for items marked for today,\\n- Write out synced copies of Today's todos (without the AutoTimeBlocking), and\\n- Create calendar events for all text items under a specific heading\",\n \"plugin.author\": \"dwertheimer\",\n \"plugin.version\": \"1.22.0\",\n \"plugin.lastUpdateInfo\": \"1.22.0: Add setting to leave completed timeblocks in the note for posterity\",\n \"plugin.dependencies\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.url\": \"https://noteplan.co/n/#/1EF12392-B544-4044-AC7A-428F57EB2DFC\",\n \"plugin.changelog\": \"https://github.com/NotePlan/plugins/blob/main/dwertheimer.EventAutomations/CHANGELOG.md\",\n \"plugin.commands\": [\n {\n \"name\": \"Event Automations: Update Plugin Settings\",\n \"description\": \"Preferences\",\n \"jsFunction\": \"editSettings\"\n },\n {\n \"name\": \"atb - Create AutoTimeBlocks for >today's Tasks\",\n \"description\": \"Read >today todos and insert them into today's calendar note as timeblocks\",\n \"jsFunction\": \"insertTodosAsTimeblocks\",\n \"alias\": [\n \"atb\",\n \"abt\",\n \"timeblocks\",\n \"block\",\n \"todoblocks\"\n ]\n },\n {\n \"name\": \"mdatb\",\n \"description\": \"Mark task on current line done and run /atb to re-create timeblocks\",\n \"jsFunction\": \"markDoneAndRecreateTimeblocks\",\n \"alias\": [\n \"done\",\n \"mark\"\n ]\n },\n {\n \"name\": \"Create AutoTimeBlocks using presets\",\n \"description\": \"Read >today todos and insert them into today's calendar note as timeblocks, but using presets defined in _configuration note\",\n \"jsFunction\": \"insertTodosAsTimeblocksWithPresets\",\n \"alias\": [\n \"atbp\",\n \"abtp\",\n \"tbp\"\n ]\n },\n {\n \"name\": \"Insert Synced Todos for Open Calendar Note\",\n \"description\": \"Output a list of todos for the day open in the editor (any todos in the References pane will show up -- either >dated or >today if you're on today's note)\",\n \"jsFunction\": \"insertSyncedCopiesOfTodayTodos\",\n \"alias\": [\n \"syncedTodos\",\n \"insertSynced\"\n ],\n \"arguments\": [\n \"'Yes' to Pass back synced todos as text (e.g. for inserting in a template).\"\n ]\n },\n {\n \"name\": \"Remove Time Blocks for Open Calendar Note\",\n \"description\": \"Remove the contents of Time Blocks created by this plugin\",\n \"jsFunction\": \"removeTimeBlocks\",\n \"alias\": [\n \"remTimeBlocks\"\n ]\n },\n {\n \"name\": \"Remove All Previous Time Blocks in Calendar Notes Written by this Plugin\",\n \"description\": \"Remove previously written Time Blocks\",\n \"jsFunction\": \"removePreviousTimeBlocks\",\n \"alias\": [\n \"remAllTimeBlocks\"\n ],\n \"arguments\": [\n \"Run silently with no pop-up messages (e.g. running from a Template) - (yes/no) - yes to run silently\"\n ]\n },\n {\n \"name\": \"cevt - Create Events From Text under heading\",\n \"description\": \"Create calendar events by writing (natural language) text under a heading\",\n \"jsFunction\": \"createEvents\",\n \"alias\": [\n \"cevt\",\n \"createevents\"\n ],\n \"arguments\": [\n \"Heading under which events are written\",\n \"Ask for confirmation on choices? yes or no for best guess\",\n \"Calendar name to write events to (leave blank to be prompted)\"\n ]\n },\n {\n \"name\": \"pevt - Prompt for Natural Language Event text\",\n \"description\": \"Create calendar events by writing (natural language) via prompt\",\n \"jsFunction\": \"createEventPrompt\",\n \"alias\": [\n \"pevt\",\n \"promptevents\"\n ],\n \"arguments\": [\n \"Name of the heading to place the created event under\"\n ]\n },\n {\n \"name\": \"onEditorWillSave\",\n \"description\": \"onEditorWillSave\",\n \"jsFunction\": \"onEditorWillSave\",\n \"alias\": [],\n \"arguments\": [],\n \"hidden\": true\n }\n ],\n \"plugin.settings\": [\n {\n \"type\": \"hidden\",\n \"key\": \"plugin_ID\",\n \"default\": \"dwertheimer.EventAutomations\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"AutoTimeBlocking Settings: General\"\n },\n {\n \"key\": \"defaultDuration\",\n \"type\": \"number\",\n \"title\": \"Default time block duration (minutes)\",\n \"description\": \"Any task that does not have a specific duration stated (see below) will have this default length in minutes\",\n \"default\": 15,\n \"required\": true\n },\n {\n \"key\": \"includeAllTodos\",\n \"title\": \"Include all todos in today's note\",\n \"description\": \"If checked, all open todos in today's note will be considered for timeblocks (time permitting). If unchecked, only todos marked with >today or >dated with today's date will be included. NOTE: if you use the todo character (e.g. '*') for your TimeBlocks leading character, this could cause issues.\",\n \"type\": \"bool\",\n \"default\": true,\n \"required\": true\n },\n {\n \"key\": \"allowEventSplits\",\n \"type\": \"bool\",\n \"title\": \"Allow tasks to be split\",\n \"description\": \"Allow tasks to be split into multiple time blocks\",\n \"default\": false,\n \"required\": true\n },\n {\n \"key\": \"durationMarker\",\n \"type\": \"string\",\n \"title\": \"Task duration marker\",\n \"description\": \"The character that signifies the start of a task duration (e.g. in the task: \\n* do something '2h44m\\nThe duration marker is the apostrophe\",\n \"default\": \"'\",\n \"choices\": [\n \"'\",\n \"~\",\n \"^\",\n \";\",\n \"%\",\n \"$\",\n \"+\"\n ],\n \"required\": true\n },\n {\n \"key\": \"todoChar\",\n \"type\": \"string\",\n \"validation\": \"^(?!(?:.*\\\\*){2})[\\\\*|\\\\-|\\\\+|#{1,}]+$\",\n \"choices\": [\n \"*\",\n \"-\",\n \"+\",\n \"#\",\n \"##\",\n \"###\",\n \"####\"\n ],\n \"title\": \"Time block leading character\",\n \"description\": \"For NotePlan to recognize a line as a Time Block, the leading character must be one of: a '*', a '-', a '+' (for a checklist box) or one or more '#'s. AutoTimeBlocking will use this to create your timeblocks.\",\n \"default\": \"+\",\n \"required\": true\n },\n {\n \"key\": \"checkedItemChecksOriginal\",\n \"title\": \"Checking a checklist item marks the original item done\",\n \"description\": \"Checking off a checklist AutoTimeBlocked line item will find and check the original task. To make this work, the onEditorWillSave trigger/frontmatter will be automatically added by the plugin.\\nIMPORTANT NOTE: Only applies if:\\n(1) you use the \\\"+\\\" for your Time Block Leading Character and\\n(2) the 'Include links to task location in time blocks' is set to 'Pretty Links'\",\n \"type\": \"bool\",\n \"default\": false,\n \"required\": true\n },\n {\n \"key\": \"leaveCompletedTBs\",\n \"title\": \"Leave completed timeblocks when re-calculating?\",\n \"description\": \"Timeblocks that have been marked complete will remain in the note/calendar when timeblocks are re-calculated.\",\n \"type\": \"bool\",\n \"default\": false,\n \"required\": true\n },\n {\n \"key\": \"timeBlockTag\",\n \"type\": \"string\",\n \"title\": \"Unique AutoTimeBlock #tag (cannot be empty)\",\n \"description\": \"The tag that will be used to identify lines created the AutoTimeBlock plugin. This tag can be #(anything), but should be not ever used by you in other places, because the plugin deletes lines with this tag before updating them.\",\n \"default\": \"#🕑\",\n \"required\": true\n },\n {\n \"key\": \"removeDuration\",\n \"type\": \"bool\",\n \"title\": \"Remove duration from time block\",\n \"description\": \"The plugin uses your duration designation (e.g. '2h44m) to determine how long a task should take. But you probably don't want that duration to show on the calendar. If you do want to see it, uncheck this item.\",\n \"default\": true,\n \"required\": true\n },\n {\n \"key\": \"timeBlockHeading\",\n \"type\": \"string\",\n \"validation\": \"^[^#+].*\",\n \"title\": \"Heading for time blocks in note\",\n \"description\": \"If this heading exists in the open note when running the AutoTimeBlock command, the generated time blocks will be placed under it. If you leave it blank, the time blocks will be placed at the top of the note. Text only -- should *not* include any #'s at the beginning of the heading.\",\n \"default\": \"[Time Blocks](noteplan://runPlugin?pluginID=dwertheimer.EventAutomations&command=atb%20-%20Create%20AutoTimeBlocks%20for%20%3Etoday%27s%20Tasks)\",\n \"required\": true\n },\n {\n \"key\": \"foldTimeBlockHeading\",\n \"type\": \"bool\",\n \"title\": \"Fold created time blocks under heading\",\n \"description\": \"Reduce the noise on your calendar page by folding the time blocks that get created under the heading. NOTE: Due to some recent changes in NotePlan, Timeblocks under folded headings don't display. So this option is false by default.\",\n \"default\": false,\n \"required\": true\n },\n {\n \"key\": \"workDayStart\",\n \"type\": \"string\",\n \"validation\": \"^\\\\d{2}:\\\\d{2}$\",\n \"title\": \"Start of work day\",\n \"description\": \"If set to anything other than 00:00, no time blocks will be placed before this time. needs to be in 24 hour format (two digits, leading zero, colon in between).\",\n \"default\": \"00:00\",\n \"required\": true\n },\n {\n \"key\": \"workDayEnd\",\n \"type\": \"string\",\n \"validation\": \"^\\\\d{2}:\\\\d{2}$\",\n \"title\": \"End of work day\",\n \"description\": \"If set to anything other than 23:59, no time blocks will be allowed to extend past this time. needs to be in 24 hour format (two digits, leading zero, colon in between).\",\n \"default\": \"23:59\",\n \"required\": true\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Synced Copies\"\n },\n {\n \"key\": \"createSyncedCopies\",\n \"type\": \"hidden\",\n \"title\": \"Automatically create synced copies of References items when ATB runs\",\n \"description\": \"When /atb (AutoTimeBlocking) command is run, write a synced line (copy) of the Reference item in the calendar note. Can look a little repetitive, but it will save you time when you want to edit the underlying item.\",\n \"default\": false,\n \"required\": true\n },\n {\n \"key\": \"syncedCopiesTitle\",\n \"type\": \"string\",\n \"title\": \"Title/heading for synced copies of today's items\",\n \"description\": \"When you generate synced copies of tasks, they will be placed under this heading in the calendar note\",\n \"default\": \" [Today's Synced Tasks](noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.EventAutomations&command=Insert%20Synced%20Todos%20for%20Open%20Calendar%20Note)\",\n \"required\": true\n },\n {\n \"key\": \"foldSyncedCopiesHeading\",\n \"type\": \"bool\",\n \"title\": \"Fold created synced copies under heading\",\n \"description\": \"Reduce the noise on your calendar page by folding the synced copy lines that get created under the heading.\",\n \"default\": false,\n \"required\": true\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Filters\"\n },\n {\n \"key\": \"includeTasksWithText\",\n \"type\": \"[string]\",\n \"title\": \"Include any tasks that match text:\",\n \"description\": \"If this field is set to any text, then any task that contains this text will be included in the timeblocks. This is useful if you want to limit tasks to items with a specific #hashtag for example. This field can also contain a comma separated list, e.g. 'someRawText, #hashtag1, #hashtag2'\",\n \"default\": [],\n \"required\": false\n },\n {\n \"key\": \"excludeTasksWithText\",\n \"type\": \"[string]\",\n \"title\": \"Exclude any tasks that match text:\",\n \"description\": \"If this field is set to any text, then any task that contains this text will *not* be included in the timeblocks. This field can also contain a comma separated list, e.g. 'someRawText, #hashtag1, @hashtag2'\",\n \"default\": [],\n \"required\": false\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Include Links\"\n },\n {\n \"type\": \"string\",\n \"title\": \"Include links to task location in time blocks\",\n \"key\": \"includeLinks\",\n \"choices\": [\n \"OFF\",\n \"[[internal#links]]\",\n \"Pretty Links\"\n ],\n \"default\": \"Pretty Links\",\n \"description\": \"Appends a link to the original location of a particular task. Can create a standard internal NotePlan link, e.g. [[internal#links]], or if you want to reduce clutter, a Pretty Link which will display only a single character (see below).\"\n },\n {\n \"type\": \"string\",\n \"title\": \"Link text/char (if Pretty Links selected above)\",\n \"key\": \"linkText\",\n \"default\": \"📄\",\n \"required\": true,\n \"description\": \"If Pretty Links is on, this it the character the link will display.\"\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Advanced: Other Settings\"\n },\n {\n \"key\": \"intervalMins\",\n \"type\": \"number\",\n \"title\": \"Time block start interval\",\n \"description\": \"Time blocks can only start every N minutes as dictated by this setting. For instance, if you want time blocks to only start every 15 minutes, set this to 15. This means you would at maximum have 4 time blocks per hour.\",\n \"default\": 5,\n \"required\": true\n },\n {\n \"key\": \"mode\",\n \"type\": \"string\",\n \"title\": \"Task->Time Block processing mode\",\n \"choices\": [\n \"PRIORITY_FIRST\",\n \"LARGEST_FIRST\",\n \"BY_TIMEBLOCK_TAG\",\n \"MANUAL_ORDERING\"\n ],\n \"description\": \"PRIORITY_FIRST places the highest priority (most !'s) first (if there's a slot) and then continues down the priority stack. LARGEST_FIRST tries to place the longest/largest duration item first. BY_TIMEBLOCK_TAG will try to slot items into a pre-existing timeblock that matches a tag on the task (e.g. a pre-existing timeblock called \\\"production\\\" and a task \\\"* do something #production\\\"). Will then fall back to PRIORITY_FIRST if no matching timeblock is found. MANUAL_ORDERING limits tasks to ones in today's note and orders them in the order they appear in the note.\",\n \"default\": \"PRIORITY_FIRST\",\n \"required\": true\n },\n {\n \"key\": \"orphanTagggedTasks\",\n \"title\": \"What to do with orphaned tagged timeblock tasks?\",\n \"description\": \"(this is only relevant when the setting above is set to BY_TIMEBLOCK_TAG). When placing tasks into timeblocks of matching tag, what should happen when there are more tasks than will fit in the matching time block?\",\n \"type\": \"string\",\n \"default\": \"OUTPUT_FOR_INFO (but don't schedule them)\",\n \"required\": true,\n \"choices\": [\n \"IGNORE_THEM\",\n \"OUTPUT_FOR_INFO (but don't schedule them)\",\n \"SCHEDULE_ELSEWHERE_LAST\",\n \"SCHEDULE_ELSEWHERE_FIRST\"\n ]\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"AutoTimeBlocking Settings: Presets\"\n },\n {\n \"key\": \"presets\",\n \"type\": \"json\",\n \"title\": \"Presets to temporarily override settings above\",\n \"description\": \"Presets are useful for changing some of the settings above but just for certain runs of the plugin (e.g. on the weekend, etc.). Read the documentation for how to use presets. Use Jsonlint.com to check changes you make in this blank for errors.\",\n \"default\": \"[\\n{\\n\\t\\\"label\\\":\\\"Limit Time Blocks to Work Hours\\\",\\n\\t\\\"workDayStart\\\":\\\"08:00\\\",\\n\\t\\\"workDayEnd\\\":\\\"17:59\\\"\\n},\\n{\\n\\t\\\"label\\\":\\\"Create Timeblocks on Calendar\\\",\\n\\t\\\"todoChar\\\":\\\"*\\\"\\n}\\n]\",\n \"required\": false\n },\n {\n \"key\": \"timeframes\",\n \"type\": \"json\",\n \"title\": \"Time-of-day Timeframes\",\n \"description\": \"When you are operating in 'BY_TIMEBLOCK_TAG' mode, you can have a task slotted into a particular part of the day by tagging it with a timeframe matching one in the above list. Each timeframe has a name (names can be whatever you want), a start and a stop time.\\nSo, if you have a task '* read book #late`, /atb will attempt to place it in the 'late' slot. Read the documentation for more on how to use this feature. Use Jsonlint.com to check changes you make in this blank for errors.\",\n \"default\": \"{\\n\\t\\\"early\\\": [\\\"07:00\\\",\\\"08:30\\\"],\\n\\t\\\"morning\\\": [\\\"08:30\\\",\\\"12:00\\\"],\\n\\t\\\"afternoon\\\": [\\\"12:00\\\",\\\"18:00\\\"],\\n\\t\\\"evening\\\": [\\\"18:00\\\",\\\"22:00\\\"],\\n\\t\\\"late\\\": [\\\"22:00\\\",\\\"23:00\\\"]\\n}\",\n \"required\": false\n },\n {\n \"type\": \"separator\",\n \"COMMENT\": \"---------- EVENT BLOCKS SETTINGS ----------\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Event Blocks Settings\"\n },\n {\n \"title\": \"Confirm when there are multiple options for what a date should be?\",\n \"key\": \"confirm\",\n \"type\": \"bool\",\n \"description\": \"Text you enter is processed and NotePlan makes a guess at what you mean. If NotePlan is not sure, it will give you choices. If you uncheck this, NotePlan will just use the first choice it finds (which may or may not be what you wanted).\",\n \"default\": true\n },\n {\n \"title\": \"Default event length (in mins) for items which have no end time\",\n \"key\": \"eventLength\",\n \"type\": \"string\",\n \"choices\": [\n \"5\",\n \"15\",\n \"20\",\n \"30\",\n \"60\",\n \"90\",\n \"120\"\n ],\n \"description\": \"If you enter 'Do something at 3pm', how long (in minutes) should that calendar item be?\",\n \"default\": \"30\"\n },\n {\n \"title\": \"Remove date text from content\",\n \"key\": \"removeDateText\",\n \"type\": \"bool\",\n \"description\": \"If selected, the text pertaining to date/time (e.g. 'Friday at 9am') will be removed from the text line when the event is created. Leaving this unchecked and the following setting checked is a good way to double-check the events get created at the proper date/time.\",\n \"default\": false\n },\n {\n \"title\": \"Show Event Created Date/Time\",\n \"key\": \"showResultingTimeDate\",\n \"type\": \"bool\",\n \"description\": \"If selected, the start time/date of the calendar event which was created will (temporarily) be displayed in the calendar event link. This is a good way to double-check that the computer understood what you meant in your text. Note: This text (but not the event link) goes away when the note is reloaded.\",\n \"default\": true\n },\n {\n \"COMMENT\": \"Commenting this out for now because NP rewrites the text\",\n \"title\": \"Calendar link text\",\n \"key\": \"linkText\",\n \"type\": \"hidden\",\n \"description\": \"Use this text for the short link to the calendar item. Leave blank for just the date text.\",\n \"default\": \"🔗\"\n },\n {\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"LOG\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much output will be displayed for this plugin the NotePlan > Help > Plugin Console. DEBUG is the most verbose; NONE is the least (silent)\",\n \"default\": \"LOG\",\n \"required\": true\n }\n ]\n}" }, { "path": "dwertheimer.EventAutomations/src/NPEventBlocks.js", "content": "// @flow\n\nimport { addMinutes } from 'date-fns'\nimport pluginJson from '../plugin.json'\nimport { log, logError, JSP, clo, logWarn, logDebug } from '@helpers/dev'\nimport { chooseHeading, chooseOption, showMessage, showMessageYesNoCancel } from '@helpers/userInput'\nimport { findHeading, getBlockUnderHeading } from '@helpers/NPParagraph'\nimport { smartPrependPara, smartAppendPara } from '@helpers/paragraph'\nimport { isReallyAllDay } from '@helpers/dateTime'\nimport { checkOrGetCalendar } from '@helpers/NPCalendar'\n\nexport const hasCalendarLink = (line: string): boolean => /\\!\\[📅\\]/.test(line)\n\nexport type EventBlocksConfig = {\n confirm: boolean,\n eventLength: string,\n removeDateText: boolean,\n linkText: string,\n showResultingTimeDate: boolean,\n version?: string,\n calendar?: string,\n}\n\ntype ConfirmedEvent = {\n revisedLine: string,\n originalLine: string,\n dateRangeInfo: ParsedTextDateRange,\n paragraph: TParagraph,\n index: number,\n}\n\n/**\n * (not used because NotePlan seems to rewrite the text on every page load so this is useless)\n * Replace the text of the calendar link with different text\n * @param {string} line - the line to check and replace\n * @param {string} replaceWith - the text to replace the calendar link text with\n * @returns\n */\nexport const replaceCalendarLinkText = (line: string, replaceWith: string): string => {\n const parts = line.split(':::')\n if (parts.length === 5) {\n parts[3] = replaceWith\n\n return parts.join(':::')\n } else {\n logDebug(pluginJson, `replaceCalendarLinkText: could not split/find 4 parts for link: ${line}`)\n return line\n }\n}\n\n/**\n * This code is just here to test that the date processing does what you expect.\n */\nexport function parseDateTextChecker() {\n const tests = [\n 'schedule something for now',\n 'today',\n 'today at 3',\n 'today at 8',\n 'ten minutes from now',\n 'in 20 minutes',\n 'tomorrow',\n 'tomorrow at 2',\n 'tomorrow at 4pm',\n 'today',\n 'tomorrow',\n 'sunday',\n 'monday',\n 'tuesday',\n 'wednesday at noon',\n 'wednesday at 12',\n 'thursday at 5',\n 'friday at 8',\n 'saturday at 9',\n 'june 29th',\n 'june 29th at 2',\n 'next week',\n 'next month',\n 'last week',\n 'last month,',\n ]\n Editor.appendParagraph(`${new Date().toISOString()} - now ISO`, 'text')\n Editor.appendParagraph(`${new Date().toString()} - now`, 'text')\n tests.forEach((element) => {\n const val = Calendar.parseDateText(element)\n Editor.appendParagraph(`${val[0].start.toString()} - \"${element}\" ${isReallyAllDay(val[0]) ? 'allday' : ''}`, 'text')\n // clo(val, `NPEventBlocks.parseDateTextChecker: Element`)\n console.log(JSON.stringify(val))\n })\n}\n\n/**\n * Helper to get the plugin settings or defaults\n * Doesn't do much. This may be replaced when this moves to a @jgclark plugin\n * @returns\n */\nexport function getPluginSettings(): EventBlocksConfig {\n const settings = DataStore.settings\n if (settings && Object.keys(settings)) {\n return settings\n } else {\n return {\n confirm: true,\n eventLength: '30',\n removeDateText: true,\n linkText: '→',\n showResultingTimeDate: true,\n }\n }\n}\n\n/**\n * Ask the user to choose the heading for the events, and then return the paragraph for the heading (we need it in order to find the block)\n * @param {*} note\n * @returns {TParagraph} - the paragraph object for the heading\n */\nexport async function chooseTheHeading(note: TNote): Promise {\n const heading = await chooseHeading(note, false, false, false)\n const headingPara = findHeading(note, heading)\n return headingPara\n}\n\n/**\n * NotePlan may return multiple potential time Range objects for this particular line. Ask the user to choose the right one\n * @param {*} text\n * @param {*} potentials\n * @returns {object} returns a Range++ object for the correct time range\n */\nexport async function confirmPotentialTimeChoice(text: string, potentials: any): Promise {\n const opts = potentials.map((potential, i) => ({\n label: `${potential.start.toLocaleString()} (text: \"${potential.text}\")`,\n value: i,\n start: potential.start,\n end: potential.end,\n text: potential.text,\n index: potential.index,\n }))\n const val = await chooseOption(`Which of these is \"${text}\"?`, opts, opts[0].value)\n return potentials[val]\n}\n\n/**\n *\n * @param {string} title - The title of the event\n * @param {object} range {start, end, text, etc.}\n * @param {*} config\n * @returns {Promis}\n */\nexport async function createEvent(title: string, range: { start: Date, end: Date }, config: any): Promise {\n /* NOTE: TODO: add in missing fields (eg calendar)\n create(\n title: string,\n date: Date,\n endDate: Date | void,\n type: CalenderItemType,\n isAllDay ?: boolean,\n calendar ?: string,\n isCompleted ?: boolean,\n notes ?: string,\n url ?: string,\n): TCalendarItem;\n*/\n const isAllDayEvent = isReallyAllDay(range) // make an educated guess about whether this was intended to be an all day event\n //logDebug(pluginJson, `createEvent: ${title} allday:${isReallyAllDay(range)}`)\n if (!isAllDayEvent && range.start === range.end) {\n // if it's not an all day event, and the start and end are the same, then it's probably \"at 12\" or something, so we add time to the end to make it an event\n range.end = addMinutes(range.start, config.eventLength || '30')\n } else if (isAllDayEvent) {\n range.end = addMinutes(range.end, -1) // parseDateText returns 12am one day to 12am the next day for a full day event\n }\n logDebug(\n pluginJson,\n `createEvent: creating: title:\"${title}\" start:${String(range.start)} end:${String(range.end)} isAllDayEvent:${String(isAllDayEvent)} calendar:${config.calendar}} `,\n )\n const calendarItem = await CalendarItem.create(title, range.start, range.end || null, 'event', isAllDayEvent, config.calendar || '')\n const result = await Calendar.add(calendarItem)\n return result || null\n}\n\n/**\n * Find the paragraphs that contain event text which needs to be created. If time/date text is ambiguous\n * then ask the user to choose the correct one. Return the ConfirmedEvent data for each line to be turned into an event\n * Skips blank lines and title lines\n * NOTE: Calendar.parseDateText does not correctly return \"today at\" so we try to fix that here\n * @param {Array} paragraphBlock\n * @param {EventBlocksConfig} config\n * @returns {Promise>} - the list of unambiguous event info to create\n */\nexport async function confirmEventTiming(paragraphBlock: Array, config: EventBlocksConfig): Promise> {\n const { confirm /*, removeDateText */ } = config\n const confirmedEventData = []\n for (let i = 0; i < paragraphBlock.length; i++) {\n const line = paragraphBlock[i]\n if (hasCalendarLink(line.content) || line.type === 'title' || line.content === '') {\n logDebug(pluginJson, `Skipping line: ${line.content}`)\n } else {\n // create a regex to replace the words \"today at\" (or today @) with or whithout spaces around the @ with \" at \"\n let lineText = line.content.replace(/today ?(at|\\@) ?/gi, ' at ') // Calendar.parseDateText does not correctly return \"today at\" so we try to fix that here\n // replace \"tomorrow\" with the ISO date for tomorrow\n lineText = lineText.replace(/tomorrow/gi, new Date(Date.now() + 86400000).toLocaleDateString())\n const potentials = Calendar.parseDateText(lineText) //returns {start: Date, end: Date}\n clo(potentials, `confirmEventTiming Calendar.parseDateText responses for \"${line.content}\"`)\n if (potentials.length > 0) {\n let chosenDateRange = { ...potentials[0] }\n if (potentials.length > 1) {\n if (confirm && line.content.length) {\n const dateRangeItem = await confirmPotentialTimeChoice(line.content, potentials)\n chosenDateRange = { ...dateRangeItem }\n }\n }\n // Remove the timing part from the line now that we have a link\n // Calendar.parseDateText = [{\"start\":\"2022-06-24T13:00:00.000Z\",\"end\":\"2022-06-24T13:00:00.000Z\",\"text\":\"friday at 8\",\"index\":0}]\n let revisedLine = lineText\n .replace(chosenDateRange?.text?.length ? chosenDateRange.text : '', '')\n .replace(/\\s{2,}/g, ' ')\n .trim()\n if (revisedLine.length === 0) {\n revisedLine = '...' // If the line was all a date description, we need something to show\n logDebug(pluginJson, `processTimeLines could not separate line timing from rest of text=\"${revisedLine}\"`)\n }\n confirmedEventData.push({ originalLine: line.content, revisedLine, dateRangeInfo: chosenDateRange, paragraph: line, index: i })\n } else {\n // do nothing with this line?\n logDebug(pluginJson, `processTimeLines no times found for \"${line.content}\"`)\n }\n }\n }\n return confirmedEventData\n}\n\n/**\n * Take in a array of TParagraphs (block of lines), loop through and create events for the ones that should be events\n * Make changes to the paragraph lines and return all changed paragraphs as an array so they can be updated in one go\n * @param {Array} block\n * @param {{[string]:any}} config\n * @param {string} calendar - the calendar to use for the events or blank to ask\n * @returns {{paragraph:{TParagraph}, time:{Range++ object with start, end | null}}}\n */\nexport async function processTimeLines(paragraphBlock: Array, config: EventBlocksConfig, calendar?: string = ''): Promise> {\n // parseDateTextChecker()\n const timeLines = []\n try {\n // First, we need to get all the data necessary to create this event, including user input\n // before we can show a status bar\n clo(paragraphBlock, `processTimeLines: paragraphBlock contains ${paragraphBlock.length} lines`)\n const eventsToCreate = (await confirmEventTiming(paragraphBlock, config)) || []\n // Now that we have all the info we need, we can create the events with a status bar\n config.calendar = (await checkOrGetCalendar(calendar, true)) || calendar || ''\n CommandBar.showLoading(true, `Creating Events:\\n(${0}/${eventsToCreate.length})`)\n await CommandBar.onAsyncThread()\n logDebug(pluginJson, `eventsToCreate.length=${eventsToCreate.length}`)\n for (let j = 0; j < eventsToCreate.length; j++) {\n const item = eventsToCreate[j]\n clo(config, `processTimeLines: config`)\n clo(item, `processTimeLines: item to create`)\n CommandBar.showLoading(true, `Creating Events:\\n(${j}/${eventsToCreate.length})`)\n const range = { start: item.dateRangeInfo.start, end: item.dateRangeInfo.end }\n const eventWithoutLink = await createEvent(item.revisedLine, range, config)\n if (eventWithoutLink && eventWithoutLink.id !== null && typeof eventWithoutLink.id === 'string') {\n logDebug(pluginJson, `created event ${eventWithoutLink.title}`)\n const { id, title } = eventWithoutLink\n const event = id ? await Calendar.eventByID(id) : null\n if (event) {\n clo(event, `Created event:`)\n let { endDate } = event\n const { calendarItemLink, date, isAllDay } = event\n // work around the fact that eventByID sends back the wrong endDate for all day events\n if (isAllDay && endDate) endDate = addMinutes(endDate, -1) // https://discord.com/channels/763107030223290449/1011492449769762836/1011492451460059246\n logDebug(pluginJson, `processTimeLines event=${title} event.calendarItemLink=${calendarItemLink}`)\n const startDateString = date.toLocaleString().split(', ')[0]\n const endDateString = endDate ? endDate.toLocaleString().split(', ')[0] : ''\n const dateStr = isAllDay ? `${startDateString}${startDateString === endDateString ? '' : `-${endDateString}`}` : date.toLocaleString()\n logDebug(\n pluginJson,\n `noDuration: ${String(startDateString === endDateString)} dateStr = \"${dateStr}\" endDate: ${endDate ? endDate.toString() : ''} ${\n endDate ? endDate.toLocaleString() : ''\n }`,\n )\n const created = config.showResultingTimeDate ? ` ${dateStr}` : ''\n const editedLink = config.showResultingTimeDate ? replaceCalendarLinkText(calendarItemLink, created) : calendarItemLink\n item.paragraph.content = `${config.removeDateText ? item.revisedLine : item.originalLine} ${editedLink}`\n // timeLines.push({ time: item.dateRangeInfo, paragraph: item.paragraph, event })\n timeLines.push(item.paragraph)\n //logDebug(pluginJson, `processTimeLines timeLines.length=${timeLines.length}`)\n }\n } else {\n logDebug(pluginJson, `processTimeLines no event created for \"${item.revisedLine}\"`)\n }\n // confirmPotentialTimeChoices()\n // CreateEvents() // + tag created events\n }\n await CommandBar.onMainThread()\n CommandBar.showLoading(false)\n logDebug(pluginJson, `processTimeLines RETURNING ${timeLines.length} processed lines`)\n } catch (error) {\n logError(pluginJson, `processTimeLines error=${JSP(error)}`)\n }\n return timeLines\n}\n\n/**\n * Create calendar events by writing (natural language) via prompt\n * Plugin entrypoint for command: \"/pevt - Prompt for Natural Language Event text\"\n * @author @dwertheimer\n * @param {*} incoming\n */\nexport async function createEventPrompt(_heading?: string) {\n try {\n logDebug(pluginJson, `createEventPrompt running; heading set to: \"${_heading || ''}\"`)\n // prompt user for event text\n const eventText = await CommandBar.showInput('Event text:', 'Process Text')\n if (eventText) {\n // parse event text\n const config = getPluginSettings()\n config.confirm = true\n // $FlowIgnore\n const timeLines = await processTimeLines([{ content: eventText, type: 'text' }], config)\n if (timeLines.length) {\n // Editor.updateParagraphs(timeLines)\n clo(timeLines, `createEventPrompt timeLines after creation:\\n${timeLines.length}`)\n const answer = _heading\n ? 'Yes'\n : await showMessageYesNoCancel(\n `Created ${timeLines.length} event. Insert a link to the new event in the active note under a heading?`,\n ['Yes', 'No'],\n 'Insert Event Link',\n )\n if (answer === 'Yes') {\n const title = _heading ?? (Editor.note ? await chooseHeading(Editor, true, true, false) : '')\n logDebug(pluginJson, `heading: \"${title}\"`)\n switch (title) {\n case '<>':\n smartPrependPara(Editor, timeLines[0].content, 'text')\n break\n case '<>':\n smartAppendPara(Editor, timeLines[0].content, 'text')\n break\n default:\n Editor.addParagraphBelowHeadingTitle(timeLines[0].content, 'text', title, false, true)\n break\n }\n }\n } else {\n logError(pluginJson, `No time lines found in \"${eventText}\"`)\n await showMessage(\n `Was not able to parse definitive date/time info for the text: \"${eventText}\". Have placed the text on the clipboard in case you want to edit and try it again.`,\n )\n Clipboard.string = eventText\n }\n }\n } catch (error) {\n logError(pluginJson, `processTimeLines error=${JSP(error)}`)\n }\n}\n\n/**\n * Create events from text in a note\n * (plugin Entry point for \"/cevt - Create Events\")\n * @param {*} heading\n * @param {*} confirm\n */\nexport async function createEvents(heading: string = '', confirm?: string = 'yes', calendarName?: string = ''): Promise {\n try {\n logDebug(pluginJson, `createEvents running; heading=\"${heading}\"; confirm=\"${confirm}\"; calendarName=\"${calendarName}\"`)\n const note = Editor.note\n if (note) {\n const config = { ...DataStore.settings }\n config.confirm = confirm === 'yes' || config.confirm\n const headingPara = heading !== '' ? findHeading(note, heading, true) : await chooseTheHeading(note)\n if (headingPara) {\n const paragraphsBlock = getBlockUnderHeading(note, headingPara)\n if (paragraphsBlock.length) {\n const timeLines = await processTimeLines(paragraphsBlock, config, calendarName)\n if (timeLines.length) {\n Editor.updateParagraphs(timeLines)\n } else {\n logError(pluginJson, `No time lines found under heading: ${heading}`)\n }\n }\n } else {\n logDebug(pluginJson, `Could not find heading containing \"${heading}\"; headings in note:\\n`)\n const titles = note.paragraphs\n .filter((p) => p.type === 'title')\n .map((p) => p.content)\n .join(`\\n`)\n clo(titles, `createEvents: titles in document were`)\n }\n }\n } catch (error) {\n logError(pluginJson, JSP(error))\n }\n}\n" }, { "path": "dwertheimer.EventAutomations/src/NPTimeblocking.js", "content": "// @flow\n\n/**\n * WHERE AM I?\n * TODO: update docs for limittotags, presets\n * TODO: timeblocks need the filter DataStore.preference(\"timeblockTextMustContainString\")\n * * getTimeBlockingDefaults should read plugin.json and create the defaults\n * * then validations should come from that file also\n * * TODO: feedback if no items to timeblock\n * impolement limitToTags[] but make it a textfilter regex\n */\nimport { addMinutes } from 'date-fns'\nimport pluginJson from '../plugin.json'\nimport { addTrigger } from '../../helpers/NPFrontMatter'\nimport type { SortableParagraphSubset } from '../../helpers/sorting'\nimport type { AutoTimeBlockingConfig } from './config'\nimport {\n blockOutEvents,\n getBlankDayMap,\n getTimeBlockTimesForEvents,\n removeDateTagsFromArray,\n appendLinkIfNecessary,\n getFullParagraphsCorrespondingToSortList,\n} from './timeblocking-helpers'\nimport {\n shouldRunCheckedItemChecksOriginal,\n deleteParagraphsContainingString,\n gatherAndPrepareTodos,\n getConfig,\n writeSyncedCopies,\n insertItemsIntoNote,\n getTodaysFilteredTodos,\n} from './timeblocking-shared'\nimport { validateAutoTimeBlockingConfig } from './config'\nimport { getPresetOptions, setConfigForPreset } from './presets'\nimport type { IntervalMap, PartialCalendarItem } from './timeblocking-flow-types'\nimport { getTimedEntries, keepTodayPortionOnly } from '@helpers/calendar'\nimport { saveEditorIfNecessary } from '@helpers/NPEditor'\nimport { textWithoutSyncedCopyTag } from '@helpers/syncedCopies'\nimport { getEventsForDay } from '@helpers/NPCalendar'\nimport { getDateStringFromCalendarFilename, getTodaysDateHyphenated, getTodaysDateUnhyphenated, removeRepeats } from '@helpers/dateTime'\nimport { getTasksByType, sortListBy, isTask } from '@helpers/sorting'\nimport { removeDateTagsAndToday } from '@helpers/stringTransforms'\nimport { showMessage, chooseOption } from '@helpers/userInput'\nimport { getTimeBlockString, isTimeBlockLine } from '@helpers/timeblocks'\nimport { JSP, clo, log, logError, logWarn, logDebug, clof } from '@helpers/dev'\nimport { checkNumber, checkWithDefault } from '@helpers/checkType'\nimport { getSyncedCopiesAsList } from '@helpers/NPSyncedCopies'\nimport { removeContentUnderHeading, removeContentUnderHeadingInAllNotes, selectedLinesIndex } from '@helpers/NPParagraph'\n\nexport const editorIsOpenToToday = (): boolean => {\n const fileName = Editor.filename\n if (fileName == null) {\n return false\n }\n return getDateStringFromCalendarFilename(fileName) === getTodaysDateUnhyphenated()\n}\n\n/**\n * Scan note for user-entered timeblocks and return them as an array of Calendar Items\n * @param {*} note\n * @param {*} defaultDuration\n * @returns\n */\nfunction getExistingTimeBlocksFromNoteAsEvents(note: CoreNoteFields, defaultDuration: number): Array {\n const timeBlocksAsEvents = []\n note.paragraphs.forEach((p) => {\n if (isTimeBlockLine(p.content)) {\n const timeblockDateRangePotentials = Calendar.parseDateText(p.content)\n if (timeblockDateRangePotentials?.length) {\n const e = timeblockDateRangePotentials[0] //use Noteplan/Chrono's best guess\n // but this may not actually be a timeblock, so keep looking\n const tbs = getTimeBlockString(p.content)\n if (tbs && tbs.length > 0) {\n const eventInfo = p.content.replace(tbs, '').trim()\n timeBlocksAsEvents.push({\n title: eventInfo,\n date: e.start,\n endDate: e.end !== e.start ? e.end : addMinutes(e.start, defaultDuration),\n type: 'event',\n availability: 0,\n })\n }\n }\n }\n })\n return timeBlocksAsEvents\n}\n\n/**\n * Get a time map populated with the calendar events for the day\n * @param {string} dateStr\n * @param {number} intervalMins\n * @param {AutoTimeBlockingConfig} config\n * @returns\n */\nasync function getPopulatedTimeMapForToday(dateStr: string, intervalMins: number, config: AutoTimeBlockingConfig): Promise {\n // const todayEvents = await Calendar.eventsToday()\n const eventsArray = await getEventsForDay(dateStr)\n const eventsWithStartAndEnd = getTimedEntries(eventsArray || [])\n let eventsScheduledForToday = keepTodayPortionOnly(eventsWithStartAndEnd)\n // remove the timebocks that NP wrote to the calendar and may not have been deleted yet due to latency\n eventsScheduledForToday = eventsScheduledForToday.filter((e) => !e.notes.startsWith('NPTB:'))\n clof(eventsScheduledForToday, `getPopulatedTimeMapForToday eventsScheduledForToday`, ['date', 'title'], true)\n if (Editor) {\n const duration = checkWithDefault(checkNumber, 60)\n const userEnteredTimeblocks = getExistingTimeBlocksFromNoteAsEvents(Editor, duration)\n eventsScheduledForToday = [...userEnteredTimeblocks, ...eventsScheduledForToday]\n }\n const blankDayMap = getBlankDayMap(parseInt(intervalMins))\n\n // $FlowFixMe - [prop-missing] and [incompatible-variance]\n const eventMap = blockOutEvents(eventsScheduledForToday, blankDayMap, config)\n return eventMap\n}\n\nexport async function deleteCalendarEventsWithTag(tag: string, dateStr: string): Promise {\n let dateString = dateStr\n if (!dateStr) {\n dateString = Editor.filename ? getDateStringFromCalendarFilename(Editor.filename) : null\n }\n if (dateString && tag) {\n const eventsArray = (await getEventsForDay(dateString)) || []\n CommandBar.showLoading(true, 'Deleting Calendar Events')\n await CommandBar.onAsyncThread()\n for (let i = 0; i < eventsArray.length; i++) {\n const event = eventsArray[i]\n if (event?.title?.includes(tag)) {\n // logDebug(pluginJson, `deleteCalendarEventsWithTag: deleting event ${event.title}`)\n // clo(event, `deleteCalendarEventsWithTag; event=`)\n await Calendar.remove(event)\n CommandBar.showLoading(true, `Deleting Calendar Events\\n(${i + 1}/${eventsArray.length})`, (i + 1) / eventsArray.length)\n logDebug(pluginJson, `deleteCalendarEventsWithTag: deleted event: ${event.title}`)\n }\n }\n await CommandBar.onMainThread()\n CommandBar.showLoading(false)\n } else {\n await showMessage('deleteCalendarEventsWithTag could not delete events')\n }\n}\n\n/**\n * Main function (called by multiple entry points)\n * @param {AutoTimeBlockingConfig} config\n * @param {Array} completedItems - items that were checked (we must be in the EditorWillSave hook)\n * @returns\n */\nexport async function DELETEMEcreateTimeBlocksForTodaysTasks(config: AutoTimeBlockingConfig = getConfig(), completedItems: Array = []): Promise> {\n logDebug(pluginJson, `Starting createTimeBlocksForTodaysTasks. Time is ${new Date().toLocaleTimeString()}`)\n // clof(Editor.paragraphs, 'Editor.paragraphs', ['type', 'content'], true)\n const { timeBlockTag, intervalMins, passBackResults } = config\n if (shouldRunCheckedItemChecksOriginal(config)) addTrigger(Editor, 'onEditorWillSave', pluginJson['plugin.id'], 'onEditorWillSave')\n const hypenatedDate = getTodaysDateHyphenated()\n logDebug(pluginJson, `createTimeBlocksForTodaysTasks hypenatedDate=${hypenatedDate} Editor.paras=${Editor.paragraphs.length}`)\n const date = getTodaysDateUnhyphenated()\n logDebug(pluginJson, `createTimeBlocksForTodaysTasks date=${date}`)\n const dateStr = Editor.filename ? getDateStringFromCalendarFilename(Editor.filename) : null\n logDebug(pluginJson, `createTimeBlocksForTodaysTasks dateStr=${dateStr ?? 'null'} Editor.paras=${Editor.paragraphs.length}`)\n if (dateStr && dateStr === date) {\n logDebug(pluginJson, `createTimeBlocksForTodaysTasks dateStr=${dateStr} is today - starting Editor.paras=${Editor.paragraphs.length}`)\n deleteParagraphsContainingString(Editor, timeBlockTag)\n logDebug(pluginJson, `createTimeBlocksForTodaysTasks after deleteParagraphsContainingString(${timeBlockTag}) Editor.paras=${Editor.paragraphs.length}`)\n\n const todosParagraphs = await getTodaysFilteredTodos(config).filter(\n (t) => t.filename !== Editor.filename || (t.filename === Editor.filename && !completedItems.find((c) => c.lineIndex === t.lineIndex)),\n )\n logDebug(pluginJson, `Back from getTodaysFilteredTodos, ${todosParagraphs.length} potential items Editor.paras=${Editor.paragraphs.length}`)\n // the following calls addBlockID and that must be called before any content changes are made that will not be saved\n const todosWithLinksMaybe = appendLinkIfNecessary(todosParagraphs, config)\n logDebug(\n pluginJson,\n `After appendLinkIfNecessary, ${todosWithLinksMaybe?.length ?? 0} potential items (may include headings or completed) Editor.paras=${Editor.paragraphs.length}`,\n )\n const cleanTodayTodoParas = [...removeDateTagsFromArray(todosWithLinksMaybe)]\n logDebug(pluginJson, `After removeDateTagsFromArray, ${cleanTodayTodoParas.length} potential items Editor.paras=${Editor.paragraphs.length}`)\n const tasksByType = todosWithLinksMaybe.length ? getTasksByType(todosWithLinksMaybe, true) : null // puts in object by type of task and enriches with sort info (like priority)\n // clo(tasksByType, 'createTimeBlocksForTodaysTasks: tasksByType')\n logDebug(\n pluginJson,\n `After getTasksByType, ${tasksByType?.open.length ?? 0} OPEN items | ${tasksByType?.scheduled.length ?? 0} Scheduled (for today) items Editor.paras=${\n Editor.paragraphs.length\n }`,\n )\n // clo(tasksByType?.open, 'createTimeBlocksForTodaysTasks: tasksByType.open')\n const openOrScheduledForToday = [...(tasksByType?.open ?? []), ...(tasksByType?.scheduled ?? [])]\n if (openOrScheduledForToday) {\n const sortedTodos = openOrScheduledForToday.length ? sortListBy(openOrScheduledForToday, '-priority') : []\n logDebug(pluginJson, `After sortListBy, ${sortedTodos.length} open items Editor.paras=${Editor.paragraphs.length}`)\n // $FlowIgnore\n if (timeBlockTag?.length) {\n logDebug(pluginJson, `timeBlockTag: (\"${timeBlockTag}\"), Editor.paras=${Editor.paragraphs.length}`)\n } else {\n logError(pluginJson, `timeBlockTag was empty. That's not good. I told the user.`)\n await showMessage(\n `Your Event Automations settings have a blank field for timeBlockTag. I will continue, but the results probably won't be what you want. Please check your settings.`,\n )\n }\n const calendarMapWithEvents = await getPopulatedTimeMapForToday(dateStr, intervalMins, config)\n // clo(calendarMapWithEvents, `calendarMapWithEvents: ${calendarMapWithEvents.length} items`)\n logDebug(\n pluginJson,\n `After getPopulatedTimeMapForToday, ${calendarMapWithEvents.length} timeMap slots; last = ${JSON.stringify(\n calendarMapWithEvents[calendarMapWithEvents.length - 1],\n )} Editor.paras=${Editor.paragraphs.length}`,\n )\n // logDebug(pluginJson, `sortedTodos[0]: ${sortedTodos[0].content} Editor.paras=${Editor.paragraphs.length}`)\n // logDebug(pluginJson, `sortedParas[0]: ${sortedParas[0].content}`)\n const eventsToTimeblock = getTimeBlockTimesForEvents(calendarMapWithEvents, sortedTodos, config)\n logDebug(`\\n\\n>>>>>>> after getTimeBlockTimesForEvents <<<<<<<<<<<<\\n\\n`)\n clo(eventsToTimeblock, `createTimeBlocksForTodaysTasks eventsToTimeblock`)\n const { blockList, noTimeForTasks } = eventsToTimeblock\n let { timeBlockTextList } = eventsToTimeblock\n\n clo(timeBlockTextList, `timeBlockTextList`)\n logDebug(\n pluginJson,\n `After getTimeBlockTimesForEvents, blocks:\\n\\tblockList.length=${String(blockList?.length)} \\n\\ttimeBlockTextList.length=${String(\n timeBlockTextList?.length,\n )} Editor.paras=${Editor.paragraphs.length}`,\n )\n logDebug(pluginJson, `After getTimeBlockTimesForEvents, Editor.paras=${Editor.paragraphs.length}`)\n\n logDebug(pluginJson, `About to insert ${String(timeBlockTextList?.length)} timeblock items into note Editor.paras=${Editor.paragraphs.length}`)\n if (!String(config.timeBlockHeading)?.length) {\n await showMessage(`You need to set a time block heading title in the plugin settings`)\n return\n } else {\n if (noTimeForTasks && Object.keys(noTimeForTasks).length) {\n // removeContentUnderHeading(Editor, config.timeBlockHeading, false, true) -- too dangerous, will delete stuff people write underneath\n if (!timeBlockTextList) timeBlockTextList = []\n Object.keys(noTimeForTasks).forEach((key) =>\n noTimeForTasks[key].forEach(\n (p) =>\n timeBlockTextList &&\n timeBlockTextList.push(\n `+ No time ${key === '_' ? 'available' : `in timeblock *${key}*`} for task: **- ${textWithoutSyncedCopyTag(removeRepeats(removeDateTagsAndToday(p.content)))}** ${\n config.timeBlockTag\n }`,\n ),\n ),\n )\n }\n // double check that we are not creating any synced lines by accident\n timeBlockTextList = timeBlockTextList?.map((t) => textWithoutSyncedCopyTag(t)) ?? []\n clo(\n timeBlockTextList,\n `getTimeBlockTimesForEvents Before writing: Editor.paras=${Editor.paragraphs.length} Editor.note.paras=${Editor.note?.paragraphs.length || 0}; timeBlockTextList=`,\n )\n await insertItemsIntoNote(Editor, timeBlockTextList, config.timeBlockHeading, config.foldTimeBlockHeading, config)\n }\n\n logDebug(pluginJson, `\\n\\nAUTOTIMEBLOCKING SUMMARY:\\n\\n`)\n logDebug(pluginJson, `After cleaning, ${tasksByType?.open?.length ?? 0} open items`)\n logDebug(pluginJson, `createTimeBlocksForTodaysTasks inserted ${String(timeBlockTextList?.length)} items Editor.paras=${Editor.paragraphs.length}`)\n\n if (config.createSyncedCopies && todosWithLinksMaybe?.length) {\n logDebug(\n pluginJson,\n `createSyncedCopies is true, so we will create synced copies of the todosParagraphs: ${todosParagraphs.length} timeblocks Editor.paras=${Editor.paragraphs.length}`,\n )\n clof(todosParagraphs, `createTimeBlocksForTodaysTasks todosParagraphs`, ['rawContent', 'raw', 'filename'], true)\n clof(sortedTodos, `createTimeBlocksForTodaysTasks sortedTodos`, ['rawContent', 'raw', 'filename'], true)\n const sortedParas = getFullParagraphsCorrespondingToSortList(todosParagraphs, sortedTodos).filter((p) => p.filename !== Editor.filename)\n clof(sortedParas, `createTimeBlocksForTodaysTasks sortedParas`, ['filename', 'content'], true)\n const sortedParasExcludingCurrentNote = sortedParas.filter((p) => p.filename !== Editor.filename)\n clof(sortedParasExcludingCurrentNote, `createTimeBlocksForTodaysTasks sortedParasExcludingCurrentNote`, ['filename', 'content'], true)\n // $FlowFixMe\n await writeSyncedCopies(...sortedParasExcludingCurrentNote, { runSilently: true, ...config })\n }\n return passBackResults ? timeBlockTextList : []\n } else {\n logDebug(pluginJson, 'No todos/references marked for >today Editor.paras=${Editor.paragraphs.length}')\n if (!passBackResults) {\n await showMessage(`No todos/references marked for >today`)\n }\n }\n } else {\n if (!passBackResults) {\n // logDebug(pluginJson,`You need to be in Today's Calendar Note to use this function Editor.paras=${Editor.paragraphs.length}`)\n await showMessage(`You need to be in Today's Calendar Note to use this function`)\n }\n }\n return []\n}\n\n/**\n * Write a list of synced copies of today items (in the references section) to the Editor\n * (entry point for /writeSyncedCopies)\n */\nexport async function insertSyncedCopiesOfTodayTodos(passBackResults?: string): Promise {\n try {\n logDebug(pluginJson, `insertSyncedCopiesOfTodayTodos running, passBackResults:${String(passBackResults)}`)\n const config = await getConfig()\n clo(config, 'insertSyncedCopiesOfTodayTodos config')\n // if (!editorIsOpenToToday()) await Editor.openNoteByDate(new Date(), false) //open editor to today\n logDebug(pluginJson, `insertSyncedCopiesOfTodayTodos before saveEditorIfNecessary`)\n if (Editor) await removeContentUnderHeading(Editor, String(config.syncedCopiesTitle), true, true)\n await saveEditorIfNecessary()\n logDebug(pluginJson, `insertSyncedCopiesOfTodayTodos after saveEditorIfNecessary`)\n const start = Editor.selection?.start // try to keep it from scrolling to end of doc\n const todosParagraphs = await getTodaysFilteredTodos(config, true)\n clof(todosParagraphs, 'insertSyncedCopiesOfTodayTodos todosParagraphs', ['filename', 'type', 'content'], true)\n const sortedParasExcludingCurrentNote = sortListBy(\n todosParagraphs.filter((p) => p.filename !== Editor.filename),\n 'content',\n )\n clof(sortedParasExcludingCurrentNote, 'insertSyncedCopiesOfTodayTodos sortedParasExcludingCurrentNote ${sortedParasExcludingCurrentNote.length} items', [\n 'filename',\n 'type',\n 'content',\n ])\n if (passBackResults && /[Yy]es/.test(passBackResults)) {\n // called from a template, so send a string back\n const syncedList = getSyncedCopiesAsList(sortedParasExcludingCurrentNote)\n logDebug(`insertSyncedCopiesOfTodayTodos`, `sending ${syncedList.length} synced line items to template`)\n return syncedList.join('\\n')\n }\n await writeSyncedCopies(sortedParasExcludingCurrentNote, config)\n await saveEditorIfNecessary()\n if (start) {\n Editor.select(0, 0)\n }\n } catch (error) {\n logError(pluginJson, `insertSyncedCopiesOfTodayTodos error: ${JSP(error)}`)\n }\n}\n\n/**\n * Remove previously written Time Blocks (written by this plugin) in the Editor\n * (entry point for /removeTimeBlocks)\n */\nexport async function removeTimeBlocks(note: TNote | null = null): Promise {\n try {\n logDebug(pluginJson, `removeTimeBlocks running`)\n await removeContentUnderHeading(note || Editor, String(DataStore.settings.timeBlockHeading), false, false)\n } catch (error) {\n logError(pluginJson, `removeTimeBlocks error: ${JSP(error)}`)\n }\n}\n\n/**\n * Remove all previously written synced copies of today items in all notes\n * (entry point for /removePreviousTimeBlocks)\n * @param {boolean} runSilently - whether to show CommandBar popups - you should set it to 'yes' when running from a template\n */\nexport async function removePreviousTimeBlocks(runSilently: string = 'no'): Promise {\n try {\n logDebug(pluginJson, `removePreviousTimeBlocks running`)\n const { timeBlockHeading } = DataStore.settings\n await removeContentUnderHeadingInAllNotes(['calendar'], timeBlockHeading, false, runSilently)\n } catch (error) {\n logError(pluginJson, `removePreviousTimeBlocks error: ${JSP(error)}`)\n }\n}\n\n/**\n * Insert todos marked >today into the editor\n * (entry point for /atb)\n * @param {*} note\n */\nexport async function insertTodosAsTimeblocks(/* note: TNote */): Promise {\n try {\n logDebug(pluginJson, `====== /atb =======\\nStarting insertTodosAsTimeblocks`)\n if (!editorIsOpenToToday()) await Editor.openNoteByDate(new Date(), false) //open editor to today\n const config = await getConfig()\n clo(config, 'atb config')\n if (config) {\n logDebug(pluginJson, `Config found. Calling createTimeBlocksForTodaysTasks`)\n await createTimeBlocksForTodaysTasks(config)\n } else {\n logDebug(pluginJson, `insertTodosAsTimeblocks: stopping after config create`)\n }\n } catch (error) {\n logError(pluginJson, `insertTodosAsTimeblocks error: ${JSP(error)}`)\n }\n}\n\nexport async function insertTodosAsTimeblocksWithPresets(/* note: TNote */): Promise {\n // logDebug(pluginJson,`====== /atbp =======\\nStarting insertTodosAsTimeblocksWithPresets`)\n // if (!editorIsOpenToToday()) await Editor.openNoteByDate(new Date(), false) //open editor to today\n let config = await getConfig()\n if (config) {\n // logDebug(pluginJson,`Config found. Checking for presets`)\n if (config.presets && config.presets.length) {\n const options = getPresetOptions(config.presets)\n const presetIndex = await chooseOption('Choose an AutoTimeBlocking Preset:', options, -1)\n const overrides = config.presets ? config.presets[presetIndex] : []\n // logDebug(pluginJson,`Utilizing preset: ${JSON.stringify(config.presets[presetIndex])}`)\n config = setConfigForPreset(config, overrides)\n try {\n await validateAutoTimeBlockingConfig(config) // check to make sure the overrides were valid\n } catch (error) {\n await showMessage(error)\n // logDebug(pluginJson,`insertTodosAsTimeblocksWithPresets: invalid config: ${error}`)\n }\n await createTimeBlocksForTodaysTasks(config)\n } else {\n await showMessage('No presets found. Please read docs.')\n }\n } else {\n // logDebug(pluginJson,`insertTodosAsTimeblocksWithPresets: no config`)\n }\n}\n\n/**\n * Mark task on current line done and run /atb to re-create timeblocks\n * Plugin entrypoint for command: \"/mdatb\"\n * @param {*} incoming\n */\nexport async function markDoneAndRecreateTimeblocks(incoming: string | null = null) {\n try {\n logDebug(pluginJson, `markDoneAndRecreateTimeblocks running with incoming:${String(incoming)}`)\n if (Editor?.selection && Editor?.paragraphs) {\n // const updatedParas = []\n const [startIndex, endIndex] = selectedLinesIndex(Editor.selection, Editor.paragraphs)\n if (endIndex >= startIndex) {\n for (let index = startIndex; index <= endIndex; index++) {\n const para = Editor.paragraphs[index]\n if (para) {\n // logDebug(pluginJson, `markDoneAndRecreateTimeblocks: paragraph[${index}] of ${startIndex} to ${endIndex}: \"${para.content || ''}\"`)\n if (para && isTask(para)) {\n // clo(para, `markDoneAndRecreateTimeblocks: before update paragraph[${index}]`)\n para.type = 'done'\n if (Editor) {\n Editor.updateParagraph(para)\n // clo(para, `markDoneAndRecreateTimeblocks: para after update paragraph[${index}]`)\n // clo(Editor?.paragraphs[para.lineIndex], `markDoneAndRecreateTimeblocks: note.paragraphs[${index}]`)\n } else {\n logError(pluginJson, `markDoneAndRecreateTimeblocks: no Editor`)\n }\n }\n }\n }\n await insertTodosAsTimeblocks()\n } else {\n logDebug(pluginJson, `markDoneAndRecreateTimeblocks: no selection`)\n }\n }\n } catch (error) {\n logError(pluginJson, JSP(error))\n }\n}\n\n/**\n * Initializes the function execution and logs the start time. It also checks\n * and adds a trigger for checked items if necessary, and validates the time\n * block tag configuration.\n *\n * @param {AutoTimeBlockingConfig} config - The configuration object for auto time blocking.\n * @param {Object} pluginJson - Plugin metadata for logging purposes.\n */\nfunction initializeAndLogStart(config: AutoTimeBlockingConfig): void {\n const { timeBlockTag } = config\n\n // Log the start of the operation with the current time\n logDebug(pluginJson, `Starting createTimeBlocksForTodaysTasks. Time is ${new Date().toLocaleTimeString()}`)\n\n // Validate the presence of a time block tag in the configuration\n if (!timeBlockTag || typeof timeBlockTag !== 'string' || timeBlockTag.length === 0) {\n logError(pluginJson, `timeBlockTag was empty. That's not good. I told the user.`)\n showMessage(\n `Your Event Automations settings have a blank field for timeBlockTag. I will continue, but the results probably won't be what you want. Please check your settings.`,\n )\n }\n}\n\n/**\n * Categorizes tasks by their type (open or scheduled) and sorts them by priority.\n * This organization is necessary for preparing the tasks for time block calculation.\n *\n * @param {Array} todosWithLinks - The list of todo items, potentially with appended links.\n * @param {Object} pluginJson - Plugin metadata for logging purposes.\n * @returns {Array} - The sorted list of todo items, ready for time block allocation.\n */\nfunction categorizeAndSortTasks(todosWithLinks: $ReadOnlyArray, config: AutoTimeBlockingConfig): Array {\n if (todosWithLinks.length === 0) {\n logDebug(pluginJson, `No todos to categorize and sort.`)\n return []\n }\n\n // Categorize tasks by type and enrich them with sorting information\n const tasksByType = getTasksByType(todosWithLinks, true)\n logDebug(pluginJson, `After getTasksByType, categorized tasks by type. Open tasks=${tasksByType.open.length} | Scheduled tasks=${tasksByType.scheduled.length}`)\n\n // Combine open and scheduled tasks, then sort by priority\n const openOrScheduledForToday = [...(tasksByType.open ?? []), ...(tasksByType.scheduled ?? [])]\n clof(openOrScheduledForToday, `categorizeAndSortTasks openOrScheduledForToday`, ['filename', 'type', 'content'], true)\n const sortKeys = config.mode === 'MANUAL_ORDERING' ? ['lineIndex'] : ['-priority', 'filename', '-duration']\n const sortedTodos = sortListBy(openOrScheduledForToday, sortKeys)\n clof(sortedTodos, `categorizeAndSortTasks sortedTodos`, ['priority', 'filename', 'duration', 'content'], true)\n logDebug(pluginJson, `After sortListBy, sorted ${sortedTodos.length} tasks by priority.`)\n\n return sortedTodos\n}\n\n/**\n * Handles scenarios where no todo items are marked for today or when specific\n * results are expected but not found. Shows messages to the user based on the\n * configuration and outcomes of the time blocking process, and returns the\n * appropriate results.\n *\n * @param {boolean} passBackResults - Flag indicating whether to pass back results.\n * @param {?Array} timeBlockTextList - The list of time block text entries, if any.\n * @param {Object} pluginJson - Plugin metadata for logging and debugging.\n * @returns {Promise>} - The results to be passed back, if any.\n */\nfunction handleNoTodosOrResults(passBackResults: boolean, timeBlockTextList: ?Array): Array {\n // Check if there are no todos or results to pass back\n if (!passBackResults) {\n const message =\n timeBlockTextList && timeBlockTextList.length > 0\n ? `Processed ${timeBlockTextList.length} time blocks for today.`\n : 'No todos/references marked for >today or no time blocks created.'\n\n logDebug(pluginJson, message)\n }\n\n // Return the results depending on whether this is being called by a template or not\n return passBackResults ? timeBlockTextList || [] : []\n}\n\n/**\n * Inserts the prepared time block text entries into the note under a specified\n * heading, applies specified formatting options, and logs a summary of the\n * autotimeblocking operation. Optionally creates synced copies of todo items\n * if required by the configuration.\n *\n * @param {Array} timeBlockTextList - The list of text entries for time blocks.\n * @param {AutoTimeBlockingConfig} config - The configuration object for auto time blocking.\n * @param {Object} pluginJson - Plugin metadata for logging and debugging.\n * @param {Array} todosWithLinksMaybe - The list of todo items with potential links appended.\n * @returns {Promise}\n */\nasync function insertAndFinalizeTimeBlocks(\n timeBlockTextList: Array,\n config: AutoTimeBlockingConfig,\n pluginJson: Object,\n todosWithLinksMaybe: Array,\n): Promise {\n // Insert time block text entries into the note\n await insertItemsIntoNote(Editor, timeBlockTextList, config.timeBlockHeading, config.foldTimeBlockHeading, config)\n logDebug(pluginJson, `insertAndFinalizeTimeBlocks: Inserted ${timeBlockTextList.length} timeblock items into note`)\n\n // Log autotimeblocking summary\n logDebug(pluginJson, `\\n\\nAUTOTIMEBLOCKING SUMMARY:\\n\\n`)\n logDebug(pluginJson, `Inserted ${timeBlockTextList.length} items`)\n\n // Create synced copies of todo items if configured\n // DELETEME: COMMENTING OUT FOR NOW (REMOVING THIS FEATURE WHICH MADE NO SENSE) DELETE THIS COMMENT AFTER A WHILE 2024-02-23\n // if (config.createSyncedCopies && todosWithLinksMaybe.length) {\n // await createSyncedCopies(todosWithLinksMaybe, config)\n // logDebug(pluginJson, `Created synced copies of todos`)\n // }\n\n // Check and add trigger for checked items if configured to do so\n if (shouldRunCheckedItemChecksOriginal(config)) {\n logDebug(pluginJson, `insertAndFinalizeTimeBlocks: calling addTrigger for checked items`)\n addTrigger(Editor, 'onEditorWillSave', pluginJson['plugin.id'], 'onEditorWillSave')\n }\n}\n\n/**\n * Generates time blocks for tasks by creating a populated time map for the day,\n * calculating time blocks for events based on this map and the sorted tasks, and\n * preparing the list of text entries for these time blocks. Special handling is\n * included for tasks that couldn't be allocated time.\n *\n * @param {Array} sortedTodos - The sorted list of todo items for today.\n * @param {string} dateStr - The date string for today, used to identify relevant events.\n * @param {AutoTimeBlockingConfig} config - The configuration object for auto time blocking.\n * @param {Object} pluginJson - Plugin metadata for logging and debugging.\n * @returns {Promise<{blockList: Array, noTimeForTasks: Object, timeBlockTextList: Array}>}\n * An object containing the lists of time block text entries and tasks with no allocated time.\n */\nasync function generateTimeBlocks(\n sortedTodos: Array,\n dateStr: string,\n config: AutoTimeBlockingConfig,\n pluginJson: Object,\n): Promise<{ blockList: Array, noTimeForTasks: Object, timeBlockTextList: Array }> {\n // Generate a populated time map for today\n const calendarMapWithEvents = await getPopulatedTimeMapForToday(dateStr, config.intervalMins, config)\n logDebug(pluginJson, `generateTimeBlocks: After getPopulatedTimeMapForToday, ${calendarMapWithEvents.length} timeMap slots`)\n clof(sortedTodos, `generateTimeBlocks sortedTodos`, ['lineIndex', 'content'], true)\n // Calculate time blocks for events based on the populated time map and sorted todo tasks\n const eventsToTimeblock = getTimeBlockTimesForEvents(calendarMapWithEvents, sortedTodos, config)\n logDebug(\n pluginJson,\n `generateTimeBlocks after getTimeBlockTimesForEvents; eventsToTimeblock.timeMap.length=${eventsToTimeblock.timeMap.length}, eventsToTimeblock.blockList.length=${\n eventsToTimeblock.blockList.length\n } eventsToTimeblock.timeBlockTextList.length=${eventsToTimeblock?.timeBlockTextList?.toString() || ''}`,\n )\n // Prepare the list of text entries for time blocks\n const { blockList, noTimeForTasks } = eventsToTimeblock\n let { timeBlockTextList } = eventsToTimeblock\n\n // Handle tasks with no allocated time\n if (noTimeForTasks && Object.keys(noTimeForTasks).length) {\n if (!timeBlockTextList) timeBlockTextList = []\n Object.keys(noTimeForTasks).forEach((key) =>\n noTimeForTasks[key].forEach((task) =>\n timeBlockTextList ? timeBlockTextList.push(`+ No time ${key === '_' ? 'available' : `in timeblock *${key}*`} for task: **- ${task.content}** ${config.timeBlockTag}`) : [],\n ),\n )\n }\n\n // Ensure no synced lines are created by accident\n timeBlockTextList = timeBlockTextList?.map((t) => textWithoutSyncedCopyTag(t)) || []\n\n return { blockList: blockList ?? [], noTimeForTasks, timeBlockTextList }\n}\n\n/**\n * If configured to leave completed timeblocks in the note, remove the timeBlockTag from the content\n * so they don't get deleted when the timeblocks are re-calculated.\n * @returns {Promise}\n */\nfunction keepCompletedTimeblocks(): void {\n const { todoChar, leaveCompletedTBs, timeBlockTag } = DataStore.settings\n const mustContainString = String(DataStore.preference('timeblockTextMustContainString')) || ''\n if (leaveCompletedTBs) {\n const doneType = todoChar === '+' ? 'checklistDone' : todoChar === '*' ? 'done' : ''\n if (doneType && Editor && timeBlockTag) {\n const completedItems = Editor.paragraphs.filter((p) => p.type === doneType && p.content.includes(timeBlockTag))\n clo(completedItems, `keepCompletedTimeblocks FOUND ${completedItems.length} completedItems`)\n // remove the timeBlockTag from the content\n completedItems.forEach((p) => {\n p.content = p.content.replace(timeBlockTag, mustContainString)\n })\n clo(completedItems, `keepCompletedTimeblocks AFTER removing timeBlockTag from content: ${completedItems.length} completedItems`)\n Editor.updateParagraphs(completedItems)\n logDebug(pluginJson, `keepCompletedTimeblocks: Updated ${completedItems.length} completedItems but not saving the Editor because of hang`)\n }\n }\n}\n\n/**\n * Main function for creating time blocks for today's tasks, utilizing modular functions\n * for improved maintainability and readability.\n *\n * @param {AutoTimeBlockingConfig} config - The configuration object for auto time blocking, with defaults provided by getConfig().\n * @param {Array} completedItems - Items that were checked, typically provided in the EditorWillSave hook context.\n * @returns {Promise>} - An optional array of strings to be passed back, depending on the configuration.\n */\nexport async function createTimeBlocksForTodaysTasks(config: AutoTimeBlockingConfig = getConfig(), completedItems: Array = []): Promise> {\n // Step 1: Initialize and log start\n initializeAndLogStart(config)\n\n // Step 5: Get completed items text if configured to leave them in the note (removes the timeBlockTag from the content)\n keepCompletedTimeblocks()\n\n // Step 2: Fetch and prepare todos\n const cleanTodayTodoParas = await gatherAndPrepareTodos(config, completedItems)\n\n // Step 3: Categorize and sort tasks\n const sortedTodos = categorizeAndSortTasks(cleanTodayTodoParas, config)\n\n // Step 4: Generate time blocks\n const dateStr = getDateStringFromCalendarFilename(Editor.filename) // Assuming this utility function exists and is accurate\n if (!dateStr) {\n return handleNoTodosOrResults(config.passBackResults || false, null)\n }\n\n const { blockList, noTimeForTasks, timeBlockTextList } = await generateTimeBlocks(sortedTodos, dateStr, config)\n\n // Check if time blocks were successfully generated\n if (blockList.length === 0 && Object.keys(noTimeForTasks).length === 0) {\n // If no blocks were created and no tasks are without time, handle accordingly\n return handleNoTodosOrResults(config.passBackResults || false, null)\n }\n\n // Step 5: Insert and finalize time blocks\n await insertAndFinalizeTimeBlocks(timeBlockTextList, config, pluginJson, sortedTodos)\n // Check and add trigger for checked items if configured to do so\n // if (shouldRunCheckedItemChecksOriginal(config)) {\n // logDebug(pluginJson, `createTimeBlocksForTodaysTasks: calling addTrigger for checked items`)\n // addTrigger(Editor, 'onEditorWillSave', pluginJson['plugin.id'], 'onEditorWillSave')\n // }\n\n // Step 6: Handle no todos or results scenario and return results\n return handleNoTodosOrResults(config.passBackResults || false, timeBlockTextList)\n}\n" }, { "path": "dwertheimer.EventAutomations/src/byTagMode.js", "content": "// @flow\n\n// import pluginJson from '../plugin.json'\nimport { sortListBy } from '../../helpers/sorting'\nimport type { AutoTimeBlockingConfig } from './config'\nimport type { OpenBlock, ParagraphWithDuration, TimeBlocksWithMap } from './timeblocking-flow-types'\nimport { filterTimeMapToOpenSlots, findTimeBlocks, matchTasksToSlots, namedTagExistsInLine, splitItemsByTags } from './timeblocking-helpers'\n\nimport { JSP, clo, log, logError, logWarn, logDebug, clof, deepCopy } from '@helpers/dev'\n\n// All functions have been moved to timeblocking-helpers.js to resolve circular dependency\n// This file now only contains imports and can be removed if no longer needed\n" }, { "path": "dwertheimer.EventAutomations/src/config.js", "content": "// @flow\n\nimport { validateConfigProperties } from '../../helpers/config'\nimport { logDebug } from '@helpers/dev'\n\nexport function getTimeBlockingDefaults(): AutoTimeBlockingConfig {\n return {\n todoChar: '+' /* character at the front of a timeblock line - can be *,-,or a heading, e.g. #### */,\n checkedItemChecksOriginal: false /* if true, checked items will check the original item, not the timeblock */,\n timeBlockTag: `#🕑` /* placed at the end of the timeblock to show it was created by this plugin */,\n timeBlockHeading:\n '[Time Blocks](noteplan://runPlugin?pluginID=dwertheimer.EventAutomations&command=atb%20-%20Create%20AutoTimeBlocks%20for%20%3Etoday%27s%20Tasks)' /* if this heading exists in the note, timeblocks will be placed under it */,\n foldTimeBlockHeading: false,\n workDayStart: '00:00' /* needs to be in 24 hour format (two digits, leading zero) */,\n workDayEnd: '23:59' /* needs to be in 24 hour format (two digits, leading zero) */,\n durationMarker: \"'\" /* signifies how long a task is, e.g. apostrophe: '2h5m or use another character, e.g. tilde: ~2h5m */,\n intervalMins: 5 /* inverval on which to calculate time blocks */,\n removeDuration: true /* remove duration when creating timeblock text */,\n defaultDuration: 20 /* default duration of a task that has no duration/end time */,\n mode: 'PRIORITY_FIRST' /* 'PRIORITY_FIRST' or 'LARGEST_FIRST' or 'BY_TIMEBLOCK_TAG' */,\n orphanTagggedTasks: \"OUTPUT_FOR_INFO (but don't schedule them)\",\n allowEventSplits: false /* allow tasks to be split into multiple timeblocks */,\n passBackResults: false /* pass back the results to the caller (e.g. for template calls) */,\n includeTasksWithText: [] /* limit to tasks with ANY of these tags/text */,\n excludeTasksWithText: [] /* exclude tasks with ANY of these tags/text */,\n includeLinks: 'Pretty Links',\n linkText: '📄',\n syncedCopiesTitle: \"Today's Synced Tasks\",\n foldSyncedCopiesHeading: false,\n runSilently: false,\n timeblockTextMustContainString: '' /* is set automatically when config is pulled */,\n foldersToIgnore: [],\n includeAllTodos: true,\n presets: [{ label: 'Limit Time Blocks to Work Hours', workDayStart: '08:00', workDayEnd: '17:59' }] /* presets for the dropdown */,\n /* OPTIONAL: nowStrOverride: \"00:00\" for testing, e.g. '00:00' */\n }\n}\n\nconst nonEmptyString: RegExp = /^(?!\\s*$).+/\n\nexport function validateAutoTimeBlockingConfig(config: AutoTimeBlockingConfig): AutoTimeBlockingConfig {\n const configTypeCheck = {\n todoChar: /^(?!(?:.*\\*){2})[\\*|\\-|\\+|#{1,}]+$/,\n timeBlockTag: /^.+/,\n timeBlockHeading: /^[^#+].*/,\n foldTimeBlockHeading: 'boolean',\n workDayStart: /^\\d{2}:\\d{2}$/,\n workDayEnd: /^\\d{2}:\\d{2}$/,\n durationMarker: nonEmptyString,\n intervalMins: 'number',\n removeDuration: 'boolean',\n syncedCopiesTitle: nonEmptyString,\n foldSyncedCopiesHeading: 'boolean',\n defaultDuration: 'number',\n mode: 'string',\n orphanTagggedTasks: 'string',\n checkedItemChecksOriginal: 'boolean',\n allowEventSplits: 'boolean',\n runSilently: { type: 'boolean', optional: true },\n passBackResults: { type: 'boolean', optional: true },\n includeLinks: nonEmptyString,\n linkText: nonEmptyString,\n includeTasksWithText: { type: 'array', optional: true },\n excludeTasksWithText: { type: 'array', optional: true },\n foldersToIgnore: { type: 'array', optional: true },\n presets: { type: 'array', optional: true },\n nowStrOverride: { type: /^\\d{2}:\\d{2}$/, optional: true },\n timeblockTextMustContainString: 'string',\n includeAllTodos: 'boolean',\n }\n try {\n // $FlowIgnore\n const validatedConfig = validateConfigProperties(config, configTypeCheck)\n if (validatedConfig.checkedItemChecksOriginal && (validatedConfig.todoChar !== '+' || validatedConfig.includeLinks !== 'Pretty Links')) {\n throw new Error(\n `To use the checklist check to check the original, your timeblock character must be + and the 'Include links to task location in time blocks' setting must be set to 'Pretty Links'`,\n )\n }\n if (config.timeBlockTag === DataStore.preference('timeblockTextMustContainString')) {\n throw new Error(\n `Your AutoTimeBlocking Tag must be different from your NotePlan Preferences 'Timeblock Must Contain' setting. /ATB has to be able to identify the items that were created previously by the plugin so it can delete and re-generate them.`,\n )\n }\n // $FlowIgnore\n return validatedConfig\n } catch (error) {\n // console.log(`NPTimeblocking::validateAutoTimeBlockingConfig: ${String(error)}\\nInvalid config:\\n${JSON.stringify(config)}`)\n throw new Error(`${String(error)}`)\n }\n}\n\nexport const arrayToCSV = (inStr: Array | string): string => (Array.isArray(inStr) ? inStr.join(', ') : inStr)\n\nexport type AutoTimeBlockingConfig = {\n todoChar: string,\n checkedItemChecksOriginal: boolean,\n timeBlockTag: string,\n timeBlockHeading: string,\n foldTimeBlockHeading: boolean,\n workDayStart: string,\n workDayEnd: string,\n durationMarker: string,\n intervalMins: number,\n removeDuration: boolean,\n syncedCopiesTitle: string,\n foldSyncedCopiesHeading: boolean,\n defaultDuration: number,\n mode: string,\n orphanTagggedTasks: string,\n allowEventSplits: boolean,\n runSilently?: boolean,\n passBackResults?: boolean,\n includeLinks: string,\n linkText: string,\n includeTasksWithText?: Array,\n excludeTasksWithText?: Array,\n foldersToIgnore?: Array,\n presets?: any,\n timeframes?: any,\n nowStrOverride?: string,\n timeblockTextMustContainString: string,\n includeAllTodos: boolean,\n dateFormat?: string,\n}\n" }, { "path": "dwertheimer.EventAutomations/src/events.js", "content": "// @flow\nimport { getEventsForDay } from '../../helpers/NPCalendar'\nimport { getTodaysDateUnhyphenated, type HourMinObj, toLocaleTime } from '../../helpers/dateTime'\nimport { chooseOption, chooseFolder } from '../../helpers/userInput'\nimport pluginJson from '../plugin.json'\nimport { logDebug } from '@helpers/dev'\n\nfunction getTimeOffset(offset: HourMinObj = { h: 0, m: 0 }) {\n const now = new Date()\n let min = now.getMinutes() + offset.m\n let hrCorrect = 0\n if (min < 0) {\n min = 60 + min\n hrCorrect = -1\n }\n let hr = now.getHours() + offset.h + hrCorrect\n if (hr < 0) hr = 0\n if (hr > 23) hr = 23\n // logDebug(pluginJson,`${hr}:${min}`)\n return { h: hr, m: min }\n}\n\nexport async function createNoteForCalendarItemWithQuickTemplate(): Promise {\n await createNoteForCalendarItem(true)\n}\n\nexport async function createNoteForCalendarItemWithoutQuickTemplate(): Promise {\n await createNoteForCalendarItem(false)\n}\n\nexport async function createNoteForCalendarItem(useQuickTemplate: boolean = true): Promise {\n const date = getTodaysDateUnhyphenated()\n logDebug(pluginJson, `Creating note for today's date: ${date}`)\n const allDaysEvents = await getEventsForDay(date)\n logDebug(pluginJson, `Found ${allDaysEvents?.length || 0} events for today`)\n const nowIshEvents = await getEventsForDay(date, [], getTimeOffset({ h: -1, m: 0 }), getTimeOffset({ h: +1, m: 0 })) // second param now implies consider all calendars\n logDebug(pluginJson, `Found ${nowIshEvents?.length || 0} events for nowIsh`)\n // const events = allDaysEvents\n if (nowIshEvents && nowIshEvents.length > 0) {\n // events = [...nowIshEvents, ...[{ title: '---' }], ...allDaysEvents]\n }\n // $FlowIgnore\n const selections = allDaysEvents.map((event) => {\n // $FlowIgnore\n const time = toLocaleTime(event.date, [], { hour: '2-digit', minute: '2-digit', hour12: false })\n // $FlowIgnore\n if (event.title) return { label: `${time}: ${event.title}`, value: event.title, time, date: event.date.toLocaleDateString() }\n })\n // $FlowIgnore\n const selectedEvent = await chooseOption('Choose an event to create a note for', selections, '')\n // Override the quickTemplateNote title with the selected event\n // $FlowIgnore\n const selEvent = selections.find((event) => event.value === selectedEvent)\n // $FlowIgnore\n // const theTime = selEvent.time === '00:00' ? '' : selEvent.time\n logDebug(pluginJson, `Selected event: ${selectedEvent} ${String(JSON.stringify(selEvent))}`)\n // $FlowIgnore\n // const theTitle = `${selectedEvent} {{date8601()}} ${theTime || ''}`\n if (selectedEvent && useQuickTemplate) {\n // quickTemplateNote is not defined!\n // await quickTemplateNote(theTitle)\n return\n }\n const useTemplate = await chooseOption(\n 'Use a template?',\n [\n { label: 'Yes', value: 'Yes' },\n { label: 'No', value: 'No' },\n ],\n 'Yes',\n )\n if (useTemplate !== 'No') {\n // newNoteWithTemplate is not defined!\n // await newNoteWithTemplate('', theTitle)\n } else {\n const folder = await chooseFolder('What folder should the note be in?')\n if (selEvent) {\n const title = `${selEvent.value} ${selEvent.date} ${selEvent.time && selEvent.time !== '00:00' ? selEvent.time : ''}`\n const fname = (await DataStore.newNote(title, folder)) ?? ''\n logDebug(pluginJson, `Creating note with title: ${title}, fname=${fname}`)\n if (fname) {\n await Editor.openNoteByFilename(fname, false)\n }\n }\n }\n}\n\n// function printEventsToConsole(events: Array): void {\n// events.forEach((event) => {\n// // ${event.notes} ${event.url}\n// logDebug(pluginJson,`${event.title} ${event.date} ${event.endDate} ${event.isAllDay}`)\n// })\n// }\n" }, { "path": "dwertheimer.EventAutomations/src/index.js", "content": "// @flow\nimport pluginJson from '../plugin.json'\nimport { updateSettingData, pluginUpdated } from '../../helpers/NPConfiguration'\nimport { log, logDebug, clo } from '../../helpers/dev'\n\nexport { editSettings } from '@helpers/NPSettings'\n\nexport {\n insertTodosAsTimeblocks,\n insertTodosAsTimeblocksWithPresets,\n insertSyncedCopiesOfTodayTodos,\n removeTimeBlocks,\n removePreviousTimeBlocks,\n markDoneAndRecreateTimeblocks,\n} from './NPTimeblocking'\n\nexport { onEditorWillSave } from './triggers'\n\nexport { createEvents, createEventPrompt } from './NPEventBlocks'\n\nconst PLUGIN_ID = 'autoTimeBlocking' // the key that's used in _configuration note\n\nexport async function onUpdateOrInstall(): Promise {\n try {\n console.log(`${PLUGIN_ID}: onUpdateOrInstall running`)\n // migrate _configuration data to data//settings.json (only executes migration once)\n const updateSettings = updateSettingData(pluginJson)\n console.log(`${PLUGIN_ID}: onUpdateOrInstall updateSettingData code: ${updateSettings}`)\n } catch (error) {\n await console.log(error)\n }\n console.log(`${PLUGIN_ID}: onUpdateOrInstall finished`)\n}\n\nexport function onSettingsUpdated() {}\n\nexport function init(): void {\n // this runs every time the plugin starts up (any command in this plugin is run)\n // clo(DataStore.settings, `${pluginJson['plugin.id']} Plugin Settings`)\n console.log(`\\n\\n\\n`)\n DataStore.installOrUpdatePluginsByID([pluginJson['plugin.id']], true, false, false).then((r) => pluginUpdated(pluginJson, r))\n}\n" }, { "path": "dwertheimer.EventAutomations/src/presets.js", "content": "import { logDebug } from '@helpers/dev'\n\n/**\n * This is used for the TimeBlocking presets in preferences\n */\n\n/**\n * Presets have a label and other properties which overwrite the default config\n * @param {*} config - the config object\n * @param {*} preset - the preset object\n */\nexport function setConfigForPreset(config, preset) {\n if (preset) {\n Object.keys(preset).forEach((key) => {\n if (key !== 'label') {\n config[key] = preset[key]\n }\n })\n }\n return config\n}\n\nexport const getPresetOptions = (presets) => {\n return presets.map((p, i) => {\n return { label: p.label, value: i }\n })\n}\n\nexport function getPreset(config) {\n if (config.preset && config.preset.length) {\n return config.preset\n } else {\n return null\n }\n}\n" }, { "path": "dwertheimer.EventAutomations/src/timeblocking-flow-types.js", "content": "// @flow\n\nexport type IntervalMap = Array<{ start: string, busy: string | boolean, index: number }>\nexport type OpenBlock = { start: string, end: string, minsAvailable: number, title?: string }\nexport type BlockArray = Array\nexport type TimeBlocksWithMap = { timeMap: IntervalMap, blockList?: BlockArray, timeBlockTextList?: Array, noTimeForTasks?: { [string]: Array } | null }\nexport type TimeBlockTextList = Array\nexport type BlockTimeOptions = { mode: string }\nexport type BlockData = { start: string, end: string, title?: string }\nexport type TimeBlockDefaults = {\n todoChar: string,\n timeBlockTag: string,\n timeBlockHeading: string,\n workDayStart: string,\n workDayEnd: string,\n durationMarker: string,\n intervalMins: number,\n removeDuration: boolean,\n defaultDuration: number,\n nowStrOverride?: string /* for testing */,\n mode: string,\n allowEventSplits: boolean,\n passBackResults: boolean,\n}\nexport type PartialCalendarItem = {\n title: string,\n date: Date,\n endDate: Date,\n type: string,\n availability: number,\n}\n\nexport interface ParagraphWithDuration extends TParagraph {\n duration: number;\n}\n\nexport type Tags = {\n [key: string]: Array,\n}\n\nexport type MatchedItems = {\n [key: string]: Array,\n}\n\nexport type SplitResult = {\n matched: MatchedItems,\n unmatched: Array,\n}\n" }, { "path": "dwertheimer.EventAutomations/src/timeblocking-helpers.js", "content": "// @flow\nimport { endOfDay, startOfDay, eachMinuteOfInterval, formatISO9075, addMinutes, differenceInMinutes } from 'date-fns'\nimport type { SortableParagraphSubset } from '../../helpers/sorting'\nimport { escapeRegExp } from '../../helpers/regex'\nimport { getTagsFromString } from '../../helpers/paragraph'\nimport type {\n IntervalMap,\n OpenBlock,\n TimeBlocksWithMap,\n BlockData,\n TimeBlockDefaults,\n PartialCalendarItem,\n ParagraphWithDuration,\n SplitResult,\n MatchedItems,\n Tags,\n} from './timeblocking-flow-types'\nimport type { AutoTimeBlockingConfig } from './config'\n\nimport { getDateObjFromDateTimeString, getTimeStringFromDate, removeRepeats } from '@helpers/dateTime'\nimport { sortListBy } from '@helpers/sorting'\nimport { removeDateTagsAndToday } from '@helpers/stringTransforms'\nimport { textWithoutSyncedCopyTag } from '@helpers/syncedCopies'\nimport { createPrettyLinkToLine, createWikiLinkToLine } from '@helpers/NPSyncedCopies'\nimport { logError, JSP, copyObject, clo, clof, logDebug, logWarn, deepCopy } from '@helpers/dev'\n\n// import { timeblockRegex1, timeblockRegex2 } from '../../helpers/markdown-regex'\n\nconst pluginJson = `timeblocking-helpers.js`\n\n/**\n * Create a map of the time intervals for a portion of day\n * @param {*} start\n * @param {*} end\n * @param {*} valueToSet\n * @param {*} options\n * @returns Array of objects with the following properties: [{\"start\":\"00:00\",\"busy\":false},{\"start\":\"00:05\",\"busy\":false}...]\n */\nexport function createIntervalMap(time: { start: Date, end: Date }, valueToSet: false | string = false, options: { step: number } = { step: 5 }): IntervalMap {\n const { start, end } = time\n const { step } = options\n if (step && step > 0) {\n const intervals = eachMinuteOfInterval({ start, end }, { step })\n return intervals.map((interval, i) => {\n const start = formatISO9075(interval).slice(0, -3)\n const time = start.split(' ')[1]\n return { start: time, busy: valueToSet, index: i }\n })\n }\n return []\n}\n\nexport function getBlankDayMap(intervalMins: number): IntervalMap {\n return createIntervalMap({ start: startOfDay(new Date()), end: endOfDay(new Date()) }, false, { step: intervalMins })\n}\n\nexport function blockTimeFor(timeMap: IntervalMap, blockdata: BlockData, config: { [key: string]: any }): { newMap: IntervalMap, itemText: string } {\n const { start, end, title } = blockdata\n const newMap = timeMap.map((t) => {\n if (t.start >= start && t.start < end) {\n t.busy = title ?? true\n }\n return t\n })\n const itemText = typeof title === 'boolean' ? '' : createTimeBlockLine({ title, start, end }, config)\n return { newMap, itemText }\n}\n\n/**\n * Clean text using an array of regexes or strings to replace\n */\nexport function cleanText(text: string, replacements: Array): string {\n let cleanString = text\n replacements.forEach((r) => {\n cleanString = cleanString.replace(r, ' ')\n })\n cleanString = cleanString.replace(/ {2,}/g, ' ').trim()\n return cleanString\n}\n\n/**\n * Remove all ATB-CREATED formatting from a timeblock line and return just the content (so we can do comparisons)\n * e.g. \"00:01-12:22 foo bar baz\" -> \"foo bar baz\"\n * @param {string} line\n * @param {TimeBlockDefaults} config\n * @returns {string} clean string\n */\nexport function cleanTimeBlockLine(line: string, config: { [key: string]: any }): string {\n const { timeBlockTag, durationMarker } = config\n // use .*? for non-greedy (match minimum chars) and make sure to use global flag for all matches\n const cleanerRegexes = [\n new RegExp(`^\\\\d{2}:\\\\d{2}-\\\\d{2}:\\\\d{2} `, 'g'),\n new RegExp(` ${escapeRegExp(timeBlockTag)}`, 'g'),\n new RegExp(`\\\\[\\\\[.*?\\\\]\\\\]`, 'g'),\n new RegExp(`\\\\[.*?\\\\]\\\\(.*?\\\\)`, 'g'),\n ]\n let clean = cleanText(line, cleanerRegexes)\n clean = removeDurationParameter(clean, durationMarker)\n clean = removeDateTagsAndToday(clean, true)\n clean = clean.replace(DataStore?.preference('timeblockTextMustContainString') || '', '')\n return clean\n // cleanString = removeDateTagsAndToday(cleanString)\n}\n\nexport function attachTimeblockTag(content: string, timeblockTag: string): string {\n const regEx = new RegExp(` ${escapeRegExp(timeblockTag)}`, 'g') //replace the existing tag if it's there\n return `${content.replace(regEx, '')} ${timeblockTag}`\n}\n\nexport function createTimeBlockLine(blockData: BlockData, config: { [key: string]: any }): string {\n if (blockData.title && blockData.title.length > 0) {\n let newContentLine = blockData.title\n if (config.removeDuration) {\n newContentLine = removeDurationParameter(newContentLine, config.durationMarker)\n }\n newContentLine = attachTimeblockTag(newContentLine, config.timeBlockTag)\n let tbLine = `${config.todoChar} ${blockData.start}-${blockData.end} ${newContentLine || blockData.title || ''}`\n logDebug(pluginJson, `createTimeBlockLine: tbLine=\"${tbLine}\" config.timeblockTextMustContainString=\"${config.timeblockTextMustContainString}\"`)\n const tbMustContainTrimmed = config.timeblockTextMustContainString?.trim() || ''\n if (tbMustContainTrimmed.length && !tbLine.includes(tbMustContainTrimmed)) {\n tbLine = `${tbLine} ${tbMustContainTrimmed}`\n }\n return tbLine\n }\n return ''\n}\n\n/**\n * Takes in an array of calendar items and a timeMap for the day\n * and returns the timeMap with the busy times updated to reflect the calendar items\n * @author @dwertheimer\n *\n * @param {Array} events\n * @param {IntervalMap} timeMap\n * @param {TimeBlockDefaults} config\n * @returns {IntervalMap} - the timeMap with the busy times updated to reflect the calendar items\n */\nexport function blockOutEvents(events: Array, timeMap: IntervalMap, config: { [key: string]: any }): IntervalMap {\n let newTimeMap = [...timeMap]\n events\n .filter((e) => e.availability !== 1)\n .forEach((event) => {\n const start = getTimeStringFromDate(event.date)\n const end = event.endDate ? getTimeStringFromDate(event.endDate) : ''\n const obj = event.endDate ? blockTimeFor(newTimeMap, { start, end, title: event.title }, config) : { newMap: newTimeMap }\n newTimeMap = obj.newMap\n })\n return newTimeMap\n}\n\n/**\n * Typically we are looking for open tasks, but it is possible that some >today items\n * might be bullets (type=='list'), so for timeblocking purposes, let's make them open tasks\n * for the purposes of this script\n * @author @dwertheimer\n *\n * @param {TParagraphs[]} paras\n * @returns TParagraphs[] - with remapped items\n */\nexport function makeAllItemsTodos(paras: Array): Array {\n const typesToRemap = ['list', 'text']\n // NOTEPLAN FRUSTRATION! YOU CANNOT SPREAD THE ...P AND GET THE\n // UNDERLYING VALUES!\n // return paras.map((p) => {p.type = ({ ...p, type: typesToRemap.indexOf(p.type) !== -1 ? 'open' : p.type }))\n return paras.map((p) => {\n p.type = typesToRemap.indexOf(p.type) !== -1 ? 'open' : p.type\n return p\n })\n}\n\n// Numbered groups only: named groups (?...) are not supported on macOS 12 / older JavaScriptCore.\n// Group 2 = hours number, group 5 = minutes number (when present).\nexport const durationRegEx = (durationMarker: string) =>\n new RegExp(\n `\\\\s*${durationMarker}(([0-9]+\\\\.?[0-9]*|\\\\.[0-9]+)(hours|hour|hr|h))?(([0-9]+\\\\.?[0-9]*|\\\\.[0-9]+)(minutes|mins|min|m))?`,\n 'mg',\n )\n\nexport const removeDurationParameter = (text: string, durationMarker: string): string => text.replace(durationRegEx(durationMarker), '').trim()\n\nexport function getDurationFromLine(line: string, durationMarker: string): number {\n const regex = durationRegEx(durationMarker)\n const match = regex.exec(line)\n let mins = 0\n if (match) {\n const hours = match[2] != null && match[2] !== '' ? Number(match[2]) : 0\n const minutes = match[5] != null && match[5] !== '' ? Number(match[5]) : 0\n mins = Math.ceil(hours * 60 + minutes)\n }\n clo(match, `+++++++ getDurationFromLine match=${String(match)}, so setting mins=${mins} for \"${line}\"; match groups=`)\n return mins\n}\n\n/**\n * Remove >date and >today tags from a paragraphs array and return only the most important parts\n * Note: rawContent is used later for mapping sorted tasks back to paragraphs\n * @author @dwertheimer\n *\n * @param {*} paragraphsArray\n * @returns\n */\nexport function removeDateTagsFromArray(paragraphsArray: $ReadOnlyArray): Array | $ReadOnlyArray {\n try {\n const newPA = paragraphsArray.map((p): any => {\n const copy = copyObject(p)\n copy.content = removeDateTagsAndToday(p.content)\n copy.rawContent = removeDateTagsAndToday(p.rawContent)\n return copy\n })\n return newPA\n } catch (error) {\n logError(`timeblocking-helppers::removeDateTagsFromArray failed. Error:`, JSP(error))\n }\n return paragraphsArray\n}\n\nexport const timeIsAfterWorkHours = (nowStr: string, config: TimeBlockDefaults): boolean => {\n return nowStr >= config.workDayEnd\n}\n\n/**\n * Get the day map with only the slots that are open, after now and inside of the workday\n * @author @dwertheimer\n *\n * @param {*} timeMap\n * @param {*} config\n * @returns {IntervalMap} remaining time map\n */\nexport function filterTimeMapToOpenSlots(timeMap: IntervalMap, config: { [key: string]: any }): IntervalMap {\n const nowStr = config.nowStrOverride ?? getTimeStringFromDate(new Date())\n const byTagMode = config.mode === 'BY_TIMEBLOCK_TAG'\n const retVal = timeMap.filter((t) => {\n // should filter to only open slots but will also include slots that are busy but have the timeblock tag - DataStore.preference('timeblockTextMustContainString')\n const isSet = typeof t.busy === 'string'\n return (\n t.start >= nowStr &&\n t.start >= config.workDayStart &&\n t.start < config.workDayEnd &&\n (!t.busy ||\n (byTagMode &&\n ((isSet && String(t.busy).includes(config.timeBlockTag)) ||\n (config.timeblockTextMustContainString?.length && isSet && String(t.busy).includes(config.timeblockTextMustContainString)))))\n )\n })\n // logDebug(`\\n\\nfilterTimeMapToOpenSlots: ${JSP(retVal)}`)\n return retVal\n}\n\nexport function createOpenBlockObject(block: BlockData, config: { [key: string]: any }, includeLastSlotTime: boolean = true): OpenBlock | null {\n let startTime, endTime\n try {\n startTime = getDateObjFromDateTimeString(`2021-01-01 ${block.start || '00:00'}`)\n endTime = getDateObjFromDateTimeString(`2021-01-01 ${block.end || '23:59'}`)\n } catch (error) {\n logError(`${error.message} for block:${JSP(block)} and config:${JSP(config)}`)\n return null\n }\n endTime = endTime ? (includeLastSlotTime ? addMinutes(endTime, config.intervalMins) : endTime) : null\n endTime = endTime && endTime <= endOfDay(startTime) ? endTime : endOfDay(startTime) // deal with edge case where end time is in the next day\n if (!startTime || !endTime) return null\n return {\n start: getTimeStringFromDate(startTime),\n // $FlowIgnore\n end: getTimeStringFromDate(endTime),\n // $FlowIgnore\n minsAvailable: differenceInMinutes(endTime, startTime, { roundingMethod: 'ceil' }),\n title: block.title,\n }\n}\n\n/**\n * Given an array of open timeslots from a day's IntervalMap, sends back\n * an array of the contiguous slots (assumes busy/unavailable slots have been\n * eliminated before calling this function (eg using filterTimeMapToOpenSlots()).\n * @param {IntervalMap} timeMap\n * @param {number} intervalMins\n * @returns array of OpenBlock objects\n */\nexport function findTimeBlocks(timeMap: IntervalMap, config: { [key: string]: any }): Array {\n const blocks: Array = []\n if (timeMap?.length) {\n let lastSlot = timeMap[0]\n let blockStart = timeMap[0]\n for (let i = 1; i < timeMap.length; i++) {\n const slot = timeMap[i]\n // console.log(`findTimeBlocks[${i}]: slot: ${slot.start} ${slot.index} ${slot.busy}}`)\n const noBreakInContinuity = slot.index === lastSlot.index + 1 && i <= timeMap.length - 1 && lastSlot.busy === slot.busy\n if (noBreakInContinuity) {\n lastSlot = slot\n continue\n } else {\n // there was a break in continuity\n // logDebug(`findTimeBlocks: lastSlot break in continuity at ${i}: ${JSP(lastSlot)}`)\n const title =\n typeof lastSlot.busy === 'string' /* this was a named timeblock */\n ? lastSlot.busy\n // .replace(config.timeblockTextMustContainString || '', '') //if you do this, then the tb will be screened out later\n .replace(/ {2,}/g, ' ')\n .trim()\n : ''\n // logDebug(`findTimeBlocks: creating block title: ${title}`)\n const block = createOpenBlockObject({ start: blockStart.start, end: lastSlot.start, title }, config, true)\n // clo(block, `findTimeBlocks: block created`)\n if (block) blocks.push(block)\n blockStart = slot\n lastSlot = slot\n }\n }\n if (timeMap.length && lastSlot === timeMap[timeMap.length - 1]) {\n // pick up the last straggler edge case\n const title =\n typeof lastSlot.busy === 'string'\n ? lastSlot.busy\n // .replace(config.timeblockTextMustContainString || '', '') //if you do this, then the tb will be screened out later\n .replace(/ {2,}/g, ' ')\n .trim()\n : ''\n const lastBlock = createOpenBlockObject({ start: blockStart.start, end: lastSlot.start, title }, config, true)\n if (lastBlock) blocks.push(lastBlock)\n }\n } else {\n // console.log(`findTimeBlocks: timeMap array was empty`)\n }\n // console.log(`findTimeBlocks: found blocks: ${JSP(blocks)}`)\n\n return blocks\n}\n\nexport function addMinutesToTimeText(startTimeText: string, minutesToAdd: number): string {\n try {\n const startTime = getDateObjFromDateTimeString(`2021-01-01 ${startTimeText}`)\n return startTime ? getTimeStringFromDate(addMinutes(startTime, minutesToAdd)) : ''\n } catch (error) {\n logError(`${error.message} for startTimeText:${startTimeText} and minutesToAdd:${minutesToAdd}`)\n return ``\n }\n}\n\n/**\n * Blocks time for the block specified and returns a new IntervalMap, new BlockList, and new TextList of time blocks\n * @param {*} tbm\n * @param {*} block\n * @param {*} config\n * @returns TimeBlocksWithMap\n */\nexport function blockTimeAndCreateTimeBlockText(tbm: TimeBlocksWithMap, block: BlockData, config: { [key: string]: any }): TimeBlocksWithMap {\n const timeBlockTextList = tbm.timeBlockTextList || []\n const obj = blockTimeFor(tbm.timeMap, block, config) //returns newMap, itemText\n timeBlockTextList.push(textWithoutSyncedCopyTag(obj.itemText))\n const timeMap = filterTimeMapToOpenSlots(obj.newMap, config)\n const blockList = findTimeBlocks(timeMap, config)\n return { timeMap, blockList, timeBlockTextList }\n}\n\n/**\n * Finds a named hashtag or attag in a line of text.\n *\n * @param {string} blockName - The name of the block to search for.\n * @param {string} line - The line of text to search in.\n * @param {Object.} config - The configuration object.\n * @return {?string} - The matched tag or null if no match is found.\n */\nexport function namedTagExistsInLine(blockName: string, line: string): boolean {\n // Sanitize blockName to escape RegExp special characters\n const sanitizedBlockName = escapeRegExp(blockName)\n const regex = new RegExp(sanitizedBlockName, 'gi')\n const match = regex.exec(line)\n return match ? true : false\n}\n\n/**\n * Reduce an array of objects to a single object with the same keys and the values combined into arrays\n * @param {*} arr - the array of objects to reduce\n * @param {*} propToLookAt - if you only want to look at one key in each top level object\n * @returns a single object with the same keys and the values combined into arrays\n */\nfunction reduceArrayOfObjectsToSingleObject(arr: Array<{ [key: string]: any }>, propToLookAt? = null): { [key: string]: any } {\n return arr.reduce((acc, obj) => {\n const o = propToLookAt ? obj[propToLookAt] : obj\n Object.keys(o).forEach((key) => {\n if (acc[key]) {\n acc[key] = [...acc[key], ...o[key]]\n } else {\n acc[key] = o[key]\n }\n })\n return acc\n }, {})\n}\n\n/**\n * Splits an array of items into two categories based on matching hashtags.\n * For items with matching hashtags, it groups them under the matched tag using the tag as the key\n * NOTE: an item can be matched to multiple tags\n *\n * @param {Array} arrayOfItems - The array of items to split, where each item has a 'hashtags' property.\n * @param {Tags} tags - An object where each key represents a tag to match against the items' hashtags.\n * @returns {SplitResult} An object containing a 'matched' object with properties for each tag and their corresponding matching items, and an 'unmatched' array for items without matching tags.\n */\nexport function splitItemsByTags(arrayOfItems: Array, tags: Tags): SplitResult {\n const matched: MatchedItems = {}\n const unmatched: Array = []\n\n arrayOfItems.forEach((item) => {\n let isMatched = false\n const hashtags = getTagsFromString(item.content, false).hashtags\n hashtags.forEach((hashtag) => {\n if (tags.hasOwnProperty(hashtag)) {\n if (!matched[hashtag]) {\n matched[hashtag] = []\n }\n matched[hashtag].push(item)\n isMatched = true\n }\n })\n\n if (!isMatched) {\n unmatched.push(item)\n }\n })\n\n return { matched, unmatched }\n}\n\n/**\n * Process the tasks that have a named tag in them (e.g. @work or #work)\n * @param {*} sortedTaskList\n * @param {TimeBlocksWithMap} tmb\n * @param {*} config\n * @returns {TimeBlocksWithMap}\n */\nexport function ORIGINALprocessByTimeBlockTag(sortedTaskList: Array, tmb: TimeBlocksWithMap, config: { [key: string]: any }): TimeBlocksWithMap {\n const { blockList, timeMap } = tmb\n let newBlockList = blockList\n let unprocessedTasks = [...sortedTaskList]\n const results = []\n let noTimeForTasks = {}\n const { matched: timeframeMatches, unmatched: regularTasks } = splitItemsByTags(sortedTaskList, config.timeframes || {})\n const namedBlocks = getNamedTimeBlocks(newBlockList ?? [])\n clo(blockList, `processByTimeBlockTag: blockList`)\n // const namedBlocksIncludingTimeframes = getTimeframeNameBlocks(namedBlocks, timeframeMatches)\n clo(namedBlocks, `processByTimeBlockTag: namedBlocks (timeblocks that are not ATB blocks)`)\n\n // start\n if (namedBlocks.length === 0) {\n logWarn(`processByTimeBlockTag we are in TIMEBLOCK_TAG mode but there are no named blocks`)\n } else {\n logDebug(`processByTimeBlockTag namedBlocks(${namedBlocks.length}):${namedBlocks.reduce((acc, val) => `${acc}, ${val.title || ''}`, '')}`)\n }\n namedBlocks.forEach((block) => {\n const blockTitle = (block.title || '').replace(config.timeblockTextMustContainString, '').replace(/ {2,}/g, ' ').trim()\n //$FlowIgnore\n const tasksMatchingThisNamedTimeblock = unprocessedTasks.filter((task) => (block.title ? namedTagExistsInLine(blockTitle, task.content) : false))\n logDebug(`processByTimeBlockTag tasksMatchingThisNamedTimeblock (${blockTitle}): ${JSP(tasksMatchingThisNamedTimeblock.map((p) => p.content || ''))}`)\n tasksMatchingThisNamedTimeblock.forEach((task, i) => {\n // call matchTasksToSlots for each block as if the block all that's available\n // remove from sortedTaskList\n // $FlowIgnore\n logDebug(pluginJson, `Calling matchTasksToSlots for item[${i}]: ${task.content} duration:${task.duration}`)\n // const filteredTimeMap = timeMap.filter((t) => t.start >= block.start && t.start <= block.end)\n const filteredTimeMap = timeMap.filter((t) => typeof t.busy === 'string' && t.busy.includes(blockTitle) && t.busy.includes(config.timeblockTextMustContainString))\n // Acting as if all blocks are just this named block\n const newTimeBlockWithMap = matchTasksToSlots([task], { blockList: [block], timeMap: filteredTimeMap }, config)\n unprocessedTasks = unprocessedTasks.filter((t) => t !== task) // remove the task from the list\n const foundTimeForTask = newTimeBlockWithMap.timeBlockTextList && newTimeBlockWithMap.timeBlockTextList.length > 0\n if (foundTimeForTask) {\n results.push(newTimeBlockWithMap)\n } else {\n if (!noTimeForTasks) noTimeForTasks = {}\n if (!noTimeForTasks[blockTitle]) noTimeForTasks[blockTitle] = []\n noTimeForTasks[blockTitle].push(task)\n }\n })\n newBlockList = blockList?.filter((b) => b !== block) // remove the block from the list\n })\n //stop\n // [\"IGNORE_THEM\",\"OUTPUT_FOR_INFO (but don't schedule them)\", \"SCHEDULE_ELSEWHERE_LAST\", \"SCHEDULE_ELSEWHERE_FIRST\"]\n const noTimeTasks = Object.values(noTimeForTasks || {}).reduce((acc, val) => acc.concat(val), [])\n switch (config.orphanTagggedTasks) {\n case 'IGNORE_THEM':\n noTimeForTasks = null\n break\n case \"OUTPUT_FOR_INFO (but don't schedule them)\":\n break\n case 'SCHEDULE_ELSEWHERE_LAST':\n unprocessedTasks = [...unprocessedTasks, ...noTimeTasks]\n break\n case 'SCHEDULE_ELSEWHERE_FIRST':\n unprocessedTasks = [...noTimeTasks, ...unprocessedTasks]\n break\n }\n // process the rest of the tasks\n newBlockList = blockList?.filter((b) => !b.title || b.title === '') || [] // remove the named blocks from the list\n\n config.mode = 'PRIORITY_FIRST' // now that we've processed the named blocks, we can process the rest of the tasks by priority\n // $FlowIgnore\n results.push(matchTasksToSlots(unprocessedTasks, { blockList: newBlockList, timeMap }, config))\n\n return {\n noTimeForTasks: reduceArrayOfObjectsToSingleObject(results, 'noTimeForTasks'),\n timeMap,\n blockList: newBlockList,\n timeBlockTextList: results.reduce((acc, currentValue) => acc.concat(currentValue.timeBlockTextList), []).sort(),\n }\n}\n\n/**\n *\n * @param {Array} sortedTaskList\n * @param {TimeBlocksWithMap} tmb\n * @param {[key: string]: any} config\n * @returns {TimeBlocksWithMap}\n */\nexport function matchTasksToSlots(sortedTaskList: Array, tmb: TimeBlocksWithMap, config: { [key: string]: any }): TimeBlocksWithMap {\n const { timeMap } = tmb\n let newMap = filterTimeMapToOpenSlots(timeMap, config)\n let newBlockList = findTimeBlocks(newMap, config)\n const { durationMarker } = config\n let timeBlockTextList = []\n const noTimeForTasks = {}\n\n clof(sortedTaskList, `matchTasksToSlots: sortedTaskList`, null, true)\n\n // sortedTaskList.forEach((task) => {\n for (let t = 0; t < sortedTaskList.length; t++) {\n const task = sortedTaskList[t]\n const taskTitle = removeRepeats(removeDateTagsAndToday(task.content))\n const taskDuration = task.duration || getDurationFromLine(task.content, durationMarker) || config.defaultDuration // default time is 15m\n logDebug(`== matchTasksToSlots task=\"${t}: ${task.content}\" newBlockList.length=${newBlockList?.length || ''}`)\n if (newBlockList && newBlockList.length) {\n let scheduling = true\n let schedulingCount = 0\n let scheduledMins = 0\n // $FlowIgnore - flow doesn't like .length below but it is safe\n for (let i = 0; i < newBlockList.length && scheduling; i++) {\n if (newBlockList && newBlockList[i]) {\n let block = newBlockList[i]\n const blockDuration = block.minsAvailable\n let endTime = ''\n while (scheduling && scheduledMins < taskDuration) {\n if (taskDuration <= blockDuration) {\n endTime = addMinutesToTimeText(block.start, taskDuration)\n scheduling = false\n } else {\n if (config.allowEventSplits) {\n const minsToUse = Math.min(block.minsAvailable, taskDuration - scheduledMins)\n endTime = addMinutesToTimeText(block.start, minsToUse)\n schedulingCount++\n scheduledMins += minsToUse\n } else {\n break //look for the next block that could work\n }\n }\n endTime = endTime !== '00:00' ? endTime : '23:59' //deal with edge case where end time is technically in the next day\n const blockData = {\n start: block.start,\n end: endTime,\n title: `${taskTitle}${schedulingCount ? ` (${schedulingCount})` : ''}`,\n }\n const newTimeBlockWithMap = blockTimeAndCreateTimeBlockText({ timeMap: newMap, blockList: newBlockList, timeBlockTextList }, blockData, config)\n // Re-assign newMap, newBlockList, and timeBlockTextList for next loop run\n ;({ timeMap: newMap, blockList: newBlockList, timeBlockTextList } = newTimeBlockWithMap)\n if (newBlockList && newBlockList.length) {\n block = newBlockList[0]\n } else {\n break\n }\n if (!scheduling) break\n }\n }\n }\n if (scheduling) {\n logDebug(`matchTasksToSlots task[${t}]=\"${taskTitle}\" scheduling:${String(scheduling)}. Pushing to noTimeForTasks array`)\n if (!noTimeForTasks['_']) noTimeForTasks['_'] = []\n noTimeForTasks['_'].push(task)\n }\n } else {\n logDebug(`matchTasksToSlots task[${t}]=\"${taskTitle}\" no blocks. saving.`)\n if (!noTimeForTasks['_']) noTimeForTasks['_'] = []\n noTimeForTasks['_'].push(task)\n }\n }\n return { timeMap: newMap, blockList: newBlockList, timeBlockTextList, noTimeForTasks }\n}\n\n/**\n * Attach links to the underlying todo note/heading if open and is not a task in today's note and if the config calls for it\n * @param { [todos] } todos\n * @param { * } config\n * @returns\n */\nexport function appendLinkIfNecessary(todos: Array, config: AutoTimeBlockingConfig): Array {\n let todosWithLinks = []\n try {\n if (todos.length && config.includeLinks !== 'OFF') {\n todosWithLinks = []\n todos.forEach((e) => {\n const isInToday = e.note?.filename === Editor.note?.filename\n if (e.type === 'open' && !isInToday) {\n // don't create URL links for tasks in the same note\n let link = ''\n if (config.includeLinks === '[[internal#links]]') {\n // link = ` ${returnNoteLink(e.note?.title ?? '', e.heading)}`\n link = ` ${createWikiLinkToLine(e)}`\n } else {\n if (config.includeLinks === 'Pretty Links') {\n // link = ` ${createPrettyOpenNoteLink(config.linkText, e.filename ?? 'unknown', true, e.heading)}`\n link = ` ${createPrettyLinkToLine(e, config.linkText)}`\n }\n }\n e.content = `${textWithoutSyncedCopyTag(e.content).replace(link, '')}${link}`\n }\n todosWithLinks.push(e)\n })\n } else {\n todosWithLinks = todos\n }\n } catch (error) {\n logError('timeblocking-helpers::appendLinkIfNecessary ${error}', JSP(error))\n }\n return todosWithLinks\n}\n\nexport const addDurationToTasks = (tasks: Array, config: { [key: string]: any }): Array => {\n const dTasks = tasks.map((t) => {\n // $FlowIgnore - Flow doesn't like spreading interfaces\n const copy = { ...t, duration: 0 }\n copy.duration = getDurationFromLine(t.content, config.durationMarker) || config.defaultDuration\n return copy\n })\n return dTasks\n}\n\nexport function getTimeBlockTimesForEvents(timeMap: IntervalMap, todos: Array, config: { [key: string]: any }): TimeBlocksWithMap {\n let newInfo = { timeMap, blockList: [], timeBlockTextList: [], noTimeForTasks: {} }\n // $FlowIgnore\n const availableTimes = filterTimeMapToOpenSlots(timeMap, config) // will be different for BY_TIMEBLOCK_TAG\n if (availableTimes.length === 0) {\n timeMap.forEach((m) => console.log(`getTimeBlockTimesForEvents no more times available: ${JSON.stringify(m)}`))\n }\n const blocksAvailable = findTimeBlocks(availableTimes, config)\n if (availableTimes.length && todos?.length && blocksAvailable?.length && timeMap?.length && config.mode) {\n const todosWithDurations = addDurationToTasks(todos, config)\n switch (config.mode) {\n case 'PRIORITY_FIRST': {\n // Go down priority list and split events if necessary\n const sortedTaskList = sortListBy(todosWithDurations, ['-priority', 'duration'])\n newInfo = matchTasksToSlots(sortedTaskList, { blockList: blocksAvailable, timeMap: availableTimes }, config)\n logDebug(pluginJson, `getTimeBlockTimesForEvents newInfo.noTimeForTasks=${JSP(newInfo.noTimeForTasks)}`)\n // const { timeBlockTextList, timeMap, blockList } = newInfo\n break\n }\n case 'LARGEST_FIRST': {\n // TODO: actually need to implement this\n const sortedTaskList = sortListBy(todosWithDurations, ['-duration', '-priority'])\n // const sortedBlockList = sortListBy(blocksAvailable, ['-minsAvailable']) //won't work because blocks gets recalced\n newInfo = matchTasksToSlots(sortedTaskList, { blockList: blocksAvailable, timeMap: availableTimes }, config)\n // FIXME: HERE AND RESULT IS NOT RIGHT\n break\n }\n case 'BY_TIMEBLOCK_TAG': {\n const sortedTaskList = sortListBy(todosWithDurations, ['-priority', 'filename', '-duration'])\n // clo(blocksAvailable, `getTimeBlockTimesForEvents blocksAvailable`)\n // clo(timeMap, `getTimeBlockTimesForEvents timeMap`)\n // clo(sortedTaskList, `getTimeBlockTimesForEvents sortedTaskList`)\n newInfo = processByTimeBlockTag(sortedTaskList, { blockList: blocksAvailable, timeMap: availableTimes }, config)\n break\n }\n case 'MANUAL_ORDERING': {\n const sortedTaskList = sortListBy(todosWithDurations, ['lineIndex'])\n newInfo = matchTasksToSlots(sortedTaskList, { blockList: blocksAvailable, timeMap: availableTimes }, config)\n }\n }\n } else {\n logDebug(\n `INFO: getTimeBlockTimesForEvents nothing will be entered because todos.length=${todos.length} blocksAvailable.length=${blocksAvailable.length} timeMap.length=${timeMap.length} config.mode=${config.mode}`,\n )\n }\n return newInfo\n}\n\n/**\n * (unused)\n * Remove all the timeblock added text so as to not add it to the todo list (mostly for synced lines)\n * @param {*} line\n */\n// export function isAutoTimeBlockLine(line: string, config?: { [key: string]: any }): null | string {\n// // otherwise, let's scan it for the ATB signature\n// // this is probably superfluous, but it's here for completeness\n// let re = /(?:[-|\\*] \\d{2}:\\d{2}-\\d{2}:\\d{2} )(.*)(( \\[.*\\]\\(.*\\))|( \\[\\[.*\\]\\]))(?: #.*)/\n// let m = re.exec(line)\n// if (m && m[1]) {\n// return m[1]\n// }\n// return null\n// }\n\n/**\n * (unused)\n * Remove items from paragraph list that are auto-time-block lines\n * @param {*} paras\n */\n// export function removeTimeBlockParas(paras: Array): Array {\n// return paras.filter((p) => !isAutoTimeBlockLine(p.content))\n// }\n\n// pattern could be a string or a /regex/ in a string\nexport function getRegExOrString(input: string | RegExp): RegExp | string {\n if (input instanceof RegExp) return input\n const str = input.trim()\n if (str.startsWith('/') && str.endsWith('/')) {\n return new RegExp(str.slice(1, -1))\n } else {\n return str\n }\n}\n\nexport function includeTasksWithPatterns(tasks: $ReadOnlyArray, pattern: string | $ReadOnlyArray): Array {\n if (Array.isArray(pattern)) {\n return tasks.filter((t) => pattern.some((p) => t.content.match(getRegExOrString(p))))\n } else if (typeof pattern === 'string') {\n const pattArr = pattern.split(',')\n return tasks.filter((t) => pattArr.some((p) => t.content.match(getRegExOrString(p))))\n } else {\n // must be a regex\n return tasks.filter((t) => t.content.match(pattern))\n }\n}\n\nexport function excludeTasksWithPatterns(tasks: Array, pattern: string | Array): Array {\n if (Array.isArray(pattern)) {\n return tasks.filter((t) => !pattern.some((p) => t.content.match(getRegExOrString(p))))\n } else if (typeof pattern === 'string') {\n const pattArr = pattern.split(',')\n return tasks.filter((t) => !pattArr.some((p) => t.content.match(getRegExOrString(p))))\n } else {\n return tasks.filter((t) => !t.content.match(pattern))\n }\n}\n\n/**\n * Take in a list of paragraphs and a sortList (not exactly paragraphs) and return an ordered list of paragraphs matching the sort list\n * This was necessary because for Synced Lines, we want the Synced Lines to match the ordering of the Time Block List but by the\n * Time we get through the sorting, we have custom Paragraphs, not paragraphs we can turn into synced lines. So we need to go back and\n * Find the source paragraphs\n * One challenge is that the sorted content has been cleaned (of dates, etc.)\n * @param {Array} paragraphs\n * @param {Array} sortList (FIXME: should provide a Flow type for this)\n * @returns {Array} paragraphs sorted in the order of sortlist\n */\nexport function getFullParagraphsCorrespondingToSortList(paragraphs: Array, sortList: Array): Array {\n if (sortList && paragraphs) {\n const sortedParagraphs =\n sortList\n .map((s) => {\n return paragraphs.find((p) => removeDateTagsAndToday(p.rawContent) === removeDateTagsAndToday(s.raw) && p.filename === s.filename)\n })\n // Filter out nulls\n ?.filter(Boolean) ?? []\n return sortedParagraphs\n }\n return []\n}\n\n/**\n * Get the timeblocks that have names/titles (e.g. a user set them up \"Work\" or \"Home\" or whatever)\n * @param {Array} blockList\n * @param {*} config\n * @returns {Array} the filtered blockList\n */\nexport function getNamedTimeBlocks(blockList: Array): Array {\n return blockList.filter((b) => b.title && b.title !== '')\n}\n\n/**\n * Processes tasks for a single named time block, updating tasks and no time for tasks accordingly.\n *\n * @param {TimeBlock} block - The current time block being processed.\n * @param {Array} unprocessedTasks - List of tasks that have not been processed yet.\n * @param {Array} timeMap - The current time map.\n * @param {Config} config - Configuration options for processing.\n * @returns {Object} - Returns an object containing the updated list of unprocessed tasks, results, and no time for tasks for this block.\n */\nexport function processTasksForNamedTimeBlock(\n block: OpenBlock,\n incomingUnprocessedTasks: Array,\n timeMap: Array,\n config: AutoTimeBlockingConfig,\n): Object {\n const results = []\n const noTimeForTasks = {}\n const blockTitle = (block.title || '').replace(config.timeblockTextMustContainString, '').replace(/ {2,}/g, ' ').trim()\n let unprocessedTasks = incomingUnprocessedTasks\n const tasksMatchingThisNamedTimeblock = unprocessedTasks.filter((task) => block.title && namedTagExistsInLine(blockTitle, task.content))\n tasksMatchingThisNamedTimeblock.forEach((task, i) => {\n const filteredTimeMap = timeMap.filter((t) => typeof t.busy === 'string' && t.busy.includes(blockTitle) && t.busy.includes(config.timeblockTextMustContainString))\n const newTimeBlockWithMap = matchTasksToSlots([task], { blockList: [block], timeMap: filteredTimeMap }, config)\n unprocessedTasks = unprocessedTasks.filter((t) => t !== task)\n const foundTimeForTask = newTimeBlockWithMap.timeBlockTextList && newTimeBlockWithMap.timeBlockTextList.length > 0\n if (foundTimeForTask) {\n results.push(newTimeBlockWithMap)\n } else {\n if (!noTimeForTasks[blockTitle]) noTimeForTasks[blockTitle] = []\n noTimeForTasks[blockTitle].push(task)\n }\n })\n clof(unprocessedTasks, `processTasksForNamedTimeBlock newUnprocessedTasks after looking for block \"${blockTitle}\"`, null, true)\n return { unprocessedTasks, results, noTimeForTasks }\n}\n\n/**\n * Handles the rest of the non-named-block/unprocessed tasks according to the specified orphanTaggedTasks strategy in the config.\n *\n * @param {Array} unprocessedTasks - List of tasks that remain unprocessed.\n * @param { [key: string]: Array } noTimeForTasks - Object containing tasks for which no time could be found, keyed by block title.\n * @param {AutoTimeBlockingConfig} config - Configuration options for processing.\n * @param {Array} newBlockList - The list of new blocks after processing.\n * @param {Array} timeMap - The current time map.\n * @returns {Object} - Returns the final result of matching tasks to slots, including unprocessed tasks handled as per config.\n */\nexport function handleUnprocessedTasks(\n unprocessedTasks: Array,\n noTimeForTasks: { [key: string]: Array },\n config: AutoTimeBlockingConfig,\n newBlockList: Array,\n timeMap: Array,\n): TimeBlocksWithMap {\n let finalUnprocessedTasks = unprocessedTasks || []\n const noTimeTasks = Object.values(noTimeForTasks)?.flat() || []\n clof(noTimeTasks, `handleUnprocessedTasks noTimeTasks=`, ['content', 'duration'], true)\n\n switch (config.orphanTagggedTasks) {\n case 'IGNORE_THEM':\n // If ignoring, do nothing further with noTimeTasks\n break\n case \"OUTPUT_FOR_INFO (but don't schedule them)\":\n // If outputting for info, log or store these tasks separately (not shown here)\n break\n case 'SCHEDULE_ELSEWHERE_LAST':\n finalUnprocessedTasks = [...finalUnprocessedTasks, ...noTimeTasks]\n break\n case 'SCHEDULE_ELSEWHERE_FIRST':\n finalUnprocessedTasks = [...noTimeTasks, ...finalUnprocessedTasks]\n break\n }\n\n config.mode = 'PRIORITY_FIRST'\n clof(finalUnprocessedTasks, `handleUnprocessedTasks finalUnprocessedTasks=`, 'content', true)\n\n return matchTasksToSlots(finalUnprocessedTasks, { blockList: newBlockList, timeMap }, config)\n}\n\n/**\n * Processes tasks by matching them to named time blocks based on tags.\n *\n * @param {Array} sortedTaskList - The list of tasks sorted by some criteria.\n * @param {Array} blockList - The current list of time blocks.\n * @param {Array} timeMap - The current time map.\n * @param {Config} config - Configuration options for processing.\n * @returns {Object} - Returns an object containing the updated block list, unprocessed tasks, results, and no time for tasks.\n */\nexport function processTasksByTimeBlockTag(sortedTaskList: Array, blockList: Array, timeMap: Array, config: AutoTimeBlockingConfig): Object {\n let newBlockList = [...(blockList || [])]\n let results = []\n let timeBlockTextList: any = []\n const noTimeForTasks = {}\n\n // MOVE THIS TO ITS OWN FUNCTION\n // Split tasks into matched and unmatched based on tags\n clo(config.timeframes, `processTasksByTimeBlockTag config.timeframes=`)\n clo(blockList, `processTasksByTimeBlockTag blockList=`)\n const { matched, unmatched } = splitItemsByTags(sortedTaskList, config.timeframes || {})\n let unprocessedTasks = unmatched || [] // tasks that do not match a timeframe will flow through to the next processing step\n clof(matched, `processTasksByTimeBlockTag matched=`, null, true)\n clof(unmatched, `processTasksByTimeBlockTag unmatched=`, ['content'], true)\n const keys = Object.keys(matched)\n if (keys.length) {\n logDebug(`\"STARTING TIMEFRAME PROCESSING\": ${keys.length} timeframes matched in tasks`)\n let newTimeMapWithBlocks = { timeBlockTextList: [], timeMap: [], blockList: [] }\n // process tasks by timeframe key\n keys.forEach((key) => {\n const tasksMatchingThisTimeframe = matched[key]\n const [start, end] = config.timeframes[key]\n let timeMapCopy = deepCopy(timeMap) // timeMap.slice()\n // process one task in the timeframe at a time\n const sortedTasksMatchingTimeframe = sortListBy(tasksMatchingThisTimeframe, ['-priority', '-duration'])\n sortedTasksMatchingTimeframe.forEach((task) => {\n logDebug(`processTasksByTimeBlockTag TIMEFRAME:\"${key}\": start=${start} end=${end}`)\n // blank out all slots that are not in the timeframe in question\n timeMapCopy.forEach((t, i) => {\n if (t.start < start || t.start >= end) {\n timeMapCopy[i].busy = true // remove times from consideration that are not in the timeframe in question\n }\n })\n // filter the map to only open slots and then find open timeblocks\n const openTimesForTimeframe = filterTimeMapToOpenSlots(timeMapCopy, config)\n const blocksForTimeframe = findTimeBlocks(openTimesForTimeframe, config)\n clof(blocksForTimeframe, `processTasksByTimeBlockTag blocksForTimeframe ${key} =`, ['start', 'minsAvailable'], true)\n newTimeMapWithBlocks = matchTasksToSlots([task], { blockList: blocksForTimeframe, timeMap: openTimesForTimeframe }, config)\n results.push(newTimeMapWithBlocks)\n\n const { timeMap: timeMapAfterTimeframePlacement, noTimeForTasks: nTftAfterTimeframePlacement, timeBlockTextList: timeBlockTextListAfterPlacement } = newTimeMapWithBlocks\n timeMapCopy = timeMapAfterTimeframePlacement\n // update the master timeMap with the changes that were made\n // timemap slots that were used will be missing in the result, so we will just mark them as busy in the master timeMap\n // function: updateMasterTimeMapWithTimeMapChanges\n openTimesForTimeframe.forEach((t, i) => {\n if (!timeMapAfterTimeframePlacement.find((nt) => nt.start === t.start)) {\n ;(timeMap.find((tm) => tm.start === t.start) ?? {}).busy = true\n }\n })\n // save no time for tasks\n if (nTftAfterTimeframePlacement) {\n Object.keys(nTftAfterTimeframePlacement).forEach((key) => {\n if (!noTimeForTasks[key]) noTimeForTasks[key] = []\n noTimeForTasks[key] = noTimeForTasks[key].concat(nTftAfterTimeframePlacement[key])\n })\n }\n // save timeblocktextlist\n if (timeBlockTextListAfterPlacement.length) {\n timeBlockTextList = timeBlockTextList.concat(timeBlockTextListAfterPlacement)\n }\n //FIXME: I am here -- need to fix the circular dependency oy vey\n })\n })\n }\n clof(timeBlockTextList, `processTasksByTimeBlockTag timeBlockTextList=`, null, false)\n clof(noTimeForTasks, `processTasksByTimeBlockTag noTimeForTasks=`, ['_', 'content'], true)\n // end split\n\n logDebug(`\"STARTING BY TIMEBLOCK TAG PROCESSING\": ${unprocessedTasks.length} unprocessedTasks`)\n clof(unprocessedTasks, `processTasksByTimeBlockTag unprocessedTasks=`, ['content'], true)\n const filteredMap = filterTimeMapToOpenSlots(timeMap, config)\n newBlockList = findTimeBlocks(filteredMap, config)\n const namedBlocks = getNamedTimeBlocks(newBlockList ?? [])\n namedBlocks.forEach((block) => {\n const blockName = block.title || ''\n logDebug(`PROCESSING BLOCK: \"${blockName}\" (tasks will be limited to this tag): ${unprocessedTasks.length} unprocessedTasks`)\n const {\n unprocessedTasks: updatedUnprocessedTasks,\n results: blockResults,\n noTimeForTasks: blockNoTimeForTasks,\n } = processTasksForNamedTimeBlock(block, unprocessedTasks, timeMap, config)\n clof(updatedUnprocessedTasks, `processTasksByTimeBlockTag updatedUnprocessedTasks after looking for block \"${blockName}\"`, null, true)\n unprocessedTasks = updatedUnprocessedTasks\n results = results.concat(blockResults)\n Object.keys(blockNoTimeForTasks).forEach((key) => {\n if (!noTimeForTasks[key]) noTimeForTasks[key] = []\n noTimeForTasks[key] = noTimeForTasks[key].concat(blockNoTimeForTasks[key])\n })\n\n newBlockList = newBlockList.filter((b) => b !== block)\n })\n\n return { newBlockList, unprocessedTasks, results, noTimeForTasks }\n}\n\n/**\n * Processes the tasks that have a named tag in them (e.g., @work or #work)\n * and schedules them within the specified time blocks.\n *\n * @param {Array} sortedTaskList - The list of tasks sorted by some criteria.\n * @param {TimeBlockWithMap} tmb - The current time block with map.\n * @param {Config} config - Configuration options for processing.\n * @returns {TimeBlockWithMap} - The updated time block with map after processing.\n */\nexport function processByTimeBlockTag(sortedTaskList: Array, tmb: TimeBlocksWithMap, config: AutoTimeBlockingConfig): TimeBlocksWithMap {\n // Destructure the initial time block with map structure\n const { blockList, timeMap } = tmb\n\n // Process tasks by matching them to named time blocks based on tags\n const { newBlockList, unprocessedTasks, results, noTimeForTasks } = processTasksByTimeBlockTag(sortedTaskList, blockList || [], timeMap, config)\n\n // Handle the unprocessed tasks according to the specified orphanTaggedTasks strategy\n const unprocessedTasksResult = handleUnprocessedTasks(unprocessedTasks, noTimeForTasks, config, newBlockList, timeMap)\n\n // Combine results from named blocks processing and final processing\n const combinedResults = [...results, unprocessedTasksResult]\n const combinedNoTimeForTasks = { ...noTimeForTasks, ...unprocessedTasksResult.noTimeForTasks }\n\n // Prepare the final return structure\n return {\n noTimeForTasks: combinedNoTimeForTasks,\n timeMap,\n blockList: newBlockList,\n timeBlockTextList: combinedResults.reduce((acc, currentValue) => acc.concat(currentValue.timeBlockTextList), []).sort(),\n }\n}\n" }, { "path": "dwertheimer.EventAutomations/src/timeblocking-shared.js", "content": "// @flow\n\nimport pluginJson from '../plugin.json'\nimport type { SortableParagraphSubset } from '../../helpers/sorting'\nimport type { AutoTimeBlockingConfig } from './config'\nimport { appendLinkIfNecessary, removeDateTagsFromArray, includeTasksWithPatterns, excludeTasksWithPatterns } from './timeblocking-helpers'\nimport { validateAutoTimeBlockingConfig, getTimeBlockingDefaults } from './config'\nimport { sortListBy } from '@helpers/sorting'\nimport { JSP, clo, log, logError, logWarn, logDebug, clof } from '@helpers/dev'\nimport { getTodaysReferences, findOpenTodosInNote } from '@helpers/NPnote'\nimport { showMessage } from '@helpers/userInput'\nimport { isTimeBlockLine } from '@helpers/timeblocks'\nimport { eliminateDuplicateParagraphs } from '@helpers/syncedCopies'\nimport { getSyncedCopiesAsList } from '@helpers/NPSyncedCopies'\nimport { insertContentUnderHeading } from '@helpers/NPParagraph'\n\nexport const shouldRunCheckedItemChecksOriginal = (config: AutoTimeBlockingConfig): boolean => config.checkedItemChecksOriginal && ['+'].indexOf(config.todoChar) > -1\n\n/**\n * Deletes paragraphs containing a specific string from the given note and returns the strings without the leading time signature\n *\n * @param {CoreNoteFields} destNote - the note to delete paragraphs from\n * @param {string} timeBlockTag - the string to search for in the paragraphs\n * @return {Array} - the contents of the deleted paragraphs without the AutoTimeBlocking tag\n */\nexport function deleteParagraphsContainingString(destNote: CoreNoteFields, timeBlockTag: string): Array {\n const destNoteParas = destNote.paragraphs\n const parasToDelete = []\n for (let i = 0; i < destNoteParas.length; i++) {\n const p = destNoteParas[i]\n if (new RegExp(timeBlockTag, 'gm').test(p.content)) {\n parasToDelete.push(p)\n }\n }\n if (parasToDelete.length > 0) {\n const deleteListByIndex = sortListBy(parasToDelete, ['lineIndex']) //NP API may give wrong results if lineIndexes are not in ASC order\n destNote.removeParagraphs(deleteListByIndex)\n }\n return parasToDelete.map((p) => p.content.replace(timeBlockTag, '').replace(/^\\d{2}:\\d{2}-\\d{2}:\\d{2} /g, ''))\n}\n\n/**\n * Creates synced copies of the provided todo items according to the configuration.\n * This is a helper function used within insertAndFinalizeTimeBlocks.\n *\n * @param {Array} todos - The list of todo items to create synced copies for.\n * @param {AutoTimeBlockingConfig} config - The configuration object for auto time blocking.\n * @returns {Promise}\n */\nexport async function createSyncedCopies(todos: Array, config: AutoTimeBlockingConfig): Promise {\n // Assuming `writeSyncedCopies` is a utility function that handles the creation of synced copies.\n await writeSyncedCopies(todos, { runSilently: true, ...config })\n}\n\n/**\n * Fetches and prepares the todo items for today. It filters out completed items,\n * appends necessary links based on the configuration, and removes date tags from\n * todo items.\n *\n * @param {AutoTimeBlockingConfig} config - The configuratifetchon object for auto time blocking.\n * @param {Array} completedItems - List of paragraphs/items that have been completed.\n * @param {Object} pluginJson - Plugin metadata for logging purposes.\n * @returns {Promise>} - The prepared list of todo items for today.\n */\nexport async function gatherAndPrepareTodos(config: AutoTimeBlockingConfig, completedItems: Array): Promise<$ReadOnlyArray> {\n deleteParagraphsContainingString(Editor, config.timeBlockTag)\n\n // Fetch todo items for today\n const todosParagraphs = await getTodaysFilteredTodos(config)\n .filter((todo) => todo.type === 'open')\n .filter((todo) => todo.filename !== Editor.filename || (todo.filename === Editor.filename && !completedItems.find((c) => c.lineIndex === todo.lineIndex)))\n\n logDebug(pluginJson, `Back from getTodaysFilteredTodos, ${todosParagraphs.length} potential items`)\n\n // Append links if necessary\n const todosWithLinksMaybe = appendLinkIfNecessary(todosParagraphs, config)\n logDebug(pluginJson, `After appendLinkIfNecessary, ${todosWithLinksMaybe.length} potential items`)\n\n // Remove date tags from todo items\n const cleanTodayTodoParas = removeDateTagsFromArray(todosWithLinksMaybe)\n logDebug(pluginJson, `After removeDateTagsFromArray, ${cleanTodayTodoParas.length} potential items`)\n\n return cleanTodayTodoParas\n}\n\n/**\n * Get the config for this plugin, from DataStore.settings or the defaults if settings are not valid\n * Note: augments settings with current DataStore.preference('timeblockTextMustContainString') setting\n * @returns {} config object\n */\nexport function getConfig(): AutoTimeBlockingConfig {\n const config = DataStore.settings || {}\n const numKeys = Object.keys(config).length\n if (numKeys && !(numKeys === 1 && config._logLevel)) {\n try {\n // $FlowIgnore\n // In real NotePlan, config.timeblockTextMustContainString won't be set, but in testing it will be, so this covers both test and prod\n if (!config.timeblockTextMustContainString) config.timeblockTextMustContainString = DataStore.preference('timeblockTextMustContainString') || ''\n validateAutoTimeBlockingConfig(config)\n return config\n } catch (error) {\n showMessage(`Plugin Settings ${error.message}\\nRunning with default settings. You should probably open the plugin configuration dialog and fix the problem(s) listed above.`)\n logDebug(pluginJson, `Plugin Settings ${error.message} Running with default settings`)\n }\n } else {\n logDebug(pluginJson, `config was empty. will use defaults`)\n }\n const defaultConfig = getTimeBlockingDefaults()\n return defaultConfig\n}\n\n/**\n * Find all (unduplicated) todos:\n * - todo items from references list (aka \"backlinks\")\n * + items in the current note marked >today or with today's >date\n * + open todos in the note (if that setting is on)\n * + ...which include the include pattern (if specified in the config)\n * - ...which do not include items the exclude pattern (if specified in the config)\n * - items in the current note that are synced tasks to elsewhere (will be in references also)\n *\n * @param {*} config\n * @param {Boolean} isSyncedCopyRun - true if we are just trying to get synced copies output (makes a difference in MANUAL_ORDERING mode)\n * @returns\n */\nexport function getTodaysFilteredTodos(config: AutoTimeBlockingConfig, isSyncedCopyRun = false): Array {\n const { includeTasksWithText, excludeTasksWithText, includeAllTodos, timeBlockTag } = config\n // filter down to just the open todos\n const backlinkParas = getTodaysReferences(Editor.note).filter((p) => p.type === 'open')\n logDebug(pluginJson, `Found ${backlinkParas.length} backlink paras`)\n clof(backlinkParas, `getTodaysFilteredTodos backlinkParas filtered to open`, ['filename', 'type', 'content'], true)\n let todosInNote = Editor.note ? findOpenTodosInNote(Editor.note, includeAllTodos).filter((p) => p.type === 'open') : []\n if (todosInNote.length > 0) {\n logDebug(pluginJson, ` getTodaysFilteredTodos: todosInNote Found ${todosInNote.length} items in today's note. Adding them to the possibilities.`)\n clof(todosInNote, `getTodaysFilteredTodos todosInNote filtered to open`, ['filename', 'type', 'content'], true)\n // we want to eliminate linked lines (for synced lines on the page)\n // because these should be in the references from other pages\n // but it's possible that this is a normal task in the note that is not in references, so for now, commenting this filter out\n // because it should get deduped later in this function\n const todayTasksWithSyncedLines = todosInNote.filter((todo) => /\\^[a-zA-Z0-9]{6}/.test(todo.content))\n logDebug(\n pluginJson,\n ` getTodaysFilteredTodos: todosInNote had ${todayTasksWithSyncedLines.length} synced line items in today's note. If they are dupes in references, they should get deduped in the following steps.`,\n )\n todosInNote = todosInNote.filter((todo) => !isTimeBlockLine(todo.content)) // if a user is using the todo character for timeblocks, eliminate those lines\n todosInNote = todosInNote.filter((todo) => !new RegExp(timeBlockTag).test(todo.content)) // just to be extra safe, make sure we're not adding our own timeblocks\n }\n const backLinksAndNoteTodos = config.mode === 'MANUAL_ORDERING' && !isSyncedCopyRun ? todosInNote : [...backlinkParas, ...todosInNote]\n\n logDebug(pluginJson, `Found ${backLinksAndNoteTodos.length} backlinks+today-note items (may include completed items)`)\n const undupedBackLinkParas = eliminateDuplicateParagraphs(backLinksAndNoteTodos, 'first', true)\n logDebug(pluginJson, `Found ${undupedBackLinkParas.length} undupedBackLinkParas after duplicate elimination`)\n // let todosParagraphs: Array = makeAllItemsTodos(undupedBackLinkParas) //some items may not be todos but we want to pretend they are and timeblock for them\n // logDebug(pluginJson, `After makeAllItemsTodos, ${todosParagraphs.length} potential items`)\n let todosParagraphs =\n Array.isArray(includeTasksWithText) && includeTasksWithText?.length > 0 ? includeTasksWithPatterns(undupedBackLinkParas, includeTasksWithText) : undupedBackLinkParas\n logDebug(pluginJson, `After includeTasksWithPatterns (${(includeTasksWithText ?? []).join(', ')}), ${todosParagraphs.length} potential items`)\n todosParagraphs = Array.isArray(excludeTasksWithText) && excludeTasksWithText?.length > 0 ? excludeTasksWithPatterns(todosParagraphs, excludeTasksWithText) : todosParagraphs\n logDebug(pluginJson, `After excludeTasksWithPatterns (${(excludeTasksWithText ?? []).join(', ')}), ${todosParagraphs.length} potential items`)\n clof(todosParagraphs, `getTodaysFilteredTodos todosParagraphs`, ['filename', 'type', 'content'], true)\n return todosParagraphs.filter((t) => t.content)\n}\n\n/**\n * Write synced copies of passed paragraphs to the Editor\n * Assumes any deletions were done already\n * @param {Array} todosParagraphs - the paragraphs to write\n * @return {Promise, config: AutoTimeBlockingConfig): Promise {\n if (!todosParagraphs.length && !config.runSilently) {\n await showMessage(`No todos/references marked for this day!`, 'OK', 'Write Synced Copies')\n } else {\n clof(todosParagraphs, `writeSyncedCopies: todosParagraphs`, 'content', true)\n const syncedList = getSyncedCopiesAsList(todosParagraphs)\n clo(syncedList, `writeSyncedCopies: syncedList`)\n logDebug(pluginJson, `Deleting previous synced list heading and content`)\n if (!String(config.syncedCopiesTitle)?.length) {\n await showMessage(`You need to set a synced copies title in the plugin settings`)\n return\n }\n logDebug(pluginJson, `Inserting synced list content: ${syncedList.length} items`)\n // $FlowIgnore\n await insertItemsIntoNote(Editor, syncedList, config.syncedCopiesTitle, config.foldSyncedCopiesHeading, config)\n }\n}\n\nexport async function insertItemsIntoNote(\n note: CoreNoteFields,\n list: Array | null = [],\n heading: string = '',\n shouldFold: boolean = false,\n config: AutoTimeBlockingConfig = getConfig(),\n) {\n if (list && list.length > 0 && note) {\n // $FlowIgnore\n logDebug(pluginJson, `insertItemsIntoNote: items.length=${list.length}`)\n clo(list, `insertItemsIntoNote: list`)\n clof(list, `insertItemsIntoNote: list`, null, false)\n // Note: could probably use API addParagraphBelowHeadingTitle to insert\n insertContentUnderHeading(note, heading, list.join('\\n'))\n // Fold the heading to hide the list\n if (shouldFold && heading !== '') {\n const thePara = note.paragraphs.find((p) => p.type === 'title' && p.content.includes(heading))\n if (thePara) {\n logDebug(pluginJson, `insertItemsIntoNote: folding \"${heading}\" - isFolded=${String(Editor.isFolded(thePara))}`)\n // $FlowIgnore[method-unbinding] - the function is not being removed from the Editor object.\n if (Editor.isFolded) {\n // make sure this command exists\n if (!Editor.isFolded(thePara)) {\n Editor.toggleFolding(thePara)\n logDebug(pluginJson, `insertItemsIntoNote: folded heading \"${heading}\"`)\n }\n } else {\n thePara.content = `${String(heading)} …` // this was the old hack for folding\n await note.updateParagraph(thePara)\n note.content = note.content ?? ''\n }\n } else {\n logDebug(pluginJson, `insertItemsIntoNote could not find heading: ${heading}`)\n }\n }\n } else {\n if (config && !config.passBackResults) {\n // await showMessage('No items to insert or work hours left. Check config/presets. Also look for calendar events which may have blocked off the rest of the day.')\n }\n }\n}\n" }, { "path": "dwertheimer.EventAutomations/src/triggers.js", "content": "// @flow\n\nimport pluginJson from '../plugin.json'\nimport { shouldRunCheckedItemChecksOriginal, getConfig, getTodaysFilteredTodos } from './timeblocking-shared'\nimport { cleanTimeBlockLine } from './timeblocking-helpers'\nimport { createTimeBlocksForTodaysTasks } from './NPTimeblocking'\nimport { isTriggerLoop } from '@helpers/NPFrontMatter'\nimport { log, logError, logDebug, timer, clo, clof, JSP } from '@helpers/dev'\nimport { getBlockUnderHeading } from '@helpers/NPParagraph'\n\n/**\n * onEditorWillSave - look for timeblocks that were marked done and remove them\n * Plugin entrypoint for command: \"/onEditorWillSave\" (trigger)\n * @author @dwertheimer\n * @param {*} incoming\n */\nexport async function onEditorWillSave(incoming: string | null = null) {\n try {\n if (Editor?.note && isTriggerLoop(Editor.note)) return\n const completedTypes = ['done', 'scheduled', 'cancelled', 'checklistDone', 'checklistScheduled', 'checklistCancelled']\n logDebug(pluginJson, `onEditorWillSave running with incoming:${String(incoming)}`)\n const config = await getConfig()\n const { timeBlockHeading } = config\n // check for today note? -- if (!editorIsOpenToToday())\n if (shouldRunCheckedItemChecksOriginal(config)) {\n // get character block\n const updatedParasInTodayNote = []\n const timeBlocks = getBlockUnderHeading(Editor, timeBlockHeading, false)\n if (timeBlocks?.length) {\n // only try to mark items that are completed and were created by this plugin\n const checkedItems = timeBlocks.filter((f) => completedTypes.indexOf(f.type) > -1 && f.content.indexOf(config.timeBlockTag) > -1)\n if (checkedItems?.length) {\n clo(checkedItems, `onEditorWillSave found:${checkedItems?.length} checked items`)\n const todayTodos = getTodaysFilteredTodos(config)\n // clo(todayTodos, `onEditorWillSave ${todayTodos?.length} todayTodos`)\n checkedItems.forEach((item, i) => {\n const referenceID = item.content.match(/noteplan:\\/\\/.*(\\%5E.*)\\)/)?.[1].replace('%5E', '^') || null\n logDebug(pluginJson, `onEditorWillSave: item[${i}] content=\"${item.content}\" blockID=\"${referenceID}\"`)\n const todo = todayTodos.find((f) =>\n referenceID ? f.blockId === referenceID : cleanTimeBlockLine(item.content, config).trim() === cleanTimeBlockLine(f.content, config).trim(),\n )\n if (todo) {\n clo(todo, `onEditorWillSave: found todo for item[${i}] blockID=\"${referenceID}\" content=${todo.content} in file ${todo.filename || ''} | now updating`)\n const isEditor = Editor.filename === todo.filename\n const note = isEditor ? Editor : todo.note\n todo.type = 'done'\n note?.updateParagraph(todo)\n logDebug(pluginJson, `onEditorWillSave: found todo for item[${i}] blockID=\"${referenceID}\" content=${todo.content} in file ${todo.filename || ''} | now updating`)\n if (!isEditor) {\n DataStore.updateCache(note)\n } else {\n logDebug(pluginJson, `onEditorWillSave: checked off item: \"${item.content}\" but manual refresh of TimeBlocks will be required`)\n updatedParasInTodayNote.push(Editor.paragraphs[todo.lineIndex])\n }\n } else {\n logDebug(pluginJson, `onEditorWillSave: no todo found for item[${i}] blockID=\"${referenceID}\" cleanContent=\"${cleanTimeBlockLine(item.content, config)}\"`)\n }\n })\n // re-run /atb - but is it safe within a hook?\n await createTimeBlocksForTodaysTasks(config, updatedParasInTodayNote)\n } else {\n logDebug(pluginJson, `onEditorWillSave: no checked items found; nothing to do; exiting gracefully.`)\n }\n }\n }\n } catch (error) {\n logError(pluginJson, JSP(error))\n }\n}\n" }, { "path": "dwertheimer.Favorites/CHANGELOG.md", "content": "# Favorites Plugin Changelog\n\n## [1.3.6] - 2026-04-13 @dwertheimer\n\n- **PluginRequestEnvelope**: Favorites browser `requestFromPlugin` resolves with `@helpers/react/pluginRequestEnvelope` (`unwrapPluginRequestData` / explicit `success` + `data` + `message`). **Release together with np.Shared 1.0.7+** (or matching Root bundle).\n\n## [1.3.5] - 2026-01-20 @dwertheimer\n\n- Fixed sidebar icon colour issue by using proper css variables for colors.\n\n## [1.3.4] - 2026-01-18 @dwertheimer \n\n- Fixed dark mode issues with favorites browser window by using proper css variables for colors.\n\n## [1.3.3 - waiting for np 3.20.1 release (change showReloadButton to true)] - 2026-01-11 @dwertheimer\n\n- Added reload button to favorites browser window to allow for easy reloading of the window when changes are made to the plugin or the underlying note data.\n\n## [1.3.2] - 2026-01-11 @dwertheimer\n\n### Fixed\n- Fixed bug where removing a favorite note would remove the star from the title but not remove the frontmatter field. Now properly passes `deleteMissingAttributes: true` to `updateFrontMatterVars()` to ensure the frontmatter key is actually deleted. Thanks @stacey for the detailed bug report!\n\n\n## [1.3.1] - 2026-01-11 @dwertheimer\n\n### Fixed\n- **CRITICAL**: Fixed request timeout issue by removing outdated local copy of `routerUtils.js` and switching to shared version from `@helpers/react/routerUtils`\n- The local copy was missing the `pluginJson` parameter required by the shared router, which could cause silent failures when sending responses back to React\n- Router now properly passes `pluginJson` parameter to `newCommsRouter` for correct logging and response handling\n\n## [1.3.0] - 2025-01-10 @dwertheimer\n\n- Feature: Add new `/favorites-browser` command to open a sidebar window to view and open favorite notes and commands. This provides a persistent browser interface for managing and accessing your favorites.\n\n## [1.2.10] - 2025-04-10 @dwertheimer\n\n- Bugfix: Fix issue with frontmatter not being visible immediately after setting a favorite\n\n## [1.2.9] - 2025-02-20 @dwertheimer\n\n- Bugfix: Fix Stacey issue with writing title above frontmatter when only one field and no title\n- Bugfix: Fix issue with duplicate notes in favorites list\n\n## [1.2.7] - 2025-02-19 @dwertheimer\n\n- Bugfix: quoteText() now handles null, boolean, number and undefined values correctly\n\n## [1.2.6] - 2025-02-19 @dwertheimer\n\n- Add \"Favorite Key\" setting to allow for customizing the frontmatter key used to identify favorites.\n\n## [1.2.5] - 2025-02-15 @dwertheimer\n\n- Favorites now works with frontmatter\n\n## [1.2.4] - 2024-06-12 @dwertheimer\n\n- bump version for rerelease (plugin was missing from github)\n\n## [1.2.3] - 2023-09-29 @dwertheimer\n\n- change the default to not add a space in front of the default tag\n\n## [1.2.2] - 2023-08 @dwertheimer\n\n- Bugfix: allow for escaping and leaving command intact.\n\n## [1.2.1] - 2023-08 @dwertheimer\n\n- Add \"rename\" capability\n\n## [1.2.0] - 2023-08-27 @dwertheimer\n\n- Add prepended characters for favorite saved commands & xcallback creator inline. Thx for the idea @clayrussell\n\n## [1.1.3] - 2023-08 @dwertheimer\n\n- Add remember-presets-after-update code\n\n## [1.1.0] - 2023-08-25 @dwertheimer\n\n- Add capability to set a preset to run a favorite URL/X-Callback\n\n## [1.0.1] - 2021-11-30 (@dwertheimer)\n\n- Minor tweak to the plugin.json to be more descriptive in Description\n\n## [1.0.0] - 2021-11-16 (@dwertheimer)\n\n- Initial plugin functions: `/fave`, `/unfave`, `/faves`\n" }, { "path": "dwertheimer.Favorites/DEBUGGING_REQUEST_TIMEOUTS.md", "content": "# Debugging Request/Response Timeout Issues\n\nThis guide explains how to debug timeout errors in the REQUEST/RESPONSE pattern used between React components and NotePlan plugins.\n\n## Error Symptoms\n\n```\n[WebView Log] DEBUG | Component, requestFromPlugin TIMEOUT: command=\"getXXX\", correlationId=\"req-...\"\n[WebView Error] ERROR | Component, requestFromPlugin REJECTED: command=\"getXXX\", error=\"Request timeout: getXXX\"\n[WebView Error] ERROR | Component, Error loading data: Request timeout: getXXX\n```\n\n## Common Causes\n\n### 1. Outdated Local routerUtils.js (MOST COMMON)\n\n**Problem**: Plugin has a local copy of `routerUtils.js` that's out of sync with the shared version in `@helpers/react/routerUtils`.\n\n**Symptoms**:\n- Works for some users but not others\n- No error logs on plugin side\n- Silent failures in response sending\n\n**Fix**:\n```bash\n# Delete local copy\nrm src/routerUtils.js\n\n# Update imports to use shared version\n# In your router file (e.g., favoritesRouter.js):\nimport { newCommsRouter, type RequestResponse } from '@helpers/react/routerUtils'\nimport pluginJson from '../plugin.json'\n\nexport const onYourRouter = newCommsRouter({\n routerName: 'YourRouter',\n defaultWindowId: YOUR_WINDOW_ID,\n routeRequest: routeYourRequest,\n handleNonRequestAction: handleYourNonRequestAction,\n pluginJson: pluginJson, // REQUIRED!\n useSharedHandlersFallback: false,\n})\n```\n\n**Prevention**:\n- ✅ Always use `@helpers/react/routerUtils` (shared version)\n- ❌ Never copy routerUtils.js to your plugin\n- ✅ Always pass `pluginJson` parameter to `newCommsRouter`\n\n### 2. Handler Function Crashes\n\n**Problem**: The handler throws an exception that's not caught properly.\n\n**Symptoms**:\n- Error logs on plugin side\n- No RESPONSE sent back to React\n- Timeout after 10 seconds\n\n**Debug**:\n```javascript\n// In your handler (requestHandlers.js):\nexport async function handleGetData(requestData: Object): Promise {\n const startTime = Date.now()\n try {\n logDebug(pluginJson, `handleGetData: ENTRY`)\n \n // Your code here\n const data = await someOperation()\n \n const elapsed = Date.now() - startTime\n logDebug(pluginJson, `handleGetData: SUCCESS in ${elapsed}ms`)\n return {\n success: true,\n data: data,\n }\n } catch (error) {\n const elapsed = Date.now() - startTime\n logError(pluginJson, `handleGetData: ERROR after ${elapsed}ms: ${error.message}`)\n return {\n success: false,\n message: error.message || 'Failed to get data',\n }\n }\n}\n```\n\n**Fix**:\n- Always use try/catch in handlers\n- Always return a RequestResponse object\n- Log timing to identify slow operations\n\n### 3. Wrong Window ID\n\n**Problem**: Response is sent to wrong window ID, so React never receives it.\n\n**Symptoms**:\n- Plugin logs show success\n- React times out\n- Multiple windows open\n\n**Debug**:\n```javascript\n// In your router:\nexport const onYourRouter = newCommsRouter({\n routerName: 'YourRouter',\n defaultWindowId: 'your-window-id', // Must match React window ID\n routeRequest: routeYourRequest,\n pluginJson: pluginJson,\n})\n\n// In React (check what windowId is being sent):\nconst requestFromPlugin = useCallback(\n (command: string, dataToSend: any = {}, timeout: number = 10000): Promise => {\n const correlationId = `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n logDebug('Component', `requestFromPlugin: command=\"${command}\", windowId=\"${windowIdRef.current}\"`)\n \n // ...\n },\n [dispatch],\n)\n```\n\n**Fix**:\n- Ensure `defaultWindowId` in router matches window ID used when opening window\n- Check `windowIdRef.current` in React component\n- Verify `data.__windowId` is set correctly in requests\n\n### 4. Router Not Registered in plugin.json\n\n**Problem**: Router function not exported or not registered as a command.\n\n**Symptoms**:\n- No logs on plugin side\n- Immediate or delayed timeout\n- \"Command not found\" errors\n\n**Debug**:\n```json\n// Check plugin.json has the router command:\n{\n \"plugin.commands\": [\n {\n \"name\": \"onYourRouter\",\n \"description\": \"React Window calling back to plugin\",\n \"jsFunction\": \"onYourRouter\",\n \"hidden\": true\n }\n ]\n}\n```\n\n```javascript\n// Check src/index.js exports the router:\nexport { onYourRouter } from './yourRouter.js'\n```\n\n**Fix**:\n- Ensure router is exported from index.js\n- Ensure router is registered in plugin.json\n- Verify `jsFunction` name matches export name\n\n### 5. Handler Takes Too Long (> 10 seconds)\n\n**Problem**: Operation genuinely takes longer than timeout.\n\n**Symptoms**:\n- Happens consistently for certain operations\n- Logs show handler is still running when timeout occurs\n- Large datasets or slow APIs\n\n**Fix**:\n```javascript\n// Option 1: Increase timeout for specific requests\nconst data = await requestFromPlugin('slowOperation', {}, 30000) // 30 second timeout\n\n// Option 2: Optimize the handler\nexport async function handleSlowOperation(requestData: Object): Promise {\n try {\n // Add early filtering/pagination\n const limit = requestData.limit || 100\n const notes = DataStore.projectNotes.slice(0, limit)\n \n // Process in chunks if needed\n // ...\n \n return { success: true, data: notes }\n } catch (error) {\n return { success: false, message: error.message }\n }\n}\n```\n\n### 6. React Component Unmounted Before Response\n\n**Problem**: React component unmounts while waiting for response.\n\n**Symptoms**:\n- Happens when rapidly switching views\n- No error logs\n- Memory leaks (pending requests not cleaned up)\n\n**Fix**:\n```javascript\n// In React component, ensure cleanup in useEffect:\nuseEffect(() => {\n const handleResponse = (event: MessageEvent) => {\n // Handle response\n }\n \n window.addEventListener('message', handleResponse)\n return () => {\n window.removeEventListener('message', handleResponse)\n // Clean up pending requests\n pendingRequestsRef.current.forEach((pending) => {\n clearTimeout(pending.timeoutId)\n })\n pendingRequestsRef.current.clear()\n }\n}, [])\n```\n\n## Debugging Checklist\n\nWhen a user reports timeout errors:\n\n1. ✅ Check if plugin has local `routerUtils.js` - delete it if found\n2. ✅ Verify router imports from `@helpers/react/routerUtils`\n3. ✅ Verify `pluginJson` parameter is passed to `newCommsRouter`\n4. ✅ Check router is exported from `src/index.js`\n5. ✅ Check router is registered in `plugin.json`\n6. ✅ Verify window IDs match (router default vs React windowId)\n7. ✅ Check handler has try/catch and returns RequestResponse\n8. ✅ Check handler case is listed in router's switch statement\n9. ✅ Add timing logs to handler to identify slow operations\n10. ✅ Test with fresh NotePlan restart (clear any cached state)\n\n## Testing Strategy\n\n### Local Testing\n```javascript\n// Add diagnostic command to plugin:\nexport async function testRequestHandlers(): Promise {\n const handlers = [\n { name: 'getFavoriteNotes', params: {} },\n { name: 'getFavoriteCommands', params: {} },\n // ... more handlers\n ]\n \n for (const { name, params } of handlers) {\n const startTime = Date.now()\n console.log(`Testing ${name}...`)\n try {\n const result = await handleRequest(name, params)\n const elapsed = Date.now() - startTime\n console.log(`✅ ${name}: success=${result.success}, elapsed=${elapsed}ms`)\n } catch (error) {\n const elapsed = Date.now() - startTime\n console.log(`❌ ${name}: error=\"${error.message}\", elapsed=${elapsed}ms`)\n }\n }\n}\n```\n\n### Production Debugging\n\nAdd comprehensive logging:\n```javascript\n// In router:\nexport const onYourRouter = newCommsRouter({\n routerName: 'YourRouter/DEBUG', // Add DEBUG suffix for extra visibility\n defaultWindowId: YOUR_WINDOW_ID,\n routeRequest: async (actionType: string, data: any): Promise => {\n logDebug(pluginJson, `[ROUTER] Received request: actionType=\"${actionType}\", correlationId=\"${data.__correlationId}\"`)\n const result = await routeYourRequest(actionType, data)\n logDebug(pluginJson, `[ROUTER] Sending response: success=${result.success}, correlationId=\"${data.__correlationId}\"`)\n return result\n },\n pluginJson: pluginJson,\n})\n```\n\n## Performance Monitoring\n\nTrack request timing:\n```javascript\n// In handler:\nexport async function handleGetData(requestData: Object): Promise {\n const perfMarks = {\n start: Date.now(),\n dataFetch: 0,\n processing: 0,\n complete: 0,\n }\n \n try {\n // Fetch data\n const data = await fetchData()\n perfMarks.dataFetch = Date.now()\n \n // Process data\n const processed = processData(data)\n perfMarks.processing = Date.now()\n \n perfMarks.complete = Date.now()\n \n logDebug(pluginJson, \n `handleGetData: PERF: ` +\n `fetch=${perfMarks.dataFetch - perfMarks.start}ms, ` +\n `process=${perfMarks.processing - perfMarks.dataFetch}ms, ` +\n `total=${perfMarks.complete - perfMarks.start}ms`\n )\n \n return { success: true, data: processed }\n } catch (error) {\n logError(pluginJson, `handleGetData: ERROR after ${Date.now() - perfMarks.start}ms: ${error.message}`)\n return { success: false, message: error.message }\n }\n}\n```\n\n## See Also\n\n- [ROUTER_AND_HANDLERS.md](../../dwertheimer.ReactSkeleton/ROUTER_AND_HANDLERS.md) - Router organization guide\n- [COMMUNICATION_STRATEGY.md](../../dwertheimer.Forms/COMMUNICATION_STRATEGY.md) - Request/response pattern details\n- `@helpers/react/routerUtils.js` - Shared router utilities (ALWAYS USE THIS)\n- `np.Shared/src/sharedRequestRouter.js` - Example router implementation\n" }, { "path": "dwertheimer.Favorites/IMPLEMENTATION_PLAN.md", "content": "# Favorites Browser Implementation Plan\n\n## Overview\nThis plan outlines the implementation of a React-based Favorites Browser for the dwertheimer.Favorites plugin, using reusable FilterableList and List components with NotePlan sidebar-style display.\n\n## Components to Create\n\n### 1. Reusable Components (in helpers/react/)\n\n#### 1.1 List Component (`helpers/react/List.jsx`)\n- **Purpose**: Core list rendering component that can work with different filter mechanisms\n- **Props**:\n - `items: Array` - Array of items to display\n - `displayType: 'noteplan-sidebar' | 'chips'` - Display style\n - `renderItem: (item: any, index: number) => React$Node` - Custom render function for each item\n - `onItemClick: (item: any, event: MouseEvent) => void` - Click handler\n - `selectedIndex: ?number` - Currently selected item index\n - `itemActions?: Array<{icon: string, onClick: (item: any, event: MouseEvent) => void, title?: string}>` - Actions to show on right side\n - `emptyMessage?: string` - Message when list is empty\n - `loading?: boolean` - Loading state\n- **Features**:\n - Two display styles:\n - `noteplan-sidebar`: Hierarchical folder/file style (like NotePlan sidebar)\n - `chips`: Card/chip style (like FormBrowser left side)\n - Support for action buttons on the right side of each item\n - Keyboard navigation support\n - Selected/active states\n\n#### 1.2 FilterableList Component (`helpers/react/FilterableList.jsx`)\n- **Purpose**: Wrapper component that adds filtering capability to List\n- **Props**:\n - All List props\n - `filterText: string` - Current filter text\n - `onFilterChange: (text: string) => void` - Filter change handler\n - `filterPlaceholder?: string` - Placeholder for filter input\n - `renderFilter?: () => React$Node` - Custom filter component (optional)\n- **Features**:\n - Text input for filtering\n - Filters items based on filterText\n - Can be replaced with custom filter mechanism\n\n#### 1.3 CSS Files\n- `helpers/react/List.css` - Styles for List component\n- `helpers/react/FilterableList.css` - Styles for FilterableList component\n\n### 2. Favorites Plugin React Components\n\n#### 2.1 FavoritesView Component (`dwertheimer.Favorites/src/components/FavoritesView.jsx`)\n- **Purpose**: Main React component for the Favorites Browser\n- **Features**:\n - Uses FilterableList with noteplan-sidebar display style\n - Toggle switch to switch between favorite notes and favorite commands\n - Displays list of favorites (notes or commands)\n - Handles click events (normal, opt-click, cmd-click)\n - Uses AppContext for communication with plugin\n\n#### 2.2 AppContext (`dwertheimer.Favorites/src/components/AppContext.jsx`)\n- **Purpose**: React Context for plugin communication (copy from Forms plugin)\n- **Features**:\n - `sendActionToPlugin` - Send actions to plugin\n - `sendToPlugin` - Send to plugin without saving scroll\n - `requestFromPlugin` - Request/response pattern\n - `dispatch` - Dispatch messages\n - `pluginData` - Data from plugin\n - `reactSettings` - Local React settings\n - `setReactSettings` - Update React settings\n\n#### 2.3 CSS Files\n- `dwertheimer.Favorites/src/components/FavoritesView.css` - Styles for FavoritesView\n\n### 3. Plugin Backend Files\n\n#### 3.1 Window Management (`dwertheimer.Favorites/src/windowManagement.js`)\n- **Purpose**: Handle opening React windows\n- **Functions**:\n - `openFavoritesBrowser()` - Opens the Favorites Browser window\n - `createWindowInitData()` - Creates initial data for React window\n - `getPluginData()` - Gathers data to pass to React window\n\n#### 3.2 Request Handlers (`dwertheimer.Favorites/src/requestHandlers.js`)\n- **Purpose**: Handle requests from React components\n- **Functions**:\n - `handleGetFavoriteNotes()` - Returns list of favorite notes\n - `handleGetFavoriteCommands()` - Returns list of favorite commands\n - `handleOpenNote()` - Opens a note (handles normal, opt-click, cmd-click)\n\n#### 3.3 Main Handler (`dwertheimer.Favorites/src/index.js`)\n- **Purpose**: Plugin entry point\n- **Functions**:\n - `openFavoritesBrowser()` - Command to open Favorites Browser\n - `onFavoritesBrowserAction()` - Handler for actions from React window\n\n### 4. Rollup Configuration\n\n#### 4.1 Rollup Entry File (`dwertheimer.Favorites/src/support/rollup.FavoritesView.entry.js`)\n- **Purpose**: Entry point for Rollup bundling\n- **Content**: Exports FavoritesView as WebView\n\n#### 4.2 Rollup Script (`dwertheimer.Favorites/src/support/performRollup.node.js`)\n- **Purpose**: Rollup build script (similar to Forms plugin)\n- **Features**:\n - Builds FavoritesView bundle\n - Development mode\n - Watch mode support\n\n### 5. Required Files Structure\n\n```\ndwertheimer.Favorites/\n├── src/\n│ ├── components/\n│ │ ├── FavoritesView.jsx\n│ │ ├── FavoritesView.css\n│ │ └── AppContext.jsx\n│ ├── support/\n│ │ ├── rollup.FavoritesView.entry.js\n│ │ └── performRollup.node.js\n│ ├── windowManagement.js\n│ ├── requestHandlers.js\n│ ├── favorites.js (existing)\n│ ├── NPFavorites.js (existing)\n│ ├── NPFavoritePresets.js (existing)\n│ └── index.js (existing - needs updates)\n├── requiredFiles/\n│ └── react.c.FavoritesView.bundle.dev.js (generated by rollup)\n└── plugin.json (existing - needs new command)\n\nhelpers/react/\n├── List.jsx (new)\n├── List.css (new)\n├── FilterableList.jsx (new)\n└── FilterableList.css (new)\n```\n\n## Implementation Details\n\n### 1. List Component Display Styles\n\n#### NotePlan Sidebar Style\n- Hierarchical display with folder/file icons\n- Indentation for nested items\n- Folder expansion/collapse (if needed)\n- Similar to NotePlan's sidebar appearance\n- Uses NotePlan theme variables\n\n#### Chips Style\n- Card/chip appearance\n- Rounded corners\n- Border and background\n- Similar to FormBrowser left side\n- Hover effects\n- Selected state highlighting\n\n### 2. Favorite Notes Display\n- Show note title\n- Show folder path (if applicable)\n- Show favorite icon (⭐️)\n- Use note decoration (icon, color) from `getNoteDecoration()`\n- Display in NotePlan sidebar style\n\n### 3. Favorite Commands Display\n- Show command name\n- Show command description (if available)\n- Display in NotePlan sidebar style\n- Icon for command type\n\n### 4. Click Handling\n- **Normal click**: `Editor.openNoteByFilename(filename, false, 0, 0, false)`\n- **Option-click (Alt)**: `Editor.openNoteByFilename(filename, false, 0, 0, true)` - split view\n- **Cmd-click (Meta)**: `Editor.openNoteByFilename(filename, true, 0, 0, false)` - floating window\n\n### 5. Toggle Switch\n- Located at top of FilterableList\n- Switches between \"Favorite Notes\" and \"Favorite Commands\"\n- Updates list when toggled\n- Persists selection in reactSettings\n\n### 6. Filtering\n- Text input at top of FilterableList\n- Filters items based on:\n - For notes: title, folder path\n - For commands: command name, description\n- Case-insensitive search\n- Updates as user types\n\n### 7. Request/Response Pattern\n- React components use `requestFromPlugin()` to request data\n- Plugin handlers respond with data\n- Uses correlation IDs for request matching\n- Timeout handling (default 10 seconds)\n\n### 8. Window Opening\n- Uses `DataStore.invokePluginCommandByName('showInMainWindow', 'np.Shared', [data, windowOptions])`\n- Opens in main window (not floating)\n- Uses NotePlan theme CSS\n- Includes FontAwesome icons\n\n## Data Flow\n\n1. User runs `/favorites-browser` command\n2. Plugin calls `openFavoritesBrowser()`\n3. `windowManagement.js` creates window data and calls `showInMainWindow`\n4. React window loads `FavoritesView` component\n5. `FavoritesView` requests favorite notes/commands via `requestFromPlugin`\n6. Plugin handlers return data\n7. `FavoritesView` displays data in FilterableList\n8. User clicks item → React sends action → Plugin opens note\n\n## Testing Checklist\n\n- [ ] List component renders correctly in both display styles\n- [ ] FilterableList filters items correctly\n- [ ] Toggle switch switches between notes and commands\n- [ ] Normal click opens note in Editor\n- [ ] Option-click opens note in split view\n- [ ] Cmd-click opens note in floating window\n- [ ] Filtering works for both notes and commands\n- [ ] Request/response pattern works correctly\n- [ ] Window opens in main window\n- [ ] NotePlan theme styling applied correctly\n- [ ] Keyboard navigation works\n- [ ] Action buttons work (if implemented)\n\n## Next Steps\n\n1. Create reusable List and FilterableList components\n2. Set up React framework in Favorites plugin\n3. Create FavoritesView component\n4. Implement window management\n5. Implement request handlers\n6. Add command to plugin.json\n7. Test and refine\n\n" }, { "path": "dwertheimer.Favorites/README.md", "content": "# Favorites Plugin\n\n## A temporary substitute for \"pinned notes\"\n\nSomewhere on the Noteplan roadmap is (hopefully) the concept of pinned notes (see [Canny](https://noteplan.canny.io/general-feature-request/p/favorite-notesfolders-and-pinning-notes-to-the-top-of-the-list)). In the meantime, I thought I would create a poor man's substitute -- inspired by @stacey's idea of having an evergreen \"Research This\" note, which I wanted to have easy access to.\n\n## Using the Favorites ⭐️ Plugin\n\n## Setting Favorite Documents for Easy Access\n\n1. At the beginning, no items are in the Favorites list.\n2. Open up any document in the Editor.\n3. Run the `/fave` plugin to set the current document as a \"Favorite\".\n - This can be done by adding a ⭐️ to the title or by setting a frontmatter field.\n - If using frontmatter, ensure the frontmatter key is set correctly in the plugin settings.\n4. Now run the `/faves` command and you will see your favorites.\n5. Choosing a favorite opens it in the Editor.\n6. Use the `/unfave` command to remove the ⭐️ or the frontmatter field (or you can do it by hand)!\n\n## Favorites Browser Sidebar\n\nThe plugin includes a Favorites Browser that provides a persistent sidebar window for viewing and managing your favorite notes and commands. This is especially useful for quick access to your most frequently used items.\n\n### Opening the Favorites Browser\n\n- Type `/favorites-browser` or `/fav-browser` in the Command Bar to open the Favorites Browser sidebar window\n- The browser opens as a sidebar window by default, providing a dedicated view of all your favorites\n- You can optionally open it as a floating window by passing `IsFloating: true` as an argument\n\n### Using the Favorites Browser\n\nOnce open, the Favorites Browser displays:\n- All your favorite notes (marked with ⭐️ or frontmatter)\n- All your favorite commands (X-Callbacks and URLs)\n- Quick access to open any favorite directly from the browser interface\n\nThe sidebar provides a convenient way to browse and access your favorites without needing to type commands, making it ideal for users who prefer a visual interface for navigation.\n\n### Preferences and Settings\n\n- **Favorite Identifier**: Choose how to identify favorites. Options include using a star in the title or a frontmatter field.\n- **Favorite Key**: If using frontmatter, this setting allows you to specify the key used to mark a note as a favorite. Default is 'favorite', but you can change it to any valid key name.\n- **Characters to Prepend to Command**: If there are characters like “-⭐️” in front of each command, it will keep them together and float them to the top of the menu. Whatever text you put here will be prepended to any command name you set. Blank this field out to not prepend any characters.\n\n## Setting Favorite Commands (X-Callbacks and URLs)\n\nYou can also set up to 20 commands that can be called directly from the Command Bar to launch an X-Callback or a URL. If there are X-Callback commands you use frequently and want to have quick access to, this is a good way to get access to them by just typing `/`.\n\nYou can use this functionality for quick access to:\n\n- Your favorite plugin commands with names you choose in a list of favorite commands you can glance at\n- Open a specific document\n- Open to a heading or line inside a document\n- Inserting a particular template you use frequently with one command at your fingertips\n- Opening some website/page you frequently use when you are inside noteplan\n\nFavorite commands functionality is best used with the Link Creator plugin, which can be used to create URLs to launch a variety of functions inside NotePlan.\n\nSet your favorite commands by typing:\n\n`/Set/Change/Rename Preset Action`\n\nThis will ask you for:\n\n- the name you want to call it (this is the name that will show up in the CommandBar when you type \"/\")\n- the URL or X-Callback that should be launched when someone selects the command (you will be asked whether you know the URL or you want the wizard to guide you through creating it)\n\nAfter that, the commands you create will be available as if they are any other plugin command, simply by typing `/foo` (for example).\n\n## Examples\n\n1. Create a command to insert a template (e.g. insert project metadata):\n\na) create a template, e.g.:\n\n```\n---\ntitle: Project Metadata Snippet\ntype: snippet \n---\n#project @start(<%- promptDate('startDate', 'Enter start date') %>) @due(<%- promptDate('dueDate', 'Enter due date - or enter') %>) @review(<%- promptDateInterval('question', 'Enter review interval') %>)\n\n```\n\nb) And then use this plugin to `/Set/Change/Rename Preset Action`:\n- Use Link Creator to create a link (Run a plugin command + `np:insert`)\n- Pass the title of the template as the first argument/parameter: \"Project Metadata Snippet\"\n\n***Then insertion of this project metadata will always be just a few keystrokes away.***\n\n2. Use it to create functionality in NotePlan that is missing for your workflow. For me, it's creating a new note in a folder of my choosing without opening the sidebar. To do this:\n\na) Create a Quick-note template, e.g.:\n\n```\n---\ntitle: New Blank Note in (Choose Folder) - qtn version\ntype: quick-note \nfolder: \n---\n#project @start(<%- promptDate('startDate', 'Enter start date') %>) @due(<%- promptDate('dueDate', 'Enter due date - or enter') %>) @review(<%- promptDateInterval('question', 'Enter review interval') %>)\n```\n\nb) And then use this plugin to `/Set/Change/Rename Preset Action`:\n- Use Link Creator to create a link (Run a plugin command + `np:qtn`)\n- Pass the title of the template as the first argument/parameter: \"New Project note (qtn version)\"\n\n***Then a few keystrokes will create a new project note in a folder of your choosing***\n\n\n### let us know of other examples you have and use!\n\n## Settings\n\n### Setting: \"Characters to Prepend to Command\"\n\nIf there are characters like “-⭐️” in front of each command, it will keep them together and float them to the top of the menu. So when you open the command bar and type the leading character (e.g. \"-\"), you will see all the favorite commands at a glance. Whatever text you put here will be prepended to any command name you set. Blank this field out to not prepend any characters, and the command name will be exactly the text you enter. Thx @clayrussell for this idea!\n" }, { "path": "dwertheimer.Favorites/__tests__/NPFavorites.test.js", "content": "/* eslint-disable no-unused-vars */\n/* eslint-disable import/order */\n/* global jest, describe, test, expect, beforeAll, afterAll, beforeEach, afterEach */\n\n// NOTE: IF YOU CALL A NPFRONTMATTER FUNCTION, YOU MUST MOCK IT MANUALLY HERE OR YOU WILL GET A FUNCTION NOT FOUND ERROR\n\nimport * as f from '../src/NPFavorites'\nimport { CustomConsole, LogType, LogMessage, clo } from '@jest/console' // see note below\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, simpleFormatter, Note, Paragraph /* mockWasCalledWithString, Paragraph */ } from '@mocks/index'\nimport { getConfig } from '../src/NPFavorites'\n\n// dbw note: some of ChatGPT's suggested mocking actually becomes a hassle because underlying functions imported in these modules are not mocked\n// I have tried to include them with the ...originalModule approach but it is not always possible\n// DBW NOTE TO SELF: Avoid the function mocking wherever possible. Only mock things like showMessage & chooseOption\n\n// Mocks for userInput helpers\njest.mock('../../helpers/userInput', () => {\n const originalModule = jest.requireActual('../../helpers/userInput')\n return {\n ...originalModule,\n chooseOption: jest.fn(),\n showMessage: jest.fn((msg) => Promise.resolve()),\n }\n})\n\nconst PLUGIN_NAME = `Favorites`\nconst FILENAME = `NPFavorites`\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = new NotePlan()\n global.console = new CustomConsole(process.stdout, process.stderr, simpleFormatter) // minimize log footprint\n DataStore.settings['_logLevel'] = 'none' //change this to DEBUG to get more logging (or 'none' for none)\n})\n\n/**\n * Tests for the NPFavorites plugin functions.\n * @module NPFavorites.test\n */\n\ndescribe(`${PLUGIN_NAME}`, () => {\n describe(`${FILENAME}`, () => {\n /**\n * Reset mocks and globals before each test\n * @returns {void}\n */\n beforeEach(() => {\n jest.clearAllMocks()\n // Reset Editor.note to a new Note by default\n Editor.note = new Note()\n // Set default settings favoriteIdentifier to 'Star in title'\n DataStore.settings.favoriteIdentifier = 'Star in title'\n DataStore.settings._logLevel = 'none'\n // Default for projectNotes\n DataStore.projectNotes = []\n })\n afterEach(() => {\n DataStore.settings._logLevel = 'none'\n })\n\n /**\n * Tests for the setFavorite function\n * @returns {void}\n */\n describe('setFavorite', () => {\n /**\n * Test that when the note is already a favorite, the user is notified and no further action is taken.\n * @returns {Promise}\n */\n test('should notify user if the note is already a favorite', async () => {\n // Setup note as already favorite\n Editor.note = new Note({ title: '⭐️ Test Note', type: 'Notes' })\n const { showMessage } = require('../../helpers/userInput')\n showMessage.mockClear()\n await f.setFavorite()\n expect(showMessage).toHaveBeenCalledWith('This file is already a Favorite! Use /unfave to remove.')\n })\n\n /**\n * Test that when the note is not already a favorite and using the Star identifier, the title is updated correctly.\n * @returns {Promise}\n */\n test('should set favorite by updating note title when not already favorite using Star identifier', async () => {\n // Setup note as not already favorite\n Editor.note = new Note({ title: 'Test Note', type: 'Notes' })\n await f.setFavorite()\n })\n\n /**\n * Test that if no valid note is selected, the user is notified accordingly.\n * @returns {Promise}\n */\n test.skip('should notify user when no valid note is selected', async () => {\n // Explicitly set Editor.note to null to simulate no note selected\n Editor.note = null\n const { showMessage } = require('../../helpers/userInput')\n showMessage.mockClear()\n await f.setFavorite()\n expect(showMessage).toHaveBeenCalledWith('Please select a Project Note in Editor first.')\n global.Editor = Editor\n })\n // Skipping this test for now because we don't have full mocking for Editor.frontmatterAttributes setter yet\n test.skip('should work in real world example', async () => {\n const note = new Note({\n title: 'this is title',\n filename: 'DELETEME/Productivity & Apps/this is title.md',\n type: 'Notes',\n frontmatterAttributes: { title: 'this is title' },\n paragraphs: [\n {\n content: '---',\n rawContent: '---',\n type: 'separator',\n heading: '',\n headingLevel: -1,\n lineIndex: 0,\n isRecurring: false,\n indents: 0,\n noteType: 'Notes',\n },\n {\n content: 'title: this is title',\n rawContent: 'title: this is title',\n type: 'text',\n heading: '',\n headingLevel: -1,\n lineIndex: 1,\n isRecurring: false,\n indents: 0,\n noteType: 'Notes',\n },\n {\n content: '---',\n rawContent: '---',\n type: 'separator',\n heading: '',\n headingLevel: -1,\n lineIndex: 2,\n isRecurring: false,\n indents: 0,\n noteType: 'Notes',\n },\n {\n content: 'this is text',\n rawContent: 'this is text',\n type: 'text',\n heading: '',\n headingLevel: -1,\n lineIndex: 3,\n isRecurring: false,\n indents: 0,\n noteType: 'Notes',\n },\n ],\n })\n Editor.note = note\n await f.setFavorite()\n expect(note.paragraphs[1].content).toEqual('title: ⭐️ this is title')\n expect(note.paragraphs.length).toEqual(4)\n })\n })\n\n /**\n * Tests for openFavorite function\n * @returns {void}\n */\n describe('openFavorite', () => {\n /**\n * Test that when no favorite documents are found, the user is notified.\n * @returns {Promise}\n */\n test('should notify user if no favorite documents found', async () => {\n // Setup mocks to simulate no favorites available\n const { showMessage } = require('../../helpers/userInput')\n showMessage.mockClear()\n await f.openFavorite()\n expect(showMessage).toHaveBeenCalledWith('No favorites found matching your setting which requires: \"Star in title\"! Use the /fave document command to set a favorite.')\n })\n\n /**\n * Test that when favorites exist, the selected favorite document is opened.\n * @returns {Promise}\n */\n test('should open the selected favorite document', async () => {\n // Setup mocks to simulate favorites available\n DataStore.projectNotes = [{ title: '⭐️ Fav Note', filename: 'fav_note.md' }]\n const { chooseOption } = require('../../helpers/userInput')\n chooseOption.mockClear()\n chooseOption.mockResolvedValue('fav_note.md')\n\n // Spy on Editor.openNoteByFilename\n Editor.openNoteByFilename = jest.fn((filename) => Promise.resolve())\n await f.openFavorite()\n expect(chooseOption).toHaveBeenCalledWith('Choose a Favorite (⭐️) Document:', [{ label: '⭐️ Fav Note', value: 'fav_note.md' }], '')\n expect(Editor.openNoteByFilename).toHaveBeenCalledWith('fav_note.md')\n })\n\n /**\n * Test that openFavorite combines notes with frontmatter and notes with stars.\n * @returns {Promise}\n */\n test('should combine notes with frontmatter and notes with stars', async () => {\n // Setup mock notes\n const notesWithFM = [\n new Note({ title: 'FM Note', filename: 'fm_note.md', frontmatterAttributes: { favorite: true }, type: 'Notes', content: '---\\nfavorite: true\\n---\\n' }),\n ]\n const notesWithStars = [new Note({ title: '⭐️ Star Note', filename: 'star_note.md' })]\n DataStore.projectNotes = [...notesWithStars, ...notesWithFM]\n DataStore.settings = {\n ...DataStore.settings,\n favoriteIdentifier: 'Star or Frontmatter (either)',\n favoriteKey: 'favorite',\n _logLevel: 'none',\n }\n\n const { chooseOption } = require('../../helpers/userInput')\n chooseOption.mockClear()\n chooseOption.mockResolvedValue('star_note.md')\n\n // Spy on Editor.openNoteByFilename\n Editor.openNoteByFilename = jest.fn((filename) => Promise.resolve())\n\n await f.openFavorite()\n expect(chooseOption).toHaveBeenCalledWith(\n 'Choose a Favorite (⭐️) Document:',\n [\n { label: 'FM Note', value: 'fm_note.md' },\n { label: '⭐️ Star Note', value: 'star_note.md' },\n ],\n '',\n )\n expect(Editor.openNoteByFilename).toHaveBeenCalledWith('star_note.md')\n })\n })\n\n /**\n * Tests for removeFavorite function\n * @returns {void}\n */\n describe('removeFavorite', () => {\n /**\n * Test that when a note is favorite using the Star identifier, its favorite status is removed by updating the title.\n * @returns {Promise}\n */\n test('should remove favorite status when note is favorite using Star identifier', async () => {\n // Setup note as favorite using Star indicator\n Editor.note = new Note({ title: '⭐️ Test Note', type: 'Notes' })\n await f.removeFavorite()\n })\n\n /**\n * Test that if the note is not marked as favorite, the user is notified.\n * @returns {Promise}\n */\n test('should notify user if note is not favorite', async () => {\n // Setup note that is not favorite\n Editor.note = new Note({ title: 'Test Note', type: 'Notes' })\n const { showMessage } = require('../../helpers/userInput')\n showMessage.mockClear()\n await f.removeFavorite()\n expect(showMessage).toHaveBeenCalledWith('This file is not a Favorite! Use /fave to make it one.')\n })\n\n /**\n * Test that if no valid note is selected for removal, the user is notified accordingly.\n * @returns {Promise}\n * // FIXME: This test is failing because Editor is a proxy. I don't know how to mock it.\n */\n test.skip('should notify user when no valid note is selected in removeFavorite', async () => {\n // Explicitly set Editor.note to null to simulate no note selected\n Editor.note = null\n const { showMessage } = require('../../helpers/userInput')\n showMessage.mockClear()\n await f.removeFavorite()\n expect(showMessage).toHaveBeenCalledWith('Please select a Project Note in Editor first.')\n })\n\n /**\n * Test that removeFavorite removes the frontmatter favorite property when using Frontmatter only configuration.\n * @returns {Promise} A promise that resolves when the test is complete.\n * // FIXME: This test is failing because Editor is a proxy. I don't know how to mock it.\n */\n test.skip('should remove frontmatter favorite property when using Frontmatter only', async () => {\n // Setup note with favorite marked in frontmatter\n const note = new Note({ title: 'Test Note', type: 'Notes', frontmatterAttributes: { favorite: 'true' } })\n Editor.note = note\n // Set configuration to Frontmatter only using dynamic favoriteKey\n DataStore.settings.favoriteIdentifier = 'Frontmatter only'\n DataStore.settings.favoriteKey = 'favorite'\n DataStore.settings._logLevel = 'none'\n // Call removeFavorite\n await f.removeFavorite()\n\n // Verify that the frontmatter attribute was removed using the dynamic key\n expect(note.content).not.toContain('favorite: true')\n })\n })\n\n describe('Frontmatter favorite behavior in NP Favorites', () => {\n /**\n * Test that setFavorite sets the frontmatter favorite property to 'true' when using Frontmatter only configuration.\n * @returns {Promise} A promise that resolves when the test is complete.\n */\n test.skip('should set frontmatter favorite when using Frontmatter only', async () => {\n // TODO: we need a mock for changing frontMatterAttributes when note content changes\n // Setup note with no favorite marked in frontmatter\n const paragraphs = [\n new Paragraph({ content: '---', rawContent: '---', type: 'separator', heading: '', headingLevel: -1, lineIndex: 0, isRecurring: false, indents: 0, noteType: 'Notes' }),\n new Paragraph({\n content: 'title: Test Note',\n rawContent: 'title: Test Note',\n type: 'text',\n heading: '',\n headingLevel: -1,\n lineIndex: 1,\n isRecurring: false,\n indents: 0,\n noteType: 'Notes',\n }),\n new Paragraph({ content: '---', rawContent: '---', type: 'separator', heading: '', headingLevel: -1, lineIndex: 2, isRecurring: false, indents: 0, noteType: 'Notes' }),\n new Paragraph({ content: 'foo', rawContent: 'foo', type: 'text', heading: '', headingLevel: -1, lineIndex: 3, isRecurring: false, indents: 0, noteType: 'Notes' }),\n ]\n const note = new Note({ title: 'Test Note', type: 'Notes', frontmatterAttributes: {}, paragraphs })\n global.Editor = { ...global.Editor, ...note, note: note }\n // Set configuration to Frontmatter only using dynamic favoriteKey\n DataStore.settings.favoriteIdentifier = 'Frontmatter only'\n DataStore.settings.favoriteKey = 'favorite'\n DataStore.settings._logLevel = 'none'\n // Call setFavorite\n await f.setFavorite()\n\n // Verify that the frontmatter attribute was set to 'true' using the dynamic key\n expect(note.frontmatterAttributes['favorite']).toEqual('true')\n })\n\n /**\n * Test that removeFavorite sets the frontmatter favorite property to 'false' when using Frontmatter only configuration.\n * @returns {Promise} A promise that resolves when the test is complete.\n * // FIXME: This test is failing because Editor is a proxy. I don't know how to mock it.\n */\n test.skip('should remove frontmatter favorite when using Frontmatter only', async () => {\n // Setup note with favorite marked in frontmatter\n const note = new Note({ title: 'Test Note', type: 'Notes', frontmatterAttributes: { favorite: 'true' } })\n Editor.note = note\n // Set configuration to Frontmatter only using dynamic favoriteKey\n DataStore.settings.favoriteIdentifier = 'Frontmatter only'\n DataStore.settings.favoriteKey = 'favorite'\n DataStore.settings._logLevel = 'none'\n\n // Call removeFavorite\n await f.removeFavorite()\n\n // Verify that the frontmatter attribute was set to 'false' using the dynamic key\n expect(note.frontmatterAttributes['favorite']).toBeUndefined()\n })\n })\n\n describe('getConfig', () => {\n /**\n * Test that the favoriteKey is reset to 'favorite' if it contains invalid characters.\n * @returns {Promise}\n */\n test('should reset favoriteKey to default if it contains invalid characters', async () => {\n DataStore.settings = {\n ...DataStore.settings,\n favoriteIdentifier: 'Frontmatter only',\n favoriteKey: 'fav@key',\n _logLevel: 'none',\n }\n const config = await getConfig()\n expect(config.favoriteKey).toBe('favorite')\n })\n\n /**\n * Test that the favoriteKey remains unchanged if it is valid.\n * @returns {Promise}\n */\n test('should keep favoriteKey unchanged if it is valid', async () => {\n DataStore.settings = {\n ...DataStore.settings,\n favoriteIdentifier: 'Frontmatter only',\n favoriteKey: 'validKey',\n _logLevel: 'none',\n }\n const config = await getConfig()\n expect(config.favoriteKey).toBe('validKey')\n })\n })\n // end of function tests\n }) // end of describe(`${FILENAME}`)\n}) // end of describe(`${PLUGIN_NAME}`)\n" }, { "path": "dwertheimer.Favorites/__tests__/favorites.test.js", "content": "/* eslint-disable no-unused-vars */\n/* eslint-disable import/order */\n/* globals describe, expect, it, test, beforeAll, beforeEach, afterAll, jest */\nimport { CustomConsole, LogType, LogMessage } from '@jest/console' // see note below\nimport * as f from '../src/favorites'\nimport { Calendar, Clipboard, CommandBar, DataStore, Editor, NotePlan, simpleFormatter /* Note, mockWasCalledWithString, Paragraph */ } from '@mocks/index'\nimport { getFavoriteDefault, favoriteNotes, getFaveOptionsArray, titleHasFavoriteIcon, getFavoritedTitle, removeFavoriteFromTitle, noteIsFavorite } from '../src/favorites'\nimport { noteHasFrontMatter, getFrontmatterAttributes } from '@helpers/NPFrontMatter'\n\nbeforeAll(() => {\n global.Calendar = Calendar\n global.Clipboard = Clipboard\n global.CommandBar = CommandBar\n global.DataStore = DataStore\n global.Editor = Editor\n global.NotePlan = new NotePlan()\n global.console = new CustomConsole(process.stdout, process.stderr, simpleFormatter) // minimize log footprint\n DataStore.settings['_logLevel'] = 'none' //change this to DEBUG to get more logging (or 'none' for none)\n DataStore.settings['favoriteIdentifier'] = 'Star in title'\n DataStore.settings['favoriteKey'] = 'favorite'\n})\n\nconst config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Star in title', favoriteKey: 'favorite' }\n\n// Mock the functions that need to be mocked\njest.mock('../src/favorites', () => ({\n ...jest.requireActual('../src/favorites'),\n titleHasFavoriteIcon: jest.fn((title, icon) => title.includes(icon)),\n}))\n\njest.mock('@helpers/NPFrontMatter', () => ({\n noteHasFrontMatter: jest.fn(() => true),\n getFrontmatterAttributes: jest.fn(() => ({ favorite: true })),\n hasFrontMatter: jest.fn(() => true),\n getAttributes: jest.fn(() => ({ favorite: true })),\n}))\n\n// Jest suite\ndescribe('dwertheimer.Favorites favorites.js', () => {\n // getFavoriteDefault\n test('getFavoriteDefault', () => {\n // expect(pd.isTask(noteWithTasks.paragraphs[1])).toBe(true)\n // expect(pd.isTask(noteWithOutTasks.paragraphs[1])).toBe(false)\n expect(getFavoriteDefault()).toEqual('⭐️')\n })\n\n //favoriteNotes\n describe('favoriteNotes ', () => {\n test('should find favorites tag wherever it exists in a string', () => {\n const notes = [{ title: '⭐️ front' }, { title: 'back ⭐️' }, { title: 'mid ⭐️ dle' }, { title: 'none' }]\n const faves = favoriteNotes(notes, config)\n expect(faves.length).toEqual(3)\n expect(faves[0].title).toEqual('⭐️ front')\n expect(faves[1].title).toEqual('back ⭐️')\n expect(faves[2].title).toEqual('mid ⭐️ dle')\n })\n test('should find no favorites if title is undefined', () => {\n expect(favoriteNotes([{ title: undefined }], config)).toEqual([])\n })\n })\n\n // getFaveOptionsArray\n describe('getFaveOptionsArray ', () => {\n test('options creator function should return value/label for each favorite', () => {\n const notes = [\n { title: '⭐️ front', filename: 'f1' },\n { title: 'back ⭐️', filename: 'f2' },\n { title: 'mid ⭐️ dle', filename: 'f3' },\n ]\n const options = getFaveOptionsArray(notes)\n expect(options.length).toEqual(3)\n expect(options[0].label).toEqual('⭐️ front')\n expect(options[0].value).toEqual('f1')\n })\n test('options creator function should return empty array for undefined values', () => {\n expect(getFaveOptionsArray([{ title: undefined, filename: undefined }])).toEqual([])\n })\n })\n\n // Test f.removeFavorite\n describe('removeFavorite ', () => {\n test('should remove favorite marker wherever it is in the string', () => {\n expect(removeFavoriteFromTitle('⭐️ front', '⭐️', config.favoriteIdentifier)).toEqual('front')\n expect(removeFavoriteFromTitle('back ⭐️', '⭐️', config.favoriteIdentifier)).toEqual('back')\n expect(removeFavoriteFromTitle('not here', '⭐️', config.favoriteIdentifier)).toEqual('not here')\n })\n })\n\n //titleHasFavoriteIcon\n describe('titleHasFavoriteIcon ', () => {\n test('should return true if there is a favorite icon in the title', () => {\n expect(titleHasFavoriteIcon(`⭐️`, `⭐️`)).toEqual(true)\n expect(titleHasFavoriteIcon(`⭐️ yes`, `⭐️`)).toEqual(true)\n expect(titleHasFavoriteIcon(`test ⭐️`, `⭐️`)).toEqual(true)\n expect(titleHasFavoriteIcon(`test ⭐️ test`, `⭐️`)).toEqual(true)\n })\n test('should return false if there is no favorite icon in the title', () => {\n expect(titleHasFavoriteIcon(`test test`, `⭐️`)).toEqual(false)\n expect(titleHasFavoriteIcon(``, `⭐️`)).toEqual(false)\n })\n })\n\n //getFavoritedTitle\n describe('getFavoritedTitle ', () => {\n test('should insert favorite icon at front of string with prepend option', () => {\n expect(getFavoritedTitle(`test`, 'prepend', `⭐️`, config.favoriteIdentifier)).toEqual(`⭐️ test`)\n })\n test('should insert favorite icon at end of string with append option', () => {\n expect(getFavoritedTitle(`test`, 'append', `⭐️`, config.favoriteIdentifier)).toEqual(`test ⭐️`)\n })\n })\n\n // Test noteIsFavorite function\n describe('noteIsFavorite', () => {\n test('should return true if note is favorite by title', () => {\n const note = { title: '⭐️ Note', filename: 'note.md', paragraphs: [{ type: 'separator' }] }\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Star in title', favoriteKey: 'favorite' }\n titleHasFavoriteIcon.mockReturnValue(true)\n\n expect(noteIsFavorite(note, config)).toBe(true)\n })\n\n test('should return false if note is not favorite by title', () => {\n const note = { title: 'Note', filename: 'note.md', paragraphs: [{ type: 'separator' }] }\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Star in title', favoriteKey: 'favorite' }\n titleHasFavoriteIcon.mockReturnValue(false)\n\n expect(noteIsFavorite(note, config)).toBe(false)\n })\n\n test('should return true if note is favorite by frontmatter', () => {\n const note = {\n title: 'Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: { favorite: true },\n }\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Frontmatter only', favoriteKey: 'favorite' }\n noteHasFrontMatter.mockReturnValue(true)\n\n expect(noteIsFavorite(note, config)).toBe(true)\n })\n\n test('should return false if note is not favorite by frontmatter', () => {\n const note = {\n title: 'Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: { favorite: false },\n }\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Frontmatter only', favoriteKey: 'favorite' }\n noteHasFrontMatter.mockReturnValue(true)\n\n expect(noteIsFavorite(note, config)).toBe(false)\n })\n\n test('should return true if note is favorite by either title or frontmatter', () => {\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Star or Frontmatter (either)', favoriteKey: 'favorite' }\n // Case 1: Title is favorite\n let note = {\n title: '⭐️ Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: {},\n }\n titleHasFavoriteIcon.mockReturnValue(true)\n noteHasFrontMatter.mockReturnValue(false)\n expect(noteIsFavorite(note, config)).toBe(true)\n\n // Case 2: Frontmatter is favorite\n note = {\n title: 'Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: { favorite: true },\n }\n titleHasFavoriteIcon.mockReturnValue(false)\n noteHasFrontMatter.mockReturnValue(true)\n expect(noteIsFavorite(note, config)).toBe(true)\n })\n\n test('should return false if note is not favorite by either title or frontmatter', () => {\n const note = {\n title: 'Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: {},\n }\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Star or Frontmatter (either)', favoriteKey: 'favorite' }\n titleHasFavoriteIcon.mockReturnValue(false)\n noteHasFrontMatter.mockReturnValue(false)\n\n expect(noteIsFavorite(note, config)).toBe(false)\n })\n\n test('should return true if note is favorite by both title and frontmatter', () => {\n const note = {\n title: '⭐️ Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: { favorite: true },\n }\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Star and Frontmatter (both)', favoriteKey: 'favorite' }\n titleHasFavoriteIcon.mockReturnValue(true)\n noteHasFrontMatter.mockReturnValue(true)\n\n expect(noteIsFavorite(note, config)).toBe(true)\n })\n\n test('should return false if note is not favorite by both title and frontmatter', () => {\n let note = {\n title: 'Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: {},\n }\n const config = { favoriteIcon: '⭐️', favoriteIdentifier: 'Star and Frontmatter (both)', favoriteKey: 'favorite' }\n titleHasFavoriteIcon.mockReturnValue(true)\n noteHasFrontMatter.mockReturnValue(false)\n expect(noteIsFavorite(note, config)).toBe(false)\n\n note = {\n title: 'Note',\n filename: 'note.md',\n paragraphs: [{ type: 'separator' }],\n frontmatterAttributes: { favorite: true },\n }\n titleHasFavoriteIcon.mockReturnValue(false)\n noteHasFrontMatter.mockReturnValue(true)\n expect(noteIsFavorite(note, config)).toBe(false)\n })\n })\n})\n" }, { "path": "dwertheimer.Favorites/plugin.json", "content": "{\n \"COMMENT1\": \"Note If you are not going to use the `npm run autowatch` command to compile, then delete the macOS.minVersion line below\",\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.20.1\",\n \"plugin.id\": \"dwertheimer.Favorites\",\n \"plugin.name\": \"⭐️ Favorites\",\n \"plugin.description\": \"Get fast access to commonly-used notes. Set any Project Note(s) as a Favorites and have quick access to choose/open the file\",\n \"plugin.author\": \"@dwertheimer\",\n \"plugin.version\": \"1.3.6\",\n \"plugin.lastUpdateInfo\": \"1.3.6: PluginRequestEnvelope / requestFromPlugin aligned with np.Shared 1.0.7.\\n1.3.5: Fix sidebar icon colour issue\\n1.3.4: Fix dark mode issues (thx @clayrussell)\\n1.3.3: Use new sidebar view feature\\n1.3.0: Add new '/favorites browser' command to open favorites in a sidebar window to view and open favorite notes and commands\\n1.3.1: Fix request timeout issue\\n1.3.2: Fix frontmatter not being removed when unfavoriting\",\n \"plugin.dependencies\": [],\n \"plugin.requiredFiles\": [\"react.c.FavoritesView.bundle.dev.js\"],\n \"plugin.script\": \"script.js\",\n \"plugin.url\": \"Put a link to a web page or your github readme file here, and it will be displayed as the 'website' in the plugin preference pane to give users more info on the plugin before/after install, e.g. https://github.com/dwertheimer/Noteplan-plugins/blob/main/np.plugin-flow-skeleton/readme.md\",\n \"plugin.commands\": [\n {\n \"name\": \"faves - Choose+Open Favorite (⭐️) Note\",\n \"description\": \"Open one of the saved Favorites\",\n \"jsFunction\": \"openFavorite\",\n \"alias\": [\n \"faves\",\n \"favorites\"\n ]\n },\n {\n \"name\": \"fave - Make this Note a Favorite (⭐️)\",\n \"description\": \"Set open Note to be a Favorite (add ⭐️)\",\n \"jsFunction\": \"setFavorite\",\n \"alias\": [\n \"fave\"\n ]\n },\n {\n \"name\": \"unfave - Remove this Note from Favorites List (⭐️)\",\n \"description\": \"Remove this Note from saved Favorites (remove ⭐️ from name)\",\n \"jsFunction\": \"removeFavorite\",\n \"alias\": [\n \"unfave\"\n ]\n },\n {\n \"name\": \"Sidebar - Open Favorites Browser Sidebar\",\n \"description\": \"Open a sidebar window to view and open favorite notes and commands\",\n \"jsFunction\": \"openFavoritesBrowser\",\n \"alias\": [\n \"favorites-browser\",\n \"fav-browser\"\n ],\n \"sidebarView\": {\n \"windowID\": \"favorites-browser-window main\",\n \"title\": \"Favorites\",\n \"icon\": \"star\",\n \"iconColor\": \"#F8E160\"\n },\n \"arguments\": [ \"IsFloating: If true or 'true', opens as a floating window instead of main window (optional, defaults to false)\"]\n },\n {\n \"name\": \"onFavoritesBrowserAction\",\n \"description\": \"Handle actions from Favorites Browser React window\",\n \"jsFunction\": \"onFavoritesBrowserAction\",\n \"hidden\": true\n },\n {\n \"note\": \"****************************************************\",\n \"not1\": \"********** PRESETS BELOW THIS LINE ***********\",\n \"not2\": \"****************************************************\"\n },\n {\n \"name\": \"Set/Change/Rename Preset Action\",\n \"description\": \"Add or edit a preset to run a favorite URL/X-Callback\",\n \"jsFunction\": \"changePreset\"\n },\n {\n \"name\": \"x-Test Preset Settings Migration\",\n \"description\": \"Test auto migration of presets; use this URL to test:\",\n \"URL\": \"noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.Favorites&command=x-Test%20Preset%20Settings%20Migration\",\n \"jsFunction\": \"onUpdateOrInstall\",\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 01\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset01\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 02\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset02\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 03\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset03\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 04\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset04\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 05\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset05\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 06\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset06\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 07\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset07\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 08\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset08\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 09\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset09\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 10\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset10\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 11\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset11\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 12\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset12\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 13\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset13\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 14\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset14\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 15\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset15\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 16\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset16\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 17\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset17\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 18\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset18\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 19\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset19\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"name\": \"Favorites: Set Preset 20\",\n \"description\": \"Run Favorite Action\",\n \"jsFunction\": \"runPreset20\",\n \"isPreset\": true,\n \"hidden\": true\n },\n {\n \"NOTE\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"Favorites: Update Plugin Settings\",\n \"description\": \"Preferences\",\n \"jsFunction\": \"editSettings\"\n }\n ],\n \"notes\": {\n \"note\": \"****************************************************\",\n \"not1\": \"********** SETTINGS BELOW THIS LINE **********\",\n \"not2\": \"****************************************************\"\n },\n \"plugin.settings\": [\n {\n \"COMMENT\": \"Plugin settings documentation: https://help.noteplan.co/article/123-plugin-configuration\",\n \"type\": \"heading\",\n \"title\": \"Favorites Settings\"\n },\n {\n \"key\": \"charsToPrepend\",\n \"title\": \"Characters to Prepend to Command\",\n \"description\": \"If there are characters like “-☆” in front of each command, it will keep them together and float them to the top of the menu. Whatever text you put here will be prepended to any command name you set. Blank this field out to not prepend any characters. No spaces will be added after text you put in this box, so if you want a space, add it to the text box.\",\n \"type\": \"string\",\n \"default\": \"-\",\n \"required\": false\n },\n {\n \"key\": \"favoriteIdentifier\",\n \"title\": \"How should favorite notes be identified?\",\n \"description\": \"Favorite notes can be identified by:\\n- A star (⭐️) in the title\\n- A frontmatter field like `favorite: `\\n- both ⭐️ in title and `favorite: ` in frontmatter (both are required)\\n- either ⭐️ in title or `favorite: ` in frontmatter (either will do, but only one is required). (default)\",\n \"type\": \"string\",\n \"default\": \"Star or Frontmatter (either)\",\n \"required\": true,\n \"choices\": [\"Star in title\", \"Frontmatter only\", \"Star and Frontmatter (both)\" , \"Star or Frontmatter (either)\"]\n },\n {\n \"type\": \"string\",\n \"title\": \"Favorite key/label to use in frontmatter to designate a favorite note\",\n \"key\": \"favoriteKey\",\n \"default\": \"favorite\",\n \"required\": true,\n \"description\": \"If you set the favorite notes identifer to any setting which includes frontmatter, this setting allows you to change the name of the frontmatter key used for the favorite field. Default is 'favorite' but you can change it to 'favourite' or 'fav' or whatever you want. Note: cannot include spaces, tabs, or special characters (e.g. #, @ etc.) in the key name.\"\n },\n {\n \"type\": \"hidden\",\n \"key\": \"pluginID\",\n \"default\": \"dwertheimer.Favorites\",\n \"COMMENT\": \"This is for use by the editSettings helper function. PluginID must match the plugin.id in the top of this file\"\n },\n {\n \"key\": \"runPreset01\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 01\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset02\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 02\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset03\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 03\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset04\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 04\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset05\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 05\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset06\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 06\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset07\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 07\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset08\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 08\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset09\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 09\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset10\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 10\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset11\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 11\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset12\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 12\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset13\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 13\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset14\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 14\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset15\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 15\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset16\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 16\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset17\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 17\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset18\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 18\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset19\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 19\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"key\": \"runPreset20\",\n \"type\": \"hidden\",\n \"default\": \"\",\n \"title\": \"Preset 20\",\n \"description\": \"Do not change this setting manually. Use the \\\"/Change Favorite Preset\\\" command.\"\n },\n {\n \"note\": \"================== DEBUGGING SETTINGS ========================\"\n },\n {\n \"NOTE\": \"DO NOT CHANGE THE FOLLOWING SETTINGS; ADD YOUR SETTINGS ABOVE ^^^\",\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"INFO\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much logging output will be displayed when executing PLUGIN DOWNLOAD TEST commands in NotePlan Plugin Console Logs (NotePlan -> Help -> Plugin Console)\\n\\n - DEBUG: Show All Logs\\n - INFO: Only Show Info, Warnings, and Errors\\n - WARN: Only Show Errors or Warnings\\n - ERROR: Only Show Errors\\n - none: Don't show any logs\",\n \"default\": \"INFO\",\n \"required\": true\n }\n ]\n}" }, { "path": "dwertheimer.Favorites/src/NPFavoritePresets.js", "content": "// @flow\n\nimport pluginJson from '../plugin.json'\nimport { showMessage, chooseOption } from '@helpers/userInput'\nimport { log, logError, logDebug, timer, clo, JSP } from '@helpers/dev'\nimport { type PresetCommand, savePluginCommand, choosePreset, presetChosen } from '@helpers/NPPresets'\nimport { getPluginJson } from '@helpers/NPConfiguration'\n\nconst COMMAND_NAME_TEMPLATE = 'Favorites: Set Preset '\n\n// check whether valid URL or xcallback URL\nconst isValidURL = (url) => /^(https?|[a-z0-9\\-]+):\\/\\/[a-z0-9\\-]+/i.test(url)\n\n/**\n * Get the URL either through the callback creator or hand-entered\n */\nexport async function getURL(commandName: string, defaultValue: string): Promise {\n const options = [\n { label: 'Run Link Creator to get URL (e.g. a NotePlan X-Callback)', value: 'linkCreator' },\n { label: 'Enter/Paste URL (you know or can paste the URL)', value: 'enter' },\n ]\n if (defaultValue) options.push({ label: `Keep Previous Value: \"${defaultValue}\"`, value: 'previous' })\n const choice = await chooseOption('How do you want to set the URL?', options, null)\n let url = ''\n if (choice) {\n if (choice === 'linkCreator') {\n url = await DataStore.invokePluginCommandByName('Get X-Callback-URL', 'np.CallbackURLs', ['', true])\n } else if (choice === 'enter') {\n url = await CommandBar.textPrompt('Set Preset X-Callback', `What X-Callback or URL do you want to run when the command\\n\"${commandName}\"\\nis selected?`, defaultValue || '')\n } else if (choice === 'previous') {\n url = defaultValue\n }\n } else {\n logDebug(pluginJson, `getURL no choice made. Returning empty string.`)\n }\n return url || ''\n}\n\n/**\n * Each of the preset commands calls this function, as does set/reset a command\n * It is called indirectly, as a callback sent to presetChosen\n * @param {PresetCommand} commandDetails - the full command object from the current plugin.json\n * @param {boolean} overwrite - this is a set/reset call\n */\nexport async function favoritePresetChosen(commandDetails: PresetCommand | null = null, overwrite: boolean = false) {\n if (!Editor) {\n showMessage(`You must be in the Editor with a document open to run this command`)\n return\n }\n clo(commandDetails, `favoritePresetChosen: overwrite:${String(overwrite)} commandDetails:`)\n if (commandDetails) {\n let commandName = commandDetails.name.startsWith(COMMAND_NAME_TEMPLATE) ? '' : commandDetails.name\n commandName = DataStore.settings.charsToPrepend ? commandName.replace(DataStore.settings.charsToPrepend, '').trim() : commandName\n logDebug(pluginJson, `favoritePresetChosen: command.name = \"${commandDetails.name}\" overwrite?:${String(overwrite)}`)\n // Put the text of an unset command in the plugin.json here (how we tell if it's vanilla/unset)\n const favoriteIsUnset = !commandDetails.name || commandDetails.name.match(/Set Preset/)\n logDebug(pluginJson, `favoritePresetChosen: favoriteIsUnset=${String(favoriteIsUnset)}`)\n if (favoriteIsUnset || overwrite) {\n // SET THE PRESET COMMAND\n let favoriteCommand = await CommandBar.textPrompt(\n 'Set Preset Text',\n 'What human-readable text do you want to use for the command? (this is the text you will see in the Command Bar when you type slash)\\n\\nLeave blank to unset the command',\n commandName,\n )\n logDebug(pluginJson, `favoritePresetChosen favoriteCommand entered=${String(favoriteCommand)}`)\n if (favoriteCommand && favoriteCommand !== '') {\n favoriteCommand = DataStore.settings.charsToPrepend ? `${DataStore.settings.charsToPrepend}${favoriteCommand}` : favoriteCommand\n const text = await getURL(favoriteCommand, commandDetails.data || '')\n if (text) {\n // validate x-callback URL\n if (!isValidURL(text)) {\n await showMessage(`\"${text}\" is not a valid URL. Must be an X-Callback URL or full Web URL. Please try again.`)\n return\n }\n await savePluginCommand(pluginJson, { ...commandDetails, name: favoriteCommand, data: text })\n await showMessage(\n `Menu command set.\\n\\nYou will find it in the CommandBar immediately by typing:\\n\"/${String(\n favoriteCommand,\n )}\"\\nYou won't see it in the menu until you restart NotePlan.`,\n )\n } else {\n // User cancelled the x-callback prompt\n await showMessage(`Command not set. You must enter an X-Callback URL to set this command.`)\n }\n } else {\n if (favoriteCommand === '') {\n clo(commandDetails, `favoritePresetChosen: Unsetting commandDetails:`)\n const numString = commandDetails.jsFunction.replace(/runPreset/, '')\n await savePluginCommand(pluginJson, { ...commandDetails, name: `${COMMAND_NAME_TEMPLATE} ${numString}`, data: '' })\n await showMessage(`Preset ${numString} has been deleted and can be reused.`)\n } // otherwise someone canceled the command\n }\n } else {\n // EXECUTE THE COMMAND CLICKED\n if (commandDetails.data) {\n NotePlan.openURL(commandDetails.data)\n } else {\n logError(pluginJson, `favoritePresetChosen No commandDetails.data for command: ${commandName}. Cannot move forward.`)\n }\n }\n } else {\n logError(pluginJson, `favoritePresetChosen: no command details object sent. Cannot continue.`)\n }\n}\n\n/*\n * PLUGIN ENTRYPOINTS BELOW THIS LINE\n */\n\n/**\n * Change a preset to another one\n * Plugin entrypoint for command: \"/Change favorite Preset\"\n * @param {*} incoming\n */\nexport async function changePreset(incoming: string) {\n try {\n logDebug(pluginJson, `changePreset running incoming:${incoming}`)\n const livePluginJson = await getPluginJson(pluginJson['plugin.id'])\n const chosen = await choosePreset(livePluginJson, 'Choose a preset to set/reset')\n if (chosen) {\n logDebug(pluginJson, `changePreset: ${chosen} -- calling presetChosen with favoritePresetChosen callback`)\n await presetChosen(pluginJson, chosen, favoritePresetChosen, [true])\n }\n } catch (error) {\n logError(pluginJson, JSP(error))\n }\n}\n\n/**\n * PRESET ENTRYPOINTS BELOW\n */\n\nexport const runPreset01 = async (): Promise => await presetChosen(pluginJson, `runPreset01`, favoritePresetChosen)\nexport const runPreset02 = async (): Promise => await presetChosen(pluginJson, `runPreset02`, favoritePresetChosen)\nexport const runPreset03 = async (): Promise => await presetChosen(pluginJson, `runPreset03`, favoritePresetChosen)\nexport const runPreset04 = async (): Promise => await presetChosen(pluginJson, `runPreset04`, favoritePresetChosen)\nexport const runPreset05 = async (): Promise => await presetChosen(pluginJson, `runPreset05`, favoritePresetChosen)\nexport const runPreset06 = async (): Promise => await presetChosen(pluginJson, `runPreset06`, favoritePresetChosen)\nexport const runPreset07 = async (): Promise => await presetChosen(pluginJson, `runPreset07`, favoritePresetChosen)\nexport const runPreset08 = async (): Promise => await presetChosen(pluginJson, `runPreset08`, favoritePresetChosen)\nexport const runPreset09 = async (): Promise => await presetChosen(pluginJson, `runPreset09`, favoritePresetChosen)\nexport const runPreset10 = async (): Promise => await presetChosen(pluginJson, `runPreset10`, favoritePresetChosen)\nexport const runPreset11 = async (): Promise => await presetChosen(pluginJson, `runPreset11`, favoritePresetChosen)\nexport const runPreset12 = async (): Promise => await presetChosen(pluginJson, `runPreset12`, favoritePresetChosen)\nexport const runPreset13 = async (): Promise => await presetChosen(pluginJson, `runPreset13`, favoritePresetChosen)\nexport const runPreset14 = async (): Promise => await presetChosen(pluginJson, `runPreset14`, favoritePresetChosen)\nexport const runPreset15 = async (): Promise => await presetChosen(pluginJson, `runPreset15`, favoritePresetChosen)\nexport const runPreset16 = async (): Promise => await presetChosen(pluginJson, `runPreset16`, favoritePresetChosen)\nexport const runPreset17 = async (): Promise => await presetChosen(pluginJson, `runPreset17`, favoritePresetChosen)\nexport const runPreset18 = async (): Promise => await presetChosen(pluginJson, `runPreset18`, favoritePresetChosen)\nexport const runPreset19 = async (): Promise => await presetChosen(pluginJson, `runPreset19`, favoritePresetChosen)\nexport const runPreset20 = async (): Promise => await presetChosen(pluginJson, `runPreset20`, favoritePresetChosen)\n" }, { "path": "dwertheimer.Favorites/src/NPFavorites.js", "content": "// @flow\nimport { chooseOption, showMessage } from '../../helpers/userInput'\nimport { favoriteNotes, getFaveOptionsArray, getFavoriteDefault, getFavoritedTitle, noteIsFavorite, removeFavoriteFromTitle, type FavoritesConfig } from './favorites'\nimport { setTitle } from '@helpers/note'\nimport { logDebug, clo, logError, JSP } from '@helpers/dev'\nimport { getFrontmatterAttributes, getFrontmatterNotes, updateFrontMatterVars, ensureFrontmatter } from '@helpers/NPFrontMatter'\n\nexport async function getConfig(): Promise {\n const settings = DataStore.settings\n const config = {\n favoriteIcon: getFavoriteDefault(),\n position: 'prepend',\n favoriteIdentifier: settings.favoriteIdentifier || 'Star or Frontmatter (either)',\n favoriteKey: settings.favoriteKey || 'favorite',\n }\n if (!settings.favoriteIdentifier) {\n config.favoriteIdentifier = 'Star or Frontmatter (either)'\n }\n // test favoriteKey according to: \"description\": \"If you set the favorite notes identifer to any setting which includes frontmatter, this setting allows you to change the name of the frontmatter key used for the favorite field. Default is 'favorite' but you can change it to 'favourite' or 'fav' or whatever you want. Note: cannot include spaces, tabs, or special characters (e.g. #, @ etc.) in the key name.\"\n if (config.favoriteIdentifier.includes('Frontmatter')) {\n if (!config.favoriteKey || [' ', '\\t', '#', '@'].some((char) => config.favoriteKey.includes(char))) {\n const originalKey = config.favoriteKey\n config.favoriteKey = 'favorite'\n DataStore.settings = { ...DataStore.settings, ...config }\n await showMessage(\n `Your Favorite key is set to \"${originalKey}\". The favorite key cannot include spaces, tabs, or special characters (e.g. #, @ etc.) in the key name. Resetting to default 'favorite'.`,\n )\n }\n }\n logDebug('NPFavorites', `Config: ${JSON.stringify(config)}`)\n return config\n}\n\n/**\n * Set the current note as a favorite based on the favoriteIdentifier setting\n * @returns {Promise}\n */\nexport async function setFavorite(): Promise {\n const config = await getConfig()\n const { favoriteKey } = config\n const note = Editor\n if (note && note.title && note.type === 'Notes') {\n const isFavorite = noteIsFavorite(note, config)\n if (isFavorite) {\n await showMessage(`This file is already a Favorite! Use /unfave to remove.`)\n return\n } else {\n let newTitle = note.title\n if (config.favoriteIdentifier.includes('Star')) {\n newTitle = await getFavoritedTitle(note.title || '', config.position, config.favoriteIcon, config.favoriteIdentifier)\n logDebug('NPFavorites', `[${config.favoriteIdentifier}] Setting title to ${newTitle}`)\n setTitle(note, newTitle)\n }\n if (config.favoriteIdentifier.includes('Frontmatter')) {\n logDebug('NPFavorites', `[${config.favoriteIdentifier}] Setting frontmatter ${favoriteKey} to true`)\n ensureFrontmatter(note)\n // In case frontmatter was just added, we need to re-open the note to properly see the frontmatter in the properties and the Editor.frontmatterAttributes\n await Editor.openNoteByFilename(Editor.filename)\n const fm = getFrontmatterAttributes(note)\n if (typeof fm === 'object' && fm !== null) {\n fm[favoriteKey] = 'true'\n updateFrontMatterVars(note, fm)\n }\n }\n }\n } else {\n await showMessage('Please select a Project Note in Editor first.')\n }\n}\n\nexport async function openFavorite(): Promise {\n const config = await getConfig()\n const notesWithFM = getFrontmatterNotes() // not including template notes\n const notesWithStars = DataStore.projectNotes.filter((note) => note.title?.includes(config.favoriteIcon))\n const combinedNotes = [...notesWithFM, ...notesWithStars]\n const nonDuplicateNotes = combinedNotes.filter((note, index, self) => self.findIndex((t) => t.filename === note.filename) === index)\n const faveNotes = favoriteNotes(nonDuplicateNotes, config)\n\n const faveOptions = getFaveOptionsArray(faveNotes)\n if (faveOptions.length === 0) {\n showMessage(`No favorites found matching your setting which requires: \"${config.favoriteIdentifier}\"! Use the /fave document command to set a favorite.`)\n } else {\n const filenameChosen = await chooseOption('Choose a Favorite (⭐️) Document:', faveOptions, '')\n if (filenameChosen) {\n await Editor.openNoteByFilename(filenameChosen)\n }\n }\n}\n\n/**\n * Remove the favorite status from the current note based on the favoriteIdentifier setting\n * @returns {Promise}\n */\nexport async function removeFavorite(): Promise {\n try {\n const config = await getConfig()\n const { favoriteKey } = config\n const note = Editor\n logDebug('NPFavorites', `Removing favorite from note \"${note?.title || ''}\" ${note?.type || ''}`)\n if (note && note.title && note.type === 'Notes') {\n const isFavorite = noteIsFavorite(note, config)\n logDebug('NPFavorites', `Removing favorite from note \"${note.title || ''}\" ${isFavorite ? 'isFavorite' : 'is not a favorite'}`)\n if (isFavorite && note.title) {\n if (config.favoriteIdentifier.includes('Star')) {\n // remove the favorite icon\n const newTitle = removeFavoriteFromTitle(note.title || '', config.favoriteIcon, config.favoriteIdentifier)\n if (newTitle !== note.title) {\n setTitle(note, newTitle)\n }\n }\n if (config.favoriteIdentifier.includes('Frontmatter')) {\n const fm = { ...getFrontmatterAttributes(note) }\n if (typeof fm === 'object' && fm !== null && fm[favoriteKey]) {\n delete fm[favoriteKey]\n updateFrontMatterVars(note, fm, true)\n }\n }\n } else {\n await showMessage(`This file is not a Favorite! Use /fave to make it one.`)\n }\n } else {\n await showMessage('Please select a Project Note in Editor first.')\n }\n } catch (err) {\n logError('NPFavorites/removeFavorite()', JSP(err))\n }\n}\n" }, { "path": "dwertheimer.Favorites/src/components/AppContext.jsx", "content": "// This is a context provider for the app. You should generally not need to edit this file.\n// It provides a way to pass functions and data to any component that needs it\n// without having to pass from parent to child to grandchild etc.\n// including reading and saving reactSettings local to the react window\n//\n// Any React component that needs access to the AppContext can use the useAppContext hook with these 2 lines\n// import { useAppContext } from './AppContext.jsx'\n// ...\n// const {sendActionToPlugin, sendToPlugin, dispatch, pluginData, reactSettings, updateReactSettings} = useAppContext() // MUST BE inside the React component/function code, cannot be at the top of a file\n\n// @flow\nimport React, { createContext, useContext, useMemo, type Node } from 'react'\n\n/**\n * Type definitions for the application context.\n */\nexport type AppContextType = {\n sendActionToPlugin: (command: string, dataToSend: any) => void, // The main one to use to send actions to the plugin, saves scroll position\n sendToPlugin: (command: string, dataToSend: any) => void, // Sends to plugin without saving scroll position\n requestFromPlugin: (command: string, dataToSend: any, timeout?: number) => Promise, // Request/response pattern - returns a Promise\n dispatch: (command: string, dataToSend: any, message?: string) => void, // Used mainly for showing banner at top of page to user\n pluginData: Object, // The data that was sent from the plugin in the field \"pluginData\"\n reactSettings: Object, // Dynamic key-value pair for reactSettings local to the react window (e.g. filterPriorityItems)\n setReactSettings: (newSettings: Object) => void, // Update the reactSettings\n updatePluginData: (newData: Object, messageForLog?: string) => void, // Updates the global pluginData, generally not something you should need to do\n}\n\n// Default context value with initial reactSettings and functions.\nconst defaultContextValue: AppContextType = {\n sendActionToPlugin: () => {},\n sendToPlugin: () => {},\n requestFromPlugin: async () => {\n throw new Error('requestFromPlugin not initialized')\n },\n dispatch: () => {},\n pluginData: {},\n reactSettings: {}, // Initial empty reactSettings local\n setReactSettings: () => {}, // Placeholder function, actual implementation below.\n updatePluginData: () => {}, // Placeholder function, actual implementation below.\n}\n\ntype Props = {\n sendActionToPlugin: (command: string, dataToSend: any) => void,\n sendToPlugin: (command: string, dataToSend: any) => void,\n requestFromPlugin: (command: string, dataToSend: any, timeout?: number) => Promise,\n dispatch: (command: string, dataToSend: any, messageForLog?: string) => void,\n pluginData: Object,\n children: Node, // React component children\n updatePluginData: (newData: Object, messageForLog?: string) => void,\n reactSettings: Object,\n setReactSettings: (newSettings: Object) => void,\n}\n\n/**\n * Create the context with the default value.\n */\nconst AppContext = createContext(defaultContextValue)\n\n// Explicitly annotate the return type of AppProvider as a React element\nexport const AppProvider = ({ children, sendActionToPlugin, sendToPlugin, requestFromPlugin, dispatch, pluginData, updatePluginData, reactSettings, setReactSettings }: Props): Node => {\n\n // Memoize the context value to prevent unnecessary re-renders of all consumers\n // This ensures that functions like requestFromPlugin and dispatch maintain stable references\n // Only recreate the context value when the actual props change\n const contextValue: AppContextType = useMemo(() => ({\n sendActionToPlugin,\n sendToPlugin,\n requestFromPlugin,\n dispatch,\n pluginData,\n reactSettings,\n setReactSettings,\n updatePluginData,\n }), [sendActionToPlugin, sendToPlugin, requestFromPlugin, dispatch, pluginData, reactSettings, setReactSettings, updatePluginData])\n\n return {children}\n}\n\n/**\n * Custom hook to use the AppContext.\n * @returns {AppContextType} - The context value.\n */\nexport const useAppContext = (): AppContextType => useContext(AppContext)\n\n" }, { "path": "dwertheimer.Favorites/src/components/FavoritesView.css", "content": "/* FavoritesView Component Styles */\n\n.favorites-view-container {\n display: flex;\n flex-direction: column;\n overflow: hidden;\n background: var(--bg-main-color);\n width: 100%;\n height: 100vh;\n}\n\n.favorites-view-window-header {\n flex-shrink: 0;\n padding: 1rem;\n border-bottom: 1px solid var(--divider-color);\n background: var(--bg-alt-color);\n}\n\n.favorites-view-title {\n margin: 0;\n font-size: 1.25rem;\n font-weight: 600;\n color: var(--fg-main-color);\n}\n\n.favorites-view-header {\n flex-shrink: 0;\n padding: .5rem;\n border-bottom: 1px solid var(--divider-color);\n background: var(--bg-alt-color);\n}\n\n.favorites-view-header-controls {\n display: flex;\n align-items: center;\n gap: 0.75rem;\n width: 100%;\n}\n\n.favorites-view-segmented-control {\n display: inline-flex;\n background: var(--bg-mid-color);\n border-radius: 6px;\n padding: 2px;\n gap: 2px;\n border: 1px solid var(--divider-color);\n flex: 1;\n}\n\n.favorites-segment-button {\n display: flex;\n align-items: center;\n justify-content: center;\n gap: 0.5rem;\n padding: 0.5rem 1rem;\n border: none;\n background: transparent;\n border-radius: 4px;\n cursor: pointer;\n font-size: 0.875rem;\n font-weight: 500;\n color: var(--fg-placeholder-color);\n transition: all 0.2s ease;\n white-space: nowrap;\n user-select: none;\n flex: 1;\n min-width: 0;\n}\n\n.favorites-segment-button:hover {\n background: var(--bg-mid-color);\n color: var(--fg-main-color);\n}\n\n.favorites-segment-button-active {\n background: var(--bg-main-color);\n color: var(--fg-main-color);\n box-shadow: 0 1px 2px color-mix(in oklch, var(--bg-main-color), black 20%);\n font-weight: 600;\n}\n\n.favorites-segment-button-active:hover {\n background: var(--bg-main-color);\n}\n\n.favorites-segment-icon {\n font-size: 0.875rem;\n width: 14px;\n text-align: center;\n font-weight: 600;\n}\n\n.favorites-new-button {\n display: flex;\n align-items: center;\n gap: 0.375rem;\n padding: 0.5rem 0.75rem;\n border: 1px solid var(--divider-color);\n background: var(--bg-main-color);\n border-radius: 6px;\n cursor: pointer;\n font-size: 0.875rem;\n font-weight: 500;\n color: var(--fg-main-color);\n transition: all 0.2s ease;\n white-space: nowrap;\n user-select: none;\n flex-shrink: 0;\n}\n\n.favorites-new-button:hover {\n background: var(--bg-mid-color);\n border-color: var(--divider-color);\n}\n\n.favorites-new-button:active {\n transform: scale(0.98);\n}\n\n.favorites-new-icon {\n font-size: 0.75rem;\n width: 12px;\n text-align: center;\n}\n\n.favorites-item-note,\n.favorites-item-command {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n width: 100%;\n min-width: 0; /* Allow flex items to shrink below content size */\n}\n\n.favorites-item-note.favorites-item-newly-added,\n.favorites-item-command.favorites-item-newly-added {\n background-color: color-mix(in oklch, var(--bg-main-color), var(--tint-color) 20%);\n animation: highlightFade 2s ease-out;\n}\n\n@keyframes highlightFade {\n 0% {\n background-color: color-mix(in oklch, var(--bg-main-color), var(--tint-color) 30%);\n }\n 100% {\n background-color: transparent;\n }\n}\n\n.favorites-item-icon {\n flex-shrink: 0;\n width: 16px;\n text-align: center;\n font-size: 0.9rem;\n}\n\n.favorites-item-content {\n flex: 1;\n min-width: 0;\n display: flex;\n flex-direction: column;\n gap: 0.125rem;\n}\n\n.favorites-item-title {\n font-size: 0.9rem;\n font-weight: 500;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.favorites-item-folder,\n.favorites-item-description {\n font-size: 0.75rem;\n color: var(--fg-placeholder-color);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n/* Unfavorite icon styling */\n.favorites-item-note .favorites-unfavorite-icon {\n margin-left: auto;\n margin-right: 0.25rem;\n flex-shrink: 0;\n}\n\n/* Styles for Add Favorite Note Dialog with Markdown Preview */\n.dynamic-dialog.favorites-note-dialog .dynamic-dialog-content {\n display: flex;\n flex-direction: column;\n height: 100%;\n max-height: 80vh;\n}\n\n.dynamic-dialog.favorites-note-dialog .ui-item[data-settings-key=\"note\"] {\n flex-shrink: 0;\n margin-bottom: 1rem;\n}\n\n.dynamic-dialog.favorites-note-dialog .ui-item[data-settings-key=\"notePreview\"] {\n flex: 1;\n display: flex;\n flex-direction: column;\n min-height: 0;\n}\n\n.dynamic-dialog.favorites-note-dialog .markdown-preview-container {\n flex: 1;\n display: flex;\n flex-direction: column;\n min-height: 0;\n}\n\n.dynamic-dialog.favorites-note-dialog .markdown-preview-content {\n flex: 1;\n min-height: 0;\n max-height: none;\n overflow-y: auto;\n}\n\n\n.favorites-view-container .filterable-list-filter-row {\n background: var(--bg-mid-color);\n}\n" }, { "path": "dwertheimer.Favorites/src/components/FavoritesView.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FavoritesView Component\n// Browse and open favorite notes and commands\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, useRef, useCallback, useMemo, type Node } from 'react'\nimport { AppProvider, useAppContext } from './AppContext.jsx'\nimport { FilterableList } from '@helpers/react/FilterableList'\nimport { type ListItemAction } from '@helpers/react/List'\nimport { logDebug, logError } from '@helpers/react/reactDev.js'\nimport { defaultNoteIconDetails } from '@helpers/NPnote.js'\nimport DynamicDialog from '@helpers/react/DynamicDialog/DynamicDialog'\nimport { type TSettingItem } from '@helpers/react/DynamicDialog/DynamicDialog'\nimport { type NoteOption } from '@helpers/react/DynamicDialog/NoteChooser'\nimport { waitForCondition } from '@helpers/promisePolyfill'\nimport { pluginEnvelopeFromResponsePayload, unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\nimport { InfoIcon } from '@helpers/react/InfoIcon'\nimport IdleTimer from '@helpers/react/IdleTimer'\nimport './FavoritesView.css'\n\n// Idle timeout: reset to notes view and focus filter after 1 minute of inactivity\nconst IDLE_TIMEOUT_MS = 60000 // 1 minute\n\ntype FavoriteNote = {\n filename: string,\n title: string,\n type: string,\n frontmatterAttributes?: Object,\n icon?: string,\n color?: string,\n folder?: string,\n}\n\ntype FavoriteCommand = {\n name: string,\n description?: string,\n jsFunction: string,\n data?: string,\n}\n\ntype FavoritesViewProps = {\n data: any,\n dispatch: Function,\n reactSettings: any,\n setReactSettings: Function,\n onSubmitOrCancelCallFunctionNamed: string,\n}\n\n/**\n * FavoritesView Component\n * @param {FavoritesViewProps} props\n * @returns {React$Node}\n */\nfunction FavoritesViewComponent({\n data,\n dispatch,\n reactSettings,\n setReactSettings,\n onSubmitOrCancelCallFunctionNamed: _onSubmitOrCancelCallFunctionNamed,\n}: FavoritesViewProps): Node {\n const { pluginData } = data\n\n // Map to store pending requests for request/response pattern\n const pendingRequestsRef = useRef void, reject: (error: Error) => void, timeoutId: any }>>(new Map())\n\n // Store windowId in a ref\n const windowIdRef = useRef(pluginData?.windowId || 'favorites-browser-window')\n\n // Update windowId ref when pluginData changes\n useEffect(() => {\n windowIdRef.current = pluginData?.windowId || 'favorites-browser-window'\n }, [pluginData?.windowId])\n\n // State\n const [favoriteNotes, setFavoriteNotes] = useState>([])\n const [favoriteCommands, setFavoriteCommands] = useState>([])\n const [loading, setLoading] = useState(true)\n const [filterText, setFilterText] = useState('')\n const [selectedIndex, setSelectedIndex] = useState(null)\n const [showNotes, setShowNotes] = useState(reactSettings?.showNotes !== false) // Default to notes\n const [projectNotes, setProjectNotes] = useState>([])\n const [presetCommands, setPresetCommands] = useState>([])\n const [showAddNoteDialog, setShowAddNoteDialog] = useState(false)\n const [showAddCommandDialog, setShowAddCommandDialog] = useState(false)\n const [addNoteDialogData, setAddNoteDialogData] = useState<{ [key: string]: any }>({})\n const [addCommandDialogData, setAddCommandDialogData] = useState<{ [key: string]: any }>({})\n const [newlyAddedFilename, setNewlyAddedFilename] = useState(null) // Track newly added item for highlighting\n const listRef = useRef(null) // Ref for scrolling to items\n const filterInputRef = useRef(null) // Ref for the filter input field\n\n // Request function\n const requestFromPlugin = useCallback(\n (command: string, dataToSend: any = {}, timeout: number = 10000): Promise => {\n if (!command) throw new Error('requestFromPlugin: command must be called with a string')\n\n const correlationId = `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n logDebug('FavoritesView', `requestFromPlugin: command=\"${command}\", correlationId=\"${correlationId}\"`)\n\n return new Promise((resolve, reject) => {\n const timeoutId = setTimeout(() => {\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n pendingRequestsRef.current.delete(correlationId)\n logDebug('FavoritesView', `requestFromPlugin TIMEOUT: command=\"${command}\", correlationId=\"${correlationId}\"`)\n reject(new Error(`Request timeout: ${command}`))\n }\n }, timeout)\n\n pendingRequestsRef.current.set(correlationId, { resolve, reject, timeoutId })\n\n const requestData = {\n ...dataToSend,\n __correlationId: correlationId,\n __requestType: 'REQUEST',\n __windowId: windowIdRef.current || '',\n }\n\n dispatch('SEND_TO_PLUGIN', [command, requestData], `FavoritesView: requestFromPlugin: ${String(command)}`)\n })\n .then((result) => {\n logDebug('FavoritesView', `requestFromPlugin RESOLVED: command=\"${command}\", correlationId=\"${correlationId}\"`)\n return result\n })\n .catch((error) => {\n logError('FavoritesView', `requestFromPlugin REJECTED: command=\"${command}\", correlationId=\"${correlationId}\", error=\"${error.message}\"`)\n throw error\n })\n },\n [dispatch],\n )\n\n // Listen for RESPONSE messages\n useEffect(() => {\n const handleResponse = (event: MessageEvent) => {\n const { data: eventData } = event\n if (eventData && typeof eventData === 'object' && eventData.type === 'RESPONSE' && eventData.payload) {\n const payload = eventData.payload\n if (payload && typeof payload === 'object') {\n const correlationId = (payload: any).correlationId\n if (correlationId && typeof correlationId === 'string') {\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n pendingRequestsRef.current.delete(correlationId)\n clearTimeout(pending.timeoutId)\n pending.resolve(pluginEnvelopeFromResponsePayload(payload))\n }\n }\n }\n }\n }\n\n window.addEventListener('message', handleResponse)\n return () => {\n window.removeEventListener('message', handleResponse)\n pendingRequestsRef.current.forEach((pending) => {\n clearTimeout(pending.timeoutId)\n })\n pendingRequestsRef.current.clear()\n }\n }, [])\n\n // Load favorite notes\n const loadFavoriteNotes = useCallback(async () => {\n try {\n setLoading(true)\n const notes = unwrapPluginRequestData(await requestFromPlugin('getFavoriteNotes'))\n if (Array.isArray(notes)) {\n setFavoriteNotes(notes)\n logDebug('FavoritesView', `Loaded ${notes.length} favorite notes`)\n }\n } catch (error) {\n logError('FavoritesView', `Error loading favorite notes: ${error.message}`)\n } finally {\n setLoading(false)\n }\n }, [requestFromPlugin])\n\n // Effect to scroll to and highlight newly added item\n useEffect(() => {\n if (newlyAddedFilename && favoriteNotes.length > 0 && listRef.current) {\n // Find the index of the newly added item\n const newIndex = favoriteNotes.findIndex((note) => note.filename === newlyAddedFilename)\n if (newIndex >= 0) {\n // Wait a bit for DOM to update, then scroll to the item\n setTimeout(() => {\n const item = listRef.current?.querySelector(`[data-index=\"${newIndex}\"]`)\n if (item instanceof HTMLElement) {\n item.scrollIntoView({ block: 'nearest', behavior: 'smooth' })\n // Remove highlight after animation completes (2 seconds)\n setTimeout(() => {\n setNewlyAddedFilename(null)\n }, 2000)\n }\n }, 100)\n }\n }\n }, [newlyAddedFilename, favoriteNotes])\n\n // Load favorite commands\n const loadFavoriteCommands = useCallback(async () => {\n try {\n setLoading(true)\n const commands = unwrapPluginRequestData(await requestFromPlugin('getFavoriteCommands'))\n if (Array.isArray(commands)) {\n setFavoriteCommands(commands)\n logDebug('FavoritesView', `Loaded ${commands.length} favorite commands`)\n }\n } catch (error) {\n logError('FavoritesView', `Error loading favorite commands: ${error.message}`)\n } finally {\n setLoading(false)\n }\n }, [requestFromPlugin])\n\n // Load data when view type changes\n useEffect(() => {\n if (showNotes) {\n loadFavoriteNotes()\n } else {\n loadFavoriteCommands()\n }\n }, [showNotes, loadFavoriteNotes, loadFavoriteCommands])\n\n // Load project notes for NoteChooser\n const loadProjectNotes = useCallback(async () => {\n try {\n const notes = unwrapPluginRequestData(await requestFromPlugin('getProjectNotes'))\n if (Array.isArray(notes)) {\n setProjectNotes(notes)\n logDebug('FavoritesView', `Loaded ${notes.length} project notes`)\n }\n } catch (error) {\n logError('FavoritesView', `Error loading project notes: ${error.message}`)\n }\n }, [requestFromPlugin])\n\n // Load preset commands for command dialog\n const loadPresetCommands = useCallback(async () => {\n try {\n const commands = unwrapPluginRequestData(await requestFromPlugin('getPresetCommands'))\n if (Array.isArray(commands)) {\n setPresetCommands(commands)\n logDebug('FavoritesView', `Loaded ${commands.length} preset commands`)\n }\n } catch (error) {\n logError('FavoritesView', `Error loading preset commands: ${error.message}`)\n }\n }, [requestFromPlugin])\n\n // Handle adding favorite note dialog\n const handleAddNoteDialogSave = useCallback(\n async (updatedSettings: { [key: string]: any }) => {\n try {\n if (updatedSettings.note) {\n const filename = updatedSettings.note\n\n // Close dialog immediately\n setShowAddNoteDialog(false)\n setAddNoteDialogData({})\n\n unwrapPluginRequestData(await requestFromPlugin('addFavoriteNote', { filename }))\n logDebug('FavoritesView', `addFavoriteNote: success`)\n\n // Show success toast\n dispatch('SHOW_TOAST', {\n type: 'SUCCESS',\n msg: 'Favorite note added successfully',\n timeout: 3000,\n })\n\n // Reload the favorites list first\n await loadFavoriteNotes()\n\n // Wait for the note to appear in the list by checking the actual list data\n // We need to reload and check, since state updates are async\n const found = await waitForCondition(\n async () => {\n // Reload notes to get fresh data, then check\n if (showNotes) {\n const notes = unwrapPluginRequestData(await requestFromPlugin('getFavoriteNotes'))\n if (Array.isArray(notes)) {\n return notes.some((note) => note.filename === filename)\n }\n }\n return false\n },\n { maxWaitMs: 3000, checkIntervalMs: 150 },\n )\n\n // Reload one more time to ensure UI is in sync\n await loadFavoriteNotes()\n\n // Set the newly added filename for highlighting (useEffect will handle scrolling)\n setNewlyAddedFilename(filename)\n\n if (found) {\n logDebug('FavoritesView', 'Successfully added favorite note and found it in list')\n } else {\n logError('FavoritesView', 'Added favorite note but could not find it in list after waiting')\n }\n }\n } catch (error) {\n logError('FavoritesView', `Error adding favorite note: ${error.message}`)\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: `Error adding favorite: ${error.message}`,\n timeout: 3000,\n })\n }\n },\n [requestFromPlugin, loadFavoriteNotes, dispatch, showNotes, favoriteNotes],\n )\n\n const handleAddNoteDialogCancel = useCallback(() => {\n setShowAddNoteDialog(false)\n setAddNoteDialogData({})\n }, [])\n\n const handleAddFavoriteNote = useCallback(async () => {\n // Load notes if not already loaded\n if (projectNotes.length === 0) {\n await loadProjectNotes()\n }\n setShowAddNoteDialog(true)\n }, [projectNotes, loadProjectNotes])\n\n // Handle adding favorite command dialog\n const handleAddCommandDialogSave = useCallback(\n async (updatedSettings: { [key: string]: any }) => {\n try {\n if (updatedSettings.preset && updatedSettings.commandName && updatedSettings.url) {\n unwrapPluginRequestData(\n await requestFromPlugin('addFavoriteCommand', {\n jsFunction: updatedSettings.preset,\n name: updatedSettings.commandName,\n data: updatedSettings.url,\n }),\n )\n await loadFavoriteCommands()\n setShowAddCommandDialog(false)\n setAddCommandDialogData({})\n logDebug('FavoritesView', 'Successfully added favorite command')\n }\n } catch (error) {\n logError('FavoritesView', `Error adding favorite command: ${error.message}`)\n }\n },\n [requestFromPlugin, loadFavoriteCommands],\n )\n\n const handleAddCommandDialogCancel = useCallback(() => {\n setShowAddCommandDialog(false)\n setAddCommandDialogData({})\n }, [])\n\n const handleAddCommandButtonClick = useCallback(\n async (key: string, value: string) => {\n if (key === 'getCallbackURL') {\n try {\n const envelope = await requestFromPlugin('getCallbackURL', {})\n const url =\n envelope.success && envelope.data && typeof envelope.data === 'object' && typeof envelope.data.url === 'string' ? envelope.data.url : null\n if (url) {\n setAddCommandDialogData((prev) => ({ ...prev, url }))\n logDebug('FavoritesView', `Got URL from Link Creator: ${url}`)\n }\n } catch (error) {\n logError('FavoritesView', `Error getting callback URL: ${error.message}`)\n }\n return false // Don't close dialog\n }\n },\n [requestFromPlugin],\n )\n\n const handleAddFavoriteCommand = useCallback(async () => {\n // Load preset commands if not already loaded\n if (presetCommands.length === 0) {\n await loadPresetCommands()\n }\n\n if (presetCommands.length === 0) {\n logError('FavoritesView', 'No preset commands available')\n return\n }\n\n setShowAddCommandDialog(true)\n }, [presetCommands, loadPresetCommands])\n\n // Handle item click\n // Note: __windowId is automatically injected by Root.jsx sendToPlugin, so we don't need to add it here\n const handleItemClick = useCallback(\n (item: FavoriteNote | FavoriteCommand, event: MouseEvent) => {\n const isOptionClick = event.altKey || (event.metaKey === false && event.ctrlKey) // Alt key (option on Mac)\n const isCmdClick = event.metaKey || event.ctrlKey // Cmd key (meta on Mac, ctrl on Windows)\n\n if (showNotes) {\n // $FlowFixMe[incompatible-cast] - item is FavoriteNote when showNotes is true\n const note: FavoriteNote = (item: any)\n // Send action to plugin to open note\n dispatch(\n 'SEND_TO_PLUGIN',\n [\n 'openNote',\n {\n filename: note.filename,\n newWindow: isCmdClick, // Cmd-click opens in floating window\n splitView: isOptionClick, // Option-click opens in split view\n },\n ],\n 'FavoritesView: openNote',\n )\n } else {\n // $FlowFixMe[incompatible-cast] - item is FavoriteCommand when showNotes is false\n const command: FavoriteCommand = (item: any)\n // Send action to plugin to run command\n dispatch(\n 'SEND_TO_PLUGIN',\n [\n 'runCommand',\n {\n jsFunction: command.jsFunction,\n data: command.data,\n },\n ],\n 'FavoritesView: runCommand',\n )\n }\n },\n [showNotes, dispatch],\n )\n\n // Get current items based on view type\n const currentItems = useMemo(() => {\n return showNotes ? favoriteNotes : favoriteCommands\n }, [showNotes, favoriteNotes, favoriteCommands])\n\n // Handle removing favorite note\n const handleRemoveFavorite = useCallback(\n async (filename: string) => {\n try {\n unwrapPluginRequestData(await requestFromPlugin('removeFavoriteNote', { filename }))\n // Show toast notification\n dispatch('SHOW_TOAST', {\n type: 'SUCCESS',\n msg: 'Favorite note removed',\n timeout: 2000,\n })\n // Reload the favorites list\n await loadFavoriteNotes()\n } catch (error) {\n logError('FavoritesView', `Error removing favorite note: ${error.message}`)\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: `Error removing favorite: ${error.message}`,\n timeout: 3000,\n })\n }\n },\n [requestFromPlugin, loadFavoriteNotes, dispatch],\n )\n\n // Handle idle timeout: reset to notes view and focus filter\n const handleIdleTimeout = useCallback(() => {\n setShowNotes(true)\n setFilterText('')\n setSelectedIndex(null)\n // Scroll list to top and focus the filter input after a brief delay to ensure it's rendered\n setTimeout(() => {\n // Get toolbar height offset (same calculation as Toast.css: calc(1rem + var(--noteplan-toolbar-height, 0px)))\n const root = document.documentElement\n if (!root) return\n\n const toolbarHeight = parseInt(getComputedStyle(root).getPropertyValue('--noteplan-toolbar-height') || '0', 10)\n const oneRem = parseFloat(getComputedStyle(root).fontSize || '16px')\n const scrollOffset = oneRem + toolbarHeight\n\n // Helper function to find scrollable ancestor\n const findScrollableAncestor = (el: HTMLElement): ?HTMLElement => {\n let parent: ?Element = el.parentElement\n while (parent) {\n if (parent instanceof HTMLElement) {\n const style = getComputedStyle(parent)\n if (style.overflow === 'auto' || style.overflow === 'scroll' || style.overflowY === 'auto' || style.overflowY === 'scroll') {\n return parent\n }\n }\n parent = parent.parentElement\n }\n return null\n }\n\n // Scroll list to top\n if (listRef.current) {\n const firstItem = listRef.current.querySelector('[data-index=\"0\"]')\n if (firstItem instanceof HTMLElement) {\n // Use scrollIntoView with offset by scrolling the parent container\n const scrollableParent = findScrollableAncestor(firstItem)\n if (scrollableParent) {\n const itemRect = firstItem.getBoundingClientRect()\n const parentRect = scrollableParent.getBoundingClientRect()\n const currentScrollTop = scrollableParent.scrollTop\n const targetScrollTop = currentScrollTop + (itemRect.top - parentRect.top) - scrollOffset\n scrollableParent.scrollTop = Math.max(0, targetScrollTop)\n } else {\n firstItem.scrollIntoView({ block: 'start', behavior: 'instant' })\n }\n } else if (listRef.current instanceof HTMLElement) {\n // If no items, try scrolling the container itself with offset\n const scrollableParent = listRef.current.parentElement?.parentElement\n if (scrollableParent instanceof HTMLElement && scrollableParent.scrollTop !== undefined) {\n scrollableParent.scrollTop = scrollOffset\n }\n }\n }\n // Focus the filter input\n if (filterInputRef.current) {\n filterInputRef.current.focus()\n }\n }, 0)\n }, [])\n\n // Render note item\n const renderNoteItem = useCallback(\n (item: any, index: number): Node => {\n // $FlowFixMe[incompatible-cast] - item is FavoriteNote when showNotes is true\n const note: FavoriteNote = item\n const folder = note.folder || ''\n const folderDisplay = folder && folder !== '/' ? `${folder} / ` : ''\n const displayTitle = note.title || note.filename || 'Untitled'\n\n // Always show an icon - use note icon if provided, otherwise use default\n const icon = note.icon || defaultNoteIconDetails.icon\n const color = note.color || defaultNoteIconDetails.color\n const isNewlyAdded = newlyAddedFilename === note.filename\n\n return (\n
\n \n
\n
{displayTitle}
\n {folder && folder !== '/' &&
{folderDisplay}
}\n
\n {\n e.preventDefault()\n e.stopPropagation()\n handleRemoveFavorite(note.filename)\n }}\n />\n
\n )\n },\n [newlyAddedFilename, handleRemoveFavorite],\n )\n\n // Render command item\n const renderCommandItem = useCallback((item: any, index: number): Node => {\n // $FlowFixMe[incompatible-cast] - item is FavoriteCommand when showNotes is false\n const command: FavoriteCommand = item\n return (\n
\n \n
\n
{command.name}
\n {command.description &&
{command.description}
}\n
\n
\n )\n }, [])\n\n // Filter function for notes\n const filterNote = useCallback((item: any, text: string): boolean => {\n if (!text) return true\n // $FlowFixMe[incompatible-cast] - item is FavoriteNote when showNotes is true\n const note: FavoriteNote = item\n const searchText = text.toLowerCase()\n const title = (note.title || '').toLowerCase()\n const folder = (note.folder || '').toLowerCase()\n return title.includes(searchText) || folder.includes(searchText)\n }, [])\n\n // Filter function for commands\n const filterCommand = useCallback((item: any, text: string): boolean => {\n if (!text) return true\n // $FlowFixMe[incompatible-cast] - item is FavoriteCommand when showNotes is false\n const command: FavoriteCommand = item\n const searchText = text.toLowerCase()\n const name = (command.name || '').toLowerCase()\n const description = (command.description || '').toLowerCase()\n return name.includes(searchText) || description.includes(searchText)\n }, [])\n\n // Get item label for filtering\n const getItemLabel = useCallback(\n (item: any): string => {\n if (showNotes) {\n // $FlowFixMe[incompatible-cast] - item is FavoriteNote when showNotes is true\n const note: FavoriteNote = item\n return note.title || note.filename || ''\n } else {\n // $FlowFixMe[incompatible-cast] - item is FavoriteCommand when showNotes is false\n const command: FavoriteCommand = item\n return command.name || ''\n }\n },\n [showNotes],\n )\n\n // Handle toggle change\n const handleToggleChange = useCallback(\n (newShowNotes: boolean) => {\n setShowNotes(newShowNotes)\n setReactSettings((prev: any) => ({ ...prev, showNotes: newShowNotes }))\n setFilterText('') // Clear filter when switching\n setSelectedIndex(null) // Reset selection\n },\n [setReactSettings],\n )\n\n // Handle keyboard navigation\n // Arrow keys only navigate (change selectedIndex) - they do NOT trigger actions\n // Click and Enter trigger actions (run command or open note)\n const handleKeyDown = useCallback(\n (event: KeyboardEvent) => {\n if (event.key === 'ArrowDown') {\n event.preventDefault()\n // Arrow navigation only - no action triggered\n const newIndex = selectedIndex === null || selectedIndex === undefined ? 0 : selectedIndex + 1\n if (newIndex < currentItems.length) {\n setSelectedIndex(newIndex)\n // Scroll into view\n setTimeout(() => {\n if (listRef.current) {\n const item = listRef.current.querySelector(`[data-index=\"${newIndex}\"]`)\n if (item instanceof HTMLElement) {\n item.scrollIntoView({ block: 'nearest', behavior: 'smooth' })\n item.focus()\n }\n }\n }, 0)\n }\n } else if (event.key === 'ArrowUp') {\n event.preventDefault()\n // Arrow navigation only - no action triggered\n if (selectedIndex !== null && selectedIndex !== undefined && selectedIndex > 0) {\n const newIndex = selectedIndex - 1\n setSelectedIndex(newIndex)\n // Scroll into view\n setTimeout(() => {\n if (listRef.current) {\n const item = listRef.current.querySelector(`[data-index=\"${newIndex}\"]`)\n if (item instanceof HTMLElement) {\n item.scrollIntoView({ block: 'nearest', behavior: 'smooth' })\n item.focus()\n }\n }\n }, 0)\n }\n } else if (event.key === 'Enter' && selectedIndex !== null && selectedIndex !== undefined && selectedIndex >= 0 && selectedIndex < currentItems.length) {\n event.preventDefault()\n // Enter key triggers the action (run command via x-callback URL or open note)\n const item = currentItems[selectedIndex]\n if (item) {\n handleItemClick(item, (event: any))\n }\n }\n },\n [currentItems, selectedIndex, handleItemClick],\n )\n\n // Handle filter input keydown\n const handleFilterKeyDown = useCallback(\n (e: any) => {\n // SyntheticKeyboardEvent\n if (e.key === 'ArrowDown' && currentItems.length > 0) {\n e.preventDefault()\n setSelectedIndex(0)\n // Focus the list with setTimeout to ensure DOM is updated\n setTimeout(() => {\n if (listRef.current) {\n const firstItem = listRef.current.querySelector('[data-index=\"0\"]')\n if (firstItem instanceof HTMLElement) {\n firstItem.focus()\n }\n }\n }, 0)\n } else if (e.key === 'Tab' && !e.shiftKey && currentItems.length > 0) {\n e.preventDefault()\n setSelectedIndex(0)\n setTimeout(() => {\n if (listRef.current) {\n const firstItem = listRef.current.querySelector('[data-index=\"0\"]')\n if (firstItem instanceof HTMLElement) {\n firstItem.focus()\n }\n }\n }, 0)\n } else {\n // Pass other keys to handleKeyDown\n handleKeyDown(e.nativeEvent)\n }\n },\n [currentItems.length, handleKeyDown],\n )\n\n return (\n
\n {/* Header - only show if floating window */}\n {pluginData?.showFloating && (\n
\n

Favorites

\n
\n )}\n
\n
\n
\n handleToggleChange(true)}\n aria-pressed={showNotes}\n >\n \n Notes\n \n handleToggleChange(false)}\n aria-pressed={!showNotes}\n >\n \n Commands\n \n
\n {\n if (showNotes) {\n handleAddFavoriteNote()\n } else {\n handleAddFavoriteCommand()\n }\n }}\n title={showNotes ? 'Add new favorite note' : 'Add new favorite command'}\n >\n \n New\n \n
\n
\n \n \n\n {/* Add Favorite Note Dialog */}\n {\n loadProjectNotes().catch((error) => {\n logError('FavoritesView', `Error reloading notes: ${error.message}`)\n })\n }}\n />\n\n {/* Add Favorite Command Dialog */}\n ({ label: cmd.label, value: cmd.value, isDefault: false })),\n required: true,\n },\n {\n type: 'input',\n key: 'commandName',\n label: 'Command Name',\n description: 'What human-readable text do you want to use for the command? (this is the text you will see in the Command Bar when you type slash)',\n placeholder: 'Enter command name',\n required: true,\n },\n {\n type: 'input',\n key: 'url',\n label: 'X-Callback URL or Web URL',\n description: 'Enter the X-Callback URL or Web URL to run when this command is selected',\n placeholder: 'noteplan://x-callback-url/... or https://...',\n required: true,\n value: addCommandDialogData.url || '',\n },\n {\n type: 'button',\n key: 'getCallbackURL',\n label: 'Use Link Creator',\n buttonText: 'Get X-Callback URL from Link Creator',\n },\n ]}\n onSave={handleAddCommandDialogSave}\n onCancel={handleAddCommandDialogCancel}\n isModal={true}\n handleButtonClick={handleAddCommandButtonClick}\n />\n
\n )\n}\n\n/**\n * Root FavoritesView Component with AppProvider\n */\nexport function FavoritesView({ data, dispatch, reactSettings, setReactSettings, onSubmitOrCancelCallFunctionNamed }: FavoritesViewProps): Node {\n // Map to store pending requests\n const pendingRequestsRef = useRef void, reject: (error: Error) => void, timeoutId: any }>>(new Map())\n\n const { pluginData } = data\n const windowIdRef = useRef(pluginData?.windowId || 'favorites-browser-window')\n\n useEffect(() => {\n windowIdRef.current = pluginData?.windowId || 'favorites-browser-window'\n }, [pluginData?.windowId])\n\n // Request function for AppContext\n const requestFromPlugin = useCallback(\n (command: string, dataToSend: any = {}, timeout: number = 10000): Promise => {\n if (!command) throw new Error('requestFromPlugin: command must be called with a string')\n\n const correlationId = `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n\n return new Promise((resolve, reject) => {\n const timeoutId = setTimeout(() => {\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n pendingRequestsRef.current.delete(correlationId)\n reject(new Error(`Request timeout: ${command}`))\n }\n }, timeout)\n\n pendingRequestsRef.current.set(correlationId, { resolve, reject, timeoutId })\n\n const requestData = {\n ...dataToSend,\n __correlationId: correlationId,\n __requestType: 'REQUEST',\n __windowId: windowIdRef.current || '',\n }\n\n dispatch('SEND_TO_PLUGIN', [command, requestData], `FavoritesView: requestFromPlugin: ${String(command)}`)\n })\n },\n [dispatch],\n )\n\n // Listen for RESPONSE messages\n useEffect(() => {\n const handleResponse = (event: MessageEvent) => {\n const { data: eventData } = event\n if (eventData && typeof eventData === 'object' && eventData.type === 'RESPONSE' && eventData.payload) {\n const payload = eventData.payload\n if (payload && typeof payload === 'object') {\n const correlationId = (payload: any).correlationId\n if (correlationId && typeof correlationId === 'string') {\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n pendingRequestsRef.current.delete(correlationId)\n clearTimeout(pending.timeoutId)\n pending.resolve(pluginEnvelopeFromResponsePayload(payload))\n }\n }\n }\n }\n }\n\n window.addEventListener('message', handleResponse)\n return () => {\n window.removeEventListener('message', handleResponse)\n pendingRequestsRef.current.forEach((pending) => {\n clearTimeout(pending.timeoutId)\n })\n pendingRequestsRef.current.clear()\n }\n }, [])\n\n const sendActionToPlugin = useCallback(\n (command: string, dataToSend: any) => {\n dispatch('SEND_TO_PLUGIN', [command, dataToSend], `FavoritesView: sendActionToPlugin: ${String(command)}`)\n },\n [dispatch],\n )\n\n const sendToPlugin = useCallback(\n (command: string, dataToSend: any) => {\n dispatch('SEND_TO_PLUGIN', [command, dataToSend], `FavoritesView: sendToPlugin: ${String(command)}`)\n },\n [dispatch],\n )\n\n const updatePluginData = useCallback(\n (newData: any, messageForLog?: string) => {\n const newFullData = { ...data, pluginData: newData }\n dispatch('UPDATE_DATA', newFullData, messageForLog)\n },\n [data, dispatch],\n )\n\n return (\n \n \n \n )\n}\n" }, { "path": "dwertheimer.Favorites/src/favorites.js", "content": "// @flow\n\nimport { noteHasFrontMatter } from '@helpers/NPFrontMatter'\nimport { logDebug, timer } from '@helpers/dev'\nexport type FavoritesConfig = {\n favoriteIcon: string,\n position: 'prepend' | 'append',\n favoriteIdentifier: 'Star in title' | 'Frontmatter only' | 'Star and Frontmatter (both)' | 'Star or Frontmatter (either)',\n favoriteKey: string,\n}\n\n/**\n * Get the default favorite icon\n * @returns {string} The default favorite icon\n */\nexport const getFavoriteDefault = (): string => '⭐️'\n\n/**\n * Filter notes to only include favorites based on the configuration\n * @param {Array} notes - The notes to filter\n * @param {FavoritesConfig} config - The configuration for the favorites plugin\n * @returns {Array} The filtered favorite notes\n */\nexport const favoriteNotes = (notes: $ReadOnlyArray, config: FavoritesConfig): $ReadOnlyArray => {\n const startTime = new Date()\n const filteredNotes = notes.filter((n) => noteIsFavorite(n, config))\n logDebug('favoriteNotes', `Reduced ${notes.length} notes to ${filteredNotes.length} favorites in ${timer(startTime)}`)\n return filteredNotes\n}\n\n/**\n * Get an array of favorite note options for selection\n * @param {Array} notes - The notes to convert to options\n * @returns {Array<{ label: string, value: string }>} The array of options\n */\nexport const getFaveOptionsArray = (notes: $ReadOnlyArray): $ReadOnlyArray<{ label: string, value: string }> =>\n notes\n .filter((n) => Boolean(n.title && n.filename))\n .map((n) => {\n // $FlowIgnore\n return { label: n.title, value: n.filename }\n })\n\n/**\n * Check if a title contains the favorite icon\n * @param {string} title - The title to check\n * @param {string} icon - The favorite icon to look for\n * @returns {boolean} True if the title contains the icon, false otherwise\n */\nexport const titleHasFavoriteIcon = (title: string, icon: string): boolean => title.search(icon) !== -1\n\n/**\n * Get a new title with the favorite icon added\n * @param {string} title - The original title\n * @param {string} position - The position to add the icon ('prepend' or 'append')\n * @param {string} icon - The favorite icon to add\n * @param {string} favoriteIdentifier - The favorite identifier setting\n * @returns {string} The new title with the favorite icon\n */\nexport const getFavoritedTitle = (title: string, position: string, icon: string, favoriteIdentifier: string): string => {\n return favoriteIdentifier.includes('Star') ? (position === 'prepend' ? `${icon} ${title}` : `${title} ${icon}`) : title\n}\n\n/**\n * Remove the favorite icon from a title\n * @param {string} title - The title to modify\n * @param {string} icon - The favorite icon to remove\n * @param {string} favoriteIdentifier - The favorite identifier setting\n * @returns {string} The title without the favorite icon\n */\nexport const removeFavoriteFromTitle = (title: string, icon: string, favoriteIdentifier: string): string => {\n return favoriteIdentifier.includes('Star') ? title.replace(icon, '').trim().replace(' ', ' ') : title\n}\n/**\n * Determine if a note is a favorite based on the favoriteIdentifier setting\n * @param {TNote} note - The note to check\n * @param {FavoritesConfig} config - The configuration for the favorites plugin\n * @returns {boolean} true if the note is a favorite, false otherwise\n */\n\nexport function noteIsFavorite(note: CoreNoteFields, config: FavoritesConfig): boolean {\n const { favoriteIcon, favoriteIdentifier, favoriteKey } = config\n let titleIsFavorite = false,\n fmIsFavorite = false\n if (favoriteIdentifier.includes('Star')) {\n if (titleHasFavoriteIcon(note?.title || '', favoriteIcon)) {\n titleIsFavorite = true\n if (favoriteIdentifier === 'Star in title') return true\n if (favoriteIdentifier === 'Star or Frontmatter (either)') return true\n }\n if (favoriteIdentifier === 'Star in title') return titleIsFavorite // if we are only looking for a star return early\n }\n if (favoriteIdentifier.includes('Frontmatter')) {\n // do a super quick check to see if it could be a frontmatter note\n const frontmatterAttributes = note.frontmatterAttributes || {}\n const mayBeFM = Object.keys(frontmatterAttributes).length > 0\n if (!mayBeFM && favoriteIdentifier === 'Frontmatter only') return false\n // if it is not a frontmatter note, and we are only looking for frontmatter, return false\n if (frontmatterAttributes.hasOwnProperty(favoriteKey) && frontmatterAttributes[favoriteKey] !== false && !/false|no/i.test(String(frontmatterAttributes[favoriteKey]))) {\n fmIsFavorite = true\n }\n if (favoriteIdentifier === 'Frontmatter only') return fmIsFavorite // if we are only looking for a frontmatter return early\n }\n if (favoriteIdentifier.includes('either')) {\n return titleIsFavorite || fmIsFavorite\n }\n if (favoriteIdentifier.includes('both')) {\n return titleIsFavorite && fmIsFavorite\n }\n\n return false\n}\n" }, { "path": "dwertheimer.Favorites/src/favoritesRouter.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Favorites Router\n// Routes requests from FavoritesView React component to appropriate handlers\n//--------------------------------------------------------------------------\n\nimport {\n handleGetFavoriteNotes,\n handleGetFavoriteCommands,\n handleOpenNote,\n handleRunCommand,\n handleAddFavoriteNote,\n handleRemoveFavoriteNote,\n handleGetPresetCommands,\n handleAddFavoriteCommand,\n handleGetCallbackURL,\n handleGetProjectNotes,\n handleRenderMarkdown,\n handleGetNoteContentAsHTML,\n} from './requestHandlers'\nimport { newCommsRouter, type RequestResponse } from '@helpers/react/routerUtils'\nimport pluginJson from '../plugin.json'\n\nconst FAVORITES_BROWSER_WINDOW_ID = 'favorites-browser-window'\n\n/**\n * Route request to appropriate handler based on action type\n * @param {string} actionType - The action/command type\n * @param {any} data - Request data\n * @returns {Promise}\n */\nasync function routeFavoritesRequest(actionType: string, data: any): Promise {\n switch (actionType) {\n case 'getFavoriteNotes':\n return await handleGetFavoriteNotes(data)\n case 'getFavoriteCommands':\n return await handleGetFavoriteCommands(data)\n case 'openNote':\n return await handleOpenNote(data)\n case 'runCommand':\n return await handleRunCommand(data)\n case 'addFavoriteNote':\n return await handleAddFavoriteNote(data)\n case 'removeFavoriteNote':\n return await handleRemoveFavoriteNote(data)\n case 'getPresetCommands':\n return await handleGetPresetCommands(data)\n case 'addFavoriteCommand':\n return await handleAddFavoriteCommand(data)\n case 'getCallbackURL':\n return await handleGetCallbackURL(data)\n case 'getProjectNotes':\n return await handleGetProjectNotes(data)\n case 'renderMarkdown':\n return await handleRenderMarkdown(data)\n case 'getNoteContentAsHTML':\n return await handleGetNoteContentAsHTML(data)\n default:\n return {\n success: false,\n message: `Unknown action type: ${actionType}`,\n }\n }\n}\n\n/**\n * Handle actions from FavoritesView React component\n * Routes requests to appropriate handlers and sends responses back\n * @param {string} actionType - The action/command type\n * @param {any} data - Request data with optional __requestType, __correlationId, __windowId\n * @returns {Promise}\n */\nexport const onFavoritesBrowserAction: (actionType: string, data: any) => Promise = newCommsRouter({\n routerName: 'onFavoritesBrowserAction',\n defaultWindowId: FAVORITES_BROWSER_WINDOW_ID,\n routeRequest: routeFavoritesRequest,\n // Also handle non-REQUEST actions (like SEND_TO_PLUGIN) by routing them the same way\n handleNonRequestAction: routeFavoritesRequest,\n pluginJson: pluginJson,\n useSharedHandlersFallback: false, // Favorites implements all its own handlers\n})\n" }, { "path": "dwertheimer.Favorites/src/index.js", "content": "// @flow\nimport pluginJson from '../plugin.json'\nimport { log, logError, logDebug, timer, clo, JSP } from '@helpers/dev'\nimport { /* getPluginJson ,*/ updateSettingData, pluginUpdated } from '@helpers/NPConfiguration'\nimport { rememberPresetsAfterInstall } from '@helpers/NPPresets'\n\nexport { editSettings } from '@helpers/NPSettings'\n\nexport { setFavorite, openFavorite, removeFavorite } from './NPFavorites'\n\nexport {\n changePreset,\n runPreset01,\n runPreset02,\n runPreset03,\n runPreset04,\n runPreset05,\n runPreset06,\n runPreset07,\n runPreset08,\n runPreset09,\n runPreset10,\n runPreset11,\n runPreset12,\n runPreset13,\n runPreset14,\n runPreset15,\n runPreset16,\n runPreset17,\n runPreset18,\n runPreset19,\n runPreset20,\n} from './NPFavoritePresets'\n\nexport { openFavoritesBrowser } from './windowManagement'\nexport { onFavoritesBrowserAction } from './favoritesRouter'\n\n/**\n * NotePlan calls this function after the plugin is installed or updated.\n * The `updateSettingData` function looks through the new plugin settings in plugin.json and updates\n * the user preferences to include any new fields\n */\nexport async function onUpdateOrInstall(): Promise {\n logDebug(pluginJson, 'dwertheimer.Favorites::onUpdateOrInstall running')\n await updateSettingData(pluginJson)\n await rememberPresetsAfterInstall(pluginJson)\n}\n\n/**\n * NotePlan calls this function every time the plugin is run (any command in this plugin)\n * You should not need to edit this function. All work should be done in the commands themselves\n */\nexport function init(): void {\n // clo(DataStore.settings, `${pluginJson['plugin.id']} Plugin Settings`)\n DataStore.installOrUpdatePluginsByID([pluginJson['plugin.id']], true, false, false).then((r) => pluginUpdated(pluginJson, r))\n}\n\nexport function onSettingsUpdated(): void {\n logDebug(pluginJson, 'dwertheimer.Favorites::onSettingsUpdated called (but this plugin does not do anything after settings are updated)')\n}\n" }, { "path": "dwertheimer.Favorites/src/requestHandlers.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Request Handlers - Handle requests from React components\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { favoriteNotes, noteIsFavorite, getFavoritedTitle, removeFavoriteFromTitle } from './favorites'\nimport { getConfig } from './NPFavorites'\nimport { type RequestResponse } from './routerUtils'\nimport { getFrontmatterNotes, ensureFrontmatter, getFrontmatterAttributes, updateFrontMatterVars } from '@helpers/NPFrontMatter'\nimport { getNoteDecoration } from '@helpers/NPnote'\nimport { getFolderFromFilename, getFolderDisplayName } from '@helpers/folders'\nimport { getPluginJson } from '@helpers/NPConfiguration'\nimport { savePluginCommand } from '@helpers/NPPresets'\nimport { logDebug, logError, JSP } from '@helpers/dev'\nimport { getNote, setTitle } from '@helpers/note'\nimport { getNoteContentAsHTML } from '@helpers/HTMLView'\n\n/**\n * Handle request to get favorite notes\n * @param {Object} requestData - Request data\n * @returns {Promise}\n */\nexport async function handleGetFavoriteNotes(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleGetFavoriteNotes: ENTRY`)\n const config = await getConfig()\n\n // Get all notes with frontmatter\n const notesWithFM = getFrontmatterNotes() // not including template notes\n const notesWithStars = DataStore.projectNotes.filter((note) => note.title?.includes(config.favoriteIcon))\n const combinedNotes = [...notesWithFM, ...notesWithStars]\n const nonDuplicateNotes = combinedNotes.filter((note, index, self) => self.findIndex((t) => t.filename === note.filename) === index)\n const faveNotes = favoriteNotes(nonDuplicateNotes, config)\n\n // Format notes for React component\n const formattedNotes = faveNotes.map((note) => {\n const decoration = getNoteDecoration(note)\n const folder = getFolderFromFilename(note.filename) || '/'\n const folderDisplay = getFolderDisplayName(folder) || folder\n\n return {\n filename: note.filename,\n title: note.title || '',\n type: note.type || 'Notes',\n frontmatterAttributes: note.frontmatterAttributes || {},\n icon: decoration.icon,\n color: decoration.color,\n folder: folderDisplay,\n }\n })\n\n logDebug(pluginJson, `handleGetFavoriteNotes: Returning ${formattedNotes.length} favorite notes`)\n return {\n success: true,\n data: formattedNotes,\n }\n } catch (error) {\n logError(pluginJson, `handleGetFavoriteNotes: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to get favorite notes',\n }\n }\n}\n\n/**\n * Handle request to get favorite commands (presets)\n * @param {Object} requestData - Request data\n * @returns {Promise}\n */\nexport async function handleGetFavoriteCommands(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleGetFavoriteCommands: ENTRY`)\n const livePluginJson = await getPluginJson(pluginJson['plugin.id'])\n\n if (!livePluginJson) {\n logError(pluginJson, `handleGetFavoriteCommands: getPluginJson returned null/undefined`)\n return {\n success: false,\n message: 'Failed to load plugin configuration',\n }\n }\n\n // plugin.json uses flat keys like 'plugin.commands', not nested objects\n const commands = livePluginJson['plugin.commands'] || []\n logDebug(pluginJson, `handleGetFavoriteCommands: Found ${commands.length} total commands`)\n\n const presetCommands = commands\n .filter((cmd) => cmd.isPreset === true && cmd.name && !cmd.name.match(/^Favorites: Set Preset/))\n .map((cmd) => {\n // Strip leading dashes and whitespace from names for display\n const displayName = (cmd.name || '').replace(/^[-]\\s*/, '')\n return {\n name: displayName,\n description: cmd.description || '',\n jsFunction: cmd.jsFunction || '',\n data: cmd.data || cmd.URL || '',\n }\n })\n\n logDebug(pluginJson, `handleGetFavoriteCommands: Returning ${presetCommands.length} favorite commands`)\n return {\n success: true,\n data: presetCommands,\n }\n } catch (error) {\n logError(pluginJson, `handleGetFavoriteCommands: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to get favorite commands',\n }\n }\n}\n\n/**\n * Handle request to open a note\n * @param {Object} requestData - Request data with filename, newWindow, splitView\n * @returns {Promise}\n */\nexport async function handleOpenNote(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleOpenNote: ENTRY - filename=\"${requestData.filename}\", newWindow=${String(requestData.newWindow)}, splitView=${String(requestData.splitView)}`)\n\n const { filename, newWindow = false, splitView = false } = requestData\n\n if (!filename) {\n return {\n success: false,\n message: 'Filename is required',\n }\n }\n\n // Use Editor.openNoteByFilename with options\n // Parameters: filename, newWindow, highlightStart, highlightEnd, splitView, createIfNeeded, content\n // Note: Editor.openNoteByFilename returns a Promise\n // It may return void even on success, so we don't check the return value\n await Editor.openNoteByFilename(filename, newWindow, 0, 0, splitView, false, undefined)\n\n logDebug(pluginJson, `handleOpenNote: Successfully opened note \"${filename}\"`)\n return {\n success: true,\n data: { filename },\n }\n } catch (error) {\n logError(pluginJson, `handleOpenNote: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to open note',\n }\n }\n}\n\n/**\n * Handle request to run a command\n * @param {Object} requestData - Request data with jsFunction and data\n * @returns {Promise}\n */\nexport async function handleRunCommand(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleRunCommand: ENTRY - jsFunction=\"${requestData.jsFunction}\"`)\n\n const { jsFunction, data } = requestData\n\n if (!jsFunction) {\n return {\n success: false,\n message: 'jsFunction is required',\n }\n }\n\n // If data is a URL, open it\n if (data && typeof data === 'string' && (data.startsWith('http') || data.startsWith('noteplan://'))) {\n NotePlan.openURL(data)\n logDebug(pluginJson, `handleRunCommand: Opened URL: ${data}`)\n } else {\n // Otherwise, try to call the function if it exists\n logDebug(pluginJson, `handleRunCommand: Command function not directly callable, URL method used`)\n }\n\n return {\n success: true,\n data: { jsFunction },\n }\n } catch (error) {\n logError(pluginJson, `handleRunCommand: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to run command',\n }\n }\n}\n\n/**\n * Handle request to add a favorite note\n * @param {Object} requestData - Request data with filename\n * @returns {Promise}\n */\nexport async function handleAddFavoriteNote(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleAddFavoriteNote: ENTRY - filename=\"${requestData.filename}\"`)\n\n const { filename } = requestData\n\n if (!filename) {\n return {\n success: false,\n message: 'Filename is required',\n }\n }\n\n // Find the note\n const note = DataStore.projectNoteByFilename(filename)\n if (!note) {\n return {\n success: false,\n message: `Note not found: \"${filename}\"`,\n }\n }\n\n // Check if already a favorite\n const config = await getConfig()\n if (noteIsFavorite(note, config)) {\n return {\n success: false,\n message: 'This note is already a favorite',\n }\n }\n\n // Set it as favorite directly without opening the note\n // We'll modify the note's title or frontmatter directly\n const { favoriteKey, favoriteIcon, position, favoriteIdentifier } = config\n\n if (favoriteIdentifier.includes('Star')) {\n // Add star to title\n const newTitle = getFavoritedTitle(note.title || '', position, favoriteIcon, favoriteIdentifier)\n setTitle(note, newTitle)\n }\n\n if (favoriteIdentifier.includes('Frontmatter')) {\n // Add frontmatter field\n ensureFrontmatter(note)\n const fm = getFrontmatterAttributes(note)\n if (typeof fm === 'object' && fm !== null) {\n fm[favoriteKey] = 'true'\n updateFrontMatterVars(note, fm)\n }\n }\n\n logDebug(pluginJson, `handleAddFavoriteNote: Successfully added favorite note`)\n return {\n success: true,\n data: { filename },\n }\n } catch (error) {\n logError(pluginJson, `handleAddFavoriteNote: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to add favorite note',\n }\n }\n}\n\n/**\n * Handle request to remove favorite note\n * @param {Object} requestData - Request data with filename\n * @returns {Promise}\n */\nexport async function handleRemoveFavoriteNote(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleRemoveFavoriteNote: ENTRY - filename=\"${requestData.filename}\"`)\n\n const { filename } = requestData\n\n if (!filename) {\n return {\n success: false,\n message: 'Filename is required',\n }\n }\n\n // Find the note\n const note = DataStore.projectNoteByFilename(filename)\n if (!note) {\n return {\n success: false,\n message: `Note not found: \"${filename}\"`,\n }\n }\n\n // Check if it's a favorite\n const config = await getConfig()\n if (!noteIsFavorite(note, config)) {\n return {\n success: false,\n message: 'This note is not a favorite',\n }\n }\n\n // Remove favorite status directly without opening the note\n const { favoriteKey, favoriteIcon, favoriteIdentifier } = config\n\n if (favoriteIdentifier.includes('Star')) {\n // Remove star from title\n const newTitle = removeFavoriteFromTitle(note.title || '', favoriteIcon, favoriteIdentifier)\n setTitle(note, newTitle)\n }\n\n if (favoriteIdentifier.includes('Frontmatter')) {\n // Remove frontmatter field\n const fm = getFrontmatterAttributes(note)\n if (typeof fm === 'object' && fm !== null && fm[favoriteKey]) {\n const updatedFm = { ...fm }\n delete updatedFm[favoriteKey]\n // Pass true for deleteMissingAttributes to actually remove the deleted key from frontmatter\n updateFrontMatterVars(note, updatedFm, true)\n }\n }\n\n logDebug(pluginJson, `handleRemoveFavoriteNote: Successfully removed favorite note`)\n return {\n success: true,\n data: { filename },\n }\n } catch (error) {\n logError(pluginJson, `handleRemoveFavoriteNote: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to remove favorite note',\n }\n }\n}\n\n/**\n * Handle request to get preset commands for selection\n * @param {Object} requestData - Request data\n * @returns {Promise}\n */\nexport async function handleGetPresetCommands(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleGetPresetCommands: ENTRY`)\n\n const livePluginJson = await getPluginJson(pluginJson['plugin.id'])\n if (!livePluginJson || !livePluginJson['plugin.commands']) {\n return {\n success: false,\n message: 'Plugin configuration is missing plugin.commands',\n }\n }\n\n const commands = livePluginJson['plugin.commands']\n const presetCommands = commands.filter((command) => command.isPreset === true)\n\n // Map to options format for dropdown\n const options = presetCommands.map((command) => ({\n label: command.name || command.jsFunction,\n value: command.jsFunction,\n }))\n\n logDebug(pluginJson, `handleGetPresetCommands: Returning ${options.length} preset commands`)\n return {\n success: true,\n data: options,\n }\n } catch (error) {\n logError(pluginJson, `handleGetPresetCommands: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to get preset commands',\n }\n }\n}\n\n/**\n * Handle request to add/update a favorite command (preset)\n * @param {Object} requestData - Request data with jsFunction, name, and data (URL)\n * @returns {Promise}\n */\nexport async function handleAddFavoriteCommand(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleAddFavoriteCommand: ENTRY - jsFunction=\"${requestData.jsFunction}\", name=\"${requestData.name}\"`)\n\n const { jsFunction, name, data: url } = requestData\n\n if (!jsFunction) {\n return {\n success: false,\n message: 'jsFunction is required',\n }\n }\n\n if (!name || !name.trim()) {\n return {\n success: false,\n message: 'Command name is required',\n }\n }\n\n if (!url || !url.trim()) {\n return {\n success: false,\n message: 'URL/X-Callback is required',\n }\n }\n\n // Validate URL\n const isValidURL = (url: string) => /^(https?|[a-z0-9\\-]+):\\/\\/[a-z0-9\\-]+/i.test(url)\n if (!isValidURL(url)) {\n return {\n success: false,\n message: `\"${url}\" is not a valid URL. Must be an X-Callback URL or full Web URL.`,\n }\n }\n\n // Get the command details from plugin.json\n const livePluginJson = await getPluginJson(pluginJson['plugin.id'])\n if (!livePluginJson || !livePluginJson['plugin.commands']) {\n return {\n success: false,\n message: 'Plugin configuration is missing plugin.commands',\n }\n }\n\n const commands = livePluginJson['plugin.commands']\n const command = commands.find((cmd) => cmd.jsFunction === jsFunction && cmd.isPreset === true)\n\n if (!command) {\n return {\n success: false,\n message: `Preset command not found: ${jsFunction}`,\n }\n }\n\n // Apply charsToPrepend if configured\n const config = DataStore.settings\n let commandName = name.trim()\n if (config.charsToPrepend) {\n commandName = `${config.charsToPrepend}${commandName}`\n }\n\n // Save the command using savePluginCommand\n await savePluginCommand(pluginJson, { ...command, name: commandName, data: url })\n\n logDebug(pluginJson, `handleAddFavoriteCommand: Successfully saved preset command`)\n return {\n success: true,\n data: { jsFunction, name: commandName, data: url },\n }\n } catch (error) {\n logError(pluginJson, `handleAddFavoriteCommand: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to add favorite command',\n }\n }\n}\n\n/**\n * Handle request to get X-Callback URL using Link Creator\n * @param {Object} requestData - Request data with commandName and defaultValue\n * @returns {Promise}\n */\nexport async function handleGetCallbackURL(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleGetCallbackURL: ENTRY`)\n\n const { commandName, defaultValue } = requestData\n\n // Call the Link Creator plugin\n const url = await DataStore.invokePluginCommandByName('Get X-Callback-URL', 'np.CallbackURLs', ['', true])\n\n if (url && typeof url === 'string') {\n logDebug(pluginJson, `handleGetCallbackURL: Successfully got URL from Link Creator`)\n return {\n success: true,\n data: { url },\n }\n } else {\n return {\n success: false,\n message: 'No URL returned from Link Creator',\n }\n }\n } catch (error) {\n logError(pluginJson, `handleGetCallbackURL: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to get callback URL',\n }\n }\n}\n\n/**\n * Handle request to get project notes for NoteChooser\n * @param {Object} requestData - Request data\n * @returns {Promise}\n */\nexport async function handleGetProjectNotes(requestData: Object): Promise {\n try {\n logDebug(pluginJson, `handleGetProjectNotes: ENTRY`)\n\n // Get all project notes (not calendar notes)\n const notes = DataStore.projectNotes.map((note) => ({\n title: note.title || '',\n filename: note.filename || '',\n type: note.type || 'Notes',\n frontmatterAttributes: note.frontmatterAttributes || {},\n changedDate: note.changedDate?.getTime() || 0,\n }))\n\n logDebug(pluginJson, `handleGetProjectNotes: Returning ${notes.length} project notes`)\n return {\n success: true,\n data: notes,\n }\n } catch (error) {\n logError(pluginJson, `handleGetProjectNotes: Error: ${JSP(error)}`)\n return {\n success: false,\n message: error.message || 'Failed to get project notes',\n }\n }\n}\n\n/**\n * Render markdown text to HTML\n * @param {Object} params - Request parameters\n * @param {string} params.markdown - Markdown text to render\n * @returns {Promise}\n */\nexport async function handleRenderMarkdown(params: { markdown: string }): Promise {\n const startTime: number = Date.now()\n try {\n logDebug(pluginJson, `handleRenderMarkdown: ENTRY - markdown length=${params.markdown?.length || 0}`)\n\n if (!params.markdown) {\n return {\n success: false,\n message: 'Markdown text is required',\n data: null,\n }\n }\n\n // Use a temporary note object to render the markdown\n // getNoteContentAsHTML expects (content: string, note: TNote)\n const tempNote: any = {\n filename: 'temp.md',\n content: params.markdown,\n paragraphs: [],\n }\n\n const html = await getNoteContentAsHTML(params.markdown, tempNote)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `handleRenderMarkdown: COMPLETE - totalElapsed=${totalElapsed}ms`)\n\n return {\n success: true,\n data: html,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `handleRenderMarkdown: ERROR - totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to render markdown: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get note content as HTML\n * @param {Object} params - Request parameters\n * @param {string} params.noteIdentifier - Filename or title of the note\n * @param {boolean} params.isFilename - Whether noteIdentifier is a filename (default: true)\n * @param {boolean} params.isTitle - Whether noteIdentifier is a title (default: false)\n * @returns {Promise}\n */\nexport async function handleGetNoteContentAsHTML(params: { noteIdentifier: string, isFilename?: boolean, isTitle?: boolean }): Promise {\n const startTime: number = Date.now()\n try {\n logDebug(\n pluginJson,\n `handleGetNoteContentAsHTML: ENTRY - noteIdentifier=\"${params.noteIdentifier}\", isFilename=${String(params.isFilename ?? true)}, isTitle=${String(params.isTitle ?? false)}`,\n )\n\n if (!params.noteIdentifier) {\n return {\n success: false,\n message: 'Note identifier is required',\n data: null,\n }\n }\n\n // Get the note by filename or title\n const note = await getNote(params.noteIdentifier, null, '')\n if (!note) {\n return {\n success: false,\n message: `Note not found: ${params.noteIdentifier}`,\n data: null,\n }\n }\n\n // Get the note content as HTML\n const html = await getNoteContentAsHTML(note.content, note)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `handleGetNoteContentAsHTML: COMPLETE - totalElapsed=${totalElapsed}ms`)\n\n return {\n success: true,\n data: html,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `handleGetNoteContentAsHTML: ERROR - totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get note content as HTML: ${error.message}`,\n data: null,\n }\n }\n}\n" }, { "path": "dwertheimer.Favorites/src/shared/types.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Shared Types - Used by both React components and back-end code\n// These types have no back-end dependencies and can be safely imported by React\n//--------------------------------------------------------------------------\n\n/**\n * Data structure passed to React windows from the plugin\n */\nexport type PassedData = {\n startTime?: Date /* used for timing/debugging */,\n title?: string /* React Window Title */,\n width?: number /* React Window Width */,\n height?: number /* React Window Height */,\n pluginData: any /* Your plugin's data to pass on first launch (or edited later) */,\n ENV_MODE?: 'development' | 'production',\n debug: boolean /* set based on ENV_MODE above */,\n logProfilingMessage: boolean /* whether you want to see profiling messages on React redraws (not super interesting) */,\n returnPluginCommand: { id: string, command: string } /* plugin jsFunction that will receive comms back from the React window */,\n componentPath: string /* the path to the rolled up webview bundle. should be ../pluginID/react.c.WebView.bundle.* */,\n passThroughVars?: any /* any data you want to pass through to the React Window */,\n}\n\n" }, { "path": "dwertheimer.Favorites/src/support/performRollup.node.js", "content": "#!/usr/bin/node\n\n/**\n * FavoritesView Rollup Script\n *\n * Builds development and production modes for:\n * - FavoritesView bundle\n *\n * Usage:\n * node '/path/to/performRollup.node.js'\n *\n * Options:\n * --react Include the React core bundle\n * --graph Create the visualization graph\n * --watch Watch for changes\n */\n\nconst rollupReactScript = require('../../../scripts/rollup.generic.js')\nconst { rollupReactFiles, getCommandLineOptions, getRollupConfig } = rollupReactScript\n\n//eslint-disable-next-line\n;(async function () {\n const { watch, graph } = getCommandLineOptions()\n\n const rollupProms = []\n\n // FavoritesView bundle configs\n const favoritesViewRollupConfigs = [\n getRollupConfig({\n entryPointPath: 'dwertheimer.Favorites/src/support/rollup.FavoritesView.entry.js',\n outputFilePath: 'dwertheimer.Favorites/requiredFiles/react.c.FavoritesView.bundle.REPLACEME.js',\n externalModules: ['React', 'react', 'reactDOM', 'dom', 'ReactDOM'],\n createBundleGraph: graph,\n buildMode: 'development',\n bundleName: 'FavoritesViewBundle',\n }),\n ]\n\n const favoritesViewConfig = favoritesViewRollupConfigs[0] // use only dev version for now\n rollupProms.push(rollupReactFiles(favoritesViewConfig, watch, 'dwertheimer.Favorites FavoritesView Component development version'))\n\n try {\n await Promise.all(rollupProms)\n } catch (error) {\n console.error('Error during rollup:', error)\n }\n})()\n\n" }, { "path": "dwertheimer.Favorites/src/support/rollup.FavoritesView.entry.js", "content": "// use rollup to create the bundle of these included files\n// See directions in the performRollup.node.js file\n\n// Export FavoritesView as WebView for the Root React Component\nexport { FavoritesView as WebView } from '../components/FavoritesView.jsx'\n\n" }, { "path": "dwertheimer.Favorites/src/windowManagement.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Window Management Functions - Opening and managing React windows\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { type PassedData } from './shared/types.js'\nimport { generateCSSFromTheme } from '@helpers/NPThemeToCSS'\nimport { logDebug, logError, timer, JSP } from '@helpers/dev'\n\nconst REACT_WINDOW_TITLE = 'Favorites'\nconst FAVORITES_BROWSER_WINDOW_ID = 'favorites-browser-window'\n\n/**\n * Generate a unique window ID for a favorites browser window\n * @param {string} identifier - Optional identifier to make the window unique\n * @returns {string} - The unique window ID\n */\nexport function getFavoritesBrowserWindowId(identifier?: string): string {\n const suffix = identifier && identifier.trim() ? ` ${identifier.trim()}` : ''\n return `${FAVORITES_BROWSER_WINDOW_ID}${suffix}`\n}\n\n/**\n * Gathers key data for the React Window\n * @param {boolean} showFloating - Whether this is a floating window\n * @param {string} windowId - The window ID\n * @returns {PassedData} the React Data Window object\n */\nexport function createWindowInitData(showFloating: boolean, windowId: string): PassedData {\n const startTime = new Date()\n logDebug(pluginJson, `createWindowInitData: ENTRY`)\n\n const pluginData = getPluginData(showFloating, windowId)\n const ENV_MODE = 'development' /* helps during development. set to 'production' when ready to release */\n\n const dataToPass: PassedData = {\n pluginData: {\n ...pluginData,\n windowId: windowId,\n },\n title: REACT_WINDOW_TITLE,\n logProfilingMessage: false,\n debug: false,\n ENV_MODE,\n returnPluginCommand: { id: pluginJson['plugin.id'], command: 'onFavoritesBrowserAction' },\n componentPath: `../dwertheimer.Favorites/react.c.FavoritesView.bundle.dev.js`,\n startTime,\n }\n return dataToPass\n}\n\n/**\n * Gather data you want passed to the React Window\n * @param {boolean} showFloating - Whether this is a floating window\n * @param {string} windowId - The window ID\n * @returns {[string]: mixed} - the data that your React Window will start with\n */\nexport function getPluginData(showFloating: boolean, windowId: string): { [string]: mixed } {\n logDebug(pluginJson, `getPluginData: ENTRY`)\n\n const pluginData = {\n platform: NotePlan.environment.platform,\n windowId: windowId,\n showFloating: showFloating,\n }\n\n return pluginData\n}\n\n/**\n * Opens the Favorites Browser React window\n * @param {boolean|string} _isFloating - If true or 'true', use openReactWindow instead of showInMainWindow\n */\nexport async function openFavoritesBrowser(_isFloating: boolean | string = false): Promise {\n try {\n logDebug(pluginJson, `openFavoritesBrowser: Starting, _isFloating=${String(_isFloating)}`)\n const startTime = new Date()\n\n // Make sure we have np.Shared plugin which has the core react code\n await DataStore.installOrUpdatePluginsByID(['np.Shared'], false, false, true)\n logDebug(pluginJson, `openFavoritesBrowser: installOrUpdatePluginsByID ['np.Shared'] completed`)\n\n // Determine if this should be a floating window\n const isFloating = _isFloating === true || (typeof _isFloating === 'string' && /true/i.test(_isFloating))\n\n // Generate unique window ID based on whether it's floating or main window\n const windowId = isFloating ? getFavoritesBrowserWindowId('floating') : getFavoritesBrowserWindowId('main')\n\n // get initial data to pass to the React Window\n const data = createWindowInitData(isFloating, windowId)\n\n const cssTagsString = `\n \n \n \n \n \\n`\n\n const themeCSS = generateCSSFromTheme()\n // find the --tint-color from the themeCSS\n const tintColor = themeCSS.match(/--tint-color: (.*?);/)?.[1]\n let iconColorHex = ''\n if (tintColor) {\n logDebug(pluginJson, `openFavoritesBrowser: Found tint color: ${tintColor}`)\n iconColorHex = tintColor\n } else {\n logDebug(pluginJson, `openFavoritesBrowser: No tint color found in themeCSS`)\n }\n\n const windowOptions = {\n savedFilename: `../../${pluginJson['plugin.id']}/favorites_browser_output.html` /* for saving a debug version of the html file */,\n headerTags: cssTagsString,\n windowTitle: REACT_WINDOW_TITLE,\n width: 500,\n height: 800,\n customId: windowId, // Use unique window ID instead of constant\n shouldFocus: true,\n generalCSSIn: themeCSS,\n specificCSS: `\n /* Favorites browser - left justified, full height, expandable width */\n body, html {\n margin: 0;\n padding: 0;\n height: 100vh;\n overflow: hidden;\n }\n #root, .favorites-view-container {\n width: 100%;\n height: 100vh;\n }\n /* Keep header controls fixed size and left-aligned */\n .favorites-view-header {\n width: 100%;\n }\n /* Let list items expand to fill available space */\n .favorites-view-container .filterable-list-container {\n flex: 1;\n min-width: 0;\n }\n .favorites-view-container .list-container {\n width: 100%;\n }\n `,\n postBodyScript: `\n \n `,\n // Options for showInMainWindow (main window mode)\n icon: 'star',\n iconColor: '#F8E160',\n splitView: false,\n autoTopPadding: true,\n showReloadButton: true,\n reloadPluginID: 'dwertheimer.Favorites',\n reloadCommandName: 'Sidebar - Open Favorites Browser Sidebar',\n }\n\n // Choose the appropriate command based on whether it's floating or main window\n const windowType = isFloating ? 'openReactWindow' : 'showInMainWindow'\n logDebug(pluginJson, `openFavoritesBrowser: Using ${windowType} (${isFloating ? 'floating' : 'main'} window)`)\n await DataStore.invokePluginCommandByName(windowType, 'np.Shared', [data, windowOptions])\n logDebug(pluginJson, `openFavoritesBrowser: Completed after ${timer(startTime)}`)\n } catch (error) {\n logError(pluginJson, `openFavoritesBrowser: Error: ${JSP(error)}`)\n throw error\n }\n}\n" }, { "path": "dwertheimer.Forms/CHANGELOG.md", "content": "# dwertheimer.Forms Changelog\n\n## About dwertheimer.Forms Plugin\n\nSee Plugin [README](https://github.com/NotePlan/plugins/blob/main/dwertheimer.Forms/README.md) for details on available commands and use case.\n\n## [1.1.9] 2026-04-17\n\n### Fixed\n- **SpaceChooser / getTeamspaces**: Form Builder, Form Browser, and DynamicDialog `space-chooser` fields rely on `@helpers/react/routerUtils` when calling np.Shared’s `handleSharedRequest` fallback. NotePlan’s `invokePluginCommandByName` can wrap the inner `RequestResponse`; that unwrap is fixed in `routerUtils` so teamspace lists load (not a nested `{ success, data }` after `unwrapPluginRequestData`). **Rebuild** FormView / FormBuilderView / FormBrowserView bundles after pulling helpers + np.Shared.\n\n### Edited in this release\n- `dwertheimer.Forms/plugin.json`, `CHANGELOG.md`.\n\n## [1.1.8] 2026-04-17\n\n### Fixed\n- **Field Editor (event-chooser)**: `getAvailableCalendars` and `getAvailableReminderLists` responses are unwrapped with `unwrapPluginRequestData` (same PluginRequestEnvelope contract as other choosers). Previously `.then` treated the full `{ success, data }` object as the list and `Array.isArray` failed.\n\n### Edited in this release\n- `dwertheimer.Forms/src/components/FieldEditor.jsx`, `plugin.json`, `CHANGELOG.md`.\n\n## [1.1.7] 2026-04-13 @dwertheimer\n\n### Changed\n- **PluginRequestEnvelope**: Forms WebViews and DynamicDialog-related callers now use `@helpers/react/pluginRequestEnvelope` (`unwrapPluginRequestData` / explicit `success` + `data` + `message`) so `requestFromPlugin` matches `np.Shared` Root and `routerUtils` RESPONSE payloads. Structured failures (e.g. `submitForm`) inspect the envelope instead of relying on reject alone. **Release together with np.Shared 1.0.7+** (or matching Root bundle).\n\n### Edited in this release\n- `dwertheimer.Forms/plugin.json` — Version 1.1.7; lastUpdateInfo.\n- `dwertheimer.Forms/CHANGELOG.md` — This section.\n\n## [1.1.6] 2026-03-16 @dwertheimer\n\n### Added\n- **Form Builder: Refresh button next to Space and Folder**: A refresh control (rotate icon) was added next to \"Space:\" and \"Folder:\" in the left sidebar (Write to existing, Create new, and Form processor sections) so folder and note lists can be refreshed after creating new folders without reopening the window.\n\n### Fixed\n- **Form Builder: Target Note chooser missing <current>**: The description stated that <current>, <today>, etc. could be chosen, but <current> (and other relative options) were missing when notes had been loaded first for the Processing Template dropdown. Notes are now always loaded with relative options included; the Processing Template chooser continues to hide them via `includeRelativeNotes={false}`.\n\n### Edited in this release\n- `dwertheimer.Forms/plugin.json` — Version 1.1.6; lastUpdateInfo.\n- `dwertheimer.Forms/CHANGELOG.md` — This section.\n- `dwertheimer.Forms/src/components/ProcessingMethodSection.jsx` — Refresh button next to Space and Folder labels (class `form-builder-refresh-folders-btn`).\n- `dwertheimer.Forms/src/components/FormBuilder.jsx` — `getNotes` now always requests `includeRelativeNotes: true` so Target Note chooser shows <current> and other relative options.\n\n## [1.1.5] 2026-03-16 @dwertheimer\n\n### Fixed\n- **Form window not closing after successful submit**: Submit was handled via the REQUEST path (`submitForm`) which never called `closeWindowFromCustomId`. The form-submit router now routes `submitForm` through `handleFormSubmitAction` when window data is available so the backend closes the floating window on success.\n- **Open new note in Editor not applied**: The \"Open new note in Editor\" checkbox value was not passed through to templateRunner. The payload now includes `shouldOpenInEditor`; the backend merges it from pluginData when missing; `resolveShouldOpenInEditor()` ensures missing/undefined defaults to true (matches Form Builder UI). Template frontmatter and loadFormContext also provide `shouldOpenInEditor`.\n- **Template body empty on create-new submit**: When submitting from the form window, `templateBody` and `newNoteFrontmatter` were not in the payload. The backend now merges them from `reactWindowData.pluginData` in `handleFormSubmitAction` so processCreateNew receives the form's template body and new-note frontmatter.\n- **Form closed without showing error when templateRunner did nothing**: When templateRunner skipped the main block (no template name, not run-from-code, no passed body), it returned undefined and Forms treated it as success. np.Templating now returns null in that case so Forms shows an error and keeps the window open.\n\n### Edited in this release\n- `dwertheimer.Forms/plugin.json` — Version 1.1.5; lastUpdateInfo.\n- `dwertheimer.Forms/CHANGELOG.md` — This section.\n- `dwertheimer.Forms/src/components/FormView.jsx` — Submit payload includes `shouldOpenInEditor`; comment for default true when missing.\n- `dwertheimer.Forms/src/components/ProcessingMethodSection.jsx` — Comment that checkbox defaults to on when missing from frontmatter.\n- `dwertheimer.Forms/src/formSubmitHandlers.js` — Route submitForm via handleFormSubmitAction in router; merge `shouldOpenInEditor`, `templateBody`, `newNoteFrontmatter` from pluginData in handleFormSubmitAction; `loadFormContextFromFilename` returns `shouldOpenInEditor` from frontmatter; `submitFormRequest` merges `shouldOpenInEditor` from payload/context; `resolveShouldOpenInEditor` import and use.\n- `dwertheimer.Forms/src/formSubmitRouter.js` — For actionType `submitForm`, resolve windowId and reactWindowData and call `handleFormSubmitAction` so backend can close window and use pluginData.\n- `dwertheimer.Forms/src/formSubmission.js` — Export `resolveShouldOpenInEditor()` (default true when missing); use it in handleSubmitButtonClick.\n- `dwertheimer.Forms/src/formBrowserRouter.js` — (existing changes in WC)\n- `dwertheimer.Forms/src/components/FormBrowserView.jsx` — (existing changes in WC)\n- `dwertheimer.Forms/src/windowManagement.js` — (existing changes in WC)\n\n## [1.1.3] 2026-02-23 @dwertheimer\n\n### Fixed\n- **Processing Template dropdown still reverting in some cases**: When the Processing Template dropdown was opened, `getNotes` ran and could commit (`setNotes`) before the user's `setFrontmatter` from selecting a template, so one render showed stale frontmatter and the dropdown appeared to revert. A pending-selection ref is now set on change and used for the displayed value until frontmatter catches up, so the selection always sticks. Sync effect also clears the pending ref when syncing from prop and only runs when the prop has changed from its previous value.\n- **Processing Template note chooser icon showing square with question mark**: The note chooser input used `iconClass: 'fa-file-lines'` without a Font Awesome 6 style prefix (`fa-solid`). FA6 requires the style prefix or the glyph renders as missing. SearchableChooser now normalizes the input icon class so a style prefix is always applied when missing.\n\n### Edited in this release\n- `dwertheimer.Forms/src/components/FormBuilder.jsx` — Pending `receivingTemplateTitle` ref set in `handleFrontmatterChange`; `frontmatterForSettings` passes effective value (pending ref ?? frontmatter); effect clears pending when frontmatter catches up; sync effect updates ref to current prop and clears pending when syncing from prop.\n- `helpers/react/DynamicDialog/SearchableChooser.jsx` — Input icon: when `iconClass` starts with `fa-` but has no style prefix (`fa-solid`/`fa-regular`/`fa-brands`), prepend `fa-solid ` so the icon renders correctly in FA6.\n\n## [1.1.2] 2026-02-23 @dwertheimer\n\n### Fixed\n- **Processing Template dropdown value not sticking**: Under some conditions, changing the Processing Template dropdown in the Form Builder left column caused the value to revert to the previous selection. The sync effect that pushes the `receivingTemplateTitle` prop into frontmatter was running whenever `frontmatter.receivingTemplateTitle` changed (including when the user changed the dropdown), then overwrote the user's choice with the stale prop. Sync now runs only when the prop itself changes (tracked via a ref), so user selections persist.\n\n### Edited in this release\n- `dwertheimer.Forms/src/components/FormBuilder.jsx` — Added `useRef` for previous `receivingTemplateTitle` prop; sync effect now depends only on `receivingTemplateTitle` and updates frontmatter only when the prop has changed, preventing the dropdown from reverting after user selection.\n\n## [1.1.1] 2026-02-22 @dwertheimer\n\n### Changed\n- Update window title to 'Template Form Builder'\n\n## [1.0.28] 2026-02-08 @dwertheimer\n\n### Fixed\n- **Infinite loop on load with preloaded content**: Forms with `preloadChooserData: true` could cause an infinite render loop. FormView was passing new object/array references every render for `defaultValues` and preloaded* props (`preloadedTeamspaces`, `preloadedMentions`, `preloadedHashtags`, `preloadedEvents`, `preloadedFrontmatterValues`), which retriggered DynamicDialog's \"add missing keys\" useEffect repeatedly. These props are now memoized with content-based dependencies so references only change when the actual data changes.\n\n### Edited in this release\n- `dwertheimer.Forms/src/components/FormView.jsx` — Added useMemo for defaultValuesStable and preloaded*Stable props passed to DynamicDialog.\n\n## [1.0.27] 2026-02-08 @dwertheimer\n\n### Added\n- tagChooser and mentionChooser now support a `valueSeparator` option: `comma` (value1,value2), `commaSpace` (value1, value2 — default for readability), or `space` (value1 value2). Form Builder includes a Value Separator dropdown; type definitions, renderer, test examples, and docs updated.\n\n## [1.0.26] 2026-02-08 @dwertheimer\n\n### Added\n- **Frontmatter Key Chooser value separator**: When not returning as array, the Frontmatter Key Chooser supports a `valueSeparator` option: `comma` (value1,value2), `commaSpace` (value1, value2 — default for readability), or `space` (value1 value2). Form Builder includes a Value Separator dropdown; type definitions, renderer, test examples, and docs updated.\n\n### Fixed\n- **FolderChooser displays all folders**: Folder chooser (e.g. in form fields) now shows all folders instead of the default 25. Uses `maxResults: 0` so the dropdown shows the full list with scrolling.\n- **SpaceChooser WebView error (isMounted)**: Fixed `ReferenceError: Can't find variable: isMounted` in SpaceChooser. The `useEffect` referenced `isMounted` which was only defined inside `loadSpaces`; added `isMountedRef` and proper mount tracking (matches FolderChooser, TagChooser, MentionChooser pattern).\n- **SpaceChooser Private option displays blank**: Selecting \"Private\" (id: empty string) in the space chooser now correctly shows \"Private\" in the text field instead of blank. SearchableChooser previously skipped the display lookup when `displayValue` was falsy (empty string); now allows lookup when `value` is set (including `''` for empty-id items).\n\n### Edited in this release\n- `helpers/react/DynamicDialog/FolderChooser.jsx` — Set `maxResults: 0` in SearchableChooser config so all folders are shown (unlimited, scroll).\n- `helpers/react/DynamicDialog/SpaceChooser.jsx` — Added `isMountedRef` and mount-tracking effect; replaced `isMounted` references with `isMountedRef.current` in `loadSpaces` and load effect.\n- `helpers/react/DynamicDialog/SearchableChooser.jsx` — Allow display-value lookup when `value` is `''` (not just truthy); condition changed from `displayValue && ...` to `value !== undefined && value !== null && ...`.\n- `helpers/react/DynamicDialog/ContainedMultiSelectChooser.jsx` — Added `valueSeparator` prop (`'comma'` | `'commaSpace'` | `'space'`) and join/parse logic for string output.\n- `helpers/react/DynamicDialog/FrontmatterKeyChooser.jsx` — Added `valueSeparator` prop, default `'commaSpace'`; pass-through to ContainedMultiSelectChooser.\n- `helpers/react/DynamicDialog/DynamicDialog.jsx` — Added `valueSeparator` to TSettingItem.\n- `helpers/react/DynamicDialog/dialogElementRenderer.js` — Extract and pass `valueSeparator` for frontmatter-key-chooser.\n- `dwertheimer.Forms/src/components/FieldEditor.jsx` — Value Separator dropdown for frontmatter-key-chooser (comma / comma+space / space).\n- `dwertheimer.Forms/src/FormFieldRenderTest.js` — valueSeparator examples (commaSpace, space, comma).\n- `helpers/react/DynamicDialog/CREATING_NEW_DYNAMICDIALOG_FIELD_TYPES.md` — Documented valueSeparator; Form Item Editor and test examples.\n- `dwertheimer.Forms/README.md` — frontmatter-key-chooser JSON example with valueSeparator.\n\n## [1.0.25] 2026-02-06 @dwertheimer\n\n### Merged\n- **Merge of fix/conditional-values-bgcolor-and-button-group-default into main.** This release combines all changes from the fix branch (conditional-values, button-group default, Form Browser overlay, simplified submit response, frontmatter allowlist) with main's 1.0.24 fixes (Processing Template dropdown, GenericDatePicker Safari, formProcessorTitle eliminated). See 1.0.21–1.0.24 below for details.\n\n## [1.0.24] 2026-02-05 @dwertheimer\n\n### Fixed\n- **Processing Template dropdown selection**: Selecting a new Processing Template from the dropdown now correctly shows the newly selected item instead of the previous value. Root cause: SearchableChooser only matched note objects by filename; NoteChooser passes the note title as value, so the match failed and the display reverted to the old value.\n- **GenericDatePicker (Safari/WebKit)**:\n - **Uncontrolled input**: Switched to uncontrolled `` (defaultValue only, no value=) so the native control owns segment state; prevents React from overwriting with empty and fixes month/day resetting and year showing 0001/0002 while typing.\n - **No clear on empty onChange**: Safari often fires change with an empty value when focusing the year segment or mid-typing; we no longer clear or call onSelectDate(cleared) in onChange. Clearing only happens on blur (field left empty) or Clear button.\n - **Partial-year guard**: Only accept dates with year 1000–9999 in change/blur; ignore placeholder years (0002, 0020, 0202) so we don’t overwrite the field or steal focus when typing the year digit-by-digit.\n - **Sync effect**: When `startingSelectedDate` is falsy or invalid, the effect no longer clears the input (user may be mid-typing). We only push from parent when the prop has a valid date; sync is done by writing to `inputRef.current.value`.\n - **Clear button**: When clearing, we set `inputRef.current.value = ''` so the DOM stays in sync.\n - **Blur**: On blur with empty value we clear and notify parent; on blur with valid full date (year 1000–9999) we commit and call onSelectDate.\n\n### Documentation\n- **GenericDatePicker Safari limitation**: Documented that in Safari/WebKit, typing in the native date input with a pause in a segment (e.g. year) can cause the next keystroke to replace rather than append (e.g. \"0\" then \"2\" may show \"2\" instead of \"02\"). This is browser behavior. Workaround: type the segment without pausing, or use the calendar picker. A text-field alternative (parse on blur) is noted as a possible future improvement in the component header.\n\n## [1.0.23] 2026-01-27 @dwertheimer\n\n### Changed\n- **Simplified form submission response handling**: `handleSubmitButtonClick` and related functions now return only the necessary information (`success`, `formSubmissionError`, `aiAnalysisResult`) instead of the full `reactWindowData` object. This simplifies the code and avoids unnecessary data passing. The window only needs to know what happened, not all the window data.\n\n### Fixed\n- **Form Browser \"Submitting...\" overlay**: The overlay now appears reliably when submitting a form from the Form Browser. Uses `flushSync` so React commits the overlay to the DOM before the async request runs (avoids WebView/rAF timing issues). Added a minimum display time of 400 ms so the overlay is always visible even when the request completes quickly.\n\n### Edited in this release\n- `dwertheimer.Forms/src/formSubmission.js` — Simplified `handleSubmitButtonClick` and processing functions to return `{ success: boolean, formSubmissionError?: string, aiAnalysisResult?: string }` instead of full `PassedData`. Removed unnecessary `withPluginDataUpdates` usage.\n- `dwertheimer.Forms/src/formSubmitHandlers.js` — Updated to handle simplified return type from `handleSubmitButtonClick`.\n- `dwertheimer.Forms/src/formBrowserHandlers.js` — Updated to handle simplified return type from `handleSubmitButtonClick`.\n- `dwertheimer.Forms/src/components/FormBrowserView.jsx` — Submitting overlay: use `flushSync` to commit overlay before request; `hideOverlay()` with 400 ms minimum display time; `overlayShownAtRef` for timing.\n\n## [1.0.22] 2026-01-27 @dwertheimer\n\n### Changed\n- **ValueInsertButtons use shared constants**: The +Color, +Icon, +Pattern, and +IconStyle insert buttons (ValueInsertButtons) now import `PATTERNS`, `ICON_STYLES`, and `FA_ICON_NAMES` from `@helpers/react/DynamicDialog/valueInsertData`, so they use the same options as the color/icon/pattern/icon-style choosers in the Form Builder.\n\n### Edited in this release\n- `dwertheimer.Forms/src/components/ValueInsertButtons.jsx` — Replaced inline PATTERNS, ICON_STYLES, FA_ICON_NAMES with imports from valueInsertData.\n\n## [1.0.21] 2026-01-27 / 2026-02-03 @dwertheimer\n\n### Fixed (from fix branch)\n- **Conditional-values excluded from form until submit**: Fields with type `conditional-values` (e.g. `bgColor` derived from a button-group) are no longer added to form state, autosave, or the submit payload until the backend runs `resolveConditionalValuesFields` in `prepareFormValuesForRendering`. Previously they appeared with empty values in the form and autosave.\n- **Button-group default applied on open and submit**: When a form field has type `button-group` and an option with `isDefault: true`, that option's value is now used as the initial value when the form opens and when building the submit payload, so the source field (e.g. `theType`) is set correctly and conditional-values (e.g. `bgColor`) resolve as intended.\n\n### Changed (from main)\n- **formProcessorTitle eliminated**: Deprecated `formProcessorTitle` in favor of `receivingTemplateTitle` as the single canonical field. The two were redundant and could get out of sync. Going forward only `receivingTemplateTitle` is used/written.\n - **Backward compatible**: Forms with only `formProcessorTitle` (legacy) are still read correctly everywhere. On save, the value is migrated to `receivingTemplateTitle` and `formProcessorTitle` is removed from the note.\n - TemplateRunner and form submission have always used `receivingTemplateTitle`; `formProcessorTitle` was only used in the Form Builder UI and could cause duplication.\n\n### Edited in this release\n- `dwertheimer.Forms/src/formSubmission.js` — `ensureAllFormFieldsExist` and `handleSubmitButtonClick` skip conditional-values when adding missing fields.\n- `dwertheimer.Forms/src/formBrowserHandlers.js` — `handleSubmitForm` skips conditional-values when adding missing fields.\n- `helpers/react/DynamicDialog/DynamicDialog.jsx` — `getInitialItemStateObject`, \"ensure all fields\" effect, and `handleSave` skip conditional-values and apply button-group `isDefault` when initializing or filling missing keys.\n\n## [1.0.20] 2026-01-26 @dwertheimer\n\n### Fixed\n- **DynamicDialog Switch compact mode**: Switch type now renders correctly in compact mode. Label is on the left and the switch on the right, matching other compactDisplay elements (InputBox, button-group, calendarpicker). Uses `input-box-container-compact` wrapper; Switch’s internal label is hidden via CSS when compact.\n\n## [1.0.19] 2026-01-26 @dwertheimer\n\n### Fixed\n- **Create-new folder override**: When creating a new note, a form field named `folder` now overrides any folder value from the form definition (newNoteFolder, template frontmatter, etc.) when passing data to templateRunner. Empty form `folder` is ignored; form definition is used as fallback.\n\n### Changed\n- **ProcessingMethodSection**: Folder field help text now states that a form field named `folder` is used to set the folder for the new note.\n\n## [1.0.18] 2026-01-25 @dwertheimer\n\n### Fixed\n- **Form Field Focus Styles**: Updated all form field focus styles to use `--tint-color` with a heavier 2px border stroke for better visibility:\n - Input boxes, dropdowns, textareas, date pickers, and all chooser components now show a prominent `--tint-color` border when focused\n - Added consistent box-shadow glow effect for all focused fields\n - Fixed SearchableChooser focus styles to properly override base border styles using `!important` flags\n- **SearchableChooser Loading State**: Fixed multiple issues with SearchableChooser when fields are loading data:\n - **Loading Spinner**: Added FontAwesome spinner icon (`fa-spinner fa-spin`) that appears in the input field when loading. Spinner is properly centered vertically and positioned on the right side of the input.\n - **Auto-Open Prevention**: Fixed issue where dropdown would auto-open when field received focus but items were still loading, showing \"No Options Available\" instead of loading state. Dropdown now only opens automatically when items have finished loading.\n - **Placeholder Management**: Fixed placeholder to show \"Loading Values...\" from initial render when loading is needed, preventing visual flip from \"Type to search values...\" to \"Loading Values...\".\n - **Focus Management**: Fixed focus behavior so that when the first field finishes loading, focus automatically moves back to it if focus was previously set on a later field (e.g., 3rd field) while the first field was loading.\n - **Empty State Blank Line**: Fixed issue where a blank, clickable line appeared in the dropdown when showing \"No Options Available\". Removed validation-message-placeholder div from dropdown options and made empty state non-clickable.\n - **Loading State Propagation**: Added `isLoading` prop support to `DropdownSelectChooser` and `ContainedMultiSelectChooser` to properly show loading state in all chooser variants.\n- **FrontmatterKeyChooser Loading Initialization**: Fixed loading state initialization to start as `true` when a frontmatterKey is provided, ensuring \"Loading Values...\" placeholder appears immediately instead of showing normal placeholder first.\n- **SearchableChooser Color Override**: Fixed issue where inline color styles were overriding the default CSS color (`var(--fg-main-color, #4c4f69)`) even when `optionColor` was `null`, `undefined`, or the default `'gray-500'` value. Now only applies inline color styles when an explicit non-default color is provided, allowing the CSS default to be used otherwise.\n\n### Changed\n- **SearchableChooser Loading UX**: Improved loading experience by showing spinner icon and wait cursor, preventing dropdown from opening prematurely, and ensuring proper focus management when loading completes.\n- **EventChooser Icon**: Updated EventChooser dropdown icon from `fa-calendar` to `fa-solid fa-calendar-alt` for a more specific calendar-related icon that better represents event selection.\n- **SearchableChooser CSS Improvements**: \n - Fixed loading spinner vertical centering (changed from `top: 56%` to `top: 50%` with proper transform)\n - Improved spinner sizing to match arrow icon size (0.75rem) with proper line-height and height constraints\n - Fixed dropdown portal spacing issues by removing fixed min-height and ensuring no extra padding/margins\n - Fixed last option spacing to maintain consistent padding\n- **SearchableChooser Filtering**: Enhanced default filter to also exclude blank/whitespace-only options in addition to templating syntax, preventing empty options from appearing in dropdown lists.\n\n## [1.0.17] 2026-01-25 @dwertheimer\n\n### Fixed\n- **SearchableChooser Templating Field Filter**: Fixed SearchableChooser to automatically filter out options containing templating fields (e.g., containing \"<%\") by default. This prevents templating syntax from appearing in frontmatter key chooser and other dropdown option lists.\n- **SearchableChooser Manual Entry Indicator**: Fixed issue where the pencil icon (manual entry indicator) was incorrectly appearing in empty/blank fields. The indicator now only appears when a non-empty value has been entered that is not in the items list, and only after the items list has finished loading.\n- **Frontmatter Key Values Filtering**: Fixed `getFrontmatterKeyValues` to filter out templating syntax values (containing \"<%\") at the source, preventing templating errors when forms load. Templating syntax values are now excluded from frontmatter key chooser dropdowns.\n- **ContainedMultiSelectChooser Create Mode**: Fixed issue where ContainedMultiSelectChooser was not allowing creation of new items when the list was empty. Now allows creating new items even when `items.length === 0`, as long as `allowCreate` is true and there's a search term with no matches.\n\n### Changed\n- **GenericDatePicker Calendar Auto-Close**: Improved date picker UX by automatically closing the calendar picker immediately after selecting a date. Previously, users had to click the date and then click outside the picker to close it. Now a single click on a date both selects it and closes the calendar.\n- **SearchableChooser Debug Logging**: Added comprehensive debug logging to SearchableChooser to help diagnose manual entry indicator issues. Logs include value checks, placeholder matching, and manual entry determination logic.\n- **FormBuilder Create-New Mode Fields**: Split \"Content to Insert\" into two separate fields when processing method is \"Create New Note\":\n - **New Note Frontmatter**: Separate field for frontmatter content (saved to `template:ignore newNoteFrontmatter` codeblock)\n - **New Note Body Content**: Renamed from \"Content to Insert\" to clarify it's the body content (saved to `template:ignore templateBody` codeblock)\n - Frontmatter and body content are automatically combined with `--` delimiters when sending to TemplateRunner\n - Fields are ordered with Frontmatter above Body Content for better workflow\n- **TemplateTagEditor Raw Mode**: All template tag editor fields (NewNoteTitle, Content to Insert, New Note Frontmatter, New Note Body Content) now default to raw mode with the toggle hidden, showing monospace text directly instead of pill/chip display for better readability\n\n## [1.0.16] 2026-01-19 @dwertheimer\n\n### Added\n- **NoteChooser Output Formats**: Added new output format options for note chooser fields:\n - **Multi-select mode**: Added `'title'` and `'filename'` output formats (in addition to existing `'wikilink'`, `'pretty-link'`, `'raw-url'`). These return plain note titles or filenames without any formatting.\n - **Single-select mode**: Added `singleSelectOutputFormat` option to choose between outputting the note title (default) or filename when a single note is selected.\n- **NoteChooser Filtering Options**: Added advanced filtering capabilities to note chooser fields:\n - **Start Folder**: Filter notes to only show those in a specific folder and its subfolders (e.g., `'@Templates'`).\n - **Include Regex**: Optional regex pattern to include only notes whose title or filename matches (case-insensitive).\n - **Exclude Regex**: Optional regex pattern to exclude notes whose title or filename matches (case-insensitive).\n- **SearchableChooser ShortDescription Optimization**: Added automatic shortening of short descriptions to just the final folder name when the option row is too narrow, ensuring the label text takes precedence and remains fully visible.\n\n### Changed\n- **FormView CSS**: Reverted compact label width to 10rem (from 20rem) while keeping input width at 360px (2x the original 180px). This provides better balance between label and input field sizing.\n\n## [1.0.15] 2026-01-18 @dwertheimer\n\n### Fixed\n- **CRITICAL: Null Value Handling**: Fixed `TypeError: null is not an object (evaluating 'Object.getOwnPropertyNames')` error that occurred when templating plugin tried to process form data containing null values. Added explicit null checks in `JSP`, `getFilteredProps`, and `getAllPropertyNames` helper functions to handle null values correctly (since `typeof null === 'object'` in JavaScript).\n- **Form Submission Success Detection**: Fixed issue where successful form submissions were incorrectly flagged as errors. When `templateRunner` successfully creates a note via `templateNew`, it returns `undefined` (which is valid), but the code was treating this as an error. Now only `null` or empty strings are treated as errors.\n- **Deep Null Sanitization**: Added comprehensive deep sanitization of null/undefined values throughout form data processing. All null/undefined values are now converted to empty strings recursively before being passed to the templating engine, preventing errors in nested data structures.\n- **setTimeout Removal**: Removed `setTimeout` usage in form submission handlers (not available in NotePlan's JSContext). Replaced with proactive cleanup mechanism using a Map to manage debouncing without timeouts.\n\n### Changed\n- **templateNew Return Value**: Updated `templateNew` to return the filename (string) on success or `null` on failure, making the API more consistent and explicit. Previously returned `undefined`, which made it difficult to distinguish success from failure.\n- **templateRunner Return Value**: Updated `templateRunner` to return the filename when a note is successfully created, instead of returning `undefined`. This provides explicit feedback about successful operations.\n- **Error Messages**: Improved error messages to be more specific about null value issues and provide better guidance for debugging template execution problems.\n\n## [1.0.14] 2026-01-19 @dwertheimer\n\n### Changed\n- **Default Window Width**: Changed default window width for new forms from 25% to 50% when creating a new form in the form builder\n- **Default Compact Field Sizes**: Doubled the default compact field sizes - labels now default to 20rem (was 10rem) and inputs default to 360px (was 180px)\n\n## [1.0.13] 2026-01-18 @dwertheimer\n\n### Changed\n- **CSS Color Variables**: Updated FormBrowserView.css, SimpleDialog.css, DynamicDialog.css, and FormBuilder.css to use only valid NotePlan theme color variables, removing non-existent variables and hard-coded color fallbacks. All colors now properly reference the theme system with appropriate fallback values. Variations on theme colors use `color-mix()` for hover states and semi-transparent overlays.\n- **FormPreview**: Added `showScaledDisclaimer` prop to control when the scaled preview warning toast is shown. The toast now only appears in FormBuilder (when `showScaledDisclaimer={true}` is passed), not in FormBrowserView or other contexts.\n- **Form Browser**: Replaced SimpleDialog success message with Toast notification. Success messages now appear as non-intrusive toasts, and notes are automatically opened after successful submission.\n\n### Fixed\n- **Form Browser**: Updated `getFormTemplates` to search for forms in both `@Forms` and `@Templates` folders, making it consistent with other parts of the plugin (e.g., Form Builder). Previously, the Form Browser only found forms in `@Forms` folder.\n- **Form Submission**: Fixed issue where empty form fields were not included in form submission. All fields from the form definition are now included in `formValues`, even if left blank, ensuring templates receive all expected variables. This fix applies to both FormView and FormPreview via DynamicDialog.\n- **Form Builder - Target Note Field**: Fixed issue where selecting special options like \"Current Note\" or \"Choose Note\" in the Target Note field was submitting the display label (e.g., \"Current Note\") instead of the template value (e.g., \"\"). Now correctly uses the template value for special options while preserving note titles for regular notes.\n\n## [1.0.12] 2026-01-17 @dwertheimer\n\n### Added\n\n### Fixed\n\n### Changed\n- **FormView**: Set text color of dialog to main color for better readability\nUnder the hood changes to move all window opening code to the windowManagement.js file.\n\n\n## [1.0.11] 2026-01-17 @dwertheimer\n\n### Added\n- **Multi-select NoteChooser**: Added ability to select multiple notes in a note-chooser field with configurable output format (wikilink, pretty-link, raw-url) and separator (space, comma, newline)\n- **Calendar Picker Button Control**: Added setting in FieldEditor to control visibility of calendar picker button in note-chooser fields\n- **Form Tester Examples**: Added multi-select note chooser examples to Form Tester with different output formats and separators\n- **Calendar Picker Date Format Setting**: Added configurable output format for calendarpicker fields using moment.js formatting:\n - Default format is ISO 8601 (YYYY-MM-DD) instead of returning Date object\n - Choose from 30+ date format options (US format, European format, long format, date & time, etc.)\n - Use `[Object]` option to return Date object for backward compatibility\n - Formatting applies when selecting from calendar picker or typing directly in the input field\n - Supports locale-aware formatting using moment-with-locales based on NotePlan environment settings\n\n### Fixed\n- Fixed calendar picker button showing when \"Include Calendar Notes\" is disabled - now only shows when calendar notes are included (or explicitly enabled via setting)\n- Fixed multi-select NoteChooser not rendering correctly - now properly detects `allowMultiSelect` prop and renders ContainedMultiSelectChooser instead of dropdown\n- Fixed syntax error in NoteChooser.jsx that prevented Rollup from building (replaced Flow type guard with explicit array building)\n\n### Changed\n- **NoteChooser**: Calendar picker button now respects \"Include Calendar Notes\" setting by default - only appears when calendar notes are included\n- **FieldEditor**: Added \"Show Calendar Picker Button\" checkbox in note-chooser field editor for explicit control\n- **NoteChooser**: Multi-select mode uses ContainedMultiSelectChooser component with checkboxes for better UX\n- **CalendarPicker**: Default behavior changed from returning Date object to returning ISO 8601 formatted string (YYYY-MM-DD) - use `dateFormat: '__object__'` to return Date object\n- **CalendarPicker**: Dates typed directly in the input field are now parsed and formatted according to the selected dateFormat option\n- **FolderChooser**: Static options (like `` to choose each time)\n- **Space**: Private or a specific Teamspace\n- **Note Content**: Write a template using form fields like:\n ```\n # <%- projectName %>\n \n **Start Date:** <%- startDate %>\n **Team:** <%- team %>\n \n ## Description\n <%- description %>\n ```\n\n#### Writing to Existing Notes\n\nPerfect for: Adding to today's note, logging entries, appending to project notes, etc.\n\n**Configuration:**\n- **Target Note**: \n - `` - Today's daily note\n - `` - Currently open note\n - `` - Prompt to choose note each time\n - Specific note title\n- **Write Location**: Where to add content\n - **Append** - Add to end of note\n - **Prepend** - Add to beginning of note\n - **Under Heading** - Add under a specific heading\n- **Content Template**: What to write using form fields\n\n### Tips for Form Builder\n\n- **Start Simple**: Create a form with just 2-3 fields first to learn how it works\n- **Use Descriptions**: Help text makes forms easier to use\n- **Test Early**: Use \"Open Form\" button frequently to test as you build\n- **Use Headings**: Group related fields with heading elements\n- **Add Separators**: Visual dividers help organize long forms\n- **Preview Updates Live**: The preview pane shows changes as you make them\n\n## Using Forms\n\n### Launching a Form\n\n**Method 1: Command Bar** (easiest)\n1. Type `/form` or `/dialog`\n2. Select your form from the list\n3. Fill out and submit\n\n**Method 2: x-callback URL Link**\n\nWhen you create a form, a launch link is automatically added to the top of your form template. Copy that link and paste it anywhere (daily notes, project notes, etc.) to launch the form with one click.\n\nExample: `[Launch My Form](noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.Forms&command=Open%20Template%20Form&arg0=My%20Form)`\n\n**Method 3: Auto-Open on Note Open** (advanced)\n\nForms can auto-open when you open certain notes by adding this to the note's frontmatter:\n```yaml\ntriggers: onOpen => dwertheimer.Forms.triggerOpenForm\n```\n\n### Form Browser\n\nView all your forms in a browsable interface:\n\nType `/browser` or `/formbrowser`\n\nThe Form Browser shows all your forms in a two-column layout where you can:\n- Browse available forms\n- Preview form details\n- Launch forms directly\n- Edit forms in Form Builder\n\n## Available Field Types\n\nThe Form Builder includes these field types:\n\n### Basic Fields\n- **Text Input** - Single-line text\n- **Textarea** - Multi-line text (expandable)\n- **Number** - Numeric input with +/- buttons\n- **Read-only Field** - Display-only text\n\n### Selection Fields\n- **Dropdown** - Select from a list\n- **Switch** - Toggle on/off\n- **Button Group** - Choose one option from buttons\n\n### Date & Time\n- **Date Picker** - Calendar for selecting dates\n\n### NotePlan Selectors\n- **Note Chooser** - Search and select a note (supports single or multi-select with configurable output format)\n- **Folder Chooser** - Search and select a folder\n- **Space Chooser** - Select Private or a Teamspace\n- **Heading Chooser** - Select a heading from a note\n- **Event Chooser** - Select a calendar event\n- **Tag Chooser** - Select multiple hashtags\n- **Mention Chooser** - Select multiple @mentions\n- **Frontmatter Key Chooser** - Select values from frontmatter keys across notes\n\n### Display Elements\n- **Heading** - Section title\n- **Separator** - Horizontal divider line\n- **Text** - Instructions or descriptions\n- **Markdown Preview** - Display formatted markdown content\n- **Table of Contents** - Clickable links to form sections\n\n### Advanced Fields\n- **Hidden Field** - Store data without displaying it\n- **JSON Editor** - Edit JSON data\n- **Button** - Clickable action button\n- **Autosave** - Auto-save form progress\n- **TemplateJS Block** - Execute JavaScript code (advanced)\n\n## Additional Commands\n\n### Restore from Autosave\n\nForms automatically save your progress. If a form is closed before submitting, you can restore it:\n\nType `/restoreautosave` or `/restoreform`\n\nAutosave files are stored in `@Trash/Autosave-{timestamp}` by default.\n\n### Form Browser\n\nBrowse all your forms in a visual interface:\n\nType `/browser` or `/formbrowser`\n\nCan open as a floating window: `/formbrowser true`\n\n## Plugin Settings\n\nThe Forms plugin has one main setting:\n\n**Enable Autosave for All Forms** (default: ON)\n- When enabled, all forms automatically save progress every 30 seconds\n- Protects against data loss from crashes or accidental closes\n- Autosave files are stored in @Trash folder\n\nYou can disable this globally and add autosave to specific forms only if preferred.\n\n## Tips and Best Practices\n\n1. **Start with the Form Builder** - Don't try to edit JSON manually\n2. **Test frequently** - Use the \"Open Form\" button to test as you build\n3. **Use meaningful field labels** - Clear labels make forms easy to use\n4. **Add descriptions** - Help text prevents confusion\n5. **Set good defaults** - Pre-fill common values to save time\n6. **Group with headings** - Organize long forms with section headings\n7. **Use conditional fields** - Hide advanced fields until needed (use `dependsOnKey`)\n8. **Create separate forms for different use cases** - Don't try to make one giant form do everything\n\n## Troubleshooting\n\n### Form won't open\n- Check Plugin Console (NotePlan → Help → Plugin Console) for errors\n- Try re-saving the form in Form Builder\n- Make sure the form template has `type: template-form` in frontmatter\n\n### Form doesn't save data correctly\n- Check your output configuration in Form Builder\n- For \"Create New Note\": Verify folder path and note title template\n- For \"Write to Existing Note\": Verify target note exists\n- Check Plugin Console for error messages\n\n### Form Builder shows errors\n- Close and reopen Form Builder\n- Check Plugin Console for details\n- Try creating a new simple form to test\n\n### Lost form data\n- Check @Trash folder for autosave files\n- Use `/restoreautosave` command\n- Enable autosave in plugin settings if it's disabled\n\n---\n\n## Advanced Topics\n\n**Most users won't need anything below this line.** The sections below are for advanced users who need custom processing logic or want to understand the underlying structure.\n\n### Preloading Chooser Data for Static HTML Testing\n\nWhen developing or testing forms, you may want to open the saved HTML file in Chrome without being connected to NotePlan. By default, chooser fields (folder-chooser, note-chooser, space-chooser, etc.) load their data dynamically from NotePlan, which requires an active connection.\n\n**To enable preloaded data:**\n\nAdd this to your form's frontmatter:\n\n```yaml\npreloadChooserData: true\n```\n\nWhen `preloadChooserData: true` is set, the form will preload all chooser data when the HTML file is created:\n- **Folders** - All folders for folder-chooser fields\n- **Notes** - All notes for note-chooser fields \n- **Teamspaces** - All teamspaces for space-chooser and folder-chooser decoration\n- **Mentions** - All mentions for mention-chooser fields\n- **Hashtags** - All hashtags for tag-chooser fields\n\nThe preloaded data is embedded in the saved HTML file (`form_output.html`), allowing you to:\n- Test the form in Chrome without NotePlan\n- Debug CSS and layout issues\n- Share static HTML files for design review\n\n**Note:** Preloaded data is a snapshot taken when the HTML is generated. For production use, leave `preloadChooserData` unset (or `false`) to use dynamic loading for up-to-date data.\n\n### Custom Processing Templates\n\nFor advanced use cases that can't be handled by the Form Builder's built-in options, you can create custom processing templates.\n\n**When you might need this:**\n- Complex conditional logic beyond what Form Builder supports\n- Advanced date/time calculations\n- Integration with other plugins\n- Custom note structure generation\n\n**Creating a Processing Template:**\n\n1. Run `/createprocessor` or `/newprocessor`\n2. Follow the wizard to set up basic configuration\n3. Edit the template to add custom logic using EJS templating\n\n**Processing Template Structure:**\n\n```yaml\n---\ntitle: My Processing Template\ntype: forms-processor\nnewNoteTitle: <%- fieldName %>\nfolder: /Projects\n---\n# Template body here\nUse form fields like: <%- fieldName %>\n```\n\nAll form field `key` values become variables in your template.\n\n**Dynamic Template Selection:**\n\nYou can allow users to choose which processing template to use by adding a `note-chooser` field with the key `receivingTemplateTitle` to your form. This enables dynamic template selection at form submission time.\n\n**How it works:**\n- Add a `note-chooser` field to your form\n- Set the field's `key` to exactly `receivingTemplateTitle`\n- When the form is submitted, the selected note's title will be used as the processing template\n- If no template is selected in the form field, the system falls back to the `receivingTemplateTitle` set in the form's frontmatter (if present)\n\n**Example form field definition:**\n```json\n{\n \"type\": \"note-chooser\",\n \"key\": \"receivingTemplateTitle\",\n \"label\": \"Choose Processing Template\",\n \"includePersonalNotes\": true,\n \"includeTemplatesAndForms\": true,\n \"startFolder\": \"@Templates\",\n \"includeRegex\": \"^Template\",\n \"description\": \"Select which template should process this form submission\"\n}\n```\n\n**Use cases:**\n- Allow users to choose between different processing templates (e.g., \"Meeting Template\" vs \"Project Template\")\n- Create a single form that can route to different processing templates based on user selection\n- Enable dynamic workflow routing based on form data\n\n**Note:** The form must have `processingMethod: \"form-processor\"` set in its frontmatter. The `receivingTemplateTitle` field value takes precedence over the frontmatter value when a template is selected in the form.\n\n**Date Formatting Example:**\n\n```ejs\n<%- startDate ? date.format(\"YYYY-MM-DD\", startDate) : '' %>\n```\n\n**Conditional Logic Example:**\n\n```ejs\n<% if (isUrgent) { %>\n**URGENT:** Requires immediate attention\n<% } %>\n```\n\n### Processing Methods\n\nThe Form Builder uses these processing methods:\n\n1. **form-processor** - Uses a custom processing template (advanced)\n2. **create-new** - Creates a new note (handled by Form Builder)\n3. **write-existing** - Writes to existing note (handled by Form Builder)\n4. **run-js-only** - Executes JavaScript only (advanced, requires TemplateJS Block fields)\n\n### Manual Template Editing\n\n**You typically don't need this** - use Form Builder instead!\n\nForm templates are stored as NotePlan notes with:\n- `type: template-form` in frontmatter\n- A `formfields` code block with JSON array of field definitions\n- Optional launch links (auto-generated by Form Builder)\n\nSee the end of this document for complete JSON field reference if you need to edit manually.\n\n### TemplateJS Blocks\n\nFor executing custom JavaScript during form processing:\n\n1. Add a \"TemplateJS Block\" field in Form Builder\n2. Write JavaScript code that executes when form is submitted\n3. Useful for: creating folders, moving files, custom data processing\n\nExample:\n```javascript\n// Create a folder based on form data\nconst folderPath = `${parentFolder}/${projectName}`;\nDataStore.createFolder(folderPath);\n```\n\n### Reserved Field Keys\n\nDon't use these as field keys (the plugin uses them internally):\n- `__isJSON__`, `submit`, `location`, `writeUnderHeading`\n- `openNoteTitle`, `writeNoteTitle`, `getNoteTitled`\n- `replaceNoteContents`, `createMissingHeading`\n- `windowTitle`, `formTitle`\n- `width`, `height`, `hideDependentItems`, `allowEmptySubmit`, `title`\n\n**Exception:** `receivingTemplateTitle` can be used as a field key if you want to allow users to dynamically select the processing template. See \"Dynamic Template Selection\" in the Custom Processing Templates section above.\n\n---\n\n## Complete Field Reference (Advanced)\n\n**Note:** You typically don't need this - the Form Builder provides a visual interface for all field types. This reference is for users who need to manually edit form JSON or understand field properties in detail.\n\n### Common Field Properties\n\nAll fields support these properties:\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `key` | string | Variable name (required for most types) |\n| `label` | string | Field label displayed to user |\n| `type` | string | Field type (required) |\n| `description` | string | Help text shown below field |\n| `default` | any | Default value for the field |\n| `value` | any | Initial/current value |\n| `compactDisplay` | boolean | Label and field side-by-side |\n| `dependsOnKey` | string | Make field conditional on another field |\n| `required` | boolean | Field must be filled |\n| `placeholder` | string | Placeholder text (for input fields) |\n\n### Input Field Types\n\n**`input`** - Text input field\n```javascript\n{\n key: 'projectName',\n label: 'Project Name',\n type: 'input',\n required: true,\n compactDisplay: true,\n validationType: 'email' // optional: 'email', 'number', 'date-interval'\n}\n```\n\n**`textarea`** - Multi-line expandable text field\n```javascript\n{\n key: 'description',\n label: 'Description',\n type: 'textarea',\n placeholder: 'Enter description...'\n}\n```\n\n**`number`** - Numeric input\n```javascript\n{\n key: 'quantity',\n label: 'Quantity',\n type: 'number',\n default: 1,\n step: 1 // increment amount\n}\n```\n\n**`input-readonly`** - Read-only display field\n```javascript\n{\n key: 'displayOnly',\n label: 'Read-only',\n type: 'input-readonly',\n value: 'Cannot be changed'\n}\n```\n\n### Selection Field Types\n\n**`dropdown-select`** - Simple dropdown\n```javascript\n{\n key: 'team',\n label: 'Team',\n type: 'dropdown-select',\n options: ['Alpha', 'Beta', 'Charlie'],\n // or with explicit values:\n // options: [{label: 'Alpha', value: 'a'}, {label: 'Beta', value: 'b'}],\n default: 'Beta'\n}\n```\n\n**`switch`** - Toggle on/off\n```javascript\n{\n key: 'isUrgent',\n label: 'Urgent',\n type: 'switch',\n default: false\n}\n```\n\n**`button-group`** - Mutually exclusive buttons\n```javascript\n{\n key: 'priority',\n label: 'Priority',\n type: 'button-group',\n options: [\n {label: 'High', value: 'high'},\n {label: 'Medium', value: 'med', isDefault: true},\n {label: 'Low', value: 'low'}\n ],\n vertical: false // true to stack vertically\n}\n```\n\n### Date Field Types\n\n**`calendarpicker`** - Date picker with configurable output format\n```javascript\n{\n key: 'dueDate',\n label: 'Due Date',\n type: 'calendarpicker',\n buttonText: 'Select Date',\n visible: false, // true to show calendar by default\n numberOfMonths: 1,\n size: 0.75, // scale factor\n dateFormat: 'YYYY-MM-DD', // moment.js format string (default: 'YYYY-MM-DD' ISO 8601)\n // Use '__object__' to return Date object instead of formatted string\n // Examples:\n // dateFormat: 'MM/DD/YYYY' - US format (12/25/2024)\n // dateFormat: 'DD/MM/YYYY' - European format (25/12/2024)\n // dateFormat: 'MMMM Do, YYYY' - Long format (December 25th, 2024)\n // dateFormat: 'YYYY-MM-DD HH:mm' - ISO with time (2024-12-25 14:30)\n // dateFormat: '__object__' - Returns Date object\n}\n```\n\n### NotePlan Chooser Field Types\n\n**`note-chooser`** - Searchable note selector (single or multi-select)\n```javascript\n{\n key: 'targetNote',\n label: 'Select Note',\n type: 'note-chooser',\n placeholder: 'Search notes...',\n showValue: false, // false=show title, true=show filename\n // Multi-select options:\n allowMultiSelect: true, // Enable multi-select mode (default: false)\n noteOutputFormat: 'wikilink', // 'wikilink' | 'pretty-link' | 'raw-url' (default: 'wikilink')\n noteSeparator: 'space', // 'space' | 'comma' | 'newline' (default: 'space')\n // Filter options:\n includePersonalNotes: true, // Include personal/project notes (default: true)\n includeCalendarNotes: false, // Include calendar notes (default: false)\n includeRelativeNotes: false, // Include relative notes like (default: false)\n includeTeamspaceNotes: true, // Include teamspace notes (default: true)\n includeTemplatesAndForms: false, // Include @Templates and @Forms folders (default: false)\n // Display options:\n showCalendarChooserIcon: true, // Show calendar picker button (default: true if calendar notes included)\n showTitleOnly: false, // Show only title, not path/title (default: false)\n shortDescriptionOnLine2: false // Show description on second line (default: false)\n}\n```\n\n**`folder-chooser`** - Searchable folder selector\n```javascript\n{\n key: 'targetFolder',\n label: 'Select Folder',\n type: 'folder-chooser',\n placeholder: 'Search folders...',\n includeNewFolderOption: true, // Allow creating new folders\n staticOptions: [ // Static options that appear at top of list\n { label: 'Select...', value: '` which prompts the user each time.\n- `sourceSpaceKey` (string) - Value dependency: key of a space-chooser field to filter folders by space\n\n**`space-chooser`** - Space/Teamspace selector\n```javascript\n{\n key: 'space',\n label: 'Space',\n type: 'space-chooser',\n placeholder: 'Select space...'\n}\n```\n\n**`heading-chooser`** - Heading selector (static or dynamic)\n```javascript\n{\n key: 'heading',\n label: 'Select Heading',\n type: 'heading-chooser',\n noteFilename: 'project.md', // static note\n // OR\n noteFieldKey: 'targetNote', // get note from another field\n placeholder: 'Select heading...'\n}\n```\n\n**`event-chooser`** - Calendar event selector\n```javascript\n{\n key: 'meeting',\n label: 'Select Event',\n type: 'event-chooser',\n date: '2024-01-15', // static date\n // OR\n dateFieldKey: 'eventDate', // get date from another field\n placeholder: 'Select event...'\n}\n```\n\n**`tag-chooser`** - Multi-select hashtags\n```javascript\n{\n key: 'tags',\n label: 'Tags',\n type: 'tag-chooser',\n returnAsArray: false,\n valueSeparator: 'commaSpace' // when string: 'comma' | 'commaSpace' | 'space' (default: commaSpace)\n}\n```\n\n**`mention-chooser`** - Multi-select @mentions\n```javascript\n{\n key: 'people',\n label: 'People',\n type: 'mention-chooser',\n returnAsArray: false,\n valueSeparator: 'commaSpace' // when string: 'comma' | 'commaSpace' | 'space' (default: commaSpace)\n}\n```\n\n**`frontmatter-key-chooser`** - Frontmatter value selector\n```javascript\n{\n key: 'status',\n label: 'Status',\n type: 'frontmatter-key-chooser',\n frontmatterKey: 'status', // which frontmatter key to search\n returnAsArray: false,\n valueSeparator: 'commaSpace' // when string: 'comma' | 'commaSpace' | 'space' (default: commaSpace)\n}\n```\n\n### Display Field Types\n\n**`heading`** - Section heading\n```javascript\n{\n type: 'heading',\n label: 'Section Title',\n description: 'Optional subtitle'\n}\n```\n\n**`separator`** - Horizontal line\n```javascript\n{\n type: 'separator'\n}\n```\n\n**`text`** - Display-only text\n```javascript\n{\n type: 'text',\n label: 'Instructions text here',\n textType: 'description' // 'title', 'description', or 'separator'\n}\n```\n\n**`markdown-preview`** - Display markdown\n```javascript\n{\n type: 'markdown-preview',\n content: '# Hello\\n\\nMarkdown content', // static content\n // OR\n noteFilename: 'preview.md', // load from note\n // OR\n noteFieldKey: 'selectedNote', // load from another field\n height: 300 // optional fixed height\n}\n```\n\n**`table-of-contents`** - Clickable form section links\n```javascript\n{\n type: 'table-of-contents',\n label: 'Form Sections'\n}\n```\n\n### Advanced Field Types\n\n**`hidden`** - Hidden field (not displayed)\n```javascript\n{\n key: 'hiddenData',\n type: 'hidden',\n value: 'some-value'\n}\n```\n\n**`json`** - JSON editor\n```javascript\n{\n key: 'metadata',\n label: 'Metadata',\n type: 'json',\n default: {}\n}\n```\n\n**`button`** - Clickable button\n```javascript\n{\n key: 'actionBtn',\n type: 'button',\n label: 'Click Me',\n isDefault: false // true for primary styling\n}\n```\n\n**`autosave`** - Auto-save form state\n```javascript\n{\n type: 'autosave',\n key: 'formAutosave',\n saveLocation: '@Trash/Autosave-',\n autoSaveInterval: 30000, // milliseconds\n showStatus: true\n}\n```\n\n**`templatejs-block`** - JavaScript execution (advanced)\n```javascript\n{\n type: 'templatejs-block',\n key: 'myScript',\n label: 'Script',\n templateJSContent: 'const result = await doSomething(); return result;',\n executeTiming: 'after' // 'before' or 'after'\n}\n```\n\n### Conditional Fields\n\nMake fields dependent on other fields:\n\n```javascript\n{\n key: 'showAdvanced',\n label: 'Show Advanced',\n type: 'switch',\n default: false\n},\n{\n key: 'advancedOption',\n label: 'Advanced Option',\n type: 'input',\n dependsOnKey: 'showAdvanced' // only enabled when showAdvanced is true\n}\n```\n\n### Complete Example Form Template\n\n````markdown\n---\ntitle: Project Form\ntype: template-form\nprocessingMethod: create-new\nwindowTitle: \"New Project\"\nwidth: 750\nheight: 600\n---\n\n[Run Form: Project Form](noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.Forms&command=Open%20Template%20Form&arg0=Project%20Form)\n\n```formfields\n[\n {\n type: 'heading',\n label: 'Project Details'\n },\n {\n key: 'projectName',\n label: 'Project Name',\n type: 'input',\n required: true,\n compactDisplay: true\n },\n {\n key: 'startDate',\n label: 'Start Date',\n type: 'calendarpicker',\n buttonText: 'Select Date'\n },\n {\n key: 'team',\n label: 'Team',\n type: 'dropdown-select',\n options: ['Alpha', 'Beta', 'Charlie'],\n compactDisplay: true\n },\n {\n type: 'separator'\n },\n {\n key: 'description',\n label: 'Description',\n type: 'textarea',\n placeholder: 'Enter project description...'\n }\n]\n```\n````\n\n## See Also\n\n- [np.Templating Plugin](../np.Templating/README.md) - For advanced template processing\n- [np.CallbackURLs Plugin](../np.CallbackURLs/README.md) - For creating x-callback-url links easily\n" }, { "path": "dwertheimer.Forms/TEMPLATEJS_FREEZE_DIAG_THROWS.md", "content": "# TemplateJS-Block Freeze — Diagnostic Throw Locations\n\nAdd **one** `throw new Error('DIAG-N: ...')` at a time at these spots. Run the form with a non-empty templatejs block. If you see the error, the freeze is **after** that spot; if the app freezes before the error, the freeze is **at or before** that spot. Move to the next N.\n\nAll locations are in **`dwertheimer.Forms/src/formSubmission.js`**.\n\n---\n\n## 1. processCreateNew — before getTemplatingContext\n\n**Function:** `processCreateNew` \n**Place:** Right before `const templatingContext = await getTemplatingContext(formValuesForRendering)` (around line 1028)\n\n```js\n logDebug(pluginJson, `processCreateNew: [DIAG] about to getTemplatingContext`)\n throw new Error('DIAG-1: before getTemplatingContext')\n const templatingContext = await getTemplatingContext(formValuesForRendering)\n```\n\n**If you see DIAG-1:** Freeze is in or after `getTemplatingContext`. Try spot 2 next.\n\n---\n\n## 2. processCreateNew — after getTemplatingContext\n\n**Function:** `processCreateNew` \n**Place:** Right after `getTemplatingContext` returns (around line 1029)\n\n```js\n const templatingContext = await getTemplatingContext(formValuesForRendering)\n throw new Error('DIAG-2: after getTemplatingContext')\n logDebug(pluginJson, `processCreateNew: [DIAG] getTemplatingContext done`)\n```\n\n**If you see DIAG-2:** Freeze is after getTemplatingContext (e.g. in extract/execute). Try spot 3.\n\n---\n\n## 3. processCreateNew — before extractTemplateJSBlocks\n\n**Function:** `processCreateNew` \n**Place:** Right before `const templateJSBlocks = extractTemplateJSBlocks(...)` (around line 1064)\n\n```js\n // Step 5: Extract and execute templatejs blocks\n throw new Error('DIAG-3: before extractTemplateJSBlocks')\n const templateJSBlocks = extractTemplateJSBlocks(formFields, 'after')\n```\n\n**If you see DIAG-3:** Freeze is in extractTemplateJSBlocks or executeTemplateJSBlocks. Try spot 4.\n\n---\n\n## 4. extractTemplateJSBlocks — first line inside function\n\n**Function:** `extractTemplateJSBlocks` \n**Place:** First line inside the function (around line 296)\n\n```js\nfunction extractTemplateJSBlocks(formFields: Array, executeTiming?: string): ... {\n throw new Error('DIAG-4: inside extractTemplateJSBlocks start')\n const blocks: Array<...> = []\n```\n\n**If you see DIAG-4:** Freeze is in extractTemplateJSBlocks (forEach/sanitize/sort). Try spot 5.\n\n---\n\n## 5. extractTemplateJSBlocks — after forEach, before return\n\n**Function:** `extractTemplateJSBlocks` \n**Place:** After the `formFields.forEach(...)`, before `blocks.sort` (around line 311)\n\n```js\n })\n throw new Error('DIAG-5: extractTemplateJSBlocks after forEach before sort')\n blocks.sort((a, b) => a.order - b.order)\n return blocks\n```\n\n**If you see DIAG-5:** Freeze is in the forEach (or sanitizeTemplateJSCode used there). If you never see DIAG-5, freeze is inside the forEach.\n\n---\n\n## 6. processCreateNew — after extractTemplateJSBlocks, before executeTemplateJSBlocks\n\n**Function:** `processCreateNew` \n**Place:** Right after `extractTemplateJSBlocks` returns, before `executeTemplateJSBlocks` (around line 1066)\n\n```js\n const templateJSBlocks = extractTemplateJSBlocks(formFields, 'after')\n throw new Error('DIAG-6: after extract before executeTemplateJSBlocks')\n logDebug(pluginJson, `processCreateNew: [DIAG] about to executeTemplateJSBlocks`)\n const fullContext = await executeTemplateJSBlocks(templateJSBlocks, templatingContext, reactWindowData)\n```\n\n**If you see DIAG-6:** Freeze is in executeTemplateJSBlocks. Try spot 7.\n\n---\n\n## 7. executeTemplateJSBlocks — first line inside function\n\n**Function:** `executeTemplateJSBlocks` \n**Place:** First line inside the function (around line 435)\n\n```js\nasync function executeTemplateJSBlocks(blocks: Array<...>, initialContext: Object, reactWindowData: PassedData): Promise {\n throw new Error('DIAG-7: executeTemplateJSBlocks entry')\n const templatejsBlockKeys = new Set(blocks.map((b) => b.field?.key).filter(Boolean))\n```\n\n**If you see DIAG-7:** Freeze is in context copy or the block loop. Try spot 8.\n\n---\n\n## 8. executeTemplateJSBlocks — after templatejsBlockKeys, before try (context copy)\n\n**Function:** `executeTemplateJSBlocks` \n**Place:** After `const templatejsBlockKeys = ...`, before the `try { const keys = Object.keys(initialContext) ...` (around line 440)\n\n```js\n const templatejsBlockKeys = new Set(blocks.map((b) => b.field?.key).filter(Boolean))\n throw new Error('DIAG-8: before initialContext copy')\n let context: { [string]: any } = {}\n try {\n const keys = Object.keys(initialContext)\n```\n\n**If you see DIAG-8:** Freeze is in the `Object.keys(initialContext)` / for-loop copy. Try spot 9.\n\n---\n\n## 9. executeTemplateJSBlocks — after try/catch copy, before for-loop\n\n**Function:** `executeTemplateJSBlocks` \n**Place:** After the try/catch that builds `context`, before `for (let blockIndex = ...)` (around line 449)\n\n```js\n } catch (e) {\n logError(pluginJson, `executeTemplateJSBlocks: failed to copy initialContext keys: ...`)\n return null\n }\n throw new Error('DIAG-9: after context copy before block loop')\n for (let blockIndex = 0; blockIndex < blocks.length; blockIndex++) {\n```\n\n**If you see DIAG-9:** Freeze is in the loop or inside executeTemplateJSBlock. Try spot 10.\n\n---\n\n## 10. executeTemplateJSBlocks — inside for-loop, before executeTemplateJSBlock call\n\n**Function:** `executeTemplateJSBlocks` \n**Place:** Inside the for-loop, right before `executeTemplateJSBlock(...)` (around line 451)\n\n```js\n for (let blockIndex = 0; blockIndex < blocks.length; blockIndex++) {\n const { field, code } = blocks[blockIndex]\n throw new Error('DIAG-10: before executeTemplateJSBlock call')\n const result = await executeTemplateJSBlock(field, code, context, blockIndex, reactWindowData)\n```\n\n**If you see DIAG-10:** Freeze is inside executeTemplateJSBlock. Try spot 11.\n\n---\n\n## 11. executeTemplateJSBlock — first line inside try\n\n**Function:** `executeTemplateJSBlock` \n**Place:** First line inside the `try {` (around line 361)\n\n```js\n try {\n throw new Error('DIAG-11: executeTemplateJSBlock try start')\n logDebug(pluginJson, `executeTemplateJSBlock: Executing templatejs block from field \"${fieldIdentifier}\"`)\n```\n\n**If you see DIAG-11:** Freeze is in logDebug, sanitize, contextVars, functionBody, or Function.apply. Try spot 12.\n\n---\n\n## 12. executeTemplateJSBlock — after sanitizeTemplateJSCode\n\n**Function:** `executeTemplateJSBlock` \n**Place:** Right after `const sanitizedCode = sanitizeTemplateJSCode(code)` (around line 364)\n\n```js\n const sanitizedCode = sanitizeTemplateJSCode(code)\n throw new Error('DIAG-12: after sanitizeTemplateJSCode')\n if (sanitizedCode !== code) {\n```\n\n**If you see DIAG-12:** Freeze is in sanitizeTemplateJSCode. If you never see DIAG-12, freeze is in sanitize.\n\n---\n\n## 13. executeTemplateJSBlock — after contextVars build\n\n**Function:** `executeTemplateJSBlock` \n**Place:** Right after `const contextVars = Object.keys(context)...join('\\n')` (around line 368)\n\n```js\n const contextVars = Object.keys(context)\n .map((key) => { ... })\n .join('\\n')\n throw new Error('DIAG-13: after contextVars build')\n const functionBody = `\n```\n\n**If you see DIAG-13:** Freeze is in Object.keys(context) or the .map. If you never see DIAG-13, freeze is there.\n\n---\n\n## 14. executeTemplateJSBlock — after functionBody, before Function.apply\n\n**Function:** `executeTemplateJSBlock` \n**Place:** Right after the `const functionBody = \\`...\\``, before `Function.apply` (around line 386)\n\n```js\n const functionBody = `\n ${contextVars}\n ...\n `\n throw new Error('DIAG-14: after functionBody before Function.apply')\n const fn = Function.apply(null, ['params', functionBody])\n```\n\n**If you see DIAG-14:** Freeze is in Function.apply or fn(context). Try spot 15.\n\n---\n\n## 15. executeTemplateJSBlock — after Function.apply, before fn(context)\n\n**Function:** `executeTemplateJSBlock` \n**Place:** Right after `const fn = Function.apply(...)`, before `const result = fn(context)` (around line 388)\n\n```js\n const fn = Function.apply(null, ['params', functionBody])\n throw new Error('DIAG-15: after Function.apply before fn(context)')\n const result = fn(context)\n```\n\n**If you see DIAG-15:** Freeze is in fn(context) — i.e. when the user's block code runs.\n\n---\n\n## 16. executeTemplateJSBlock — after fn(context)\n\n**Function:** `executeTemplateJSBlock` \n**Place:** Right after `const result = fn(context)` (around line 389)\n\n```js\n const result = fn(context)\n throw new Error('DIAG-16: after fn(context)')\n if (result && typeof result === 'object' && !Array.isArray(result)) {\n```\n\n**If you see DIAG-16:** Block ran; freeze is in result handling or later in processCreateNew.\n\n---\n\n## Suggested order to try\n\n1. Start with **DIAG-1** (before getTemplatingContext). If you see it → freeze is in or after getTemplatingContext.\n2. Then **DIAG-2**. If you see it → freeze is in extract or execute.\n3. Then **DIAG-3**. If you see it → freeze is in extractTemplateJSBlocks or executeTemplateJSBlocks.\n4. Then **DIAG-6**. If you see it → freeze is in executeTemplateJSBlocks.\n5. Then **DIAG-7**. If you see it → freeze is in context copy or block loop.\n6. Then **DIAG-8** and **DIAG-9** to see if it’s the context copy.\n7. Then **DIAG-10**. If you see it → freeze is inside executeTemplateJSBlock.\n8. Then **DIAG-11** → **DIAG-12** → **DIAG-13** → **DIAG-14** → **DIAG-15** → **DIAG-16** to narrow it to a single section.\n\nRemove each throw before adding the next so only one is active at a time.\n" }, { "path": "dwertheimer.Forms/plugin.json", "content": "{\n \"COMMENT\": \"Details on these fields: https://help.noteplan.co/article/67-create-command-bar-plugins\",\n \"macOS.minVersion\": \"10.13.0\",\n \"noteplan.minAppVersion\": \"3.4.0\",\n \"plugin.id\": \"dwertheimer.Forms\",\n \"plugin.name\": \"📝 Template Forms\",\n \"plugin.version\": \"1.1.9\",\n \"plugin.releaseStatus\": \"full\",\n \"plugin.lastUpdateInfo\": \"1.1.9: SpaceChooser + np.Shared getTeamspaces via shared-handler fallback (helpers/routerUtils invoke unwrap). Rebuild bundles.\\n1.1.8: Field Editor event-chooser: unwrap getAvailableCalendars / getAvailableReminderLists (PluginRequestEnvelope).\\n1.1.7: PluginRequestEnvelope / requestFromPlugin aligned with np.Shared 1.0.7.\\n1.1.6: Form Builder refresh button next to Space/Folder; Target Note chooser shows .\",\n \"plugin.description\": \"Dynamic Forms for NotePlan using Templating -- fill out a multi-field form and have the data sent to a template for processing\",\n \"plugin.author\": \"dwertheimer\",\n \"plugin.requiredFiles\": [\"react.c.FormView.bundle.dev.js\", \"react.c.FormBuilderView.bundle.dev.js\", \"react.c.FormBrowserView.bundle.dev.js\"],\n \"plugin.dependsOn\": [],\n \"plugin.script\": \"script.js\",\n \"plugin.url\": \"https://github.com/NotePlan/plugins/blob/main/dwertheimer.Forms/README.md\",\n \"plugin.changelog\": \"https://github.com/NotePlan/plugins/blob/main/dwertheimer.Forms/CHANGELOG.md\",\n \"plugin.commands\": [\n {\n \"note\": \"================== COMMMANDS ========================\"\n },\n {\n \"name\": \"Open Template Form\",\n \"alias\": [\n \"form\",\n \"dialog\",\n \"getTemplateFormData\"\n ],\n \"description\": \"Open form for template data entry which will be sent to a template for processing. Generally invoked from an xcallback\",\n \"jsFunction\": \"openTemplateForm\",\n \"arguments\": [\"Title of the template form to open (optional, if not provided user will be prompted to select)\"]\n },\n {\n \"name\": \"Open Template Form from trigger\",\n \"description\": \"Open form for template data entry which will be sent to a template for processing. Generally invoked from an trigger. Looks for template details in the open note in Editor\",\n \"jsFunction\": \"triggerOpenForm\",\n \"hidden\": true\n },\n {\n \"name\": \"Form Builder/Editor\",\n \"alias\": [\n \"builder\",\n \"buildform\"\n ],\n \"description\": \"Visual form builder to create and edit form field definitions without writing JSON manually\",\n \"jsFunction\": \"openFormBuilder\",\n \"arguments\": [\n {\n \"name\": \"templateTitle\",\n \"type\": \"string\",\n \"description\": \"Title of the template form to edit (optional, if not provided user will be prompted to create new or select existing)\"\n }\n ]\n },\n {\n \"name\": \"Sidebar Forms Chooser\",\n \"alias\": [\n \"browser\",\n \"formbrowser\"\n ],\n \"description\": \"Browse and select template forms in a two-column resizable layout\",\n \"jsFunction\": \"openFormBrowser\",\n \"sidebarView\": {\n \"windowID\": \"dwertheimer.forms_forms-chooser-window_main\",\n \"title\": \"Template Forms\",\n \"icon\": \"list\",\n \"iconColor\": \"blue-500\"\n },\n \"arguments\": [\n {\n \"name\": \"showFloating\",\n \"type\": \"boolean\",\n \"description\": \"If true, opens as a floating window instead of main window (optional, defaults to false)\"\n }\n ]\n },\n {\n \"name\": \"Restore form from autosave\",\n \"alias\": [\n \"restoreautosave\",\n \"restoreform\"\n ],\n \"description\": \"Restore a form from an autosave file, opening the form with the saved data pre-populated\",\n \"jsFunction\": \"restoreFormFromAutosave\",\n \"arguments\": [\"Autosave filename (e.g., '@Trash/Autosave-2025-12-30T23-51-09')\"]\n },\n {\n \"name\": \"Create Processing Template\",\n \"alias\": [\n \"createprocessor\",\n \"newprocessor\"\n ],\n \"description\": \"Create a form processing template separately (for use with existing form templates)\",\n \"jsFunction\": \"createProcessingTemplate\",\n \"arguments\": [\n ]\n },\n {\n \"name\": \"openFormWindow\",\n \"description\": \"Open HTML+React Form Window\",\n \"jsFunction\": \"openFormWindow\",\n \"hidden\": true\n },\n {\n \"name\": \"onFormSubmitFromHTMLView\",\n \"description\": \"React Form Calling back to plugin\",\n \"jsFunction\": \"onFormSubmitFromHTMLView\",\n \"hidden\": true\n },\n {\n \"name\": \"onFormBuilderAction\",\n \"description\": \"React FormBuilder Calling back to plugin\",\n \"jsFunction\": \"onFormBuilderAction\",\n \"hidden\": true\n },\n {\n \"name\": \"onFormBrowserAction\",\n \"description\": \"React FormBrowser Calling back to plugin\",\n \"jsFunction\": \"onFormBrowserAction\",\n \"hidden\": true\n },\n {\n \"NOTE\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"Forms: Version\",\n \"description\": \"Update + Check Version\",\n \"jsFunction\": \"versionCheck\"\n },\n {\n \"description\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"onOpen\",\n \"jsFunction\": \"onOpen\",\n \"hidden\": true\n },\n {\n \"description\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"onEditorWillSave\",\n \"jsFunction\": \"onEditorWillSave\",\n \"hidden\": true\n },\n {\n \"NOTE\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"onMessageFromHTMLView\",\n \"description\": \"dwertheimer.Forms: Callback function to receive messages from HTML view\",\n \"jsFunction\": \"onMessageFromHTMLView\",\n \"hidden\": true\n },\n {\n \"NOTE\": \"DO NOT EDIT THIS COMMAND/TRIGGER\",\n \"name\": \"Forms: Update Plugin Settings\",\n \"description\": \"Preferences\",\n \"jsFunction\": \"editSettings\"\n },\n {\n \"name\": \"Test Request Handlers\",\n \"alias\": [\n \"testhandlers\",\n \"testrequests\"\n ],\n \"description\": \"Test request handlers directly (without React)\",\n \"jsFunction\": \"testRequestHandlers\"\n },\n {\n \"name\": \"DynamicDialog: All Form Fields Render Test\",\n \"alias\": [\n \"testfields\",\n \"fieldtest\"\n ],\n \"description\": \"Open a test form with all DynamicDialog field types to verify rendering\",\n \"jsFunction\": \"testFormFieldRender\"\n }\n ],\n \"plugin.settings\": [\n {\n \"note\": \"================== SETTINGS ========================\"\n },\n {\n \"COMMENT\": \"Plugin settings documentation: https://help.noteplan.co/article/123-plugin-configuration\",\n \"type\": \"heading\",\n \"title\": \"Forms Settings\"\n },\n {\n \"type\": \"hidden\",\n \"key\": \"pluginID\",\n \"default\": \"dwertheimer.Forms\",\n \"COMMENT\": \"This is for use by the editSettings helper function. PluginID must match the plugin.id in the top of this file\"\n },\n {\n \"key\": \"autosave\",\n \"type\": \"bool\",\n \"title\": \"Enable Autosave for All Forms\",\n \"description\": \"When enabled, automatically adds an invisible autosave field to every form opened. The form will be automatically saved periodically in the background, by default to @Trash/Autosave-. This provides a safety net in case of unexpected crashes or power outages or form submission errors. You can turn this off and add an autosave to a specific form by adding an autosave field to the form in the form builder.\",\n \"default\": true\n },\n {\n \"note\": \"================== DEBUGGING SETTINGS ========================\"\n },\n {\n \"NOTE\": \"DO NOT CHANGE THE FOLLOWING SETTINGS; ADD YOUR SETTINGS ABOVE ^^^\",\n \"type\": \"separator\"\n },\n {\n \"type\": \"heading\",\n \"title\": \"Debugging\"\n },\n {\n \"key\": \"_logLevel\",\n \"type\": \"string\",\n \"title\": \"Log Level\",\n \"choices\": [\n \"DEBUG\",\n \"INFO\",\n \"WARN\",\n \"ERROR\",\n \"none\"\n ],\n \"description\": \"Set how much logging output will be displayed when executing Forms commands in NotePlan Plugin Console Logs (NotePlan -> Help -> Plugin Console)\\n\\n - DEBUG: Show All Logs\\n - INFO: Only Show Info, Warnings, and Errors\\n - WARN: Only Show Errors or Warnings\\n - ERROR: Only Show Errors\\n - none: Don't show any logs\",\n \"default\": \"INFO\",\n \"required\": true\n }\n ]\n}" }, { "path": "dwertheimer.Forms/src/FormFieldRenderTest.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Field Render Test\n// Opens a test form with examples of ALL field types from DynamicDialog\n// This ensures all field types render correctly and helps catch regressions\n// Field types are based on TSettingItemType in DynamicDialog.jsx\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { openFormWindow, WEBVIEW_WINDOW_ID } from './windowManagement.js'\nimport { logInfo, logWarn, logError } from '@helpers/dev'\nimport { isHTMLWindowOpen, focusHTMLWindowIfAvailable } from '@helpers/NPWindows'\nimport { showMessage } from '@helpers/userInput'\n\n/**\n * Form Field Render Test\n * Opens a test form with examples of ALL field types from DynamicDialog\n * This ensures all field types render correctly and helps catch regressions\n * Field types are based on TSettingItemType in DynamicDialog.jsx\n * @returns {Promise}\n */\nexport async function testFormFieldRender(): Promise {\n try {\n logInfo(pluginJson, '📚 Form Field Examples...')\n logInfo(pluginJson, 'Opening form with examples of all DynamicDialog field types and configuration options...')\n logInfo(pluginJson, 'This form demonstrates various field types and their settings')\n\n // All field types from DynamicDialog.jsx TSettingItemType\n // This list should match the type definition to ensure we test everything\n const testFormFields = [\n {\n type: 'text',\n textType: 'description',\n label:\n 'This form demonstrates all available field types and their configuration options in DynamicDialog. Use these examples to see how different settings affect field appearance and behavior.',\n },\n {\n type: 'table-of-contents',\n label: 'Table of Contents',\n description: '',\n },\n {\n type: 'heading',\n label: 'Compact View Alignment Test',\n underline: true,\n },\n {\n type: 'input',\n label: 'Name',\n key: 'testCompactName',\n placeholder: 'Enter name',\n compactDisplay: true,\n description: 'Compact input field with short label',\n },\n {\n type: 'number',\n label: 'Age',\n key: 'testCompactAge',\n value: '25',\n step: 1,\n compactDisplay: true,\n description: 'Compact number field with short label',\n },\n {\n type: 'textarea',\n label: 'Notes',\n key: 'testCompactNotes',\n placeholder: 'Enter notes...',\n minRows: 3,\n maxRows: 10,\n compactDisplay: true,\n description: 'Compact expandable textarea with short label',\n },\n {\n type: 'calendarpicker',\n label: 'Date',\n key: 'testCompactDate',\n selectedDate: new Date(),\n numberOfMonths: 1,\n compactDisplay: true,\n description: 'Compact calendar picker with short label',\n },\n {\n type: 'dropdown-select',\n label: 'Dropdown',\n key: 'testCompactDropdown',\n options: ['Option 1', 'Option 2', 'Option 3', 'Option 4', 'Option 5'],\n compactDisplay: true,\n description: 'Compact dropdown select with short label',\n },\n {\n type: 'space-chooser',\n label: 'Space',\n key: 'testCompactSpace',\n compactDisplay: true,\n showValue: true,\n description: 'Compact space chooser with short label',\n },\n {\n type: 'folder-chooser',\n label: 'Folder',\n key: 'testCompactFolder',\n includeNewFolderOption: true,\n compactDisplay: true,\n showValue: true,\n description: 'Compact folder chooser with short label',\n },\n {\n type: 'note-chooser',\n label: 'Note',\n key: 'testCompactNote',\n includePersonalNotes: true,\n includeCalendarNotes: false,\n includeRelativeNotes: false,\n includeTeamspaceNotes: true,\n compactDisplay: true,\n showValue: true,\n description: 'Compact note chooser with short label',\n },\n {\n type: 'heading-chooser',\n label: 'Heading',\n key: 'testCompactHeading',\n staticHeadings: ['Tasks', 'Projects', 'Archive'],\n compactDisplay: true,\n showValue: true,\n description: 'Compact heading chooser with short label',\n },\n {\n type: 'event-chooser',\n label: 'Event',\n key: 'testCompactEvent',\n eventDate: new Date(),\n compactDisplay: true,\n showValue: true,\n description: 'Compact event chooser with short label',\n },\n {\n type: 'mention-chooser',\n label: 'Mention',\n key: 'testCompactMention',\n compactDisplay: true,\n placeholder: 'Type to search mentions...',\n description: 'Compact mention chooser with short label',\n },\n {\n type: 'tag-chooser',\n label: 'Tag',\n key: 'testCompactTag',\n compactDisplay: true,\n placeholder: 'Type to search hashtags...',\n description: 'Compact tag chooser with short label',\n },\n {\n type: 'frontmatter-key-chooser',\n label: 'Frontmatter',\n key: 'testCompactFrontmatter',\n frontmatterKey: 'status',\n compactDisplay: true,\n placeholder: 'Type to search values...',\n singleValue: true,\n renderAsDropdown: true,\n description: 'Compact frontmatter key chooser with short label',\n },\n {\n type: 'heading',\n label: 'Basic Input Fields',\n underline: true,\n },\n {\n type: 'input',\n label: 'Text Input',\n key: 'testInput',\n placeholder: 'Enter text here',\n description: 'Standard text input field',\n },\n {\n type: 'input',\n label: 'Text Input (With Default Value)',\n key: 'testInputDefault',\n placeholder: 'Enter text here',\n default: 'Default value',\n description: 'Text input with a pre-filled default value',\n },\n {\n type: 'input',\n label: 'Text Input (Compact Display)',\n key: 'testInputCompact',\n placeholder: 'Enter text here',\n compactDisplay: true,\n description: 'Text input in compact mode - label and field side by side',\n },\n {\n type: 'input',\n label: 'Text Input (Auto-Focus)',\n key: 'testInputFocus',\n placeholder: 'This field receives focus when form opens',\n focus: true,\n description: 'Text input that automatically receives focus when the form opens',\n },\n {\n type: 'input',\n label: 'Required Input',\n key: 'testInputRequired',\n placeholder: 'This field is required',\n required: true,\n description: 'This field must be filled out (required validation)',\n },\n {\n type: 'input',\n label: 'Email Input (Validated)',\n key: 'testInputEmail',\n placeholder: 'user@example.com',\n validationType: 'email',\n description: 'This field validates email format',\n },\n {\n type: 'input',\n label: 'Number Input (Validated)',\n key: 'testInputNumber',\n placeholder: 'Enter a number',\n validationType: 'number',\n description: 'This field validates that input is a number',\n },\n {\n type: 'input',\n label: 'Date Interval (Validated)',\n key: 'testInputDateInterval',\n placeholder: 'e.g., 7d, 2w, 1m',\n validationType: 'date-interval',\n description: 'This field validates date interval format (nn[bdwmqy])',\n },\n {\n type: 'input-readonly',\n label: 'Readonly Input',\n key: 'testInputReadonly',\n value: 'This is readonly',\n description: 'Read-only text input field',\n },\n {\n type: 'textarea',\n label: 'Expandable Textarea',\n key: 'testTextarea',\n placeholder: 'Type here and watch it expand...',\n minRows: 3,\n maxRows: 10,\n description: 'Multi-line text field that automatically expands as you type. Starts at 3 rows, expands up to 10 rows, then scrolls.',\n },\n {\n type: 'textarea',\n label: 'Expandable Textarea (Large)',\n key: 'testTextareaLarge',\n placeholder: 'This one starts larger and can expand more...',\n minRows: 5,\n maxRows: 15,\n description: 'Larger textarea starting at 5 rows, expanding up to 15 rows',\n },\n {\n type: 'textarea',\n label: 'Expandable Textarea (Small)',\n key: 'testTextareaSmall',\n placeholder: 'Small textarea...',\n minRows: 1,\n maxRows: 5,\n description: 'Small textarea starting at 1 row, expanding up to 5 rows',\n },\n {\n type: 'textarea',\n label: 'Expandable Textarea (Compact)',\n key: 'testTextareaCompact',\n placeholder: 'Compact textarea...',\n minRows: 2,\n maxRows: 8,\n compactDisplay: true,\n description: 'Textarea in compact mode - label and field side by side',\n },\n {\n type: 'number',\n label: 'Number Input',\n key: 'testNumber',\n value: '42',\n step: 1,\n description: 'Number input with step increment of 1',\n },\n {\n type: 'number',\n label: 'Number Input (Step: 5)',\n key: 'testNumberStep5',\n value: '10',\n step: 5,\n description: 'Number input with step increment of 5 - increments/decrements by 5',\n },\n {\n type: 'number',\n label: 'Number Input (Step: 0.1)',\n key: 'testNumberStepDecimal',\n value: '1.5',\n step: 0.1,\n description: 'Number input with decimal step increment of 0.1',\n },\n {\n type: 'text',\n label: 'Text Display (Description)',\n textType: 'description',\n description: 'This is a text display field with textType=\"description\" (not editable)',\n },\n {\n type: 'text',\n label: 'Text Display (Title)',\n textType: 'title',\n description: 'This is a text display field with textType=\"title\" (not editable)',\n },\n {\n type: 'text',\n label: 'Text Display (Separator)',\n textType: 'separator',\n description: 'This is a text display field with textType=\"separator\" (not editable)',\n },\n {\n type: 'heading',\n label: 'Selection Fields',\n underline: true,\n },\n {\n type: 'switch',\n label: 'Switch/Toggle (Off)',\n key: 'testSwitch',\n checked: false,\n description: 'Boolean switch/toggle field in the \"off\" state',\n },\n {\n type: 'switch',\n label: 'Switch/Toggle (On)',\n key: 'testSwitchOn',\n checked: true,\n description: 'Boolean switch/toggle field in the \"on\" state',\n },\n {\n type: 'switch',\n label: 'Switch (Compact Display)',\n key: 'testSwitchCompact',\n checked: false,\n compactDisplay: true,\n description: 'Switch in compact mode - label and switch side by side',\n },\n {\n type: 'dropdown-select',\n label: 'Dropdown Select (Searchable)',\n key: 'testDropdown',\n options: ['Option 1', 'Option 2', 'Option 3', 'Option 4', 'Option 5', 'Long Option Name That Might Be Truncated'],\n placeholder: 'Select an option',\n showValue: true, // Show the selected value for debugging\n description: 'Searchable dropdown select field (now uses SearchableChooser)',\n },\n {\n type: 'dropdown-select',\n label: 'Dropdown Select (Editable)',\n key: 'testDropdownEditable',\n options: ['Option A', 'Option B', 'Option C'],\n placeholder: 'Select or type a value',\n isEditable: true,\n showValue: true,\n description: 'Editable dropdown - allows typing a custom value not in the options list',\n },\n {\n type: 'heading',\n label: 'Chooser Fields',\n underline: true,\n },\n {\n type: 'space-chooser',\n label: 'Space Chooser',\n key: 'testSpace',\n showValue: true, // Show the selected value for debugging\n description: 'Select a Space (Private or Teamspace). This is used to filter folders below.',\n },\n {\n type: 'heading',\n label: 'Custom Width Examples',\n underline: true,\n },\n {\n type: 'folder-chooser',\n label: 'Folder Chooser',\n key: 'testFolderCompact30vw',\n compactDisplay: true,\n width: '30vw',\n showValue: true,\n description: 'Compact display with field custom width of 30vw. Width overrides default even in compact mode.',\n },\n {\n type: 'note-chooser',\n label: 'Note Chooser (Non-Compact, Custom Width: 79%)',\n key: 'testNote79Percent',\n compactDisplay: false,\n width: '79%',\n showValue: true,\n description: 'Non-compact display with custom width of 79%. Width applies to the input field.',\n },\n {\n type: 'dropdown-select',\n label: 'Dropdown',\n key: 'testDropdown300px',\n compactDisplay: true,\n width: '300px',\n options: ['Option 1', 'Option 2', 'Option 3', 'Option 4', 'Option 5'],\n showValue: true,\n description: 'Compact display with custom width of 300px. Width overrides default even in compact mode.',\n },\n {\n type: 'space-chooser',\n label: 'Space Chooser (Non-Compact, Custom Width: calc(100% - 140px))',\n key: 'testSpaceCalc',\n compactDisplay: false,\n width: 'calc(100% - 140px)',\n showValue: true,\n description: 'Non-compact display with custom width using calc(). Demonstrates advanced CSS width values.',\n },\n {\n type: 'space-chooser',\n label: 'Space Chooser (With All Option)',\n key: 'testSpaceWithAll',\n includeAllOption: true,\n showValue: true,\n description: 'Space chooser with \"All Private + Spaces\" option that returns \"__all__\"',\n },\n {\n type: 'folder-chooser',\n label: 'Folder Chooser',\n key: 'testFolder',\n includeNewFolderOption: true,\n startFolder: 'Projects',\n showValue: true, // Show the selected value for debugging\n description: 'Loads folders dynamically when form opens',\n },\n {\n type: 'folder-chooser',\n label: 'Folder Chooser (With Archive)',\n key: 'testFolderWithArchive',\n includeArchive: true,\n showValue: true,\n description: 'Folder chooser that includes the Archive folder in the list',\n },\n {\n type: 'folder-chooser',\n label: 'Folder Chooser (With Folder Path)',\n key: 'testFolderWithPath',\n includeFolderPath: true,\n showValue: true,\n description: 'Folder chooser that shows the full folder path, not just the folder name',\n },\n {\n type: 'folder-chooser',\n label: 'Folder Chooser (Exclude Teamspaces)',\n key: 'testFolderNoTeamspaces',\n excludeTeamspaces: true,\n showValue: true,\n description: 'Folder chooser that excludes teamspace folders, showing only Private folders',\n },\n {\n type: 'folder-chooser',\n label: 'Folder Chooser (Start in Specific Folder)',\n key: 'testFolderStartFolder',\n startFolder: 'Projects',\n showValue: true,\n description: 'Folder chooser that starts in a specific folder (e.g., \"Projects\")',\n },\n {\n type: 'heading',\n label: 'Folder Chooser with Space Dependency',\n underline: true,\n },\n {\n type: 'space-chooser',\n label: 'Space Chooser (for Folder Dependency)',\n key: 'testSpaceForFolder',\n showValue: true,\n description: 'Select a space to filter folders in the chooser below',\n },\n {\n type: 'folder-chooser',\n label: 'Folder Chooser (Depends on Space)',\n key: 'testFolderDependsOnSpace',\n sourceSpaceKey: 'testSpaceForFolder',\n includeNewFolderOption: true,\n showValue: true,\n staticOptions: [{ label: 'Select...', value: '' },\n { label: 'Choose...', value: '' },\n ],\n showValue: true,\n description: 'Folder chooser with static options at the top. The \"Select...\" option uses TemplateRunner\\'s to be prompted each time for the folder):',\n ' to be prompted each time for the folder, change in frontmatter if you want to use a different folder)\\n`\n }\n if (frontmatterVars.writeNoteTitle) {\n basicContent += `\\nNote: This template will write to: \"${frontmatterVars.writeNoteTitle}\"\\n`\n }\n if (frontmatterVars.writeUnderHeading) {\n basicContent += `Heading: ${frontmatterVars.writeUnderHeading}\\n`\n }\n if (frontmatterVars.location) {\n basicContent += `Location: ${frontmatterVars.location} (append, prepend, replace, write under heading)\\n`\n }\n basicContent += `\\n\\`\\`\\`\\n`\n basicContent += `\\`\\`\\`${varsCodeBlockType}\\n`\n basicContent += `${varsInForm}\\n\\`\\`\\`\\n`\n\n processingNote.appendParagraph(basicContent, 'text')\n const emptyParagraph = processingNote.paragraphs.find((p) => p.type === 'empty')\n if (emptyParagraph) processingNote.removeParagraph(emptyParagraph)\n\n // Note: Form template frontmatter is updated by the caller (NPTemplateForm.js), so we don't update it here\n // to avoid duplicate receivingTemplateTitle entries\n // Only show message and open note if called standalone (not from Form Builder)\n // When called from Form Builder, the React UI will handle the update\n if (!formTemplateFilename) {\n if (formTemplateTitle) {\n await showMessage(`Created processing template \"${processingTitle}\" and linked it to form template \"${formTemplateTitle}\"`)\n } else {\n await showMessage(`Created processing template \"${processingTitle}\"`)\n }\n // Open the note in the Editor when called standalone\n await Editor.openNoteByFilename(filename)\n }\n\n logDebug(pluginJson, `createProcessingTemplate: Successfully created processing template \"${processingTitle}\"`)\n\n return { processingTitle, processingFilename: filename }\n } catch (error) {\n logError(pluginJson, `createProcessingTemplate error: ${JSP(error)}`)\n await showMessage(`Error creating processing template: ${error.message}`)\n return { processingTitle: undefined, processingFilename: undefined }\n }\n}\n" }, { "path": "dwertheimer.Forms/src/components/AppContext.jsx", "content": "// This is a context provider for the app. You should generally not need to edit this file.\n// It provides a way to pass functions and data to any component that needs it\n// without having to pass from parent to child to grandchild etc.\n// including reading and saving reactSettings local to the react window\n//\n// Any React component that needs access to the AppContext can use the useAppContext hook with these 2 lines\n// import { useAppContext } from './AppContext.jsx'\n// ...\n// const {sendActionToPlugin, sendToPlugin, dispatch, pluginData, reactSettings, updateReactSettings} = useAppContext() // MUST BE inside the React component/function code, cannot be at the top of a file\n\n// @flow\nimport React, { createContext, useContext, useMemo, type Node } from 'react'\n\n/**\n * Type definitions for the application context.\n */\nexport type AppContextType = {\n sendActionToPlugin: (command: string, dataToSend: any) => void, // The main one to use to send actions to the plugin, saves scroll position\n sendToPlugin: (command: string, dataToSend: any) => void, // Sends to plugin without saving scroll position\n requestFromPlugin: (command: string, dataToSend: any, timeout?: number) => Promise, // Request/response pattern - returns a Promise\n dispatch: (command: string, dataToSend: any, message?: string) => void, // Used mainly for showing banner at top of page to user\n pluginData: Object, // The data that was sent from the plugin in the field \"pluginData\"\n reactSettings: Object, // Dynamic key-value pair for reactSettings local to the react window (e.g. filterPriorityItems)\n setReactSettings: (newSettings: Object) => void, // Update the reactSettings\n updatePluginData: (newData: Object, messageForLog?: string) => void, // Updates the global pluginData, generally not something you should need to do\n}\n\n// Default context value with initial reactSettings and functions.\nconst defaultContextValue: AppContextType = {\n sendActionToPlugin: () => {},\n sendToPlugin: () => {},\n requestFromPlugin: async () => {\n throw new Error('requestFromPlugin not initialized')\n },\n dispatch: () => {},\n pluginData: {},\n reactSettings: {}, // Initial empty reactSettings local\n setReactSettings: () => {}, // Placeholder function, actual implementation below.\n updatePluginData: () => {}, // Placeholder function, actual implementation below.\n}\n\ntype Props = {\n sendActionToPlugin: (command: string, dataToSend: any) => void,\n sendToPlugin: (command: string, dataToSend: any) => void,\n requestFromPlugin: (command: string, dataToSend: any, timeout?: number) => Promise,\n dispatch: (command: string, dataToSend: any, messageForLog?: string) => void,\n pluginData: Object,\n children: Node, // React component children\n updatePluginData: (newData: Object, messageForLog?: string) => void,\n reactSettings: Object,\n setReactSettings: (newSettings: Object) => void,\n}\n\n/**\n * Create the context with the default value.\n */\nconst AppContext = createContext(defaultContextValue)\n\n// Explicitly annotate the return type of AppProvider as a React element\nexport const AppProvider = ({ children, sendActionToPlugin, sendToPlugin, requestFromPlugin, dispatch, pluginData, updatePluginData, reactSettings, setReactSettings }: Props): Node => {\n\n // Memoize the context value to prevent unnecessary re-renders of all consumers\n // This ensures that functions like requestFromPlugin and dispatch maintain stable references\n // Only recreate the context value when the actual props change\n const contextValue: AppContextType = useMemo(() => ({\n sendActionToPlugin,\n sendToPlugin,\n requestFromPlugin,\n dispatch,\n pluginData,\n reactSettings,\n setReactSettings,\n updatePluginData,\n }), [sendActionToPlugin, sendToPlugin, requestFromPlugin, dispatch, pluginData, reactSettings, setReactSettings, updatePluginData])\n\n return {children}\n}\n\n/**\n * Custom hook to use the AppContext.\n * @returns {AppContextType} - The context value.\n */\nexport const useAppContext = (): AppContextType => useContext(AppContext)\n" }, { "path": "dwertheimer.Forms/src/components/ConditionsEditor.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// ConditionsEditor Component - Editor for conditional-values matchTerm/value pairs\n// Similar to OptionsEditor but with matchTerm and value columns (no label/isDefault).\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, type Node } from 'react'\nimport { ValueInsertButtons } from './ValueInsertButtons.jsx'\n\ntype ConditionItem = {\n matchTerm: string,\n value: string,\n}\n\ntype ConditionsEditorProps = {\n conditions: Array<{ matchTerm: string, value: string }>,\n onChange: (conditions: Array<{ matchTerm: string, value: string }>) => void,\n}\n\n/**\n * Editor for conditional-values conditions (matchTerm/value pairs).\n * First match wins when evaluating.\n *\n * @param {ConditionsEditorProps} props\n * @returns {Node}\n */\nexport function ConditionsEditor({ conditions, onChange }: ConditionsEditorProps): Node {\n const normalizeCondition = (c: { matchTerm?: string, value?: string } | any): ConditionItem => ({\n matchTerm: c?.matchTerm ?? '',\n value: c?.value ?? '',\n })\n\n const [conditionItems, setConditionItems] = useState>(() => {\n return Array.isArray(conditions) ? conditions.map(normalizeCondition) : []\n })\n\n const handleAddCondition = () => {\n const newItem: ConditionItem = { matchTerm: '', value: '' }\n const updated = [...conditionItems, newItem]\n setConditionItems(updated)\n onChange(updated)\n }\n\n const handleUpdateCondition = (index: number, updates: Partial) => {\n const updated = [...conditionItems]\n updated[index] = { ...updated[index], ...updates }\n setConditionItems(updated)\n onChange(updated)\n }\n\n const handleDeleteCondition = (index: number) => {\n const updated = conditionItems.filter((_, i) => i !== index)\n setConditionItems(updated)\n onChange(updated)\n }\n\n const handleMoveUp = (index: number) => {\n if (index === 0) return\n const updated = [...conditionItems]\n const temp = updated[index - 1]\n updated[index - 1] = updated[index]\n updated[index] = temp\n setConditionItems(updated)\n onChange(updated)\n }\n\n const handleMoveDown = (index: number) => {\n if (index === conditionItems.length - 1) return\n const updated = [...conditionItems]\n const temp = updated[index]\n updated[index] = updated[index + 1]\n updated[index + 1] = temp\n setConditionItems(updated)\n onChange(updated)\n }\n\n useEffect(() => {\n const normalized = Array.isArray(conditions) ? conditions.map(normalizeCondition) : []\n setConditionItems(normalized)\n }, [conditions])\n\n return (\n
\n
\n \n \n
\n
\n {conditionItems.length === 0 ? (\n
No conditions yet. Click "Add Condition" to add match/value pairs.
\n ) : (\n conditionItems.map((cond, index) => (\n
\n
\n \n \n
\n
\n
\n \n handleUpdateCondition(index, { matchTerm: e.target.value })}\n placeholder=\"Trip or .*trip.* (regex)\"\n />\n
\n
\n \n
\n handleUpdateCondition(index, { value: e.target.value })}\n placeholder=\"red-500, fa-solid fa-star, lined, etc.\"\n />\n handleUpdateCondition(index, { value: v })} />\n
\n
\n
\n \n
\n ))\n )}\n
\n
\n When the source field's value matches "Match" (string or regex), this field is set to "Value". Order matters: first match wins. Use the +Color, +Icon, +Pattern, and +IconStyle buttons next to the Value field to insert values commonly used as NotePlan variables in frontmatter: +Color inserts Tailwind color names (e.g. amber-100, red-500); +Icon inserts Font Awesome icon classes (e.g. fa-solid fa-star); +Pattern inserts lined, squared, mini-squared, or dotted; +IconStyle inserts solid, light, or regular.\n
\n
\n )\n}\n\nexport default ConditionsEditor\n" }, { "path": "dwertheimer.Forms/src/components/FieldEditor.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FieldEditor Component - Modal editor for editing individual form fields\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, useMemo, useRef, type Node } from 'react'\nimport { ConditionsEditor } from './ConditionsEditor.jsx'\nimport { OptionsEditor } from './OptionsEditor.jsx'\nimport { type TSettingItem } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\nimport { unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\n\ntype FieldEditorProps = {\n field: TSettingItem,\n allFields: Array,\n onSave: (field: TSettingItem) => void,\n onCancel: () => void,\n requestFromPlugin?: (command: string, dataToSend?: any, timeout?: number) => Promise, // Optional function to call plugin commands\n}\n\n/**\n * Validate CSS width value\n * @param {string} value - The width value to validate\n * @returns {boolean} - True if valid CSS width value\n */\nfunction isValidCSSWidth(value: string): boolean {\n if (!value || value.trim() === '') return true // Empty is valid (means use default)\n // Match valid CSS width values: px, %, em, rem, vw, vh, ch, ex, cm, mm, in, pt, pc, or calc()\n const cssWidthRegex = /^(\\d+(\\.\\d+)?(px|%|em|rem|vw|vh|ch|ex|cm|mm|in|pt|pc)|calc\\([^)]+\\)|auto|inherit|initial|unset|max-content|min-content|fit-content)$/i\n return cssWidthRegex.test(value.trim())\n}\n\n/**\n * Check if a field type is NOT in the excluded types array\n * @param {string} fieldType - The field type to check\n * @param {Array} excludedTypes - Array of field types to exclude\n * @returns {boolean} - True if field type is NOT in excluded types\n */\nfunction shouldDisplayFieldType(fieldType: string, excludedTypes: Array): boolean {\n return !excludedTypes.some((excludedType) => fieldType === excludedType)\n}\n\nexport function FieldEditor({ field, allFields, onSave, onCancel, requestFromPlugin }: FieldEditorProps): Node {\n const [editedField, setEditedField] = useState({ ...field })\n const [calendars, setCalendars] = useState>([])\n const [calendarsLoaded, setCalendarsLoaded] = useState(false)\n const [reminderLists, setReminderLists] = useState>([])\n const [reminderListsLoaded, setReminderListsLoaded] = useState(false)\n const calendarsLoadingRef = useRef(false)\n const reminderListsLoadingRef = useRef(false)\n const requestFromPluginRef = useRef(requestFromPlugin)\n const [widthError, setWidthError] = useState('')\n const [templateJSError, setTemplateJSError] = useState('')\n\n // Track previous field key to detect actual field changes\n const prevFieldKeyRef = useRef(field.key)\n\n // Update ref when requestFromPlugin changes\n useEffect(() => {\n requestFromPluginRef.current = requestFromPlugin\n }, [requestFromPlugin])\n\n // Update editedField when field prop changes (e.g., when editing a different field)\n useEffect(() => {\n const fieldKeyChanged = prevFieldKeyRef.current !== field.key\n console.log('[FieldEditor DIAG] field useEffect triggered:', {\n prevKey: prevFieldKeyRef.current,\n newKey: field.key,\n keyChanged: fieldKeyChanged,\n type: field.type,\n })\n prevFieldKeyRef.current = field.key\n\n setEditedField({ ...field })\n // Only reset loaded states when field key actually changes (not just object reference)\n if (fieldKeyChanged && field.type === 'event-chooser') {\n console.log('[FieldEditor DIAG] field useEffect: resetting loaded states')\n setCalendarsLoaded(false)\n setReminderListsLoaded(false)\n calendarsLoadingRef.current = false\n reminderListsLoadingRef.current = false\n }\n }, [field])\n\n // Load calendars when editing event-chooser field\n useEffect(() => {\n const requestFn = requestFromPluginRef.current\n console.log('[FieldEditor DIAG] calendars useEffect triggered:', {\n type: editedField.type,\n calendarsLoaded,\n isLoading: calendarsLoadingRef.current,\n hasRequestFn: !!requestFn,\n })\n\n // Only load if we're editing an event-chooser, haven't loaded yet, not currently loading, and have requestFromPlugin\n if (editedField.type !== 'event-chooser' || calendarsLoaded || calendarsLoadingRef.current || !requestFn) {\n console.log('[FieldEditor DIAG] calendars useEffect: skipping load (conditions not met)')\n return\n }\n\n console.log('[FieldEditor DIAG] calendars useEffect: STARTING load')\n let isMounted = true\n calendarsLoadingRef.current = true\n\n requestFn('getAvailableCalendars', { writeOnly: false })\n .then((envelope: any) => {\n const calendarsData = unwrapPluginRequestData(envelope)\n console.log('[FieldEditor DIAG] calendars useEffect: received data, isMounted=', isMounted, 'data type=', Array.isArray(calendarsData) ? 'array' : typeof calendarsData)\n if (isMounted && Array.isArray(calendarsData)) {\n setCalendars(calendarsData)\n setCalendarsLoaded(true)\n console.log('[FieldEditor DIAG] calendars useEffect: set calendars and loaded flag')\n }\n calendarsLoadingRef.current = false\n })\n .catch((error) => {\n console.error('[FieldEditor DIAG] calendars useEffect: ERROR loading calendars:', error)\n if (isMounted) {\n setCalendarsLoaded(true) // Set to true to prevent infinite retries\n }\n calendarsLoadingRef.current = false\n })\n\n return () => {\n console.log('[FieldEditor DIAG] calendars useEffect: cleanup called')\n isMounted = false\n calendarsLoadingRef.current = false\n }\n }, [editedField.type, calendarsLoaded])\n\n // Load reminder lists when editing event-chooser field and reminders are enabled\n useEffect(() => {\n const requestFn = requestFromPluginRef.current\n const includeReminders = ((editedField: any): { includeReminders?: boolean }).includeReminders\n console.log('[FieldEditor DIAG] reminderLists useEffect triggered:', {\n type: editedField.type,\n reminderListsLoaded,\n isLoading: reminderListsLoadingRef.current,\n hasRequestFn: !!requestFn,\n includeReminders,\n })\n\n if (editedField.type !== 'event-chooser' || reminderListsLoaded || reminderListsLoadingRef.current || !requestFn || !includeReminders) {\n console.log('[FieldEditor DIAG] reminderLists useEffect: skipping load (conditions not met)')\n return\n }\n\n console.log('[FieldEditor DIAG] reminderLists useEffect: STARTING load')\n let isMounted = true\n reminderListsLoadingRef.current = true\n\n requestFn('getAvailableReminderLists', {})\n .then((envelope: any) => {\n const listsData = unwrapPluginRequestData(envelope)\n console.log(\n '[FieldEditor DIAG] reminderLists useEffect: received data, isMounted=',\n isMounted,\n 'data type=',\n Array.isArray(listsData) ? 'array' : typeof listsData,\n 'length=',\n Array.isArray(listsData) ? listsData.length : 'N/A',\n )\n if (isMounted) {\n if (Array.isArray(listsData)) {\n setReminderLists(listsData)\n setReminderListsLoaded(true)\n console.log('[FieldEditor DIAG] reminderLists useEffect: set lists and loaded flag, count=', listsData.length)\n if (listsData.length === 0) {\n console.log('[FieldEditor DIAG] reminderLists useEffect: WARNING - received empty array, user may not have any reminder lists configured')\n }\n } else {\n console.error('[FieldEditor DIAG] reminderLists useEffect: received non-array data:', typeof listsData, listsData)\n setReminderLists([])\n setReminderListsLoaded(true)\n }\n }\n reminderListsLoadingRef.current = false\n })\n .catch((error) => {\n console.error('[FieldEditor DIAG] reminderLists useEffect: ERROR loading reminder lists:', error)\n if (isMounted) {\n setReminderLists([])\n setReminderListsLoaded(true) // Set to true to prevent infinite retries\n }\n reminderListsLoadingRef.current = false\n })\n\n return () => {\n console.log('[FieldEditor DIAG] reminderLists useEffect: cleanup called')\n isMounted = false\n reminderListsLoadingRef.current = false\n }\n }, [editedField.type, reminderListsLoaded, ((editedField: any): { includeReminders?: boolean }).includeReminders])\n\n // Compute dependency options fresh each render based on current allFields\n const dependencyOptions = useMemo(() => {\n return allFields\n .filter((f) => f.key && f.key !== editedField.key && (f.type === 'switch' || f.type === 'input' || f.type === 'number'))\n .map((f) => {\n const key = f.key || ''\n const label = f.label || key\n return {\n value: key,\n label: `${label} (${key})`,\n }\n })\n }, [allFields, editedField.key])\n\n const updateField = (updates: Partial) => {\n setEditedField({ ...editedField, ...updates })\n }\n\n const handleSave = () => {\n let fieldToSave = editedField\n if (editedField.type === 'conditional-values' && Array.isArray((editedField: any).conditions)) {\n const filtered = ((editedField: any).conditions: Array<{ matchTerm: string, value: string }>).filter(\n (c) => (c?.matchTerm ?? '').trim() !== '',\n )\n fieldToSave = { ...editedField, conditions: filtered }\n }\n onSave(fieldToSave)\n }\n\n // templatejs-block fields don't need keys - they're auto-generated at execution time\n const needsKey = shouldDisplayFieldType(editedField.type, ['separator', 'heading', 'autosave', 'table-of-contents', 'comment', 'templatejs-block'])\n\n // Construct header title with label, key, and type\n const headerTitle = needsKey && editedField.key ? `Editing ${editedField.type}: ${editedField.label || ''} (${editedField.key})` : `Editing: ${editedField.type}`\n\n return (\n
\n
e.stopPropagation()}>\n
\n

{headerTitle}

\n \n
\n
\n {needsKey && (\n
\n \n {\n const newKey = e.target.value\n updateField({ key: newKey })\n }}\n placeholder=\"e.g., projectName\"\n />\n
This becomes the variable name in your template (so it's best to give it a descriptive name)
\n
\n )}\n\n {(editedField.type === 'heading' || editedField.type === 'table-of-contents' || editedField.type !== 'separator') && (\n
\n \n updateField({ label: e.target.value })} placeholder=\"Field label\" />\n
The label is displayed above the field (or to the left of the field if compact display is enabled)
\n
\n )}\n\n {shouldDisplayFieldType(editedField.type, ['separator', 'heading', 'table-of-contents', 'calendarpicker', 'autosave', 'comment']) && (\n
\n \n
\n )}\n\n {/* Width field for SearchableChooser-based fields */}\n {(editedField.type === 'folder-chooser' ||\n editedField.type === 'note-chooser' ||\n editedField.type === 'space-chooser' ||\n editedField.type === 'heading-chooser' ||\n editedField.type === 'dropdown-select' ||\n editedField.type === 'event-chooser' ||\n editedField.type === 'color-chooser' ||\n editedField.type === 'icon-chooser' ||\n editedField.type === 'pattern-chooser' ||\n editedField.type === 'icon-style-chooser') && (\n
\n \n {\n const rawValue = e.target.value\n const widthValue = rawValue.trim()\n const updated = { ...editedField }\n if (widthValue === '') {\n delete (updated: any).width\n setWidthError('')\n } else {\n // Always save the raw value while typing (allows partial/invalid values during typing)\n ;(updated: any).width = rawValue\n // Only validate if the trimmed value is complete (has a valid CSS unit or is a valid calc())\n // This allows typing intermediate values like \"80\", \"80v\", \"calc(\" without errors\n if (isValidCSSWidth(widthValue)) {\n // Valid complete value - trim and save trimmed version\n ;(updated: any).width = widthValue\n setWidthError('')\n } else {\n // Invalid or incomplete - keep raw value for typing, but don't show error yet\n // Error will be shown on blur if still invalid\n setWidthError('')\n }\n }\n setEditedField(updated)\n }}\n onBlur={(e) => {\n // Validate on blur when user is done typing\n const widthValue = e.target.value.trim()\n const updated = { ...editedField }\n if (widthValue === '') {\n delete (updated: any).width\n setWidthError('')\n } else if (isValidCSSWidth(widthValue)) {\n ;(updated: any).width = widthValue\n setWidthError('')\n } else {\n ;(updated: any).width = widthValue\n setWidthError('Invalid CSS width value. Use px, %, em, rem, vw, vh, or calc()')\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., 80vw, 79%, 300px, calc(100% - 20px)\"\n style={{ borderColor: widthError ? 'red' : undefined }}\n />\n
\n {widthError ? (\n {widthError}\n ) : (\n <>\n Custom width for the chooser input. Overrides default width even in compact mode. Examples: 80vw, 79%, 300px,{' '}\n calc(100% - 20px). Leave empty to use default width.\n \n )}\n
\n
\n )}\n\n {shouldDisplayFieldType(editedField.type, ['separator', 'comment']) && (\n
\n \n updateField({ description: e.target.value })}\n onKeyDown={(e) => {\n // Stop Enter key from bubbling to prevent any form submission\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let textarea handle Enter naturally\n }\n }}\n placeholder=\"Help text shown below the field\"\n rows={2}\n />\n
(like this)
\n
\n )}\n\n {editedField.type === 'input' || editedField.type === 'input-readonly' || editedField.type === 'text' ? (\n <>\n
\n \n updateField({ default: e.target.value })} placeholder=\"Default value\" />\n
\n {editedField.type === 'input' && (\n <>\n
\n \n
\n
\n \n \n
\n \n )}\n \n ) : null}\n\n {editedField.type === 'textarea' ? (\n <>\n
\n \n updateField({ default: e.target.value })}\n onKeyDown={(e) => {\n // Stop Enter key from bubbling to prevent any form submission\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let textarea handle Enter naturally\n }\n }}\n placeholder=\"Default value (multi-line)\"\n rows={3}\n />\n
\n
\n \n
\n
\n \n updateField({ minRows: parseInt(e.target.value, 10) || 3 })} min=\"1\" max=\"20\" />\n
Starting height of the textarea (default: 3)
\n
\n
\n \n updateField({ maxRows: parseInt(e.target.value, 10) || 10 })} min=\"1\" max=\"50\" />\n
Maximum height before scrolling (default: 10)
\n
\n \n ) : null}\n\n {editedField.type === 'templatejs-block' ? (\n <>\n
\n \n {\n const newValue = e.target.value\n // Check for illegal backticks (```) - these are not allowed in templatejs blocks\n if (newValue.includes('```')) {\n // Remove backticks and show error\n const cleanedValue = newValue.replace(/```/g, '')\n updateField((({ templateJSContent: cleanedValue }: any): Partial))\n // Show error message\n setTemplateJSError('Backticks (```) are not allowed in TemplateJS blocks. They have been removed.')\n // Clear error after 3 seconds\n setTimeout(() => setTemplateJSError(''), 3000)\n } else {\n updateField((({ templateJSContent: newValue }: any): Partial))\n // Clear any previous error\n if (templateJSError) setTemplateJSError('')\n }\n }}\n onKeyDown={(e) => {\n // Stop Enter key from bubbling to prevent any form submission\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let textarea handle Enter naturally\n }\n }}\n placeholder=\"// Enter JavaScript to run for this form\"\n rows={10}\n style={{ width: '100%', fontFamily: 'Menlo, monospace', borderColor: templateJSError ? 'red' : undefined }}\n />\n {templateJSError &&
{templateJSError}
}\n
\n Enter without the backticks. Stored as plain text in the form definition.\n
\n Important: To set variables, your code must return an object. The returned object will be merged into the template context,\n making all its properties available to the template and later templatejs blocks.\n
\n Example:{' '}\n \n return {'{'} bgColor: 'blue-50', iconColor: 'blue-500' {'}'};\n \n
\n All form field values are available as variables in your code. Blocks execute top-to-bottom, so later blocks can use values from earlier blocks.\n
\n
\n
\n \n updateField((({ executeTiming: (e.target.value: any) || 'after' }: any): Partial))}\n style={{ width: '100%', padding: '0.5rem' }}\n >\n \n \n \n
Determines when this TemplateJS block runs during processing.
\n
\n \n ) : null}\n\n {editedField.type === 'number' ? (\n <>\n
\n \n updateField({ default: parseInt(e.target.value) || 0 })} />\n
\n
\n \n updateField({ step: parseInt(e.target.value) || 1 })} />\n
\n \n ) : null}\n\n {editedField.type === 'switch' ? (\n
\n \n
\n ) : null}\n\n {(editedField.type === 'dropdown-select' || editedField.type === 'combo' || editedField.type === 'button-group') && (\n
\n updateField({ options: newOptions })} />\n {(editedField.type === 'dropdown-select' || editedField.type === 'combo') && (\n <>\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).placeholder = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., Select a color\"\n />\n
Text shown when no option is selected (won't be submitted)
\n
\n {editedField.type === 'dropdown-select' &&\n (() => {\n // Build dropdown options from the field's options\n const defaultOptions = []\n if (editedField.options && editedField.options.length > 0) {\n editedField.options.forEach((opt: any) => {\n if (typeof opt === 'string') {\n defaultOptions.push({ label: opt, value: opt })\n } else if (opt && typeof opt === 'object' && opt.label && opt.value) {\n defaultOptions.push({ label: opt.label, value: opt.value })\n }\n })\n }\n return (\n
\n \n \n
Select which option should be pre-selected
\n
\n )\n })()}\n \n )}\n
\n )}\n\n {editedField.type === 'calendarpicker' && (\n <>\n {shouldDisplayFieldType(editedField.type, ['separator', 'heading']) && (\n
\n \n
\n )}\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).dateFormat = e.target.value\n setEditedField(updated)\n }}\n >\n {(() => {\n // Import date format options dynamically (avoiding circular dependency issues)\n // Use inline options array for now - we can refactor to use helper later if needed\n const options = [\n { value: '__object__', label: '[Object] - Return Date object' },\n { value: 'YYYY-MM-DD', label: '8601 Date (default) - YYYY-MM-DD' },\n { value: 'YYYY-MM-DD HH:mm', label: 'YYYY-MM-DD HH:mm - ISO date and time (24-hour)' },\n { value: 'YYYY-MM-DD HH:mm:ss', label: 'YYYY-MM-DD HH:mm:ss - ISO date and time with seconds' },\n { value: 'MM/DD/YYYY', label: 'MM/DD/YYYY - US date format' },\n { value: 'MM/DD/YY', label: 'MM/DD/YY - US date format (short year)' },\n { value: 'M/D/YYYY', label: 'M/D/YYYY - US date format (no leading zeros)' },\n { value: 'DD/MM/YYYY', label: 'DD/MM/YYYY - European date format' },\n { value: 'DD/MM/YY', label: 'DD/MM/YY - European date format (short year)' },\n { value: 'D/M/YYYY', label: 'D/M/YYYY - European date format (no leading zeros)' },\n { value: 'MMMM Do, YYYY', label: 'MMMM Do, YYYY - Long date format (e.g., December 22nd, 2024)' },\n { value: 'dddd, MMMM Do, YYYY', label: 'dddd, MMMM Do, YYYY - Full date with weekday' },\n { value: 'MMMM Do', label: 'MMMM Do - Month and day (e.g., December 22nd)' },\n { value: 'h:mm A', label: 'h:mm A - Time (12-hour with AM/PM)' },\n { value: 'hh:mm A', label: 'hh:mm A - Time (12-hour with AM/PM, leading zero)' },\n { value: 'h:mm:ss A', label: 'h:mm:ss A - Time with seconds (12-hour with AM/PM)' },\n { value: 'HH:mm', label: 'HH:mm - Time (24-hour)' },\n { value: 'HH:mm:ss', label: 'HH:mm:ss - Time with seconds (24-hour)' },\n { value: 'MM/DD/YYYY h:mm A', label: 'MM/DD/YYYY h:mm A - US date and time (12-hour)' },\n { value: 'MM/DD/YYYY HH:mm', label: 'MM/DD/YYYY HH:mm - US date and time (24-hour)' },\n { value: 'DD/MM/YYYY h:mm A', label: 'DD/MM/YYYY h:mm A - European date and time (12-hour)' },\n { value: 'DD/MM/YYYY HH:mm', label: 'DD/MM/YYYY HH:mm - European date and time (24-hour)' },\n { value: 'MMMM Do, YYYY h:mm A', label: 'MMMM Do, YYYY h:mm A - Long date and time (12-hour)' },\n { value: 'MMMM Do, YYYY HH:mm', label: 'MMMM Do, YYYY HH:mm - Long date and time (24-hour)' },\n { value: 'dddd', label: 'dddd - Day of week (full name)' },\n { value: 'ddd', label: 'ddd - Day of week (abbreviated)' },\n { value: 'MMMM', label: 'MMMM - Month name (full)' },\n { value: 'MMM', label: 'MMM - Month name (abbreviated)' },\n { value: 'YYYY', label: 'YYYY - Year (4 digits)' },\n { value: 'YY', label: 'YY - Year (2 digits)' },\n { value: 'Do', label: 'Do - Day of month with ordinal (e.g., 22nd)' },\n { value: 'D', label: 'D - Day of month (no leading zero)' },\n { value: 'DD', label: 'DD - Day of month (with leading zero)' },\n { value: 'wo [week of] YYYY', label: 'wo [week of] YYYY - Week number and year' },\n { value: 'Qo [quarter] YYYY', label: 'Qo [quarter] YYYY - Quarter and year' },\n ]\n return options.map((opt) => (\n \n ))\n })()}\n \n
\n Choose how to format the selected date. Default is ISO 8601 (YYYY-MM-DD). Use "[Object]" to return a Date object instead of a formatted string.\n
\n
\n \n )}\n\n {editedField.type === 'folder-chooser' && (\n <>\n
\n \n
Include the Archive folder in the list of available folders
\n
\n
\n \n
\n Add a "New Folder" option that allows users to create a new folder and select it. On macOS, users can also Option-click on a parent folder to create a\n new subfolder.\n
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).startFolder = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., /Projects\"\n />\n
Folder to start the list in (e.g., to limit folders to a specific subfolder). Leave empty to show all folders.
\n
\n
\n \n
Show the folder path (or most of it), not just the last folder name, to give more context
\n
\n
\n \n
Exclude teamspace folders from the list of folders
\n
\n
\n \n }).staticOptions\n ? JSON.stringify((editedField: any).staticOptions, null, 2)\n : ''\n }\n onChange={(e) => {\n const updated = { ...editedField }\n try {\n const parsed = e.target.value.trim() ? JSON.parse(e.target.value) : undefined\n ;(updated: any).staticOptions = Array.isArray(parsed) ? parsed : undefined\n } catch (error) {\n // Invalid JSON, don't update\n }\n setEditedField(updated)\n }}\n placeholder='[{\"label\": \"Select...\", \"value\": \"\n
\n If specified, folders will be filtered by the space selected in the space-chooser field. This is a value dependency - the field needs the value\n from another field to function.\n
\n
\n \n )}\n\n {editedField.type === 'note-chooser' && (\n <>\n
\n \n
Include personal/project notes in the list
\n
\n
\n \n
Include calendar notes (daily, weekly, monthly, etc.) in the list
\n
\n
\n \n
\n Include relative notes like <today>, <thisweek>, <nextweek>, <current>, <choose>. These are compatible with TemplateRunner.\n
\n
\n
\n \n
Include teamspace notes in the list
\n
\n
\n \n
When enabled, includes notes from @Templates and @Forms folders. By default, these folders are excluded from the note list.
\n
\n
\n \n
When enabled, displays the short description (e.g., folder path, space name) on a second line below the label
\n
\n
\n \n
\n When enabled, displays only the note title in the label (not "path / title"). The path will still appear in the short description if enabled.\n
\n
\n
\n \n
\n When enabled, shows a calendar icon button on the right side of the chooser to quickly select calendar notes. The button will only appear if "Include Calendar Notes" is enabled, or if you explicitly enable this option.\n
\n
\n
\n \n
\n When enabled, allows selecting multiple notes. The chooser will display as a multi-select list with checkboxes.\n
\n
\n {((editedField: any): { allowMultiSelect?: boolean }).allowMultiSelect && (\n <>\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).noteOutputFormat = e.target.value\n setEditedField(updated)\n }}\n >\n \n \n \n \n \n \n
\n Choose how to format the selected notes in the output. Wikilink format is compatible with NotePlan's native linking. "Plain Title" and "Filename" return just the title or filename without any formatting.\n
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).noteSeparator = e.target.value\n setEditedField(updated)\n }}\n >\n \n \n \n \n
Choose how to separate multiple selected notes in the output.
\n
\n \n )}\n {!((editedField: any): { allowMultiSelect?: boolean }).allowMultiSelect && (\n
\n \n {\n const updated = { ...editedField }\n const value = e.target.value\n // Set noteOutputFormat (new unified setting)\n ;(updated: any).noteOutputFormat = value\n // Clear deprecated singleSelectOutputFormat if it exists\n if ((updated: any).singleSelectOutputFormat) {\n delete (updated: any).singleSelectOutputFormat\n }\n setEditedField(updated)\n }}\n >\n \n \n \n
\n Choose what to output when a single note is selected. "Title" returns the note title, "Filename" returns the full filename path. Note: Wikilink, Pretty Link, and Raw URL formats are not available for single-select mode.\n
\n
\n )}\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).startFolder = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., @Templates/Forms\"\n />\n
\n Filter notes to only show those in this folder and its subfolders. Leave empty to show all notes. Example: "@Templates/Forms"\n
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).includeRegex = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., ^Project\"\n />\n
\n Optional regex pattern to include only notes whose title or filename matches. Case-insensitive. Leave empty to include all notes. Example: "^Project" to include only notes starting with "Project"\n
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).excludeRegex = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., Archive|Draft\"\n />\n
\n Optional regex pattern to exclude notes whose title or filename matches. Case-insensitive. Leave empty to exclude nothing. Example: "Archive|Draft" to exclude notes containing "Archive" or "Draft"\n
\n
\n \n )}\n\n {editedField.type === 'space-chooser' && (\n <>\n
\n \n
\n When enabled, adds an "All Private + Spaces" option that returns "__all__" when selected. This allows users to select all spaces at once.\n NOTE: whatever is receiving the value needs to handle the "__all__" value appropriately.\n
\n
\n
\n \n
When enabled, displays the short description (e.g., folder path, space name) on a second line below the label
\n
\n \n )}\n\n {editedField.type === 'event-chooser' && (\n <>\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).sourceDateKey = e.target.value || undefined\n // Also set old property for backward compatibility\n if (e.target.value) {\n ;(updated: any).dependsOnDateKey = e.target.value\n } else {\n delete (updated: any).dependsOnDateKey\n }\n setEditedField(updated)\n }}\n >\n \n {allFields\n .filter((f) => f.key && (f.type === 'calendarpicker' || f.type === 'input') && f.key !== editedField.key)\n .map((f) => (\n \n ))}\n \n
\n If specified, events will be loaded for the date from the selected field. The field can be a Date Picker (returns Date) or a text input with a date string\n (YYYY-MM-DD format). If not specified, events default to today. This is a value dependency - the field needs the value from another field to\n function.\n
\n
\n
\n \n {\n const eventDate = ((editedField: any): { eventDate?: Date }).eventDate\n if (!eventDate) return ''\n if (eventDate instanceof Date) {\n return eventDate.toISOString().split('T')[0]\n }\n return String(eventDate)\n })()}\n onChange={(e) => {\n const updated = { ...editedField }\n const dateStr = e.target.value\n if (dateStr) {\n const parsed = new Date(dateStr)\n if (!isNaN(parsed.getTime())) {\n ;(updated: any).eventDate = parsed\n } else {\n ;(updated: any).eventDate = undefined\n }\n } else {\n ;(updated: any).eventDate = undefined\n }\n setEditedField(updated)\n }}\n placeholder=\"YYYY-MM-DD (e.g., 2024-01-15)\"\n />\n
Default date to load events for (if not depending on another field). Leave empty to use today. Format: YYYY-MM-DD
\n
\n
\n \n
If checked, include events from all calendars NotePlan has access to. This bypasses the calendar list below.
\n
\n
\n \n {!calendarsLoaded && requestFromPlugin ? (\n
Loading calendars...
\n ) : calendars.length === 0 ? (\n
No calendars available
\n ) : (\n
\n \n {calendars.map((calendar) => {\n const selectedCalendars = ((editedField: any): { selectedCalendars?: Array }).selectedCalendars || []\n const isChecked = selectedCalendars.includes(calendar)\n const allCalendars = ((editedField: any): { allCalendars?: boolean }).allCalendars || false\n return (\n \n )\n })}\n
\n
\n Select which calendars to include events from. Leave all unchecked to include events from all calendars.\n
\n NOTE: Due to a bug in NotePlan's API, this list may be incomplete.\n
\n
\n )}\n
\n
\n \n {\n const updated = { ...editedField }\n const regexStr = e.target.value.trim()\n if (regexStr) {\n ;(updated: any).calendarFilterRegex = regexStr\n } else {\n ;(updated: any).calendarFilterRegex = undefined\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., ^Work|^Personal (regex pattern)\"\n />\n
\n Optional regex pattern to filter calendars after fetching events. Applied when "All NotePlan Enabled Calendars" is enabled. Leave empty to include all\n calendars.\n
\n
\n
\n \n {\n const updated = { ...editedField }\n const regexStr = e.target.value.trim()\n if (regexStr) {\n ;(updated: any).eventFilterRegex = regexStr\n } else {\n ;(updated: any).eventFilterRegex = undefined\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., Meeting|Standup\"\n />\n
\n Optional regex pattern to filter events by title after fetching. Applied to all fetched events before display. Leave empty to include all events.\n
\n
\n
\n \n
Include reminders in the event list
\n
\n {((editedField: any): { includeReminders?: boolean }).includeReminders && (\n
\n \n {!reminderListsLoaded && requestFromPlugin ? (\n
Loading reminder lists...
\n ) : reminderLists.length === 0 ? (\n
No reminder lists available
\n ) : (\n
\n \n {reminderLists.map((list) => {\n const selectedLists = ((editedField: any): { reminderLists?: Array }).reminderLists || []\n const isChecked = selectedLists.includes(list)\n return (\n \n )\n })}\n
\n
Select which reminder lists to include. Leave all unchecked to include reminders from all lists.
\n
\n )}\n
\n )}\n
\n \n
When enabled, displays the short description (e.g., calendar name) on a second line below the label
\n
\n \n )}\n\n {editedField.type === 'heading-chooser' && (\n <>\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).sourceNoteKey = e.target.value || undefined\n // Also set old property for backward compatibility\n if (e.target.value) {\n ;(updated: any).dependsOnNoteKey = e.target.value\n } else {\n delete (updated: any).dependsOnNoteKey\n }\n setEditedField(updated)\n }}\n >\n \n {allFields\n .filter((f) => f.key && f.type === 'note-chooser' && f.key !== editedField.key)\n .map((f) => (\n \n ))}\n \n
\n If specified, headings will be loaded dynamically from the selected note. Otherwise, use static headings below. This is a value dependency - the\n field needs the value from another field to function.\n
\n
\n
\n \n }).staticHeadings?.join('\\n') || ''}\n onChange={(e) => {\n const updated = { ...editedField }\n ;(updated: any).staticHeadings = e.target.value\n .split('\\n')\n .map((h) => h.trim())\n .filter((h) => h.length > 0)\n setEditedField(updated)\n }}\n onKeyDown={(e) => {\n // Stop Enter key from bubbling to prevent any form submission\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let textarea handle Enter naturally\n }\n }}\n placeholder=\"Enter one heading per line Tasks Projects Archive\"\n rows={5}\n />\n
Enter headings one per line. Only used if "Depends On Note Field" is not set.
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).defaultHeading = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., Tasks\"\n />\n
Default heading to use if none is selected
\n
\n
\n \n
\n
\n \n
\n
\n \n
When enabled, displays the short description on a second line below the label
\n
\n \n )}\n\n {editedField.type === 'frontmatter-key-chooser' && (\n <>\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).frontmatterKey = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., status, category, priority\"\n />\n
Enter the frontmatter key name (e.g., "status"). Leave empty if using a source field below.
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).sourceKeyKey = e.target.value || undefined\n setEditedField(updated)\n }}\n >\n \n {allFields\n .filter((f) => f.key && (f.type === 'input' || f.type === 'text') && f.key !== editedField.key)\n .map((f) => (\n \n ))}\n \n
\n If specified, the frontmatter key will be read from this field's value. Otherwise, use the fixed key above. This is a value dependency - the\n field needs the value from another field to function.\n
\n
\n
\n \n
If checked, returns selected values as an array. Otherwise, returns as string (format set by Value Separator below).
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).valueSeparator = e.target.value || undefined\n setEditedField(updated)\n }}\n >\n \n \n \n \n
How to join multiple selected values when not returning as array. Comma with space is default for readability.
\n
\n
\n \n
If checked, all items will be selected by default.
\n
\n
\n \n
If checked, users can create new frontmatter values that don't exist yet.
\n
\n
\n \n
\n If checked, allows selecting only one value (no checkboxes, returns single value). Clicking an item or pressing Enter selects it immediately.\n
\n
\n
\n \n
If checked and "Choose Single Value" is enabled, renders as a dropdown-select instead of a filterable chooser.
\n
\n
\n \n {\n const updated = { ...editedField }\n const value = parseFloat(e.target.value)\n if (e.target.value === '' || isNaN(value) || value <= 0) {\n delete (updated: any).maxRows\n } else {\n ;(updated: any).maxRows = value\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., 5 or 5.5\"\n min=\"0.1\"\n />\n
\n Limit the height to show only this many result rows (overrides Max Height if provided). Assumes ~40px per row. Decimal values allowed (e.g., 5.5 for finer\n control).\n
\n
\n
\n \n {\n const rawValue = e.target.value\n const widthValue = rawValue.trim()\n const updated = { ...editedField }\n if (widthValue === '') {\n delete (updated: any).width\n setWidthError('')\n } else {\n // Always save the raw value while typing (allows partial/invalid values during typing)\n ;(updated: any).width = rawValue\n // Only validate if the trimmed value is complete (has a valid CSS unit or is a valid calc())\n // This allows typing intermediate values like \"80\", \"80v\", \"calc(\" without errors\n if (isValidCSSWidth(widthValue)) {\n // Valid complete value - trim and save trimmed version\n ;(updated: any).width = widthValue\n setWidthError('')\n } else {\n // Invalid or incomplete - keep raw value for typing, but don't show error yet\n // Error will be shown on blur if still invalid\n setWidthError('')\n }\n }\n setEditedField(updated)\n }}\n onBlur={(e) => {\n // Validate on blur when user is done typing\n const widthValue = e.target.value.trim()\n const updated = { ...editedField }\n if (widthValue === '') {\n delete (updated: any).width\n setWidthError('')\n } else if (isValidCSSWidth(widthValue)) {\n ;(updated: any).width = widthValue\n setWidthError('')\n } else {\n ;(updated: any).width = widthValue\n setWidthError('Invalid CSS width value. Use px, %, em, rem, vw, vh, or calc()')\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., 300px, 80%, calc(100% - 20px)\"\n style={{ borderColor: widthError ? 'red' : undefined }}\n />\n
\n {widthError ? (\n {widthError}\n ) : (\n <>\n Custom width for the entire control. Overrides default width. Examples: 300px, 80%, calc(100% - 20px). Leave empty to\n use default width.\n \n )}\n
\n
\n
\n \n {\n const updated = { ...editedField }\n const heightValue = e.target.value.trim()\n if (heightValue === '') {\n delete (updated: any).height\n } else {\n ;(updated: any).height = heightValue\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., 400px\"\n />\n
\n Custom height for the entire control. Overrides Max Height and Max Result Rows. Examples: 400px, 50vh. Leave empty to use default\n height.\n
\n
\n
\n \n {\n const updated = { ...editedField }\n const patternValue = e.target.value.trim()\n if (patternValue === '') {\n delete (updated: any).includePattern\n } else {\n ;(updated: any).includePattern = patternValue\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., ^work|^personal\"\n />\n
Optional regex pattern to include only items that match. Leave empty to include all items.
\n
\n
\n \n {\n const updated = { ...editedField }\n const patternValue = e.target.value.trim()\n if (patternValue === '') {\n delete (updated: any).excludePattern\n } else {\n ;(updated: any).excludePattern = patternValue\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., ^archive|^old\"\n />\n
Optional regex pattern to exclude items that match. Leave empty to exclude nothing.
\n
\n \n )}\n\n {(editedField.type === 'tag-chooser' || editedField.type === 'mention-chooser') && (\n <>\n
\n \n
If checked, returns selected values as an array. Otherwise, returns as string (format set by Value Separator below).
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).valueSeparator = e.target.value || undefined\n setEditedField(updated)\n }}\n >\n \n \n \n \n
How to join multiple selected values when not returning as array. Comma with space is default for readability.
\n
\n
\n \n
If checked, all items will be selected by default.
\n
\n
\n \n
If checked, users can create new {editedField.type === 'tag-chooser' ? 'tags' : 'mentions'} that don't exist yet.
\n
\n
\n \n
\n If checked, allows selecting only one value (no checkboxes, returns single value). Clicking an item or pressing Enter selects it immediately.\n
\n
\n
\n \n
If checked and "Choose Single Value" is enabled, renders as a dropdown-select instead of a filterable chooser.
\n
\n
\n \n {\n const updated = { ...editedField }\n const value = parseFloat(e.target.value)\n if (e.target.value === '' || isNaN(value) || value <= 0) {\n delete (updated: any).maxRows\n } else {\n ;(updated: any).maxRows = value\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., 5 or 5.5\"\n min=\"0.1\"\n />\n
\n Limit the height to show only this many result rows (overrides Max Height if provided). Assumes ~40px per row. Decimal values allowed (e.g., 5.5 for finer\n control).\n
\n
\n
\n \n {\n const rawValue = e.target.value\n const widthValue = rawValue.trim()\n const updated = { ...editedField }\n if (widthValue === '') {\n delete (updated: any).width\n setWidthError('')\n } else {\n // Always save the raw value while typing (allows partial/invalid values during typing)\n ;(updated: any).width = rawValue\n // Only validate if the trimmed value is complete (has a valid CSS unit or is a valid calc())\n // This allows typing intermediate values like \"80\", \"80v\", \"calc(\" without errors\n if (isValidCSSWidth(widthValue)) {\n // Valid complete value - trim and save trimmed version\n ;(updated: any).width = widthValue\n setWidthError('')\n } else {\n // Invalid or incomplete - keep raw value for typing, but don't show error yet\n // Error will be shown on blur if still invalid\n setWidthError('')\n }\n }\n setEditedField(updated)\n }}\n onBlur={(e) => {\n // Validate on blur when user is done typing\n const widthValue = e.target.value.trim()\n const updated = { ...editedField }\n if (widthValue === '') {\n delete (updated: any).width\n setWidthError('')\n } else if (isValidCSSWidth(widthValue)) {\n ;(updated: any).width = widthValue\n setWidthError('')\n } else {\n ;(updated: any).width = widthValue\n setWidthError('Invalid CSS width value. Use px, %, em, rem, vw, vh, or calc()')\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., 300px, 80%, calc(100% - 20px)\"\n style={{ borderColor: widthError ? 'red' : undefined }}\n />\n
\n {widthError ? (\n {widthError}\n ) : (\n <>\n Custom width for the entire control. Overrides default width. Examples: 300px, 80%, calc(100% - 20px). Leave empty to\n use default width.\n \n )}\n
\n
\n
\n \n {\n const updated = { ...editedField }\n const heightValue = e.target.value.trim()\n if (heightValue === '') {\n delete (updated: any).height\n } else {\n ;(updated: any).height = heightValue\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., 400px\"\n />\n
\n Custom height for the entire control. Overrides Max Height and Max Result Rows. Examples: 400px, 50vh. Leave empty to use default\n height.\n
\n
\n
\n \n {\n const updated = { ...editedField }\n const patternValue = e.target.value.trim()\n if (patternValue === '') {\n delete (updated: any).includePattern\n } else {\n ;(updated: any).includePattern = patternValue\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., ^work|^personal\"\n />\n
Optional regex pattern to include only items that match. Leave empty to include all items.
\n
\n
\n \n {\n const updated = { ...editedField }\n const patternValue = e.target.value.trim()\n if (patternValue === '') {\n delete (updated: any).excludePattern\n } else {\n ;(updated: any).excludePattern = patternValue\n }\n setEditedField(updated)\n }}\n placeholder=\"e.g., ^archive|^old\"\n />\n
Optional regex pattern to exclude items that match. Leave empty to exclude nothing.
\n
\n \n )}\n\n {editedField.type === 'markdown-preview' && (\n <>\n
\n \n {\n const field = (editedField: any)\n // Check in priority order - if sourceNoteKey exists (even if empty string), it's 'field'\n if (field.sourceNoteKey !== undefined || field.dependsOnNoteKey !== undefined) {\n return 'field'\n }\n // If markdownNoteFilename exists (even if empty string), it's 'filename'\n if (field.markdownNoteFilename !== undefined) {\n return 'filename'\n }\n // If markdownNoteTitle exists (even if empty string), it's 'title'\n if (field.markdownNoteTitle !== undefined) {\n return 'title'\n }\n // If markdownText exists (even if empty string), it's 'static'\n if (field.markdownText !== undefined) {\n return 'static'\n }\n // Default to static\n return 'static'\n })()}\n onChange={(e) => {\n const updated = { ...editedField }\n const sourceType = e.target.value\n // Clear all source options\n delete (updated: any).markdownText\n delete (updated: any).markdownNoteFilename\n delete (updated: any).markdownNoteTitle\n // Set default based on type\n if (sourceType === 'static') {\n ;(updated: any).markdownText = ''\n // Clear field-related properties when switching away from field mode\n delete (updated: any).sourceNoteKey\n delete (updated: any).dependsOnNoteKey\n } else if (sourceType === 'filename') {\n ;(updated: any).markdownNoteFilename = ''\n // Clear field-related properties when switching away from field mode\n delete (updated: any).sourceNoteKey\n delete (updated: any).dependsOnNoteKey\n } else if (sourceType === 'title') {\n ;(updated: any).markdownNoteTitle = ''\n // Clear field-related properties when switching away from field mode\n delete (updated: any).sourceNoteKey\n delete (updated: any).dependsOnNoteKey\n } else if (sourceType === 'field') {\n // When switching to field mode, set sourceNoteKey to empty string if it doesn't exist\n // This ensures the dropdown stays on 'field' option\n // If it already exists, preserve it (user may have already selected a field)\n if (!(updated: any).sourceNoteKey && !(updated: any).dependsOnNoteKey) {\n ;(updated: any).sourceNoteKey = ''\n }\n }\n setEditedField(updated)\n }}\n >\n \n \n \n \n \n
\n Choose how to get the markdown content to display. Note: This is a very basic markdown renderer that does not display full NotePlan formatted\n tasks and items. It's intended for a quick preview, not a faithful rendering.\n
\n
\n\n {(() => {\n const field = (editedField: any)\n // Determine source type\n let sourceType = 'static'\n // Check in priority order - if sourceNoteKey exists (even if empty string), it's 'field'\n if (field.sourceNoteKey !== undefined || field.dependsOnNoteKey !== undefined) {\n sourceType = 'field'\n }\n // If markdownNoteFilename exists (even if empty string), it's 'filename'\n else if (field.markdownNoteFilename !== undefined) {\n sourceType = 'filename'\n }\n // If markdownNoteTitle exists (even if empty string), it's 'title'\n else if (field.markdownNoteTitle !== undefined) {\n sourceType = 'title'\n }\n // If markdownText exists (even if empty string), it's 'static'\n else if (field.markdownText !== undefined) {\n sourceType = 'static'\n }\n\n return (\n <>\n {sourceType === 'static' && (\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).markdownText = e.target.value\n setEditedField(updated)\n }}\n onKeyDown={(e) => {\n // Stop Enter key from bubbling to prevent any form submission\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let textarea handle Enter naturally\n }\n }}\n placeholder=\"Enter markdown text to display...\"\n rows={10}\n />\n
Enter the markdown text to display (e.g., instructions)
\n
\n )}\n\n {sourceType === 'filename' && (\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).markdownNoteFilename = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., MyNote.md or 20240101.md\"\n />\n
Enter the filename (with extension) of the note to display
\n
\n )}\n\n {sourceType === 'title' && (\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).markdownNoteTitle = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"e.g., My Note\"\n />\n
Enter the title of the note to display
\n
\n )}\n\n {sourceType === 'field' && (\n
\n \n {\n const updated = { ...editedField }\n const value = e.target.value\n // Set sourceNoteKey to the value (even if empty string, to maintain 'field' mode)\n ;(updated: any).sourceNoteKey = value || ''\n // Also set old property for backward compatibility\n if (value) {\n ;(updated: any).dependsOnNoteKey = value\n } else {\n delete (updated: any).dependsOnNoteKey\n }\n setEditedField(updated)\n }}\n >\n \n {allFields\n .filter((f) => f.key && f.type === 'note-chooser' && f.key !== editedField.key)\n .map((f) => (\n \n ))}\n \n
\n Select a note-chooser field. The preview will display the note selected in that field. This is a value dependency - the field needs the\n value from another field to function.\n
\n
\n )}\n \n )\n })()}\n \n )}\n\n {editedField.type === 'comment' && (\n <>\n
\n \n {\n updateField((({ commentText: e.target.value }: any): Partial))\n }}\n onKeyDown={(e) => {\n // Stop Enter key from bubbling to prevent any form submission\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let textarea handle Enter naturally\n }\n }}\n placeholder=\"Enter your comment or notes here (supports markdown)...\"\n rows={10}\n style={{ width: '100%' }}\n />\n
Enter markdown text for your comment. This field is only visible in Form Builder and will not appear in the form output.
\n
\n
\n \n
If checked, the comment will be expanded (showing content) by default in Form Builder. If unchecked, it will be collapsed.
\n
\n \n )}\n\n {editedField.type === 'conditional-values' && (\n <>\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).sourceFieldKey = e.target.value || undefined\n setEditedField(updated)\n }}\n >\n \n {allFields\n .filter((f) => f.key && f.key !== editedField.key)\n .map((f) => (\n \n ))}\n \n
\n This field's value will be set based on the selected field's value. When it matches a condition below, this field gets the paired value.\n
\n
\n
\n }).conditions || []}\n onChange={(newConditions) => updateField({ conditions: newConditions })}\n />\n
\n
\n \n
If checked, matching is case-sensitive. Otherwise "Trip" and "trip" are equivalent.
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).matchMode = (e.target.value === 'regex' ? 'regex' : 'string')\n setEditedField(updated)\n }}\n >\n \n \n \n
String: "Match" must equal the source value. Regex: "Match" is a regular expression.
\n
\n
\n \n {\n const updated = { ...editedField }\n ;(updated: any).defaultWhenNoMatch = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"Leave blank to clear on no match\"\n />\n
Value to set when the source does not match any condition. Leave blank to clear this field.
\n
\n
\n \n
If checked, leading/trailing spaces are removed from the source value before matching. Default: on.
\n
\n
\n \n
If checked, the resolved value is shown read-only in the form. Uncheck for a hidden derived field.
\n
\n \n )}\n\n {editedField.type === 'heading' && (\n <>\n
\n \n
Add an underline directly under the heading with minimal margin/padding
\n
\n \n )}\n\n {editedField.type === 'autosave' && (\n <>\n
\n \n {\n const updated = { ...editedField }\n const value = parseInt(e.target.value, 10)\n ;(updated: any).autosaveInterval = isNaN(value) || value < 1 ? 2 : value\n setEditedField(updated)\n }}\n placeholder=\"2\"\n />\n
\n How often (in seconds) to automatically save the form state. Default is 2 seconds. The form will only save if the content has changed since the last save.\n
\n
\n
\n \n '}\n onChange={(e) => {\n const updated = { ...editedField }\n ;(updated: any).autosaveFilename = e.target.value || undefined\n setEditedField(updated)\n }}\n placeholder=\"@Trash/Autosave-\"\n />\n
\n Filename pattern for autosave files. Available placeholders:\n
    \n
  • \n <ISO8601> or <timestamp> - Timestamp in local timezone format: YYYY-MM-DDTHH-MM-SS\n
    • \n
  • \n <formTitle> or <FORM_NAME> - Form title (sanitized for filesystem compatibility)\n
    • \n
\n Default is "@Trash/Autosave-<formTitle>-<ISO8601>" (or "@Trash/Autosave-<ISO8601>" if no form title). The form title will be\n automatically included if available.\n
\n
\n
\n \n
\n When checked, the autosave field will not display any UI message, but will still automatically save the form state in the background.\n
\n
\n \n )}\n\n {needsKey && (\n
\n \n {\n const updated = { ...editedField }\n updated.requiresKey = e.target.value || undefined\n // Also set old property for backward compatibility\n if (e.target.value) {\n updated.dependsOnKey = e.target.value\n } else {\n delete updated.dependsOnKey\n }\n setEditedField(updated)\n }}\n >\n \n {dependencyOptions.map((option) => (\n \n ))}\n \n
\n This field will only be visible/enabled when the specified field is true/has a value. This is a prerequisite - the field must be set for this field\n to be visible or editable.\n
\n
\n )}\n
\n
\n \n \n
\n \n \n )\n}\n\nexport default FieldEditor\n" }, { "path": "dwertheimer.Forms/src/components/FieldTypeSelector.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FieldTypeSelector Component - Modal for selecting field type when adding new field\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, useRef, useMemo, type Node } from 'react'\nimport { FIELD_TYPES, type FieldTypeOption } from './fieldTypes.js'\nimport { type TSettingItemType } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\n\ntype FieldTypeSelectorProps = {\n isOpen: boolean,\n onSelect: (type: TSettingItemType) => void,\n onClose: () => void,\n}\n\nexport function FieldTypeSelector({ isOpen, onSelect, onClose }: FieldTypeSelectorProps): Node {\n const [filterText, setFilterText] = useState('')\n const filterInputRef = useRef(null)\n\n // Focus filter input when modal opens\n useEffect(() => {\n if (isOpen && filterInputRef.current) {\n // Use setTimeout to ensure the modal is fully rendered\n setTimeout(() => {\n if (filterInputRef.current) {\n filterInputRef.current.focus()\n }\n }, 0)\n } else if (!isOpen) {\n // Clear filter when modal closes\n setFilterText('')\n }\n }, [isOpen])\n\n // Filter field types based on filter text (searches in value, label, and description)\n const filteredFieldTypes = useMemo(() => {\n if (!filterText.trim()) {\n return FIELD_TYPES\n }\n const searchTerm = filterText.toLowerCase()\n return FIELD_TYPES.filter((fieldType) => {\n return (\n fieldType.value.toLowerCase().includes(searchTerm) ||\n fieldType.label.toLowerCase().includes(searchTerm) ||\n fieldType.description.toLowerCase().includes(searchTerm)\n )\n })\n }, [filterText])\n\n if (!isOpen) return null\n\n const handleSelect = (fieldType: FieldTypeOption) => {\n onSelect(fieldType.value)\n }\n\n return (\n
\n
e.stopPropagation()}>\n
\n

Select Field Type

\n
\n setFilterText(e.target.value)}\n onClick={(e) => e.stopPropagation()}\n />\n
\n \n
\n
\n
\n {filteredFieldTypes.length === 0 ? (\n
No field types match your search.
\n ) : (\n filteredFieldTypes.map((fieldType) => (\n
handleSelect(fieldType)}>\n
{fieldType.label}
\n
{fieldType.description}
\n
\n ))\n )}\n
\n
\n
\n \n
\n
\n
\n )\n}\n\nexport default FieldTypeSelector\n" }, { "path": "dwertheimer.Forms/src/components/FormBrowserView.css", "content": "/* FormBrowserView Styles */\n\n.form-browser-container {\n display: flex;\n flex-direction: column;\n height: 100vh;\n width: 100%;\n overflow: hidden;\n background: var(--bg-main-color);\n}\n\n.form-browser-header {\n flex-shrink: 0;\n padding: 1rem;\n border-bottom: 1px solid var(--divider-color);\n background: var(--bg-alt-color);\n}\n\n.form-browser-title {\n margin: 0;\n font-size: 1.5rem;\n font-weight: 600;\n color: var(--fg-main-color);\n}\n\n.form-browser-space-chooser {\n flex: 0 0 auto;\n width: 100%;\n}\n\n.form-browser-filter-row {\n display: flex;\n gap: 0.5rem;\n align-items: center;\n width: 100%;\n}\n\n.form-browser-filter {\n flex: 1 1 auto;\n min-width: 0;\n}\n\n.form-browser-filter-input {\n width: 100%;\n padding: 0.5rem 0.75rem;\n font-size: 0.9rem;\n border: 1px solid var(--divider-color);\n border-radius: 4px;\n background: var(--bg-apple-input-color);\n color: var(--fg-main-color);\n}\n\n.form-browser-filter-input:focus {\n outline: none;\n border-color: var(--tint-color);\n box-shadow: 0 0 0 2px color-mix(in oklch, var(--tint-color), transparent 90%);\n}\n\n.form-browser-button {\n flex: 0 0 auto;\n padding: 0.5rem 1rem;\n font-size: 0.9rem;\n font-weight: 500;\n border: none;\n border-radius: 4px;\n cursor: pointer;\n transition: background 0.2s;\n white-space: nowrap;\n}\n\n.form-browser-button-new {\n background: var(--bg-mid-color);\n color: var(--fg-main-color);\n}\n\n.form-browser-button-new:hover {\n background: var(--tint-color);\n color: var(--fg-main-color);\n}\n\n.form-browser-button-new:active {\n background: var(--tint-color);\n color: var(--fg-main-color);\n opacity: 0.8;\n}\n\n.form-browser-button-new:focus {\n outline: none;\n background: var(--bg-alt-color);\n color: var(--fg-main-color);\n}\n\n.form-browser-button-reload {\n background: var(--bg-alt-color);\n color: var(--fg-main-color);\n border: 1px solid var(--divider-color);\n font-size: 1.2rem;\n padding: 0.5rem 0.75rem;\n}\n\n.form-browser-button-reload:hover {\n background: var(--bg-mid-color);\n}\n\n.form-browser-content {\n flex: 1;\n overflow: hidden;\n display: flex;\n flex-direction: column;\n}\n\n.form-browser-panels {\n height: 100%;\n width: 100%;\n}\n\n.form-browser-left-panel {\n min-width: 300px;\n}\n\n.form-browser-list-container {\n height: 100%;\n display: flex;\n flex-direction: column;\n overflow: hidden;\n background: var(--bg-alt-color);\n}\n\n.form-browser-left-controls {\n flex-shrink: 0;\n padding: 1rem;\n border-bottom: 1px solid var(--divider-color);\n background: var(--bg-alt-color);\n display: flex;\n flex-direction: column;\n gap: 0.75rem;\n}\n\n.form-browser-list-header {\n flex-shrink: 0;\n padding: 1rem;\n border-bottom: 1px solid var(--divider-color);\n background: var(--bg-alt-color);\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.5rem;\n}\n\n.form-browser-list-header h3 {\n margin: 0;\n font-size: 1rem;\n font-weight: 600;\n color: var(--fg-main-color);\n background: unset;\n}\n\n.form-browser-list {\n flex: 1;\n overflow-y: auto;\n padding: 0.5rem;\n outline: none;\n}\n\n.form-browser-list-loading,\n.form-browser-list-empty {\n padding: 2rem;\n text-align: center;\n color: var(--fg-placeholder-color);\n font-style: italic;\n}\n\n.form-browser-list-item {\n padding: 0.75rem 1rem;\n margin-bottom: 0.25rem;\n border-radius: 4px;\n cursor: pointer;\n background: var(--bg-main-color);\n border: 1px solid var(--divider-color);\n transition: all 0.2s;\n outline: none;\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.5rem;\n}\n\n.form-browser-list-item-content {\n flex: 1;\n min-width: 0;\n display: flex;\n flex-direction: column;\n gap: 0.25rem;\n}\n\n.form-browser-list-item-label {\n flex: 1;\n min-width: 0;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.form-browser-list-item-space {\n font-size: 0.75rem;\n opacity: 0.6;\n color: var(--fg-placeholder-color);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.form-browser-list-item.selected .form-browser-list-item-space {\n color: color-mix(in oklch, var(--fg-main-color), transparent 20%);\n}\n\n.form-browser-list-item-actions {\n display: flex;\n gap: 0.25rem;\n flex-shrink: 0;\n}\n\n.form-browser-list-item-button {\n padding: 0.25rem 0.5rem;\n font-size: 0.9rem;\n border: none;\n border-radius: 4px;\n cursor: pointer;\n background: transparent;\n transition: background 0.2s;\n opacity: 0.7;\n}\n\n.form-browser-list-item:hover .form-browser-list-item-button {\n opacity: 1;\n}\n\n.form-browser-list-item-button:hover {\n background: var(--bg-mid-color);\n}\n\n.form-browser-list-item.selected .form-browser-list-item-button:hover {\n background: color-mix(in oklch, var(--tint-color), var(--fg-main-color) 20%);\n}\n\n.form-browser-list-item-button-edit {\n filter: grayscale(100%);\n opacity: 0.6;\n}\n\n.form-browser-list-item:hover .form-browser-list-item-button-edit {\n opacity: 0.8;\n}\n\n.form-browser-list-item:hover {\n background: var(--bg-mid-color);\n border-color: var(--tint-color);\n}\n\n.form-browser-list-item.selected {\n background: var(--tint-color);\n color: var(--fg-main-color);\n border-color: var(--tint-color);\n}\n\n.form-browser-list-item.active {\n border: 2px solid var(--tint-color);\n font-weight: 600;\n}\n\n.form-browser-list-item.active.selected {\n background: var(--tint-color);\n color: var(--fg-main-color);\n}\n\n.form-browser-resize-handle {\n background-color: var(--divider-color);\n width: 4px;\n cursor: col-resize;\n transition: background-color 0.2s;\n}\n\n.form-browser-resize-handle:hover {\n background-color: var(--bg-mid-color);\n}\n\n.form-browser-form-container {\n height: 100%;\n overflow: hidden;\n display: flex;\n flex-direction: column;\n background: var(--bg-main-color);\n}\n\n.form-browser-form-wrapper {\n height: 100%;\n overflow-y: auto;\n padding: 1rem;\n position: relative;\n}\n\n.form-browser-preview-wrapper {\n height: 100%;\n display: flex;\n flex-direction: column;\n}\n\n/* Override FormPreview styling for form browser context */\n.form-browser-preview-wrapper .form-builder-preview {\n height: 100%;\n display: flex;\n flex-direction: column;\n overflow: hidden;\n}\n\n.form-browser-preview-wrapper .form-preview-container {\n flex: 1;\n overflow: auto;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: flex-start;\n padding: 1rem;\n position: relative;\n width: 100%;\n box-sizing: border-box;\n}\n\n.form-browser-preview-wrapper .form-preview-window {\n display: flex;\n flex-direction: column;\n overflow: hidden;\n /* Dimensions will be set via inline styles from component */\n /* Remove fixed width/height to allow calculated dimensions */\n}\n\n.form-browser-preview-wrapper .form-preview-scaled-disclaimer {\n position: sticky;\n top: 0;\n z-index: 10;\n background: var(--bg-mid-color);\n opacity: 0.5;\n color: var(--fg-main-color);\n padding: 0.5rem 1rem;\n margin-bottom: 0.5rem;\n border-radius: 4px;\n font-size: 0.85rem;\n text-align: center;\n box-shadow: 0 2px 4px color-mix(in oklch, var(--bg-main-color), black 20%);\n width: 100%;\n max-width: 90%;\n box-sizing: border-box;\n}\n\n.form-browser-preview-wrapper .form-preview-window-content {\n flex: 1;\n overflow-y: auto;\n overflow-x: hidden;\n}\n\n/* Override DynamicDialog positioning when in form browser preview */\n.form-browser-preview-wrapper .dynamic-dialog {\n position: relative !important;\n top: auto !important;\n left: auto !important;\n transform: none !important;\n width: 100% !important;\n max-width: 100% !important;\n height: 100% !important;\n max-height: 100% !important;\n box-shadow: none !important;\n margin: 0 !important;\n /* set the text color of the dialog to the main color */\n color: var(--fg-main-color);\n}\n\n.form-browser-preview-wrapper .dynamic-dialog input,\n.form-browser-preview-wrapper .dynamic-dialog textarea,\n.form-browser-preview-wrapper .dynamic-dialog select {\n color: var(--fg-main-color);\n}\n\n.form-browser-form-empty {\n height: 100%;\n display: flex;\n align-items: center;\n justify-content: center;\n color: var(--fg-placeholder-color);\n font-style: italic;\n}\n\n.form-browser-form-empty p {\n margin: 0;\n font-size: 1.1rem;\n}\n\n" }, { "path": "dwertheimer.Forms/src/components/FormBrowserView.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FormBrowserView Component\n// Browse and select template forms with a resizable two-column layout\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, useRef, useMemo, useCallback, type Node } from 'react'\nimport { createPortal, flushSync } from 'react-dom'\nimport { PanelGroup, Panel, PanelResizeHandle } from 'react-resizable-panels'\nimport { AppProvider } from './AppContext.jsx'\nimport { FormPreview } from './FormPreview.jsx'\nimport { SpaceChooser as SpaceChooserComponent } from '@helpers/react/DynamicDialog/SpaceChooser'\nimport DynamicDialog from '@helpers/react/DynamicDialog/DynamicDialog'\nimport { type TSettingItem } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\nimport { logDebug, logError } from '@helpers/react/reactDev.js'\nimport { pluginEnvelopeFromResponsePayload, unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\nimport './FormBrowserView.css'\nimport './FormView.css' // Import FormView.css for form-submitting-overlay styles\n\ntype FormTemplate = {\n label: string,\n value: string,\n filename: string,\n spaceId?: string, // Empty string for Private, teamspace ID for teamspaces\n spaceTitle?: string, // \"Private\" or teamspace title\n}\n\ntype FormBrowserViewProps = {\n data: any,\n dispatch: Function,\n reactSettings: any,\n setReactSettings: Function,\n onSubmitOrCancelCallFunctionNamed: string,\n}\n\n/**\n * FormBrowserView Component\n * Displays a list of template forms in a resizable two-column layout\n * @param {FormBrowserViewProps} props\n * @returns {React$Node}\n */\nexport function FormBrowserView({\n data,\n dispatch,\n reactSettings,\n setReactSettings,\n onSubmitOrCancelCallFunctionNamed: _onSubmitOrCancelCallFunctionNamed,\n}: FormBrowserViewProps): Node {\n const { pluginData } = data\n\n // Map to store pending requests for request/response pattern\n // Key: correlationId, Value: { resolve, reject, timeoutId }\n const pendingRequestsRef = useRef void, reject: (error: Error) => void, timeoutId: any }>>(new Map())\n\n // Store windowId in a ref so requestFromPlugin doesn't need to depend on pluginData\n const windowIdRef = useRef(pluginData?.windowId || 'forms-chooser-window')\n\n // Update windowId ref when pluginData changes\n useEffect(() => {\n windowIdRef.current = pluginData?.windowId || 'forms-chooser-window'\n }, [pluginData?.windowId])\n\n // Listen for RESPONSE messages from Root and resolve pending requests\n useEffect(() => {\n const handleResponse = (event: MessageEvent) => {\n const { data: eventData } = event\n // $FlowFixMe[incompatible-type] - eventData can be various types\n if (eventData && typeof eventData === 'object' && eventData.type === 'RESPONSE' && eventData.payload) {\n // $FlowFixMe[prop-missing] - payload structure is validated above\n const payload = eventData.payload\n // $FlowFixMe[prop-missing] - payload structure is validated above\n if (payload && typeof payload === 'object') {\n const correlationId = (payload: any).correlationId\n const success = (payload: any).success\n logDebug('FormBrowserView', `handleResponse: Received RESPONSE with correlationId=\"${String(correlationId || '')}\", success=${String(success || false)}`)\n if (correlationId && typeof correlationId === 'string') {\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n pendingRequestsRef.current.delete(correlationId)\n clearTimeout(pending.timeoutId)\n logDebug('FormBrowserView', `handleResponse: Resolving request for correlationId=\"${correlationId}\", success=${String(success || false)}`)\n pending.resolve(pluginEnvelopeFromResponsePayload(payload))\n } else {\n logDebug('FormBrowserView', `handleResponse: No pending request found for correlationId=\"${correlationId}\"`)\n }\n }\n }\n }\n }\n\n window.addEventListener('message', handleResponse)\n return () => {\n window.removeEventListener('message', handleResponse)\n // Clean up any pending requests on unmount\n pendingRequestsRef.current.forEach((pending) => {\n clearTimeout(pending.timeoutId)\n })\n pendingRequestsRef.current.clear()\n }\n }, [])\n\n /**\n * Request data from the plugin using request/response pattern\n *\n * RESPONSE PATTERN:\n * - Handler returns: { success: boolean, data?: any, message?: string }\n * - Router sends RESPONSE: { correlationId, success, data, error }\n * - handleResponse extracts payload.data and resolves promise with just the data\n * - So this function resolves with result.data (the actual data array/object, not the wrapper)\n *\n * Returns a Promise that resolves with the response data or rejects with an error\n * Memoized with useCallback to prevent recreation on every render\n * @param {string} command - The command/request type (e.g., 'getFormTemplates', 'getFormFields')\n * @param {any} dataToSend - Request parameters\n * @param {number} timeout - Timeout in milliseconds (default: 10000)\n * @returns {Promise} - Resolves with the data from handler (result.data), not the full response object\n */\n const requestFromPlugin = useCallback(\n (command: string, dataToSend: any = {}, timeout: number = 10000): Promise => {\n if (!command) throw new Error('requestFromPlugin: command must be called with a string')\n\n const correlationId = `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n\n return new Promise((resolve, reject) => {\n const timeoutId = setTimeout(() => {\n if (pendingRequestsRef.current.has(correlationId)) {\n pendingRequestsRef.current.delete(correlationId)\n reject(new Error(`Request timeout after ${timeout}ms: ${command}`))\n }\n }, timeout)\n\n pendingRequestsRef.current.set(correlationId, { resolve, reject, timeoutId })\n\n // Send request with correlation ID and request type marker\n const requestData = {\n ...dataToSend,\n __correlationId: correlationId,\n __requestType: 'REQUEST',\n __windowId: windowIdRef.current,\n }\n\n logDebug('FormBrowserView', `requestFromPlugin: Sending request \"${command}\" with correlationId=\"${correlationId}\", windowId=\"${String(windowIdRef.current || '')}\"`)\n dispatch('SEND_TO_PLUGIN', [command, requestData], `FormBrowserView: requestFromPlugin: ${String(command)}`)\n })\n },\n [dispatch],\n ) // Only depend on dispatch, which should be stable from useReducer\n\n const sendActionToPlugin = (command: string, dataToSend: any) => {\n logDebug('FormBrowserView', `sendActionToPlugin: command=\"${command}\"`)\n dispatch('SEND_TO_PLUGIN', [command, dataToSend], `FormBrowserView: ${command}`)\n }\n\n // State\n const [selectedSpace, setSelectedSpace] = useState('__all__') // '__all__' = show all spaces (default)\n const [filterText, setFilterText] = useState('')\n const [templates, setTemplates] = useState>([])\n const [selectedTemplate, setSelectedTemplate] = useState(null)\n const [formFields, setFormFields] = useState>([])\n const [frontmatter, setFrontmatter] = useState<{ [key: string]: any }>({})\n const [folders, setFolders] = useState>([])\n const [notes, setNotes] = useState>([])\n const [loading, setLoading] = useState(false)\n const [selectedIndex, setSelectedIndex] = useState(-1)\n const formPreviewRef = useRef(null)\n // Ref to track if we're programmatically updating selection (to prevent useEffect from firing)\n const isUpdatingSelectionRef = useRef(false)\n // Create form dialog state\n const [showCreateFormDialog, setShowCreateFormDialog] = useState(false)\n const [createFormDialogData, setCreateFormDialogData] = useState<{ formName?: string, space?: string }>({})\n\n // Refs\n const filterInputRef = useRef(null)\n const listRef = useRef(null)\n\n /**\n * Load template forms from the plugin\n */\n const loadTemplates = useCallback(async () => {\n try {\n setLoading(true)\n const responseData = unwrapPluginRequestData(\n await requestFromPlugin('getFormTemplates', {\n space: selectedSpace || '__all__', // Default to showing all spaces if not set\n }),\n )\n if (Array.isArray(responseData)) {\n setTemplates(responseData)\n logDebug('FormBrowserView', `Loaded ${responseData.length} templates`)\n } else {\n logError('FormBrowserView', `Failed to load templates: Expected array but got ${typeof responseData}`)\n setTemplates([])\n }\n } catch (error) {\n logError('FormBrowserView', `Error loading templates: ${error.message}`)\n setTemplates([])\n } finally {\n setLoading(false)\n }\n }, [requestFromPlugin, selectedSpace])\n\n /**\n * Load form fields for the selected template\n */\n const loadFormFields = useCallback(\n async (template: FormTemplate) => {\n try {\n setLoading(true)\n const responseData = unwrapPluginRequestData(\n await requestFromPlugin('getFormFields', {\n templateFilename: template.filename,\n templateTitle: template.label,\n windowId: windowIdRef.current || '',\n }),\n )\n if (responseData && typeof responseData === 'object' && Array.isArray(responseData.formFields)) {\n setFormFields(responseData.formFields)\n setFrontmatter(responseData.frontmatter || {})\n logDebug('FormBrowserView', `Loaded ${responseData.formFields.length} form fields for template \"${template.label}\"`)\n\n // Load folders and notes if needed (check if form has folder-chooser or note-chooser fields)\n const needsFolders = responseData.formFields.some((field: TSettingItem) => field.type === 'folder-chooser')\n const needsNotes = responseData.formFields.some((field: TSettingItem) => field.type === 'note-chooser')\n\n if (needsFolders) {\n try {\n // Pass space: null to get all folders from all spaces (FolderChooser will filter client-side based on spaceFilter prop)\n const foldersData = unwrapPluginRequestData(await requestFromPlugin('getFolders', { excludeTrash: true, space: null }))\n if (Array.isArray(foldersData)) {\n setFolders(foldersData)\n }\n } catch (error) {\n logError('FormBrowserView', `Error loading folders: ${error.message}`)\n }\n }\n\n if (needsNotes) {\n try {\n const notesData = unwrapPluginRequestData(await requestFromPlugin('getNotes', { includeCalendarNotes: false }))\n if (Array.isArray(notesData)) {\n setNotes(notesData)\n }\n } catch (error) {\n logError('FormBrowserView', `Error loading notes: ${error.message}`)\n }\n }\n } else {\n logError('FormBrowserView', `Failed to load form fields: Invalid response data`)\n setFormFields([])\n setFrontmatter({})\n }\n } catch (error) {\n logError('FormBrowserView', `Error loading form fields: ${error.message}`)\n setFormFields([])\n setFrontmatter({})\n } finally {\n setLoading(false)\n }\n },\n [requestFromPlugin],\n )\n\n // Load templates when space changes\n useEffect(() => {\n loadTemplates()\n }, [loadTemplates])\n\n // Load form fields when template is selected\n useEffect(() => {\n if (selectedTemplate) {\n loadFormFields(selectedTemplate)\n } else {\n setFormFields([])\n }\n }, [selectedTemplate, loadFormFields])\n\n // Focus filter input on mount\n useEffect(() => {\n if (filterInputRef.current) {\n filterInputRef.current.focus()\n }\n }, [])\n\n // Filter templates based on filter text (case-insensitive)\n const filteredTemplates = useMemo(() => {\n if (!filterText.trim()) {\n return templates\n }\n const searchTerm = filterText.toLowerCase()\n return templates.filter((template) => template.label.toLowerCase().includes(searchTerm))\n }, [templates, filterText])\n\n // Handle template selection\n const handleTemplateSelect = useCallback(\n (template: FormTemplate) => {\n logDebug('FormBrowserView', `handleTemplateSelect: selecting template \"${template.label}\"`)\n // Set flag to prevent useEffect from firing during this update\n isUpdatingSelectionRef.current = true\n\n // Update selectedIndex to match the selected template FIRST, before updating selectedTemplate\n // This ensures they're in sync when the useEffect fires\n const index = filteredTemplates.findIndex((t) => t.value === template.value)\n if (index >= 0) {\n logDebug('FormBrowserView', `handleTemplateSelect: found template at index ${index}, updating both selectedIndex and selectedTemplate`)\n // Update both in the same render cycle\n setSelectedIndex(index)\n setSelectedTemplate(template)\n } else {\n logDebug('FormBrowserView', `handleTemplateSelect: template not found in filteredTemplates (length=${filteredTemplates.length}), searching in full templates list`)\n // If not found in filtered list, try the full templates list\n const fullIndex = templates.findIndex((t) => t.value === template.value)\n if (fullIndex >= 0) {\n logDebug('FormBrowserView', `handleTemplateSelect: found template at index ${fullIndex} in full templates list, but not in filtered list - template may be filtered out`)\n }\n // Still set the template even if index not found (user might have filtered it out)\n setSelectedTemplate(template)\n // Reset selectedIndex to -1 if template not in filtered list (so useEffect doesn't try to select wrong template)\n setSelectedIndex(-1)\n }\n\n // Reset flag after state updates (use setTimeout to ensure state updates are processed)\n // Use requestAnimationFrame to ensure React has processed the state updates\n requestAnimationFrame(() => {\n setTimeout(() => {\n isUpdatingSelectionRef.current = false\n logDebug('FormBrowserView', `handleTemplateSelect: reset isUpdatingSelectionRef flag`)\n }, 50) // Small delay to ensure state updates complete\n })\n },\n [filteredTemplates, templates],\n )\n\n // Auto-select template when selectedIndex changes (for arrow navigation)\n useEffect(() => {\n // Skip if we're in the middle of programmatically updating selection\n if (isUpdatingSelectionRef.current) {\n logDebug('FormBrowserView', `useEffect selectedIndex: skipping because isUpdatingSelectionRef.current is true`)\n return\n }\n logDebug(\n 'FormBrowserView',\n `useEffect selectedIndex: selectedIndex=${selectedIndex}, filteredTemplates.length=${filteredTemplates.length}, current selectedTemplate=${\n selectedTemplate?.label || 'null'\n }`,\n )\n if (selectedIndex >= 0 && selectedIndex < filteredTemplates.length) {\n const template = filteredTemplates[selectedIndex]\n logDebug(\n 'FormBrowserView',\n `useEffect selectedIndex: template at index ${selectedIndex} is \"${template.label}\", current selectedTemplate=${selectedTemplate?.label || 'null'}`,\n )\n if (template) {\n // Check if the template at selectedIndex already matches selectedTemplate\n // If so, don't call handleTemplateSelect again (prevents duplicate requests)\n if (template.value === selectedTemplate?.value) {\n logDebug('FormBrowserView', `useEffect selectedIndex: template at index ${selectedIndex} already matches selectedTemplate, skipping handleTemplateSelect`)\n // Even if same template, make sure form fields are loaded (in case they weren't before)\n if (selectedTemplate && formFields.length === 0) {\n logDebug('FormBrowserView', `useEffect selectedIndex: formFields empty, triggering loadFormFields`)\n loadFormFields(selectedTemplate)\n }\n return\n }\n // Only call handleTemplateSelect if the template is different\n logDebug('FormBrowserView', `useEffect selectedIndex: calling handleTemplateSelect for \"${template.label}\" (different template)`)\n handleTemplateSelect(template)\n }\n } else {\n logDebug('FormBrowserView', `useEffect selectedIndex: selectedIndex out of range (${selectedIndex}) or no templates`)\n }\n }, [selectedIndex, filteredTemplates, selectedTemplate, handleTemplateSelect, formFields.length, loadFormFields])\n\n // Handle keyboard navigation\n const handleKeyDown = useCallback(\n (e: KeyboardEvent) => {\n logDebug(\n 'FormBrowserView',\n `handleKeyDown: key=\"${e.key}\", selectedIndex=${selectedIndex}, filteredTemplates.length=${filteredTemplates.length}, selectedTemplate=${\n selectedTemplate?.label || 'null'\n }`,\n )\n\n if (e.key === 'ArrowDown') {\n e.preventDefault()\n logDebug('FormBrowserView', `handleKeyDown ArrowDown: current selectedIndex=${selectedIndex}, max=${filteredTemplates.length - 1}`)\n // If selectedIndex is -1, start at 0, otherwise increment\n const newIndex = selectedIndex < 0 ? 0 : selectedIndex + 1\n if (newIndex < filteredTemplates.length) {\n logDebug('FormBrowserView', `handleKeyDown ArrowDown: setting selectedIndex to ${newIndex}`)\n setSelectedIndex(newIndex)\n // Scroll into view\n setTimeout(() => {\n if (listRef.current) {\n const item = listRef.current.querySelector(`[data-index=\"${newIndex}\"]`)\n if (item) {\n logDebug('FormBrowserView', `handleKeyDown ArrowDown: scrolling item into view`)\n item.scrollIntoView({ block: 'nearest', behavior: 'smooth' })\n // Also focus the item for better keyboard navigation\n // @ts-ignore\n item.focus()\n } else {\n logDebug('FormBrowserView', `handleKeyDown ArrowDown: could not find item with data-index=\"${newIndex}\"`)\n }\n } else {\n logDebug('FormBrowserView', `handleKeyDown ArrowDown: listRef.current is null`)\n }\n }, 0)\n } else {\n logDebug('FormBrowserView', `handleKeyDown ArrowDown: already at last item (${selectedIndex}), not moving`)\n }\n } else if (e.key === 'ArrowUp') {\n e.preventDefault()\n logDebug('FormBrowserView', `handleKeyDown ArrowUp: current selectedIndex=${selectedIndex}`)\n if (selectedIndex > 0) {\n const newIndex = selectedIndex - 1\n logDebug('FormBrowserView', `handleKeyDown ArrowUp: setting selectedIndex to ${newIndex}`)\n setSelectedIndex(newIndex)\n // Scroll into view\n setTimeout(() => {\n if (listRef.current) {\n const item = listRef.current.querySelector(`[data-index=\"${newIndex}\"]`)\n if (item) {\n logDebug('FormBrowserView', `handleKeyDown ArrowUp: scrolling item into view`)\n item.scrollIntoView({ block: 'nearest', behavior: 'smooth' })\n // Also focus the item for better keyboard navigation\n // @ts-ignore\n item.focus()\n } else {\n logDebug('FormBrowserView', `handleKeyDown ArrowUp: could not find item with data-index=\"${newIndex}\"`)\n }\n } else {\n logDebug('FormBrowserView', `handleKeyDown ArrowUp: listRef.current is null`)\n }\n }, 0)\n } else {\n logDebug('FormBrowserView', `handleKeyDown ArrowUp: already at first item (${selectedIndex}), not moving`)\n }\n } else if (e.key === 'Enter' && selectedIndex >= 0 && selectedIndex < filteredTemplates.length) {\n e.preventDefault()\n logDebug('FormBrowserView', `handleKeyDown Enter: selecting template at index ${selectedIndex}`)\n handleTemplateSelect(filteredTemplates[selectedIndex])\n } else if (e.key === 'Tab' && selectedIndex >= 0 && selectedIndex < filteredTemplates.length && selectedTemplate) {\n // TAB from focused list item should focus first form field\n e.preventDefault()\n logDebug('FormBrowserView', `handleKeyDown Tab: attempting to focus first form field, formPreviewRef.current=${formPreviewRef.current ? 'exists' : 'null'}`)\n // Focus the first input field in the form preview\n if (formPreviewRef.current) {\n const firstInput = formPreviewRef.current.querySelector('input:not([type=\"hidden\"]), textarea, select, button:not(.cancel-button):not(.save-button)')\n if (firstInput instanceof HTMLElement) {\n logDebug('FormBrowserView', `handleKeyDown Tab: found first input, focusing it`)\n firstInput.focus()\n } else {\n logDebug('FormBrowserView', `handleKeyDown Tab: no input field found in form preview`)\n }\n } else {\n logDebug('FormBrowserView', `handleKeyDown Tab: formPreviewRef.current is null`)\n }\n } else {\n logDebug('FormBrowserView', `handleKeyDown: unhandled key=\"${e.key}\"`)\n }\n },\n [selectedIndex, filteredTemplates, selectedTemplate, handleTemplateSelect],\n )\n\n // Handle filter input keydown\n const handleFilterKeyDown = useCallback(\n (e: SyntheticKeyboardEvent) => {\n logDebug('FormBrowserView', `handleFilterKeyDown: key=\"${e.key}\", filteredTemplates.length=${filteredTemplates.length}`)\n\n if (e.key === 'ArrowDown' && filteredTemplates.length > 0) {\n e.preventDefault()\n logDebug('FormBrowserView', `handleFilterKeyDown ArrowDown: setting selectedIndex to 0 and focusing first item`)\n setSelectedIndex(0)\n // Focus the list with setTimeout to ensure DOM is updated\n setTimeout(() => {\n if (listRef.current) {\n const firstItem = listRef.current.querySelector('[data-index=\"0\"]')\n if (firstItem) {\n logDebug('FormBrowserView', `handleFilterKeyDown ArrowDown: found first item, focusing it`)\n // @ts-ignore\n firstItem.focus()\n } else {\n logDebug('FormBrowserView', `handleFilterKeyDown ArrowDown: could not find first item`)\n }\n } else {\n logDebug('FormBrowserView', `handleFilterKeyDown ArrowDown: listRef.current is null`)\n }\n }, 0)\n } else if (e.key === 'Tab' && !e.shiftKey && filteredTemplates.length > 0) {\n // TAB from filter should focus first list item\n e.preventDefault()\n logDebug('FormBrowserView', `handleFilterKeyDown Tab: focusing first list item`)\n setSelectedIndex(0)\n setTimeout(() => {\n if (listRef.current) {\n const firstItem = listRef.current.querySelector('[data-index=\"0\"]')\n if (firstItem) {\n logDebug('FormBrowserView', `handleFilterKeyDown Tab: found first item, focusing it`)\n // @ts-ignore\n firstItem.focus()\n } else {\n logDebug('FormBrowserView', `handleFilterKeyDown Tab: could not find first item`)\n }\n } else {\n logDebug('FormBrowserView', `handleFilterKeyDown Tab: listRef.current is null`)\n }\n }, 0)\n } else {\n logDebug('FormBrowserView', `handleFilterKeyDown: passing to handleKeyDown, key=\"${e.key}\"`)\n handleKeyDown(e.nativeEvent)\n }\n },\n [filteredTemplates.length, handleKeyDown],\n )\n\n // Handle form cancel\n const handleCancel = useCallback(() => {\n setSelectedTemplate(null)\n setFormFields([])\n }, [])\n\n // Track submission state for overlay\n const [isSubmitting, setIsSubmitting] = useState(false)\n const overlayShownAtRef = useRef(0)\n\n // Handle form submit\n const handleSave = useCallback(\n (formValues: Object, windowId?: string) => {\n logDebug('FormBrowserView', 'Form submitted:', formValues)\n\n // Clear any previous errors before submitting\n dispatch('UPDATE_DATA', {\n ...data,\n pluginData: {\n ...pluginData,\n formSubmissionError: '',\n aiAnalysisResult: '',\n },\n })\n\n // Force overlay into the DOM before starting the request (flushSync ensures React commits\n // synchronously; in WebView rAF timing can prevent the overlay from ever painting).\n flushSync(() => {\n setIsSubmitting(true)\n overlayShownAtRef.current = Date.now()\n })\n\n const hideOverlay = () => {\n const MIN_OVERLAY_MS = 400\n const elapsed = Date.now() - overlayShownAtRef.current\n if (elapsed < MIN_OVERLAY_MS) {\n setTimeout(() => setIsSubmitting(false), MIN_OVERLAY_MS - elapsed)\n } else {\n setIsSubmitting(false)\n }\n }\n\n if (!requestFromPlugin) {\n setIsSubmitting(false)\n return\n }\n requestFromPlugin(\n 'submitForm',\n {\n keepOpenOnSubmit: true, // Tell plugin not to close the window\n templateFilename: selectedTemplate?.filename,\n formValues,\n windowId,\n },\n 30000,\n ) // Use 30s timeout like FormView\n .then((envelope: any) => {\n logDebug('FormBrowserView', 'Form submission response:', envelope)\n\n hideOverlay()\n\n if (!envelope.success) {\n const payloadData = envelope.data && typeof envelope.data === 'object' ? envelope.data : {}\n const formError = payloadData.formSubmissionError\n const aiError = payloadData.aiAnalysisResult\n let errorMessage = envelope.message || 'Form submission failed.'\n if (formError) {\n errorMessage = formError\n } else if (aiError) {\n const aiMsg = aiError\n const firstLine = aiMsg.split('\\n')[0] || aiMsg.substring(0, 200)\n errorMessage = `Template error: ${firstLine}`\n }\n logError('FormBrowserView', `Form submission failed: ${errorMessage}`)\n dispatch('UPDATE_DATA', {\n ...data,\n pluginData: {\n ...pluginData,\n formSubmissionError: formError || errorMessage,\n aiAnalysisResult: aiError || '',\n },\n })\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: errorMessage,\n timeout: 10000,\n })\n return\n }\n\n const responseData = envelope.data || {}\n\n dispatch('UPDATE_DATA', {\n ...data,\n pluginData: {\n ...pluginData,\n formSubmissionError: '',\n aiAnalysisResult: '',\n },\n })\n\n let successMessage = envelope.message || 'Your form has been submitted successfully.'\n if (responseData && typeof responseData === 'object' && responseData.noteTitle) {\n const action = responseData.processingMethod === 'create-new' ? 'created' : 'updated'\n successMessage = `Form submitted successfully. Note \"${responseData.noteTitle}\" has been ${action}.`\n\n setTimeout(() => {\n if (requestFromPlugin) {\n requestFromPlugin('openNote', {\n noteTitle: responseData.noteTitle,\n }).then((openEnvelope: any) => {\n if (!openEnvelope.success) {\n logError('FormBrowserView', `Error opening note: ${openEnvelope.message || 'Request failed'}`)\n }\n })\n }\n }, 500)\n }\n\n dispatch('SHOW_TOAST', {\n type: 'SUCCESS',\n msg: successMessage,\n timeout: 5000,\n })\n\n handleCancel()\n })\n .catch((error) => {\n logError('FormBrowserView', `Error submitting form: ${error.message}`)\n\n // Hide submitting overlay on error (with minimum display time)\n hideOverlay()\n\n // On error, show Toast notification but don't close the window\n // The window should stay open so user can fix and retry\n const errorMessage = error.message || 'An error occurred while submitting the form'\n\n // Update pluginData with error so FormErrorBanner can display it\n dispatch('UPDATE_DATA', {\n ...data,\n pluginData: {\n ...pluginData,\n formSubmissionError: errorMessage,\n },\n })\n\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: errorMessage,\n timeout: 10000, // Longer timeout for error messages\n })\n // Don't reset form on error - let user see what they entered\n })\n },\n [selectedTemplate, requestFromPlugin, handleCancel, dispatch, data, pluginData],\n )\n\n // Handle new form button - show dialog\n const handleNewForm = useCallback(() => {\n // Pass through the currently selected space filter as the default for the new form dialog\n setCreateFormDialogData({ formName: '', space: selectedSpace || '' })\n setShowCreateFormDialog(true)\n }, [selectedSpace])\n\n // Handle creating form from dialog\n const handleCreateFormDialogSave = useCallback(\n async (formValues: { [key: string]: any }) => {\n const formName = formValues.formName?.trim() || ''\n const spaceId = formValues.space || ''\n\n if (!formName) {\n logError('FormBrowserView', 'Form name is required')\n return\n }\n\n if (!requestFromPlugin) {\n logError('FormBrowserView', 'requestFromPlugin is not available')\n return\n }\n\n try {\n logDebug('FormBrowserView', `Creating new form: name=\"${formName}\", space=\"${spaceId || 'Private'}\"`)\n const envelope = await requestFromPlugin('createNewForm', {\n formName,\n space: spaceId,\n })\n\n if (envelope.success && envelope.data && typeof envelope.data === 'object' && envelope.data.templateFilename) {\n await loadTemplates()\n setShowCreateFormDialog(false)\n setCreateFormDialogData({})\n logDebug('FormBrowserView', `Form \"${formName}\" created successfully`)\n } else {\n logError('FormBrowserView', `Failed to create form: ${envelope.message || JSON.stringify(envelope)}`)\n }\n } catch (error) {\n logError('FormBrowserView', `Error creating new form: ${error.message}`)\n }\n },\n [requestFromPlugin, loadTemplates],\n )\n\n const handleCreateFormDialogCancel = useCallback(() => {\n setShowCreateFormDialog(false)\n setCreateFormDialogData({})\n }, [])\n\n // Handle edit form button\n const handleEditForm = useCallback(\n (template: FormTemplate, e: any) => {\n e.stopPropagation() // Prevent triggering template selection\n if (requestFromPlugin) {\n // Open FormBuilder with the template title\n // The receivingTemplateTitle will be read from the note's frontmatter by openFormBuilder\n requestFromPlugin('openFormBuilder', {\n templateTitle: template.label,\n }).catch((error) => {\n logError('FormBrowserView', `Error opening form builder: ${error.message}`)\n })\n }\n },\n [requestFromPlugin],\n )\n\n return (\n {\n const newFullData = { ...data, pluginData: newData }\n dispatch('UPDATE_DATA', newFullData)\n }}\n reactSettings={reactSettings}\n setReactSettings={setReactSettings}\n >\n
\n {/* Header - only show if floating window */}\n {pluginData?.showFloating && (\n
\n

Form Browser

\n
\n )}\n\n {/* Content with resizable columns */}\n
\n \n {/* Left Panel: Template List */}\n \n
\n {/* Controls in left column */}\n
\n
\n {\n setSelectedSpace(spaceId)\n setSelectedTemplate(null) // Clear selection when space changes\n setFilterText('') // Clear filter when space changes\n }}\n placeholder=\"Select space (Private or Teamspace)\"\n compactDisplay={true}\n requestFromPlugin={requestFromPlugin}\n showValue={false}\n includeAllOption={true}\n shortDescriptionOnLine2={true}\n />\n
\n
\n
\n {\n setFilterText(e.target.value)\n setSelectedIndex(-1) // Reset selection when filter changes\n }}\n onKeyDown={handleFilterKeyDown}\n />\n
\n \n
\n
\n
\n

Template Forms ({filteredTemplates.length})

\n
\n
\n {loading && templates.length === 0 ? (\n
Loading...
\n ) : filteredTemplates.length === 0 ? (\n
{filterText ? 'No forms match your filter' : 'No forms found'}
\n ) : (\n filteredTemplates.map((template, index) => (\n handleTemplateSelect(template)}\n onKeyDown={(e) => {\n logDebug('FormBrowserView', `list-item onKeyDown: key=\"${e.key}\", index=${index}, template=\"${template.label}\", shiftKey=${e.shiftKey}`)\n if (e.key === 'Enter') {\n e.preventDefault()\n logDebug('FormBrowserView', `list-item Enter: selecting template \"${template.label}\"`)\n handleTemplateSelect(template)\n } else if (e.key === 'Tab' && !e.shiftKey && selectedTemplate) {\n // TAB from list item should focus first form field\n e.preventDefault()\n logDebug('FormBrowserView', `list-item Tab: attempting to focus first form field, formPreviewRef.current=${formPreviewRef.current ? 'exists' : 'null'}`)\n // Use setTimeout to ensure the form is rendered\n setTimeout(() => {\n const previewRef = formPreviewRef.current\n if (previewRef) {\n // Try to find first focusable input (skip hidden, readonly, disabled)\n const firstInput = previewRef.querySelector(\n 'input:not([type=\"hidden\"]):not([readonly]):not([disabled]), textarea:not([readonly]):not([disabled]), select:not([disabled]), button:not(.cancel-button):not(.save-button):not([disabled])',\n )\n if (firstInput instanceof HTMLElement) {\n logDebug('FormBrowserView', `list-item Tab: found first input (${firstInput.tagName}), focusing it`)\n firstInput.focus()\n } else {\n logDebug('FormBrowserView', `list-item Tab: no focusable input found, trying broader search`)\n // Try a broader search (include readonly/disabled)\n const anyInput = previewRef.querySelector('input:not([type=\"hidden\"]), textarea, select, button:not(.cancel-button):not(.save-button)')\n if (anyInput instanceof HTMLElement) {\n logDebug('FormBrowserView', `list-item Tab: found input with broader search (${anyInput.tagName}), focusing it`)\n anyInput.focus()\n } else {\n logDebug('FormBrowserView', `list-item Tab: no input field found at all in form preview`)\n }\n }\n } else {\n logDebug('FormBrowserView', `list-item Tab: formPreviewRef.current is null`)\n }\n }, 100)\n }\n }}\n tabIndex={0}\n >\n
\n {template.label}\n {selectedSpace === '__all__' && template.spaceTitle && {template.spaceTitle}}\n
\n
e.stopPropagation()}>\n \n
\n
\n ))\n )}\n
\n
\n \n\n \n\n {/* Right Panel: Form Preview */}\n \n
\n {selectedTemplate && formFields.length > 0 ? (\n
\n
\n \n
\n
\n ) : (\n
\n

Select a form from the list to preview and fill it out

\n
\n )}\n
\n \n \n
\n \n \n {/* Submitting overlay - rendered via portal to document.body to appear above everything */}\n {isSubmitting && typeof document !== 'undefined' && document.body\n ? createPortal(\n
\n
\n
Submitting Form...
\n
\n
,\n document.body,\n )\n : null}\n \n )\n}\n\nexport default FormBrowserView\n" }, { "path": "dwertheimer.Forms/src/components/FormBuilder.css", "content": ".form-builder-container {\n display: flex;\n flex-direction: column;\n height: 100vh;\n width: 100%;\n background: var(--bg-main-color, #eff1f5);\n color: var(--fg-main-color, #4c4f69);\n}\n\n.form-builder-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding: 1rem 1.5rem;\n border-bottom: 1px solid var(--divider-color, #CDCFD0);\n background: var(--bg-alt-color, #e6e9ef);\n position: sticky;\n top: 0;\n z-index: 100;\n}\n\n.form-builder-title-section {\n display: flex;\n flex-direction: column;\n gap: 0.25rem;\n flex: 1;\n}\n\n.form-builder-document-name {\n font-size: 0.875rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n cursor: pointer;\n user-select: none;\n}\n\n.form-builder-document-name:hover {\n color: var(--tint-color, #dc8a78);\n text-decoration: underline;\n}\n\n.form-builder-title {\n margin: 0;\n font-size: 1.5rem;\n font-weight: 600;\n}\n\n.unsaved-changes-message {\n font-size: 0.875rem;\n color: var(--fg-warn-color, color-mix(in oklch, var(--fg-main-color), orange 20%));\n font-weight: 500;\n display: flex;\n align-items: center;\n gap: 0.25rem;\n}\n\n.save-message {\n font-size: 0.875rem;\n font-weight: 500;\n display: flex;\n align-items: center;\n gap: 0.25rem;\n padding: 0.25rem 0.5rem;\n border-radius: 4px;\n margin-left: 0.5rem;\n}\n\n.save-message-success {\n color: var(--fg-ok-color, color-mix(in oklch, var(--fg-main-color), green 20%));\n background-color: var(--bg-ok-color, color-mix(in oklch, var(--bg-main-color), green 20%));\n}\n\n.save-message-error {\n color: var(--fg-error-color, color-mix(in oklch, var(--fg-main-color), red 20%));\n background-color: var(--bg-error-color, color-mix(in oklch, var(--bg-main-color), red 20%));\n}\n\n.form-builder-actions {\n display: flex;\n gap: 0.5rem;\n align-items: center;\n}\n\n.form-builder-actions .PCButton {\n padding-top: calc(4px + 2px) !important; /* Add 2px to default PCButton padding-top of 4px */\n}\n\n.form-builder-content {\n display: flex;\n flex: 1;\n overflow: hidden;\n}\n\n.form-builder-panels {\n width: 100%;\n height: 100%;\n display: flex;\n}\n\n/* Ensure Panel components fill their container */\n.form-builder-panels > [data-panel-id] {\n height: 100%;\n overflow: hidden;\n}\n\n.form-builder-sidebar {\n height: 100%;\n padding: 0;\n border-right: 1px solid var(--divider-color, #CDCFD0);\n background: var(--bg-alt-color, #e6e9ef);\n overflow-y: auto;\n display: flex;\n flex-direction: column;\n}\n\n.sidebar-section {\n display: flex;\n flex-direction: column;\n}\n\n.sidebar-section:last-child {\n margin-bottom: 0;\n}\n\n.frontmatter-editor {\n display: flex;\n flex-direction: column;\n gap: 1rem;\n padding: 1rem;\n}\n\n.frontmatter-field {\n display: flex;\n flex-direction: column;\n}\n\n.frontmatter-field label {\n font-weight: 600;\n font-size: 0.9rem;\n margin-bottom: 0.25rem;\n}\n\n.frontmatter-field input[type='text'] {\n padding: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n font-size: 0.9rem;\n background: var(--bg-apple-input-color, #fbfbfb);\n color: var(--fg-main-color, #4c4f69);\n}\n\n.frontmatter-field input[type='checkbox'] {\n margin-right: 0.5rem;\n}\n\n.add-field-button {\n width: 100%;\n padding: 0.75rem;\n font-size: 1rem;\n}\n\n.field-type-selector {\n display: flex;\n flex-direction: column;\n gap: 1rem;\n}\n\n.field-type-list {\n display: flex;\n flex-direction: column;\n gap: 0.5rem;\n overflow-y: auto;\n flex: 1;\n min-height: 0;\n}\n\n.field-type-option {\n padding: 0.75rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n cursor: pointer;\n background: var(--bg-main-color, #eff1f5);\n transition: all 0.2s;\n}\n\n.field-type-option:hover {\n background: var(--bg-mid-color, #ebedf2);\n border-color: var(--tint-color, #dc8a78);\n}\n\n.field-type-no-results {\n padding: 2rem;\n text-align: center;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n font-style: italic;\n}\n\n.field-type-label {\n font-weight: 600;\n margin-bottom: 0.25rem;\n color: var(--fg-main-color, #4c4f69);\n}\n\n.field-type-description {\n font-size: 0.85rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n}\n\n.form-builder-main {\n height: 100%;\n display: flex;\n flex-direction: column;\n overflow: hidden;\n}\n\n.form-builder-editor {\n flex: 1;\n display: flex;\n flex-direction: column;\n overflow: hidden;\n border-right: 1px solid var(--divider-color, #CDCFD0);\n}\n\n.form-section-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding: 0 1rem;\n margin: 0;\n border-bottom: 1px solid var(--divider-color, #CDCFD0);\n background: var(--bg-alt-color, #e6e9ef);\n height: 48px;\n box-sizing: border-box;\n flex-shrink: 0;\n}\n\n.form-section-header h3 {\n margin: 0;\n font-size: 1.1rem;\n font-weight: 600;\n line-height: 1;\n}\n\n.add-field-button-small {\n padding: 0.375rem 0.75rem;\n font-size: 0.875rem;\n background: var(--tint-color, #dc8a78);\n color: var(--fg-main-color, #4c4f69);\n border: none;\n border-radius: 4px;\n cursor: pointer;\n font-weight: 500;\n transition: background 0.2s;\n line-height: 1;\n flex-shrink: 0;\n}\n\n.add-field-button-small:hover {\n background: color-mix(in oklch, var(--tint-color, #dc8a78), black 10%);\n}\n\n.form-fields-list {\n flex: 1;\n padding: 1rem;\n overflow-y: auto;\n}\n\n.form-builder-preview {\n height: 100%;\n display: flex;\n flex-direction: column;\n overflow: hidden;\n background: var(--bg-alt-color, #e6e9ef);\n}\n\n/* Resize handle styling */\n.form-builder-resize-handle {\n background-color: var(--divider-color, #CDCFD0);\n width: 4px;\n cursor: col-resize;\n transition: background-color 0.2s;\n}\n\n.form-builder-resize-handle:hover {\n background-color: color-mix(in oklch, var(--divider-color, #CDCFD0), black 20%);\n}\n\n.form-preview-container {\n flex: 1;\n padding: 1rem;\n overflow-y: auto;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: flex-start;\n position: relative;\n}\n\n.form-preview-scaled-disclaimer {\n position: sticky;\n top: 0;\n z-index: 10;\n background: var(--bg-mid-color, #ebedf2);\n color: var(--fg-main-color, #4c4f69);\n padding: 0.5rem 1rem;\n margin-bottom: 0.5rem;\n border-radius: 4px;\n font-size: 0.85rem;\n text-align: center;\n box-shadow: 0 2px 4px color-mix(in oklch, var(--bg-main-color), black 10%);\n width: 100%;\n max-width: 90%;\n box-sizing: border-box;\n}\n\n.form-preview-window {\n width: 100%;\n max-width: 800px; /* Default max-width, can be overridden by inline styles from frontmatter */\n background: var(--bg-main-color, #eff1f5);\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 8px;\n box-shadow: 0 4px 12px color-mix(in oklch, var(--bg-main-color, #eff1f5), black 15%);\n overflow: hidden;\n display: flex;\n flex-direction: column;\n /* Allow inline styles to override dimensions */\n min-width: 200px; /* Minimum width for usability */\n /* No min-height - respect the height from frontmatter exactly */\n}\n\n.form-preview-window-titlebar {\n background: var(--bg-alt-color, #e6e9ef);\n border-bottom: 1px solid var(--divider-color, #CDCFD0);\n padding: 0.75rem 1rem;\n display: flex;\n align-items: center;\n justify-content: center;\n flex-shrink: 0; /* Don't shrink the titlebar */\n}\n\n.form-preview-window-title {\n font-weight: 600;\n font-size: 0.95rem;\n color: var(--fg-main-color, #4c4f69);\n text-align: center;\n}\n\n.form-preview-window-content {\n flex: 1 1 0; /* Grow and shrink, but start from 0 */\n position: relative;\n overflow: auto;\n min-height: 0; /* Critical: allows flex child to shrink below content size */\n height: 100%; /* Ensure full height in flex container */\n}\n\n/* Warning message when preview is scaled - shown in Form Builder */\n.form-preview-scaled-warning {\n position: absolute;\n bottom: 2.5rem; /* Position above the dimensions display */\n left: 0.5rem;\n right: 0.5rem;\n background: var(--bg-warn-color, color-mix(in oklch, var(--bg-main-color), orange 20%));\n color: var(--fg-warn-color, color-mix(in oklch, var(--fg-main-color), orange 20%));\n padding: 0.75rem 1rem;\n border-radius: 4px;\n font-size: 0.85rem;\n border: 1px solid var(--fg-warn-color, color-mix(in oklch, var(--fg-main-color), orange 20%));\n z-index: 5;\n box-shadow: 0 2px 4px color-mix(in oklch, var(--bg-main-color), black 10%);\n}\n\n/* Dimension display at bottom right of preview container */\n.form-preview-dimensions {\n position: absolute;\n bottom: 0.5rem;\n right: 1.5rem;\n font-size: 0.75rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n display: flex;\n align-items: center;\n gap: 0.25rem;\n z-index: 5;\n pointer-events: none;\n}\n\n.form-preview-dimensions-text {\n pointer-events: none;\n}\n\n.form-preview-dimensions-link {\n pointer-events: auto;\n background: none;\n border: none;\n color: var(--tint-color, #dc8a78);\n cursor: pointer;\n text-decoration: underline;\n font-size: 0.75rem;\n padding: 0;\n margin: 0;\n font-family: inherit;\n}\n\n.form-preview-dimensions-link:hover {\n color: var(--tint-color, #dc8a78);\n opacity: 0.8;\n}\n\n/* Override DynamicDialog positioning when in preview pane */\n.form-preview-window-content .dynamic-dialog {\n position: relative !important;\n top: auto !important;\n left: auto !important;\n transform: none !important;\n width: 100% !important;\n min-width: 0 !important;\n max-width: 100% !important;\n height: 100% !important; /* Fill parent height */\n max-height: 100% !important; /* Constrain dialog to content area */\n box-shadow: none !important;\n border: none !important;\n border-radius: 0 !important;\n margin: 0 !important;\n display: flex !important;\n flex-direction: column !important;\n overflow: hidden !important; /* Prevent dialog from expanding */\n}\n\n.form-preview-window-content .dynamic-dialog .dynamic-dialog-content {\n width: 100% !important;\n max-width: 100% !important;\n overflow-y: auto !important; /* Allow scrolling within dialog content */\n flex: 1 1 0 !important; /* Allow content to shrink */\n min-height: 0 !important; /* Critical: allows flex child to shrink */\n}\n\n.empty-state {\n text-align: center;\n padding: 3rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n font-style: italic;\n}\n\n.form-field-item {\n display: flex;\n align-items: center;\n gap: 0.75rem;\n padding: 1rem;\n margin-bottom: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 6px;\n background: var(--bg-main-color, #eff1f5);\n cursor: move;\n transition: all 0.2s;\n}\n\n.form-field-item:hover {\n border-color: var(--tint-color, #dc8a78);\n box-shadow: 0 2px 4px color-mix(in oklch, var(--bg-main-color), black 10%);\n}\n\n.form-field-item.dragging {\n opacity: 0.5;\n}\n\n.form-field-item.editing {\n border-color: var(--tint-color, #dc8a78);\n border-width: 2px;\n background: var(--bg-mid-color, #ebedf2);\n}\n\n.field-handle {\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n cursor: grab;\n font-size: 1.2rem;\n padding: 0.25rem;\n}\n\n.field-handle:active {\n cursor: grabbing;\n}\n\n.field-content {\n flex: 1;\n cursor: pointer;\n}\n\n.field-header {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n margin-bottom: 0.25rem;\n}\n\n.field-type-badge {\n padding: 0.2rem 0.5rem;\n background: var(--tint-color, #dc8a78);\n color: var(--fg-main-color, #4c4f69);\n border-radius: 3px;\n font-size: 0.75rem;\n font-weight: 600;\n text-transform: uppercase;\n}\n\n.field-label-preview {\n font-weight: 600;\n font-size: 1rem;\n}\n\n.field-description-preview {\n font-size: 0.85rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n margin-top: 0.25rem;\n}\n\n.field-key-preview {\n margin-top: 0.25rem;\n font-size: 0.8rem;\n}\n\n.field-key-preview code {\n background: var(--bg-alt-color, #e6e9ef);\n padding: 0.2rem 0.4rem;\n border-radius: 3px;\n font-family: monospace;\n color: var(--code-color, #0091f8);\n}\n\n.field-actions {\n display: flex;\n gap: 0.5rem;\n}\n\n.field-edit-button,\n.field-delete-button {\n background: transparent;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n padding: 0.5rem;\n cursor: pointer;\n color: var(--fg-main-color, #4c4f69);\n transition: all 0.2s;\n}\n\n.field-edit-button:hover {\n background: var(--tint-color, #dc8a78);\n color: var(--fg-main-color, #4c4f69);\n border-color: var(--tint-color, #dc8a78);\n}\n\n.field-delete-button:hover {\n background: var(--fg-error-color, color-mix(in oklch, var(--fg-main-color), red 20%));\n color: var(--fg-main-color, #4c4f69);\n border-color: var(--fg-error-color, color-mix(in oklch, var(--fg-main-color), red 20%));\n}\n\n.field-drop-indicator {\n height: 2px;\n background: var(--tint-color, #dc8a78);\n margin: 0.25rem 0;\n border-radius: 1px;\n}\n\n/* Field Editor Modal */\n.field-editor-overlay {\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n background: color-mix(in oklch, var(--bg-main-color), black 50%);\n display: flex;\n align-items: center;\n justify-content: center;\n z-index: 1000;\n}\n\n.field-editor-modal {\n background: var(--bg-main-color, #eff1f5);\n border-radius: 8px;\n width: 90%;\n max-width: 600px;\n max-height: 90vh;\n display: flex;\n flex-direction: column;\n box-shadow: 0 4px 20px color-mix(in oklch, var(--bg-main-color), black 30%);\n}\n\n.field-editor-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding: 1rem 1.5rem;\n border-bottom: 1px solid var(--divider-color, #CDCFD0);\n}\n\n.field-editor-header h3 {\n margin: 0;\n font-size: 1.25rem;\n color: var(--fg-main-color, #4c4f69);\n}\n\n.field-editor-close {\n background: transparent;\n border: none;\n font-size: 1.5rem;\n cursor: pointer;\n color: var(--fg-main-color, #4c4f69);\n padding: 0.25rem;\n line-height: 1;\n}\n\n.field-editor-close:hover {\n color: var(--tint-color, #dc8a78);\n}\n\n.field-editor-content {\n flex: 1;\n padding: 1.5rem;\n overflow-y: auto;\n}\n\n.field-editor-row {\n margin-bottom: 1.5rem;\n}\n\n.field-editor-row label {\n display: block;\n margin-bottom: 0.5rem;\n font-weight: 600;\n font-size: 0.9rem;\n}\n\n.field-editor-row input[type='text'],\n.field-editor-row input[type='number'],\n.field-editor-row textarea,\n.field-editor-row select {\n width: 100%;\n padding: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n font-size: 1rem;\n font-family: inherit;\n background: var(--bg-apple-input-color, #fbfbfb);\n color: var(--fg-main-color, #4c4f69);\n}\n\n.field-editor-row textarea {\n resize: vertical;\n min-height: 80px;\n}\n\n.field-editor-row input[type='checkbox'] {\n margin-right: 0.5rem;\n}\n\n.field-editor-help {\n font-size: 0.85rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n margin-top: 0.25rem;\n font-style: italic;\n}\n\n.field-editor-footer {\n display: flex;\n justify-content: flex-end;\n gap: 0.5rem;\n padding: 1rem 1.5rem;\n border-top: 1px solid var(--divider-color, #CDCFD0);\n background: var(--bg-alt-color, #e6e9ef);\n}\n\n/* Field Type Selector Modal */\n.field-type-selector-overlay {\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n background: color-mix(in oklch, var(--bg-main-color), black 50%);\n display: flex;\n align-items: center;\n justify-content: center;\n z-index: 1000;\n}\n\n.field-type-selector-modal {\n background: var(--bg-main-color, #eff1f5);\n border-radius: 8px;\n width: 90%;\n max-width: 600px;\n height: 600px;\n max-height: 90vh;\n display: flex;\n flex-direction: column;\n box-shadow: 0 4px 20px color-mix(in oklch, var(--bg-main-color), black 30%);\n}\n\n.field-type-selector-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n gap: 1rem;\n padding: 1rem 1.5rem;\n border-bottom: 1px solid var(--divider-color, #CDCFD0);\n}\n\n.field-type-selector-header h3 {\n margin: 0;\n font-size: 1.25rem;\n flex-shrink: 0;\n}\n\n.field-type-selector-filter-wrapper {\n flex: 1;\n max-width: 300px;\n}\n\n.field-type-selector-filter {\n width: 100%;\n padding: 0.5rem 0.75rem;\n font-size: 0.9rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n background: var(--bg-apple-input-color, #fbfbfb);\n color: var(--fg-main-color, #4c4f69);\n}\n\n.field-type-selector-filter:focus {\n outline: none;\n border-color: var(--tint-color, #dc8a78);\n box-shadow: 0 0 0 2px color-mix(in oklch, var(--tint-color, #dc8a78), transparent 80%);\n}\n\n.field-type-selector-filter::placeholder {\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n}\n\n.field-type-selector-close {\n background: transparent;\n border: none;\n font-size: 1.5rem;\n cursor: pointer;\n color: var(--fg-main-color, #4c4f69);\n padding: 0.25rem;\n line-height: 1;\n}\n\n.field-type-selector-close:hover {\n color: var(--tint-color, #dc8a78);\n}\n\n.field-type-selector-content {\n flex: 1;\n padding: 1.5rem;\n overflow-y: auto;\n display: flex;\n flex-direction: column;\n min-height: 0;\n}\n\n.field-type-selector-footer {\n display: flex;\n justify-content: flex-end;\n gap: 0.5rem;\n padding: 1rem 1.5rem;\n border-top: 1px solid var(--divider-color, #CDCFD0);\n background: var(--bg-alt-color, #e6e9ef);\n}\n\n/* Options Editor */\n.options-editor {\n margin-top: 0.5rem;\n}\n\n.options-editor-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n margin-bottom: 0.75rem;\n}\n\n.options-editor-header label {\n font-weight: 600;\n font-size: 0.9rem;\n}\n\n.add-option-button {\n padding: 0.375rem 0.75rem;\n font-size: 0.875rem;\n}\n\n.options-list {\n display: flex;\n flex-direction: column;\n gap: 0.5rem;\n margin-bottom: 0.5rem;\n}\n\n.options-empty-state {\n padding: 1rem;\n text-align: center;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n font-style: italic;\n border: 1px dashed var(--divider-color, #CDCFD0);\n border-radius: 4px;\n}\n\n.option-item {\n display: flex;\n align-items: flex-start;\n gap: 0.75rem;\n padding: 0.75rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n background: var(--bg-main-color, #eff1f5);\n}\n\n.option-item-controls {\n display: flex;\n flex-direction: column;\n gap: 0.25rem;\n}\n\n.option-move-button {\n background: transparent;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 3px;\n padding: 0.25rem 0.5rem;\n cursor: pointer;\n font-size: 0.875rem;\n color: var(--fg-main-color, #4c4f69);\n transition: all 0.2s;\n}\n\n.option-move-button:hover:not(:disabled) {\n background: var(--tint-color, #dc8a78);\n color: var(--fg-main-color, #4c4f69);\n border-color: var(--tint-color, #dc8a78);\n}\n\n.option-move-button:disabled {\n opacity: 0.3;\n cursor: not-allowed;\n}\n\n.option-item-fields {\n flex: 1;\n display: flex;\n flex-direction: column;\n gap: 0.5rem;\n}\n\n.option-field {\n display: flex;\n flex-direction: column;\n gap: 0.25rem;\n}\n\n.option-field label {\n font-size: 0.85rem;\n font-weight: 500;\n}\n\n.option-field input[type='text'] {\n padding: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n font-size: 0.9rem;\n background: var(--bg-apple-input-color, #fbfbfb);\n color: var(--fg-main-color, #4c4f69);\n}\n\n.option-checkbox-field {\n flex-direction: row;\n align-items: center;\n gap: 0.5rem;\n}\n\n.option-checkbox-field label {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n cursor: pointer;\n font-weight: normal;\n}\n\n.option-delete-button {\n background: transparent;\n border: none;\n color: var(--fg-error-color, color-mix(in oklch, var(--fg-main-color), red 20%));\n font-size: 1.5rem;\n cursor: pointer;\n padding: 0.25rem 0.5rem;\n line-height: 1;\n transition: all 0.2s;\n}\n\n.option-delete-button:hover {\n background: var(--fg-error-color, color-mix(in oklch, var(--fg-main-color), red 20%));\n color: var(--fg-main-color, #4c4f69);\n border-radius: 4px;\n}\n\n.options-editor-help {\n font-size: 0.85rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n font-style: italic;\n margin-top: 0.5rem;\n}\n\n/* Conditions Editor (conditional-values matchTerm/value pairs) */\n.conditions-editor {\n margin-top: 0.5rem;\n}\n\n.conditions-editor-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n margin-bottom: 0.75rem;\n}\n\n.conditions-editor-header label {\n font-weight: 600;\n font-size: 0.9rem;\n}\n\n.add-condition-button {\n padding: 0.375rem 0.75rem;\n font-size: 0.875rem;\n}\n\n.conditions-list {\n display: flex;\n flex-direction: column;\n gap: 0.5rem;\n margin-bottom: 0.5rem;\n}\n\n.conditions-empty-state {\n padding: 1rem;\n text-align: center;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n font-style: italic;\n border: 1px dashed var(--divider-color, #CDCFD0);\n border-radius: 4px;\n}\n\n.condition-item {\n display: flex;\n align-items: flex-start;\n gap: 0.75rem;\n padding: 0.75rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n background: var(--bg-main-color, #eff1f5);\n}\n\n.condition-item-controls {\n display: flex;\n flex-direction: column;\n gap: 0.25rem;\n}\n\n.condition-move-button {\n background: transparent;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 3px;\n padding: 0.25rem 0.5rem;\n cursor: pointer;\n font-size: 0.875rem;\n color: var(--fg-main-color, #4c4f69);\n transition: all 0.2s;\n}\n\n.condition-move-button:hover:not(:disabled) {\n background: var(--tint-color, #dc8a78);\n color: var(--fg-main-color, #4c4f69);\n border-color: var(--tint-color, #dc8a78);\n}\n\n.condition-move-button:disabled {\n opacity: 0.3;\n cursor: not-allowed;\n}\n\n.condition-item-fields {\n flex: 1;\n display: flex;\n flex-direction: row;\n flex-wrap: wrap;\n gap: 0.75rem;\n}\n\n.condition-field {\n display: flex;\n flex-direction: column;\n gap: 0.25rem;\n min-width: 120px;\n flex: 1;\n}\n\n.value-input-with-insert-row {\n display: flex;\n flex-wrap: wrap;\n align-items: center;\n gap: 0.5rem;\n}\n\n.value-input-with-insert-row input {\n flex: 1;\n min-width: 100px;\n}\n\n.condition-field label {\n font-size: 0.85rem;\n font-weight: 500;\n}\n\n.condition-field input[type='text'] {\n padding: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n font-size: 0.9rem;\n background: var(--bg-apple-input-color, #fbfbfb);\n color: var(--fg-main-color, #4c4f69);\n}\n\n.condition-delete-button {\n background: transparent;\n border: none;\n color: var(--fg-error-color, color-mix(in oklch, var(--fg-main-color), red 20%));\n font-size: 1.5rem;\n cursor: pointer;\n padding: 0.25rem 0.5rem;\n line-height: 1;\n transition: all 0.2s;\n}\n\n.condition-delete-button:hover {\n background: var(--fg-error-color, color-mix(in oklch, var(--fg-main-color), red 20%));\n color: var(--fg-main-color, #4c4f69);\n border-radius: 4px;\n}\n\n.conditions-editor-help {\n font-size: 0.85rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n font-style: italic;\n margin-top: 0.5rem;\n}\n\n/* ValueInsertButtons (+Color, +Icon, +Pattern, +IconStyle) */\n.value-insert-buttons {\n display: flex;\n flex-wrap: wrap;\n gap: 0.35rem;\n align-items: flex-start;\n}\n\n.value-insert-btn-group {\n position: relative;\n}\n\n.value-insert-btn {\n padding: 0.3rem 0.5rem;\n font-size: 0.8rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n background: var(--bg-apple-button-color, #fcfcfc);\n color: var(--fg-main-color, #4c4f69);\n cursor: pointer;\n white-space: nowrap;\n transition: background 0.2s, border-color 0.2s;\n}\n\n.value-insert-btn:hover:not(:disabled) {\n background: var(--bg-mid-color, #ebedf2);\n border-color: var(--tint-color, #dc8a78);\n}\n\n.value-insert-btn:disabled {\n opacity: 0.5;\n cursor: not-allowed;\n}\n\n.value-insert-dropdown {\n position: absolute;\n top: 100%;\n left: 0;\n margin-top: 2px;\n min-width: 140px;\n max-height: 240px;\n overflow-y: auto;\n background: var(--bg-main-color, #eff1f5);\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 6px;\n box-shadow: 0 4px 12px color-mix(in oklch, var(--bg-main-color), black 25%);\n z-index: 500;\n display: flex;\n flex-direction: column;\n padding: 0.25rem;\n gap: 1px;\n}\n\n.value-insert-dropdown-colors {\n min-width: 160px;\n max-height: 280px;\n}\n\n.value-insert-option {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n padding: 0.4rem 0.5rem;\n font-size: 0.85rem;\n text-align: left;\n border: none;\n border-radius: 4px;\n background: transparent;\n color: var(--fg-main-color, #4c4f69);\n cursor: pointer;\n transition: background 0.15s;\n}\n\n.value-insert-option:hover {\n background: var(--bg-alt-color, #e6e9ef);\n}\n\n.value-insert-option-color {\n flex-direction: row;\n align-items: center;\n}\n\n.value-insert-color-swatch {\n width: 1rem;\n height: 1rem;\n flex-shrink: 0;\n border-radius: 3px;\n}\n\n.value-insert-option-label {\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.value-insert-option-icon {\n flex-direction: row;\n align-items: center;\n}\n\n/* Save Button Styles - match other buttons */\n.save-button-active {\n background-color: var(--tint-color, #dc8a78) !important;\n color: var(--fg-main-color, #4c4f69) !important;\n cursor: pointer;\n border: none !important;\n border-radius: 4px !important;\n padding: 4px 8px !important;\n margin: 2px 4px 2px 0px !important;\n font-size: 0.85rem !important;\n line-height: 1.2rem !important;\n white-space: nowrap !important;\n align-self: center !important;\n}\n\n.save-button-disabled {\n opacity: 0.5;\n cursor: not-allowed;\n border: none !important;\n border-radius: 4px !important;\n padding: 4px 8px !important;\n margin: 2px 4px 2px 0px !important;\n font-size: 0.85rem !important;\n line-height: 1.2rem !important;\n white-space: nowrap !important;\n align-self: center !important;\n}\n\n/* Processing Template Chooser - maximize horizontal space */\n.processing-template-chooser-container {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n width: 100%;\n}\n\n.processing-template-chooser-wrapper {\n flex: 1;\n min-width: 0; /* Allow shrinking below content size */\n}\n\n/* When there's an open button, constrain the wrapper more */\n.note-chooser-with-open-button .processing-template-chooser-wrapper {\n max-width: calc(100% - 5rem); /* Account for \"Open\" button + gap */\n}\n\n/* When there's no open button, use full width */\n.note-chooser-no-open-button .processing-template-chooser-wrapper {\n max-width: 100%;\n}\n\n/* Ensure the note chooser itself fills its wrapper */\n.processing-template-chooser-wrapper .note-chooser-container {\n width: 100%;\n}\n\n.processing-template-chooser-wrapper .note-chooser-input-wrapper {\n width: 100%;\n min-width: 0; /* Allow shrinking */\n}\n\n.processing-template-chooser-wrapper .note-chooser-input {\n width: 100%;\n min-width: 0; /* Allow text truncation */\n}\n" }, { "path": "dwertheimer.Forms/src/components/FormBuilder.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FormBuilder Component\n// Visual form builder for creating and editing form field definitions\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, useMemo, useCallback, useRef, type Node } from 'react'\nimport { PanelGroup, Panel, PanelResizeHandle } from 'react-resizable-panels'\nimport { useAppContext } from './AppContext.jsx'\nimport { FieldEditor } from './FieldEditor.jsx'\nimport { FieldTypeSelector } from './FieldTypeSelector.jsx'\nimport { FormSettings } from './FormSettings.jsx'\nimport { FormFieldsList } from './FormFieldsList.jsx'\nimport { FormPreview } from './FormPreview.jsx'\nimport { stripDoubleQuotes } from '@helpers/stringTransforms'\nimport { logDebug, logError } from '@helpers/react/reactDev.js'\nimport { unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\nimport { type NoteOption } from '@helpers/react/DynamicDialog/NoteChooser.jsx'\nimport { type TSettingItem, type TSettingItemType } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\nimport './FormBuilder.css'\n\ntype FormBuilderProps = {\n initialFields?: Array,\n receivingTemplateTitle?: string,\n windowTitle?: string,\n formTitle?: string,\n allowEmptySubmit?: boolean,\n hideDependentItems?: boolean,\n width?: ?number | ?string,\n height?: ?number | ?string,\n x?: ?number | ?string,\n y?: ?number | ?string,\n templateBody?: string, // Load from codeblock\n customCSS?: string, // Load from codeblock\n newNoteFrontmatter?: string, // Load from codeblock\n templateRunnerArgs?: { [key: string]: any }, // TemplateRunner processing variables (loaded from codeblock)\n isNewForm?: boolean,\n templateTitle?: string,\n templateFilename?: string,\n launchLink?: string, // Launch link URL for Form URL button\n onSave: (fields: Array, frontmatter: { [key: string]: any }) => Promise<{ success: boolean, message?: string }>,\n onCancel: () => void,\n onOpenForm?: (templateTitle: string) => void,\n}\n\n//--------------------------------------------------------------------------\n// FormBuilder Component\n//--------------------------------------------------------------------------\nexport function FormBuilder({\n initialFields = [],\n receivingTemplateTitle = '',\n windowTitle = '',\n formTitle = '',\n allowEmptySubmit = false,\n hideDependentItems = false,\n width,\n height,\n x,\n y,\n templateBody = '', // Load from codeblock\n customCSS = '', // Load from codeblock\n newNoteFrontmatter = '', // Load from codeblock\n templateRunnerArgs = {}, // TemplateRunner processing variables (loaded from codeblock)\n isNewForm = false,\n templateTitle = '',\n templateFilename = '',\n launchLink = '',\n onSave,\n onCancel,\n onOpenForm,\n}: FormBuilderProps): Node {\n // Get requestFromPlugin and sendActionToPlugin from context (needed early for useState)\n const { requestFromPlugin, dispatch, pluginData } = useAppContext()\n\n // Get template's teamspace ID and title from pluginData (if form is in a teamspace, preserve that context)\n const templateTeamspaceID = pluginData?.templateTeamspaceID || ''\n const templateTeamspaceTitle = pluginData?.templateTeamspaceTitle || ''\n\n // Add default comment field for new forms\n const defaultCommentField: TSettingItem = {\n type: 'comment',\n label: 'Getting Started',\n commentText: `# Welcome to Form Builder\n\nUse this form builder to create your form:\n\n1. **Add Fields**: Click the \"+ Add Field\" button to add form fields (text inputs, dropdowns, date pickers, etc.)\n2. **Edit Fields**: Click any field to edit its properties (label, key, validation, etc.)\n3. **Reorder Fields**: Drag fields by their grip handle to reorder them\n4. **Preview**: Use the preview pane on the right to see how your form will look\n5. **Settings**: Use the settings panel on the left to configure form behavior and processing options\n\nYou can edit or delete this comment field - it's just a note to help you get started!`,\n expanded: true,\n }\n const [fields, setFields] = useState>(() => {\n // If this is a new form and no initial fields, add default comment field\n if (isNewForm && (!initialFields || initialFields.length === 0)) {\n return [defaultCommentField]\n }\n return initialFields\n })\n const [editingIndex, setEditingIndex] = useState(null)\n const [draggedIndex, setDraggedIndex] = useState(null)\n const [dragOverIndex, setDragOverIndex] = useState(null)\n const [showAddField, setShowAddField] = useState(false)\n const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false)\n const [isSaved, setIsSaved] = useState(!isNewForm)\n // Track if form has been saved at least once (for new forms, this becomes true after first save)\n const [hasBeenSavedOnce, setHasBeenSavedOnce] = useState(!isNewForm)\n const [folders, setFolders] = useState>([])\n const [notes, setNotes] = useState>([])\n const [foldersLoaded, setFoldersLoaded] = useState(false)\n const [notesLoaded, setNotesLoaded] = useState(false)\n const [loadingFolders, setLoadingFolders] = useState(false)\n const [loadingNotes, setLoadingNotes] = useState(false)\n const [showTagInserter, setShowTagInserter] = useState(false)\n const [tagInserterInputRef, setTagInserterInputRef] = useState(null)\n const [tagInserterFieldKey, setTagInserterFieldKey] = useState('')\n const [tagInserterMode, setTagInserterMode] = useState<'field' | 'date' | 'both'>('both')\n const [frontmatter, setFrontmatter] = useState<{ [key: string]: any }>(() => {\n // Strip quotes from initial values to prevent saving quoted values\n const cleanedReceivingTemplateTitle = stripDoubleQuotes(receivingTemplateTitle || '') || ''\n // Get processingMethod from pluginData (loaded from frontmatter) or calculate default\n // pluginData.processingMethod comes from the note's frontmatter via windowManagement.js\n const processingMethodFromPluginData = pluginData?.processingMethod || ''\n // For backward compatibility: if receivingTemplateTitle exists, automatically use form-processor\n // But only if processingMethod wasn't already set in frontmatter\n const defaultProcessingMethod = processingMethodFromPluginData || (cleanedReceivingTemplateTitle ? 'form-processor' : 'write-existing')\n\n // Base frontmatter with form configuration\n const baseFrontmatter = {\n processingMethod: defaultProcessingMethod, // Will be overridden by templateRunnerArgs if present\n receivingTemplateTitle: cleanedReceivingTemplateTitle,\n windowTitle: stripDoubleQuotes(windowTitle || '') || '',\n formTitle: stripDoubleQuotes(formTitle || '') || '',\n allowEmptySubmit: allowEmptySubmit || false,\n hideDependentItems: hideDependentItems || false,\n width: width,\n height: height,\n x: x, // Preserve string values like \"center\", \"left\", \"right\" or numeric/percentage values\n y: y, // Preserve string values like \"center\", \"top\", \"bottom\" or numeric/percentage values\n // Option A: Write to existing file (defaults)\n getNoteTitled: '',\n location: 'append',\n writeUnderHeading: '',\n replaceNoteContents: false,\n createMissingHeading: true,\n // Option B: Create new note (defaults)\n newNoteTitle: '',\n newNoteFolder: '',\n newNoteFrontmatter: '', // Frontmatter for new note (saved to codeblock)\n // Option C: Form processor (receivingTemplateTitle only - formProcessorTitle deprecated/eliminated)\n // Space selection (empty string = Private, teamspace ID = Teamspace)\n // Default to template's teamspace if form is in a teamspace, otherwise Private\n space: templateTeamspaceID || '', // Use template's teamspace as default if available\n // Template body (loaded from codeblock)\n templateBody: templateBody || '',\n // Custom CSS (loaded from codeblock)\n customCSS: customCSS || '',\n // New note frontmatter (loaded from codeblock)\n newNoteFrontmatter: newNoteFrontmatter || '',\n }\n\n // Merge TemplateRunner args from codeblock (these override defaults)\n // These contain template tags and should not be in frontmatter\n const mergedFrontmatter: { [key: string]: any } = { ...baseFrontmatter }\n Object.keys(templateRunnerArgs).forEach((key: string) => {\n if (templateRunnerArgs[key] !== undefined) {\n mergedFrontmatter[key] = templateRunnerArgs[key]\n }\n })\n\n // If space is not set in templateRunnerArgs and template is in a teamspace, set it as default\n // This ensures forms opened in a teamspace default to that teamspace for creating/loading notes\n if (templateTeamspaceID && !mergedFrontmatter.space) {\n mergedFrontmatter.space = templateTeamspaceID\n }\n\n return mergedFrontmatter\n })\n\n // Handle Form URL copy\n const handleCopyFormUrl = async () => {\n // Use launchLink from props (passed from pluginData) or from frontmatter\n const urlToCopy = launchLink || frontmatter.launchLink\n if (!urlToCopy) {\n // Show toast message instead of alert\n dispatch('SHOW_TOAST', {\n type: 'WARN',\n msg: 'No form URL available. Save the form first to generate a URL.',\n timeout: 3000,\n })\n return\n }\n try {\n // Use browser Clipboard API directly - no need for plugin round-trip\n // $FlowFixMe[prop-missing] - navigator.clipboard may not be in Flow types\n if (navigator.clipboard && typeof (navigator.clipboard: any).writeText === 'function') {\n await (navigator.clipboard: any).writeText(urlToCopy)\n dispatch('SHOW_TOAST', {\n type: 'SUCCESS',\n msg: 'Form URL copied to clipboard!',\n timeout: 2000,\n })\n } else {\n // Fallback for older browsers - use a temporary textarea element\n const textarea = document.createElement('textarea')\n textarea.value = urlToCopy\n textarea.style.position = 'fixed'\n textarea.style.opacity = '0'\n if (document.body) {\n document.body.appendChild(textarea)\n textarea.select()\n try {\n document.execCommand('copy')\n dispatch('SHOW_TOAST', {\n type: 'SUCCESS',\n msg: 'Form URL copied to clipboard!',\n timeout: 2000,\n })\n } catch (err) {\n throw new Error('Clipboard copy failed')\n } finally {\n if (document.body) {\n document.body.removeChild(textarea)\n }\n }\n } else {\n throw new Error('Document body not available')\n }\n }\n } catch (error) {\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: `Error copying URL: ${error.message || String(error)}`,\n timeout: 3000,\n })\n }\n }\n\n // Handle form duplication\n const handleDuplicateForm = async () => {\n if (!templateFilename || !templateTitle) {\n alert('Cannot duplicate: form must be saved first.')\n return\n }\n try {\n const envelope = await requestFromPlugin('duplicateForm', {\n templateFilename,\n templateTitle,\n receivingTemplateTitle: frontmatter.receivingTemplateTitle || frontmatter.formProcessorTitle || '',\n })\n if (!envelope.success) {\n alert(envelope.message || 'Failed to duplicate form')\n return\n }\n const result = envelope.data\n const newTitle = result && typeof result === 'object' && typeof result.newTemplateTitle === 'string' ? result.newTemplateTitle : null\n alert(newTitle ? `Form \"${newTitle}\" duplicated successfully` : envelope.message || 'Form duplicated successfully')\n } catch (error) {\n alert(`Error duplicating form: ${error.message || String(error)}`)\n }\n }\n\n // Check if form has folder-chooser or note-chooser fields\n const needsFolders = useMemo(() => fields.some((field) => field.type === 'folder-chooser'), [fields])\n const needsNotes = useMemo(() => fields.some((field) => field.type === 'note-chooser'), [fields])\n\n // Load folders on demand when needed (for form fields OR processing method sections)\n const loadFolders = useCallback(\n async (forceReload: boolean = false, spaceOverride?: ?string) => {\n if ((foldersLoaded && !forceReload) || loadingFolders) return\n\n try {\n setLoadingFolders(true)\n // Use spaceOverride if provided, otherwise use frontmatter.space\n const spaceToUse = spaceOverride !== null && spaceOverride !== undefined ? spaceOverride : frontmatter.space || ''\n logDebug('FormBuilder', `Loading folders on demand... (space=${spaceToUse || 'Private'})`)\n const foldersData = unwrapPluginRequestData(\n await requestFromPlugin('getFolders', {\n excludeTrash: true,\n space: spaceToUse, // Filter by selected space (empty string = Private)\n }),\n )\n if (Array.isArray(foldersData)) {\n setFolders(foldersData)\n setFoldersLoaded(true)\n logDebug('FormBuilder', `Loaded ${foldersData.length} folders`)\n } else {\n logError('FormBuilder', `Failed to load folders: Invalid response format`)\n setFoldersLoaded(true) // Set to true to prevent infinite retries\n }\n } catch (error) {\n logError('FormBuilder', `Error loading folders: ${error.message}`)\n setFoldersLoaded(true) // Set to true to prevent infinite retries\n } finally {\n setLoadingFolders(false)\n }\n },\n [foldersLoaded, loadingFolders, requestFromPlugin, frontmatter.space],\n )\n\n // Load notes on demand when needed (for form fields OR processing method sections)\n const loadNotes = useCallback(\n async (forceReload: boolean = false, forProcessingTemplates: boolean = false, spaceOverride?: ?string) => {\n if ((notesLoaded && !forceReload) || loadingNotes) return\n\n try {\n setLoadingNotes(true)\n // Use spaceOverride if provided, otherwise use frontmatter.space\n const spaceToUse = spaceOverride !== null && spaceOverride !== undefined ? spaceOverride : frontmatter.space || ''\n logDebug('FormBuilder', `Loading notes on demand... (forProcessingTemplates=${String(forProcessingTemplates)}, space=${spaceToUse || 'Private'})`)\n const notesData = unwrapPluginRequestData(\n await requestFromPlugin('getNotes', {\n includePersonalNotes: true,\n includeCalendarNotes: !forProcessingTemplates, // Skip calendar notes for processing templates (performance optimization)\n includeRelativeNotes: true, // Always include , , etc. so Target Note chooser shows them; Processing Template chooser filters them via includeRelativeNotes={false}\n includeTeamspaceNotes: true,\n space: spaceToUse, // Filter by selected space (empty string = Private)\n }),\n )\n if (Array.isArray(notesData)) {\n setNotes(notesData)\n setNotesLoaded(true)\n logDebug('FormBuilder', `Loaded ${notesData.length} notes`)\n } else {\n logError('FormBuilder', `Failed to load notes: Invalid response format`)\n setNotesLoaded(true) // Set to true to prevent infinite retries\n }\n } catch (error) {\n logError('FormBuilder', `Error loading notes: ${error.message}`)\n setNotesLoaded(true) // Set to true to prevent infinite retries\n } finally {\n setLoadingNotes(false)\n }\n },\n [notesLoaded, loadingNotes, requestFromPlugin, frontmatter.space],\n )\n\n // Load folders/notes automatically when fields change and they're needed, OR when processing method sections are shown\n useEffect(() => {\n const needsFoldersForFields = fields.some((field) => field.type === 'folder-chooser')\n const needsFoldersForProcessing = frontmatter.processingMethod === 'create-new'\n if (needsFoldersForFields || needsFoldersForProcessing) {\n // Always load if needed, even if already loaded (in case processing method changed)\n const shouldLoad = !foldersLoaded || (needsFoldersForProcessing && folders.length === 0)\n if (shouldLoad && !loadingFolders) {\n logDebug(\n 'FormBuilder',\n `Triggering loadFolders: needsFoldersForFields=${String(needsFoldersForFields)}, needsFoldersForProcessing=${String(needsFoldersForProcessing)}, folders.length=${\n folders.length\n }`,\n )\n loadFolders(needsFoldersForProcessing && folders.length === 0) // Force reload if processing section needs it and we have no data\n }\n }\n }, [needsFolders, foldersLoaded, loadingFolders, loadFolders, frontmatter.processingMethod, fields, folders.length])\n\n // Load notes for form fields on mount (if needed)\n // For processing templates, load notes lazily when dropdown opens (better UX)\n useEffect(() => {\n const needsNotesForFields = fields.some((field) => field.type === 'note-chooser')\n if (needsNotesForFields && !notesLoaded && !loadingNotes) {\n logDebug('FormBuilder', `Triggering loadNotes for form fields: needsNotesForFields=${String(needsNotesForFields)}`)\n loadNotes(false, false) // Load all note types for form fields\n }\n // Note: We no longer auto-load notes for processing templates - they load lazily when dropdown opens\n }, [needsNotes, notesLoaded, loadingNotes, loadNotes, fields])\n\n // Sync frontmatter when the receivingTemplateTitle *prop* changes (e.g. after template creation or initial load).\n // We must NOT sync when only frontmatter.receivingTemplateTitle changes (user changed the dropdown), or we\n // would overwrite the user's selection with the stale prop and the dropdown would \"flip back\".\n const prevReceivingTemplateTitlePropRef = useRef(receivingTemplateTitle)\n // Pending user selection: when user picks a template, setNotes (from getNotes) can commit before setFrontmatter,\n // so one render can show stale frontmatter and the dropdown \"reverts\". We pass pendingRef ?? frontmatter so the\n // display never reverts; clear the ref when frontmatter catches up or when we sync from prop.\n const pendingReceivingTemplateTitleRef = useRef(null)\n useEffect(() => {\n const prevProp = prevReceivingTemplateTitlePropRef.current\n prevReceivingTemplateTitlePropRef.current = receivingTemplateTitle\n if (receivingTemplateTitle && receivingTemplateTitle !== prevProp) {\n pendingReceivingTemplateTitleRef.current = null\n const cleanedReceivingTemplateTitle = stripDoubleQuotes(receivingTemplateTitle || '') || ''\n setFrontmatter((prev) => ({\n ...prev,\n receivingTemplateTitle: cleanedReceivingTemplateTitle,\n // For backward compatibility: if receivingTemplateTitle is set, automatically switch to form-processor\n processingMethod: cleanedReceivingTemplateTitle ? 'form-processor' : prev.processingMethod || 'write-existing',\n }))\n }\n }, [receivingTemplateTitle])\n\n // Clear pending ref once frontmatter has caught up to the user's selection (avoids keeping override forever)\n useEffect(() => {\n if (pendingReceivingTemplateTitleRef.current != null && frontmatter.receivingTemplateTitle === pendingReceivingTemplateTitleRef.current) {\n pendingReceivingTemplateTitleRef.current = null\n }\n }, [frontmatter.receivingTemplateTitle])\n\n // Initialize frontmatter with stripped quotes to prevent saving quoted values\n useEffect(() => {\n setFrontmatter((prev) => {\n const updated = { ...prev }\n // Strip quotes from string values in frontmatter\n let hasChanges = false\n Object.keys(updated).forEach((key) => {\n if (typeof updated[key] === 'string') {\n const stripped = stripDoubleQuotes(updated[key])\n if (stripped !== updated[key]) {\n updated[key] = stripped\n hasChanges = true\n }\n }\n })\n return hasChanges ? updated : prev\n })\n }, []) // Only run once on mount\n\n //----------------------------------------------------------------------\n // Drag and Drop Handlers\n //----------------------------------------------------------------------\n const handleDragStart = (e: any, index: number) => {\n setDraggedIndex(index)\n e.dataTransfer.effectAllowed = 'move'\n e.dataTransfer.setData('text/html', '')\n }\n\n const handleDragOver = (e: any, index: number) => {\n e.preventDefault()\n e.dataTransfer.dropEffect = 'move'\n setDragOverIndex(index)\n }\n\n const handleDragLeave = () => {\n setDragOverIndex(null)\n }\n\n const handleDrop = (e: any, dropIndex: number) => {\n e.preventDefault()\n if (draggedIndex == null || draggedIndex === dropIndex) {\n setDraggedIndex(null)\n setDragOverIndex(null)\n return\n }\n\n const newFields = [...fields]\n const draggedItem = newFields[draggedIndex]\n if (draggedItem && typeof draggedIndex === 'number') {\n newFields.splice(draggedIndex, 1)\n const insertIndex = dropIndex\n newFields.splice(insertIndex, 0, draggedItem)\n }\n\n handleReorderFields(newFields)\n setDraggedIndex(null)\n setDragOverIndex(null)\n }\n\n const handleDragEnd = () => {\n setDraggedIndex(null)\n setDragOverIndex(null)\n }\n\n //----------------------------------------------------------------------\n // Field Management\n //----------------------------------------------------------------------\n\n const handleUpdateField = (index: number, updatedField: TSettingItem) => {\n const newFields = [...fields]\n newFields[index] = updatedField\n setFields(newFields)\n setEditingIndex(null)\n setHasUnsavedChanges(true)\n }\n\n const [isSaving, setIsSaving] = useState(false)\n\n const handleSave = async () => {\n // Guard: Prevent saving with empty fields array to avoid errors and infinite loops\n if (!fields || !Array.isArray(fields) || fields.length === 0) {\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: 'Cannot save form with no fields. Please add at least one field before saving.',\n timeout: 5000,\n })\n return\n }\n\n // Guard: Prevent duplicate saves\n if (isSaving) {\n logDebug('FormBuilder', 'handleSave: Already saving, skipping duplicate save request')\n return\n }\n\n setIsSaving(true)\n try {\n const result = await onSave(fields, frontmatter)\n if (result.success) {\n setHasUnsavedChanges(false)\n setIsSaved(true)\n setHasBeenSavedOnce(true) // Mark that the form has been saved at least once\n // Show success toast with green color\n dispatch('SHOW_TOAST', {\n type: 'SUCCESS',\n msg: result.message || 'Form saved successfully',\n timeout: 3000,\n })\n } else {\n // Show error toast\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: result.message || 'Failed to save form',\n timeout: 5000,\n })\n }\n } catch (error) {\n logError('FormBuilder', `handleSave error: ${error.message}`)\n // Show error toast\n dispatch('SHOW_TOAST', {\n type: 'ERROR',\n msg: error.message || 'Failed to save form',\n timeout: 5000,\n })\n } finally {\n setIsSaving(false)\n }\n }\n\n const handleFrontmatterChange = (key: string, value: any) => {\n // Strip quotes from string values before saving\n const cleanedValue = typeof value === 'string' ? stripDoubleQuotes(value) : value\n if (key === 'receivingTemplateTitle') {\n pendingReceivingTemplateTitleRef.current = cleanedValue != null && cleanedValue !== '' ? String(cleanedValue) : null\n }\n setFrontmatter((prev) => ({ ...prev, [key]: cleanedValue }))\n setHasUnsavedChanges(true)\n }\n\n const handleAddField = (type: TSettingItemType) => {\n const baseField: TSettingItem = {\n type,\n key: type === 'separator' || type === 'heading' ? undefined : `field${fields.length + 1}`,\n label: type === 'separator' ? undefined : `${type} field`,\n compactDisplay: type !== 'separator' && type !== 'heading' && type !== 'calendarpicker' ? true : undefined, // Default to compact display for most fields\n }\n let newField: TSettingItem = baseField\n if (type === 'switch') {\n newField = { ...baseField, default: false }\n } else if (type === 'number') {\n newField = { ...baseField, default: 0, step: 1 }\n } else if (type === 'dropdown-select' || type === 'combo' || type === 'button-group') {\n newField = { ...baseField, options: ['Option 1', 'Option 2'] }\n }\n const newFields = [...fields, newField]\n setFields(newFields)\n setEditingIndex(newFields.length - 1)\n setShowAddField(false)\n setHasUnsavedChanges(true)\n }\n\n const handleDeleteField = (index: number) => {\n const newFields = fields.filter((_, i) => i !== index)\n setFields(newFields)\n if (editingIndex != null && editingIndex === index) {\n setEditingIndex(null)\n } else if (editingIndex != null && typeof editingIndex === 'number' && editingIndex > index) {\n setEditingIndex(editingIndex - 1)\n }\n setHasUnsavedChanges(true)\n }\n\n const handleReorderFields = (newFields: Array) => {\n setFields(newFields)\n setHasUnsavedChanges(true)\n }\n\n const handleOpenForm = () => {\n logDebug('FormBuilder', `handleOpenForm: called, onOpenForm=${String(!!onOpenForm)}, templateTitle=\"${String(templateTitle)}\"`)\n if (!onOpenForm || !templateTitle) {\n logDebug('FormBuilder', `handleOpenForm: early return - onOpenForm=${String(!!onOpenForm)}, templateTitle=${String(!!templateTitle)}`)\n return\n }\n\n // Warn if there are unsaved changes\n if (hasUnsavedChanges) {\n logDebug('FormBuilder', `handleOpenForm: hasUnsavedChanges=true, showing confirmation dialog`)\n const confirmed = window.confirm('You have unsaved changes. The form will open with the last saved version. Do you want to continue?')\n if (!confirmed) {\n logDebug('FormBuilder', `handleOpenForm: user cancelled confirmation`)\n dispatch('SHOW_TOAST', {\n type: 'INFO',\n msg: 'Opening form cancelled. Save your changes first to open the form with the latest version.',\n timeout: 5000,\n })\n return\n }\n }\n\n logDebug('FormBuilder', `handleOpenForm: calling onOpenForm with templateTitle=\"${templateTitle}\"`)\n onOpenForm(templateTitle)\n }\n\n // Allow opening form if saved and not new, OR if it has been saved at least once (for new forms after first save)\n const canOpenForm = Boolean(isSaved && (!isNewForm || hasBeenSavedOnce) && templateTitle && onOpenForm)\n\n // Log canOpenForm calculation whenever dependencies change\n // NOTE: canOpenForm is NOT in dependencies because it's derived from the other dependencies\n // Including it would cause infinite loops since it's recalculated on every render\n useEffect(() => {\n logDebug(\n 'FormBuilder',\n `canOpenForm calculation: isSaved=${String(isSaved)}, !isNewForm=${String(!isNewForm)}, templateTitle=\"${String(templateTitle)}\", onOpenForm=${String(\n !!onOpenForm,\n )}, result=${String(canOpenForm)}`,\n )\n if (!canOpenForm) {\n logDebug(\n 'FormBuilder',\n `Open Form button will NOT render because: isSaved=${String(isSaved)}, isNewForm=${String(isNewForm)}, templateTitle=\"${String(templateTitle)}\", onOpenForm=${String(\n !!onOpenForm,\n )}`,\n )\n }\n }, [isSaved, isNewForm, templateTitle, onOpenForm])\n\n //----------------------------------------------------------------------\n // Render\n //----------------------------------------------------------------------\n // Use pending ref so Processing Template dropdown never reverts when setNotes races with setFrontmatter\n const effectiveReceivingTemplateTitle = pendingReceivingTemplateTitleRef.current ?? frontmatter.receivingTemplateTitle\n const frontmatterForSettings = { ...frontmatter, receivingTemplateTitle: effectiveReceivingTemplateTitle }\n\n return (\n
\n
\n
\n

Template Form Builder

\n {templateTitle && (\n
\n {\n if (templateFilename) {\n try {\n unwrapPluginRequestData(await requestFromPlugin('openNote', { filename: templateFilename }))\n } catch (error) {\n console.error('Error opening note:', error)\n }\n }\n }}\n style={{ cursor: templateFilename ? 'pointer' : 'default', fontSize: '0.875rem', color: 'var(--fg-placeholder-color, rgba(76, 79, 105, 0.7))' }}\n >\n Form: {templateTeamspaceTitle && }\n {(() => {\n const windowTitle = frontmatter.windowTitle || ''\n const formTitle = frontmatter.formTitle || templateTitle || ''\n // Only show both if they're different and both exist\n let displayTitle = ''\n if (windowTitle && formTitle && windowTitle !== formTitle) {\n displayTitle = `${windowTitle} | ${formTitle}`\n } else {\n // Otherwise show whichever one exists (or templateTitle as fallback)\n displayTitle = windowTitle || formTitle || templateTitle\n }\n // Add teamspace indication if form is in a teamspace\n if (templateTeamspaceTitle) {\n return `${templateTeamspaceTitle} ${displayTitle}`\n }\n return displayTitle\n })()}\n
\n {hasUnsavedChanges && (\n \n ⚠️ Unsaved changes\n \n )}\n
\n )}\n
\n
\n {(!isNewForm || hasBeenSavedOnce) && templateFilename && (\n \n )}\n {(!isNewForm || hasBeenSavedOnce) && templateFilename && (\n \n )}\n {canOpenForm ? (\n {\n logDebug('FormBuilder', `Open Form button clicked, event type: ${e.type}`)\n e.preventDefault()\n e.stopPropagation()\n handleOpenForm()\n }}\n title={hasUnsavedChanges ? 'Open form (you have unsaved changes - you will be warned)' : 'Open this form in a new window'}\n style={{ marginRight: '0.5rem' }}\n >\n Open Form\n \n ) : null}\n \n \n {isSaving ? 'Saving...' : 'Save Form'}\n \n
\n
\n
\n \n \n {\n // Load notes - for processing templates, only project notes (faster)\n // For write-existing method, need all note types (including calendar/relative notes)\n // Force reload when space changes or when explicitly requested\n // spaceOverride allows passing the new space value immediately (before state updates)\n await loadNotes(forceReload === true, forProcessingTemplates === true, spaceOverride) // Only skip calendar notes if explicitly for processing templates\n }}\n loadingNotes={loadingNotes}\n onLoadFolders={loadFolders}\n templateTitle={templateTitle}\n templateFilename={templateFilename}\n showTagInserter={showTagInserter}\n setShowTagInserter={setShowTagInserter}\n tagInserterInputRef={tagInserterInputRef}\n setTagInserterInputRef={setTagInserterInputRef}\n tagInserterFieldKey={tagInserterFieldKey}\n setTagInserterFieldKey={setTagInserterFieldKey}\n tagInserterMode={tagInserterMode}\n setTagInserterMode={setTagInserterMode}\n fields={fields}\n />\n \n \n \n setShowAddField(true)}\n onEditField={(index) => setEditingIndex(index)}\n onDeleteField={handleDeleteField}\n onDragStart={handleDragStart}\n onDragOver={handleDragOver}\n onDragLeave={handleDragLeave}\n onDrop={handleDrop}\n onDragEnd={handleDragEnd}\n requestFromPlugin={requestFromPlugin}\n />\n \n \n \n {\n // Show toast instead of closing\n dispatch('SHOW_TOAST', {\n type: 'INFO',\n msg: 'Form submitted successfully (preview mode - no actual submission)',\n timeout: 3000,\n })\n // Explicitly return void\n return\n }}\n />\n \n \n
\n\n setShowAddField(false)} />\n\n {editingIndex != null && typeof editingIndex === 'number' && editingIndex < fields.length && (\n {\n if (typeof editingIndex === 'number') {\n handleUpdateField(editingIndex, updatedField)\n }\n }}\n onCancel={() => setEditingIndex(null)}\n requestFromPlugin={requestFromPlugin}\n />\n )}\n \n )\n}\n\nexport default FormBuilder\n" }, { "path": "dwertheimer.Forms/src/components/FormBuilderView.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FormBuilderView - React WebView wrapper for FormBuilder\n//--------------------------------------------------------------------------\n\nimport React, { useEffect, useRef, useCallback, type Node } from 'react'\nimport { type PassedData } from '../shared/types.js'\nimport { AppProvider } from './AppContext.jsx'\nimport FormBuilder from './FormBuilder.jsx'\nimport { clo, logDebug, logError } from '@helpers/react/reactDev.js'\nimport { pluginEnvelopeFromResponsePayload } from '@helpers/react/pluginRequestEnvelope'\nimport { FORMBUILDER_WINDOW_ID } from '../shared/constants.js'\nimport './FormBuilder.css'\n\ntype Props = {\n data: any,\n dispatch: Function,\n reactSettings: any,\n setReactSettings: Function,\n onSubmitOrCancelCallFunctionNamed: string,\n}\n\n/**\n * Root element for the FormBuilder's React Tree\n * NOTE: Even though we have named this FormBuilderView.jsx, it is exported as WebView because that is what Root expects to load dynamically\n */\nexport function WebView({ data, dispatch, reactSettings, setReactSettings, onSubmitOrCancelCallFunctionNamed = 'onFormBuilderAction' }: Props): Node {\n const { pluginData } = data\n const formFields = pluginData.formFields || []\n const receivingTemplateTitle = pluginData.receivingTemplateTitle || ''\n const windowTitle = pluginData.windowTitle || ''\n const formTitle = pluginData.formTitle || ''\n const allowEmptySubmit = pluginData.allowEmptySubmit || false\n const hideDependentItems = pluginData.hideDependentItems || false\n const width = pluginData.width\n const height = pluginData.height\n const x = pluginData.x\n const y = pluginData.y\n const isNewForm = pluginData.isNewForm || false\n const templateTitle = pluginData.templateTitle || ''\n const launchLink = pluginData.launchLink || ''\n const templateFilename = pluginData.templateFilename || ''\n\n // Map to store pending requests for request/response pattern\n // Key: correlationId, Value: { resolve, reject, timeoutId }\n const pendingRequestsRef = useRef void, reject: (error: Error) => void, timeoutId: any }>>(new Map())\n \n // Store windowId in a ref so requestFromPlugin doesn't need to depend on pluginData\n const windowIdRef = useRef(pluginData?.windowId || FORMBUILDER_WINDOW_ID)\n \n // Update windowId ref when pluginData changes\n useEffect(() => {\n windowIdRef.current = pluginData?.windowId || FORMBUILDER_WINDOW_ID\n }, [pluginData?.windowId])\n\n // Listen for RESPONSE messages from Root and resolve pending requests\n useEffect(() => {\n const handleResponse = (event: MessageEvent) => {\n const { data: eventData } = event\n // $FlowFixMe[incompatible-type] - eventData can be various types\n if (eventData && typeof eventData === 'object' && eventData.type === 'RESPONSE' && eventData.payload) {\n // $FlowFixMe[prop-missing] - payload structure is validated above\n const payload = eventData.payload\n // $FlowFixMe[prop-missing] - payload structure is validated above\n if (payload && typeof payload === 'object') {\n const correlationId = (payload: any).correlationId\n const success = (payload: any).success\n logDebug('FormBuilderView', `handleResponse: Received RESPONSE with correlationId=\"${String(correlationId || '')}\", success=${String(success || false)}`)\n if (correlationId && typeof correlationId === 'string') {\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n pendingRequestsRef.current.delete(correlationId)\n clearTimeout(pending.timeoutId)\n logDebug('FormBuilderView', `handleResponse: Resolving request for correlationId=\"${correlationId}\", success=${String(success || false)}`)\n pending.resolve(pluginEnvelopeFromResponsePayload(payload))\n } else {\n logDebug('FormBuilderView', `handleResponse: No pending request found for correlationId=\"${correlationId}\"`)\n }\n }\n }\n }\n }\n\n window.addEventListener('message', handleResponse)\n return () => {\n window.removeEventListener('message', handleResponse)\n // Clean up any pending requests on unmount\n pendingRequestsRef.current.forEach((pending) => {\n clearTimeout(pending.timeoutId)\n })\n pendingRequestsRef.current.clear()\n }\n }, [])\n\n const sendActionToPlugin = (command: string, dataToSend: any) => {\n logDebug('FormBuilderView', `sendActionToPlugin: command=\"${command}\"`)\n clo(dataToSend, `FormBuilderView: sendActionToPlugin dataToSend`)\n logDebug('FormBuilderView', `sendActionToPlugin: About to dispatch SEND_TO_PLUGIN with command=\"${command}\", data.type=\"${dataToSend?.type || 'MISSING'}\"`)\n dispatch('SEND_TO_PLUGIN', [command, dataToSend], `FormBuilderView: ${command}`)\n logDebug('FormBuilderView', `sendActionToPlugin: dispatch called for command=\"${command}\"`)\n }\n\n /**\n * Request data from the plugin using request/response pattern\n * Returns a Promise that resolves with the response data or rejects with an error\n * Memoized with useCallback to prevent recreation on every render (fixes infinite loop issues)\n * Uses refs for windowId to avoid dependency on pluginData\n * @param {string} command - The command/request type (e.g., 'getFolders', 'getNotes')\n * @param {any} dataToSend - Request parameters\n * @param {number} timeout - Timeout in milliseconds (default: 10000)\n * @returns {Promise}\n */\n const requestFromPlugin = useCallback((command: string, dataToSend: any = {}, timeout: number = 10000): Promise => {\n if (!command) throw new Error('requestFromPlugin: command must be called with a string')\n\n const correlationId = `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n\n return new Promise((resolve, reject) => {\n const timeoutId = setTimeout(() => {\n if (pendingRequestsRef.current.has(correlationId)) {\n pendingRequestsRef.current.delete(correlationId)\n reject(new Error(`Request timeout after ${timeout}ms: ${command}`))\n }\n }, timeout)\n\n pendingRequestsRef.current.set(correlationId, { resolve, reject, timeoutId })\n\n // Send request with correlation ID and request type marker\n // Use ref for windowId to avoid dependency on pluginData\n const requestData = {\n ...dataToSend,\n __correlationId: correlationId,\n __requestType: 'REQUEST',\n __windowId: windowIdRef.current, // Include windowId in request for reliable response routing\n }\n\n logDebug('FormBuilderView', `requestFromPlugin: Sending request \"${command}\" with correlationId=\"${correlationId}\", windowId=\"${String(windowIdRef.current || '')}\"`)\n dispatch('SEND_TO_PLUGIN', [command, requestData], `FormBuilderView: requestFromPlugin: ${String(command)}`)\n })\n }, [dispatch]) // Only depend on dispatch, which should be stable from useReducer\n\n const handleSave = async (fields: Array, frontmatter: any): Promise<{ success: boolean, message?: string }> => {\n clo(fields, 'FormBuilderView: handleSave fields')\n clo(frontmatter, 'FormBuilderView: handleSave frontmatter')\n try {\n const envelope = await requestFromPlugin(onSubmitOrCancelCallFunctionNamed, {\n type: 'save',\n fields,\n frontmatter,\n templateFilename: pluginData.templateFilename || '',\n templateTitle: pluginData.templateTitle || '',\n })\n if (!envelope.success) {\n return { success: false, message: envelope.message || 'Failed to save form' }\n }\n const result = envelope.data\n const titleForMsg = result && typeof result === 'object' && typeof result.templateTitle === 'string' ? result.templateTitle : null\n return {\n success: true,\n message: envelope.message || (titleForMsg ? `Form saved successfully to \"${titleForMsg}\"` : 'Form saved successfully'),\n }\n } catch (error) {\n logError('FormBuilderView', `handleSave error: ${error.message}`)\n return { success: false, message: error.message || 'Failed to save form' }\n }\n }\n\n const handleCancel = () => {\n sendActionToPlugin(onSubmitOrCancelCallFunctionNamed, { type: 'cancel' })\n }\n\n const handleOpenForm = (templateTitle: string) => {\n logDebug('FormBuilderView', `handleOpenForm: called with templateTitle=\"${templateTitle}\"`)\n logDebug('FormBuilderView', `handleOpenForm: onSubmitOrCancelCallFunctionNamed=\"${onSubmitOrCancelCallFunctionNamed}\"`)\n sendActionToPlugin(onSubmitOrCancelCallFunctionNamed, {\n type: 'openForm',\n templateTitle: templateTitle,\n __windowId: windowIdRef.current, // Include windowId so plugin knows which FormBuilder window initiated this\n })\n logDebug('FormBuilderView', `handleOpenForm: sendActionToPlugin called with windowId=\"${String(windowIdRef.current || '')}\"`)\n }\n\n return (\n {\n const newFullData = { ...data, pluginData: newData }\n dispatch('UPDATE_DATA', newFullData)\n }}\n reactSettings={reactSettings}\n setReactSettings={setReactSettings}\n >\n
\n
\n \n
\n
\n \n )\n}\n\nexport default WebView\n" }, { "path": "dwertheimer.Forms/src/components/FormErrorBanner.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FormErrorBanner Component - Reusable error display banner for forms\n//--------------------------------------------------------------------------\n\nimport React, { useEffect, useState, useRef } from 'react'\nimport { unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\nimport './FormView.css'\n\ntype FormErrorBannerProps = {\n aiAnalysisResult?: string, // AI analysis result from template rendering errors\n formSubmissionError?: string, // Form submission error message\n requestFromPlugin?: (command: string, data?: any) => Promise, // Optional: for rendering markdown\n onClose?: () => void, // Optional: callback when banner is closed\n}\n\n/**\n * FormErrorBanner - Displays template errors and form submission errors\n * This component can be used in both FormView and FormPreview\n */\nconst FormErrorBanner = ({\n aiAnalysisResult = '',\n formSubmissionError = '',\n requestFromPlugin,\n onClose,\n}: FormErrorBannerProps): React$Node => {\n // State for rendered markdown HTML and visibility\n const [aiAnalysisHtml, setAiAnalysisHtml] = useState('')\n const [showAiAnalysis, setShowAiAnalysis] = useState(false)\n const bannerShownRef = useRef(false)\n\n // State for form submission error visibility\n const [showFormSubmissionError, setShowFormSubmissionError] = useState(false)\n const formErrorShownRef = useRef(false)\n const formErrorLastValueRef = useRef('')\n\n // Render markdown when AI analysis result is received (only once)\n useEffect(() => {\n if (aiAnalysisResult && typeof aiAnalysisResult === 'string' && aiAnalysisResult.includes('==**Templating Error Found**') && !bannerShownRef.current) {\n bannerShownRef.current = true\n setShowAiAnalysis(true)\n\n // Render markdown to HTML using requestFromPlugin\n if (requestFromPlugin) {\n requestFromPlugin('renderMarkdown', { markdown: aiAnalysisResult })\n .then((envelope: any) => {\n let html: any\n try {\n html = unwrapPluginRequestData(envelope)\n } catch {\n html = null\n }\n if (typeof html === 'string') {\n setAiAnalysisHtml(html)\n } else {\n setAiAnalysisHtml(aiAnalysisResult.replace(/\\n/g, '
')) // Fallback to simple line breaks\n }\n })\n .catch((error: Error) => {\n setAiAnalysisHtml(aiAnalysisResult.replace(/\\n/g, '
')) // Fallback to simple line breaks\n })\n } else {\n // Fallback if requestFromPlugin not available\n setAiAnalysisHtml(aiAnalysisResult.replace(/\\n/g, '
'))\n }\n } else if (!aiAnalysisResult) {\n // Reset banner shown flag when AI analysis is cleared\n bannerShownRef.current = false\n setAiAnalysisHtml('')\n setShowAiAnalysis(false)\n }\n }, [aiAnalysisResult, requestFromPlugin])\n\n // Display form submission error when received; show again when error message changes (e.g. after resubmit)\n useEffect(() => {\n if (formSubmissionError && typeof formSubmissionError === 'string') {\n if (formSubmissionError !== formErrorLastValueRef.current) {\n formErrorLastValueRef.current = formSubmissionError\n formErrorShownRef.current = true\n }\n setShowFormSubmissionError(true)\n } else if (!formSubmissionError) {\n formErrorShownRef.current = false\n formErrorLastValueRef.current = ''\n setShowFormSubmissionError(false)\n }\n }, [formSubmissionError])\n\n const handleCloseAiAnalysis = () => {\n setShowAiAnalysis(false)\n if (onClose) onClose()\n }\n\n const handleCloseFormError = () => {\n setShowFormSubmissionError(false)\n if (onClose) onClose()\n }\n\n if (!showAiAnalysis && !showFormSubmissionError) {\n return null\n }\n\n return (\n <>\n {/* Display form submission error at the top if present */}\n {showFormSubmissionError && formSubmissionError && (\n
\n
\n
⚠️ Form Submission Error:
\n \n ×\n \n
\n
{formSubmissionError}
\n
\n )}\n {/* Display AI analysis result at the top if present */}\n {showAiAnalysis && aiAnalysisResult && (\n
\n
\n
⚠️ Template Error - AI Analysis:
\n \n ×\n \n
\n {aiAnalysisHtml ? (\n \n ) : (\n
Loading...
\n )}\n
\n )}\n \n )\n}\n\nexport default FormErrorBanner\n" }, { "path": "dwertheimer.Forms/src/components/FormFieldsList.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FormFieldsList Component - Middle column showing list of form fields\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, type Node } from 'react'\nimport { type TSettingItem } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\nimport { MarkdownPreview } from '@helpers/react/DynamicDialog/MarkdownPreview.jsx'\nimport { unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\n\ntype FormFieldsListProps = {\n fields: Array,\n editingIndex: ?number,\n draggedIndex: ?number,\n dragOverIndex: ?number,\n onAddField: () => void,\n onEditField: (index: number) => void,\n onDeleteField: (index: number) => void,\n onDragStart: (e: any, index: number) => void,\n onDragOver: (e: any, index: number) => void,\n onDragLeave: () => void,\n onDrop: (e: any, index: number) => void,\n onDragEnd: () => void,\n requestFromPlugin?: (command: string, data?: any) => Promise,\n}\n\nexport function FormFieldsList({\n fields,\n editingIndex,\n draggedIndex,\n dragOverIndex,\n onAddField,\n onEditField,\n onDeleteField,\n onDragStart,\n onDragOver,\n onDragLeave,\n onDrop,\n onDragEnd,\n requestFromPlugin,\n}: FormFieldsListProps): Node {\n // Track expanded state for comment fields (by index as string)\n const [expandedComments, setExpandedComments] = useState<{ [key: string]: boolean }>(() => {\n const initial: { [key: string]: boolean } = {}\n fields.forEach((field, index) => {\n if (field.type === 'comment') {\n // Use field.expanded if set, otherwise default to true\n const indexStr = String(index)\n initial[indexStr] = (field: any).expanded !== false\n }\n })\n return initial\n })\n\n const toggleComment = (index: number) => {\n const indexStr = String(index)\n setExpandedComments((prev) => ({\n ...prev,\n [indexStr]: !prev[indexStr],\n }))\n }\n\n // Sync expanded state when fields change (e.g., when comment fields are added/removed)\n useEffect(() => {\n const newExpanded: { [key: string]: boolean } = {}\n fields.forEach((field, index) => {\n if (field.type === 'comment') {\n const indexStr = String(index)\n // Preserve existing state if field still exists, otherwise use field.expanded or default to true\n newExpanded[indexStr] = expandedComments[indexStr] !== undefined ? expandedComments[indexStr] : (field: any).expanded !== false\n }\n })\n setExpandedComments(newExpanded)\n }, [fields.length]) // Only update when number of fields changes\n\n return (\n
\n
\n
\n

Form Fields

\n
\n \n {requestFromPlugin && (\n {\n try {\n unwrapPluginRequestData(await requestFromPlugin('testFormFieldRender', {}))\n } catch (error) {\n console.error('Error opening form field examples:', error)\n }\n }}\n title=\"Open a test form showing examples of all field types\"\n style={{ fontSize: '0.85rem', padding: '4px 8px' }}\n >\n Examples\n \n )}\n
\n
\n
\n {fields.length === 0 ? (\n
No fields yet. Click "Add Field" to get started.
\n ) : (\n fields.map((field, index) => {\n const isDragging = draggedIndex === index\n const isDragOver = dragOverIndex === index\n const showDropIndicator = isDragOver && draggedIndex != null && draggedIndex !== index\n const isDraggingDown = draggedIndex != null && typeof draggedIndex === 'number' && draggedIndex < index\n const isComment = field.type === 'comment'\n const indexStr = String(index)\n const isExpanded = expandedComments[indexStr] !== false // Default to true if not set\n\n return (\n \n {showDropIndicator && !isDraggingDown &&
}\n onDragStart(e, index)}\n onDragOver={(e) => onDragOver(e, index)}\n onDragLeave={onDragLeave}\n onDrop={(e) => onDrop(e, index)}\n onDragEnd={onDragEnd}\n >\n
\n \n
\n {\n // Don't open editor for separator - it has no editable properties\n // For comment fields, clicking the header toggles expand/collapse\n if (isComment) {\n toggleComment(index)\n } else if (field.type !== 'separator') {\n onEditField(index)\n }\n }}\n style={{ cursor: field.type === 'separator' ? 'default' : 'pointer' }}\n >\n
\n {isComment && (\n \n ▶\n \n )}\n {field.label || field.key || ''}\n {field.type}\n
\n {!isComment && field.description &&
{field.description}
}\n {!isComment && field.key && (\n
\n key: {field.key}\n
\n )}\n {isComment && isExpanded && (field: any).commentText && (\n
\n \n
\n )}\n
\n
\n {field.type !== 'separator' && (\n {\n e.stopPropagation()\n onEditField(editingIndex === index ? -1 : index)\n }}\n title=\"Edit field\"\n >\n \n \n )}\n {\n e.stopPropagation()\n onDeleteField(index)\n }}\n title=\"Delete field\"\n >\n \n \n
\n
\n {showDropIndicator && isDraggingDown &&
}\n \n )\n })\n )}\n
\n
\n
\n )\n}\n\nexport default FormFieldsList\n" }, { "path": "dwertheimer.Forms/src/components/FormPreview.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FormPreview Component - Right column showing live preview of the form\n//--------------------------------------------------------------------------\n\nimport React, { useMemo, useRef, useEffect, useState, useCallback, type Node } from 'react'\nimport { useAppContext } from './AppContext.jsx'\nimport DynamicDialog from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\nimport FormErrorBanner from './FormErrorBanner.jsx'\nimport { type TSettingItem } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\nimport { type NoteOption } from '@helpers/react/DynamicDialog/NoteChooser.jsx'\nimport { stripDoubleQuotes } from '@helpers/stringTransforms'\n\ntype FormPreviewProps = {\n frontmatter: { [key: string]: any },\n fields: Array,\n folders: Array,\n notes: Array,\n requestFromPlugin: (command: string, data?: any) => Promise,\n onSave?: (formValues: { [key: string]: any }, windowId?: string) => void,\n onCancel?: () => void,\n hideHeaderButtons?: boolean,\n allowEmptySubmit?: boolean,\n hidePreviewHeader?: boolean,\n hideWindowTitlebar?: boolean,\n keepOpenOnSubmit?: boolean, // If true, don't close the window after submit (e.g., for Form Browser context)\n onFrontmatterChange?: (key: string, value: any) => void, // Optional callback to update frontmatter (for Form Builder)\n showScaledDisclaimer?: boolean, // If true, show toast warning when preview is scaled (only for Form Builder)\n aiAnalysisResult?: string, // Optional: AI analysis result from template rendering errors\n formSubmissionError?: string, // Optional: Form submission error message\n}\n\n/**\n * Get screen dimensions for calculating intended window size\n * Uses window.screen if available, otherwise defaults to common desktop size\n * @returns {{width: number, height: number}} Screen dimensions\n */\nfunction getScreenDimensions(): { width: number, height: number } {\n // Use window.screen if available (browser context)\n if (typeof window !== 'undefined' && window.screen) {\n return {\n width: window.screen.width || 1920,\n height: window.screen.height || 1080,\n }\n }\n // Default to common desktop size\n return { width: 1920, height: 1080 }\n}\n\n/**\n * Calculate the intended window dimension in pixels\n * This is what the window would be when actually opened\n * @param {string | number | void} value - The dimension value from frontmatter\n * @param {'width' | 'height'} dimensionType - Whether this is width or height\n * @returns {number | null} Intended dimension in pixels, or null if not specified\n */\nfunction calculateIntendedWindowDimension(value: ?(number | string), dimensionType: 'width' | 'height'): ?number {\n if (typeof value === 'number') {\n return value\n }\n if (typeof value === 'string') {\n const trimmedValue = value.trim()\n // If it's a percentage, convert to pixels based on screen size\n if (trimmedValue.endsWith('%')) {\n const percentValue = parseFloat(trimmedValue)\n if (!isNaN(percentValue)) {\n const screenDimensions = getScreenDimensions()\n const screenDimension = dimensionType === 'width' ? screenDimensions.width : screenDimensions.height\n return Math.round((percentValue / 100) * screenDimension)\n }\n }\n // If it already has px units, parse it\n const pxMatch = trimmedValue.match(/^(\\d+)px$/)\n if (pxMatch) {\n return parseInt(pxMatch[1], 10)\n }\n // If it's a plain number string, parse it\n const numValue = parseInt(trimmedValue, 10)\n if (!isNaN(numValue)) {\n return numValue\n }\n }\n return null\n}\n\n/**\n * Calculate preview dimension with constraints\n * Ensures the preview shows the intended size when possible, but respects container limits\n * @param {number | null} intendedSize - The intended window size in pixels\n * @param {number} containerSize - The available container size in pixels\n * @param {number} minSize - Minimum size to display\n * @returns {{size: number, isScaled: boolean}} Preview size and whether it's scaled from intended\n */\nfunction calculatePreviewDimension(intendedSize: ?number, containerSize: number, minSize: number = 200): { size: number, isScaled: boolean } {\n // If no intended size, use 90% of container\n if (intendedSize === null || intendedSize === undefined) {\n return {\n size: Math.round(containerSize * 0.9),\n isScaled: false,\n }\n }\n\n // Calculate 90% of container (max allowed)\n const maxSize = Math.round(containerSize * 0.9)\n\n // Use intended size, but constrain to max\n const constrainedSize = Math.min(intendedSize, maxSize)\n\n // Ensure minimum size\n const finalSize = Math.max(constrainedSize, minSize)\n\n // If we had to scale down, mark as scaled\n const isScaled = finalSize < intendedSize\n\n return {\n size: finalSize,\n isScaled,\n }\n}\n\nexport function FormPreview({\n frontmatter,\n fields,\n folders,\n notes,\n requestFromPlugin,\n onSave,\n onCancel,\n hideHeaderButtons = true,\n allowEmptySubmit = false,\n hidePreviewHeader = false,\n hideWindowTitlebar = false,\n keepOpenOnSubmit = false,\n onFrontmatterChange,\n showScaledDisclaimer = false,\n aiAnalysisResult = '',\n formSubmissionError = '',\n}: FormPreviewProps): Node {\n const containerRef = useRef(null)\n const previewWindowRef = useRef(null)\n const [containerDimensions, setContainerDimensions] = useState<{ width: number, height: number }>({ width: 0, height: 0 })\n const [previewWindowDimensions, setPreviewWindowDimensions] = useState<{ width: number, height: number }>({ width: 0, height: 0 })\n const { dispatch } = useAppContext()\n const prevShowScaledDisclaimerRef = useRef(false)\n\n // Always use smart sizing for previews (both Form Browser and Form Builder)\n // The key difference is that Form Browser doesn't show the preview header\n\n // Calculate intended window dimensions (what they would be when actually opened)\n const intendedWidth = useMemo(() => {\n return calculateIntendedWindowDimension(frontmatter.width, 'width')\n }, [frontmatter.width])\n\n const intendedHeight = useMemo(() => {\n return calculateIntendedWindowDimension(frontmatter.height, 'height')\n }, [frontmatter.height])\n\n // Measure container dimensions\n const measureContainer = useCallback(() => {\n if (containerRef.current) {\n const rect = containerRef.current.getBoundingClientRect()\n setContainerDimensions({\n width: rect.width,\n height: rect.height,\n })\n }\n }, [])\n\n // Measure preview window dimensions\n const measurePreviewWindow = useCallback(() => {\n if (previewWindowRef.current) {\n const rect = previewWindowRef.current.getBoundingClientRect()\n setPreviewWindowDimensions({\n width: Math.round(rect.width),\n height: Math.round(rect.height),\n })\n }\n }, [])\n\n // Calculate preview dimensions with constraints\n const previewDimensions = useMemo(() => {\n // Always use smart sizing for previews (both Form Browser and Form Builder)\n // Only calculate dimensions if we have valid container dimensions\n if (containerDimensions.width === 0 && containerDimensions.height === 0) {\n // Container not measured yet, return empty style (will be recalculated after measurement)\n return { style: {}, isScaled: { width: false, height: false } }\n }\n\n // Calculate both width and height - if not specified, use 90% of container\n const widthResult = calculatePreviewDimension(intendedWidth, containerDimensions.width)\n const heightResult = calculatePreviewDimension(intendedHeight, containerDimensions.height)\n\n const style: { [key: string]: string } = {}\n style.width = `${widthResult.size}px`\n style.maxWidth = `${widthResult.size}px`\n style.minWidth = `${widthResult.size}px`\n\n // Always set height (either calculated from intended or 90% if not specified)\n style.height = `${heightResult.size}px`\n style.minHeight = `${heightResult.size}px`\n\n return { style, isScaled: { width: widthResult.isScaled, height: heightResult.isScaled } }\n }, [frontmatter.width, frontmatter.height, intendedWidth, intendedHeight, containerDimensions.width, containerDimensions.height])\n\n // Measure container dimensions - initial measurement and when needed\n useEffect(() => {\n // Always measure container for smart sizing\n const timeoutId = setTimeout(() => {\n measureContainer()\n measurePreviewWindow()\n }, 0)\n\n const handleResize = () => {\n measureContainer()\n measurePreviewWindow()\n }\n\n window.addEventListener('resize', handleResize)\n\n // Use ResizeObserver for more accurate container measurement\n let containerResizeObserver = null\n const containerElement = containerRef.current\n if (containerElement && typeof ResizeObserver !== 'undefined') {\n containerResizeObserver = new ResizeObserver(() => {\n measureContainer()\n })\n containerResizeObserver.observe(containerElement)\n }\n\n // Use ResizeObserver for preview window measurement\n let previewResizeObserver = null\n const previewElement = previewWindowRef.current\n if (previewElement && typeof ResizeObserver !== 'undefined') {\n previewResizeObserver = new ResizeObserver(() => {\n measurePreviewWindow()\n })\n previewResizeObserver.observe(previewElement)\n }\n\n return () => {\n clearTimeout(timeoutId)\n window.removeEventListener('resize', handleResize)\n if (containerResizeObserver && containerElement) {\n containerResizeObserver.unobserve(containerElement)\n }\n if (previewResizeObserver && previewElement) {\n previewResizeObserver.unobserve(previewElement)\n }\n }\n }, [measureContainer, measurePreviewWindow])\n\n // Measure preview window when its dimensions are set\n useEffect(() => {\n // Small delay to allow DOM to update with new styles\n const timeoutId = setTimeout(() => {\n measurePreviewWindow()\n }, 50)\n return () => clearTimeout(timeoutId)\n }, [previewDimensions.style, measurePreviewWindow])\n\n const isScaled = previewDimensions.isScaled.width || previewDimensions.isScaled.height\n\n // Calculate warning message when preview is scaled (only for Form Builder)\n const scaledWarningMessage = useMemo(() => {\n if (!isScaled) {\n return ''\n }\n const isWidthScaled = previewDimensions.isScaled.width\n const isHeightScaled = previewDimensions.isScaled.height\n let reducedText = ''\n if (isWidthScaled && isHeightScaled) {\n reducedText = 'width and height'\n } else if (isWidthScaled) {\n reducedText = 'width'\n } else if (isHeightScaled) {\n reducedText = 'height'\n }\n const intendedSize = `${intendedWidth ? `${intendedWidth}px` : 'auto'} x ${intendedHeight ? `${intendedHeight}px` : 'auto'}`\n const actualSize = `${previewWindowDimensions.width > 0 ? `${previewWindowDimensions.width}px` : '...'} x ${\n previewWindowDimensions.height > 0 ? `${previewWindowDimensions.height}px` : '...'\n }`\n return `Form settings are set to ${intendedSize}, but preview window is ${actualSize}. ${\n reducedText.charAt(0).toUpperCase() + reducedText.slice(1)\n } is reduced for the preview window.`\n }, [\n isScaled,\n previewDimensions.isScaled.width,\n previewDimensions.isScaled.height,\n intendedWidth,\n intendedHeight,\n previewWindowDimensions.width,\n previewWindowDimensions.height,\n ])\n\n // Compare current preview dimensions with frontmatter settings\n // Only show \"set window to this size\" link if dimensions don't match\n const dimensionsMatch = useMemo(() => {\n if (!previewWindowDimensions.width || !previewWindowDimensions.height) {\n return false // Don't show link until dimensions are measured\n }\n const currentWidth = previewWindowDimensions.width\n const currentHeight = previewWindowDimensions.height\n const frontmatterWidth = calculateIntendedWindowDimension(frontmatter.width, 'width')\n const frontmatterHeight = calculateIntendedWindowDimension(frontmatter.height, 'height')\n\n // If frontmatter has no width/height, they don't match\n if (frontmatterWidth === null || frontmatterHeight === null) {\n return false\n }\n\n // Compare with small tolerance (within 2px)\n // Flow type guard: we know these are numbers after null check\n const widthNum: number = (frontmatterWidth: any)\n const heightNum: number = (frontmatterHeight: any)\n const widthDiff = Math.abs(currentWidth - widthNum)\n const heightDiff = Math.abs(currentHeight - heightNum)\n return widthDiff <= 2 && heightDiff <= 2\n }, [previewWindowDimensions.width, previewWindowDimensions.height, frontmatter.width, frontmatter.height])\n\n // Handle setting window size from preview dimensions\n const handleSetWindowSize = useCallback(() => {\n if (!onFrontmatterChange || !previewWindowDimensions.width || !previewWindowDimensions.height) {\n return\n }\n\n const width = String(previewWindowDimensions.width)\n const height = String(previewWindowDimensions.height)\n\n onFrontmatterChange('width', width)\n onFrontmatterChange('height', height)\n\n // Show success toast\n dispatch('SHOW_TOAST', {\n type: 'SUCCESS',\n msg: `Window size set to ${width}x${height}px`,\n timeout: 3000,\n })\n }, [onFrontmatterChange, previewWindowDimensions.width, previewWindowDimensions.height, dispatch])\n\n // Show warning toast when preview is scaled (only when showScaledDisclaimer prop is true, e.g., in Form Builder)\n useEffect(() => {\n if (showScaledDisclaimer && isScaled && !prevShowScaledDisclaimerRef.current) {\n const isWidthScaled = previewDimensions.isScaled.width\n const isHeightScaled = previewDimensions.isScaled.height\n let reducedText = ''\n if (isWidthScaled && isHeightScaled) {\n reducedText = 'width+height'\n } else if (isWidthScaled) {\n reducedText = 'width'\n } else if (isHeightScaled) {\n reducedText = 'height'\n }\n const intendedSize = `${intendedWidth ? `${intendedWidth}px` : 'auto'} x ${intendedHeight ? `${intendedHeight}px` : 'auto'}`\n const actualSize = `${previewWindowDimensions.width > 0 ? `${previewWindowDimensions.width}px` : '...'} x ${\n previewWindowDimensions.height > 0 ? `${previewWindowDimensions.height}px` : '...'\n }`\n const message = `Form settings are set to ${intendedSize}, but preview DIV is ${actualSize}\\n${reducedText} is reduced for the preview window.`\n dispatch('SHOW_TOAST', {\n type: 'WARN',\n msg: message,\n timeout: 10000,\n })\n }\n prevShowScaledDisclaimerRef.current = isScaled\n }, [\n showScaledDisclaimer,\n isScaled,\n intendedWidth,\n intendedHeight,\n previewWindowDimensions.width,\n previewWindowDimensions.height,\n previewDimensions.isScaled.width,\n previewDimensions.isScaled.height,\n dispatch,\n ])\n\n return (\n
\n {!hidePreviewHeader && (\n
\n

Preview

\n
\n )}\n
\n {/* Error banner - only show when not in Form Builder (when onFrontmatterChange is not provided) */}\n {!onFrontmatterChange && (aiAnalysisResult || formSubmissionError) && (\n
\n \n
\n )}\n
\n {!hideWindowTitlebar && (\n
\n {stripDoubleQuotes(frontmatter.windowTitle || '') || 'Form Window'}\n
\n )}\n
\n {})}\n onCancel={onCancel || (() => {})}\n handleButtonClick={() => {}}\n style={{\n width: '100%',\n maxWidth: '100%',\n margin: 0,\n content: { paddingLeft: '1.5rem', paddingRight: '1.5rem' },\n '--template-form-compact-label-width': frontmatter?.compactLabelWidth || undefined,\n '--template-form-compact-input-width': frontmatter?.compactInputWidth || undefined,\n }}\n allowEmptySubmit={allowEmptySubmit || frontmatter.allowEmptySubmit || false}\n hideDependentItems={frontmatter.hideDependentItems || false}\n folders={folders}\n notes={(notes: any)} // NoteOption array - cast to any to avoid Flow invariant array type issues\n requestFromPlugin={requestFromPlugin}\n keepOpenOnSubmit={keepOpenOnSubmit}\n className=\"template-form\"\n />\n
\n
\n {/* Warning message when preview is scaled - only show in Form Builder (when onFrontmatterChange is provided) */}\n {onFrontmatterChange && isScaled && scaledWarningMessage &&
{scaledWarningMessage}
}\n {/* Dimension display - only show in Form Builder (when onFrontmatterChange is provided) */}\n {onFrontmatterChange && previewWindowDimensions.width > 0 && previewWindowDimensions.height > 0 && (\n
\n \n Preview Dimensions: {previewWindowDimensions.width}x{previewWindowDimensions.height}\n \n {!dimensionsMatch && (\n \n )}\n
\n )}\n
\n
\n )\n}\n\nexport default FormPreview\n" }, { "path": "dwertheimer.Forms/src/components/FormSettings.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// FormSettings Component - Left column showing form configuration settings\n//--------------------------------------------------------------------------\n\nimport React, { useState, type Node } from 'react'\nimport { ProcessingMethodSection } from './ProcessingMethodSection.jsx'\nimport { PositionInput } from './PositionInput.jsx'\nimport { InfoIcon } from '@helpers/react/InfoIcon.jsx'\nimport { type TSettingItem } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\nimport { type NoteOption } from '@helpers/react/DynamicDialog/NoteChooser.jsx'\n\ntype FormSettingsProps = {\n frontmatter: { [key: string]: any },\n onFrontmatterChange: (key: string, value: any) => void,\n notes: Array,\n folders: Array,\n requestFromPlugin: (command: string, data?: any) => Promise,\n onLoadNotes: (forceReload?: boolean, forProcessingTemplates?: boolean) => Promise,\n loadingNotes?: boolean,\n onLoadFolders: (forceReload?: boolean) => Promise,\n templateTitle: string,\n templateFilename?: string,\n showTagInserter: boolean,\n setShowTagInserter: (show: boolean) => void,\n tagInserterInputRef: ?HTMLInputElement | ?HTMLTextAreaElement,\n setTagInserterInputRef: (ref: ?HTMLInputElement | ?HTMLTextAreaElement) => void,\n tagInserterFieldKey: string,\n setTagInserterFieldKey: (key: string) => void,\n tagInserterMode: 'field' | 'date' | 'both',\n setTagInserterMode: (mode: 'field' | 'date' | 'both') => void,\n fields: Array,\n}\n\nexport function FormSettings({\n frontmatter,\n onFrontmatterChange,\n notes,\n folders,\n requestFromPlugin,\n onLoadNotes,\n loadingNotes = false,\n onLoadFolders,\n templateTitle,\n templateFilename = '',\n showTagInserter,\n setShowTagInserter,\n tagInserterInputRef,\n setTagInserterInputRef,\n tagInserterFieldKey,\n setTagInserterFieldKey,\n tagInserterMode,\n setTagInserterMode,\n fields,\n}: FormSettingsProps): Node {\n const [showFormWindowOptions, setShowFormWindowOptions] = useState(false)\n\n return (\n
\n
\n
\n

Form Settings

\n
\n
\n
\n \n onFrontmatterChange('windowTitle', e.target.value)}\n placeholder=\"Form Window\"\n style={{ width: '100%', padding: '0.5rem', marginTop: '0.25rem' }}\n />\n
\n
\n \n onFrontmatterChange('formTitle', e.target.value)}\n placeholder=\"Form Heading\"\n style={{ width: '100%', padding: '0.5rem', marginTop: '0.25rem' }}\n />\n
\n {/* Form Window Options - Collapsible Section */}\n
\n setShowFormWindowOptions(!showFormWindowOptions)}\n >\n \n ▶\n \n \n Form Window Options\n \n \n \n {showFormWindowOptions && (\n
\n
\n \n
\n
\n \n
\n
\n \n
\n
\n
\n \n onFrontmatterChange('width', e.target.value || undefined)}\n onBlur={(e) => {\n const value = e.target.value.trim()\n if (value) {\n const numValue = parseInt(value, 10)\n if (isNaN(numValue) && !value.endsWith('%')) {\n alert('Window width must be a number (e.g., 750) or a percentage (e.g., 50%).')\n onFrontmatterChange('width', undefined)\n } else if (!value.endsWith('%') && numValue < 200) {\n alert('Window width must be at least 200 pixels. Please enter a value of 200 or greater, or use a percentage.')\n onFrontmatterChange('width', undefined)\n }\n }\n }}\n placeholder=\"750 or 50%\"\n style={{ width: '100%', padding: '0.4rem', fontSize: '0.85rem' }}\n />\n
\n
\n \n onFrontmatterChange('height', e.target.value || undefined)}\n onBlur={(e) => {\n const value = e.target.value.trim()\n if (value) {\n const numValue = parseInt(value, 10)\n if (isNaN(numValue) && !value.endsWith('%')) {\n alert('Window height must be a number (e.g., 750) or a percentage (e.g., 50%).')\n onFrontmatterChange('height', undefined)\n } else if (!value.endsWith('%') && numValue < 200) {\n alert('Window height must be at least 200 pixels. Please enter a value of 200 or greater, or use a percentage.')\n onFrontmatterChange('height', undefined)\n }\n }\n }}\n placeholder=\"750 or 50%\"\n style={{ width: '100%', padding: '0.4rem', fontSize: '0.85rem' }}\n />\n
\n
\n \n
\n onFrontmatterChange('x', value)} placeholder=\"center, left, right, or 25%\" />\n
\n
\n
\n \n
\n onFrontmatterChange('y', value)} placeholder=\"center, top, bottom, or 25%\" />\n
\n
\n
\n
\n Use pixels (e.g., 750) or percentages (e.g., 50%). Minimum Width x Height is 200 x 200 pixels. For position, use predefined choices (center, left, right, top,\n bottom) or enter a number/percentage. Leave empty to use defaults.\n
\n
\n
\n
\n \n
\n
\n
\n \n onFrontmatterChange('compactLabelWidth', e.target.value || undefined)}\n onBlur={(e) => {\n const value = e.target.value.trim()\n if (value) {\n // Validate CSS width value (rem, em, px, %, vw, vh, or calc())\n const cssWidthPattern = /^(\\d+(\\.\\d+)?(rem|em|px|%|vw|vh)|calc\\(.+\\))$/i\n if (!cssWidthPattern.test(value)) {\n alert('Label width must be a valid CSS width value (e.g., 10rem, 12em, 150px, 20%, or calc(10rem + 2px)).')\n onFrontmatterChange('compactLabelWidth', undefined)\n }\n }\n }}\n placeholder=\"20rem (default)\"\n style={{ width: '100%', padding: '0.4rem', fontSize: '0.85rem' }}\n />\n
\n
\n \n onFrontmatterChange('compactInputWidth', e.target.value || undefined)}\n onBlur={(e) => {\n const value = e.target.value.trim()\n if (value) {\n // Validate CSS width value (rem, em, px, %, vw, vh, or calc())\n const cssWidthPattern = /^(\\d+(\\.\\d+)?(rem|em|px|%|vw|vh)|calc\\(.+\\))$/i\n if (!cssWidthPattern.test(value)) {\n alert('Input width must be a valid CSS width value (e.g., 180px, 12rem, 20%, or calc(180px + 2rem)).')\n onFrontmatterChange('compactInputWidth', undefined)\n }\n }\n }}\n placeholder=\"180px (default)\"\n style={{ width: '100%', padding: '0.4rem', fontSize: '0.85rem' }}\n />\n
\n
\n
\n Use CSS units like '20rem' or '24em' for labels, and '360px' or '400px' for inputs. Labels are right-aligned and inputs are left-aligned in compact mode. Leave empty to use defaults.\n
\n
\n
\n
\n \n onFrontmatterChange('customCSS', e.target.value)}\n placeholder=\"/* Enter custom CSS for this form */ .dynamic-dialog { /* Your styles here */ }\"\n rows={8}\n style={{\n width: '100%',\n padding: '0.5rem',\n fontFamily: 'Menlo, Monaco, \"Courier New\", monospace',\n fontSize: '0.85rem',\n lineHeight: '1.4',\n resize: 'vertical',\n marginTop: '0.25rem',\n }}\n />\n
\n Custom CSS will be saved in a template:ignore customCSS codeblock and injected into the form window when opened.\n
\n
\n Override Input Width: To change the width of all input fields on this form, add:\n
\n \n .dynamic-dialog-content {'{'} --dynamic-dialog-input-width: 250px; {'}'}\n \n Replace 250px with your desired width.\n
\n
\n
\n )}\n
\n \n
\n
\n
\n )\n}\n\nexport default FormSettings\n" }, { "path": "dwertheimer.Forms/src/components/FormView.css", "content": "/* Dynamic Dialog Styles */\n.dynamic-dialog.form-view {\n width: 90vw !important;\n height: 90vh !important;\n}\n\n/* Template Form Dialog Centering - apply same centering logic as DynamicDialog.css */\n/* Only apply centering if no explicit x,y positioning is set via inline styles */\n.dynamic-dialog.template-form {\n\n /* set the text color of the dialog to the main color */\n color: var(--fg-main-color);\n & input, & textarea, & select {\n color: var(--fg-main-color);\n }\n\n /* Ensure proper vertical centering - same as DynamicDialog.css */\n /* Center vertically: position top edge at viewport center + toolbar offset, then translateY(-50%) centers it */\n /* Account for toolbar offset: center of available space = 50vh + toolbar-height/2 */\n top: calc(50vh + var(--noteplan-toolbar-height, 0px) / 2) !important;\n /* Horizontal centering */\n left: 50% !important;\n /* Center both horizontally and vertically */\n transform: translate(-50%, -50%) !important;\n /* Override any conflicting margins */\n margin: 0 !important;\n\n /* CSS Variables for template form compact mode sizing */\n /* These can be overridden via inline styles or form-specific CSS */\n --template-form-compact-label-width: 10rem; /* Default label width - can be overridden */\n --template-form-compact-input-width: 360px; /* Default input width - can be overridden (2x previous default) */\n\n /* Template Form Specific Styles */\n & .ui-button-group {\n justify-content: normal;\n }\n\n /* For template forms, ensure all compact labels are right-aligned with consistent width */\n /* This ensures all labels line up vertically in compact mode */\n /* Override the min-width: fit-content rule from DynamicDialog.css and SearchableChooser.css */\n & .input-box-container-compact .input-box-label,\n & [class*=\"-chooser-container\"].compact [class*=\"-chooser-label\"],\n & [class*=\"-chooser-container\"].compact label,\n & [class*=\"-chooser-label-compact\"],\n & .contained-multi-select-label-compact,\n & .contained-multi-select-container.compact label,\n & .searchable-chooser-base.compact [class*=\"-chooser-label\"],\n & .searchable-chooser-base.compact label,\n & .searchable-chooser-base.compact > label,\n & .expandable-textarea-container.compact .expandable-textarea-label,\n & .autosave-field-container.compact .autosave-field-label {\n text-align: right !important;\n min-width: var(--template-form-compact-label-width, 20rem) !important;\n max-width: var(--template-form-compact-label-width, 20rem) !important;\n width: var(--template-form-compact-label-width, 20rem) !important;\n padding-right: 1rem !important;\n padding-left: 0 !important;\n margin-left: 0 !important;\n margin-right: 0 !important;\n box-sizing: border-box !important;\n flex-shrink: 0 !important;\n flex-grow: 0 !important;\n margin-bottom: 0 !important;\n align-self: center !important;\n white-space: nowrap !important;\n overflow: hidden !important;\n text-overflow: ellipsis !important;\n order: -1 !important; /* Ensure labels come first in flex container */\n display: block !important; /* Override any inline-flex or other display values */\n }\n\n /* Ensure the compact container itself uses flex to align labels */\n /* Also target nested containers to remove all left spacing */\n & .input-box-container-compact,\n & [class*=\"-chooser-container\"].compact,\n & .searchable-chooser-base.compact,\n & .expandable-textarea-container.compact,\n & .autosave-field-container.compact,\n & [class*=\"-chooser-container\"].compact [class*=\"-chooser-container\"].compact,\n & [class*=\"-chooser-container\"].compact .searchable-chooser-base,\n & [data-field-type] [class*=\"-chooser-container\"].compact,\n & [data-field-type] .searchable-chooser-base.compact {\n display: flex !important;\n align-items: center !important;\n gap: .5rem !important;\n padding-left: 0 !important;\n margin-left: 0 !important;\n }\n\n /* Ensure parent containers don't add extra spacing that misaligns labels */\n & .ui-item,\n & .dynamic-dialog-item {\n padding-left: 0 !important;\n margin-left: 0 !important;\n }\n\n /* Ensure all compact field containers start at the same horizontal position */\n /* Target all nested wrapper divs to remove any spacing */\n & .ui-item > .input-box-container-compact,\n & .ui-item > [class*=\"-chooser-container\"].compact,\n & .ui-item > .searchable-chooser-base.compact,\n & .ui-item > .expandable-textarea-container.compact,\n & .ui-item > .autosave-field-container.compact,\n & .ui-item > div > .input-box-container-compact,\n & .ui-item > div > [class*=\"-chooser-container\"].compact,\n & .ui-item > div > .searchable-chooser-base.compact,\n & .ui-item [data-field-type] > [class*=\"-chooser-container\"].compact,\n & .ui-item [data-field-type] > .searchable-chooser-base.compact,\n & [class*=\"-chooser-container\"].compact [class*=\"-chooser-container\"].compact,\n & [class*=\"-chooser-container\"].compact .searchable-chooser-base {\n margin-left: 0 !important;\n padding-left: 0 !important;\n }\n\n /* Ensure labels are positioned at exactly the same left edge by removing any margin/padding */\n /* Also ensure any wrapper divs don't add spacing */\n & .input-box-container-compact .input-box-label,\n & [class*=\"-chooser-container\"].compact [class*=\"-chooser-label\"],\n & [class*=\"-chooser-container\"].compact label,\n & [class*=\"-chooser-label-compact\"],\n & .contained-multi-select-label-compact,\n & .contained-multi-select-container.compact label,\n & .searchable-chooser-base.compact [class*=\"-chooser-label\"],\n & .searchable-chooser-base.compact label,\n & .expandable-textarea-container.compact .expandable-textarea-label,\n & .autosave-field-container.compact .autosave-field-label,\n & .input-box-container-compact > div:first-child.input-box-label {\n margin-left: 0 !important;\n padding-left: 0 !important;\n margin-right: 0 !important;\n }\n\n /* Target nested wrapper divs that contain compact fields - remove all left spacing and ensure consistent bottom spacing */\n /* Target the outer data-field-type wrapper and its direct children when they contain compact fields */\n & [data-field-type=\"dropdown-select\"],\n & [data-field-type=\"folder-chooser\"],\n & [data-field-type=\"note-chooser\"],\n & [data-field-type=\"space-chooser\"],\n & [data-field-type=\"heading-chooser\"],\n & [data-field-type=\"event-chooser\"],\n & [data-field-type=\"tag-chooser\"],\n & [data-field-type=\"mention-chooser\"],\n & [data-field-type=\"frontmatter-key-chooser\"] {\n padding-left: 0 !important;\n margin-left: 0 !important;\n margin-bottom: 0 !important; /* Ensure consistent spacing - spacing is handled by .dynamic-dialog-item gap */\n }\n\n & [data-field-type] > div[class*=\"-chooser-container\"],\n & [data-field-type] > div[class*=\"-chooser-container\"] > div {\n padding-left: 0 !important;\n margin-left: 0 !important;\n margin-bottom: 0 !important; /* Ensure consistent spacing - spacing is handled by .dynamic-dialog-item gap */\n }\n\n /* Ensure all field wrapper divs have consistent spacing */\n /* Spacing between fields is handled by .dynamic-dialog-content gap, not individual field margins */\n & .ui-item,\n & [data-field-type],\n & .input-box-container,\n & .input-box-container-compact,\n & [class*=\"-chooser-container\"],\n & .searchable-chooser-base,\n & .folder-chooser-wrapper,\n & .folder-chooser-wrapper-compact,\n & .dropdown-select-chooser-container {\n margin-top: 0 !important;\n margin-bottom: 0 !important;\n }\n\n /* Use CSS variable for input field widths in template forms */\n /* This allows both labels and inputs to align their right edges */\n /* Cover all field types: InputBox, SearchableChooser, ThemedSelect, ExpandableTextarea, CalendarPicker, AutosaveField */\n & .input-box-container-compact .input-box-wrapper,\n & .input-box-container-compact .input-box-input,\n & [class*=\"-chooser-container\"].compact [class*=\"-chooser-input-wrapper\"],\n & .searchable-chooser-base.compact [class*=\"-chooser-input-wrapper\"],\n & .input-box-container-compact .input-box-wrapper > div, /* ThemedSelect react-select container */\n & .input-box-container-compact .input-box-wrapper .react-select__control,\n & .expandable-textarea-container.compact .expandable-textarea-input,\n & .calendarpicker-container.compact .calendarpicker-input-wrapper,\n & .autosave-field-container.compact .autosave-field-input-wrapper,\n & .autosave-field-container.compact .autosave-field-input {\n width: var(--template-form-compact-input-width, 300px) !important;\n min-width: var(--template-form-compact-input-width, 300px) !important;\n max-width: var(--template-form-compact-input-width, 300px) !important;\n }\n\n /* Override item-description margin-left in compact mode to align with input field values */\n /* Uses label width (CSS variable) + gap (1rem) to align with the start of input field values */\n & [data-compact-display=\"true\"] .item-description {\n margin-left: calc(var(--template-form-compact-label-width, 20rem) + 1rem) !important;\n }\n}\n\n/* Form View Styles */\n.form-view {\n label {\n font-size: 1.4rem;\n font-weight: 700;\n }\n\n .input-box-input {\n width: 50vw; \n }\n\n .dayPicker-container {\n margin-left: 1rem;\n }\n\n .rdp-caption_label {\n font-size: 1.4rem;\n font-weight: 600;\n }\n\n .input-box-container-compact {\n justify-content: flex-start !important;\n }\n\n /* Dialog Styles */\n dialog {\n /* Unset the margin around it, to allow absolute positioning by left/top */\n display: block;\n margin: 0rem 0.5rem;\n color: var(--fg-sidebar-color);\n background: var(--bg-sidebar-color);\n padding: 0rem;\n border: solid 1px var(--divider-color);\n border-radius: 0.5em;\n box-shadow: 0px 0px 10px 2px rgba(0 0 0 / 0.4);\n z-index: 50;\n max-width: 98%;\n }\n\n dialog:modal {\n max-width: 92%;\n }\n\n /* Calendar Picker Custom Styles */\n calendarPickerCustom {\n padding-left: 10px;\n }\n\n /* Dialog Title Styles */\n .dialogTitle {\n display: grid;\n background: var(--bg-alt-color);\n padding-block-start: 0.4rem;\n padding-inline-start: 0.6rem;\n padding-inline-end: 0.5rem;\n padding-block-end: 0.3rem;\n border-block-end: 1px solid var(--divider-color);\n /* margin-block-end: 4px; */\n border-radius: 0.5rem 0.5rem 0px 0px;\n /* mimic the dialog border radius only at the top */\n grid-template-columns: max-content auto max-content;\n /* vertically align content items in center */\n align-items: center;\n /* gap: 0.5rem; */\n }\n\n /* icons in title */\n .dialogTitle i {\n color: var(--tint-color);\n }\n\n .dialogTitle div:nth-last-child(1) {\n /* Put very last div (Close button etc.) on RHS */\n justify-self: end;\n /* margin-bottom: 5px; */\n }\n\n /* Dialog Item Note Styles */\n .dialogItemNote {\n font-weight: 600;\n }\n\n .dialogItemNoteType {\n font-weight: 400;\n }\n\n /* Dialog Body Styles */\n .dialogBody {\n padding-block-start: 0.3rem;\n padding-inline-start: 0.5rem;\n padding-inline-end: 0.5rem;\n padding-block-end: 0.6rem;\n }\n\n /* Button Grid Styles */\n .buttonGrid {\n display: grid;\n grid-template-columns: auto minmax(15rem, auto);\n column-gap: 0.3rem;\n row-gap: 0.2rem;\n /* vertically align content items in center */\n align-items: center;\n }\n\n /* Tweak the first column labels */\n .buttonGrid div.preText {\n align-self: self-start;\n padding-block-start: 5px;\n justify-self: end;\n /* margin-top: 5px; */\n }\n\n /* Put very last div (Close button) on RHS -- no longer used */\n /* .buttonGrid div:nth-last-child(1) {\n justify-self: end;\n} */\n\n /* .buttonGrid div:nth-child(1) { */\n /* Put very first div down a bit to try to align with input field */\n /* padding-block-start: 6px; */\n /* } */\n\n /* for Dialog main buttons: a little more pronounced */\n .mainButton {\n color: var(--tint-color);\n background-color: var(--bg-alt-color);\n font-size: 0.9rem;\n font-weight: 600;\n border: 1px solid var(--divider-color);\n padding: 2px 5px 2px 5px;\n margin: 2px 4px;\n }\n\n .dialogBody button {\n font-size: 0.85rem;\n font-weight: 400;\n /* add a clearer border to buttons */\n /* border: 1px solid rgb(from var(--fg-main-color) r g b / 0.7); */\n border: 1px solid var(--divider-color);\n border-radius: 4px;\n padding: 1px 4px 0px 4px;\n /* have margin to the right+top+bottom of buttons */\n margin: 0.2rem 0.3rem 0.2rem 0;\n /* 3px 4px 3px 0px; */\n }\n\n /* set FontAwesome icon colour to tint color */\n .dialogBody button i {\n color: var(--tint-color);\n }\n\n /* Item Actions Dialog Styles */\n .itemActionsDialog {\n max-width: 32rem;\n }\n\n /* Full Text Input Styles */\n .fullTextInput {\n width: -webkit-fill-available;\n /* calc(100% - 3rem); */\n font-size: 0.9rem;\n font-weight: 600;\n padding: 1px 4px 1px 4px;\n border: 1px solid var(--divider-color);\n border-radius: 4px;\n /* margin-left: 0.3rem; */\n margin-right: 0.3rem;\n }\n\n /* for iphone, allow the text to wrap */\n .fullTextArea {\n box-sizing: border-box;\n /* Include padding and border in the element's total width and height */\n width: 100%;\n /* Adjust the width as needed */\n min-height: 50px;\n /* Minimum height */\n max-height: 500px;\n /* Maximum height */\n overflow-y: hidden;\n /* Hide vertical scrollbar */\n resize: none;\n /* Prevent manual resizing */\n padding: 10px;\n /* Adjust padding as needed */\n border: 1px solid #ccc;\n /* Border styling */\n border-radius: 4px;\n /* Rounded corners */\n white-space: pre-wrap;\n /* Preserve white spaces */\n word-wrap: break-word;\n /* Break long words */\n outline: none;\n /* Remove default outline */\n }\n\n .fullTextArea .placeholder {\n color: #aaa;\n pointer-events: none;\n /* Prevent placeholder text from being selectable */\n }\n\n /* Child Details Styles */\n .childDetails {\n font-size: 0.9rem;\n padding-left: 0.5rem;\n }\n\n /* Close Button Styles */\n .closeButton {\n font-size: unset;\n color: var(--tint-color);\n background-color: transparent;\n border: none;\n box-shadow: none;\n /* margin-right: 5px; */\n outline: none;\n padding-top: 3px;\n }\n\n /* Skip Button Styles */\n .skip-button {\n font-size: unset;\n background-color: transparent;\n border: none;\n /* outline: none; -- requested by DBW but not good for accessibility? */\n box-shadow: none;\n margin-right: 0px;\n }\n\n /* Interactive Processing Status Styles */\n .interactive-processing-status {\n margin-right: 5px;\n margin-top: 2px;\n }\n\n /* iOS devices require an override for font size, otherwise it does a nasty zoom in effect \n * discovered via https://stackoverflow.com/questions/68973232/how-to-handle-safari-ios-zoom-on-input-fields/69125139#69125139\n * PS Apple says user-scalable, min-scale and max-scale settings are ignored: https://webkit.org/blog/7367/new-interaction-behaviors-in-ios-10/ \n*/\n @media screen and (width <=420px) {\n .fullTextInput {\n font-size: 11pt;\n }\n }\n\n /* @media screen and (width <= 420px) {\n dialog:modal {\n max-width: 90%;\n left: 5%;\n }\n} */\n\n /* Override items from main Dashboard.css for slightly different context this is used */\n .projectIcon {\n margin-block-start: 3px !important;\n }\n\n /* Style for combobox-container */\n .combobox-container {\n display: flex;\n flex-direction: column;\n padding-top: 1px;\n }\n\n /* Style for combobox-container (compact version) */\n .combobox-container-compact {\n display: flex;\n flex-direction: row;\n align-items: baseline;\n gap: 0.4rem;\n padding-top: 1px;\n }\n\n /* Combobox Wrapper Styles */\n .combobox-wrapper {\n display: flex;\n align-items: end;\n gap: 10px;\n position: relative;\n width: fit-content;\n }\n\n /* Combobox Label Styles */\n .combobox-label {\n font-weight: 700;\n color: var(--fg-alt-color);\n }\n\n /* Combobox Input Styles */\n .combobox-input {\n flex: 1;\n padding: 3px 6px 1px;\n border-radius: 4px;\n font-size: 0.9rem;\n /* width: 100%; */\n }\n\n .combobox-input:focus {\n border-color: var(--hashtag-color);\n outline: none;\n box-shadow: 0 0 3px var(--hashtag-color);\n }\n\n /* Combobox Arrow Styles */\n .combobox-arrow {\n position: absolute;\n right: 0.4rem;\n pointer-events: none;\n font-size: larger;\n color: var(--tint-color);\n align-self: center;\n top: 50%;\n transform: translateY(-50%);\n }\n\n /* Combobox Dropdown Styles */\n .combobox-dropdown {\n position: absolute;\n top: 100%;\n left: 0;\n right: 0;\n border: 1px solid var(--divider-color);\n border-radius: 4px;\n background-color: color(var(--tint-color) lightness(-20%));\n /* background-color: hsl(from var(--bg-sidebar-color) h s calc(l*1.4)); TODO: restore this in the future */\n box-shadow: 0 2px 5px var(--divider-color);\n z-index: 5;\n width: 100%;\n }\n\n /* Combobox Option Styles */\n .combobox-option {\n cursor: pointer;\n color: var(--fg-main-color);\n padding: 0.2rem 0rem 0.2rem 0.4rem;\n min-height: 0.9rem;\n width: 100%;\n }\n\n .combobox-option:hover {\n background-color: var(--bg-alt-color);\n color: var(--fg-alt-color);\n }\n\n .combobox-option .option-label {\n white-space: nowrap;\n }\n\n /* Combobox Input Container Styles */\n .combobox-input-container {\n position: relative;\n width: 100%;\n }\n}\n\n/* AI Analysis Error Warning Styles */\n.form-ai-analysis-error {\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n z-index: 1000;\n padding: 1rem;\n margin: 0;\n background-color: #fff3cd;\n color: #856404;\n border: 1px solid #ffc107;\n border-top: none;\n border-radius: 0 0 4px 4px;\n font-size: 0.9rem;\n max-height: 40vh;\n overflow-y: auto;\n overflow-x: hidden;\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);\n box-sizing: border-box;\n width: 100%;\n}\n\n.form-ai-analysis-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n margin-bottom: 0.5rem;\n gap: 1rem;\n}\n\n.form-ai-analysis-title {\n font-weight: bold;\n font-size: 1rem;\n flex: 1;\n word-wrap: break-word;\n}\n\n.form-ai-analysis-close {\n background: transparent;\n border: none;\n color: #856404;\n font-size: 1.5rem;\n font-weight: bold;\n cursor: pointer;\n padding: 0 0.5rem;\n line-height: 1;\n flex-shrink: 0;\n transition: color 0.2s;\n}\n\n.form-ai-analysis-close:hover {\n color: #856404;\n opacity: 0.7;\n}\n\n.form-ai-analysis-content {\n word-wrap: break-word;\n overflow-wrap: break-word;\n max-width: 100%;\n box-sizing: border-box;\n}\n\n.form-ai-analysis-content * {\n max-width: 100%;\n word-wrap: break-word;\n overflow-wrap: break-word;\n}\n\n.form-ai-analysis-content pre,\n.form-ai-analysis-content code {\n white-space: pre-wrap;\n word-wrap: break-word;\n overflow-wrap: break-word;\n}\n\n/* Form Submitting Overlay */\n/* Positioned at root level to appear above all content including modals */\n.form-submitting-overlay {\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n background-color: rgba(0, 0, 0, 0.6); /* Slightly darker for better visibility */\n display: flex;\n align-items: center;\n justify-content: center;\n z-index: 99999 !important; /* Very high z-index to appear above everything (modals are 100-101) */\n pointer-events: auto; /* Block all interactions during submission */\n}\n\n.form-submitting-message {\n background-color: var(--tint-color, #007aff);\n color: white;\n padding: 1.5rem 2.5rem;\n border-radius: 12px;\n font-size: 1.2rem;\n font-weight: 600;\n box-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);\n animation: pulse 2s ease-in-out infinite;\n text-align: center;\n pointer-events: auto; /* Make message interactive (though not needed) */\n min-width: 250px;\n max-width: 90vw;\n}\n\n.form-submitting-message > div {\n display: block;\n line-height: 1.5;\n}\n\n@keyframes pulse {\n 0%, 100% {\n opacity: 1;\n }\n 50% {\n opacity: 0.8;\n }\n}\n" }, { "path": "dwertheimer.Forms/src/components/FormView.jsx", "content": "/****************************************************************************************************************************\n * WEBVIEW COMPONENT\n * This is your top-level React component. All other React components should be imported and included below\n ****************************************************************************************************************************/\n// @flow\n\n/**\n * IMPORTANT\n * YOU MUST ROLL UP THESE FILES INTO A SINGLE FILE IN ORDER TO USE IT IN THE PLUGIN\n * RUN FROM THE SHELL: node 'np.Shared/src/react/support/performRollup.node.js' --watch\n */\n\ntype Props = {\n data: any /* passed in from the plugin as globalSharedData */,\n dispatch: Function,\n reactSettings: any,\n setReactSettings: Function,\n onSubmitOrCancelCallFunctionNamed: string,\n}\n/****************************************************************************************************************************\n * NOTES\n * WebView should act as a \"controlled component\", as far as the data from the plugin is concerned.\n * Plugin-related data is always passed in via props, and never stored in state in this component\n *\n * FYI, if you do use state, it is highly recommended when setting state with hooks to use the functional form of setState\n * e.g. setTodos((prevTodos) => [...prevTodos, newTodo]) rather than setTodos([...todos, newTodo])\n * This has cost me a lot of time in debugging stale state issues\n */\n\n/****************************************************************************************************************************\n * IMPORTS\n ****************************************************************************************************************************/\n\nimport React, { useEffect, useRef, useState, useCallback, useMemo, type Node } from 'react'\nimport { createPortal } from 'react-dom'\nimport { type PassedData } from '../shared/types.js'\nimport { AppProvider } from './AppContext.jsx'\nimport FormErrorBanner from './FormErrorBanner.jsx'\nimport DynamicDialog from '@helpers/react/DynamicDialog'\nimport { type NoteOption } from '@helpers/react/DynamicDialog/NoteChooser.jsx'\nimport { clo, logDebug, logError } from '@helpers/react/reactDev.js'\nimport { pluginEnvelopeFromResponsePayload, unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\nimport './FormView.css'\n\n/** Commands that load data for choosers; suppressed during submit to avoid storm of REQUESTS that can cause freeze */\nconst DATA_LOAD_COMMANDS = ['getFolders', 'getTeamspaces', 'getNotes', 'getHashtags', 'getMentions', 'getEvents', 'getFrontmatterKeyValues']\n\n/****************************************************************************************************************************\n * CONSOLE LOGGING\n ****************************************************************************************************************************/\n/**\n * Root element for the Plugin's React Tree\n * @param {any} data\n * @param {Function} dispatch - function to send data back to the Root Component and plugin\n * NOTE: Even though we have named this FormView.jsx, it is exported as WebView because that is what Root expects to load dynamically\n */\nexport function FormView({ data, dispatch, reactSettings, setReactSettings, onSubmitOrCancelCallFunctionNamed = 'onSubmitClick' }: Props): Node {\n /****************************************************************************************************************************\n * HOOKS\n ****************************************************************************************************************************/\n\n // GENERALLY SPEAKING YOU DO NOT WANT TO USE STATE HOOKS IN THE WEBVIEW COMPONENT\n // because the plugin may need to know what changes were made so when it updates data, it will be consistent\n // otherwise when the plugin updates data, it will overwrite any changes made locally in the Webview\n // instead of using hooks here, save updates to data using:\n // dispatch('UPDATE_DATA', {...data,changesToData})\n // this will save the data at the Root React Component level, which will give the plugin access to this data also\n // sending this dispatch will re-render the Webview component with the new data\n\n /****************************************************************************************************************************\n * VARIABLES\n ****************************************************************************************************************************/\n\n // destructure all the startup data we expect from the plugin\n const { pluginData } = data\n const formFields = pluginData.formFields || []\n\n // Map to store pending requests for request/response pattern\n // Key: correlationId, Value: { resolve, reject, timeoutId }\n const pendingRequestsRef = useRef void, reject: (error: Error) => void, timeoutId: any }>>(new Map())\n\n /** When true, requestFromPlugin skips data-load commands (getFolders, getNotes, etc.) to avoid storm of REQUESTS during submit that can cause freeze */\n const suppressDataRequestsRef = useRef(false)\n\n // State for dynamically loaded folders and notes (loaded on demand, or pre-loaded from pluginData if available)\n // Check if preloaded data exists in pluginData (for static HTML testing with preloadChooserData: true)\n const [folders, setFolders] = useState>(() => {\n // Initialize from preloaded data if available\n const preloadedFolders = pluginData?.folders\n if (Array.isArray(preloadedFolders) && preloadedFolders.length > 0) {\n logDebug('FormView', `Using preloaded folders: ${preloadedFolders.length} folders`)\n return preloadedFolders\n }\n logDebug('FormView', `No preloaded folders found, will load dynamically (folders type: ${typeof preloadedFolders}, length: ${preloadedFolders?.length || 0})`)\n return []\n })\n const [notes, setNotes] = useState>(() => {\n // Initialize from preloaded data if available\n const preloadedNotes = pluginData?.notes\n if (Array.isArray(preloadedNotes) && preloadedNotes.length > 0) {\n logDebug('FormView', `Using preloaded notes: ${preloadedNotes.length} notes`)\n return preloadedNotes\n }\n logDebug('FormView', `No preloaded notes found, will load dynamically (notes type: ${typeof preloadedNotes}, length: ${preloadedNotes?.length || 0})`)\n return []\n })\n // Check if preloaded data exists (for setting loaded flags)\n const hasPreloadedFolders = Array.isArray(pluginData?.folders) && pluginData.folders.length > 0\n const hasPreloadedNotes = Array.isArray(pluginData?.notes) && pluginData.notes.length > 0\n const [foldersLoaded, setFoldersLoaded] = useState(hasPreloadedFolders) // If preloaded, mark as loaded\n const [notesLoaded, setNotesLoaded] = useState(hasPreloadedNotes) // If preloaded, mark as loaded\n const [loadingFolders, setLoadingFolders] = useState(false)\n const [loadingNotes, setLoadingNotes] = useState(false)\n\n // Check if form has folder-chooser or note-chooser fields\n const needsFolders = useMemo(() => formFields.some((field) => field.type === 'folder-chooser'), [formFields])\n const needsNotes = useMemo(() => formFields.some((field) => field.type === 'note-chooser'), [formFields])\n\n // Stabilize defaultValues and preloaded* props so DynamicDialog's useEffect (add missing keys)\n // does not re-run on every render. Passing new {} or [] every time causes infinite loops with preloaded content.\n const defaultValuesStable = useMemo(\n () => pluginData?.defaultValues ?? {},\n [pluginData?.defaultValues == null ? '' : JSON.stringify(pluginData.defaultValues)],\n )\n const preloadedTeamspacesStable = useMemo(\n () => pluginData?.preloadedTeamspaces ?? [],\n [pluginData?.preloadedTeamspaces == null ? '' : JSON.stringify(pluginData.preloadedTeamspaces)],\n )\n const preloadedMentionsStable = useMemo(\n () => pluginData?.preloadedMentions ?? [],\n [pluginData?.preloadedMentions == null ? '' : JSON.stringify(pluginData.preloadedMentions)],\n )\n const preloadedHashtagsStable = useMemo(\n () => pluginData?.preloadedHashtags ?? [],\n [pluginData?.preloadedHashtags == null ? '' : JSON.stringify(pluginData.preloadedHashtags)],\n )\n const preloadedEventsStable = useMemo(\n () => pluginData?.preloadedEvents ?? [],\n [pluginData?.preloadedEvents == null ? '' : JSON.stringify(pluginData.preloadedEvents)],\n )\n const preloadedFrontmatterValuesStable = useMemo(\n () => pluginData?.preloadedFrontmatterValues ?? {},\n [pluginData?.preloadedFrontmatterValues == null ? '' : JSON.stringify(pluginData.preloadedFrontmatterValues)],\n )\n\n /**\n * Request data from the plugin using request/response pattern\n * Returns a Promise that resolves with the response data or rejects with an error\n * Memoized with useCallback to prevent infinite loops in child components\n * @param {string} command - The command/request type (e.g., 'getFolders', 'getNotes')\n * @param {any} dataToSend - Request parameters\n * @param {number} timeout - Timeout in milliseconds (default: 10000)\n * @returns {Promise}\n */\n const requestFromPlugin = useCallback(\n (command: string, dataToSend: any = {}, timeout: number = 10000): Promise => {\n if (!command) throw new Error('requestFromPlugin: command must be called with a string')\n\n // During submit, skip data-load requests so fields don't storm the bridge and cause freeze\n if (suppressDataRequestsRef.current && DATA_LOAD_COMMANDS.includes(command)) {\n logDebug('FormView', `[DIAG] requestFromPlugin SKIP (submitting): command=\"${command}\"`)\n if (!Promise.resolve) {\n logError('FormView', `[DIAG] Promise.resolve is not defined, this is a critical error`)\n throw new Error('Promise.resolve is not defined, this is a critical error')\n }\n return Promise.resolve([])\n }\n\n const correlationId = `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n const requestStartTime = performance.now()\n const pendingCount = pendingRequestsRef.current.size\n\n logDebug('FormView', `[DIAG] requestFromPlugin START: command=\"${command}\", correlationId=\"${correlationId}\", pendingRequests=${pendingCount}`)\n\n return new Promise((resolve, reject) => {\n const timeoutId = setTimeout(() => {\n // CRITICAL: Check if component is still mounted before accessing refs and rejecting\n if (!isMountedRef.current) {\n logDebug('FormView', `[DIAG] requestFromPlugin TIMEOUT skipped - component unmounted: command=\"${command}\", correlationId=\"${correlationId}\"`)\n return\n }\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n pendingRequestsRef.current.delete(correlationId)\n const elapsed = performance.now() - requestStartTime\n logDebug('FormView', `[DIAG] requestFromPlugin TIMEOUT: command=\"${command}\", correlationId=\"${correlationId}\", elapsed=${elapsed.toFixed(2)}ms`)\n reject(new Error(`Request timeout: ${command}`))\n }\n }, timeout)\n\n pendingRequestsRef.current.set(correlationId, { resolve, reject, timeoutId })\n\n // Use requestAnimationFrame to yield to browser before dispatching\n requestAnimationFrame(() => {\n const dispatchElapsed = performance.now() - requestStartTime\n logDebug(\n 'FormView',\n `[DIAG] requestFromPlugin DISPATCH: command=\"${command}\", correlationId=\"${correlationId}\", pendingRequests=${\n pendingRequestsRef.current.size\n }, dispatchElapsed=${dispatchElapsed.toFixed(2)}ms`,\n )\n\n const requestData = {\n ...dataToSend,\n __correlationId: correlationId,\n __requestType: 'REQUEST',\n __windowId: pluginData?.windowId || '', // Include windowId in request for reliable response routing\n }\n\n // Dispatch the request\n requestAnimationFrame(() => {\n const dispatchAfterRAFElapsed = performance.now() - requestStartTime\n logDebug(\n 'FormView',\n `[DIAG] requestFromPlugin DISPATCH AFTER RAF: command=\"${command}\", correlationId=\"${correlationId}\", dispatchElapsed=${dispatchAfterRAFElapsed.toFixed(2)}ms`,\n )\n dispatch('SEND_TO_PLUGIN', [command, requestData], `WebView: requestFromPlugin: ${String(command)}`)\n })\n })\n })\n .then((result) => {\n const elapsed = performance.now() - requestStartTime\n logDebug(\n 'FormView',\n `[DIAG] requestFromPlugin RESOLVED: command=\"${command}\", correlationId=\"${correlationId}\", elapsed=${elapsed.toFixed(2)}ms, pendingRequests=${\n pendingRequestsRef.current.size\n }`,\n )\n return result\n })\n .catch((error) => {\n const elapsed = performance.now() - requestStartTime\n logDebug(\n 'FormView',\n `[DIAG] requestFromPlugin REJECTED: command=\"${command}\", correlationId=\"${correlationId}\", elapsed=${elapsed.toFixed(2)}ms, error=\"${\n error.message\n }\", pendingRequests=${pendingRequestsRef.current.size}`,\n )\n throw error\n })\n },\n [dispatch, pluginData?.windowId],\n ) // Memoize to prevent infinite loops - only recreate if dispatch or windowId changes\n\n // Load folders on demand when needed (matching FormBuilder pattern)\n // Always load all folders (space: null) so folder-choosers with space dependencies can filter client-side\n const loadFolders = useCallback(async () => {\n if (foldersLoaded || loadingFolders || !needsFolders) return\n\n try {\n setLoadingFolders(true)\n logDebug('FormView', 'Loading folders on demand... (all spaces)')\n // requestFromPlugin resolves with PluginRequestEnvelope; unwrap throws on handler failure\n const foldersData = unwrapPluginRequestData(await requestFromPlugin('getFolders', { excludeTrash: true, space: null }))\n if (Array.isArray(foldersData)) {\n setFolders(foldersData)\n setFoldersLoaded(true)\n logDebug('FormView', `Loaded ${foldersData.length} folders (all spaces)`)\n } else {\n logError('FormView', `Failed to load folders: Invalid response format`)\n setFoldersLoaded(true) // Set to true to prevent infinite retries\n }\n } catch (error) {\n logError('FormView', `Error loading folders: ${error.message}`)\n setFoldersLoaded(true) // Set to true to prevent infinite retries\n } finally {\n setLoadingFolders(false)\n }\n }, [foldersLoaded, loadingFolders, needsFolders, requestFromPlugin])\n\n // Reload folders (used after creating a new folder)\n // Always load all folders (space: null) so folder-choosers with space dependencies can filter client-side\n const reloadFolders = useCallback(async () => {\n try {\n setLoadingFolders(true)\n setFoldersLoaded(false) // Reset to allow reload\n logDebug('FormView', 'Reloading folders after folder creation... (all spaces)')\n // Pass space: null to get all folders from all spaces\n const foldersData = unwrapPluginRequestData(await requestFromPlugin('getFolders', { excludeTrash: true, space: null }))\n if (Array.isArray(foldersData)) {\n setFolders(foldersData)\n setFoldersLoaded(true)\n logDebug('FormView', `Reloaded ${foldersData.length} folders (all spaces)`)\n } else {\n logError('FormView', `Failed to reload folders: Invalid response format`)\n setFoldersLoaded(true)\n }\n } catch (error) {\n logError('FormView', `Error reloading folders: ${error.message}`)\n setFoldersLoaded(true)\n } finally {\n setLoadingFolders(false)\n }\n }, [requestFromPlugin])\n\n // Reload notes (used after creating a new note)\n const reloadNotes = useCallback(async () => {\n if (!needsNotes) return\n\n try {\n setLoadingNotes(true)\n setNotesLoaded(false) // Reset to allow reload\n logDebug('FormView', 'Reloading notes after note creation...')\n\n // Collect note-chooser options from all note-chooser fields (same as loadNotes)\n const noteChooserFields = formFields.filter((field) => field.type === 'note-chooser')\n const includeCalendarNotes = noteChooserFields.some((field) => field.includeCalendarNotes === true)\n const includePersonalNotes = noteChooserFields.some((field) => field.includePersonalNotes === true)\n const includeRelativeNotes = noteChooserFields.some((field) => field.includeRelativeNotes === true)\n const includeTeamspaceNotes = noteChooserFields.some((field) => field.includeTeamspaceNotes === true)\n\n const notesData = unwrapPluginRequestData(\n await requestFromPlugin('getNotes', {\n includeCalendarNotes,\n includePersonalNotes,\n includeRelativeNotes,\n includeTeamspaceNotes,\n }),\n )\n if (Array.isArray(notesData)) {\n setNotes(notesData)\n setNotesLoaded(true)\n logDebug('FormView', `Reloaded ${notesData.length} notes`)\n } else {\n logError('FormView', `Failed to reload notes: Invalid response format`)\n setNotesLoaded(true)\n }\n } catch (error) {\n logError('FormView', `Error reloading notes: ${error.message}`)\n setNotesLoaded(true)\n } finally {\n setLoadingNotes(false)\n }\n }, [needsNotes, formFields, requestFromPlugin])\n\n // Load notes on demand when needed (matching FormBuilder pattern)\n const loadNotes = useCallback(async () => {\n if (notesLoaded || loadingNotes || !needsNotes) return\n\n try {\n setLoadingNotes(true)\n logDebug('FormView', 'Loading notes on demand...')\n\n // Load all notes with all options enabled (union of all field options)\n // Each NoteChooser component will filter the notes client-side based on its own options\n const noteChooserFields = formFields.filter((field) => field.type === 'note-chooser')\n const includeCalendarNotes = noteChooserFields.some((field) => field.includeCalendarNotes === true)\n // Include personal notes if ANY field wants them (union logic - load all that might be needed)\n // Since personal notes default to true, we include them if any field has it true or undefined\n const includePersonalNotes = noteChooserFields.some((field) => field.includePersonalNotes !== false) // At least one field wants them\n const includeRelativeNotes = noteChooserFields.some((field) => field.includeRelativeNotes === true)\n // Include teamspace notes if ANY field wants them (union logic - load all that might be needed)\n // Since teamspace notes default to true, we include them if any field has it true or undefined\n const includeTeamspaceNotes = noteChooserFields.some((field) => field.includeTeamspaceNotes !== false) // At least one field wants them\n\n const notesData = unwrapPluginRequestData(\n await requestFromPlugin('getNotes', {\n includeCalendarNotes,\n includePersonalNotes,\n includeRelativeNotes,\n includeTeamspaceNotes,\n }),\n )\n if (Array.isArray(notesData)) {\n setNotes(notesData)\n setNotesLoaded(true)\n logDebug('FormView', `Loaded ${notesData.length} notes`)\n } else {\n logError('FormView', `Failed to load notes: Invalid response format`)\n setNotesLoaded(true) // Set to true to prevent infinite retries\n }\n } catch (error) {\n logError('FormView', `Error loading notes: ${error.message}`)\n setNotesLoaded(true) // Set to true to prevent infinite retries\n } finally {\n setLoadingNotes(false)\n }\n }, [notesLoaded, loadingNotes, needsNotes, requestFromPlugin, formFields])\n\n // Inject custom CSS from pluginData if provided\n useEffect(() => {\n const customCSS = pluginData?.customCSS || ''\n if (!customCSS || typeof document === 'undefined') return\n\n // $FlowFixMe[incompatible-use] - document.head is checked for null\n const head = document.head\n if (!head) return\n\n // Create a style element with a unique ID to avoid duplicates\n const styleId = 'form-custom-css'\n let styleElement = document.getElementById(styleId)\n\n if (!styleElement) {\n styleElement = document.createElement('style')\n styleElement.id = styleId\n // $FlowFixMe[incompatible-use] - head is checked for null above\n head.appendChild(styleElement)\n }\n\n if (styleElement) {\n styleElement.textContent = customCSS\n }\n\n // Cleanup: remove style element when component unmounts or CSS changes\n return () => {\n const element = document.getElementById(styleId)\n if (element) {\n element.remove()\n }\n }\n }, [pluginData?.customCSS])\n\n // Listen for RESPONSE messages from Root and resolve pending requests\n useEffect(() => {\n const handleResponse = (event: MessageEvent) => {\n const responseStartTime = performance.now()\n const { data: eventData } = event\n // $FlowFixMe[incompatible-type] - eventData can be various types\n if (eventData && typeof eventData === 'object' && eventData.type === 'RESPONSE' && eventData.payload) {\n // $FlowFixMe[prop-missing] - payload structure is validated above\n const payload = eventData.payload\n if (payload && typeof payload === 'object' && payload.correlationId && typeof payload.correlationId === 'string') {\n const { correlationId, success } = payload\n const pending = pendingRequestsRef.current.get(correlationId)\n if (pending) {\n const resolveStartTime = performance.now()\n pendingRequestsRef.current.delete(correlationId)\n clearTimeout(pending.timeoutId)\n const successStr = typeof success === 'boolean' ? String(success) : 'unknown'\n logDebug(\n 'FormView',\n `[DIAG] handleResponse RESOLVING: correlationId=\"${correlationId}\", success=${successStr}, pendingRequests=${pendingRequestsRef.current.size}, handlerElapsed=${(\n performance.now() - responseStartTime\n ).toFixed(2)}ms`,\n )\n\n const envelope = pluginEnvelopeFromResponsePayload(payload)\n requestAnimationFrame(() => {\n const resolveElapsed = performance.now() - resolveStartTime\n logDebug(\n 'FormView',\n `[DIAG] handleResponse RESOLVING AFTER RAF: correlationId=\"${correlationId}\", success=${String(envelope.success)}, resolveElapsed=${resolveElapsed.toFixed(2)}ms`,\n )\n pending.resolve(envelope)\n })\n } else {\n logDebug('FormView', `[DIAG] handleResponse UNKNOWN: correlationId=\"${correlationId}\" not found in pending requests`)\n }\n }\n }\n }\n\n window.addEventListener('message', handleResponse)\n return () => {\n window.removeEventListener('message', handleResponse)\n // Clean up any pending requests on unmount\n pendingRequestsRef.current.forEach((pending) => {\n clearTimeout(pending.timeoutId)\n })\n pendingRequestsRef.current.clear()\n }\n }, [])\n\n /****************************************************************************************************************************\n * HANDLERS\n ****************************************************************************************************************************/\n\n //\n // Dynamic Dialog\n //\n const closeDialog = () => {\n setReactSettings((prev) => ({ ...prev, dynamicDialog: { isOpen: false } }))\n }\n\n const handleCancel = () => {\n setIsSubmitting(false) // Hide overlay if canceling during submission\n setFormSubmitted(false) // Reset submitted state\n sendActionToPlugin(onSubmitOrCancelCallFunctionNamed, { type: 'cancel' })\n closeDialog()\n }\n\n // Track if form was submitted to handle delayed closing\n const [formSubmitted, setFormSubmitted] = useState(false)\n // Track if form is currently submitting (for showing loading overlay)\n const [isSubmitting, setIsSubmitting] = useState(false)\n\n // Debug counters (tracked via refs to avoid re-renders)\n const debugCountersRef = useRef<{ renders: number, setDataReceived: number, handleSaveCalls: number }>({ renders: 0, setDataReceived: 0, handleSaveCalls: 0 })\n const handleSaveCallCountRef = useRef(0)\n const setDataReceivedCountRef = useRef(0)\n /** Blocks double-submit; set sync in handleSave, cleared in deferred state update (avoids re-render blocking getGlobalSharedData) */\n const submissionInProgressRef = useRef(false)\n // Ref to track if component is mounted (prevents callbacks after unmount) - declared early so it's available to all setTimeout callbacks\n const isMountedRef = useRef(true)\n\n // Close dialog after submission if there's no AI analysis result\n // GUARD: Use ref to prevent this effect from running multiple times with same data\n const formSubmittedEffectRunRef = useRef('')\n // Ref to track timeout ID for proper cleanup (prevents race condition crash)\n const closeDialogTimeoutRef = useRef | null>(null)\n // Ref to track effect instance ID (increments each time effect runs, prevents stale callback execution)\n const effectInstanceIdRef = useRef(0)\n useEffect(() => {\n // Clear any existing timeout when effect runs (cleanup from previous effect run)\n if (closeDialogTimeoutRef.current != null) {\n clearTimeout(closeDialogTimeoutRef.current)\n closeDialogTimeoutRef.current = null\n }\n // Increment instance ID to invalidate any pending callbacks from previous effect runs\n const currentInstanceId = ++effectInstanceIdRef.current\n\n if (formSubmitted) {\n // Create a signature for this effect run to prevent duplicate processing\n const signature = `${String(!!pluginData?.aiAnalysisResult)}-${String(!!pluginData?.formSubmissionError)}`\n if (formSubmittedEffectRunRef.current === signature) {\n // Already processed this state, skip to prevent loops\n return\n }\n formSubmittedEffectRunRef.current = signature\n // Check if there's an AI analysis result\n const hasAiAnalysis = pluginData?.aiAnalysisResult && typeof pluginData.aiAnalysisResult === 'string' && pluginData.aiAnalysisResult.includes('==**Templating Error Found**')\n logDebug(\n 'FormView',\n `[AI ANALYSIS] formSubmitted=${String(formSubmitted)}, hasAiAnalysis=${String(hasAiAnalysis)}, aiAnalysisResult exists=${String(!!pluginData?.aiAnalysisResult)}, length=${\n pluginData?.aiAnalysisResult?.length || 0\n }`,\n )\n\n const hasFormSubmissionError = pluginData?.formSubmissionError && typeof pluginData.formSubmissionError === 'string'\n\n // Hide submitting overlay and allow resubmit if we received an error or AI analysis result\n if (hasAiAnalysis || hasFormSubmissionError) {\n setIsSubmitting(false)\n setFormSubmitted(false) // Allow user to click Submit again when error/AI analysis banner is shown\n suppressDataRequestsRef.current = false // Allow data-load requests again when keeping dialog open for error\n submissionInProgressRef.current = false // Ensure guard allows next submit (belt-and-suspenders)\n formSubmittedEffectRunRef.current = '' // So next effect run (after second submit) doesn't skip due to signature match\n }\n\n if (!hasAiAnalysis && !hasFormSubmissionError) {\n // No AI analysis result and no form submission error - close the dialog after a short delay to allow data to update\n logDebug('FormView', `[AI ANALYSIS] No AI analysis result, no form submission error, will close dialog after 500ms delay`)\n // Capture instance ID in closure for the timeout callback\n const callbackInstanceId = currentInstanceId\n // Capture current timeout ref to verify it hasn't been cleared\n const timeoutRef = closeDialogTimeoutRef\n closeDialogTimeoutRef.current = setTimeout(() => {\n try {\n // CRITICAL: Check if component is still mounted, effect instance is still current, and timeout hasn't been cleared\n // This prevents crashes when the component unmounts or effect re-runs while callback is executing\n const isUnmounted = !isMountedRef.current\n const instanceChanged = effectInstanceIdRef.current !== callbackInstanceId\n const timeoutCleared = timeoutRef.current === null\n if (isUnmounted || instanceChanged || timeoutCleared) {\n logDebug('FormView', `[AI ANALYSIS] Timeout callback skipped - unmounted=${String(isUnmounted)}, instance changed (${callbackInstanceId} -> ${effectInstanceIdRef.current}), timeout cleared=${String(timeoutCleared)}`)\n return\n }\n // Double-check there's still no AI analysis result or form submission error\n // Access pluginData safely - it might be stale but that's okay for this check\n const stillNoAiAnalysis = !pluginData?.aiAnalysisResult || !pluginData.aiAnalysisResult.includes('==**Templating Error Found**')\n const stillNoFormError = !pluginData?.formSubmissionError\n logDebug('FormView', `[AI ANALYSIS] After 500ms delay, stillNoAiAnalysis=${String(stillNoAiAnalysis)}, stillNoFormError=${String(stillNoFormError)}, closing dialog`)\n if (stillNoAiAnalysis && stillNoFormError) {\n setIsSubmitting(false) // Hide overlay before closing\n suppressDataRequestsRef.current = false // Allow data-load requests again after submit completes\n closeDialog()\n setFormSubmitted(false)\n }\n } catch (err) {\n // Defensive: catch any errors to prevent crashes during cleanup\n logDebug('FormView', `[AI ANALYSIS] Error in timeout callback (likely component unmounted): ${String(err)}`)\n }\n }, 500) // Wait 500ms for SET_DATA message to arrive\n } else {\n logDebug('FormView', `[AI ANALYSIS] AI analysis result or form submission error detected, keeping dialog open`)\n // If there's an AI analysis result or form submission error, keep the dialog open (don't close)\n }\n }\n\n // Cleanup function: clear timeout\n return () => {\n if (closeDialogTimeoutRef.current != null) {\n clearTimeout(closeDialogTimeoutRef.current)\n closeDialogTimeoutRef.current = null\n }\n }\n }, [formSubmitted, pluginData?.aiAnalysisResult, pluginData?.formSubmissionError])\n\n // Track mount state to prevent callbacks after unmount\n useEffect(() => {\n isMountedRef.current = true\n \n // CRITICAL: Handle window/page replacement (when NotePlan reuses window with new content)\n // When the window content is replaced, React may not get a chance to unmount properly\n // This ensures cleanup happens even if React's unmount lifecycle doesn't complete\n const handlePageUnload = () => {\n logDebug('FormView', '[CLEANUP] Page unloading - clearing all pending timeouts and marking as unmounted')\n isMountedRef.current = false\n // Clear all pending timeouts\n if (closeDialogTimeoutRef.current != null) {\n clearTimeout(closeDialogTimeoutRef.current)\n closeDialogTimeoutRef.current = null\n }\n // Clear any pending requests\n pendingRequestsRef.current.forEach((pending) => {\n clearTimeout(pending.timeoutId)\n })\n pendingRequestsRef.current.clear()\n }\n \n // Listen for page unload events (fires when window content is replaced)\n window.addEventListener('beforeunload', handlePageUnload)\n window.addEventListener('pagehide', handlePageUnload)\n // Also listen for visibility change as a fallback\n const handleVisibilityChange = () => {\n if (document.visibilityState === 'hidden') {\n // Page is being hidden - might be replaced soon, but don't clear yet\n // Just log for debugging\n logDebug('FormView', '[CLEANUP] Page visibility changed to hidden')\n }\n }\n document.addEventListener('visibilitychange', handleVisibilityChange)\n \n return () => {\n isMountedRef.current = false\n // Clear any pending timeout on unmount\n if (closeDialogTimeoutRef.current != null) {\n clearTimeout(closeDialogTimeoutRef.current)\n closeDialogTimeoutRef.current = null\n }\n // Remove event listeners\n window.removeEventListener('beforeunload', handlePageUnload)\n window.removeEventListener('pagehide', handlePageUnload)\n document.removeEventListener('visibilitychange', handleVisibilityChange)\n }\n }, [])\n\n /**\n * Submit form via REQUEST/RESPONSE so errors (formSubmissionError, aiAnalysisResult) are returned\n * and shown before the dialog closes. Uses requestFromPlugin('submitForm', payload) per REQUEST_COMMUNICATIONS_AND_ROUTING.\n */\n const handleSave = useCallback(\n (formValues: Object, windowId?: string) => {\n // GUARD: Prevent multiple submissions (critical for preventing loops)\n if (submissionInProgressRef.current || isSubmitting || formSubmitted) {\n logDebug(\n 'FormView',\n `[GUARD] handleSave: Already submitting (inProgress=${String(submissionInProgressRef.current)}, isSubmitting=${String(isSubmitting)}, formSubmitted=${String(\n formSubmitted,\n )}), ignoring duplicate call`,\n )\n return\n }\n submissionInProgressRef.current = true\n suppressDataRequestsRef.current = true // Skip data-load requestFromPlugin during submit to avoid storm of REQUESTS\n\n handleSaveCallCountRef.current += 1\n debugCountersRef.current.handleSaveCalls = handleSaveCallCountRef.current\n\n clo(formValues, 'DynamicDialog: handleSave: formValues')\n logDebug(\n 'FormView',\n `[FRONT-END] handleSave called (#${handleSaveCallCountRef.current}) - form submission starting, isSubmitting=${String(isSubmitting)}, formSubmitted=${String(\n formSubmitted,\n )}`,\n )\n logDebug('FormView', `[FRONT-END] Sending submitForm REQUEST to back-end (plugin)`)\n const receivingTemplateTitleFromForm = formValues?.receivingTemplateTitle || ''\n const receivingTemplateTitleFromPluginData = pluginData['receivingTemplateTitle'] || ''\n const receivingTemplateTitle = receivingTemplateTitleFromForm || receivingTemplateTitleFromPluginData\n\n const payload = {\n type: 'submit',\n formValues,\n windowId: windowId || pluginData.windowId || '',\n formTemplateFilename: pluginData?.templateFilename || '',\n processingMethod: pluginData['processingMethod'] || (receivingTemplateTitle ? 'form-processor' : 'write-existing'),\n receivingTemplateTitle: receivingTemplateTitle,\n getNoteTitled: pluginData['getNoteTitled'] || '',\n location: pluginData['location'] || 'append',\n writeUnderHeading: pluginData['writeUnderHeading'] || '',\n replaceNoteContents: pluginData['replaceNoteContents'] || false,\n createMissingHeading: pluginData['createMissingHeading'] !== false,\n newNoteTitle: pluginData['newNoteTitle'] || '',\n newNoteFolder: pluginData['newNoteFolder'] || '',\n space: pluginData['space'] || '',\n // Default true when missing (no shouldOpenInEditor in frontmatter = open in editor, matches Form Builder UI)\n shouldOpenInEditor: pluginData?.shouldOpenInEditor !== false && pluginData?.shouldOpenInEditor !== 'false',\n }\n\n // Persist current data so plugin sees latest when it calls getGlobalSharedData (passthrough vars updated by sendActionToPlugin elsewhere)\n dispatch('UPDATE_DATA', data)\n\n // Show overlay only; do NOT set formSubmitted until we have the submitForm RESPONSE (otherwise the\n // formSubmitted effect runs with stale pluginData and incorrectly schedules \"close after 500ms\" while backend is still processing).\n requestAnimationFrame(() => {\n setIsSubmitting(true)\n submissionInProgressRef.current = false\n })\n\n // Use 30s timeout so backend's getRenderContext (20s) can complete; if backend hangs, user sees \"Request timeout\" and overlay clears.\n const SUBMIT_TIMEOUT_MS = 30000\n requestFromPlugin('submitForm', payload, SUBMIT_TIMEOUT_MS)\n .then((envelope: any) => {\n if (envelope && envelope.success === false) {\n const payloadData = envelope.data && typeof envelope.data === 'object' ? envelope.data : null\n if (payloadData && (payloadData.formSubmissionError != null || payloadData.aiAnalysisResult != null)) {\n const basePluginData = data.pluginData || {}\n const mergedPluginData = { ...basePluginData }\n if ('formSubmissionError' in payloadData) {\n mergedPluginData.formSubmissionError = payloadData.formSubmissionError\n }\n if ('aiAnalysisResult' in payloadData) {\n mergedPluginData.aiAnalysisResult = payloadData.aiAnalysisResult\n }\n dispatch('UPDATE_DATA', { ...data, pluginData: mergedPluginData })\n } else {\n const errorData = {\n ...data,\n pluginData: { ...(data.pluginData || {}), formSubmissionError: envelope.message || 'Form submission failed' },\n }\n dispatch('UPDATE_DATA', errorData)\n }\n } else if (envelope && envelope.success === true) {\n const result = envelope.data\n if (result && typeof result === 'object') {\n const basePluginData = data.pluginData || {}\n const mergedPluginData = { ...basePluginData }\n if ('formSubmissionError' in result) {\n mergedPluginData.formSubmissionError = result.formSubmissionError\n }\n if ('aiAnalysisResult' in result) {\n mergedPluginData.aiAnalysisResult = result.aiAnalysisResult\n }\n dispatch('UPDATE_DATA', { ...data, pluginData: mergedPluginData })\n }\n }\n setIsSubmitting(false)\n setFormSubmitted(true) // Only now: effect runs with real pluginData and decides close vs keep-open\n })\n .catch((error: Error) => {\n logDebug('FormView', `[FRONT-END] submitForm REQUEST failed: ${error.message}`)\n suppressDataRequestsRef.current = false\n setIsSubmitting(false)\n const errorData = {\n ...data,\n pluginData: { ...(data.pluginData || {}), formSubmissionError: error.message || 'Form submission failed' },\n }\n dispatch('UPDATE_DATA', errorData)\n setFormSubmitted(true) // Effect runs, sees formSubmissionError, keeps dialog open\n })\n },\n [data, pluginData, isSubmitting, formSubmitted, dispatch, requestFromPlugin, onSubmitOrCancelCallFunctionNamed],\n )\n\n // Return true if the string is 'true' (case insensitive), otherwise return false (blank or otherwise)\n const isTrueString = (value: string): boolean => (value ? /true/i.test(value) : false)\n\n /****************************************************************************************************************************\n * EFFECTS\n ****************************************************************************************************************************/\n\n /**\n * Scroll the .dynamic-dialog-content element to top on mount\n * The scrolling element is .dynamic-dialog-content inside .template-form, not the window\n */\n useEffect(() => {\n // Function to find and scroll the dialog content element\n const scrollDialogContentToTop = () => {\n // CRITICAL: Check if component is still mounted before accessing DOM\n if (!isMountedRef.current) {\n return null\n }\n // Try multiple selectors to find the scrolling element\n const selectors = ['.template-form .dynamic-dialog-content', '.dynamic-dialog.template-form .dynamic-dialog-content', '.dynamic-dialog-content']\n\n for (const selector of selectors) {\n const element = document.querySelector(selector)\n if (element) {\n const scrollTop = element.scrollTop\n element.scrollTop = 0\n logDebug('FormView', `[SCROLL] Found ${selector}, scrollTop was ${scrollTop}, set to 0`)\n return element\n }\n }\n logDebug('FormView', `[SCROLL] Could not find dialog content element`)\n return null\n }\n\n // Try immediately\n scrollDialogContentToTop()\n\n // Try again after a short delay to catch it after React renders\n const timeout1 = setTimeout(() => {\n if (isMountedRef.current) {\n scrollDialogContentToTop()\n }\n }, 50)\n\n // Try again after a longer delay\n const timeout2 = setTimeout(() => {\n if (isMountedRef.current) {\n scrollDialogContentToTop()\n }\n }, 200)\n\n // Final attempt after everything should be rendered\n const timeout3 = setTimeout(() => {\n if (isMountedRef.current) {\n scrollDialogContentToTop()\n }\n }, 500)\n\n return () => {\n clearTimeout(timeout1)\n clearTimeout(timeout2)\n clearTimeout(timeout3)\n }\n }, []) // Only run once on mount\n\n /**\n * When the data changes, restore scroll position if provided\n * Fires after components draw\n */\n useEffect(() => {\n if (data?.passThroughVars?.lastWindowScrollTop !== undefined && data.passThroughVars.lastWindowScrollTop !== window.scrollY) {\n logDebug('FormView', `[SCROLL] Restoring scroll position to ${data.passThroughVars.lastWindowScrollTop}`)\n window.scrollTo(0, data.passThroughVars.lastWindowScrollTop)\n }\n }, [data])\n\n // Load folders/notes automatically when fields change and they're needed (matching FormBuilder pattern)\n // Load folders/notes with delay to yield to TOC rendering\n // Delay the request to yield to TOC rendering and other critical UI elements\n // This prevents blocking the initial render with data loading\n useEffect(() => {\n if (needsFolders && !foldersLoaded && !loadingFolders) {\n // Use setTimeout to delay the request, allowing TOC and other UI to render first\n const timeoutId = setTimeout(() => {\n // CRITICAL: Check if component is still mounted before calling state setters\n if (isMountedRef.current) {\n loadFolders()\n }\n }, 200) // 200ms delay to yield to TOC rendering\n\n return () => {\n clearTimeout(timeoutId)\n }\n }\n }, [needsFolders, foldersLoaded, loadingFolders, loadFolders])\n\n useEffect(() => {\n if (needsNotes && !notesLoaded && !loadingNotes) {\n // Use setTimeout to delay the request, allowing TOC and other UI to render first\n const timeoutId = setTimeout(() => {\n // CRITICAL: Check if component is still mounted before calling state setters\n if (isMountedRef.current) {\n loadNotes()\n }\n }, 200) // 200ms delay to yield to TOC rendering\n\n return () => {\n clearTimeout(timeoutId)\n }\n }\n }, [needsNotes, notesLoaded, loadingNotes, loadNotes])\n\n /****************************************************************************************************************************\n * FUNCTIONS\n ****************************************************************************************************************************/\n /**\n * Helper function to remove HTML entities from a string. Not used in this example but leaving here because it's useful\n * if you want to allow people to enter text in an HTML field\n * @param {string} text\n * @returns {string} cleaned text without HTML entities\n */\n // eslint-disable-next-line no-unused-vars\n function decodeHTMLEntities(text: string): string {\n const textArea = document.createElement('textarea')\n textArea.innerHTML = text\n const decoded = textArea.value\n return decoded\n }\n\n /**\n * Add the passthrough variables to the data object that will roundtrip to the plugin and come back in the data object\n * Because any data change coming from the plugin will force a React re-render, we can use this to store data that we want to persist\n * (e.g. lastWindowScrollTop)\n * @param {*} data\n * @returns\n */\n const addPassthroughVars = (data: PassedData): PassedData => {\n const newData = { ...data }\n if (!newData.passThroughVars) newData.passThroughVars = {}\n // $FlowIgnore\n newData.passThroughVars.lastWindowScrollTop = window.scrollY\n return newData\n }\n\n /**\n * Convenience function to send an action to the plugin and saving any passthrough data first in the Root data store\n * This is useful if you want to save data that you want to persist when the plugin sends data back to the Webview\n * For instance, saving where the scroll position was so that when data changes and the Webview re-renders, it can scroll back to where it was\n * @param {string} command\n * @param {any} dataToSend\n */\n const sendActionToPlugin = (command: string, dataToSend: any, additionalDetails: string = '') => {\n const newData = addPassthroughVars(data) // save scroll position and other data in data object at root level\n dispatch('UPDATE_DATA', newData) // save the data at the Root React Component level, which will give the plugin access to this data also\n sendToPlugin([command, dataToSend, additionalDetails]) // send action to plugin\n }\n\n /**\n * Send data back to the plugin to update the data in the plugin\n * This could cause a refresh of the Webview if the plugin sends back new data, so we want to save any passthrough data first\n * In that case, don't call this directly, use sendActionToPlugin() instead\n * @param {[command:string,data:any,additionalDetails:string]} param0\n */\n // $FlowIgnore\n const sendToPlugin = ([command: string, data: any, additionalDetails: string = '']) => {\n if (!command) throw new Error('sendToPlugin: command must be called with a string')\n logDebug(`Webview: sendToPlugin: ${JSON.stringify(command)} ${additionalDetails}`, command, data, additionalDetails)\n if (!data) throw new Error('sendToPlugin: data must be called with an object')\n dispatch('SEND_TO_PLUGIN', [command, data], `WebView: sendToPlugin: ${String(command)} ${additionalDetails}`)\n }\n\n /**\n * Updates the pluginData with the provided new data (must be the whole pluginData object)\n *\n * @param {Object} newData - The new data to update the plugin with,\n * @param {string} messageForLog - An optional message to log with the update\n * @throws {Error} Throws an error if newData is not provided or if it does not have more keys than the current pluginData.\n * @return {void}\n */\n const updatePluginData = (newData: any, messageForLog?: string) => {\n if (!newData) {\n throw new Error('updatePluginData: newData must be called with an object')\n }\n if (Object.keys(newData).length < Object.keys(pluginData).length) {\n throw new Error('updatePluginData: newData must be called with an object that has more keys than the current pluginData. You must send a full pluginData object')\n }\n const newFullData = { ...data, pluginData: newData }\n dispatch('UPDATE_DATA', newFullData, messageForLog) // save the data at the Root React Component level, which will give the plugin access to this data also\n }\n if (!pluginData.reactSettings) pluginData.reactSettings = {}\n\n /****************************************************************************************************************************\n * RENDER\n ****************************************************************************************************************************/\n\n /**\n * NOTE: THE FOLLOWING CODE DOES NOT DO MUCH, BECAUSE ALL THE MAGIC HAPPENS IN THE DynamicDialog.jsx component\n * WHICH IS OPENED WHEN reactData.dynamicDialog.isOpen is set to true\n * which happens when the useEffect() in this FormView.jsx file opens the dialog on page load\n */\n // Diagnostic: Log render timing (runs on every render to track re-renders)\n // Note: Re-renders from autosave completion are expected (autosave updates state → re-render)\n const renderCountRef = useRef(0)\n const lastPluginDataRef = useRef('')\n useEffect(() => {\n renderCountRef.current += 1\n const renderStartTime = performance.now()\n\n // Track pluginData changes to detect SET_DATA messages from back-end\n const currentPluginDataStr = JSON.stringify(pluginData)\n const pluginDataChanged = currentPluginDataStr !== lastPluginDataRef.current\n if (pluginDataChanged) {\n lastPluginDataRef.current = currentPluginDataStr\n setDataReceivedCountRef.current += 1\n debugCountersRef.current.setDataReceived = setDataReceivedCountRef.current\n // Don't update state here - would cause infinite loop. Only update when handleSave is called.\n logDebug(\n 'FormView',\n `[FRONT-END] SET_DATA received from back-end (#${setDataReceivedCountRef.current}) - pluginData changed, triggering re-render #${renderCountRef.current}`,\n )\n // Log what changed\n const hasError = pluginData?.formSubmissionError || pluginData?.aiAnalysisResult\n if (hasError) {\n logDebug('FormView', `[FRONT-END] SET_DATA contains error: formSubmissionError=${!!pluginData?.formSubmissionError}, aiAnalysisResult=${!!pluginData?.aiAnalysisResult}`)\n }\n }\n\n // Update render counter in ref only (don't trigger state update - that would cause infinite loop!)\n debugCountersRef.current.renders = renderCountRef.current\n\n // Only log first few renders and then periodically to reduce noise\n // But always log when pluginData changes (back-end activity)\n const shouldLog = pluginDataChanged || renderCountRef.current <= 3 || renderCountRef.current % 10 === 0\n if (shouldLog) {\n logDebug(\n 'FormView',\n `[FRONT-END] FormView RENDER #${renderCountRef.current}: formFields=${formFields.length}, folders=${folders.length}, notes=${notes.length}, pluginDataChanged=${String(\n pluginDataChanged,\n )}`,\n )\n }\n\n requestAnimationFrame(() => {\n const renderElapsed = performance.now() - renderStartTime\n if (shouldLog) {\n logDebug('FormView', `[FRONT-END] FormView RENDER #${renderCountRef.current} AFTER RAF: elapsed=${renderElapsed.toFixed(2)}ms`)\n }\n })\n })\n\n // Check for AI analysis result in pluginData\n const aiAnalysisResult = pluginData?.aiAnalysisResult || ''\n\n // Check for form submission error in pluginData\n const formSubmissionError = pluginData?.formSubmissionError || ''\n\n return (\n <>\n \n
\n {/* replace all this code with your own component(s) */}\n \n \n {\n reloadFolders()\n }}\n onNotesChanged={() => {\n reloadNotes()\n }}\n className=\"template-form\"\n style={{\n content: { paddingLeft: '1.5rem', paddingRight: '1.5rem' },\n '--template-form-compact-label-width': pluginData?.compactLabelWidth || undefined,\n '--template-form-compact-input-width': pluginData?.compactInputWidth || undefined,\n }}\n />\n
\n {/* end of replace */}\n \n {/* Submitting overlay - rendered via portal to document.body to appear above everything */}\n {isSubmitting && typeof document !== 'undefined' && document.body\n ? createPortal(\n
\n
\n
Submitting Form...
\n
\n
,\n document.body,\n )\n : null}\n \n {/* Submitting overlay - rendered via portal to document.body to appear above everything */}\n {isSubmitting && typeof document !== 'undefined' && document.body\n ? createPortal(\n
\n
\n
Submitting Form...
\n
\n
,\n document.body,\n )\n : null}\n \n )\n}\n" }, { "path": "dwertheimer.Forms/src/components/OptionsEditor.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// OptionsEditor Component - Reusable editor for dropdown/button-group options\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect, type Node } from 'react'\n\ntype OptionItem = {\n label: string,\n value: string,\n isDefault: boolean,\n}\n\ntype OptionsEditorProps = {\n options: Array, // Can be Array, but Flow has trouble with union arrays\n fieldType: 'dropdown-select' | 'combo' | 'button-group',\n onChange: (options: Array) => void, // Can be Array\n}\n\nexport function OptionsEditor({ options, fieldType, onChange }: OptionsEditorProps): Node {\n // Normalize options to always work with OptionItem format internally\n const normalizeOption = (opt: string | OptionItem): OptionItem => {\n if (typeof opt === 'string') {\n return { label: opt, value: opt, isDefault: false }\n }\n return { label: opt.label || opt.value || '', value: opt.value || '', isDefault: opt.isDefault || false }\n }\n\n const [optionItems, setOptionItems] = useState>(() => {\n return options ? options.map(normalizeOption) : []\n })\n\n const handleAddOption = () => {\n const newOption: OptionItem = { label: 'New Option', value: 'newOption', isDefault: false }\n const updated = [...optionItems, newOption]\n setOptionItems(updated)\n convertAndNotify(updated)\n }\n\n const handleUpdateOption = (index: number, updates: Partial) => {\n const updated = [...optionItems]\n const currentItem = updated[index]\n const newItem = { ...currentItem, ...updates }\n // Ensure value is also updated if label changes and they were the same\n if (updates.label && currentItem.label === currentItem.value && !updates.value) {\n newItem.value = updates.label\n }\n updated[index] = newItem\n setOptionItems(updated)\n // Convert back to the appropriate format for the field type\n convertAndNotify(updated)\n }\n\n const handleDeleteOption = (index: number) => {\n const updated = optionItems.filter((_, i) => i !== index)\n setOptionItems(updated)\n convertAndNotify(updated)\n }\n\n const handleMoveUp = (index: number) => {\n if (index === 0) return\n const updated = [...optionItems]\n const temp = updated[index - 1]\n updated[index - 1] = updated[index]\n updated[index] = temp\n setOptionItems(updated)\n convertAndNotify(updated)\n }\n\n const handleMoveDown = (index: number) => {\n if (index === optionItems.length - 1) return\n const updated = [...optionItems]\n const temp = updated[index]\n updated[index] = updated[index + 1]\n updated[index + 1] = temp\n setOptionItems(updated)\n convertAndNotify(updated)\n }\n\n const handleToggleDefault = (index: number) => {\n const updated = optionItems.map((opt, i) => ({\n label: opt.label,\n value: opt.value,\n isDefault: i === index ? !opt.isDefault : false, // Only one default at a time\n }))\n setOptionItems(updated)\n convertAndNotify(updated)\n }\n\n const convertAndNotify = (items: Array) => {\n if (fieldType === 'button-group') {\n // For button-group, always return objects with isDefault (but convert to the format expected)\n const converted: Array = items.map((item) => ({\n label: item.label,\n value: item.value,\n isDefault: item.isDefault,\n }))\n onChange(converted)\n } else {\n // For dropdown-select/combo, return strings if label === value, otherwise objects\n const converted: Array = items.map((item) => {\n if (item.label === item.value) {\n return item.label\n }\n return { label: item.label, value: item.value }\n })\n onChange(converted)\n }\n }\n\n useEffect(() => {\n // Update internal state when options prop changes externally\n const normalized = options ? options.map(normalizeOption) : []\n setOptionItems(normalized)\n }, [options])\n\n return (\n
\n
\n \n \n
\n
\n {optionItems.length === 0 ? (\n
No options yet. Click "Add Option" to get started.
\n ) : (\n optionItems.map((option, index) => (\n
\n
\n \n \n
\n
\n
\n \n handleUpdateOption(index, { label: e.target.value })} placeholder=\"Display label\" />\n
\n
\n \n handleUpdateOption(index, { value: e.target.value })} placeholder=\"Value (for template)\" />\n
\n {fieldType === 'button-group' && (\n
\n \n
\n )}\n
\n \n
\n ))\n )}\n
\n
\n {fieldType === 'button-group'\n ? 'Label is what users see, Value is used in templates. Only one option can be marked as default.'\n : 'Label is what users see, Value is used in templates. Leave Value empty to use Label as Value.'}\n
\n
\n )\n}\n\nexport default OptionsEditor\n" }, { "path": "dwertheimer.Forms/src/components/PositionInput.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// PositionInput Component\n// Input field with dropdown choices for window position (X or Y)\n// Allows selecting from predefined choices or entering custom values (e.g., \"60%\")\n//--------------------------------------------------------------------------\n\nimport React, { type Node } from 'react'\n\nexport type PositionType = 'x' | 'y'\n\ntype PositionInputProps = {\n type: PositionType, // 'x' or 'y'\n value?: string | number,\n onChange: (value: string | void) => void,\n onBlur?: (e: any) => void,\n placeholder?: string,\n style?: { [key: string]: any },\n}\n\n/**\n * PositionInput Component\n * Input field with datalist for predefined position choices\n * @param {PositionInputProps} props\n * @returns {React$Node}\n */\nexport function PositionInput({\n type,\n value = '',\n onChange,\n onBlur,\n placeholder,\n style = {},\n}: PositionInputProps): Node {\n const listId = `position-${type}-list`\n \n // Define choices based on type\n const choices = type === 'x' \n ? ['-', 'center', 'left', 'right']\n : ['-', 'center', 'top', 'bottom']\n\n // Convert value to string for input\n const stringValue = value === null || value === undefined ? '' : String(value)\n\n const handleChange = (e: any) => {\n const newValue = e.currentTarget.value.trim()\n onChange(newValue || undefined)\n }\n\n const handleBlur = (e: any) => {\n const inputValue = e.currentTarget.value.trim()\n if (inputValue) {\n // Validate: must be a number, percentage, or one of the predefined choices\n const isValidChoice = choices.includes(inputValue.toLowerCase())\n const isPercentage = inputValue.endsWith('%')\n const isNumber = !isNaN(parseFloat(inputValue))\n \n if (!isValidChoice && !isPercentage && !isNumber) {\n alert(`Window ${type.toUpperCase()} position must be a number (e.g., 100), a percentage (e.g., 25%), or one of: ${choices.join(', ')}.`)\n onChange(undefined)\n }\n }\n if (onBlur) {\n onBlur(e)\n }\n }\n\n return (\n
\n \n \n {choices.map((choice) => (\n \n
\n )\n}\n\nexport default PositionInput\n\n" }, { "path": "dwertheimer.Forms/src/components/ProcessingMethodSection.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// ProcessingMethodSection Component\n// Handles the form processing method selection and related configuration\n//--------------------------------------------------------------------------\n\nimport React, { useState, useEffect } from 'react'\nimport { TemplateTagInserter } from './TemplateTagInserter.jsx'\nimport { TemplateTagEditor } from './TemplateTagEditor.jsx'\nimport { useAppContext } from './AppContext.jsx'\nimport { NoteChooser, type NoteOption } from '@helpers/react/DynamicDialog/NoteChooser.jsx'\nimport { HeadingChooser } from '@helpers/react/DynamicDialog/HeadingChooser.jsx'\nimport { FolderChooser } from '@helpers/react/DynamicDialog/FolderChooser.jsx'\nimport { SpaceChooser } from '@helpers/react/DynamicDialog/SpaceChooser.jsx'\nimport { InfoIcon } from '@helpers/react/InfoIcon.jsx'\nimport { logDebug } from '@helpers/react/reactDev'\nimport { unwrapPluginRequestData } from '@helpers/react/pluginRequestEnvelope'\n\nexport type ProcessingMethodSectionProps = {\n processingMethod: string,\n frontmatter: { [key: string]: any },\n notes: Array,\n folders: Array,\n requestFromPlugin: (command: string, dataToSend?: any, timeout?: number) => Promise,\n onFrontmatterChange: (key: string, value: any) => void,\n onLoadNotes: (forProcessingTemplates?: boolean, forceReload?: boolean, spaceOverride?: ?string) => Promise,\n loadingNotes?: boolean, // Loading state for notes\n onLoadFolders: (forceReload?: boolean, spaceOverride?: ?string) => Promise,\n templateTitle: string,\n templateFilename?: string,\n showTagInserter: boolean,\n setShowTagInserter: (show: boolean) => void,\n tagInserterMode: 'field' | 'date' | 'both',\n setTagInserterMode: (mode: 'field' | 'date' | 'both') => void,\n tagInserterInputRef: ?HTMLInputElement | ?HTMLTextAreaElement,\n setTagInserterInputRef: (ref: ?HTMLInputElement | ?HTMLTextAreaElement) => void,\n tagInserterFieldKey: string, // Track which field is being edited ('newNoteTitle' or 'templateBody')\n setTagInserterFieldKey: (key: string) => void,\n fields: Array, // TSettingItem array\n}\n\n/**\n * ProcessingMethodSection Component\n * Renders the processing method selection and related configuration fields\n */\nexport function ProcessingMethodSection({\n processingMethod,\n frontmatter,\n notes,\n folders,\n requestFromPlugin,\n onFrontmatterChange,\n onLoadNotes,\n loadingNotes = false,\n onLoadFolders,\n templateTitle,\n templateFilename = '',\n showTagInserter,\n setShowTagInserter,\n tagInserterMode,\n setTagInserterMode,\n tagInserterInputRef,\n setTagInserterInputRef,\n tagInserterFieldKey,\n setTagInserterFieldKey,\n fields,\n}: ProcessingMethodSectionProps): React$Node {\n // Get pluginData from context for buffer buster logging\n const { pluginData } = useAppContext()\n\n const [tagInserterAnchorElement, setTagInserterAnchorElement] = useState(null)\n // Track the selected processing template filename so we can open it\n const [selectedProcessingTemplateFilename, setSelectedProcessingTemplateFilename] = useState('')\n\n // Initialize selectedProcessingTemplateFilename from notes when receivingTemplateTitle is set\n // Also update when notes load (for timing issue fix)\n React.useEffect(() => {\n const currentTitle = frontmatter.receivingTemplateTitle || frontmatter.formProcessorTitle || ''\n if (currentTitle && notes.length > 0) {\n const matchingNote = notes.find((note: NoteOption) => {\n // Match by title (preferred) or filename\n return note.title === currentTitle || note.filename === currentTitle\n })\n if (matchingNote && matchingNote.filename) {\n setSelectedProcessingTemplateFilename(matchingNote.filename)\n } else {\n // If no match found but we have a title, clear the filename to prevent stale state\n setSelectedProcessingTemplateFilename('')\n }\n } else {\n setSelectedProcessingTemplateFilename('')\n }\n }, [frontmatter.receivingTemplateTitle, frontmatter.formProcessorTitle, notes])\n\n // Helper function to handle tag inserter button clicks\n const handleTagInserterButtonClick = (e: any, mode: 'field' | 'date', fieldKey: string) => {\n e.preventDefault()\n e.stopPropagation()\n\n // Store the button element for positioning\n const buttonElement = e.currentTarget instanceof HTMLElement ? e.currentTarget : null\n\n // Ensure ref is set before opening modal\n const activeElement = document.activeElement\n if (activeElement instanceof HTMLTextAreaElement || activeElement instanceof HTMLInputElement) {\n setTagInserterInputRef(activeElement)\n setTagInserterFieldKey(fieldKey)\n } else {\n // Find the associated textarea/input (the one this button is next to)\n const container = e.currentTarget.closest('.frontmatter-field')\n const textarea = container?.querySelector('textarea')\n const input = container?.querySelector('input[type=\"text\"]')\n if (textarea instanceof HTMLTextAreaElement) {\n setTagInserterInputRef(textarea)\n setTagInserterFieldKey(fieldKey)\n } else if (input instanceof HTMLInputElement) {\n setTagInserterInputRef(input)\n setTagInserterFieldKey(fieldKey)\n }\n }\n setTagInserterMode(mode)\n setTagInserterAnchorElement(buttonElement)\n setShowTagInserter(true)\n }\n\n return (\n <>\n
\n \n onFrontmatterChange('processingMethod', e.target.value)}\n style={{ width: '100%', padding: '0.5rem', marginTop: '0.25rem' }}\n className=\"processing-method-select\"\n >\n \n \n \n \n \n
\n {processingMethod === 'write-existing' && 'Write form data directly to an existing note using TemplateRunner'}\n {processingMethod === 'create-new' && 'Create a new note with form data using TemplateRunner'}\n {processingMethod === 'form-processor' && 'Use a separate processing template to handle form submissions'}\n {processingMethod === 'run-js-only' && 'Run JavaScript template code only - no note creation or validation'}\n
\n
\n\n {/* Show in Editor checkbox - label changes based on processing method. Default true when missing from frontmatter (new forms). */}\n {/* Hide for run-js-only since there's no note to open */}\n {processingMethod !== 'run-js-only' && (\n
\n \n
\n )}\n\n {/* Option A: Write to Existing File */}\n {processingMethod === 'write-existing' && (\n <>\n
\n \n {\n onFrontmatterChange('space', spaceId)\n // Clear note selection when space changes to avoid confusion\n onFrontmatterChange('getNoteTitled', '')\n // Reload notes and folders to reflect the new space filter (force reload to ensure fresh data)\n // Pass spaceId directly to avoid reading stale frontmatter.space value\n onLoadNotes(false, true, spaceId).catch((error) => {\n console.error('Error reloading notes after space change:', error)\n })\n onLoadFolders(true, spaceId).catch((error) => {\n console.error('Error reloading folders after space change:', error)\n })\n }}\n placeholder=\"Select space (Private or Teamspace)\"\n compactDisplay={true}\n requestFromPlugin={requestFromPlugin}\n showValue={false}\n width=\"100%\"\n />\n
\n {frontmatter.space ? 'Only notes from the selected space will be shown' : 'Private notes (default) - only private notes will be shown'}\n
\n
\n
\n \n {\n // For special options (like \"Current Note\", \"Choose Note\"), use the filename (template value like \"\")\n // instead of the title (display label like \"Current Note\")\n // Check if filename is a template value (starts with \"<\" and ends with \">\")\n const valueToUse = noteFilename && noteFilename.startsWith('<') && noteFilename.endsWith('>') ? noteFilename : noteTitle\n onFrontmatterChange('getNoteTitled', valueToUse)\n }}\n placeholder=\"Select note or type , , , etc.\"\n includePersonalNotes={true}\n includeCalendarNotes={true}\n includeRelativeNotes={true}\n includeTeamspaceNotes={true}\n spaceFilter={frontmatter.space || ''}\n compactDisplay={true}\n requestFromPlugin={requestFromPlugin}\n onNotesChanged={() => {\n onLoadNotes(false) // Load all note types for write-existing method\n }}\n onOpen={() => {\n // Lazy load notes when dropdown opens\n // For write-existing, need all note types (including calendar/relative notes like )\n if (notes.length === 0) {\n onLoadNotes(false).catch((error) => {\n console.error('Error loading notes:', error)\n })\n }\n }}\n isLoading={notes.length === 0 && loadingNotes}\n />\n
\n Select a note or use special values: <today>, <current>, <thisweek>, <nextweek>, <choose>\n
\n
\n
\n \n {\n const newLocation = e.target.value\n onFrontmatterChange('location', newLocation)\n // If replacing, set replaceNoteContents\n if (newLocation === 'replace') {\n onFrontmatterChange('replaceNoteContents', true)\n } else {\n onFrontmatterChange('replaceNoteContents', false)\n }\n }}\n style={{ width: '100%', padding: '0.5rem', marginTop: '0.25rem' }}\n >\n \n \n \n \n \n \n \n \n
\n {(frontmatter.location === 'prepend-under-heading' ||\n frontmatter.location === 'append-under-heading' ||\n (frontmatter.location === 'append' && frontmatter.writeUnderHeading) ||\n (frontmatter.location === 'prepend' && frontmatter.writeUnderHeading)) && (\n <>\n
\n \n n.title === frontmatter.getNoteTitled)?.filename || null : null\n }\n requestFromPlugin={requestFromPlugin}\n onChange={(heading: string) => {\n onFrontmatterChange('writeUnderHeading', heading)\n }}\n placeholder=\"Select heading or type to enter manually\"\n optionAddTopAndBottom={true}\n includeArchive={false}\n compactDisplay={true}\n />\n
\n {frontmatter.getNoteTitled\n ? \"Select a heading from the note above, or type a heading name and press Enter to enter it manually. The heading will be created if it doesn't exist.\"\n : 'Type a heading name and press Enter to enter it manually. If a note is selected above, you can also choose from its headings.'}\n
\n
\n
\n \n
\n \n )}\n
\n \n onFrontmatterChange('templateBody', value)}\n onFocus={(e) => {\n const target = e.target\n if (target instanceof HTMLTextAreaElement) {\n setTagInserterInputRef(target)\n setTagInserterFieldKey('templateBody')\n }\n }}\n placeholder=\"\"\n minRows={5}\n maxRows={15}\n fields={fields.filter((f) => f.key && f.type !== 'separator' && f.type !== 'heading')}\n defaultRawMode={true}\n hideRawToggle={true}\n actionButtons={\n <>\n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'field', 'templateBody')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert field variable\"\n >\n + Field\n \n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'date', 'templateBody')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert date format\"\n >\n + Date\n \n \n }\n />\n
\n Use template tags like <%- fieldKey %> for form fields, or <%- date.format("YYYY-MM-DD") %> for dates\n
\n
\n \n )}\n\n {/* Option B: Create New Note */}\n {processingMethod === 'create-new' && (\n <>\n
\n \n {\n onFrontmatterChange('space', spaceId)\n // Reload notes and folders to reflect the new space filter (force reload)\n onLoadNotes(false, true, spaceId).catch((error) => {\n console.error('Error reloading notes after space change:', error)\n })\n onLoadFolders(true, spaceId).catch((error) => {\n console.error('Error reloading folders after space change:', error)\n })\n }}\n placeholder=\"Select space (Private or Teamspace)\"\n compactDisplay={true}\n requestFromPlugin={requestFromPlugin}\n showValue={false}\n width=\"100%\"\n />\n
\n {frontmatter.space ? 'New note will be created in the selected space' : 'Private notes (default) - new note will be created in Private space'}\n
\n
\n
\n \n {\n onFrontmatterChange('newNoteFolder', folder)\n }}\n placeholder=\"Select folder (optional)\"\n includeNewFolderOption={true}\n spaceFilter={frontmatter.space || ''}\n compactDisplay={false}\n includeFolderPath={false}\n requestFromPlugin={requestFromPlugin}\n onFoldersChanged={() => {\n onLoadFolders(true) // Force reload after creating folder\n }}\n staticOptions={[{ label: '' }]}\n width=\"100%\"\n />\n
\n Where to put the new note. Leave empty for root folder, or use "<Select>" to be prompted each time for the folder. If you have a field named "folder", it will be used to set the folder for the new note.\n
\n
\n
\n \n {\n // Strip newlines only (allow trailing spaces - trim on save)\n const cleanedValue = value.replace(/\\n/g, ' ')\n onFrontmatterChange('newNoteTitle', cleanedValue)\n }}\n onFocus={(e) => {\n const target = e.target\n if (target instanceof HTMLTextAreaElement) {\n setTagInserterInputRef(target)\n setTagInserterFieldKey('newNoteTitle')\n }\n }}\n placeholder=\"e.g., <%- noteTitle %> or Project: <%- projectName %>\"\n minRows={2}\n maxRows={5}\n fields={fields.filter((f) => f.key && f.type !== 'separator' && f.type !== 'heading')}\n defaultRawMode={true}\n hideRawToggle={true}\n actionButtons={\n <>\n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'field', 'newNoteTitle')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert field variable\"\n >\n + Field\n \n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'date', 'newNoteTitle')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert date format\"\n >\n + Date\n \n \n }\n />\n
\n (Without folder path). Use template tags like <%- fieldKey %> for form fields, or <%- date.format("YYYY-MM-DD") %> for dates\n
\n
\n
\n \n onFrontmatterChange('templateBody', value)}\n onFocus={(e) => {\n const target = e.target\n if (target instanceof HTMLTextAreaElement) {\n setTagInserterInputRef(target)\n setTagInserterFieldKey('templateBody')\n }\n }}\n placeholder=\"\"\n minRows={5}\n maxRows={15}\n fields={fields.filter((f) => f.key && f.type !== 'separator' && f.type !== 'heading')}\n defaultRawMode={true}\n hideRawToggle={true}\n actionButtons={\n <>\n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'field', 'templateBody')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert field variable\"\n >\n + Field\n \n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'date', 'templateBody')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert date format\"\n >\n + Date\n \n \n }\n />\n
\n Enter the template content that will be used to create the new note. Use tags like <%- fieldKey %> for form fields, or <%-\n date.format("YYYY-MM-DD") %> for dates.\n
\n
\n
\n \n onFrontmatterChange('newNoteFrontmatter', value)}\n onFocus={(e) => {\n const target = e.target\n if (target instanceof HTMLTextAreaElement) {\n setTagInserterInputRef(target)\n setTagInserterFieldKey('newNoteFrontmatter')\n }\n }}\n placeholder=\"e.g., travel_mode: <%- travel_mode %>\\ntravel_start: <%- travel_start ? date.format('YYYY-MM-DD', travel_start) : '' %>\"\n minRows={3}\n maxRows={10}\n fields={fields.filter((f) => f.key && f.type !== 'separator' && f.type !== 'heading')}\n defaultRawMode={true}\n hideRawToggle={true}\n actionButtons={\n <>\n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'field', 'newNoteFrontmatter')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert field variable\"\n >\n + Field\n \n {\n e.preventDefault()\n e.stopPropagation()\n handleTagInserterButtonClick(e, 'date', 'newNoteFrontmatter')\n }}\n onMouseDown={(e) => {\n e.preventDefault()\n e.stopPropagation()\n }}\n style={{\n fontSize: '0.75rem',\n padding: '0.25rem 0.5rem',\n backgroundColor: '#f0f0f0',\n border: '1px solid #ccc',\n borderRadius: '3px',\n cursor: 'pointer',\n position: 'relative',\n zIndex: 100,\n }}\n title=\"Insert date format\"\n >\n + Date\n \n \n }\n />\n
\n Frontmatter content for the new note. Use template tags like <%- fieldKey %> for form fields. This will be saved to the ```template:ignore newNoteFrontmatter``` codeblock.\n
\n
\n \n )}\n\n {/* Option D: Run JS Only */}\n {processingMethod === 'run-js-only' && (\n <>\n \n
\n JavaScript Template Code:\n \n
\n
\n

\n To use this method, add a TemplateJS Block field to your form fields list. The JavaScript code in that field will be executed when the form is\n submitted.\n

\n

\n Form values are available as variables in the TemplateJS code. No note creation or validation is performed - the code runs directly.\n

\n
\n \n \n )}\n\n {/* Option C: Form Processor */}\n {processingMethod === 'form-processor' && (\n <>\n
\n \n {\n onFrontmatterChange('space', spaceId)\n // Clear template selection when space changes to avoid confusion\n onFrontmatterChange('receivingTemplateTitle', '')\n setSelectedProcessingTemplateFilename('')\n // Reload notes and folders to reflect the new space filter (force reload to ensure fresh data)\n // Pass spaceId directly to avoid reading stale frontmatter.space value\n onLoadNotes(true, true, spaceId).catch((error) => {\n console.error('Error reloading notes after space change:', error)\n })\n onLoadFolders(true, spaceId).catch((error) => {\n console.error('Error reloading folders after space change:', error)\n })\n }}\n placeholder=\"Select space (Private or Teamspace)\"\n compactDisplay={true}\n requestFromPlugin={requestFromPlugin}\n showValue={false}\n width=\"100%\"\n />\n
\n {frontmatter.space ? 'Only templates from the selected space will be shown' : 'Private notes (default) - only private templates will be shown'}\n
\n
\n
\n \n \n
\n {\n // Ensure we're setting the note title (not filename) to receivingTemplateTitle\n const trimmedTitle = noteTitle ? noteTitle.trim() : ''\n logDebug(\n pluginData,\n `ProcessingMethodSection: NoteChooser onChange called: noteTitle=\"${noteTitle}\", noteFilename=\"${noteFilename}\", trimmedTitle=\"${trimmedTitle}\"`,\n )\n setSelectedProcessingTemplateFilename(noteFilename || '')\n if (trimmedTitle) {\n logDebug(pluginData, `ProcessingMethodSection: Setting receivingTemplateTitle to: \"${trimmedTitle}\"`)\n onFrontmatterChange('receivingTemplateTitle', trimmedTitle)\n // Clear deprecated formProcessorTitle if present (migration cleanup)\n if (frontmatter.formProcessorTitle) {\n onFrontmatterChange('formProcessorTitle', '')\n }\n } else {\n logDebug(pluginData, 'ProcessingMethodSection: Clearing receivingTemplateTitle')\n onFrontmatterChange('receivingTemplateTitle', '')\n if (frontmatter.formProcessorTitle) {\n onFrontmatterChange('formProcessorTitle', '')\n }\n }\n }}\n placeholder=\"Select processing template\"\n includePersonalNotes={true}\n includeCalendarNotes={false}\n includeRelativeNotes={false}\n includeTeamspaceNotes={true}\n spaceFilter={frontmatter.space || ''}\n filterByType={['forms-processor', 'template-runner']}\n includeTemplatesAndForms={true}\n allowBackwardsCompatible={true}\n requestFromPlugin={requestFromPlugin}\n onNotesChanged={() => {\n onLoadNotes(true) // Load only project notes for processing templates (faster)\n }}\n onOpen={() => {\n // Lazy load notes when dropdown opens - always reload to ensure fresh data\n // For processing templates, only need project notes (faster)\n onLoadNotes(true, true).catch((error) => {\n console.error('Error loading notes:', error)\n })\n }}\n isLoading={notes.length === 0 && loadingNotes}\n showCalendarChooserIcon={false}\n shortDescriptionOnLine2={true}\n />\n
\n {(selectedProcessingTemplateFilename || frontmatter.receivingTemplateTitle || frontmatter.formProcessorTitle) && (\n {\n try {\n // If we have a filename, use it; otherwise try to find it from the title\n let filenameToOpen = selectedProcessingTemplateFilename\n const currentTitle = frontmatter.receivingTemplateTitle || frontmatter.formProcessorTitle || ''\n\n logDebug(\n pluginData,\n `ProcessingMethodSection: Open button clicked: selectedProcessingTemplateFilename=\"${selectedProcessingTemplateFilename}\", currentTitle=\"${currentTitle}\", notes.length=${notes.length}`,\n )\n\n // If no filename, try to find it from notes\n if (!filenameToOpen && currentTitle) {\n // If notes aren't loaded yet, load them directly via requestFromPlugin\n // This ensures we have the notes data immediately in this async function\n let notesToSearch = notes\n if (notes.length === 0) {\n logDebug(pluginData, `ProcessingMethodSection: Notes not loaded, loading notes for processing templates via requestFromPlugin...`)\n try {\n const notesData = unwrapPluginRequestData(\n await requestFromPlugin('getNotes', {\n includePersonalNotes: true,\n includeCalendarNotes: false, // Skip calendar notes for processing templates (performance)\n includeRelativeNotes: false, // Skip relative notes for processing templates\n includeTeamspaceNotes: true,\n space: frontmatter.space || '', // Filter by selected space\n filterByType: ['forms-processor', 'template-runner'],\n includeTemplatesAndForms: true,\n }),\n )\n if (Array.isArray(notesData)) {\n notesToSearch = notesData\n logDebug(pluginData, `ProcessingMethodSection: Loaded ${notesData.length} notes via requestFromPlugin`)\n }\n } catch (error) {\n logDebug(pluginData, `ProcessingMethodSection: Error loading notes: ${error.message}`)\n }\n }\n\n // Try to find the note in the notes array\n if (notesToSearch.length > 0) {\n const matchingNote = notesToSearch.find((note: NoteOption) => note.title === currentTitle)\n if (matchingNote && matchingNote.filename) {\n filenameToOpen = matchingNote.filename\n logDebug(pluginData, `ProcessingMethodSection: Found matching note: filename=\"${matchingNote.filename}\"`)\n } else {\n logDebug(pluginData, `ProcessingMethodSection: No matching note found in ${notesToSearch.length} notes for title=\"${currentTitle}\"`)\n }\n }\n }\n\n if (filenameToOpen) {\n logDebug(pluginData, `ProcessingMethodSection: Opening note with filename=\"${filenameToOpen}\"`)\n unwrapPluginRequestData(\n await requestFromPlugin('openNote', {\n filename: filenameToOpen,\n }),\n )\n } else if (currentTitle) {\n // Fallback: try to open by title directly\n logDebug(pluginData, `ProcessingMethodSection: No filename found, trying to open by title: \"${currentTitle}\"`)\n try {\n unwrapPluginRequestData(\n await requestFromPlugin('openNote', {\n title: currentTitle,\n }),\n )\n } catch (titleError) {\n const errorMsg = `Could not find or open processing template \"${currentTitle}\". Please select the template again.`\n logDebug(pluginData, `ProcessingMethodSection: ${errorMsg}`)\n console.error(errorMsg)\n }\n } else {\n const errorMsg = `Could not find filename for processing template. Please select the template again.`\n logDebug(pluginData, `ProcessingMethodSection: ${errorMsg}`)\n console.error(errorMsg)\n }\n } catch (error) {\n logDebug(pluginData, `ProcessingMethodSection: Error opening note: ${error.message}`)\n console.error('openNote: Error opening note:', error)\n }\n }}\n className=\"PCButton processing-template-open-button\"\n style={{ whiteSpace: 'nowrap', flexShrink: 0 }}\n title={`Open \"${frontmatter.receivingTemplateTitle || frontmatter.formProcessorTitle || ''}\" in NotePlan`}\n >\n Open\n \n )}\n
\n
Select an existing processing template, or create a new one below
\n \n
\n {\n try {\n // This will be handled by the plugin - we'll need to add a request handler\n const envelope = await requestFromPlugin('createProcessingTemplate', {\n formTemplateTitle: templateTitle,\n formTemplateFilename: templateFilename,\n })\n console.log(`createProcessingTemplate: envelope: ${JSON.stringify(envelope)}`)\n if (!envelope.success) {\n console.warn(`createProcessingTemplate: ${envelope.message}`)\n return\n }\n const result = envelope.data\n let processingTitle = null\n let processingFilename = null\n\n if (result && typeof result === 'string') {\n processingTitle = result\n } else if (result && typeof result === 'object' && result.processingTitle) {\n processingTitle = result.processingTitle\n processingFilename = result.processingFilename || null\n }\n\n if (processingTitle) {\n console.log(`createProcessingTemplate: Updating receivingTemplateTitle to: ${processingTitle}, filename: ${processingFilename || 'null'}`)\n onFrontmatterChange('receivingTemplateTitle', processingTitle)\n if (processingFilename) {\n setSelectedProcessingTemplateFilename(processingFilename)\n }\n await onLoadNotes(true) // Load only project notes for processing templates\n } else {\n console.warn(`createProcessingTemplate: Unexpected data format: ${JSON.stringify(result)}`)\n }\n } catch (error) {\n const errorMessage = error?.message || error?.toString() || String(error) || 'Unknown error'\n const errorStack = error?.stack || 'No stack trace'\n console.error('createProcessingTemplate: Error creating processing template:', {\n error,\n message: errorMessage,\n stack: errorStack,\n type: typeof error,\n stringified: JSON.stringify(error),\n })\n }\n }}\n className=\"PCButton\"\n style={{ width: '100%', marginTop: '0.5rem' }}\n >\n Create New Processing Template\n \n
Creates a new processing template and links it to this form
\n
\n \n )}\n\n {/* Debug JSON Viewer */}\n {false && (\n
\n \n \n {JSON.stringify(\n {\n processingMethod: frontmatter.processingMethod,\n shouldOpenInEditor: frontmatter.shouldOpenInEditor,\n getNoteTitled: frontmatter.getNoteTitled,\n getNoteFilename: frontmatter.getNoteFilename,\n location: frontmatter.location,\n writeUnderHeading: frontmatter.writeUnderHeading,\n replaceNoteContents: frontmatter.replaceNoteContents,\n createMissingHeading: frontmatter.createMissingHeading,\n newNoteTitle: frontmatter.newNoteTitle,\n newNoteFolder: frontmatter.newNoteFolder,\n templateBody: frontmatter.templateBody,\n receivingTemplateTitle: frontmatter.receivingTemplateTitle,\n },\n null,\n 2,\n )}\n
\n
\n Current frontmatter values for debugging. This shows what will be saved.\n
\n \n )}\n\n {/* Template Tag Inserter Modal */}\n {showTagInserter && (\n {\n setShowTagInserter(false)\n setTagInserterAnchorElement(null)\n }}\n anchorElement={tagInserterAnchorElement}\n onInsert={(tag: string) => {\n // Insert tag at cursor position\n if (tagInserterInputRef && tagInserterFieldKey) {\n const start = tagInserterInputRef.selectionStart || 0\n const end = tagInserterInputRef.selectionEnd || 0\n const currentValue = tagInserterInputRef.value || ''\n const newValue = currentValue.substring(0, start) + tag + currentValue.substring(end)\n\n // Update the field based on the tracked field key\n onFrontmatterChange(tagInserterFieldKey, newValue)\n\n // Set cursor position after inserted text\n setTimeout(() => {\n tagInserterInputRef.focus()\n const newCursorPos = start + tag.length\n tagInserterInputRef.setSelectionRange(newCursorPos, newCursorPos)\n }, 0)\n }\n }}\n fields={fields\n .filter((f) => f.key && f.type !== 'separator' && f.type !== 'heading' && f.type !== 'templatejs-block')\n .map((f) => ({ key: f.key || '', label: f.label, type: f.type }))}\n showDateFormats={true}\n mode={tagInserterMode}\n />\n )}\n \n )\n}\n\nexport default ProcessingMethodSection\n" }, { "path": "dwertheimer.Forms/src/components/TemplateTagEditor.css", "content": "/* TemplateTagEditor Component Styles */\n\n.template-tag-editor {\n position: relative;\n width: 100%;\n}\n\n/* Toggle Switch Styles */\n.template-tag-editor-toggle {\n margin-bottom: 0.5rem;\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.5rem;\n}\n\n.template-tag-editor-action-buttons {\n display: flex;\n gap: 0.25rem;\n align-items: center;\n position: relative;\n z-index: 10;\n pointer-events: auto;\n}\n\n.template-tag-editor-action-buttons button {\n pointer-events: auto;\n position: relative;\n z-index: 10;\n}\n\n.template-tag-toggle-switch {\n display: flex;\n align-items: center;\n gap: 0.5rem;\n cursor: pointer;\n user-select: none;\n}\n\n.template-tag-toggle-switch input[type=\"checkbox\"] {\n position: absolute;\n opacity: 0;\n width: 0;\n height: 0;\n}\n\n.template-tag-toggle-slider {\n position: relative;\n display: inline-block;\n width: 44px;\n height: 24px;\n background-color: var(--bg-alt-color, #ccc);\n border-radius: 24px;\n transition: background-color 0.3s ease;\n}\n\n.template-tag-toggle-slider::before {\n content: '';\n position: absolute;\n width: 18px;\n height: 18px;\n left: 3px;\n top: 3px;\n background-color: white;\n border-radius: 50%;\n transition: transform 0.3s ease;\n box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);\n}\n\n.template-tag-toggle-switch input[type=\"checkbox\"]:checked + .template-tag-toggle-slider {\n background-color: var(--tint-color, #007aff);\n}\n\n.template-tag-toggle-switch input[type=\"checkbox\"]:checked + .template-tag-toggle-slider::before {\n transform: translateX(20px);\n}\n\n.template-tag-toggle-label {\n font-size: 0.85rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n}\n\n/* Raw mode textarea */\n.template-tag-editor-raw {\n width: 100%;\n padding: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n font-family: Menlo, monospace;\n font-size: 0.9em;\n background-color: var(--bg-main-color, #fff);\n color: var(--fg-main-color, #333);\n}\n\n.template-tag-editor-raw:focus {\n outline: none;\n border-color: var(--tint-color, #007aff);\n box-shadow: 0 0 0 2px rgba(0, 122, 255, 0.1);\n}\n\n/* Pill mode wrapper */\n.template-tag-editor-pills-wrapper {\n display: flex;\n flex-direction: column;\n gap: 0.5rem;\n position: relative;\n}\n\n/* Pill mode container */\n.template-tag-editor-pills-container {\n position: relative;\n min-height: 3em;\n padding: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n background-color: var(--bg-main-color, #fff);\n cursor: text;\n}\n\n.template-tag-editor-pills-container:focus-within {\n border-color: var(--tint-color, #007aff);\n box-shadow: 0 0 0 2px rgba(0, 122, 255, 0.1);\n}\n\n.template-tag-editor-pills {\n display: flex;\n flex-wrap: wrap;\n gap: 0.25rem;\n align-items: center;\n min-height: 1.5em;\n position: relative;\n z-index: 2;\n}\n\n/* Pill styles */\n.template-tag-pill {\n display: inline-flex;\n align-items: center;\n padding: 0.25rem 0.5rem;\n border-radius: 2px;\n font-size: 0.85rem;\n line-height: 1.4;\n transition: all 0.2s ease;\n user-select: none;\n font-family: Menlo, monospace; /* Monospace for all pills */\n position: relative;\n}\n\n.template-tag-pill-tag {\n background-color: var(--tint-color, #007aff);\n color: white;\n font-weight: 500;\n border: 1px solid var(--tint-color, #007aff);\n cursor: grab;\n}\n\n.template-tag-pill-tag:active {\n cursor: text; /* I-beam cursor when dragging */\n}\n\n.template-tag-pill-tag:hover {\n filter: brightness(90%);\n transform: translateY(-1px);\n box-shadow: 0 2px 4px rgba(0, 122, 255, 0.2);\n}\n\n.template-tag-pill-tag.template-tag-pill-selected {\n filter: brightness(90%);\n box-shadow: 0 0 0 2px rgba(0, 122, 255, 0.3);\n}\n\n.template-tag-pill-tag.template-tag-pill-dragging {\n opacity: 0.5;\n cursor: text; /* I-beam cursor when dragging */\n}\n\n.template-tag-pill-text {\n background-color: var(--bg-alt-color, #f5f5f5);\n color: var(--fg-main-color, #333);\n border: 1px solid var(--divider-color, #CDCFD0);\n cursor: grab;\n font-family: Menlo, monospace; /* Monospace for text pills */\n white-space: pre-wrap; /* Preserve whitespace and newlines for display */\n}\n\n.template-tag-pill-text:active {\n cursor: text; /* I-beam cursor when dragging */\n}\n\n.template-tag-pill-text:hover {\n background-color: var(--bg-hover-color, #e8e8e8);\n border-color: var(--tint-color, #007aff);\n}\n\n.template-tag-pill-text.template-tag-pill-dragging {\n opacity: 0.5;\n cursor: text; /* I-beam cursor when dragging */\n}\n\n.template-tag-pill-text.template-tag-pill-editing {\n background-color: white;\n border: 2px solid var(--tint-color, #007aff);\n padding: 0.2rem 0.4rem;\n min-width: 100px;\n font-size: 0.85rem;\n cursor: text;\n}\n\n.template-tag-pill-label {\n margin-right: 0.25rem;\n}\n\n.template-tag-pill-delete {\n background: none;\n border: none;\n color: white;\n font-size: 1.2em;\n line-height: 1;\n padding: 0;\n margin-left: 0.25rem;\n cursor: pointer;\n opacity: 0.8;\n transition: opacity 0.2s ease;\n display: flex;\n align-items: center;\n justify-content: center;\n width: 16px;\n height: 16px;\n}\n\n.template-tag-pill-delete:hover {\n opacity: 1;\n transform: scale(1.2);\n}\n\n.template-tag-pill-text .template-tag-pill-delete {\n color: var(--fg-main-color, #333);\n}\n\n/* Drop indicator line - vertical cursor */\n.template-tag-drop-indicator {\n width: 2px;\n height: 1.5em;\n background-color: var(--tint-color, #007aff);\n margin: 0 0.125rem;\n border-radius: 1px;\n box-shadow: 0 0 4px rgba(0, 122, 255, 0.5);\n display: inline-block;\n vertical-align: middle;\n animation: blink 1s infinite;\n}\n\n@keyframes blink {\n 0%, 50% { opacity: 1; }\n 51%, 100% { opacity: 0.3; }\n}\n\n/* Drop zone for between pills */\n.template-tag-drop-zone {\n display: inline-block;\n min-height: 1.5em;\n min-width: 4px;\n cursor: text; /* I-beam cursor */\n transition: background-color 0.2s ease;\n vertical-align: middle;\n position: relative;\n}\n\n.template-tag-drop-zone-end {\n min-width: 20px;\n}\n\n.template-tag-drop-zone:hover {\n background-color: rgba(0, 122, 255, 0.1);\n}\n\n.template-tag-drop-zone::before {\n content: '';\n position: absolute;\n left: 50%;\n top: 0;\n bottom: 0;\n width: 2px;\n background-color: transparent;\n transform: translateX(-50%);\n transition: background-color 0.2s ease;\n}\n\n.template-tag-drop-zone:hover::before {\n background-color: var(--tint-color, #007aff);\n}\n\n/* Empty state */\n.template-tag-editor-empty {\n padding: 0.5rem;\n color: var(--fg-placeholder-color, rgba(76, 79, 105, 0.7));\n font-style: italic;\n font-size: 0.85rem;\n font-family: Menlo, monospace;\n}\n\n/* Textarea for editing (hidden in pill mode, visible for typing) */\n.template-tag-editor-textarea {\n width: 100%;\n padding: 0.5rem;\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n font-family: Menlo, monospace; /* Monospace */\n font-size: 0.9em;\n background-color: var(--bg-main-color, #fff);\n color: var(--fg-main-color, #333);\n}\n\n.template-tag-editor-textarea:focus {\n outline: none;\n border-color: var(--tint-color, #007aff);\n box-shadow: 0 0 0 2px rgba(0, 122, 255, 0.1);\n}\n\n/* Sync textarea - overlays pills container */\n.template-tag-editor-sync-textarea {\n caret-color: var(--tint-color, #007aff);\n color: transparent; /* Make text transparent so pills show through */\n caret-shape: block; /* Show block cursor */\n}\n\n/* Ensure cursor is visible */\n.template-tag-editor-pills-container:focus-within .template-tag-editor-sync-textarea {\n caret-color: var(--tint-color, #007aff);\n}\n\n.template-tag-editor-sync-textarea::selection {\n background-color: rgba(0, 122, 255, 0.2);\n}\n" }, { "path": "dwertheimer.Forms/src/components/TemplateTagEditor.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// TemplateTagEditor Component\n// A user-friendly editor for template tags that displays them as interactive pills\n//--------------------------------------------------------------------------\n\nimport React, { useState, useMemo, useRef, useEffect, useCallback } from 'react'\nimport './TemplateTagEditor.css'\n\nexport type TemplateTagPill = {\n id: string,\n type: 'tag' | 'text',\n content: string, // For tags: the full tag like \"<%- field1 %>\", for text: the text content\n label: string, // Display label for tags (e.g., \"field1\" or \"Date: YYYY-MM-DD\")\n startIndex: number, // Original position in the text\n endIndex: number, // Original end position in the text\n}\n\nexport type TemplateTagEditorProps = {\n value: string,\n onChange: (value: string) => void,\n onFocus?: (e: FocusEvent) => void,\n onBlur?: (e: FocusEvent) => void,\n placeholder?: string,\n minRows?: number,\n maxRows?: number,\n fields?: Array<{ key: string, label: string }>, // For displaying field labels\n className?: string,\n style?: { [key: string]: any },\n actionButtons?: React$Node, // Buttons to display in the toggle area\n defaultRawMode?: boolean, // If true, start in raw mode (default: false)\n hideRawToggle?: boolean, // If true, hide the raw mode toggle switch (default: false)\n}\n\n/**\n * Parse template tags from text and extract information\n * @param {string} text - The text to parse\n * @param {Array<{key: string, label: string}>} fields - Available form fields for label lookup\n * @returns {Array} Array of pills (tags and text segments)\n */\nfunction parseTemplateTags(text: string, fields: Array<{ key: string, label: string }> = []): Array {\n if (!text) return []\n\n const pills: Array = []\n const TAG_PATTERN = /<%-?\\s*([^%]+?)\\s*-?%>/g\n let lastIndex = 0\n let match\n let pillId = 0\n\n while ((match = TAG_PATTERN.exec(text)) !== null) {\n if (!match || match.index === undefined) continue\n const fullTag = match[0] || ''\n const tagContent = (match[1] || '').trim()\n const startIndex = match.index\n const endIndex = startIndex + fullTag.length\n\n // Add text before this tag\n if (startIndex > lastIndex) {\n const textContent = text.substring(lastIndex, startIndex)\n if (textContent) {\n pills.push({\n id: `text-${pillId++}`,\n type: 'text',\n content: textContent,\n label: textContent,\n startIndex: lastIndex,\n endIndex: startIndex,\n })\n }\n }\n\n // Parse tag content to determine label\n let label = tagContent\n if (tagContent.startsWith('date.format(')) {\n // Extract date format\n const formatMatch = tagContent.match(/date\\.format\\([\"']([^\"']+)[\"']\\)/)\n if (formatMatch) {\n label = `Date: ${formatMatch[1]}`\n } else {\n label = 'Date Format'\n }\n } else if (tagContent.includes('.')) {\n // Handle other function calls\n const parts = tagContent.split('.')\n label = parts[0] || tagContent\n } else {\n // Look up field label\n const field = fields.find((f) => f.key === tagContent)\n label = field ? field.label : tagContent\n }\n\n // Add tag pill\n pills.push({\n id: `tag-${pillId++}`,\n type: 'tag',\n content: fullTag,\n label: label,\n startIndex: startIndex,\n endIndex: endIndex,\n })\n\n lastIndex = endIndex\n }\n\n // Add remaining text\n if (lastIndex < text.length) {\n const textContent = text.substring(lastIndex)\n if (textContent) {\n pills.push({\n id: `text-${pillId++}`,\n type: 'text',\n content: textContent,\n label: textContent,\n startIndex: lastIndex,\n endIndex: text.length,\n })\n }\n }\n\n return pills\n}\n\n/**\n * Reconstruct text from pills\n * @param {Array} pills - Array of pills\n * @returns {string} Reconstructed text\n */\nfunction reconstructText(pills: Array): string {\n return pills.map((pill) => (pill.type === 'tag' ? pill.content : pill.content)).join('')\n}\n\n// Removed displayTextWithSpaces function - now showing text directly with whitespace preserved\n\n/**\n * TemplateTagEditor Component\n * Displays template tags as interactive pills with a toggle for raw mode\n */\nexport function TemplateTagEditor({\n value = '',\n onChange,\n onFocus,\n onBlur,\n placeholder = '',\n minRows = 3,\n maxRows = 10,\n fields = [],\n className = '',\n style = {},\n actionButtons,\n defaultRawMode = false,\n hideRawToggle = false,\n}: TemplateTagEditorProps): React$Node {\n const [showRaw, setShowRaw] = useState(defaultRawMode)\n const [pills, setPills] = useState>([])\n const [selectedPillId, setSelectedPillId] = useState(null)\n const [editingTextIndex, setEditingTextIndex] = useState(null)\n const [editingTextValue, setEditingTextValue] = useState('')\n const [draggedPillId, setDraggedPillId] = useState(null)\n const [dragOverIndex, setDragOverIndex] = useState(null)\n const [dragOverPosition, setDragOverPosition] = useState<'before' | 'after' | null>(null)\n const [cursorPosition, setCursorPosition] = useState(null) // Position in pills array where cursor should be\n const [editingPillId, setEditingPillId] = useState(null) // Pill being edited in raw mode\n const containerRef = useRef(null)\n const textareaRef = useRef(null)\n const pillsContainerRef = useRef(null)\n\n // Parse pills from value\n useEffect(() => {\n if (!showRaw) {\n const parsedPills = parseTemplateTags(value, fields)\n setPills(parsedPills)\n }\n }, [value, fields, showRaw])\n\n // Handle pill deletion\n const handleDeletePill = useCallback(\n (pillId: string) => {\n const newPills = pills.filter((p) => p.id !== pillId)\n const newValue = reconstructText(newPills)\n setPills(newPills)\n onChange(newValue)\n },\n [pills, onChange],\n )\n\n // Handle text editing\n const handleTextEdit = useCallback(\n (index: number) => {\n const pill = pills[index]\n if (pill && pill.type === 'text') {\n setEditingTextIndex(index)\n setEditingTextValue(pill.content)\n }\n },\n [pills],\n )\n\n // Handle text edit save\n const handleTextEditSave = useCallback(() => {\n if (editingTextIndex !== null && editingTextIndex !== undefined && editingTextIndex >= 0 && editingTextIndex < pills.length) {\n const newPills = [...pills]\n const existingPill = newPills[editingTextIndex]\n if (existingPill) {\n newPills[editingTextIndex] = {\n ...existingPill,\n content: editingTextValue,\n label: editingTextValue,\n }\n const newValue = reconstructText(newPills)\n setPills(newPills)\n onChange(newValue)\n }\n }\n setEditingTextIndex(null)\n setEditingTextValue('')\n setEditingPillId(null)\n }, [editingTextIndex, editingTextValue, pills, onChange])\n\n // Handle text edit cancel\n const handleTextEditCancel = useCallback(() => {\n setEditingTextIndex(null)\n setEditingTextValue('')\n setEditingPillId(null)\n }, [])\n\n // Handle pill click\n const handlePillClick = useCallback((pillId: string, e: SyntheticMouseEvent) => {\n e.stopPropagation()\n setSelectedPillId(pillId)\n }, [])\n\n // Handle drag start\n const handleDragStart = useCallback((pillId: string, e: SyntheticDragEvent) => {\n setDraggedPillId(pillId)\n e.dataTransfer.effectAllowed = 'move'\n e.dataTransfer.setData('text/plain', pillId)\n // Set I-beam cursor\n if (e.target instanceof HTMLElement) {\n e.target.style.cursor = 'text'\n }\n }, [])\n\n // Handle drag over\n const handleDragOver = useCallback(\n (index: number, position: 'before' | 'after', e: SyntheticDragEvent) => {\n e.preventDefault()\n e.stopPropagation()\n e.dataTransfer.dropEffect = 'move'\n\n // Update drag over state for real-time feedback\n setDragOverIndex(index)\n setDragOverPosition(position)\n\n // If dragging over a text pill, allow splitting it\n const pill = pills[index]\n if (pill && pill.type === 'text' && draggedPillId && draggedPillId !== pill.id) {\n const rect = e.currentTarget.getBoundingClientRect()\n const midPoint = rect.left + rect.width / 2\n const newPosition = e.clientX < midPoint ? 'before' : 'after'\n setDragOverPosition(newPosition)\n }\n },\n [pills, draggedPillId],\n )\n\n // Handle drag leave\n const handleDragLeave = useCallback(() => {\n setDragOverIndex(null)\n setDragOverPosition(null)\n }, [])\n\n // Handle drop\n const handleDrop = useCallback(\n (dropIndex: number, position: 'before' | 'after', e: SyntheticDragEvent) => {\n e.preventDefault()\n e.stopPropagation()\n\n if (!draggedPillId) {\n setDraggedPillId(null)\n setDragOverIndex(null)\n setDragOverPosition(null)\n return\n }\n\n const draggedIndex = pills.findIndex((p) => p.id === draggedPillId)\n if (draggedIndex === -1) {\n setDraggedPillId(null)\n setDragOverIndex(null)\n setDragOverPosition(null)\n return\n }\n\n const newPills = [...pills]\n const draggedPill = newPills[draggedIndex]\n const dropPill = newPills[dropIndex]\n\n if (!draggedPill) {\n setDraggedPillId(null)\n setDragOverIndex(null)\n setDragOverPosition(null)\n return\n }\n\n // If dropping on a text pill, split it at the drop position\n if (dropPill && dropPill.type === 'text' && draggedPillId !== dropPill.id) {\n const rect = e.currentTarget.getBoundingClientRect()\n const midPoint = rect.left + rect.width / 2\n const actualPosition = e.clientX < midPoint ? 'before' : 'after'\n\n // Remove dragged pill first\n newPills.splice(draggedIndex, 1)\n\n // Adjust drop index if we removed an item before it\n const adjustedDropIndex = draggedIndex < dropIndex ? dropIndex - 1 : dropIndex\n const targetPill = newPills[adjustedDropIndex]\n\n if (targetPill && targetPill.type === 'text') {\n // Split text pill at cursor position (approximate - use midpoint for now)\n const textContent = targetPill.content\n const splitPoint = Math.floor(textContent.length / 2)\n const beforeText = textContent.substring(0, splitPoint)\n const afterText = textContent.substring(splitPoint)\n\n // Create new pills array with split text\n const splitPills: Array = []\n if (beforeText) {\n splitPills.push({\n ...targetPill,\n id: `${targetPill.id}-before`,\n content: beforeText,\n label: beforeText,\n })\n }\n splitPills.push(draggedPill)\n if (afterText) {\n splitPills.push({\n ...targetPill,\n id: `${targetPill.id}-after`,\n content: afterText,\n label: afterText,\n })\n }\n\n // Replace target pill with split pills\n newPills.splice(adjustedDropIndex, 1, ...splitPills)\n } else {\n // Insert before or after based on position\n const insertIndex = actualPosition === 'before' ? adjustedDropIndex : adjustedDropIndex + 1\n newPills.splice(insertIndex, 0, draggedPill)\n }\n } else {\n // Normal drop - remove and reinsert\n newPills.splice(draggedIndex, 1)\n\n // Calculate insert index\n let insertIndex = dropIndex\n if (draggedIndex < dropIndex) {\n insertIndex = dropIndex - 1\n }\n\n if (position === 'after') {\n insertIndex += 1\n }\n\n newPills.splice(insertIndex, 0, draggedPill)\n }\n\n const newValue = reconstructText(newPills)\n setPills(newPills)\n onChange(newValue)\n\n setDraggedPillId(null)\n setDragOverIndex(null)\n setDragOverPosition(null)\n },\n [draggedPillId, pills, onChange],\n )\n\n // Handle drag end\n const handleDragEnd = useCallback(() => {\n setDraggedPillId(null)\n setDragOverIndex(null)\n setDragOverPosition(null)\n }, [])\n\n // Handle raw mode toggle\n const handleRawToggle = useCallback(() => {\n if (showRaw) {\n // Switching from raw to pill mode - parse the current value\n const parsedPills = parseTemplateTags(value, fields)\n setPills(parsedPills)\n }\n setShowRaw(!showRaw)\n }, [showRaw, value, fields])\n\n // Handle raw textarea change\n const handleRawChange = useCallback(\n (e: SyntheticInputEvent) => {\n onChange(e.target.value)\n },\n [onChange],\n )\n\n // Handle container click to position cursor\n const handleContainerClick = useCallback(\n (e: SyntheticMouseEvent) => {\n if (!pillsContainerRef.current || !textareaRef.current) return\n\n const container = pillsContainerRef.current\n const rect = container.getBoundingClientRect()\n const clickX = e.clientX - rect.left\n const clickY = e.clientY - rect.top\n\n // Find which pill or gap was clicked\n const children = Array.from(container.querySelectorAll('.template-tag-pill, .template-tag-drop-zone'))\n let clickedIndex = -1\n let position: 'before' | 'after' = 'after'\n\n for (let i = 0; i < children.length; i++) {\n const child = (children[i]: any)\n if (!(child instanceof HTMLElement)) continue\n const childRect = child.getBoundingClientRect()\n const childLeft = childRect.left - rect.left\n const childRight = childRect.right - rect.left\n\n if (clickX >= childLeft && clickX <= childRight) {\n // Clicked on a pill or drop zone\n const midPoint = childLeft + (childRight - childLeft) / 2\n position = clickX < midPoint ? 'before' : 'after'\n\n // Find the corresponding pill index\n const pillId = child.getAttribute('data-pill-id') || child.getAttribute('data-drop-zone-index')\n if (pillId) {\n clickedIndex = pills.findIndex((p) => p.id === pillId)\n if (clickedIndex === -1) {\n // Might be a drop zone index\n const dropZoneIndex = parseInt(pillId, 10)\n if (!isNaN(dropZoneIndex)) {\n clickedIndex = dropZoneIndex\n }\n }\n }\n break\n }\n }\n\n // If clicked at the end (after last pill), position cursor at the end of the text\n if (clickedIndex === -1) {\n const textarea = textareaRef.current\n if (textarea) {\n const textLength = value.length\n textarea.focus()\n textarea.setSelectionRange(textLength, textLength)\n }\n } else {\n // Calculate cursor position in the text\n let cursorPos = 0\n for (let i = 0; i < pills.length; i++) {\n if (i === clickedIndex) {\n if (position === 'before') {\n break\n } else {\n cursorPos += pills[i].content.length\n break\n }\n }\n cursorPos += pills[i].content.length\n }\n const textarea = textareaRef.current\n if (textarea) {\n textarea.setSelectionRange(cursorPos, cursorPos)\n }\n }\n },\n [pills, value],\n )\n\n // Handle pill mode textarea change\n const handlePillModeTextareaChange = useCallback(\n (e: SyntheticInputEvent) => {\n const newValue = e.target.value\n // Parse and update pills in real-time\n const parsedPills = parseTemplateTags(newValue, fields)\n setPills(parsedPills)\n onChange(newValue)\n },\n [fields, onChange],\n )\n\n // Render pills\n const renderPills = useMemo(() => {\n return pills.map((pill, index) => {\n const isDragging = draggedPillId === pill.id\n const isDragOver = dragOverIndex === index\n const showDropIndicatorBefore = isDragOver && dragOverPosition === 'before' && draggedPillId !== pill.id\n const showDropIndicatorAfter = isDragOver && dragOverPosition === 'after' && draggedPillId !== pill.id\n\n if (pill.type === 'tag') {\n return (\n \n {/* Drop indicator before */}\n {showDropIndicatorBefore &&
}\n {\n e.stopPropagation()\n handlePillClick(pill.id, e)\n // Focus textarea and position cursor\n const textarea = textareaRef.current\n if (textarea) {\n textarea.focus()\n let cursorPos = 0\n for (let i = 0; i < index; i++) {\n cursorPos += pills[i].content.length\n }\n // Position cursor after this pill\n cursorPos += pill.content.length\n textarea.setSelectionRange(cursorPos, cursorPos)\n }\n }}\n onDoubleClick={(e) => {\n e.stopPropagation()\n // Turn on RAW mode when double-clicking a pill\n if (!showRaw) {\n setShowRaw(true)\n }\n }}\n draggable={true}\n onDragStart={(e) => handleDragStart(pill.id, e)}\n onDragOver={(e) => {\n const rect = e.currentTarget.getBoundingClientRect()\n const midPoint = rect.left + rect.width / 2\n const position = e.clientX < midPoint ? 'before' : 'after'\n handleDragOver(index, position, e)\n }}\n onDragLeave={handleDragLeave}\n onDrop={(e) => handleDrop(index, dragOverPosition || 'before', e)}\n onDragEnd={handleDragEnd}\n title={pill.content}\n style={{ cursor: isDragging ? 'text' : 'grab' }}\n >\n {showDropIndicatorBefore &&
}\n {pill.label}\n {\n e.stopPropagation()\n handleDeletePill(pill.id)\n }}\n title=\"Delete tag\"\n >\n ×\n \n {showDropIndicatorAfter &&
}\n
\n {/* Drop zone for between pills - also clickable for text input */}\n {index < pills.length - 1 && (\n {\n e.stopPropagation()\n // Focus textarea and position cursor between pills\n const textarea = textareaRef.current\n if (textarea) {\n textarea.focus()\n let cursorPos = 0\n for (let i = 0; i <= index; i++) {\n cursorPos += pills[i].content.length\n }\n textarea.setSelectionRange(cursorPos, cursorPos)\n }\n }}\n onDragOver={(e) => handleDragOver(index + 1, 'before', e)}\n onDragLeave={handleDragLeave}\n onDrop={(e) => handleDrop(index + 1, dragOverPosition || 'before', e)}\n />\n )}\n \n )\n } else {\n // Text pill - editable\n if (editingTextIndex === index) {\n return (\n setEditingTextValue(e.target.value)}\n onBlur={handleTextEditSave}\n onKeyDown={(e) => {\n if (e.key === 'Enter') {\n e.preventDefault()\n handleTextEditSave()\n } else if (e.key === 'Escape') {\n e.preventDefault()\n handleTextEditCancel()\n }\n }}\n autoFocus={true}\n style={{ fontFamily: 'Menlo, monospace' }}\n />\n )\n } else {\n return (\n \n {/* Drop indicator before */}\n {showDropIndicatorBefore &&
}\n {\n e.stopPropagation()\n // Focus textarea and position cursor in this text pill\n const textarea = textareaRef.current\n if (textarea) {\n textarea.focus()\n let cursorPos = 0\n for (let i = 0; i < index; i++) {\n cursorPos += pills[i].content.length\n }\n // Position cursor in the middle of this text pill (or at click position)\n const rect = e.currentTarget.getBoundingClientRect()\n const clickX = e.clientX - rect.left\n const midPoint = rect.width / 2\n const charPos = Math.floor((clickX / rect.width) * pill.content.length)\n cursorPos += Math.max(0, Math.min(charPos, pill.content.length))\n textarea.setSelectionRange(cursorPos, cursorPos)\n }\n }}\n onDoubleClick={(e) => {\n e.stopPropagation()\n // Turn on RAW mode when double-clicking a pill\n if (!showRaw) {\n setShowRaw(true)\n }\n }}\n draggable={true}\n onDragStart={(e) => handleDragStart(pill.id, e)}\n onDragOver={(e) => {\n const rect = e.currentTarget.getBoundingClientRect()\n const midPoint = rect.left + rect.width / 2\n const position = e.clientX < midPoint ? 'before' : 'after'\n handleDragOver(index, position, e)\n }}\n onDragLeave={handleDragLeave}\n onDrop={(e) => handleDrop(index, dragOverPosition || 'before', e)}\n onDragEnd={handleDragEnd}\n title=\"Click to position cursor, double-click to edit\"\n style={{ cursor: isDragging ? 'text' : 'text', fontFamily: 'Menlo, monospace' }}\n >\n {showDropIndicatorBefore &&
}\n {pill.content}\n {showDropIndicatorAfter &&
}\n
\n {/* Drop zone for between pills - also clickable for text input */}\n {index < pills.length - 1 && (\n {\n e.stopPropagation()\n // Focus textarea and position cursor between pills\n const textarea = textareaRef.current\n if (textarea) {\n textarea.focus()\n let cursorPos = 0\n for (let i = 0; i <= index; i++) {\n cursorPos += pills[i].content.length\n }\n textarea.setSelectionRange(cursorPos, cursorPos)\n }\n }}\n onDragOver={(e) => handleDragOver(index + 1, 'before', e)}\n onDragLeave={handleDragLeave}\n onDrop={(e) => handleDrop(index + 1, dragOverPosition || 'before', e)}\n />\n )}\n \n )\n }\n }\n })\n }, [\n pills,\n selectedPillId,\n editingTextIndex,\n editingTextValue,\n draggedPillId,\n dragOverIndex,\n dragOverPosition,\n showRaw,\n handlePillClick,\n handleDragStart,\n handleDragOver,\n handleDragLeave,\n handleDrop,\n handleDragEnd,\n handleDeletePill,\n handleTextEdit,\n handleTextEditSave,\n handleTextEditCancel,\n ])\n\n return (\n
\n {/* Toggle switch for raw mode - hidden if hideRawToggle is true */}\n {!hideRawToggle && (\n
\n {actionButtons && (\n {\n // Ensure button clicks work\n e.stopPropagation()\n }}\n onMouseDown={(e) => {\n // Ensure button clicks work\n e.stopPropagation()\n }}\n >\n {actionButtons}\n
\n )}\n \n
\n )}\n {/* Show action buttons even when toggle is hidden */}\n {hideRawToggle && actionButtons && (\n
\n {\n // Ensure button clicks work\n e.stopPropagation()\n }}\n onMouseDown={(e) => {\n // Ensure button clicks work\n e.stopPropagation()\n }}\n >\n {actionButtons}\n
\n
\n )}\n\n {/* Raw mode - simple textarea */}\n {showRaw ? (\n {\n // Allow Tab key to insert a tab character instead of moving focus\n if (e.key === 'Tab' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.preventDefault()\n const textarea = e.currentTarget\n const start = textarea.selectionStart || 0\n const end = textarea.selectionEnd || 0\n const newValue = `${value.substring(0, start)}\\t${value.substring(end)}`\n onChange(newValue)\n // Set cursor position after the inserted tab\n setTimeout(() => {\n textarea.focus()\n const newCursorPos = start + 1\n textarea.setSelectionRange(newCursorPos, newCursorPos)\n }, 0)\n }\n // Ensure Enter key works normally (creates newline in textarea)\n // Stop propagation to prevent DynamicDialog from submitting the form\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let the textarea handle Enter naturally to create newline\n }\n }}\n style={Object.assign(\n {\n width: '100%',\n minHeight: `${minRows * 1.5}em`,\n maxHeight: `${maxRows * 1.5}em`,\n resize: 'vertical',\n fontFamily: 'Menlo, monospace',\n fontSize: '0.9em',\n },\n style || {},\n )}\n className=\"template-tag-editor-raw\"\n />\n ) : (\n /* Pill mode - show pills only, with hidden textarea for typing */\n
\n {/* Pills display */}\n {\n // Don't interfere with textarea clicks\n if ((e.target: any) instanceof HTMLTextAreaElement) {\n return\n }\n setSelectedPillId(null)\n // Focus the hidden textarea when clicking in the container\n if (textareaRef.current) {\n textareaRef.current.focus()\n // Set cursor position based on click location\n handleContainerClick(e)\n }\n }}\n onKeyDown={(e) => {\n // Don't interfere with textarea key events - let them bubble naturally\n // But prevent container from handling Enter if textarea is focused\n if (e.target instanceof HTMLTextAreaElement) {\n return\n }\n }}\n >\n {pills.length > 0 ? (\n <>\n
{renderPills}
\n {/* Drop zone after last pill - allows clicking after the last item to type */}\n {\n e.stopPropagation()\n // Focus textarea and position cursor at the end\n const textarea = textareaRef.current\n if (textarea) {\n textarea.focus()\n const textLength = value.length\n textarea.setSelectionRange(textLength, textLength)\n }\n }}\n onDragOver={(e) => handleDragOver(pills.length, 'before', e)}\n onDragLeave={handleDragLeave}\n onDrop={(e) => handleDrop(pills.length, dragOverPosition || 'before', e)}\n style={{ minWidth: '20px', minHeight: '1.5em', display: 'inline-block' }}\n />\n \n ) : (\n
{placeholder || 'Start typing or use +Field/+Date buttons to add template tags'}
\n )}\n
\n {/* Hidden textarea for syncing and adding new content - positioned to overlay pills container */}\n {\n // Allow Tab key to insert a tab character instead of moving focus\n if (e.key === 'Tab' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.preventDefault()\n const textarea = e.currentTarget\n const start = textarea.selectionStart || 0\n const end = textarea.selectionEnd || 0\n const newValue = `${value.substring(0, start)}\\t${value.substring(end)}`\n onChange(newValue)\n // Set cursor position after the inserted tab\n setTimeout(() => {\n textarea.focus()\n const newCursorPos = start + 1\n textarea.setSelectionRange(newCursorPos, newCursorPos)\n }, 0)\n }\n // Ensure Enter key creates a newline - stop propagation to prevent parent handlers\n if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey) {\n e.stopPropagation()\n // Don't prevent default - let textarea handle Enter naturally to create newline\n }\n }}\n onMouseDown={(e) => {\n // Allow clicks on buttons to work - check if click is on a button\n const target = (e.target: any)\n if (target instanceof HTMLElement && target.closest('.template-tag-editor-action-buttons')) {\n e.stopPropagation()\n return\n }\n }}\n onClick={(e) => {\n // Allow clicks on buttons to work - check if click is on a button\n const target = (e.target: any)\n if (target instanceof HTMLElement && target.closest('.template-tag-editor-action-buttons')) {\n e.stopPropagation()\n return\n }\n }}\n style={Object.assign(\n {\n position: 'absolute',\n top: 0,\n left: 0,\n right: 0,\n bottom: 0,\n opacity: 0,\n width: '100%',\n height: '100%',\n padding: '0.5rem',\n border: 'none',\n background: 'transparent',\n resize: 'none',\n fontFamily: 'Menlo, monospace',\n fontSize: '0.9em',\n lineHeight: '1.4',\n zIndex: 1,\n cursor: 'text',\n pointerEvents: 'auto',\n },\n style || {},\n )}\n className=\"template-tag-editor-sync-textarea\"\n />\n
\n )}\n
\n )\n}\n\nexport default TemplateTagEditor\n" }, { "path": "dwertheimer.Forms/src/components/TemplateTagInserter.css", "content": "/* TemplateTagInserter Component Styles */\n\n.template-tag-inserter-overlay {\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n background-color: rgba(0, 0, 0, 0.5);\n display: flex;\n align-items: center;\n justify-content: center;\n z-index: 10000;\n}\n\n.template-tag-inserter-container {\n background-color: var(--bg-main-color, #fff);\n border-radius: 8px;\n padding: 1rem;\n min-width: 400px;\n max-width: 600px;\n max-height: 80vh;\n box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);\n display: flex;\n flex-direction: column;\n}\n\n.template-tag-inserter-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n margin-bottom: 1rem;\n}\n\n.template-tag-inserter-header h3 {\n margin: 0;\n font-size: 1.2rem;\n color: var(--fg-main-color, #333);\n}\n\n.template-tag-inserter-close {\n background: none;\n border: none;\n font-size: 1.5rem;\n color: var(--fg-main-color, #666);\n cursor: pointer;\n padding: 0;\n width: 2rem;\n height: 2rem;\n display: flex;\n align-items: center;\n justify-content: center;\n border-radius: 4px;\n}\n\n.template-tag-inserter-close:hover {\n background-color: var(--bg-alt-color, #f5f5f5);\n}\n\n/* Ensure SearchableChooser inside TemplateTagInserter has proper styling */\n.template-tag-inserter-container .template-tag-inserter-container {\n width: 100%;\n}\n\n/* Input wrapper should match dropdown width */\n.template-tag-inserter-container .template-tag-inserter-input-wrapper {\n position: relative;\n width: 100%;\n}\n\n/* Input should have proper padding for arrow */\n.template-tag-inserter-container .template-tag-inserter-input {\n width: 100%;\n padding-right: 2.5rem; /* Make room for arrow */\n box-sizing: border-box;\n}\n\n/* Arrow should be inside the input wrapper */\n.template-tag-inserter-container .template-tag-inserter-arrow {\n position: absolute;\n right: 0.75rem;\n top: 50%;\n transform: translateY(-50%);\n color: var(--item-icon-color, #1e66f5);\n pointer-events: none;\n transition: transform 0.2s;\n font-size: 0.75rem;\n z-index: 1;\n}\n\n/* Dropdown should match input width exactly */\n.template-tag-inserter-container .template-tag-inserter-dropdown {\n position: absolute;\n top: 100%;\n left: 0;\n right: 0;\n width: 100%;\n max-height: 200px;\n overflow-y: auto;\n background-color: var(--bg-main-color, #eff1f5);\n border: 1px solid var(--divider-color, #CDCFD0);\n border-top: none;\n border-radius: 0 0 4px 4px;\n box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);\n z-index: 9999;\n margin-top: -1px;\n box-sizing: border-box;\n}\n\n/* Options should have proper background and separators */\n.template-tag-inserter-container .template-tag-inserter-option {\n padding: 0.5rem 0.75rem;\n cursor: pointer;\n border-bottom: 1px solid var(--divider-color, #CDCFD0);\n color: var(--fg-main-color, #4c4f69);\n font-size: 0.9rem;\n background-color: var(--bg-main-color, #eff1f5);\n display: flex;\n align-items: center;\n justify-content: space-between;\n gap: 0.5rem;\n}\n\n.template-tag-inserter-container .template-tag-inserter-option:last-child {\n border-bottom: none;\n}\n\n.template-tag-inserter-container .template-tag-inserter-option:hover {\n background-color: var(--bg-alt-color, #f5f5f5);\n}\n\n/* Backdrop for dropdown mode */\n.template-tag-inserter-backdrop {\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n z-index: 9999;\n background: transparent;\n}\n\n/* Dropdown container */\n.template-tag-inserter-dropdown {\n background: var(--bg-main-color, #fff);\n border: 1px solid var(--divider-color, #CDCFD0);\n border-radius: 4px;\n box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n padding: 0.5rem;\n max-height: 70vh;\n min-height: 200px;\n overflow: visible;\n display: flex;\n flex-direction: column;\n}\n\n/* Ensure SearchableChooser inside dropdown can expand */\n.template-tag-inserter-dropdown .template-tag-inserter-container {\n display: flex;\n flex-direction: column;\n flex: 1;\n min-height: 0;\n position: relative;\n overflow: visible;\n}\n\n/* Allow the SearchableChooser dropdown list to expand properly */\n.template-tag-inserter-dropdown .template-tag-inserter-container .template-tag-inserter-dropdown {\n position: absolute;\n top: 100%;\n left: 0;\n right: 0;\n max-height: 50vh;\n min-height: 150px;\n overflow-y: auto;\n z-index: 10001;\n}\n\n" }, { "path": "dwertheimer.Forms/src/components/TemplateTagInserter.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// TemplateTagInserter Component\n// A SearchableChooser-based component for inserting template tags into text fields\n//--------------------------------------------------------------------------\n\nimport React, { useState, useMemo, useEffect, useRef } from 'react'\nimport { createPortal } from 'react-dom'\nimport SearchableChooser, { type ChooserConfig } from '@helpers/react/DynamicDialog/SearchableChooser'\nimport { truncateText } from '@helpers/react/reactUtils.js'\nimport moment from 'moment/min/moment-with-locales'\nimport './TemplateTagInserter.css'\n\nexport type TemplateTagOption = {\n label: string,\n value: string,\n description?: string,\n category?: ?string, // Can be null to hide category\n}\n\nexport type TemplateTagInserterProps = {\n isOpen: boolean,\n onClose: () => void,\n onInsert: (tag: string) => void,\n fieldKeys?: Array, // Available form field keys for <%- fieldKey %> (deprecated - use fields instead)\n fields?: Array<{ key: string, label?: string, type?: string }>, // Available form fields with keys and labels\n showDateFormats?: boolean, // Show date format options\n mode?: 'field' | 'date' | 'both', // Mode: 'field' = only fields, 'date' = only dates, 'both' = both (default)\n anchorElement?: ?HTMLElement, // Element to position dropdown relative to (button that was clicked)\n}\n\n/**\n * TemplateTagInserter Component\n * A searchable dropdown for selecting template tags to insert\n * @param {TemplateTagInserterProps} props\n * @returns {React$Node}\n */\nexport function TemplateTagInserter({\n isOpen,\n onClose,\n onInsert,\n fieldKeys = [],\n fields = [],\n showDateFormats = true,\n mode = 'both',\n anchorElement,\n}: TemplateTagInserterProps): React$Node {\n const [searchTerm, setSearchTerm] = useState('')\n const containerRef = useRef(null)\n const [position, setPosition] = useState<{ top: number, left: number } | null>(null)\n\n // Position dropdown relative to anchor element and focus input\n useEffect(() => {\n if (isOpen && anchorElement) {\n // Calculate position immediately (synchronously if possible)\n const calculatePosition = () => {\n if (anchorElement) {\n try {\n const rect = anchorElement.getBoundingClientRect()\n // Use getBoundingClientRect which gives viewport-relative coordinates\n // For fixed positioning, we don't need to add scroll offsets\n setPosition({\n top: rect.bottom + 4, // 4px gap below button (viewport coordinates)\n left: rect.left, // viewport coordinates\n })\n } catch (error) {\n // Fallback if getBoundingClientRect fails\n console.error('Error calculating dropdown position:', error)\n setPosition({ top: 0, left: 0 })\n }\n }\n }\n\n // Calculate immediately\n calculatePosition()\n\n // Also use requestAnimationFrame as fallback to ensure DOM is ready\n requestAnimationFrame(() => {\n calculatePosition()\n // Focus the input after positioning - SearchableChooser uses id \"template-tag-inserter-default\"\n setTimeout(() => {\n const input = document.getElementById('template-tag-inserter-default')\n if (input instanceof HTMLInputElement) {\n input.focus()\n }\n }, 0)\n })\n } else {\n setPosition(null)\n }\n }, [isOpen, anchorElement])\n\n // Build options list\n const options: Array = useMemo(() => {\n const opts: Array = []\n\n // Add field keys (only if mode is 'field' or 'both')\n if (mode === 'field' || mode === 'both') {\n // Prefer fields array over fieldKeys array (fields has label information)\n if (fields.length > 0) {\n fields\n .filter((field) => {\n // Filter out templatejs-block fields - they shouldn't be insertable as template tags\n return field.type !== 'templatejs-block'\n })\n .forEach((field) => {\n const key = field.key || ''\n const label = field.label || key\n opts.push({\n label: `${label} (${key})`, // Display format: \"label (key)\"\n value: `<%- ${key} %>`,\n description: `Insert value of form field \"${label}\"`,\n category: null, // Don't show category for fields\n })\n })\n } else if (fieldKeys.length > 0) {\n // Fallback to fieldKeys if fields not provided (backward compatibility)\n fieldKeys.forEach((key) => {\n opts.push({\n label: key,\n value: `<%- ${key} %>`,\n description: `Insert value of form field \"${key}\"`,\n category: null, // Don't show category for fields\n })\n })\n }\n }\n\n // Add date formats (only if mode is 'date' or 'both')\n if ((mode === 'date' || mode === 'both') && showDateFormats) {\n // Use a sample date to generate locale-specific examples\n // Use a date that shows various aspects: weekday, month, day, year, time\n const sampleDate = moment('2024-12-22 14:30:45') // Sunday, December 22, 2024, 2:30 PM\n\n // Set locale from NotePlan environment if available\n if (typeof NotePlan !== 'undefined' && NotePlan.environment) {\n const userLocale = `${NotePlan.environment.languageCode || 'en'}${NotePlan.environment.regionCode ? `-${NotePlan.environment.regionCode}` : ''}`\n moment.locale(userLocale)\n }\n\n // Generate locale-specific examples for common date formats\n const dateFormats = [\n // ISO and standard formats\n { format: 'YYYY-MM-DD', description: 'ISO date format' },\n { format: 'YYYY-MM-DD HH:mm', description: 'ISO date and time (24-hour)' },\n { format: 'YYYY-MM-DD HH:mm:ss', description: 'ISO date and time with seconds' },\n\n // US date formats\n { format: 'MM/DD/YYYY', description: 'US date format' },\n { format: 'MM/DD/YY', description: 'US date format (short year)' },\n { format: 'M/D/YYYY', description: 'US date format (no leading zeros)' },\n\n // European date formats\n { format: 'DD/MM/YYYY', description: 'European date format' },\n { format: 'DD/MM/YY', description: 'European date format (short year)' },\n { format: 'D/M/YYYY', description: 'European date format (no leading zeros)' },\n\n // Long date formats\n { format: 'MMMM Do, YYYY', description: 'Long date format (e.g., December 22nd, 2024)' },\n { format: 'dddd, MMMM Do, YYYY', description: 'Full date with weekday' },\n { format: 'MMMM Do', description: 'Month and day (e.g., December 22nd)' },\n\n // Time formats (12-hour with AM/PM)\n { format: 'h:mm A', description: 'Time (12-hour with AM/PM)' },\n { format: 'hh:mm A', description: 'Time (12-hour with AM/PM, leading zero)' },\n { format: 'h:mm:ss A', description: 'Time with seconds (12-hour with AM/PM)' },\n\n // Time formats (24-hour)\n { format: 'HH:mm', description: 'Time (24-hour)' },\n { format: 'HH:mm:ss', description: 'Time with seconds (24-hour)' },\n\n // Date and time combinations\n { format: 'MM/DD/YYYY h:mm A', description: 'US date and time (12-hour)' },\n { format: 'MM/DD/YYYY HH:mm', description: 'US date and time (24-hour)' },\n { format: 'DD/MM/YYYY h:mm A', description: 'European date and time (12-hour)' },\n { format: 'DD/MM/YYYY HH:mm', description: 'European date and time (24-hour)' },\n { format: 'MMMM Do, YYYY h:mm A', description: 'Long date and time (12-hour)' },\n { format: 'MMMM Do, YYYY HH:mm', description: 'Long date and time (24-hour)' },\n\n // Individual components\n { format: 'dddd', description: 'Day of week (full name)' },\n { format: 'ddd', description: 'Day of week (abbreviated)' },\n { format: 'MMMM', description: 'Month name (full)' },\n { format: 'MMM', description: 'Month name (abbreviated)' },\n { format: 'YYYY', description: 'Year (4 digits)' },\n { format: 'YY', description: 'Year (2 digits)' },\n { format: 'Do', description: 'Day of month with ordinal (e.g., 22nd)' },\n { format: 'D', description: 'Day of month (no leading zero)' },\n { format: 'DD', description: 'Day of month (with leading zero)' },\n\n // Week and quarter\n { format: 'wo [week of] YYYY', description: 'Week number and year' },\n { format: 'Qo [quarter] YYYY', description: 'Quarter and year' },\n ]\n\n opts.push(\n ...dateFormats.map((df) => {\n // Generate locale-specific example using moment\n const example = sampleDate.format(df.format)\n return {\n label: `${df.format} (${example})`,\n value: `<%- date.format(\"${df.format}\") %>`,\n description: df.description,\n category: null, // Don't show category for dates\n }\n }),\n )\n }\n\n return opts\n }, [fieldKeys, fields, showDateFormats, mode])\n\n // Configure the SearchableChooser\n const config: ChooserConfig = {\n items: options,\n filterFn: (option: TemplateTagOption, term: string): boolean => {\n const search = term.toLowerCase()\n return (\n option.label.toLowerCase().includes(search) ||\n option.value.toLowerCase().includes(search) ||\n (option.description ? option.description.toLowerCase().includes(search) : false) ||\n (option.category ? option.category.toLowerCase().includes(search) : false)\n )\n },\n getDisplayValue: (option: TemplateTagOption) => option.label,\n getOptionText: (option: TemplateTagOption) => option.label,\n getOptionTitle: (option: TemplateTagOption) => option.description || option.value,\n truncateDisplay: truncateText,\n onSelect: (option: TemplateTagOption) => {\n onInsert(option.value)\n onClose()\n },\n emptyMessageNoItems: 'No template tags available',\n emptyMessageNoMatch: 'No tags match your search',\n classNamePrefix: 'template-tag-inserter',\n iconClass: null,\n showArrow: true, // Show down arrow like a select\n fieldType: 'template-tag-inserter',\n debugLogging: false,\n maxResults: 100, // Show all date formats (we have ~34 date formats + field keys)\n inputMaxLength: 60,\n dropdownMaxLength: 80,\n getOptionShortDescription: (option: TemplateTagOption) => null, // Don't show category\n }\n\n if (!isOpen) return null\n\n // If anchorElement is provided, always use dropdown positioning (even if position not calculated yet)\n if (anchorElement) {\n const dropdownContent = (\n <>\n {/* Backdrop to close on outside click */}\n
\n e.stopPropagation()}\n >\n \n
\n \n )\n\n // Use portal to render outside the normal DOM hierarchy to avoid clipping by parent containers\n return typeof document !== 'undefined' && document.body ? createPortal(dropdownContent, document.body) : dropdownContent\n }\n\n // Fallback to modal overlay if no anchor element\n return (\n
\n
e.stopPropagation()}>\n
\n

Insert Template Tag

\n \n
\n \n
\n
\n )\n}\n\nexport default TemplateTagInserter\n" }, { "path": "dwertheimer.Forms/src/components/ValueInsertButtons.jsx", "content": "// @flow\n//--------------------------------------------------------------------------\n// ValueInsertButtons - Buttons that insert Color / Icon / Pattern / IconStyle\n// into a value field. Generalizes the \"+ Add Field\" style for value replacement.\n// Used next to conditional-values \"Value\" input and other value fields.\n//--------------------------------------------------------------------------\n\nimport React, { useState, useRef, useEffect, useCallback, type Node } from 'react'\nimport { TAILWIND_COLOR_NAMES, getColorStyle } from '@helpers/colors'\nimport { PATTERNS, ICON_STYLES, FA_ICON_NAMES } from '@helpers/react/DynamicDialog/valueInsertData'\n\ntype ValueInsertButtonsProps = {\n onValueReplace: (value: string) => void,\n defaultIconStyle?: string,\n disabled?: boolean,\n className?: string,\n}\n\n/**\n * Buttons (+Color, +Icon, +Pattern, +IconStyle) that replace the current value\n * with a chosen item. Picking from a list inserts that value into the field.\n *\n * @param {ValueInsertButtonsProps} props\n * @returns {Node}\n */\nexport function ValueInsertButtons({\n onValueReplace,\n defaultIconStyle = 'solid',\n disabled = false,\n className = '',\n}: ValueInsertButtonsProps): Node {\n const [openDropdown, setOpenDropdown] = useState(null)\n const containerRef = useRef(null)\n\n const close = useCallback(() => setOpenDropdown(null), [])\n\n useEffect(() => {\n if (!openDropdown) return\n const handleClickOutside = (e: MouseEvent) => {\n if (containerRef.current && !containerRef.current.contains((e: any).target)) {\n close()\n }\n }\n document.addEventListener('mousedown', handleClickOutside)\n return () => document.removeEventListener('mousedown', handleClickOutside)\n }, [openDropdown, close])\n\n const handlePick = (value: string) => {\n onValueReplace(value)\n close()\n }\n\n const toggle = (key: 'color' | 'icon' | 'pattern' | 'iconstyle') => {\n setOpenDropdown((prev) => (prev === key ? null : key))\n }\n\n return (\n
\n
\n toggle('color')}\n disabled={disabled}\n title=\"Insert Tailwind color\"\n >\n +Color\n \n {openDropdown === 'color' && (\n
\n {TAILWIND_COLOR_NAMES.map((name) => {\n const hex = getColorStyle(name)\n return (\n handlePick(name)}\n >\n \n {name}\n \n )\n })}\n
\n )}\n
\n
\n \n {openDropdown === 'icon' && (\n
\n {FA_ICON_NAMES.map((name) => {\n const fullClass = `fa-${defaultIconStyle} fa-${name}`\n return (\n handlePick(fullClass)}\n >\n \n {name}\n \n )\n })}\n
\n )}\n
\n
\n \n {openDropdown === 'pattern' && (\n
\n {PATTERNS.map((p) => (\n \n ))}\n
\n )}\n
\n
\n \n {openDropdown === 'iconstyle' && (\n
\n {ICON_STYLES.map((s) => (\n \n ))}\n
\n )}\n
\n
\n )\n}\n\nexport default ValueInsertButtons\n" }, { "path": "dwertheimer.Forms/src/components/fieldTypes.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Field Types Constants\n//--------------------------------------------------------------------------\n\nimport { type TSettingItemType } from '@helpers/react/DynamicDialog/DynamicDialog.jsx'\n\nexport type FieldTypeOption = {\n value: TSettingItemType,\n label: string,\n description: string,\n}\n\nexport const FIELD_TYPES: Array = [\n { value: 'input', label: 'Text Input', description: 'Single-line text field' },\n { value: 'input-readonly', label: 'Read-only (display value) field', description: 'Display-only text field' },\n { value: 'textarea', label: 'Expandable Textarea', description: 'Multi-line text field that expands as you type' },\n { value: 'number', label: 'Number', description: 'Numeric input with increment/decrement' },\n { value: 'text', label: 'Text', description: 'Display-only text/instructions' },\n { value: 'switch', label: 'Switch', description: 'Toggle on/off' },\n { value: 'dropdown-select', label: 'Dropdown', description: 'Simple dropdown menu' },\n // combo is not available because of missing NP_Theme in showHTMLV2 (and maybe doesn't work reliably anyway)\n // { value: 'combo', label: 'Combo', description: 'Advanced dropdown with search' },\n { value: 'calendarpicker', label: 'Date Picker', description: 'Date selection calendar' },\n { value: 'folder-chooser', label: 'Folder Chooser', description: 'Searchable folder selector' },\n { value: 'note-chooser', label: 'Note Chooser', description: 'Searchable note selector' },\n { value: 'space-chooser', label: 'Space Chooser', description: 'Select a Space (Private or Teamspace)' },\n { value: 'heading-chooser', label: 'Heading Chooser', description: 'Select a heading from a note (static or dynamic based on note-chooser)' },\n { value: 'event-chooser', label: 'Event Chooser', description: 'Select a calendar event for a specific date' },\n { value: 'tag-chooser', label: 'Tag Chooser', description: 'Multi-select hashtag chooser with filtering (returns #tag1,#tag2 or array)' },\n { value: 'mention-chooser', label: 'Mention Chooser', description: 'Multi-select mention chooser with filtering (returns @mention1,@mention2 or array)' },\n { value: 'frontmatter-key-chooser', label: 'Frontmatter Key Chooser', description: 'Multi-select chooser for frontmatter key values (returns value1,value2 or array). Key can be fixed or from another field.' },\n { value: 'markdown-preview', label: 'Markdown Preview', description: 'Display markdown content (static text, note by filename/title, or note from another field). Note: This is a very basic markdown renderer that does not display full NotePlan formatted tasks and items. It\\'s intended for a quick preview, not a faithful rendering.' },\n { value: 'heading', label: 'Heading', description: 'Section heading' },\n { value: 'separator', label: 'Separator', description: 'Horizontal line' },\n { value: 'button', label: 'Button', description: 'Clickable button' },\n { value: 'button-group', label: 'Button Group', description: 'Group of mutually exclusive selectable buttons (like a toggle group or radio buttons)' },\n { value: 'json', label: 'JSON Editor', description: 'JSON data editor' },\n { value: 'hidden', label: 'Hidden Field', description: 'Hidden data field' },\n { value: 'templatejs-block', label: 'TemplateJS Block', description: 'JavaScript code block that executes during template processing' },\n { value: 'autosave', label: 'Autosave', description: 'Automatically saves form state periodically (shows \"Saved x ago\" status)' },\n { value: 'table-of-contents', label: 'Table of Contents', description: 'Clickable table of contents that links to headings in the form' },\n { value: 'comment', label: 'Comment', description: 'Comment/note field for Form Builder only - doesn\\'t render in form output. Use for notes to yourself while building forms.' },\n {\n value: 'conditional-values',\n label: 'Conditional Values',\n description:\n 'Derived field: sets this field\\'s value based on another field\\'s value. Define matchTerm/value pairs (e.g. \"Trip\"→\"red-500\", \"Beach\"→\"yellow-500\"). First match wins. Supports string or regex matching.',\n },\n { value: 'color-chooser', label: 'Color Chooser', description: 'Single-value searchable chooser for Tailwind color names (e.g. amber-200, blue-500)' },\n {\n value: 'icon-chooser',\n label: 'Icon Chooser',\n description: 'Single-value searchable chooser for Font Awesome icon names. Output is short name only (e.g. circle, star) for NotePlan compatibility.',\n },\n { value: 'pattern-chooser', label: 'Pattern Chooser', description: 'Single-value searchable chooser for pattern names (lined, squared, mini-squared, dotted)' },\n { value: 'icon-style-chooser', label: 'Icon Style Chooser', description: 'Single-value searchable chooser for Font Awesome style (solid, light, regular)' },\n]\n" }, { "path": "dwertheimer.Forms/src/dataHandlers.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Data Handlers - Data-fetching functions for forms\n// These functions are separated from requestHandlers.js to break circular dependencies\n//--------------------------------------------------------------------------\n\nimport moment from 'moment/min/moment-with-locales'\nimport pluginJson from '../plugin.json'\nimport { getAllNotesAsOptions, getRelativeNotesAsOptions } from './noteHelpers'\nimport { logDebug, logError, logInfo } from '@helpers/dev'\nimport { getFoldersMatching } from '@helpers/folders'\nimport { getAllTeamspaceIDsAndTitles } from '@helpers/NPTeamspace'\nimport { parseTeamspaceFilename } from '@helpers/teamspace'\nimport { keepTodayPortionOnly } from '@helpers/calendar.js'\nimport { getValuesForFrontmatterTag } from '@helpers/NPFrontMatter'\nimport { type RequestResponse } from './shared/types'\n\n/**\n * Get list of folders with filtering options\n * @param {Object} params - Request parameters\n * @param {boolean} params.excludeTrash - Exclude trash folder (default: true)\n * @param {string} params.space - Space ID to filter by (empty string = Private, teamspace ID = specific teamspace, null/undefined = all spaces)\n * @returns {RequestResponse}\n */\nexport function getFolders(params: { excludeTrash?: boolean, space?: ?string } = {}): RequestResponse {\n const startTime: number = Date.now()\n try {\n const spaceParam = params.space\n logDebug(\n pluginJson,\n `[DIAG] getFolders START: excludeTrash=${String(params.excludeTrash ?? true)}, space=${spaceParam != null ? String(spaceParam) : 'null/undefined (all spaces)'}`,\n )\n\n const excludeTrash = params.excludeTrash ?? true\n // Don't default spaceId - if null/undefined, don't filter (show all spaces)\n // Empty string means Private space only, teamspace ID means specific teamspace only\n const spaceId = spaceParam\n const exclusions = excludeTrash ? ['@Trash'] : []\n\n // Get all folders except exclusions. Include special folders (@Templates, @Archive, etc.) and teamspaces, sorted\n const foldersStartTime: number = Date.now()\n let folders = getFoldersMatching([], false, exclusions, false, true)\n const foldersElapsed: number = Date.now() - foldersStartTime\n logDebug(pluginJson, `[DIAG] getFolders getFoldersMatching: elapsed=${foldersElapsed}ms, found=${folders.length} folders`)\n\n // Filter by space if specified (empty string = Private, teamspace ID = specific teamspace, null/undefined = all spaces)\n if (spaceId !== null && spaceId !== undefined) {\n folders = folders.filter((folder: string) => {\n // Root folder - only include for Private space\n if (folder === '/') {\n return spaceId === ''\n }\n\n // Check if folder is a teamspace folder\n if (folder.startsWith('%%NotePlanCloud%%')) {\n const folderDetails = parseTeamspaceFilename(folder)\n if (spaceId === '') {\n // Private space filter - exclude all teamspace folders\n return false\n } else {\n // Specific teamspace filter - only include folders from that teamspace\n return spaceId === folderDetails.teamspaceID\n }\n } else {\n // Regular folder (not teamspace)\n if (spaceId === '') {\n // Private space filter - include regular folders\n return true\n } else {\n // Specific teamspace filter - exclude regular folders\n return false\n }\n }\n })\n logDebug(pluginJson, `[DIAG] getFolders FILTERED: ${folders.length} folders after space filter (space=${spaceId || 'Private'})`)\n }\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getFolders COMPLETE: totalElapsed=${totalElapsed}ms, found=${folders.length} folders`)\n\n if (folders.length === 0) {\n logInfo(pluginJson, `getFolders: No folders found, returning root folder only`)\n return {\n success: true,\n message: 'No folders found, returning root folder',\n data: ['/'],\n }\n }\n\n return {\n success: true,\n data: folders,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getFolders ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get folders: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get list of notes with filtering options\n * @param {Object} params - Request parameters\n * @param {boolean} params.includeCalendarNotes - Include calendar notes (default: false)\n * @param {boolean} params.includePersonalNotes - Include personal/project notes (default: true)\n * @param {boolean} params.includeRelativeNotes - Include relative notes like , , etc. (default: false)\n * @param {boolean} params.includeTeamspaceNotes - Include teamspace notes (default: true)\n * @param {string} params.space - Space ID to filter by (empty string = Private, teamspace ID = specific teamspace)\n * @returns {RequestResponse}\n */\nexport function getNotes(\n params: {\n includeCalendarNotes?: boolean,\n includePersonalNotes?: boolean,\n includeRelativeNotes?: boolean,\n includeTeamspaceNotes?: boolean,\n space?: string, // Space ID (empty string = Private, teamspace ID = specific teamspace)\n } = {},\n): RequestResponse {\n const startTime: number = Date.now()\n try {\n const includeCalendarNotes = params.includeCalendarNotes ?? false\n const includePersonalNotes = params.includePersonalNotes ?? true\n const includeRelativeNotes = params.includeRelativeNotes ?? false\n const includeTeamspaceNotes = params.includeTeamspaceNotes ?? true\n const spaceId = params.space ?? '' // Empty string = Private (default)\n\n logDebug(\n pluginJson,\n `[DIAG] getNotes START: includeCalendarNotes=${String(includeCalendarNotes)}, includePersonalNotes=${String(includePersonalNotes)}, includeRelativeNotes=${String(\n includeRelativeNotes,\n )}, includeTeamspaceNotes=${String(includeTeamspaceNotes)}, space=${spaceId || 'Private'}`,\n )\n\n const allNotes: Array = []\n\n // Get project notes and calendar notes separately, then filter\n const processStartTime: number = Date.now()\n\n // Get project notes (personal notes)\n if (includePersonalNotes) {\n const projectNotes = getAllNotesAsOptions(false, true) // Don't include calendar notes here\n const processElapsed: number = Date.now() - processStartTime\n logDebug(pluginJson, `[DIAG] getNotes PROJECT: elapsed=${processElapsed}ms, found=${projectNotes.length} project notes`)\n\n // Filter teamspace notes if needed, and also filter by space if specified\n for (const note of projectNotes) {\n const isTeamspaceNote = note.isTeamspaceNote === true\n const noteTeamspaceID = note.teamspaceID || null\n\n // First check if we should include teamspace notes at all\n if (includeTeamspaceNotes || !isTeamspaceNote) {\n // If space filter is specified, only include notes from that space\n if (spaceId !== '') {\n // Space filter is set - only include notes from that specific space\n if (spaceId === noteTeamspaceID) {\n allNotes.push(note)\n }\n // Skip notes that don't match the space filter\n } else {\n // No space filter (Private) - only include private notes (non-teamspace)\n if (!isTeamspaceNote) {\n allNotes.push(note)\n }\n // Skip teamspace notes when space filter is Private (empty string)\n }\n }\n }\n logDebug(pluginJson, `[DIAG] getNotes PROJECT FILTERED: ${allNotes.length} personal notes after teamspace and space filter`)\n }\n\n // Get calendar notes if requested\n if (includeCalendarNotes) {\n const calendarStartTime: number = Date.now()\n const calendarNotes = getAllNotesAsOptions(true, true) // Include calendar notes\n const calendarElapsed: number = Date.now() - calendarStartTime\n logDebug(pluginJson, `[DIAG] getNotes CALENDAR: elapsed=${calendarElapsed}ms, found=${calendarNotes.length} calendar notes`)\n\n // Filter teamspace notes if needed, and only include calendar notes (not project notes)\n // Also filter by space if specified\n for (const note of calendarNotes) {\n const isCalendarNote = note.type === 'Calendar'\n const isTeamspaceNote = note.isTeamspaceNote === true\n const noteTeamspaceID = note.teamspaceID || null\n\n // Only include if it's actually a calendar note (not a project note that got mixed in)\n if (isCalendarNote) {\n // If space filter is specified, only include notes from that space\n if (spaceId !== '') {\n // Space filter is set - only include notes from that specific space\n if (spaceId === noteTeamspaceID) {\n allNotes.push(note)\n }\n // Skip notes that don't match the space filter\n } else {\n // No space filter (Private) - only include private notes (non-teamspace)\n if (!isTeamspaceNote) {\n allNotes.push(note)\n }\n // Skip teamspace notes when space filter is Private (empty string)\n }\n }\n }\n logDebug(pluginJson, `[DIAG] getNotes CALENDAR FILTERED: ${allNotes.length} total notes after calendar filter`)\n }\n\n logDebug(pluginJson, `[DIAG] getNotes FILTERED: ${allNotes.length} notes after filtering`)\n\n // Get relative notes (like , , etc.)\n if (includeRelativeNotes) {\n const processStartTime: number = Date.now()\n const relativeNotes = getRelativeNotesAsOptions(true) // Include decoration\n const processElapsed: number = Date.now() - processStartTime\n logDebug(pluginJson, `[DIAG] getNotes RELATIVE: elapsed=${processElapsed}ms, found=${relativeNotes.length} relative notes`)\n allNotes.push(...relativeNotes)\n }\n\n // Re-sort all notes together by changedDate (most recent first), but put relative notes at the top\n allNotes.sort((a: any, b: any) => {\n // Relative notes (those with filename starting with '<') should appear first\n const aIsRelative = typeof a.filename === 'string' && a.filename.startsWith('<')\n const bIsRelative = typeof b.filename === 'string' && b.filename.startsWith('<')\n\n if (aIsRelative && !bIsRelative) return -1\n if (!aIsRelative && bIsRelative) return 1\n\n // For non-relative notes, sort by changedDate (most recent first)\n const aDate = typeof a.changedDate === 'number' ? a.changedDate : 0\n const bDate = typeof b.changedDate === 'number' ? b.changedDate : 0\n return bDate - aDate\n })\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getNotes COMPLETE: totalElapsed=${totalElapsed}ms, found=${allNotes.length} total notes`)\n\n return {\n success: true,\n data: allNotes,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getNotes ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get notes: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get list of calendar events for a specific date\n * @param {Object} params - Request parameters\n * @param {string} params.dateString - Date string in YYYY-MM-DD format (optional, defaults to today)\n * @param {string} params.date - ISO date string (optional, alternative to dateString)\n * @param {Array} params.calendars - Optional array of calendar titles to filter by (ignored if allCalendars=true)\n * @param {boolean} params.allCalendars - If true, include events from all calendars NotePlan can access (bypasses calendars filter)\n * @param {string} params.calendarFilterRegex - Optional regex pattern to filter calendars after fetching (applied when allCalendars=true)\n * @param {string} params.eventFilterRegex - Optional regex pattern to filter events by title after fetching\n * @param {boolean} params.includeReminders - If true, include reminders (default: false)\n * @param {Array} params.reminderLists - Optional array of reminder list titles to filter reminders by\n * @returns {Promise}\n */\nexport async function getEvents(\n params: {\n dateString?: string,\n date?: string,\n calendars?: Array,\n allCalendars?: boolean,\n calendarFilterRegex?: string,\n eventFilterRegex?: string,\n includeReminders?: boolean,\n reminderLists?: Array,\n } = {},\n): Promise {\n const startTime: number = Date.now()\n try {\n // Parse the date using moment.js for proper timezone handling\n // Prefer dateString (YYYY-MM-DD), fall back to date (ISO), or use today\n let targetMoment: any // moment.Moment type\n let isToday = false\n\n if (params.dateString) {\n // Parse YYYY-MM-DD format - moment handles this in local timezone\n targetMoment = moment(params.dateString, 'YYYY-MM-DD', true) // strict parsing\n if (!targetMoment.isValid()) {\n logError(pluginJson, `getEvents: Invalid dateString provided: \"${String(params.dateString)}\"`)\n return {\n success: false,\n message: `Invalid dateString provided`,\n data: null,\n }\n }\n } else if (params.date) {\n // Parse ISO date string - moment handles timezone conversion properly\n targetMoment = moment(params.date)\n if (!targetMoment.isValid()) {\n logError(pluginJson, `getEvents: Invalid date provided: \"${String(params.date)}\"`)\n return {\n success: false,\n message: `Invalid date provided`,\n data: null,\n }\n }\n } else {\n // Default to today - use Calendar.eventsToday() for better accuracy\n isToday = true\n targetMoment = moment().startOf('day')\n }\n\n // Normalize to start of day in local timezone using moment\n targetMoment = targetMoment.startOf('day')\n const targetDate: Date = targetMoment.toDate()\n\n logDebug(\n pluginJson,\n `[DIAG] getEvents START: targetDate=${targetDate.toISOString()}, isToday=${String(isToday)}, localDate=${targetMoment.format('YYYY-MM-DD')}, input dateString=\"${String(\n params.dateString || '',\n )}\", input date=\"${String(params.date || '')}\"`,\n )\n\n // Get start and end of day using moment (handles timezone properly)\n const dayStartMoment = targetMoment.clone().startOf('day')\n const dayEndMoment = targetMoment.clone().endOf('day')\n\n // Convert to Calendar.dateFrom format (extract components from moment in local timezone)\n const year = dayStartMoment.year()\n const month = dayStartMoment.month() + 1 // Calendar.dateFrom uses 1-12 for months, moment uses 0-11\n const day = dayStartMoment.date()\n const dayStart = Calendar.dateFrom(year, month, day, 0, 0, 0)\n const dayEnd = Calendar.dateFrom(year, month, day, 23, 59, 59)\n\n logDebug(pluginJson, `[DIAG] getEvents: Calendar.dateFrom params: year=${year}, month=${month}, day=${day}`)\n logDebug(\n pluginJson,\n `[DIAG] getEvents: dayStart=${dayStart.toISOString()}, dayEnd=${dayEnd.toISOString()}, momentStart=${dayStartMoment.format()}, momentEnd=${dayEndMoment.format()}`,\n )\n logDebug(pluginJson, `[DIAG] getEvents: dayStart local=${dayStartMoment.format('YYYY-MM-DD HH:mm:ss')}, dayEnd local=${dayEndMoment.format('YYYY-MM-DD HH:mm:ss')}`)\n\n // Fetch events for the day - use eventsToday() for today, eventsBetween() for other dates\n const eventsStartTime: number = Date.now()\n let calendarEvents: Array\n if (isToday) {\n // Use eventsToday() for better accuracy when fetching today's events\n calendarEvents = await Calendar.eventsToday()\n } else {\n calendarEvents = await Calendar.eventsBetween(dayStart, dayEnd)\n }\n const eventsElapsed: number = Date.now() - eventsStartTime\n logDebug(pluginJson, `[DIAG] getEvents Calendar.eventsBetween: elapsed=${eventsElapsed}ms, found=${calendarEvents.length} events`)\n\n // Filter to only events that are on this day\n let filteredEvents = keepTodayPortionOnly(calendarEvents, targetDate)\n\n // Filter by calendars if specified (only if allCalendars is not enabled)\n if (!params.allCalendars && params.calendars && Array.isArray(params.calendars) && params.calendars.length > 0) {\n filteredEvents = filteredEvents.filter((event: TCalendarItem) => {\n return params.calendars?.includes(event.calendar || '')\n })\n logDebug(pluginJson, `[DIAG] getEvents FILTERED BY CALENDARS: ${filteredEvents.length} events after calendar filter`)\n }\n\n // Apply calendar filter regex if specified (when allCalendars is enabled)\n if (params.allCalendars && params.calendarFilterRegex && typeof params.calendarFilterRegex === 'string') {\n try {\n const calendarRegex = new RegExp(params.calendarFilterRegex)\n const beforeCount = filteredEvents.length\n filteredEvents = filteredEvents.filter((event: TCalendarItem) => {\n return calendarRegex.test(event.calendar || '')\n })\n logDebug(pluginJson, `[DIAG] getEvents FILTERED BY CALENDAR REGEX: ${beforeCount} -> ${filteredEvents.length} events after regex filter`)\n } catch (error) {\n logError(pluginJson, `[DIAG] getEvents: Invalid calendarFilterRegex pattern: \"${String(params.calendarFilterRegex)}\", error: ${error.message}`)\n }\n }\n\n // Apply event title filter regex if specified\n if (params.eventFilterRegex && typeof params.eventFilterRegex === 'string') {\n try {\n const eventRegex = new RegExp(params.eventFilterRegex)\n const beforeCount = filteredEvents.length\n filteredEvents = filteredEvents.filter((event: TCalendarItem) => {\n return eventRegex.test(event.title || '')\n })\n logDebug(pluginJson, `[DIAG] getEvents FILTERED BY EVENT REGEX: ${beforeCount} -> ${filteredEvents.length} events after regex filter`)\n } catch (error) {\n logError(pluginJson, `[DIAG] getEvents: Invalid eventFilterRegex pattern: \"${String(params.eventFilterRegex)}\", error: ${error.message}`)\n }\n }\n\n // Get reminders if requested\n let reminders: Array = []\n if (params.includeReminders === true) {\n const remindersStartTime: number = Date.now()\n if (params.reminderLists && Array.isArray(params.reminderLists) && params.reminderLists.length > 0) {\n // Filter by reminder lists\n reminders = await Calendar.remindersByLists(params.reminderLists)\n logDebug(pluginJson, `[DIAG] getEvents remindersByLists: elapsed=${Date.now() - remindersStartTime}ms, found=${reminders.length} reminders`)\n } else {\n // Get reminders for today\n reminders = await Calendar.remindersToday()\n logDebug(pluginJson, `[DIAG] getEvents remindersToday: elapsed=${Date.now() - remindersStartTime}ms, found=${reminders.length} reminders`)\n }\n\n // Filter reminders to only those on this day\n reminders = keepTodayPortionOnly(reminders, targetDate)\n logDebug(pluginJson, `[DIAG] getEvents FILTERED REMINDERS: ${reminders.length} reminders after date filter`)\n }\n\n // Convert events to serializable format (Date objects to ISO strings)\n // Include all CalendarItem properties for full event information\n const serializedEvents = filteredEvents.map((event: TCalendarItem) => ({\n id: event.id || '',\n title: event.title || '',\n date: event.date ? event.date.toISOString() : new Date().toISOString(),\n endDate: event.endDate ? event.endDate.toISOString() : null,\n calendar: event.calendar || '',\n isAllDay: event.isAllDay || false,\n type: event.type || 'event',\n isCompleted: event.isCompleted || false,\n notes: event.notes || '',\n url: event.url || '',\n availability: event.availability ?? -1,\n attendees: event.attendees || [],\n attendeeNames: event.attendeeNames || [],\n calendarItemLink: event.calendarItemLink || '',\n location: event.location || '',\n isCalendarWritable: event.isCalendarWritable || false,\n isRecurring: event.isRecurring || false,\n occurrences: event.occurrences ? event.occurrences.map((d: Date) => d.toISOString()) : [],\n }))\n\n // Sort events: all-day first, then by time\n serializedEvents.sort((a: any, b: any) => {\n const aDate = new Date(a.date)\n const bDate = new Date(b.date)\n // Sort all-day events first, then by time\n if (a.isAllDay && !b.isAllDay) return -1\n if (!a.isAllDay && b.isAllDay) return 1\n if (a.isAllDay && b.isAllDay) {\n // Both all-day, sort by title\n return a.title.localeCompare(b.title)\n }\n // Both timed, sort by start time\n return aDate.getTime() - bDate.getTime()\n })\n\n // Convert reminders to serializable format and add to events\n // Include all CalendarItem properties for full reminder information\n if (reminders.length > 0) {\n const serializedReminders = reminders.map((reminder: TCalendarItem) => ({\n id: reminder.id || '',\n title: reminder.title || '',\n date: reminder.date ? reminder.date.toISOString() : new Date().toISOString(),\n endDate: reminder.endDate ? reminder.endDate.toISOString() : null,\n calendar: reminder.calendar || '',\n isAllDay: reminder.isAllDay || false,\n type: 'reminder', // Mark as reminder\n isCompleted: reminder.isCompleted || false,\n notes: reminder.notes || '',\n url: reminder.url || '',\n availability: reminder.availability ?? -1,\n attendees: reminder.attendees || [],\n attendeeNames: reminder.attendeeNames || [],\n calendarItemLink: reminder.calendarItemLink || '',\n location: reminder.location || '',\n isCalendarWritable: reminder.isCalendarWritable || false,\n isRecurring: reminder.isRecurring || false,\n occurrences: reminder.occurrences ? reminder.occurrences.map((d: Date) => d.toISOString()) : [],\n }))\n\n // Sort reminders: all-day first, then by time\n serializedReminders.sort((a: any, b: any) => {\n const aDate = new Date(a.date)\n const bDate = new Date(b.date)\n if (a.isAllDay && !b.isAllDay) return -1\n if (!a.isAllDay && b.isAllDay) return 1\n if (a.isAllDay && b.isAllDay) {\n return a.title.localeCompare(b.title)\n }\n return aDate.getTime() - bDate.getTime()\n })\n\n // Merge reminders with events, keeping all-day events first, then by time\n serializedEvents.push(...serializedReminders)\n serializedEvents.sort((a: any, b: any) => {\n const aDate = new Date(a.date)\n const bDate = new Date(b.date)\n if (a.isAllDay && !b.isAllDay) return -1\n if (!a.isAllDay && b.isAllDay) return 1\n if (a.isAllDay && b.isAllDay) {\n return a.title.localeCompare(b.title)\n }\n return aDate.getTime() - bDate.getTime()\n })\n }\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(\n pluginJson,\n `[DIAG] getEvents COMPLETE: totalElapsed=${totalElapsed}ms, found=${serializedEvents.length} items (${filteredEvents.length} events, ${reminders.length} reminders)`,\n )\n\n return {\n success: true,\n data: serializedEvents,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getEvents ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get events: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get all hashtags from DataStore\n * @param {Object} _params - Not used, kept for consistency\n * @returns {RequestResponse} Array of hashtags (without # prefix)\n */\nexport function getHashtags(_params: Object = {}): RequestResponse {\n try {\n // DataStore.hashtags returns items without # prefix\n const hashtags = DataStore.hashtags || []\n logDebug(pluginJson, `getHashtags: returning ${hashtags.length} hashtags`)\n return {\n success: true,\n data: hashtags,\n }\n } catch (error) {\n logError(pluginJson, `getHashtags error: ${error.message}`)\n return {\n success: false,\n message: error.message,\n data: [],\n }\n }\n}\n\n/**\n * Get all mentions from DataStore\n * @param {Object} _params - Not used, kept for consistency\n * @returns {RequestResponse} Array of mentions (without @ prefix)\n */\nexport function getMentions(_params: Object = {}): RequestResponse {\n try {\n // DataStore.mentions returns items without @ prefix\n const mentions = DataStore.mentions || []\n logDebug(pluginJson, `getMentions: returning ${mentions.length} mentions`)\n return {\n success: true,\n data: mentions,\n }\n } catch (error) {\n logError(pluginJson, `getMentions error: ${error.message}`)\n return {\n success: false,\n message: error.message,\n data: [],\n }\n }\n}\n\n/**\n * Get all teamspace definitions\n * @param {Object} _params - Request parameters (currently unused)\n * @returns {RequestResponse}\n */\nexport function getTeamspaces(_params: Object = {}): RequestResponse {\n const startTime: number = Date.now()\n try {\n logDebug(pluginJson, `[DIAG] getTeamspaces START`)\n\n const teamspacesStartTime: number = Date.now()\n const teamspaces = getAllTeamspaceIDsAndTitles()\n const teamspacesElapsed: number = Date.now() - teamspacesStartTime\n logDebug(pluginJson, `[DIAG] getTeamspaces getAllTeamspaceIDsAndTitles: elapsed=${teamspacesElapsed}ms, found=${teamspaces.length} teamspaces`)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getTeamspaces COMPLETE: totalElapsed=${totalElapsed}ms, found=${teamspaces.length} teamspaces`)\n\n return {\n success: true,\n data: teamspaces,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getTeamspaces ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get teamspaces: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get all values for a frontmatter key from DataStore\n * Moved here from requestHandlers.js to break circular dependency: requestHandlers -> FormFieldRenderTest -> windowManagement -> requestHandlers\n * @param {Object} params - Request parameters\n * @param {string} params.frontmatterKey - The frontmatter key to get values for\n * @param {'Notes' | 'Calendar' | 'All'} params.noteType - Type of notes to search (default: 'All')\n * @param {boolean} params.caseSensitive - Whether to perform case-sensitive search (default: false)\n * @param {string} params.folderString - Folder to limit search to (optional)\n * @param {boolean} params.fullPathMatch - Whether to match full path (default: false)\n * @returns {Promise} Array of values (as strings)\n */\nexport async function getFrontmatterKeyValues(params: {\n frontmatterKey: string,\n noteType?: 'Notes' | 'Calendar' | 'All',\n caseSensitive?: boolean,\n folderString?: string,\n fullPathMatch?: boolean,\n}): Promise {\n const startTime: number = Date.now()\n try {\n logDebug(pluginJson, `[DIAG] getFrontmatterKeyValues START: frontmatterKey=\"${params.frontmatterKey}\"`)\n\n if (!params.frontmatterKey) {\n return {\n success: false,\n message: 'Frontmatter key is required',\n data: [],\n }\n }\n\n const noteType = params.noteType || 'All'\n const caseSensitive = params.caseSensitive || false\n const folderString = params.folderString || ''\n const fullPathMatch = params.fullPathMatch || false\n\n // Get values using the helper function\n const values = await getValuesForFrontmatterTag(params.frontmatterKey, noteType, caseSensitive, folderString, fullPathMatch)\n\n // Convert all values to strings (frontmatter values can be various types)\n let stringValues = values.map((v: any) => String(v))\n\n // Filter out templating syntax values (containing \"<%\") - these are template code, not actual values\n // This prevents templating errors when forms load and process frontmatter\n const beforeFilterCount = stringValues.length\n stringValues = stringValues.filter((v: string) => !v.includes('<%'))\n if (beforeFilterCount !== stringValues.length) {\n logDebug(pluginJson, `[DIAG] getFrontmatterKeyValues: Filtered out ${beforeFilterCount - stringValues.length} templating syntax values`)\n }\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getFrontmatterKeyValues COMPLETE: totalElapsed=${totalElapsed}ms, found=${stringValues.length} values for key \"${params.frontmatterKey}\"`)\n\n return {\n success: true,\n data: stringValues,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getFrontmatterKeyValues ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get frontmatter key values: ${error.message}`,\n data: [],\n }\n }\n}\n" }, { "path": "dwertheimer.Forms/src/formBrowserHandlers.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Browser Request Handlers\n// Handlers for requests from FormBrowserView component\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { openFormBuilder } from './NPTemplateForm'\nimport { handleSubmitButtonClick } from './formSubmission'\nimport { findDuplicateFormTemplates } from './templateIO'\nimport { loadFormContextFromFilename } from './formSubmitHandlers'\nimport { openFormBuilderWindow } from './windowManagement'\nimport { loadCodeBlockFromNote } from '@helpers/codeBlocks'\nimport { parseObjectString, stripDoubleQuotes } from '@helpers/stringTransforms'\nimport { logDebug, logError, logWarn } from '@helpers/dev'\nimport { getNoteByFilename, getNote } from '@helpers/note'\nimport { parseTeamspaceFilename } from '@helpers/teamspace'\nimport { getFolderFromFilename } from '@helpers/folders'\nimport { showMessage } from '@helpers/userInput'\nimport { sendBannerMessage } from '@helpers/HTMLView'\nimport { getAllTeamspaceIDsAndTitles } from '@helpers/NPTeamspace'\nimport { ensureFrontmatter, updateFrontMatterVars } from '@helpers/NPFrontMatter'\nimport { waitForCondition } from '@helpers/promisePolyfill'\n\n// RequestResponse type definition (shared with requestHandlers.js)\n// NOTE: Handler functions return this format. The router wraps it in a RESPONSE message.\n// React components receive just the data (result.data) when the promise resolves.\nexport type RequestResponse = {\n success: boolean,\n message?: string,\n data?: any,\n}\n\n/**\n * Get list of form templates filtered by space and @Forms or @Templates folder\n * @param {Object} params - Request parameters\n * @param {string} params.space - Space ID to filter by (empty string = Private, teamspace ID = specific teamspace)\n * @returns {RequestResponse}\n */\nexport function getFormTemplates(params: { space?: string } = {}): RequestResponse {\n try {\n const spaceId = params.space ?? '' // Empty string = Private (default), \"__all__\" = all spaces\n const showAll = spaceId === '__all__'\n logDebug(pluginJson, `getFormTemplates: space=${spaceId || 'Private'}, showAll=${String(showAll)}`)\n\n // Get teamspace titles for lookup\n const teamspaces = getAllTeamspaceIDsAndTitles()\n const teamspaceMap = new Map()\n teamspaces.forEach((ts) => {\n teamspaceMap.set(ts.id, ts.title)\n })\n\n const allNotes = DataStore.projectNotes\n const formTemplates = []\n let templateFormCount = 0\n let inFormsFolderCount = 0\n let spaceMatchCount = 0\n\n for (const note of allNotes) {\n const type = note.frontmatterAttributes?.type\n if (type === 'template-form') {\n templateFormCount++\n // Get the folder path from the note's filename\n const noteFolder = getFolderFromFilename(note.filename || '')\n\n // Check if note is in teamspace\n const isTeamspaceNote = note.filename?.startsWith('%%NotePlanCloud%%') || false\n const noteTeamspaceID = isTeamspaceNote ? parseTeamspaceFilename(note.filename || '').teamspaceID : null\n\n // Apply space filter (skip if showAll is true)\n if (!showAll) {\n if (spaceId === '') {\n // Private space: only include private notes (non-teamspace)\n if (isTeamspaceNote) {\n logDebug(pluginJson, `getFormTemplates: Skipping teamspace note \"${note.title || note.filename}\" for Private space`)\n continue\n }\n } else {\n // Teamspace: only include notes from that specific teamspace\n if (!isTeamspaceNote || noteTeamspaceID !== spaceId) {\n logDebug(pluginJson, `getFormTemplates: Skipping note \"${note.title || note.filename}\" - teamspaceID=\"${String(noteTeamspaceID || 'null')}\", expected=\"${spaceId}\"`)\n continue\n }\n }\n }\n\n // Check if note is in the @Forms folder OR @Templates folder (or subfolders)\n // For Private: noteFolder should start with '@Forms' or '@Templates' or be exactly '@Forms' or '@Templates'\n // For teamspace: noteFolder should start with '%%NotePlanCloud%%/{teamspaceID}/@Forms' or '%%NotePlanCloud%%/{teamspaceID}/@Templates'\n // Note: We check both formats (with and without the /) for backward compatibility, but the correct format is with the /\n let isInFormsFolder = false\n let isInTemplatesFolder = false\n if (showAll) {\n // When showing all, check folder based on the note's actual space\n if (isTeamspaceNote && noteTeamspaceID) {\n // Teamspace note: check if folder starts with '%%NotePlanCloud%%/{teamspaceID}/@Forms' or '@Templates'\n const formsPrefix1 = `%%NotePlanCloud%%${noteTeamspaceID}/@Forms`\n const formsPrefix2 = `%%NotePlanCloud%%/${noteTeamspaceID}/@Forms`\n const templatesPrefix1 = `%%NotePlanCloud%%${noteTeamspaceID}/@Templates`\n const templatesPrefix2 = `%%NotePlanCloud%%/${noteTeamspaceID}/@Templates`\n isInFormsFolder =\n noteFolder === formsPrefix1 || noteFolder.startsWith(`${formsPrefix1}/`) || noteFolder === formsPrefix2 || noteFolder.startsWith(`${formsPrefix2}/`)\n isInTemplatesFolder =\n noteFolder === templatesPrefix1 || noteFolder.startsWith(`${templatesPrefix1}/`) || noteFolder === templatesPrefix2 || noteFolder.startsWith(`${templatesPrefix2}/`)\n } else {\n // Private note: check if folder is '@Forms' or '@Templates' or starts with '@Forms/' or '@Templates/'\n isInFormsFolder = noteFolder === '@Forms' || noteFolder.startsWith('@Forms/')\n isInTemplatesFolder = noteFolder === '@Templates' || noteFolder.startsWith('@Templates/')\n }\n } else if (spaceId === '') {\n // Private: check if folder is '@Forms' or '@Templates' or starts with '@Forms/' or '@Templates/'\n isInFormsFolder = noteFolder === '@Forms' || noteFolder.startsWith('@Forms/')\n isInTemplatesFolder = noteFolder === '@Templates' || noteFolder.startsWith('@Templates/')\n } else {\n // Teamspace: check if folder starts with '%%NotePlanCloud%%/{teamspaceID}/@Forms' or '@Templates' (correct format)\n // Note: getFolderFromFilename may return paths with or without the leading slash after %%NotePlanCloud%%\n // We check both for backward compatibility, but the correct format is: %%NotePlanCloud%%/{teamspaceID}/...\n const formsPrefix1 = `%%NotePlanCloud%%${spaceId}/@Forms` // Incorrect format (for backward compatibility)\n const formsPrefix2 = `%%NotePlanCloud%%/${spaceId}/@Forms` // Correct format\n const templatesPrefix1 = `%%NotePlanCloud%%${spaceId}/@Templates` // Incorrect format (for backward compatibility)\n const templatesPrefix2 = `%%NotePlanCloud%%/${spaceId}/@Templates` // Correct format\n isInFormsFolder =\n noteFolder === formsPrefix1 || noteFolder.startsWith(`${formsPrefix1}/`) || noteFolder === formsPrefix2 || noteFolder.startsWith(`${formsPrefix2}/`)\n isInTemplatesFolder =\n noteFolder === templatesPrefix1 || noteFolder.startsWith(`${templatesPrefix1}/`) || noteFolder === templatesPrefix2 || noteFolder.startsWith(`${templatesPrefix2}/`)\n }\n\n if (!isInFormsFolder && !isInTemplatesFolder) {\n logDebug(pluginJson, `getFormTemplates: Skipping note \"${note.title || note.filename}\" - folder=\"${noteFolder}\", space=\"${spaceId || 'Private'}\" (not in @Forms or @Templates)`)\n continue // Skip notes not in @Forms or @Templates folder\n }\n inFormsFolderCount++\n spaceMatchCount++\n\n // Note passed all filters - add it to the list\n const title = note.title || note.filename || ''\n if (title) {\n // Determine space info for this template\n const templateSpaceId = isTeamspaceNote && noteTeamspaceID ? noteTeamspaceID : ''\n const templateSpaceTitle = isTeamspaceNote && noteTeamspaceID ? teamspaceMap.get(noteTeamspaceID) || 'Unknown Teamspace' : 'Private'\n \n formTemplates.push({\n label: title,\n value: note.filename || '',\n filename: note.filename || '',\n spaceId: templateSpaceId,\n spaceTitle: templateSpaceTitle,\n })\n }\n }\n }\n\n logDebug(\n pluginJson,\n `getFormTemplates: Scanned ${templateFormCount} template-form notes, ${inFormsFolderCount} in @Forms or @Templates folder, ${spaceMatchCount} matched space filter, ${formTemplates.length} added to results`,\n )\n\n // Sort by title\n formTemplates.sort((a, b) => a.label.localeCompare(b.label))\n\n logDebug(pluginJson, `getFormTemplates: Found ${formTemplates.length} templates`)\n return {\n success: true,\n data: formTemplates,\n }\n } catch (error) {\n logError(pluginJson, `getFormTemplates: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to get form templates: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get form fields and frontmatter for a specific template\n * @param {Object} params - Request parameters\n * @param {string} params.templateFilename - The template filename\n * @returns {RequestResponse}\n */\nexport async function getFormFields(params: { templateFilename?: string, templateTitle?: string, windowId?: string } = {}): Promise {\n try {\n const templateFilename = params.templateFilename\n if (!templateFilename) {\n return {\n success: false,\n message: 'templateFilename is required',\n data: null,\n }\n }\n\n logDebug(pluginJson, `getFormFields: templateFilename=\"${templateFilename}\"`)\n\n // Get the template note to read frontmatter\n const templateNote = await getNoteByFilename(templateFilename)\n if (!templateNote) {\n return {\n success: false,\n message: `Template not found: ${templateFilename}`,\n data: null,\n }\n }\n \n // Check for duplicate titles if templateTitle is provided\n const templateTitle = params.templateTitle || templateNote.title\n if (templateTitle) {\n const duplicates = findDuplicateFormTemplates(templateTitle)\n if (duplicates.length > 1) {\n // Multiple forms with same title found - include warning in response\n const duplicateFilenames = duplicates.map((d) => d.value).join(', ')\n const warningMsg = `⚠️ WARNING: Multiple forms found with the title \"${templateTitle}\". This may cause confusion. Duplicate files: ${duplicates.length} found. Please rename one of these forms to avoid conflicts.`\n logWarn(pluginJson, `getFormFields: Found ${duplicates.length} forms with title \"${templateTitle}\": ${duplicateFilenames}`)\n \n // Send banner message to React window if windowId is provided\n if (params.windowId && typeof params.windowId === 'string' && params.windowId.length > 0) {\n // $FlowFixMe[incompatible-call] - We've checked that windowId is a string above\n await sendBannerMessage(params.windowId, warningMsg, 'WARN', 10000)\n }\n }\n }\n\n // Load form fields from code block\n const formFields = await loadCodeBlockFromNote>(templateFilename, 'formfields', pluginJson.id, parseObjectString)\n\n if (!formFields || !Array.isArray(formFields)) {\n return {\n success: false,\n message: 'No form fields found in template',\n data: null,\n }\n }\n\n // Get frontmatter attributes\n const frontmatter = templateNote.frontmatterAttributes || {}\n\n logDebug(pluginJson, `getFormFields: Loaded ${formFields.length} form fields`)\n return {\n success: true,\n data: {\n formFields,\n frontmatter,\n },\n }\n } catch (error) {\n logError(pluginJson, `getFormFields: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to get form fields: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle form submission from FormBrowserView\n * @param {Object} params - Request parameters\n * @param {string} params.templateFilename - The template filename\n * @param {Object} params.formValues - The form values\n * @param {string} params.windowId - Optional window ID\n * @returns {RequestResponse}\n */\nexport async function handleSubmitForm(params: { templateFilename?: string, formValues?: Object, windowId?: string, keepOpenOnSubmit?: boolean } = {}): Promise {\n try {\n const { templateFilename, formValues, windowId, keepOpenOnSubmit } = params\n if (!templateFilename || !formValues) {\n return {\n success: false,\n message: 'templateFilename and formValues are required',\n data: null,\n }\n }\n\n logDebug(pluginJson, `handleSubmitForm: templateFilename=\"${templateFilename}\", keepOpenOnSubmit=${String(keepOpenOnSubmit || false)}`)\n\n // Load form context from file (same as submitFormRequest does)\n const formContext = await loadFormContextFromFilename(templateFilename)\n if (!formContext) {\n return {\n success: false,\n message: `Could not load form from \"${templateFilename}\". Template not found or invalid.`,\n data: { formSubmissionError: `Could not load form from \"${templateFilename}\".` },\n }\n }\n logDebug(pluginJson, `handleSubmitForm: Loaded formContext: newNoteTitle=\"${formContext.newNoteTitle}\", newNoteFolder=\"${formContext.newNoteFolder}\", templateBody length=${formContext.templateBody.length}`)\n\n // Get the template note to extract processing information\n const templateNote = await getNoteByFilename(templateFilename)\n if (!templateNote) {\n return {\n success: false,\n message: `Template not found: ${templateFilename}`,\n data: null,\n }\n }\n\n // Get frontmatter attributes\n const fm = templateNote.frontmatterAttributes || {}\n // Backward compat: formProcessorTitle was legacy name for receivingTemplateTitle\n const receivingTemplateFromFm = fm?.receivingTemplateTitle || fm?.formProcessorTitle\n const processingMethod = fm?.processingMethod || (receivingTemplateFromFm ? 'form-processor' : null)\n\n if (!processingMethod) {\n return {\n success: false,\n message: 'Template does not have a processingMethod set',\n data: null,\n }\n }\n\n // receivingTemplateTitle can come from formValues (dynamic) or frontmatter (static)\n // Backward compat: formProcessorTitle was legacy name for receivingTemplateTitle\n const receivingTemplateTitleFromForm = formValues?.receivingTemplateTitle || ''\n const receivingTemplateTitleFromFrontmatter =\n stripDoubleQuotes(fm?.receivingTemplateTitle || fm?.formProcessorTitle || '') || ''\n const receivingTemplateTitle = receivingTemplateTitleFromForm || receivingTemplateTitleFromFrontmatter\n \n // Build submitData with all necessary fields\n const submitData = {\n type: 'submit',\n formValues,\n windowId: windowId || '',\n processingMethod,\n receivingTemplateTitle: receivingTemplateTitle,\n getNoteTitled: stripDoubleQuotes(fm?.getNoteTitled || '') || '',\n location: fm?.location || 'append',\n writeUnderHeading: stripDoubleQuotes(fm?.writeUnderHeading || '') || '',\n replaceNoteContents: fm?.replaceNoteContents || false,\n createMissingHeading: fm?.createMissingHeading !== false,\n }\n\n // Merge loaded form context (templateBody, newNoteFrontmatter, newNoteTitle, newNoteFolder) into submitData\n // This matches what submitFormRequest does - processCreateNew reads from data.templateBody, data.newNoteTitle, etc.\n const submitDataWithFormContext = {\n ...submitData,\n templateBody: formContext.templateBody || '',\n newNoteFrontmatter: formContext.newNoteFrontmatter || '',\n newNoteTitle: formContext.newNoteTitle || '',\n newNoteFolder: formContext.newNoteFolder || '',\n }\n\n // Use formFields from loaded form context\n const formFields = formContext.formFields || []\n\n // Validate that all form fields are present in formValues (even if empty)\n // Conditional-values are resolved in prepareFormValuesForRendering; do not add them here\n if (formFields && formFields.length > 0) {\n const missingFields: Array = []\n formFields.forEach((field) => {\n if (field.type === 'conditional-values') return\n if (field.key && !(field.key in formValues)) {\n missingFields.push(field.key)\n // Add missing field with empty value\n formValues[field.key] = field.default ?? field.value ?? ''\n }\n })\n if (missingFields.length > 0) {\n logDebug(pluginJson, `handleSubmitForm: Added ${missingFields.length} missing field(s) to formValues: ${missingFields.join(', ')}`)\n }\n }\n\n const result = await handleSubmitButtonClick(submitDataWithFormContext, formFields)\n\n // Check for errors in result\n if (!result.success) {\n // Extract error message\n let errorMessage = result.formSubmissionError || 'Template execution failed.'\n if (!result.formSubmissionError && result.aiAnalysisResult) {\n // Extract a brief summary from AI analysis (first line or first sentence)\n const aiMsg = result.aiAnalysisResult\n const firstLine = aiMsg.split('\\n')[0] || aiMsg.substring(0, 200)\n errorMessage = `Template error: ${firstLine}`\n }\n \n logError(pluginJson, `handleSubmitForm: Form submission failed with error: ${errorMessage}`)\n // Return error info in data so FormBrowserView can access it even when success=false\n return {\n success: false,\n message: errorMessage,\n data: {\n formSubmissionError: result.formSubmissionError,\n aiAnalysisResult: result.aiAnalysisResult,\n processingMethod,\n },\n }\n }\n\n // Success case\n // Determine note title based on processing method for success dialog\n let noteTitle = ''\n if (processingMethod === 'create-new') {\n noteTitle = submitData.newNoteTitle || ''\n } else if (processingMethod === 'write-existing') {\n noteTitle = submitData.getNoteTitled || ''\n }\n // For form-processor and run-js-only, we don't know the note title, so leave it empty\n\n return {\n success: true,\n message: 'Form submitted successfully',\n data: {\n noteTitle,\n processingMethod,\n },\n }\n } catch (error) {\n logError(pluginJson, `handleSubmitForm: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to submit form: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle creating a new form from FormBrowserView\n * @param {Object} params - Request parameters\n * @param {string} params.formName - The form name (will have \"Form\" appended if not present)\n * @param {string} params.space - The space ID (empty string = Private, teamspace ID = specific teamspace)\n * @returns {RequestResponse}\n */\nexport async function handleCreateNewForm(params: { formName?: string, space?: string } = {}): Promise {\n try {\n const { formName, space = '' } = params\n logDebug(pluginJson, `handleCreateNewForm: Creating new form, formName=\"${formName || ''}\", space=\"${space || 'Private'}\"`)\n\n if (!formName || typeof formName !== 'string' || !formName.trim()) {\n logDebug(pluginJson, `handleCreateNewForm: No form name provided, returning`)\n return {\n success: false,\n message: 'Form name is required',\n data: null,\n }\n }\n\n // Append \"Form\" to title if it doesn't already contain \"form\" (case-insensitive)\n let newTitle = formName.trim()\n if (!/form/i.test(newTitle)) {\n newTitle = `${newTitle} Form`\n logDebug(pluginJson, `handleCreateNewForm: Appended \"Form\" to title, new title: \"${newTitle}\"`)\n }\n\n // Create folder path based on space\n // For Private: @Forms/{form name}\n // For teamspace: %%NotePlanCloud%%/{teamspaceID}/@Forms/{form name}\n // Note: teamspace folder format requires / after %%NotePlanCloud%%\n let formFolderPath: string\n if (space && space.trim()) {\n // Teamspace: construct path with teamspace prefix (note the / after %%NotePlanCloud%%)\n formFolderPath = `%%NotePlanCloud%%/${space}/@Forms/${newTitle}`\n } else {\n // Private: use standard folder path\n formFolderPath = `@Forms/${newTitle}`\n }\n logDebug(pluginJson, `handleCreateNewForm: Creating form in folder \"${formFolderPath}\"`)\n\n // Create new note in Forms subfolder\n const filename = DataStore.newNote(newTitle, formFolderPath)\n logDebug(pluginJson, `handleCreateNewForm: DataStore.newNote returned filename: \"${filename || 'null'}\"`)\n if (!filename) {\n logError(pluginJson, `handleCreateNewForm: Failed to create template \"${newTitle}\"`)\n await showMessage(`Failed to create template \"${newTitle}\"`)\n return {\n success: false,\n message: `Failed to create template \"${newTitle}\"`,\n data: null,\n }\n }\n\n // Wait for the note to appear in the cache (especially important for teamspace notes)\n // Teamspace notes may take a moment to be indexed after creation\n logDebug(pluginJson, `handleCreateNewForm: Waiting for note to appear in cache...`)\n const noteFound = await waitForCondition(\n () => {\n const note = DataStore.projectNoteByFilename(filename)\n return note != null\n },\n { maxWaitMs: 3000, checkIntervalMs: 100 },\n )\n\n if (!noteFound) {\n logError(pluginJson, `handleCreateNewForm: Note did not appear in cache within timeout: ${filename}`)\n await showMessage(`Note was created but could not be found. Please try again.`)\n return {\n success: false,\n message: `Note was created but could not be found: ${filename}`,\n data: null,\n }\n }\n\n // Now get the note (should be available now)\n const templateNote = await getNoteByFilename(filename)\n if (!templateNote) {\n logError(pluginJson, `handleCreateNewForm: Could not find note with filename: ${filename}`)\n await showMessage(`Failed to open newly created template \"${newTitle}\"`)\n return {\n success: false,\n message: `Failed to open newly created template \"${newTitle}\"`,\n data: null,\n }\n }\n\n // Set frontmatter for new template\n ensureFrontmatter(templateNote, true, newTitle)\n const encodedNewTitle = encodeURIComponent(newTitle)\n const newLaunchLink = `noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.Forms&command=Open%20Template%20Form&arg0=${encodedNewTitle}`\n const newFormEditLink = `noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.Forms&command=Form%20Builder/Editor&arg0=${encodedNewTitle}`\n\n updateFrontMatterVars(templateNote, {\n type: 'template-form',\n windowTitle: newTitle,\n launchLink: newLaunchLink,\n formEditLink: newFormEditLink,\n })\n\n // Update cache to ensure note is available\n DataStore.updateCache(templateNote, true)\n\n // Open FormBuilder with the new form (pass isNewForm: true so default comment field is added)\n await openFormBuilderWindow({\n formFields: [],\n templateFilename: filename,\n templateTitle: newTitle,\n isNewForm: true,\n })\n\n return {\n success: true,\n message: `Form \"${newTitle}\" created successfully`,\n data: { templateFilename: filename, templateTitle: newTitle },\n }\n } catch (error) {\n logError(pluginJson, `handleCreateNewForm: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to create new form: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle opening FormBuilder from FormBrowserView\n * @param {Object} params - Request parameters\n * @param {string} params.templateTitle - Optional template title to open in FormBuilder\n * @param {string} params.initialReceivingTemplateTitle - Optional receiving template title\n * @returns {RequestResponse}\n */\nexport async function handleOpenFormBuilder(params: { templateTitle?: string, initialReceivingTemplateTitle?: string } = {}): Promise {\n try {\n const { templateTitle, initialReceivingTemplateTitle } = params\n logDebug(\n pluginJson,\n `handleOpenFormBuilder: Opening FormBuilder, templateTitle=\"${templateTitle || ''}\", initialReceivingTemplateTitle=\"${initialReceivingTemplateTitle || ''}\"`,\n )\n\n if (templateTitle) {\n // Open existing form in FormBuilder\n // The receivingTemplateTitle will be read from the note's frontmatter by openFormBuilder\n // But if initialReceivingTemplateTitle is provided, it will be used instead\n await openFormBuilder(templateTitle)\n } else {\n // Open FormBuilder for new form\n await openFormBuilder()\n }\n\n return {\n success: true,\n message: 'FormBuilder opened',\n data: null,\n }\n } catch (error) {\n logError(pluginJson, `handleOpenFormBuilder: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to open FormBuilder: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle opening a note by title from FormBrowserView\n * @param {Object} params - Request parameters\n * @param {string} params.noteTitle - The note title to open\n * @returns {Promise}\n */\nexport async function handleOpenNoteByTitle(params: { noteTitle?: string } = {}): Promise {\n try {\n const { noteTitle } = params\n if (!noteTitle) {\n return {\n success: false,\n message: 'noteTitle is required',\n data: null,\n }\n }\n\n logDebug(pluginJson, `handleOpenNoteByTitle: noteTitle=\"${noteTitle}\"`)\n\n // Find note by title (getNote returns a Promise)\n const note = await getNote(noteTitle)\n if (!note) {\n return {\n success: false,\n message: `Note not found: ${noteTitle}`,\n data: null,\n }\n }\n\n // Open the note in the editor\n Editor.openNoteByFilename(note.filename || '')\n\n return {\n success: true,\n message: 'Note opened successfully',\n data: null,\n }\n } catch (error) {\n logError(pluginJson, `handleOpenNoteByTitle: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to open note: ${error.message}`,\n data: null,\n }\n }\n}\n" }, { "path": "dwertheimer.Forms/src/formBrowserRouter.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Browser Router\n// Routes requests from FormBrowserView React component to appropriate handlers\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { getFormTemplates, getFormFields, handleSubmitForm, handleOpenFormBuilder, handleCreateNewForm, handleOpenNoteByTitle } from './formBrowserHandlers'\nimport { handleDuplicateForm } from './formBuilderHandlers' // For duplicate functionality\nimport { handleRequest } from './requestHandlers' // For shared requests like getTeamspaces\nimport { newCommsRouter, type RequestResponse } from '@helpers/react/routerUtils'\n\nconst FORM_BROWSER_WINDOW_ID = 'forms-chooser-window'\n\n/**\n * Route request to appropriate handler based on action type\n * @param {string} actionType - The action/command type\n * @param {any} data - Request data\n * @returns {Promise}\n */\nasync function routeFormBrowserRequest(actionType: string, data: any): Promise {\n // Route to form browser specific handlers\n switch (actionType) {\n case 'getFormTemplates':\n return getFormTemplates(data)\n case 'getFormFields':\n return await getFormFields(data)\n case 'submitForm':\n return await handleSubmitForm(data)\n case 'openFormBuilder':\n return await handleOpenFormBuilder(data)\n case 'createNewForm':\n return await handleCreateNewForm(data)\n case 'duplicateForm':\n return await handleDuplicateForm(data)\n case 'openNote':\n return await handleOpenNoteByTitle(data)\n default:\n // For shared requests (getTeamspaces, etc.), use the shared request handler\n return await handleRequest(actionType, data)\n }\n}\n\n/**\n * Handle actions from FormBrowserView React component\n * Routes requests to appropriate handlers and sends responses back\n * @param {string} actionType - The action/command type (e.g., 'getFormTemplates', 'getFormFields')\n * @param {any} data - Request data with optional __requestType, __correlationId, __windowId\n * @returns {Promise}\n */\nexport const onFormBrowserAction: (actionType: string, data: any) => Promise = newCommsRouter({\n routerName: 'onFormBrowserAction',\n defaultWindowId: FORM_BROWSER_WINDOW_ID,\n routeRequest: routeFormBrowserRequest,\n pluginJson: pluginJson,\n useSharedHandlersFallback: true, // Forms uses shared handlers for choosers\n // FormBrowserView primarily uses REQUEST/RESPONSE pattern, no non-REQUEST actions\n})\n" }, { "path": "dwertheimer.Forms/src/formBuilderHandlers.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Builder Request Handlers\n// Handlers for requests from FormBuilder component\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { getGlobalSharedData } from '../../helpers/HTMLView'\nimport { createProcessingTemplate } from './ProcessingTemplate'\nimport { openFormBuilder } from './NPTemplateForm'\nimport { FORMBUILDER_WINDOW_ID } from './windowManagement'\nimport {\n formatFormFieldsAsCodeBlock,\n getFormTemplateList,\n loadTemplateBodyFromTemplate,\n loadTemplateRunnerArgsFromTemplate,\n saveFormFieldsToTemplate,\n saveTemplateBodyToTemplate,\n saveTemplateRunnerArgsToTemplate,\n saveCustomCSSToTemplate,\n saveNewNoteFrontmatterToTemplate,\n updateReceivingTemplateWithFields,\n} from './templateIO'\nimport { removeEmptyLinesFromNote, updateFormLinksInNote } from './requestHandlers'\nimport { getNoteByFilename, getNote } from '@helpers/note'\nimport { focusHTMLWindowIfAvailable } from '@helpers/NPWindows'\nimport { updateFrontMatterVars, ensureFrontmatter, endOfFrontmatterLineIndex } from '@helpers/NPFrontMatter'\nimport { saveCodeBlockToNote, loadCodeBlockFromNote } from '@helpers/codeBlocks'\nimport { parseObjectString, stripDoubleQuotes } from '@helpers/stringTransforms'\nimport { replaceContentUnderHeading } from '@helpers/NPParagraph'\nimport { waitForCondition } from '@helpers/promisePolyfill'\nimport { getFolderFromFilename } from '@helpers/folders'\nimport { logDebug, logError, logWarn } from '@helpers/dev'\nimport { showMessage } from '@helpers/userInput'\n\n// RequestResponse type definition (shared with requestHandlers.js)\nexport type RequestResponse = {\n success: boolean,\n message?: string,\n data?: any,\n}\n\n/**\n * Allowlist of keys that are written to the form note's YAML frontmatter when saving.\n * Only these keys are passed to saveFrontmatterToTemplate; all others are ignored.\n *\n * We use an allowlist (not a blocklist) so that:\n * - New codeblock-only fields (templateBody, customCSS, newNoteFrontmatter, TemplateRunner args)\n * can never accidentally leak into frontmatter if someone forgets to add them to a blocklist.\n * - The form frontmatter schema is a single source of truth.\n *\n * Keys that live in code blocks and must NOT be in this list:\n * - templateBody, customCSS, newNoteFrontmatter (template:ignore code blocks)\n * - newNoteTitle, getNoteTitled, location, writeUnderHeading, replaceNoteContents,\n * createMissingHeading, newNoteFolder (template:ignore templateRunnerArgs code block)\n */\nconst FORM_FRONTMATTER_ALLOWLIST = [\n 'type',\n 'title',\n 'windowTitle',\n 'formTitle',\n 'launchLink',\n 'formEditLink',\n 'allowEmptySubmit',\n 'hideDependentItems',\n 'width',\n 'height',\n 'x',\n 'y',\n 'processingMethod',\n 'receivingTemplateTitle',\n 'space',\n 'shouldOpenInEditor',\n]\n\n/**\n * Handle creating a processing template from FormBuilder\n * @param {Object} params - Request parameters\n * @returns {RequestResponse}\n */\nexport async function handleCreateProcessingTemplate(params: Object): Promise {\n try {\n logDebug(pluginJson, `handleCreateProcessingTemplate: params=${JSON.stringify(params)}`)\n\n const options = {\n formTemplateTitle: params.formTemplateTitle,\n formTemplateFilename: params.formTemplateFilename,\n suggestedProcessingTitle: params.suggestedProcessingTitle,\n formLaunchLink: params.formLaunchLink,\n formEditLink: params.formEditLink,\n }\n\n const result = await createProcessingTemplate(options)\n\n if (result && result.processingTitle) {\n // Bring the Form Builder window back to the front\n focusHTMLWindowIfAvailable(FORMBUILDER_WINDOW_ID)\n\n const processingTitle = result.processingTitle || ''\n return {\n success: true,\n message: `Processing template \"${processingTitle}\" created successfully`,\n data: {\n processingTitle: processingTitle,\n processingFilename: result.processingFilename,\n },\n }\n } else {\n return {\n success: false,\n message: 'Processing template creation was cancelled or failed',\n data: null,\n }\n }\n } catch (error) {\n logError(pluginJson, `handleCreateProcessingTemplate: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to create processing template: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle opening a note from FormBuilder\n * @param {Object} params - Request parameters\n * @param {string} params.filename - The note filename to open (preferred)\n * @param {string} params.title - The note title to open (fallback if filename not provided)\n * @returns {RequestResponse}\n */\nexport async function handleOpenNote(params: { filename?: string, title?: string }): Promise {\n try {\n const filename = params.filename\n const title = params.title\n\n if (!filename && !title) {\n return {\n success: false,\n message: 'filename or title is required',\n data: null,\n }\n }\n\n if (filename) {\n logDebug(pluginJson, `handleOpenNote: Opening by filename=\"${filename}\"`)\n // Open the note in the editor\n Editor.openNoteByFilename(filename)\n return {\n success: true,\n message: 'Note opened successfully',\n data: null,\n }\n } else if (title) {\n logDebug(pluginJson, `handleOpenNote: Opening by title=\"${title}\"`)\n // Find note by title using getNote helper\n const note = await getNote(title)\n if (!note) {\n return {\n success: false,\n message: `Note not found: ${title}`,\n data: null,\n }\n }\n // Open the note in the editor\n Editor.openNoteByFilename(note.filename || '')\n return {\n success: true,\n message: 'Note opened successfully',\n data: null,\n }\n }\n\n return {\n success: false,\n message: 'No filename or title provided',\n data: null,\n }\n } catch (error) {\n logError(pluginJson, `handleOpenNote: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to open note: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle copying form URL to clipboard\n * @param {Object} params - Request parameters\n * @param {string} params.launchLink - The launch link URL to copy\n * @returns {RequestResponse}\n */\nexport function handleCopyFormUrl(params: { launchLink?: string }): RequestResponse {\n try {\n const launchLink = params.launchLink\n logDebug(pluginJson, `handleCopyFormUrl: launchLink=\"${String(launchLink || '')}\"`)\n if (!launchLink) {\n logError(pluginJson, `handleCopyFormUrl: No launchLink provided in params`)\n return {\n success: false,\n message: 'No launch link provided',\n data: null,\n }\n }\n\n Clipboard.string = launchLink\n logDebug(pluginJson, `handleCopyFormUrl: Successfully copied to clipboard, Clipboard.string=\"${Clipboard.string}\"`)\n return {\n success: true,\n message: 'Form URL copied to clipboard',\n data: null,\n }\n } catch (error) {\n logError(pluginJson, `handleCopyFormUrl: Error copying to clipboard: ${error.message || String(error)}`)\n return {\n success: false,\n message: `Failed to copy URL: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle duplicating a form template\n * @param {Object} params - Request parameters\n * @param {string} params.templateFilename - The source template filename\n * @param {string} params.templateTitle - The source template title\n * @param {string} params.receivingTemplateTitle - The receiving template title (if any)\n * @returns {RequestResponse}\n */\nexport async function handleDuplicateForm(params: { templateFilename?: string, templateTitle?: string, receivingTemplateTitle?: string }): Promise {\n try {\n const { templateFilename, templateTitle, receivingTemplateTitle } = params\n if (!templateFilename || !templateTitle) {\n return {\n success: false,\n message: 'Template filename and title are required',\n data: null,\n }\n }\n\n // Prompt for new name (suggest current name + \" copy\")\n const suggestedName = `${templateTitle} copy`\n const newTitle = await CommandBar.textPrompt('Duplicate Form', 'Enter new form title:', suggestedName)\n if (!newTitle || typeof newTitle === 'boolean') {\n return {\n success: false,\n message: 'Duplicate cancelled',\n data: null,\n }\n }\n\n // Read the current form template\n const sourceNote = await getNoteByFilename(templateFilename)\n if (!sourceNote) {\n return {\n success: false,\n message: `Could not find source form template: ${templateFilename}`,\n data: null,\n }\n }\n\n // Get folder from source template (use same folder as original, not a subfolder)\n const sourceFolder = getFolderFromFilename(templateFilename) || '@Forms'\n\n // Read all codeblocks from source\n const formFields = await loadCodeBlockFromNote>(sourceNote, 'formfields', pluginJson.id, parseObjectString)\n const templateBody = await loadTemplateBodyFromTemplate(sourceNote)\n const templateRunnerArgs = await loadTemplateRunnerArgsFromTemplate(sourceNote)\n\n // Create new note with empty content (updateFormLinksInNote will add the heading and links)\n const newNoteContent = ''\n\n // Create new note in the same folder as the original (not inside the original's folder)\n const newFilename = DataStore.newNoteWithContent(newNoteContent, sourceFolder, `${newTitle}.md`)\n if (!newFilename) {\n return {\n success: false,\n message: `Failed to create duplicate form \"${newTitle}\"`,\n data: null,\n }\n }\n\n const newNote = await getNoteByFilename(newFilename)\n if (!newNote) {\n return {\n success: false,\n message: `Created duplicate form but could not open it: ${newFilename}`,\n data: null,\n }\n }\n\n // Update cache immediately after getting the note to ensure it's available\n const cachedNote = DataStore.updateCache(newNote, true)\n if (cachedNote) {\n logDebug(pluginJson, `handleDuplicateForm: Updated cache for newly created note \"${newTitle}\"`)\n }\n\n // Copy frontmatter using frontmatterAttributesArray to preserve order and all fields\n const sourceFrontmatterArray = sourceNote.frontmatterAttributesArray || []\n const encodedNewTitle = encodeURIComponent(newTitle)\n const newLaunchLink = `noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.Forms&command=Open%20Template%20Form&arg0=${encodedNewTitle}`\n const newFormEditLink = `noteplan://x-callback-url/runPlugin?pluginID=dwertheimer.Forms&command=Form%20Builder/Editor&arg0=${encodedNewTitle}`\n\n // Prepare frontmatter for new note copy all fields from source, updating title-related ones\n const newFrontmatter: { [string]: string } = {}\n const fieldsToUpdate = {\n type: 'template-form',\n windowTitle: newTitle,\n // formTitle is left blank by default - user can fill it in later (don't copy from source)\n launchLink: newLaunchLink,\n formEditLink: newFormEditLink,\n }\n\n // Copy all frontmatter fields from source, preserving order\n for (const attr of sourceFrontmatterArray) {\n const key = attr.key\n // Skip title-related fields that we'll update\n if (!['type', 'windowTitle', 'formTitle', 'launchLink', 'formEditLink', 'title'].includes(key)) {\n newFrontmatter[key] = attr.value\n }\n }\n\n // Add/update the title-related fields\n Object.assign(newFrontmatter, fieldsToUpdate)\n\n // Update frontmatter - ensure frontmatter exists first\n ensureFrontmatter(newNote, true, newTitle)\n updateFrontMatterVars(newNote, newFrontmatter)\n\n // Update markdown links in body using replaceContentUnderHeading (works better than manual insertion)\n await updateFormLinksInNote(newNote, newTitle, newLaunchLink, newFormEditLink, undefined)\n\n // Copy codeblocks (these will be added after the heading)\n if (formFields && Array.isArray(formFields) && formFields.length > 0) {\n await saveCodeBlockToNote(newFilename, 'formfields', formFields, pluginJson.id, formatFormFieldsAsCodeBlock, false)\n }\n if (templateBody) {\n await saveCodeBlockToNote(newFilename, 'template:ignore templateBody', templateBody, pluginJson.id, null, false)\n }\n if (templateRunnerArgs) {\n await saveCodeBlockToNote(newFilename, 'template:ignore templateRunnerArgs', templateRunnerArgs, pluginJson.id, (obj) => JSON.stringify(obj, null, 2), false)\n }\n\n // Reload note after code blocks are saved to get latest content\n const noteAfterCodeBlocks = await getNoteByFilename(newFilename)\n if (noteAfterCodeBlocks) {\n // Update cache after code blocks are saved\n DataStore.updateCache(noteAfterCodeBlocks, true)\n }\n\n // Clean up: remove any duplicate title text and extra blank lines\n const finalNote = await getNoteByFilename(newFilename)\n if (finalNote) {\n // Remove text paragraphs that are just the title (duplicates)\n const titleText = newTitle.trim()\n const cleanedParas = finalNote.paragraphs.filter((p) => {\n // Keep frontmatter separators\n if (p.type === 'separator') return true\n // Remove text paragraphs that match the title exactly (these are unwanted duplicates)\n if (p.type === 'text' && p.content.trim() === titleText) return false\n return true\n })\n\n // Rebuild content without the duplicate title\n const contentParts = cleanedParas.map((p) => p.rawContent)\n finalNote.content = contentParts.join('\\n')\n finalNote.updateParagraphs(finalNote.paragraphs)\n\n // Remove empty lines\n removeEmptyLinesFromNote(finalNote)\n\n // Update cache to ensure the note is available in DataStore.projectNotes\n // This is critical for getFormTemplateList() to find the newly created form\n const updatedNote = DataStore.updateCache(finalNote, true)\n if (updatedNote) {\n logDebug(pluginJson, `handleDuplicateForm: Updated cache for note \"${newTitle}\"`)\n } else {\n logWarn(pluginJson, `handleDuplicateForm: Failed to update cache for note \"${newTitle}\"`)\n }\n }\n\n // Wait for the note to be available in getFormTemplateList() before trying to open it\n // This handles race conditions where the note was created but not yet in DataStore.projectNotes\n logDebug(pluginJson, `handleDuplicateForm: Waiting for note \"${newTitle}\" to be available in cache...`)\n const noteAvailable = await waitForCondition(\n () => {\n const options = getFormTemplateList()\n const found = options.find((option) => option.label === newTitle)\n if (found) {\n logDebug(pluginJson, `handleDuplicateForm: Note \"${newTitle}\" is now available in cache`)\n return true\n }\n return false\n },\n { maxWaitMs: 3000, checkIntervalMs: 100 },\n )\n\n if (!noteAvailable) {\n logWarn(pluginJson, `handleDuplicateForm: Note \"${newTitle}\" not found in cache after waiting, but will try to open anyway`)\n }\n\n // If there's a receiving template, duplicate it too\n let newReceivingTemplateTitle = ''\n if (receivingTemplateTitle) {\n const receivingNote = await getNoteByFilename(receivingTemplateTitle)\n if (receivingNote) {\n // Create duplicate receiving template\n const receivingFolder = getFolderFromFilename(receivingTemplateTitle) || sourceFolder\n const newReceivingTitle = `${receivingTemplateTitle} copy`\n const newReceivingContent = receivingNote.content || ''\n const newReceivingFilename = DataStore.newNoteWithContent(newReceivingContent, receivingFolder, `${newReceivingTitle}.md`)\n if (newReceivingFilename) {\n const newReceivingNote = await getNoteByFilename(newReceivingFilename)\n if (newReceivingNote) {\n // Copy frontmatter from receiving template\n const receivingFrontmatter = receivingNote.frontmatterAttributes || {}\n const newReceivingFrontmatter: { [string]: string } = {}\n Object.keys(receivingFrontmatter).forEach((key) => {\n if (key !== 'title') {\n newReceivingFrontmatter[key] = String(receivingFrontmatter[key])\n }\n })\n updateFrontMatterVars(newReceivingNote, newReceivingFrontmatter)\n newReceivingTemplateTitle = newReceivingTitle\n\n // Update the form's receivingTemplateTitle\n updateFrontMatterVars(newNote, { receivingTemplateTitle: newReceivingTemplateTitle })\n }\n }\n }\n }\n\n // Open the new form in the Form Builder\n await openFormBuilder(newTitle)\n\n return {\n success: true,\n message: `Form \"${newTitle}\" duplicated successfully`,\n data: {\n newTemplateFilename: newFilename,\n newTemplateTitle: newTitle,\n newReceivingTemplateTitle: newReceivingTemplateTitle || undefined,\n },\n }\n } catch (error) {\n logError(pluginJson, `handleDuplicateForm: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to duplicate form: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Save frontmatter to template\n * @param {string} templateFilename - The template filename\n * @param {Object} frontmatter - The frontmatter object\n * @returns {Promise}\n */\nexport async function saveFrontmatterToTemplate(templateFilename: string, frontmatter: Object): Promise {\n try {\n if (!templateFilename) {\n await showMessage('No template filename provided. Cannot save frontmatter.')\n return\n }\n\n const templateNote = await getNoteByFilename(templateFilename)\n if (!templateNote) {\n await showMessage(`Template not found: ${templateFilename}`)\n return\n }\n\n // Convert all frontmatter values to strings (updateFrontMatterVars expects strings)\n // Strip any quotes that might have been added\n // IMPORTANT: Skip empty string values to avoid writing \"\" to frontmatter\n const frontmatterAsStrings: { [string]: string } = {}\n Object.keys(frontmatter).forEach((key) => {\n const value = frontmatter[key]\n // Skip null, undefined, and empty strings - don't write them to frontmatter\n if (value === null || value === undefined) {\n // Skip - don't add to frontmatterAsStrings\n return\n }\n\n let stringValue: string = ''\n if (typeof value === 'boolean') {\n stringValue = String(value)\n } else if (typeof value === 'number') {\n stringValue = String(value)\n } else if (typeof value === 'string') {\n // Strip quotes from string values\n stringValue = stripDoubleQuotes(value)\n } else {\n stringValue = stripDoubleQuotes(String(value))\n }\n\n // Allow empty strings for specific fields that users may want to blank out (formTitle, windowTitle)\n // receivingTemplateTitle should also be allowed to be empty (to clear it)\n // For other fields, skip empty strings to avoid writing \"\" to frontmatter\n const fieldsThatAllowEmpty = ['formTitle', 'windowTitle', 'receivingTemplateTitle']\n const shouldInclude = stringValue !== '' || fieldsThatAllowEmpty.includes(key)\n if (shouldInclude) {\n frontmatterAsStrings[key] = stringValue\n logDebug(pluginJson, `saveFrontmatterToTemplate: Including ${key}=\"${stringValue}\" (empty string allowed: ${String(fieldsThatAllowEmpty.includes(key))})`)\n } else {\n logDebug(pluginJson, `saveFrontmatterToTemplate: Skipping ${key}=\"${stringValue}\" (empty string not allowed for this field)`)\n }\n })\n\n // Update frontmatter (only non-empty values will be written)\n updateFrontMatterVars(templateNote, frontmatterAsStrings)\n logDebug(pluginJson, `saveFrontmatterToTemplate: Saved frontmatter to template`)\n } catch (error) {\n logError(pluginJson, `saveFrontmatterToTemplate error: ${error.message || String(error)}`)\n await showMessage(`Error saving frontmatter: ${error.message}`)\n }\n}\n\n/**\n * Handle save request from React (request/response pattern)\n * @param {Object} data - Request data containing fields, frontmatter, templateFilename, templateTitle\n * @returns {Promise<{success: boolean, message?: string, data?: any}>}\n */\n// Buffer buster padding for NotePlan's console\nexport async function handleSaveRequest(data: any): Promise<{ success: boolean, message?: string, data?: any }> {\n const saveId = `SAVE-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: ENTRY - saveId=${saveId}`)\n logDebug(\n pluginJson,\n `[${saveId}] handleSaveRequest: data.fields: ${\n data?.fields ? `exists, type=${typeof data.fields}, isArray=${String(Array.isArray(data.fields))}, length=${data.fields.length || 0}` : 'missing'\n }`,\n )\n if (data?.fields?.length > 0) {\n logDebug(\n pluginJson,\n `[${saveId}] handleSaveRequest: First field: ${typeof data.fields[0] === 'string' ? data.fields[0].substring(0, 50) : JSON.stringify(data.fields[0]).substring(0, 50)}`,\n )\n }\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: ENTRY - Starting save request`)\n try {\n // Get the template filename from the data passed from React, or fall back to reactWindowData\n const templateFilename = data?.templateFilename\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: templateFilename=\"${templateFilename}\"`)\n // Try to get window data using the windowId from the request (if provided), otherwise use the default\n const windowId = data?.__windowId || FORMBUILDER_WINDOW_ID\n let fallbackTemplateFilename = ''\n try {\n // Note: getGlobalSharedData may hang if window is in bad state, but we can't use Promise.race\n // in NotePlan's JSContext (Promise is not a constructor). Just try it and let it fail naturally.\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Attempting to get window data for windowId=\"${windowId}\"`)\n const reactWindowData = await getGlobalSharedData(windowId)\n fallbackTemplateFilename = reactWindowData?.pluginData?.templateFilename || ''\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Got window data, fallbackTemplateFilename=\"${fallbackTemplateFilename}\"`)\n } catch (e) {\n // If we can't get window data, that's ok - we'll use templateFilename from data\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Could not get window data: ${e.message || String(e)}`)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Could not get window data for windowId=\"${windowId}\", using templateFilename from data`)\n }\n const finalTemplateFilename = templateFilename || fallbackTemplateFilename\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: finalTemplateFilename=\"${finalTemplateFilename}\"`)\n\n if (!finalTemplateFilename) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: ERROR: No template filename provided`)\n return {\n success: false,\n message: 'No template filename provided',\n data: null,\n }\n }\n\n // Check for missing or empty fields array\n logDebug(\n pluginJson,\n `[${saveId}] handleSaveRequest: Checking fields: data?.fields=${data?.fields ? 'exists' : 'missing'}, isArray=${String(Array.isArray(data?.fields))}, length=${\n data?.fields?.length || 0\n }`,\n )\n if (!data?.fields || !Array.isArray(data.fields) || data.fields.length === 0) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: ERROR: No fields provided to save`)\n return {\n success: false,\n message: 'No fields provided to save',\n data: null,\n }\n }\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Fields check passed, proceeding with save`)\n\n // Parse fields if they're strings (shouldn't happen, but just in case)\n logDebug(\n pluginJson,\n `[${saveId}] handleSaveRequest: Fields before parsing: type=${typeof data.fields}, isArray=${String(Array.isArray(data.fields))}, length=${\n data.fields?.length || 0\n }, firstFieldType=${data.fields?.[0] ? typeof data.fields[0] : 'none'}`,\n )\n let fieldsToSave = data.fields\n if (Array.isArray(fieldsToSave) && fieldsToSave.length > 0 && typeof fieldsToSave[0] === 'string') {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Fields are strings, attempting to parse`)\n logWarn(pluginJson, `[${saveId}] handleSaveRequest: Fields are strings, attempting to parse`)\n fieldsToSave = fieldsToSave.map((field) => {\n try {\n const parsed = typeof field === 'string' ? JSON.parse(field) : field\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Parsed field: ${JSON.stringify(parsed).substring(0, 100)}`)\n return parsed\n } catch (e) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Error parsing field: ${e.message}`)\n logError(pluginJson, `[${saveId}] handleSaveRequest: Error parsing field: ${e.message}`)\n return field\n }\n })\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Finished parsing ${fieldsToSave.length} fields`)\n } else {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Fields are already objects, no parsing needed`)\n }\n\n // Clean up markdown-preview fields: remove empty string values\n // Empty strings are used in the UI to maintain state, but shouldn't be saved\n fieldsToSave = fieldsToSave.map((field) => {\n if (field.type === 'markdown-preview') {\n const cleaned = { ...field }\n // Remove empty string values - they're just UI state markers\n if (cleaned.sourceNoteKey === '') {\n delete cleaned.sourceNoteKey\n }\n if (cleaned.markdownNoteFilename === '') {\n delete cleaned.markdownNoteFilename\n }\n if (cleaned.markdownNoteTitle === '') {\n delete cleaned.markdownNoteTitle\n }\n if (cleaned.markdownText === '') {\n delete cleaned.markdownText\n }\n // Also clean up old property names for backward compatibility\n if (cleaned.dependsOnNoteKey === '') {\n delete cleaned.dependsOnNoteKey\n }\n return cleaned\n }\n return field\n })\n\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to save ${fieldsToSave.length} fields to template \"${finalTemplateFilename}\"`)\n\n await saveFormFieldsToTemplate(finalTemplateFilename, fieldsToSave)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Fields saved to template successfully`)\n\n // Extract TemplateRunner processing variables from frontmatter\n // These contain template tags and should be stored in codeblock, not frontmatter\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Creating templateRunnerArgs object`)\n const templateRunnerArgs: { [string]: any } = {}\n const templateRunnerArgKeys = [\n 'newNoteTitle', // Contains template tags like <%- field1 %>\n 'getNoteTitled', // May contain special values like , \n 'location', // Write location setting\n 'writeUnderHeading', // Heading to write under\n 'replaceNoteContents', // Whether to replace note contents\n 'createMissingHeading', // Whether to create missing heading\n 'newNoteFolder', // Folder for new note\n ]\n\n // Extract TemplateRunner args from frontmatter\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Checking if frontmatter exists: ${data?.frontmatter ? 'yes' : 'no'}`)\n if (data?.frontmatter) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Extracting TemplateRunner args from frontmatter`)\n templateRunnerArgKeys.forEach((key) => {\n if (data.frontmatter[key] !== undefined) {\n templateRunnerArgs[key] = data.frontmatter[key]\n }\n })\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Extracted ${Object.keys(templateRunnerArgs).length} TemplateRunner args`)\n } else {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: No frontmatter found, skipping TemplateRunner args extraction`)\n }\n\n // Save templateBody to codeblock if provided\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Checking templateBody: ${data?.frontmatter?.templateBody !== undefined ? 'exists' : 'missing'}`)\n if (data?.frontmatter?.templateBody !== undefined) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to save templateBody to codeblock`)\n await saveTemplateBodyToTemplate(finalTemplateFilename, data.frontmatter.templateBody || '')\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: templateBody saved to codeblock`)\n }\n\n // Save custom CSS to codeblock if provided\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Checking customCSS: ${data?.frontmatter?.customCSS !== undefined ? 'exists' : 'missing'}`)\n if (data?.frontmatter?.customCSS !== undefined) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to save customCSS to codeblock`)\n await saveCustomCSSToTemplate(finalTemplateFilename, data.frontmatter.customCSS || '')\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: customCSS saved to codeblock`)\n }\n\n // Save newNoteFrontmatter to codeblock if provided\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Checking newNoteFrontmatter: ${data?.frontmatter?.newNoteFrontmatter !== undefined ? 'exists' : 'missing'}`)\n if (data?.frontmatter?.newNoteFrontmatter !== undefined) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to save newNoteFrontmatter to codeblock`)\n await saveNewNoteFrontmatterToTemplate(finalTemplateFilename, data.frontmatter.newNoteFrontmatter || '')\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: newNoteFrontmatter saved to codeblock`)\n }\n\n // Save TemplateRunner args to codeblock if any exist\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Checking TemplateRunner args: ${Object.keys(templateRunnerArgs).length} keys`)\n if (Object.keys(templateRunnerArgs).length > 0) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to save TemplateRunner args to codeblock`)\n await saveTemplateRunnerArgsToTemplate(finalTemplateFilename, templateRunnerArgs)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: TemplateRunner args saved to codeblock`)\n } else {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: No TemplateRunner args to save`)\n }\n\n // Save frontmatter using allowlist: only prescribed keys get written to the form note's YAML.\n // All other keys (templateBody, customCSS, newNoteFrontmatter, TemplateRunner args) live in code blocks.\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to check if frontmatter needs to be saved`)\n if (data?.frontmatter) {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Building frontmatter from FORM_FRONTMATTER_ALLOWLIST`)\n const frontmatterForSave: { [string]: any } = {}\n FORM_FRONTMATTER_ALLOWLIST.forEach((key) => {\n if (data.frontmatter[key] !== undefined) {\n frontmatterForSave[key] = data.frontmatter[key]\n }\n })\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Frontmatter to save (allowlist): ${JSON.stringify(frontmatterForSave)}`)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: receivingTemplateTitle=\"${frontmatterForSave.receivingTemplateTitle || 'MISSING'}\"`)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to save frontmatter to template`)\n await saveFrontmatterToTemplate(finalTemplateFilename, frontmatterForSave)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Frontmatter saved successfully`)\n } else {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: No frontmatter provided in data`)\n }\n\n // Get template note for success message and cleanup\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Getting template note for \"${finalTemplateFilename}\"...`)\n const templateNote = await getNoteByFilename(finalTemplateFilename)\n const templateTitle = templateNote?.title || finalTemplateFilename\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Template note found: title=\"${templateTitle}\", type=\"${templateNote?.frontmatterAttributes?.type || 'none'}\"`)\n\n // Remove empty lines from the note\n if (templateNote) {\n removeEmptyLinesFromNote(templateNote)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Removed empty lines from note`)\n }\n\n // Check if we should update the receiving template\n // Use try-catch to ensure form saving continues even if template update fails\n // Update automatically without prompting (user requested automatic update)\n // Note: We await this so it completes, but errors don't stop the save\n // IMPORTANT: Skip updating the receiving template if this is being called recursively\n // (i.e., if we're already saving a processing template itself)\n // This prevents infinite loops when the processing template has its own receivingTemplateTitle\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Checking if we need to update receiving template...`)\n if (templateNote) {\n const isProcessingTemplateSave = templateNote.frontmatterAttributes?.type === 'forms-processor'\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: isProcessingTemplateSave=${String(isProcessingTemplateSave)}`)\n if (!isProcessingTemplateSave) {\n // Backward compat: formProcessorTitle was legacy name for receivingTemplateTitle\n const receivingTemplateTitle =\n templateNote.frontmatterAttributes?.receivingTemplateTitle ||\n templateNote.frontmatterAttributes?.formProcessorTitle\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: receivingTemplateTitle=\"${receivingTemplateTitle || 'none'}\"`)\n if (receivingTemplateTitle) {\n // Strip double quotes before passing to updateReceivingTemplateWithFields\n const cleanedReceivingTemplateTitle = stripDoubleQuotes(receivingTemplateTitle)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: About to call updateReceivingTemplateWithFields for \"${cleanedReceivingTemplateTitle}\"`)\n try {\n // Await the update but don't let errors stop the save\n await updateReceivingTemplateWithFields(cleanedReceivingTemplateTitle, fieldsToSave, saveId)\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Successfully updated processing template \"${cleanedReceivingTemplateTitle}\"`)\n } catch (error) {\n // Log error but don't stop form saving\n logError(pluginJson, `[${saveId}] handleSaveRequest: Error updating receiving template: ${error.message || String(error)}`)\n }\n } else {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: No receivingTemplateTitle found, skipping update`)\n }\n } else {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: Skipping recursive update of receiving template for processing template \"${templateNote.title || ''}\"`)\n }\n } else {\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: No template note found, skipping receiving template update`)\n }\n\n logDebug(pluginJson, `[${saveId}] handleSaveRequest: EXIT - Save completed successfully`)\n return {\n success: true,\n message: `Form saved successfully to \"${templateTitle}\"`,\n data: { templateFilename: finalTemplateFilename, templateTitle },\n }\n } catch (error) {\n logError(pluginJson, `[${saveId}] handleSaveRequest: EXIT - ERROR: ${error.message || String(error)}`)\n logError(pluginJson, `[${saveId}] handleSaveRequest: Stack trace: ${error.stack || 'No stack trace'}`)\n return {\n success: false,\n message: `Error saving form: ${error.message || String(error)}`,\n data: null,\n }\n }\n}\n" }, { "path": "dwertheimer.Forms/src/formBuilderRouter.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Builder Router\n// Routes actions from FormBuilderView React component to appropriate handlers\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { handleRequest } from './requestHandlers' // For shared requests like getFolders, getNotes, getTeamspaces\nimport { handleSaveRequest, handleCreateProcessingTemplate, handleOpenNote, handleCopyFormUrl, handleDuplicateForm } from './formBuilderHandlers'\nimport { openFormBuilderWindow, FORMBUILDER_WINDOW_ID } from './windowManagement'\nimport { openTemplateForm } from './NPTemplateForm'\nimport { newCommsRouter, type RequestResponse } from '@helpers/react/routerUtils'\nimport { closeWindowFromCustomId } from '@helpers/NPWindows'\nimport { getNoteByFilename } from '@helpers/note'\nimport { loadCodeBlockFromNote } from '@helpers/codeBlocks'\nimport { parseObjectString } from '@helpers/stringTransforms'\nimport { logDebug, logError, logWarn } from '@helpers/dev'\n\n/**\n * Route request to appropriate handler based on action type\n * @param {string} actionType - The action/command type\n * @param {any} data - Request data\n * @returns {Promise}\n */\nasync function routeFormBuilderRequest(actionType: string, data: any): Promise {\n logDebug(pluginJson, `[routeFormBuilderRequest] Called with actionType=\"${actionType}\", data.type=\"${data?.type || 'none'}\"`)\n logDebug(pluginJson, `[routeFormBuilderRequest] data.fields type: ${Array.isArray(data?.fields) ? 'array' : typeof data?.fields}, length: ${data?.fields?.length || 0}`)\n if (data?.fields?.length > 0) {\n logDebug(pluginJson, `[routeFormBuilderRequest] First field type: ${typeof data.fields[0]}, is string: ${String(typeof data.fields[0] === 'string')}`)\n }\n\n // Handle save action as a special case (it's not a standard request)\n const actualActionType = data?.type\n logDebug(pluginJson, `[routeFormBuilderRequest] actualActionType=\"${actualActionType}\"`)\n if (actualActionType === 'save') {\n logDebug(pluginJson, `[routeFormBuilderRequest] Routing to handleSaveRequest with fields type: ${typeof data.fields}, isArray: ${String(Array.isArray(data.fields))}`)\n logDebug(pluginJson, `[routeFormBuilderRequest] About to call handleSaveRequest`)\n const result = await handleSaveRequest(data)\n logDebug(pluginJson, `[routeFormBuilderRequest] handleSaveRequest returned, success: ${String(result?.success ?? 'undefined')}`)\n return result\n }\n\n // Route to form builder specific handlers\n switch (actionType) {\n case 'createProcessingTemplate':\n return await handleCreateProcessingTemplate(data)\n case 'openNote':\n return await handleOpenNote(data)\n case 'copyFormUrl':\n return handleCopyFormUrl(data)\n case 'duplicateForm':\n return await handleDuplicateForm(data)\n default:\n // For shared requests (getFolders, getNotes, getTeamspaces, etc.), use the shared request handler\n return await handleRequest(actionType, data)\n }\n}\n\n/**\n * Handle non-REQUEST actions (legacy action-based pattern)\n * @param {string} actionType - The action type\n * @param {any} data - Request data\n * @returns {Promise}\n */\nasync function handleFormBuilderNonRequestAction(_actionType: string, data: any): Promise {\n // The data structure from React is: { type: 'save'|'cancel'|'openForm', fields: [...], templateFilename: ..., templateTitle: ... }\n // actionType will be \"onFormBuilderAction\" (the command name), and the actual action is in data.type\n const actualActionType = data?.type\n logDebug(pluginJson, `onFormBuilderAction: actualActionType=\"${actualActionType}\"`)\n logDebug(pluginJson, `onFormBuilderAction: data keys: ${Object.keys(data || {}).join(', ')}`)\n if (actualActionType === 'openForm') {\n logDebug(pluginJson, `onFormBuilderAction: openForm detected, data.templateTitle=\"${data?.templateTitle || 'MISSING'}\"`)\n }\n\n // Get window ID from data (passed from React), or fall back to default\n const windowId = data?.__windowId || FORMBUILDER_WINDOW_ID\n logDebug(pluginJson, `onFormBuilderAction: Using windowId=\"${windowId}\"`)\n\n if (actualActionType === 'cancel') {\n logDebug(pluginJson, `onFormBuilderAction: User cancelled, closing window`)\n closeWindowFromCustomId(windowId)\n } else if (actualActionType === 'openForm' && data?.templateTitle) {\n logDebug(pluginJson, `onFormBuilderAction: Opening form with templateTitle=\"${data.templateTitle}\"`)\n logDebug(pluginJson, `onFormBuilderAction: Calling openTemplateForm with templateTitle=\"${data.templateTitle}\"`)\n try {\n await openTemplateForm(data.templateTitle)\n logDebug(pluginJson, `onFormBuilderAction: openTemplateForm completed successfully`)\n } catch (error) {\n logError(pluginJson, `onFormBuilderAction: Error in openTemplateForm: ${error.message}`)\n logError(pluginJson, `onFormBuilderAction: Error stack: ${error.stack || 'No stack trace'}`)\n throw error\n }\n } else if (actualActionType === 'duplicateForm' && data?.newTemplateFilename) {\n // After duplicating, open the new form in Form Builder\n logDebug(pluginJson, `onFormBuilderAction: Opening duplicated form with filename=\"${data.newTemplateFilename}\"`)\n const newNote = await getNoteByFilename(data.newTemplateFilename)\n if (newNote) {\n const loadedFormFields = await loadCodeBlockFromNote>(newNote, 'formfields', pluginJson.id, parseObjectString)\n const formFields = loadedFormFields || []\n await openFormBuilderWindow({\n formFields,\n templateFilename: data.newTemplateFilename,\n templateTitle: data.newTemplateTitle || newNote.title || '',\n initialReceivingTemplateTitle: data.newReceivingTemplateTitle,\n })\n }\n } else {\n logWarn(pluginJson, `onFormBuilderAction: Unknown actualActionType=\"${actualActionType}\" or missing fields/data`)\n logWarn(pluginJson, `onFormBuilderAction: data.keys=${Object.keys(data || {}).join(', ')}`)\n }\n\n return {}\n}\n\n/**\n * Handle actions from FormBuilderView React component\n * Routes requests to appropriate handlers and sends responses back\n * @param {string} actionType - The action/command type\n * @param {any} data - Request data with optional __requestType, __correlationId, __windowId\n * @returns {Promise}\n */\nexport const onFormBuilderAction: (actionType: string, data: any) => Promise = newCommsRouter({\n routerName: 'onFormBuilderAction',\n defaultWindowId: FORMBUILDER_WINDOW_ID,\n routeRequest: routeFormBuilderRequest,\n handleNonRequestAction: handleFormBuilderNonRequestAction,\n pluginJson: pluginJson,\n useSharedHandlersFallback: true, // Forms uses shared handlers for choosers\n})\n" }, { "path": "dwertheimer.Forms/src/formSubmission.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Submission Handling - Processing form submissions and calling TemplateRunner\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { getRenderContext as getRenderContextLocal } from '../../np.Templating/src/Templating.js'\nimport { type PassedData } from './NPTemplateForm.js'\nimport { logError, logDebug, clo, JSP } from '@helpers/dev'\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Resolve shouldOpenInEditor: when the field is missing (undefined/null) or not explicitly false, return true.\n * Matches Form Builder UI where the checkbox defaults to \"on\" and is only written to frontmatter when unchecked.\n * @param {*} value - Raw value from frontmatter, pluginData, or payload\n * @returns {boolean} - true to open note in editor, false to leave it closed\n */\nexport function resolveShouldOpenInEditor(value: any): boolean {\n if (value === false || value === 'false') return false\n return true\n}\n\n/**\n * Check if a key is a valid JavaScript identifier\n * @param {string} key - The key to check\n * @returns {boolean} - True if the key is a valid JavaScript identifier\n */\nfunction isValidIdentifier(key: string): boolean {\n // JavaScript identifier: starts with letter/underscore/$ and contains only letters, digits, underscore, $\n return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key)\n}\n\n/**\n * Generate a key from label + random string for use in error messages\n * @param {string} label - The field label\n * @param {number} index - The field index\n * @returns {string} - A valid JavaScript identifier\n */\nfunction generateKeyFromLabel(label: string, index: number): string {\n // Sanitize label: remove special chars, replace spaces/hyphens with underscores, ensure starts with letter/underscore\n let sanitized = (label || 'templatejs-block')\n .replace(/[^a-zA-Z0-9\\s-_]/g, '') // Remove special chars except spaces, hyphens, underscores\n .replace(/[\\s-]+/g, '_') // Replace spaces and hyphens with underscores\n .replace(/_+/g, '_') // Replace multiple underscores with single underscore\n .substring(0, 30) // Limit length\n .toLowerCase()\n .trim()\n\n // Ensure it starts with a letter or underscore (valid JS identifier requirement)\n if (sanitized.length === 0 || !/^[a-zA-Z_]/.test(sanitized)) {\n sanitized = `block_${sanitized}`\n }\n\n // Generate random string (4 chars) for uniqueness\n const randomStr = Math.random().toString(36).substring(2, 6)\n return `${sanitized}_${randomStr}_${index + 1}`\n}\n\n/**\n * Deep sanitize an object to ensure no null or undefined values exist\n * Recursively converts null/undefined to empty strings\n * @param {any} obj - The object to sanitize\n * @returns {any} - Sanitized object with no null/undefined values\n */\nfunction deepSanitizeNulls(obj: any): any {\n // Handle null/undefined at the root\n if (obj === null || obj === undefined) {\n return ''\n }\n\n // Handle arrays - recursively sanitize each item\n if (Array.isArray(obj)) {\n return obj.map((item) => deepSanitizeNulls(item))\n }\n\n // Handle objects - but check for null first (typeof null === 'object' in JavaScript!)\n if (obj === null) {\n return ''\n }\n\n if (typeof obj === 'object' && !(obj instanceof Date)) {\n const sanitized: { [string]: any } = {}\n for (const key in obj) {\n if (obj.hasOwnProperty(key)) {\n const value = obj[key]\n // Convert null/undefined to empty string\n if (value === null || value === undefined) {\n sanitized[key] = ''\n } else {\n // Recursively sanitize nested structures\n sanitized[key] = deepSanitizeNulls(value)\n }\n }\n }\n return sanitized\n }\n\n // For primitives, Dates, etc., return as-is\n return obj\n}\n\n/**\n * Simplified form submission result - only contains what the window needs to know\n * @typedef {Object} FormSubmissionResult\n * @property {boolean} success - Whether the submission was successful\n * @property {string} [formSubmissionError] - Error message if submission failed\n * @property {string} [aiAnalysisResult] - AI analysis result if template error was detected\n */\nexport type FormSubmissionResult = {\n success: boolean,\n formSubmissionError?: string,\n aiAnalysisResult?: string,\n}\n\n/**\n * Resolve a single conditional-values output from source value and conditions.\n * First match wins. Used only at form submission; conditional-values are not rendered in the dialog.\n *\n * @param {string} sourceVal - Raw value from the watched field\n * @param {Array<{ matchTerm: string, value: string }>} conds - matchTerm/value pairs\n * @param {'regex'|'string'} mode - Match mode\n * @param {boolean} caseSens - Case-sensitive matching\n * @param {boolean} trim - Trim source before matching\n * @param {string} [defaultVal] - Value when no condition matches\n * @returns {string} Resolved value\n */\nfunction resolveConditionalValue(\n sourceVal: string,\n conds: Array<{ matchTerm: string, value: string }>,\n mode: 'regex' | 'string',\n caseSens: boolean,\n trim: boolean,\n defaultVal?: string,\n): string {\n const toMatch = trim ? (typeof sourceVal === 'string' ? sourceVal : String(sourceVal ?? '')).trim() : String(sourceVal ?? '')\n if (!Array.isArray(conds) || conds.length === 0) {\n return defaultVal ?? ''\n }\n for (let i = 0; i < conds.length; i++) {\n const c = conds[i]\n const term = c?.matchTerm ?? ''\n const outVal = c?.value ?? ''\n if (mode === 'regex') {\n try {\n const flags = caseSens ? 'u' : 'iu'\n const re = new RegExp(term, flags)\n if (re.test(toMatch)) {\n return outVal\n }\n } catch (e) {\n logError(pluginJson, `resolveConditionalValue: invalid regex matchTerm \"${term}\": ${(e: any).message}`)\n continue\n }\n } else {\n const eq = caseSens ? toMatch === term : toMatch.toLowerCase() === term.toLowerCase()\n if (eq) {\n return outVal\n }\n }\n }\n return defaultVal ?? ''\n}\n\n/**\n * Resolve conditional-values fields from current form values. Conditional-values are only for\n * final form submission processing; they are not rendered in the dialog.\n *\n * @param {Object} formValues - Current form values (source fields must already be present)\n * @param {Array} formFields - Form fields array\n * @returns {Object} formValues with conditional-values keys set to resolved values\n */\nfunction resolveConditionalValuesFields(formValues: Object, formFields: Array): Object {\n if (!formFields || formFields.length === 0) {\n return formValues\n }\n const out = { ...formValues }\n formFields.forEach((field) => {\n if (field.type !== 'conditional-values' || !field.key) {\n return\n }\n const sourceFieldKey = field.sourceFieldKey || ''\n const sourceValue = sourceFieldKey ? String(out[sourceFieldKey] ?? '') : ''\n const rawConditions = Array.isArray(field.conditions) ? field.conditions : []\n const conditions = rawConditions.filter((c) => (c?.matchTerm ?? '').trim() !== '')\n const matchMode = field.matchMode === 'regex' ? 'regex' : 'string'\n const caseSensitive = field.caseSensitive ?? false\n const trimSourceBeforeMatch = field.trimSourceBeforeMatch !== false\n const defaultWhenNoMatch = field.defaultWhenNoMatch\n const resolved = resolveConditionalValue(sourceValue, conditions, matchMode, caseSensitive, trimSourceBeforeMatch, defaultWhenNoMatch)\n out[field.key] = resolved\n })\n return out\n}\n\n/**\n * Ensure all form fields exist in formValues, adding missing ones with empty string values\n * @param {Object} formValues - The form values object\n * @param {Array} formFields - The form fields array\n * @returns {Object} - Form values with all fields guaranteed to exist\n */\nfunction ensureAllFormFieldsExist(formValues: Object, formFields: Array): Object {\n if (!formFields || formFields.length === 0) {\n return formValues\n }\n\n const ensured = { ...formValues }\n const missingFields: Array = []\n\n formFields.forEach((field) => {\n // Conditional-values are resolved only at submit via resolveConditionalValuesFields; do not add them here\n // Templatejs-block keys are output-only (computed by the block at submit); do not add to formValues passed to getRenderContext\n if (field.type === 'conditional-values' || field.type === 'templatejs-block' || !field.key) return\n // Check if key exists (even if value is undefined/null/empty string)\n if (!(field.key in ensured)) {\n missingFields.push(field.key)\n // Add missing field with empty value (or default if available)\n ensured[field.key] = field.default ?? field.value ?? ''\n } else if (ensured[field.key] === undefined || ensured[field.key] === null) {\n // Field exists but is undefined/null - ensure it's at least an empty string\n missingFields.push(`${field.key} (was undefined/null)`)\n ensured[field.key] = field.default ?? field.value ?? ''\n }\n })\n\n if (missingFields.length > 0) {\n logDebug(`ensureAllFormFieldsExist: Added/fixed ${missingFields.length} missing field(s): ${missingFields.join(', ')}`)\n }\n\n return ensured\n}\n\n/**\n * Prepare form values for rendering by removing internal flags and ensuring all fields exist\n * @param {Object} formValues - The raw form values\n * @param {Array} formFields - The form fields array (optional, for validation)\n * @returns {Object} - Cleaned form values with all fields guaranteed\n */\nfunction prepareFormValuesForRendering(formValues: Object, formFields?: Array): Object {\n // Resolve conditional-values from current form values (only at submission; not rendered in dialog)\n const withConditionalsResolved = formFields ? resolveConditionalValuesFields(formValues, formFields) : formValues\n // Then ensure all fields exist if formFields is provided\n const withAllFields = formFields ? ensureAllFormFieldsExist(withConditionalsResolved, formFields) : withConditionalsResolved\n\n // Create cleaned object - use explicit iteration to avoid any spread issues\n const cleaned: { [string]: any } = {}\n Object.keys(withAllFields).forEach((key) => {\n if (key !== '__isJSON__') {\n // Ensure value is never undefined or null - convert to empty string\n const value = withAllFields[key]\n cleaned[key] = value === undefined || value === null ? '' : value\n }\n })\n\n return cleaned\n}\n\n/**\n * Get the full templating context with form values merged in\n * Uses local import of np.Templating.getRenderContext to preserve prototype chains and methods.\n * @param {Object} formValues - The form values to merge into context\n * @returns {Promise} - The full templating context\n */\nasync function getTemplatingContext(formValues: Object): Promise {\n const sanitizedFormValues = deepSanitizeNulls(formValues || {})\n const templatingContext = await getRenderContextLocal(sanitizedFormValues)\n // IMPORTANT: Do NOT deepSanitizeNulls() the returned templatingContext.\n // It contains class instances (e.g. DateModule) and sanitizing would traverse/alter them.\n return templatingContext\n}\n\n/**\n * Extract templatejs blocks from form fields\n * @param {Array} formFields - The form fields array\n * @param {string} executeTiming - Filter by execute timing ('before' or 'after')\n * @returns {Array<{field: Object, code: string, order: number}>} - Array of templatejs blocks\n */\nfunction extractTemplateJSBlocks(formFields: Array, executeTiming?: string): Array<{ field: Object, code: string, order: number }> {\n const blocks: Array<{ field: Object, code: string, order: number }> = []\n logDebug(`extractTemplateJSBlocks: Checking ${formFields?.length || 0} formFields for templatejs-block (executeTiming=\"${executeTiming || 'any'}\")`)\n formFields.forEach((field, index) => {\n const fieldType = field?.type || '(no-type)'\n const hasContent = !!field?.templateJSContent\n const fieldExecuteTiming = field?.executeTiming || 'after'\n if (fieldType === 'templatejs-block') {\n logDebug(\n `extractTemplateJSBlocks: Found templatejs-block at index ${index}, key=\"${field?.key || '(no-key)'}\", label=\"${field?.label || '(no-label)'}\", hasContent=${String(\n hasContent,\n )}, executeTiming=\"${fieldExecuteTiming}\"`,\n )\n }\n if (field.type === 'templatejs-block' && field.templateJSContent) {\n const rawCode = String(field.templateJSContent).trim()\n // Sanitize the code when extracting (replace smart quotes, etc.)\n const code = sanitizeTemplateJSCode(rawCode)\n if (code) {\n if (!executeTiming || fieldExecuteTiming === executeTiming) {\n blocks.push({ field, code, order: index })\n logDebug(\n `extractTemplateJSBlocks: Added block at index ${index}, key=\"${field?.key || '(no-key)'}\", executeTiming=\"${fieldExecuteTiming}\" matches filter=\"${\n executeTiming || 'any'\n }\"`,\n )\n } else {\n logDebug(`extractTemplateJSBlocks: Skipped block at index ${index} (executeTiming=\"${fieldExecuteTiming}\" !== filter=\"${executeTiming}\")`)\n }\n } else {\n logDebug(`extractTemplateJSBlocks: Skipped block at index ${index} (code empty after sanitize)`)\n }\n }\n })\n // Sort by order (top to bottom)\n blocks.sort((a, b) => a.order - b.order)\n logDebug(`extractTemplateJSBlocks: Returning ${blocks.length} block(s)`)\n return blocks\n}\n\n/**\n * Replace smart quotes (curly quotes) with straight quotes — inlined to avoid calling into np.Templating\n * during templatejs-block execution, which can cause bridge/recursion freeze when Forms invokes getRenderContext.\n * @param {string} text - The text to process\n * @returns {string} - Text with smart quotes replaced\n */\nfunction replaceSmartQuotesLocal(text: string): string {\n if (!text || typeof text !== 'string') return text\n return text\n .replace(/\\u201C/g, '\"')\n .replace(/\\u201D/g, '\"')\n .replace(/\\u2018/g, \"'\")\n .replace(/\\u2019/g, \"'\")\n .replace(/\"/g, '\"')\n .replace(/\"/g, '\"')\n .replace(/'/g, \"'\")\n .replace(/'/g, \"'\")\n}\n\n/**\n * Sanitize templateJS code before execution\n * - Replaces smart quotes with straight quotes (uses local impl to avoid np.Templating call during block run)\n * @param {string} code - The raw templateJS code\n * @returns {string} - The sanitized code\n */\nfunction sanitizeTemplateJSCode(code: string): string {\n if (!code || typeof code !== 'string') {\n return code || ''\n }\n let sanitized = replaceSmartQuotesLocal(code)\n if (typeof sanitized !== 'string') sanitized = String(sanitized)\n return sanitized\n}\n\n\n/**\n * Execute a single templatejs block with the given context\n * @param {Object} field - The field object\n * @param {string} code - The JavaScript code to execute\n * @param {Object} context - The execution context\n * @param {number} blockIndex - The index of this block (for error messages)\n * @param {PassedData} _reactWindowData - Unused; errors are returned via __blockError (no direct writes)\n * @returns {Object|null} - The returned object from the block, or { __blockError } on error\n */\nfunction executeTemplateJSBlock(field: Object, code: string, context: Object, blockIndex: number, _reactWindowData: PassedData): Object | null {\n const fieldIdentifier = field.key || generateKeyFromLabel(field.label || '', blockIndex)\n try {\n // Sanitize the code before execution (replace smart quotes, etc.)\n const sanitizedCode = sanitizeTemplateJSCode(code)\n if (sanitizedCode !== code) {\n logDebug(`executeTemplateJSBlock: Code was sanitized (smart quotes replaced)`)\n }\n\n // CRITICAL: Use the original context directly from np.Templating to preserve prototype chains and methods.\n // Shallow copying breaks objects like `date` that have methods on their prototype (e.g., date.now()).\n // We'll enumerate keys for variable declarations, but pass the original context object to the function.\n const contextKeys: string[] = []\n for (const key in context) {\n // $FlowFixMe[method-unbinding] - safe use for own-property check\n if (!Object.prototype.hasOwnProperty.call(context, key)) continue\n contextKeys.push(key)\n }\n // Use the original context directly - don't create a copy\n const contextToUse = context\n\n // Build context variables - only create variables for valid JavaScript identifiers\n const contextVars = contextKeys\n .map((key) => {\n if (isValidIdentifier(key)) {\n return `const ${key} = params.${key};`\n }\n // For invalid identifiers, don't create a variable - user can access via params['key-name']\n return `// Key \"${key}\" is not a valid JavaScript identifier - access via params['${key}']`\n })\n .join('\\n')\n\n const functionBody = `\n ${contextVars}\n // Execute user's code\n // All templating functions are available: moment, date, note, tasks, etc.\n ${sanitizedCode}\n `\n\n // $FlowIgnore[prop-missing] - Function constructor is safe here as code comes from form definition\n const fn = Function.apply(null, ['params', functionBody])\n \n // Execute the function with the original context to preserve prototype chains and methods\n let result\n try {\n result = fn(contextToUse)\n } catch (fnError) {\n const msg = fnError instanceof Error ? fnError.message : String(fnError)\n const stack = fnError instanceof Error ? fnError.stack : ''\n logError(pluginJson, `executeTemplateJSBlock: TemplateJS function threw: ${msg}\\nstack: ${stack || '(no stack)'}`)\n throw new Error(`TemplateJS block \"${fieldIdentifier}\" threw when called with context: ${msg}`)\n }\n\n // Validate that the code returned an object\n if (result && typeof result === 'object' && !Array.isArray(result)) {\n const resultKeys = Object.keys(result)\n \n // Create a plain object copy of result to avoid proxy/getter issues\n const plainResult: { [string]: any } = {}\n for (const key of resultKeys) {\n plainResult[key] = result[key]\n }\n\n // NotePlan's Promise is not a constructor (can't use new Promise()).\n // Just return plainResult directly - the async function will wrap it automatically.\n return plainResult\n } else if (result !== undefined) {\n const errorMessage = `TemplateJS block \"${fieldIdentifier}\" should return an object, but returned ${typeof result}. Please update your code to return an object (e.g., return { key: value }).`\n logError(pluginJson, `executeTemplateJSBlock: ${errorMessage}`)\n return { __blockError: errorMessage }\n } else {\n const errorMessage = `TemplateJS block \"${fieldIdentifier}\" did not return anything. Please update your code to return an object (e.g., return { key: value }).`\n logError(pluginJson, `executeTemplateJSBlock: ${errorMessage}`)\n return { __blockError: errorMessage }\n }\n } catch (error) {\n const errorMessage = `Error executing TemplateJS block \"${fieldIdentifier}\": ${error.message}`\n logError(pluginJson, `executeTemplateJSBlock: ${errorMessage}`)\n return { __blockError: errorMessage }\n }\n}\n\n/**\n * Execute all templatejs blocks in order and merge their results into context\n * @param {Array<{field: Object, code: string, order: number}>} blocks - The templatejs blocks to execute\n * @param {Object} initialContext - The initial execution context\n * @param {PassedData} reactWindowData - The React window data to store errors in\n * @returns {Promise} - The merged context, or null on error (errors are stored in reactWindowData.pluginData.formSubmissionError)\n */\nasync function executeTemplateJSBlocks(blocks: Array<{ field: Object, code: string, order: number }>, initialContext: Object, reactWindowData: PassedData): Promise {\n // Templatejs-block keys must not be in the scope passed to the block (output-only).\n const templatejsBlockKeys = new Set(blocks.map((b) => b.field?.key).filter(Boolean))\n // CRITICAL: Use the original context directly from np.Templating to preserve prototype chains and methods.\n // Shallow copying breaks objects like `date` that have methods on their prototype.\n // We'll filter out templatejs-block keys when building the contextKeys list for variable declarations,\n // but pass the original context object directly to the function.\n \n // Build a filtered context object that excludes templatejs-block keys (for variable declarations)\n // But we'll still pass the original context to the function to preserve methods\n let context: { [string]: any } = {}\n try {\n // Use for...in to get all enumerable properties (not just own)\n for (const k in initialContext) {\n // $FlowFixMe[method-unbinding] - safe use for own-property check\n if (!Object.prototype.hasOwnProperty.call(initialContext, k)) continue\n if (!templatejsBlockKeys.has(k)) {\n // Still build context object for key enumeration, but we'll use original context when calling fn\n context[k] = (initialContext: any)[k]\n }\n }\n } catch (e) {\n logError(pluginJson, `executeTemplateJSBlocks: failed to enumerate initialContext keys: ${e instanceof Error ? e.message : String(e)}`)\n return null\n }\n \n // Use the original context directly (not the filtered copy) to preserve prototype chains\n // But we'll merge results back into the filtered context object for subsequent blocks\n const contextToUse = initialContext\n\n for (let blockIndex = 0; blockIndex < blocks.length; blockIndex++) {\n const { field, code } = blocks[blockIndex]\n // Pass the original contextToUse (initialContext) to preserve prototype chains and methods\n // The filtered context is only used for key enumeration, not execution\n const result = executeTemplateJSBlock(field, code, contextToUse, blockIndex, reactWindowData)\n\n if (result === null) {\n return null\n }\n if (result && typeof result === 'object' && (result: any).__blockError) {\n return result\n }\n\n // CRITICAL: Avoid spread operator on result - it might contain proxies that freeze\n // Build a plain object copy instead\n const plainResult: { [string]: any } = {}\n if (result && typeof result === 'object') {\n const resultKeys = Object.keys(result)\n for (const key of resultKeys) {\n plainResult[key] = result[key]\n }\n }\n context = { ...context, ...plainResult }\n }\n\n return context\n}\n\n/**\n * Handle template runner result - check for AI analysis and formSubmissionError.\n * Returns simplified result with only what the window needs to know.\n * @param {any} templateRunnerResult - The result from templateRunner\n * @param {Array} formFields - Form fields array (for error messages)\n * @returns {FormSubmissionResult} Simplified result with success/error info\n */\nfunction handleTemplateRunnerResult(templateRunnerResult: any, formFields: Array): FormSubmissionResult {\n logDebug(\n pluginJson,\n `handleTemplateRunnerResult: templateRunner result type=${typeof templateRunnerResult}, length=${templateRunnerResult?.length || 0}, includes AI marker=${String(\n templateRunnerResult?.includes?.('==**Templating Error Found**') || false,\n )}`,\n )\n\n // Check if result contains AI analysis (error message from template rendering)\n if (templateRunnerResult && typeof templateRunnerResult === 'string' && templateRunnerResult.includes('==**Templating Error Found**')) {\n logDebug(`handleTemplateRunnerResult: AI analysis result detected, returning result with aiAnalysisResult`)\n return {\n success: false,\n aiAnalysisResult: templateRunnerResult,\n }\n }\n if (templateRunnerResult === null || (typeof templateRunnerResult === 'string' && templateRunnerResult.trim() === '')) {\n // Template runner returned null or empty string - this indicates an error occurred\n // NOTE: undefined is NOT an error - when templateRunner successfully creates a note via templateNew,\n // it returns undefined (see NPTemplateRunner.js line 874). This is a valid success case.\n logError(pluginJson, `handleTemplateRunnerResult: Template runner returned null or empty string - this indicates an error occurred during template execution`)\n const formFieldKeys = formFields.filter((f) => f.key).map((f) => f.key)\n\n let errorMessage = 'Template execution failed. The error \"null is not an object\" typically means the templating plugin encountered a null value when processing the form data.'\n if (formFieldKeys.length > 0) {\n errorMessage += ` All form fields were sent: ${formFieldKeys.join(', ')}.`\n }\n errorMessage += ' This error occurs when the templating plugin tries to process a null value in the data object.'\n errorMessage += ' The form data has been sanitized to remove nulls, but the templating plugin may have created null values during frontmatter processing.'\n errorMessage += ' Please check the NotePlan Plugin Console logs for the detailed error message from the Templating plugin.'\n return {\n success: false,\n formSubmissionError: errorMessage,\n }\n }\n // Success case: undefined (note created), string (rendered content), or other valid result\n logDebug(\n pluginJson,\n `handleTemplateRunnerResult: Template execution completed successfully. Result type: ${typeof templateRunnerResult}, value: ${\n templateRunnerResult === undefined ? 'undefined (note created)' : String(templateRunnerResult).substring(0, 100)\n }`,\n )\n return { success: true }\n}\n\n// ============================================================================\n// Processing Method Handlers\n// ============================================================================\n\n/**\n * Process form submission using form-processor method\n * @param {Object} data - The submission data\n * @param {Array} formFields - Form fields array\n * @returns {Promise} - Simplified result with success/error info\n */\nasync function processFormProcessor(data: any, formFields: Array): Promise {\n const { receivingTemplateTitle, formValues, shouldOpenInEditor } = data\n\n if (!receivingTemplateTitle) {\n const errorMessage = 'No Processing Template was Provided; You should set a processing template in your form settings.'\n logError(pluginJson, `processFormProcessor: ${errorMessage}`)\n return { success: false, formSubmissionError: errorMessage }\n }\n logDebug(`processFormProcessor: Starting with ${Object.keys(formValues || {}).length} formValues keys, ${formFields.length} formFields`)\n\n // Step 1: Prepare form values and get templating context\n const formValuesForRendering = prepareFormValuesForRendering(formValues, formFields)\n logDebug(\n pluginJson,\n `processFormProcessor: After prepareFormValuesForRendering, have ${Object.keys(formValuesForRendering).length} keys: ${Object.keys(formValuesForRendering).join(', ')}`,\n )\n\n // Validate that all form fields are present\n if (formFields && formFields.length > 0) {\n const missingFields: Array = []\n formFields.forEach((field) => {\n if (field.key && !(field.key in formValuesForRendering)) {\n missingFields.push(field.key)\n }\n })\n if (missingFields.length > 0) {\n logError(pluginJson, `processFormProcessor: CRITICAL - Missing fields after prepareFormValuesForRendering: ${missingFields.join(', ')}`)\n } else {\n logDebug(`processFormProcessor: All ${formFields.length} form fields are present in formValuesForRendering`)\n }\n }\n\n const templatingContext = await getTemplatingContext(formValuesForRendering)\n\n // Step 2: Extract and execute templatejs blocks\n // Note: We use the full templating context for execution so templatejs blocks have access to moment, date, etc.\n\n const templateJSBlocks = extractTemplateJSBlocks(formFields, 'after')\n\n // Create minimal PassedData object for executeTemplateJSBlocks (it doesn't actually use most properties)\n const minimalWindowData: PassedData = {\n pluginData: { formFields },\n componentPath: '',\n debug: false,\n logProfilingMessage: false,\n returnPluginCommand: { id: pluginJson['plugin.id'], command: 'onFormSubmitFromHTMLView' },\n }\n const fullContext = await executeTemplateJSBlocks(templateJSBlocks, templatingContext, minimalWindowData)\n if (fullContext === null) {\n return { success: false, formSubmissionError: 'Failed to prepare template context.' }\n }\n if (fullContext && typeof fullContext === 'object' && (fullContext: any).__blockError) {\n return { success: false, formSubmissionError: (fullContext: any).__blockError }\n }\n\n // Step 3: Extract only form-specific variables (form values + templatejs block results)\n // Don't pass templating context (modules, globals) to templateRunner - it will add those itself\n // Track which keys are templating context keys (these should be excluded)\n const templatingContextKeys = new Set(Object.keys(templatingContext))\n\n // Build a clean object with only form-specific variables\n // CRITICAL: Always include ALL form values first, even if they conflict with templating context\n // Form values take precedence and must be present (even if empty strings) to prevent template errors\n const formSpecificVars: { [string]: any } = {}\n\n // First, include ALL original form values (these take precedence and must be present)\n Object.keys(formValuesForRendering).forEach((key) => {\n formSpecificVars[key] = formValuesForRendering[key]\n })\n\n // Then, include templatejs block results (but don't override form values)\n Object.keys(fullContext).forEach((key) => {\n // Only include keys that are NOT in the templating context (i.e., templatejs block results)\n // AND that are not already in formSpecificVars (form values take precedence)\n if (!templatingContextKeys.has(key) && !(key in formSpecificVars)) {\n formSpecificVars[key] = fullContext[key]\n }\n })\n\n // Step 4: Deep sanitize formSpecificVars to ensure no null/undefined values exist anywhere\n // This prevents errors in the templating plugin when it tries to process the data\n const sanitizedFormSpecificVars = deepSanitizeNulls(formSpecificVars)\n logDebug(`processFormProcessor: After deep sanitization, sanitizedFormSpecificVars has ${Object.keys(sanitizedFormSpecificVars).length} keys`)\n\n // Step 5: Call templateRunner with form-specific variables\n const argumentsToSend = [receivingTemplateTitle, shouldOpenInEditor, sanitizedFormSpecificVars]\n const templateRunnerResult = await DataStore.invokePluginCommandByName('templateRunner', 'np.Templating', argumentsToSend)\n\n // Step 7: Handle result\n return handleTemplateRunnerResult(templateRunnerResult, formFields)\n}\n\n/**\n * Process form submission using write-existing method\n * @param {Object} data - The submission data\n * @param {Array} formFields - Form fields array\n * @returns {Promise} - Simplified result with success/error info\n */\nasync function processWriteExisting(data: any, formFields: Array): Promise {\n const { getNoteTitled, location, writeUnderHeading, createMissingHeading, formValues, shouldOpenInEditor } = data\n\n if (!getNoteTitled) {\n const errorMessage = 'No target note was specified. Please set a target note in your form settings.'\n logError(pluginJson, `processWriteExisting: ${errorMessage}`)\n return { success: false, formSubmissionError: errorMessage }\n }\n\n // Step 1: Prepare form values and get templating context\n // CRITICAL: Pass formFields to ensure all fields exist\n const formValuesForRendering = prepareFormValuesForRendering(formValues, formFields)\n const templatingContext = await getTemplatingContext(formValuesForRendering)\n\n // Step 2: Extract and execute templatejs blocks\n const templateJSBlocks = extractTemplateJSBlocks(formFields, 'after')\n\n // Create minimal PassedData object for executeTemplateJSBlocks (it doesn't actually use most properties)\n const minimalWindowData: PassedData = {\n pluginData: { formFields },\n componentPath: '',\n debug: false,\n logProfilingMessage: false,\n returnPluginCommand: { id: pluginJson['plugin.id'], command: 'onFormSubmitFromHTMLView' },\n }\n const fullContext = await executeTemplateJSBlocks(templateJSBlocks, templatingContext, minimalWindowData)\n if (fullContext === null) {\n return { success: false, formSubmissionError: 'Failed to prepare template context.' }\n }\n if (fullContext && typeof fullContext === 'object' && (fullContext: any).__blockError) {\n return { success: false, formSubmissionError: (fullContext: any).__blockError }\n }\n\n // Step 3: Extract only form-specific variables (form values + templatejs block results)\n // Don't pass templating context (modules, globals) to templateRunner - it will add those itself\n const templatingContextKeys = new Set(Object.keys(templatingContext))\n\n // Build a clean object with only form-specific variables\n // CRITICAL: Always include ALL form values first, even if they conflict with templating context\n // Form values take precedence and must be present (even if empty strings) to prevent template errors\n const formSpecificVars: { [string]: any } = {}\n\n // First, include ALL original form values (these take precedence and must be present)\n Object.keys(formValuesForRendering).forEach((key) => {\n formSpecificVars[key] = formValuesForRendering[key]\n })\n\n // Then, include templatejs block results (but don't override form values)\n Object.keys(fullContext).forEach((key) => {\n // Only include keys that are NOT in the templating context (i.e., templatejs block results)\n // AND that are not already in formSpecificVars (form values take precedence)\n if (!templatingContextKeys.has(key) && !(key in formSpecificVars)) {\n formSpecificVars[key] = fullContext[key]\n }\n })\n\n // Step 4: Build template body (DO NOT insert templatejs blocks - they're already executed)\n const templateBody = data?.templateBody || ''\n const finalTemplateBody = templateBody || ''\n\n // Step 5: Build templateRunner args with form-specific variables\n const templateRunnerArgs: { [string]: any } = {\n getNoteTitled,\n templateBody: finalTemplateBody,\n }\n // Add form-specific variables (spread after explicit keys to avoid Flow error)\n Object.keys(formSpecificVars).forEach((key) => {\n templateRunnerArgs[key] = formSpecificVars[key]\n })\n\n // Step 4: Handle location options\n if (location === 'replace') {\n templateRunnerArgs.replaceNoteContents = true\n } else if (location === 'prepend-under-heading') {\n templateRunnerArgs.location = 'prepend'\n if (writeUnderHeading) {\n templateRunnerArgs.writeUnderHeading = writeUnderHeading\n if (createMissingHeading !== undefined) {\n templateRunnerArgs.createMissingHeading = createMissingHeading\n }\n }\n } else if (location === 'append-under-heading') {\n templateRunnerArgs.location = 'append'\n if (writeUnderHeading) {\n templateRunnerArgs.writeUnderHeading = writeUnderHeading\n if (createMissingHeading !== undefined) {\n templateRunnerArgs.createMissingHeading = createMissingHeading\n }\n }\n } else {\n // For other location values (append, prepend, cursor, insert)\n if (location) {\n templateRunnerArgs.location = location\n }\n if (writeUnderHeading) {\n templateRunnerArgs.writeUnderHeading = writeUnderHeading\n if (createMissingHeading !== undefined) {\n templateRunnerArgs.createMissingHeading = createMissingHeading\n }\n }\n }\n\n // Step 5: Call templateRunner\n clo(templateRunnerArgs, `processWriteExisting: Calling templateRunner with args`)\n const templateRunnerResult = await DataStore.invokePluginCommandByName('templateRunner', 'np.Templating', ['', shouldOpenInEditor, templateRunnerArgs])\n return handleTemplateRunnerResult(templateRunnerResult, formFields)\n}\n\n/**\n * Process form submission using run-js-only method\n * @param {Object} data - The submission data\n * @param {Array} formFields - Form fields array\n * @returns {Promise} - Simplified result with success/error info\n */\nasync function processRunJSOnly(data: any, formFields: Array): Promise {\n const { formValues } = data\n\n logDebug(`processRunJSOnly: formFields.length=${formFields.length}`)\n\n // Step 1: Prepare form values and get templating context\n // CRITICAL: Pass formFields to ensure all fields exist\n const formValuesForRendering = prepareFormValuesForRendering(formValues, formFields)\n const templatingContext = await getTemplatingContext(formValuesForRendering)\n\n // Step 2: Extract and execute templatejs blocks\n const templateJSBlocks = extractTemplateJSBlocks(formFields, 'after')\n\n if (templateJSBlocks.length === 0) {\n const errorMessage = 'No TemplateJS block found in form fields. Please add a TemplateJS Block field to your form with the JavaScript code to execute.'\n logError(pluginJson, `processRunJSOnly: ${errorMessage}`)\n return { success: false, formSubmissionError: errorMessage }\n }\n\n logDebug(`processRunJSOnly: Found ${templateJSBlocks.length} templatejs blocks to execute`)\n\n // Create minimal PassedData object for executeTemplateJSBlocks (it doesn't actually use most properties)\n const minimalWindowData: PassedData = {\n pluginData: { formFields },\n componentPath: '',\n debug: false,\n logProfilingMessage: false,\n returnPluginCommand: { id: pluginJson['plugin.id'], command: 'onFormSubmitFromHTMLView' },\n }\n const fullContext = await executeTemplateJSBlocks(templateJSBlocks, templatingContext, minimalWindowData)\n if (fullContext === null) {\n return { success: false, formSubmissionError: 'Failed to prepare template context.' }\n }\n if (fullContext && typeof fullContext === 'object' && (fullContext: any).__blockError) {\n return { success: false, formSubmissionError: (fullContext: any).__blockError }\n }\n\n // Step 3: Extract only form-specific variables (form values + templatejs block results)\n // Don't pass templating context (modules, globals) - we just want the results\n const templatingContextKeys = new Set(Object.keys(templatingContext))\n\n // Build a clean object with only form-specific variables (the results)\n // CRITICAL: Always include ALL form values first, even if they conflict with templating context\n // Form values take precedence and must be present (even if empty strings) to prevent template errors\n const results: { [string]: any } = {}\n\n // First, include ALL original form values (these take precedence and must be present)\n Object.keys(formValuesForRendering).forEach((key) => {\n results[key] = formValuesForRendering[key]\n })\n\n // Then, include templatejs block results (but don't override form values)\n Object.keys(fullContext).forEach((key) => {\n // Only include keys that are NOT in the templating context (i.e., templatejs block results)\n // AND that are not already in results (form values take precedence)\n if (!templatingContextKeys.has(key) && !(key in results)) {\n results[key] = fullContext[key]\n }\n })\n\n // Step 4: Show results to user (or store in reactWindowData for display)\n const resultsString = Object.keys(results)\n .map((key) => `${key}: ${JSON.stringify(results[key])}`)\n .join('\\n')\n\n logDebug(`processRunJSOnly: JavaScript executed successfully. Results: ${resultsString}`)\n // Success - results are logged to console\n return { success: true }\n}\n\n/**\n * Parse frontmatter from a string (extracts key: value pairs between -- or --- markers)\n * @param {string} content - The content string to parse\n * @returns {Object} - Parsed frontmatter attributes\n */\nfunction parseFrontmatterFromString(content: string): { [string]: string } {\n const attributes: { [string]: string } = {}\n if (!content || typeof content !== 'string') {\n return attributes\n }\n\n // Match frontmatter between -- or --- markers (can be at start or anywhere)\n // Try --- first (standard YAML frontmatter), then -- (NotePlan style)\n // The closing marker may or may not be followed by a newline\n let frontmatterMatch = content.match(/^---\\s*\\n([\\s\\S]*?)\\n---(?:\\s*\\n|$)/)\n if (!frontmatterMatch) {\n frontmatterMatch = content.match(/^--\\s*\\n([\\s\\S]*?)\\n--(?:\\s*\\n|$)/)\n }\n if (!frontmatterMatch) {\n logDebug(`parseFrontmatterFromString: No frontmatter markers found in content (length=${content.length}, first 100 chars: \"${content.substring(0, 100)}\")`)\n return attributes\n }\n\n const frontmatterContent = frontmatterMatch[1]\n const lines = frontmatterContent.split('\\n')\n\n for (const line of lines) {\n const trimmedLine = line.trim()\n if (!trimmedLine || trimmedLine.startsWith('#')) {\n continue // Skip empty lines and comments\n }\n\n // Match key: value pattern\n const match = trimmedLine.match(/^([^:]+):\\s*(.*)$/)\n if (match) {\n const key = match[1].trim()\n let value = match[2].trim()\n // Remove quotes if present\n if ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n value = value.slice(1, -1)\n }\n attributes[key] = value\n logDebug(`parseFrontmatterFromString: Extracted ${key}=\"${value.substring(0, 50)}${value.length > 50 ? '...' : ''}\"`)\n }\n }\n\n logDebug(`parseFrontmatterFromString: Parsed ${Object.keys(attributes).length} attributes: ${Object.keys(attributes).join(', ')}`)\n return attributes\n}\n\n/**\n * Process form submission using create-new method\n * @param {Object} data - The submission data\n * @param {Array} formFields - Form fields array\n * @returns {Promise} - Simplified result with success/error info\n */\nasync function processCreateNew(data: any, formFields: Array): Promise {\n const { newNoteTitle, newNoteFolder, space, formValues, shouldOpenInEditor } = data\n\n // Step 1: Get newNoteTitle from multiple sources (data, or template body frontmatter)\n let newNoteTitleToUse = newNoteTitle || ''\n\n // If still empty, try to parse from template body frontmatter\n if (!newNoteTitleToUse || !newNoteTitleToUse.trim()) {\n const templateBody = data?.templateBody || ''\n if (templateBody) {\n const templateFrontmatter = parseFrontmatterFromString(templateBody)\n if (templateFrontmatter.newNoteTitle) {\n newNoteTitleToUse = templateFrontmatter.newNoteTitle\n logDebug(`processCreateNew: Extracted newNoteTitle from template body frontmatter: \"${newNoteTitleToUse}\"`)\n }\n }\n }\n\n // Also check for folder in template body frontmatter if not provided\n let newNoteFolderToUse = newNoteFolder || ''\n if (!newNoteFolderToUse || !newNoteFolderToUse.trim()) {\n const templateBody = data?.templateBody || ''\n if (templateBody) {\n const templateFrontmatter = parseFrontmatterFromString(templateBody)\n if (templateFrontmatter.folder) {\n newNoteFolderToUse = templateFrontmatter.folder\n logDebug(`processCreateNew: Extracted folder from template body frontmatter: \"${newNoteFolderToUse}\"`)\n }\n }\n }\n // Step 2: Prepare form values and get templating context (needed to render template tags)\n // CRITICAL: Pass formFields to ensure all fields exist\n const formValuesForRendering = prepareFormValuesForRendering(formValues, formFields)\n const templatingContext = await getTemplatingContext(formValuesForRendering)\n\n // Step 3: Render newNoteTitle template tags if present\n let renderedNewNoteTitle = newNoteTitleToUse\n if (newNoteTitleToUse && typeof newNoteTitleToUse === 'string' && (newNoteTitleToUse.includes('<%') || newNoteTitleToUse.includes('${'))) {\n try {\n // Use templating plugin to render the title (it contains template tags like <%- Contact_Name %>)\n const renderedTitleResult = await DataStore.invokePluginCommandByName('render', 'np.Templating', [newNoteTitleToUse, templatingContext])\n if (renderedTitleResult && typeof renderedTitleResult === 'string') {\n renderedNewNoteTitle = renderedTitleResult\n logDebug(`processCreateNew: Rendered newNoteTitle from \"${newNoteTitleToUse}\" to \"${renderedNewNoteTitle}\"`)\n } else {\n logError(pluginJson, `processCreateNew: Invalid result from render for newNoteTitle: ${typeof renderedTitleResult}`)\n }\n } catch (error) {\n logError(pluginJson, `processCreateNew: Error rendering newNoteTitle template: ${error.message}`)\n // Continue with original value - might just be plain text\n }\n }\n\n // Step 4: Validate and clean rendered new note title\n const cleanedNewNoteTitle = renderedNewNoteTitle ? String(renderedNewNoteTitle).replace(/\\n/g, ' ').trim() : ''\n if (!cleanedNewNoteTitle) {\n logError(pluginJson, 'processCreateNew: No new note title was specified. Please set a new note title in your form settings.')\n return {\n success: false,\n formSubmissionError: 'No new note title was specified. Please set a new note title in your form settings.',\n }\n }\n\n // Step 5: Extract and execute templatejs blocks\n const templateJSBlocks = extractTemplateJSBlocks(formFields, 'after')\n // Create minimal PassedData object for executeTemplateJSBlocks (it doesn't actually use most properties)\n const minimalWindowData: PassedData = {\n pluginData: { formFields },\n componentPath: '',\n debug: false,\n logProfilingMessage: false,\n returnPluginCommand: { id: pluginJson['plugin.id'], command: 'onFormSubmitFromHTMLView' },\n }\n const fullContext = await executeTemplateJSBlocks(templateJSBlocks, templatingContext, minimalWindowData)\n if (fullContext === null) {\n return { success: false, formSubmissionError: 'Failed to prepare template context.' }\n }\n if (fullContext && typeof fullContext === 'object' && (fullContext: any).__blockError) {\n return { success: false, formSubmissionError: (fullContext: any).__blockError }\n }\n\n // Step 6: Extract only form-specific variables (form values + templatejs block results)\n // Don't pass templating context (modules, globals) to templateRunner - it will add those itself\n const templatingContextKeys = new Set(Object.keys(templatingContext))\n\n // Build a clean object with only form-specific variables\n // CRITICAL: Always include ALL form values first, even if they conflict with templating context\n // Form values take precedence and must be present (even if empty strings) to prevent template errors\n const formSpecificVars: { [string]: any } = {}\n\n // First, include ALL original form values (these take precedence and must be present)\n Object.keys(formValuesForRendering).forEach((key) => {\n formSpecificVars[key] = formValuesForRendering[key]\n })\n\n // Then, include templatejs block results (but don't override form values)\n Object.keys(fullContext).forEach((key) => {\n // Only include keys that are NOT in the templating context (i.e., templatejs block results)\n // AND that are not already in formSpecificVars (form values take precedence)\n if (!templatingContextKeys.has(key) && !(key in formSpecificVars)) {\n formSpecificVars[key] = fullContext[key]\n }\n })\n\n // Step 7: Build template body (DO NOT insert templatejs blocks - they're already executed)\n // Get new note frontmatter and body content (templateBody)\n let newNoteFrontmatter = data?.newNoteFrontmatter || ''\n const templateBody = data?.templateBody || ''\n\n // Ensure title is preserved: if frontmatter exists, check if it has a title field\n // If not, and body doesn't start with \"# <%- newNoteTitle %>\", add title to frontmatter\n if (newNoteFrontmatter && newNoteFrontmatter.trim()) {\n // Parse frontmatter to check for title field\n const frontmatterLines = newNoteFrontmatter.trim().split('\\n')\n let hasTitleField = false\n\n for (const line of frontmatterLines) {\n const trimmedLine = line.trim()\n // Check if line matches \"title:\" (case-insensitive, with optional whitespace)\n if (trimmedLine.match(/^title\\s*:/i)) {\n hasTitleField = true\n break\n }\n }\n\n // If no title field exists, check body content\n if (!hasTitleField) {\n const bodyFirstLine = templateBody.trim().split('\\n')[0] || ''\n const hasTitleHeading = bodyFirstLine.trim() === '# <%- newNoteTitle %>'\n\n // If body doesn't have the title heading, add title to frontmatter\n if (!hasTitleHeading) {\n // Use the original newNoteTitle template tag if it contains template syntax,\n // otherwise use the newNoteTitle variable (which will be available in template context)\n const originalNewNoteTitle = newNoteTitleToUse || data?.newNoteTitle || ''\n\n // If newNoteTitle contains template tags, use them directly; otherwise reference newNoteTitle variable\n let titleTemplateTag = '<%- newNoteTitle %>'\n if (originalNewNoteTitle && typeof originalNewNoteTitle === 'string' && originalNewNoteTitle.includes('<%')) {\n // Use the original template tag (e.g., \"<%- Contact_Name %>\")\n titleTemplateTag = originalNewNoteTitle\n }\n\n // Add title field to the top of frontmatter\n newNoteFrontmatter = `title: ${titleTemplateTag}\\n${newNoteFrontmatter.trim()}`\n logDebug(`processCreateNew: Added title field to frontmatter to preserve title from being overwritten: title: ${titleTemplateTag}`)\n }\n }\n }\n\n let finalTemplateBody = ''\n\n // If we have frontmatter, combine it with templateBody using -- delimiters\n if (newNoteFrontmatter && newNoteFrontmatter.trim()) {\n const parts = ['--', newNoteFrontmatter.trim(), '--']\n if (templateBody && templateBody.trim()) {\n parts.push(templateBody.trim())\n }\n finalTemplateBody = parts.join('\\n')\n logDebug(`processCreateNew: Combined newNoteFrontmatter and templateBody with -- delimiters`)\n } else {\n // No frontmatter, just use templateBody as-is (empty string if not provided)\n finalTemplateBody = templateBody || ''\n }\n\n // Step 8: Build templateRunner args with form-specific variables\n const templateRunnerArgs: { [string]: any } = {\n newNoteTitle: cleanedNewNoteTitle,\n templateBody: finalTemplateBody,\n }\n // Add form-specific variables (spread after explicit keys to avoid Flow error)\n Object.keys(formSpecificVars).forEach((key) => {\n templateRunnerArgs[key] = formSpecificVars[key]\n })\n\n // Step 9: Handle folder path and teamspace (use extracted folder if available)\n // If form has a field named \"folder\", it overrides the form definition (see ProcessingMethodSection)\n const formFolderRaw = formSpecificVars['folder']\n const formFolder = formFolderRaw != null && String(formFolderRaw).trim() !== '' ? String(formFolderRaw).trim() : ''\n let folderSource = newNoteFolderToUse && newNoteFolderToUse.trim() ? newNoteFolderToUse.trim() : ''\n if (formFolder !== '') {\n folderSource = formFolder\n logDebug(`processCreateNew: Using form field \"folder\" override: \"${folderSource}\"`)\n }\n let folderPath = folderSource || '/'\n\n // Render folder template tags if present\n if (folderPath && typeof folderPath === 'string' && (folderPath.includes('<%') || folderPath.includes('${'))) {\n try {\n const renderedFolderResult = await DataStore.invokePluginCommandByName('render', 'np.Templating', [folderPath, templatingContext])\n if (renderedFolderResult && typeof renderedFolderResult === 'string') {\n folderPath = renderedFolderResult\n logDebug(`processCreateNew: Rendered folder to \"${folderPath}\"`)\n } else {\n logError(pluginJson, `processCreateNew: Invalid result from render for folder: ${typeof renderedFolderResult}`)\n }\n } catch (error) {\n logError(pluginJson, `processCreateNew: Error rendering folder template: ${error.message}`)\n // Continue with original value\n }\n }\n if (space && space.trim() && !folderPath.startsWith('%%NotePlanCloud%%')) {\n if (folderPath === '/' || folderPath === '') {\n folderPath = `%%NotePlanCloud%%/${space}/`\n } else {\n const cleanFolder = folderPath.startsWith('/') ? folderPath.slice(1) : folderPath\n folderPath = `%%NotePlanCloud%%/${space}/${cleanFolder}`\n }\n logDebug(`processCreateNew: Prefixed folder with teamspace: ${folderPath}`)\n }\n templateRunnerArgs.folder = folderPath\n\n // Step 10: Call templateRunner\n clo(templateRunnerArgs, `processCreateNew: Calling templateRunner with args`)\n const templateRunnerResult = await DataStore.invokePluginCommandByName('templateRunner', 'np.Templating', ['', shouldOpenInEditor, templateRunnerArgs])\n return handleTemplateRunnerResult(templateRunnerResult, formFields)\n}\n\n/**\n * Insert TemplateJS blocks into templateBody based on executeTiming\n * @param {string} templateBody - The base template body\n * @param {Array} formFields - The form fields array\n * @returns {string} - The template body with TemplateJS blocks inserted\n */\nexport function insertTemplateJSBlocks(templateBody: string, formFields: Array): string {\n if (!Array.isArray(formFields) || formFields.length === 0) {\n return templateBody\n }\n\n const beforeBlocks: Array = []\n const afterBlocks: Array = []\n\n // Extract TemplateJS blocks from form fields\n formFields.forEach((field) => {\n if (field.type === 'templatejs-block' && field.templateJSContent && field.key) {\n const rawCode = String(field.templateJSContent).trim()\n // Sanitize the code (replace smart quotes, etc.)\n const code = sanitizeTemplateJSCode(rawCode)\n if (code) {\n // Format as templatejs code block (no extra whitespace)\n const codeBlock = `\\`\\`\\`templatejs\\n${code}\\n\\`\\`\\``\n const executeTiming = field.executeTiming || 'after'\n if (executeTiming === 'before') {\n beforeBlocks.push(codeBlock)\n } else {\n afterBlocks.push(codeBlock)\n }\n }\n }\n })\n\n // Build final templateBody: before blocks + original + after blocks\n const parts: Array = []\n if (beforeBlocks.length > 0) {\n parts.push(beforeBlocks.join('\\n'))\n }\n if (templateBody.trim()) {\n parts.push(templateBody)\n }\n if (afterBlocks.length > 0) {\n parts.push(afterBlocks.join('\\n'))\n }\n\n return parts.join('\\n')\n}\n\n/**\n * When someone clicks a \"Submit\" button in the React Window, it calls the router (onMessageFromHTMLView)\n * which sees the actionType === \"onSubmitClick\" so it routes to this function for processing\n * @param {any} data - the data sent from the React Window for the action 'onSubmitClick'\n * @param {Array} formFields - Form fields array (required for validation and templatejs block execution)\n * @returns {Promise} - Simplified result with success/error info\n */\nexport async function handleSubmitButtonClick(data: any, formFields: Array): Promise {\n const { type, formValues, processingMethod, receivingTemplateTitle } = data\n const method = processingMethod || (receivingTemplateTitle ? 'form-processor' : 'write-existing')\n clo(data, `handleSubmitButtonClick: data BEFORE acting on it`)\n\n // Validate submission type\n if (type !== 'submit') {\n logDebug(`handleSubmitButtonClick: type is not 'submit', returning success`)\n return { success: true }\n }\n\n if (!formValues) {\n logError(pluginJson, `handleSubmitButtonClick: formValues is undefined`)\n return {\n success: false,\n formSubmissionError: 'Form values are missing. Please try submitting again.',\n }\n }\n\n // Validate that all form fields are present in formValues (even if empty)\n // Conditional-values are resolved in prepareFormValuesForRendering; do not add them here\n // Templatejs-block keys are output-only (computed by the block at submit); do not add to formValues or jsContext\n const formFieldsArray = Array.isArray(formFields) ? formFields : []\n if (formFieldsArray.length > 0) {\n const missingFields: Array = []\n formFieldsArray.forEach((field) => {\n if (field.type === 'conditional-values' || field.type === 'templatejs-block') return\n if (field.key && !(field.key in formValues)) {\n missingFields.push(field.key)\n // Add missing field with empty value\n formValues[field.key] = field.default ?? field.value ?? ''\n }\n })\n if (missingFields.length > 0) {\n logDebug(`handleSubmitButtonClick: Added ${missingFields.length} missing field(s) to formValues: ${missingFields.join(', ')}`)\n }\n }\n\n // Mark form values as JSON for templating plugin\n formValues['__isJSON__'] = true\n // Default true when field missing (form template has no shouldOpenInEditor in frontmatter = open in editor)\n const shouldOpenInEditor = resolveShouldOpenInEditor(data.shouldOpenInEditor)\n\n // Add shouldOpenInEditor to data for processing functions\n data.shouldOpenInEditor = shouldOpenInEditor\n\n // Route to appropriate processing method\n let result: FormSubmissionResult\n if (method === 'form-processor') {\n result = await processFormProcessor(data, formFieldsArray)\n } else if (method === 'create-new') {\n result = await processCreateNew(data, formFieldsArray)\n } else if (method === 'write-existing') {\n result = await processWriteExisting(data, formFieldsArray)\n } else if (method === 'run-js-only') {\n result = await processRunJSOnly(data, formFieldsArray)\n } else {\n const errorMessage = `Unknown processing method: ${method}`\n logError(pluginJson, `handleSubmitButtonClick: ${errorMessage}`)\n return { success: false, formSubmissionError: errorMessage }\n }\n\n logDebug(\n pluginJson,\n `handleSubmitButtonClick: Returning result, success=${String(result.success)}, has aiAnalysisResult=${String(!!result.aiAnalysisResult)}, aiAnalysisResult length=${\n result.aiAnalysisResult?.length || 0\n }`,\n )\n return result\n}\n" }, { "path": "dwertheimer.Forms/src/formSubmitHandlers.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Submit Request Handlers\n// Handlers for requests from FormView component (form submission)\n// REQUEST/RESPONSE path does not read or write reactWindowData; form is loaded by filename.\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { getGlobalSharedData, sendToHTMLWindow, sendBannerMessage } from '../../helpers/HTMLView'\nimport { handleSubmitButtonClick, resolveShouldOpenInEditor } from './formSubmission'\nimport { loadTemplateBodyFromTemplate, loadNewNoteFrontmatterFromTemplate, loadTemplateRunnerArgsFromTemplate } from './templateIO'\nimport { WEBVIEW_WINDOW_ID, getFormWindowId, findFormWindowId } from './windowManagement'\nimport { closeWindowFromCustomId } from '@helpers/NPWindows'\nimport { loadCodeBlockFromNote } from '@helpers/codeBlocks'\nimport { getNoteByFilename } from '@helpers/note'\nimport { parseObjectString, stripDoubleQuotes } from '@helpers/stringTransforms'\nimport { logDebug, logError, clo } from '@helpers/dev'\n\n// RequestResponse type definition (shared with other handler files)\nexport type RequestResponse = {\n success: boolean,\n message?: string,\n data?: any,\n}\n\n/**\n * Get window ID for form submission, with fallback strategies\n * @param {Object} data - Request data with optional windowId\n * @returns {Promise} - The window ID to use\n */\nexport async function getFormWindowIdForSubmission(data: any): Promise {\n // Window ID lookup: __windowId (from REQUEST bridge), then windowId from data, then fallback strategies\n let windowId = data?.__windowId || data?.windowId || ''\n\n // If windowId was provided in data, use it directly\n if (windowId) {\n try {\n await getGlobalSharedData(windowId)\n logDebug(pluginJson, `getFormWindowIdForSubmission: Using windowId from data: ${windowId}`)\n return windowId\n } catch (e) {\n logDebug(pluginJson, `getFormWindowIdForSubmission: Could not get window data with provided windowId: ${windowId}, falling back to search`)\n windowId = '' // Reset to trigger fallback\n }\n }\n\n // Fallback strategies if windowId not provided or lookup failed\n if (!windowId) {\n // Strategy 1: Try to find window by looking at all open windows (most reliable for dynamic IDs)\n windowId = findFormWindowId() || WEBVIEW_WINDOW_ID\n\n // Strategy 2: Try to get window data using the found/fallback window ID\n try {\n const reactWindowData = await getGlobalSharedData(windowId)\n // If we got window data, use the windowId from it if available (most reliable)\n if (reactWindowData?.pluginData?.windowId) {\n windowId = reactWindowData.pluginData.windowId\n // Re-fetch with the correct window ID if different\n if (windowId !== WEBVIEW_WINDOW_ID) {\n try {\n await getGlobalSharedData(windowId)\n } catch (e) {\n logDebug(pluginJson, `getFormWindowIdForSubmission: Could not re-fetch with corrected windowId: ${windowId}`)\n }\n }\n } else if (reactWindowData?.pluginData?.formTitle) {\n // Reconstruct window ID from form title if we have it\n const reconstructedId = getFormWindowId(reactWindowData.pluginData.formTitle)\n if (reconstructedId !== windowId) {\n windowId = reconstructedId\n try {\n await getGlobalSharedData(windowId)\n } catch (e) {\n logDebug(pluginJson, `getFormWindowIdForSubmission: Could not fetch with reconstructed windowId: ${windowId}`)\n }\n }\n }\n } catch (e) {\n // Strategy 3: Fallback - try base WEBVIEW_WINDOW_ID for backward compatibility\n if (windowId !== WEBVIEW_WINDOW_ID) {\n try {\n const tempWindowData = await getGlobalSharedData(WEBVIEW_WINDOW_ID)\n if (tempWindowData?.pluginData?.windowId) {\n windowId = tempWindowData.pluginData.windowId\n await getGlobalSharedData(windowId)\n } else if (tempWindowData) {\n // Use base ID window data if available\n windowId = WEBVIEW_WINDOW_ID\n }\n } catch (e2) {\n logDebug(pluginJson, `getFormWindowIdForSubmission: Could not get window data with base ID either`)\n }\n }\n }\n }\n\n return windowId\n}\n\n/**\n * Load form definition and template content from the form file (by filename).\n * Used by REQUEST/RESPONSE submit so we do not read reactWindowData.\n * @param {string} formTemplateFilename - Filename of the form template note\n * @returns {Promise<{ formFields: Array, templateBody: string, newNoteTitle: string, newNoteFolder: string, newNoteFrontmatter: string, shouldOpenInEditor: boolean } | null>}\n */\nexport async function loadFormContextFromFilename(\n formTemplateFilename: string,\n): Promise<{\n formFields: Array,\n templateBody: string,\n newNoteTitle: string,\n newNoteFolder: string,\n newNoteFrontmatter: string,\n shouldOpenInEditor: boolean,\n} | null> {\n if (!formTemplateFilename || !formTemplateFilename.trim()) {\n return null\n }\n try {\n const templateNote = await getNoteByFilename(formTemplateFilename)\n if (!templateNote) {\n logError(pluginJson, `loadFormContextFromFilename: Template not found: ${formTemplateFilename}`)\n return null\n }\n const fm = templateNote.frontmatterAttributes || {}\n let formFields: Array = []\n try {\n const loaded = await loadCodeBlockFromNote>(formTemplateFilename, 'formfields', pluginJson.id, parseObjectString)\n if (loaded && Array.isArray(loaded)) {\n formFields = loaded\n }\n } catch (e) {\n logError(pluginJson, `loadFormContextFromFilename: Error loading formFields: ${e instanceof Error ? e.message : String(e)}`)\n }\n const templateBody = (await loadTemplateBodyFromTemplate(formTemplateFilename)) || ''\n const newNoteFrontmatter = (await loadNewNoteFrontmatterFromTemplate(formTemplateFilename)) || ''\n \n // Load templateRunnerArgs from codeblock (these override frontmatter values)\n const templateRunnerArgs = await loadTemplateRunnerArgsFromTemplate(formTemplateFilename)\n \n // Get newNoteTitle: prefer templateRunnerArgs, then frontmatter\n let newNoteTitle = ''\n if (templateRunnerArgs?.newNoteTitle) {\n newNoteTitle = stripDoubleQuotes(String(templateRunnerArgs.newNoteTitle)) || ''\n } else {\n newNoteTitle = stripDoubleQuotes(fm?.newNoteTitle || '') || ''\n }\n \n // Get newNoteFolder: prefer templateRunnerArgs, then frontmatter\n let newNoteFolder = ''\n if (templateRunnerArgs?.newNoteFolder) {\n newNoteFolder = stripDoubleQuotes(String(templateRunnerArgs.newNoteFolder)) || ''\n } else {\n newNoteFolder = stripDoubleQuotes(fm?.newNoteFolder || '') || ''\n }\n \n // Default true when field missing (no shouldOpenInEditor in frontmatter = open in editor, matches Form Builder UI)\n const shouldOpenInEditor = resolveShouldOpenInEditor(fm?.shouldOpenInEditor)\n logDebug(pluginJson, `loadFormContextFromFilename: Loaded from \"${formTemplateFilename}\": newNoteTitle=\"${newNoteTitle}\", newNoteFolder=\"${newNoteFolder}\", templateBody length=${templateBody.length}, templateRunnerArgs=${templateRunnerArgs ? 'loaded' : 'none'}, shouldOpenInEditor=${String(shouldOpenInEditor)}`)\n return {\n formFields,\n templateBody,\n newNoteTitle,\n newNoteFolder,\n newNoteFrontmatter,\n shouldOpenInEditor,\n }\n } catch (error) {\n logError(pluginJson, `loadFormContextFromFilename: Error: ${error instanceof Error ? error.message : String(error)}`)\n return null\n }\n}\n\n/**\n * Execute form submission as a REQUEST (no SET_DATA, no close).\n * Used when front-end calls requestFromPlugin('submitForm', payload).\n * Does not read or write reactWindowData: requires formTemplateFilename and loads the form from the file.\n * Returns { success, data: { formSubmissionError?, aiAnalysisResult? }, message } so the form can display errors before closing.\n *\n * @param {Object} data - Request payload (formValues, formTemplateFilename, processingMethod, etc.)\n * @returns {Promise}\n */\nexport async function submitFormRequest(data: any): Promise {\n logDebug(pluginJson, `submitFormRequest: Called (REQUEST path - no reactWindowData), formTemplateFilename=\"${data?.formTemplateFilename || 'NOT SET'}\"`)\n try {\n const formTemplateFilename = data?.formTemplateFilename || ''\n if (!formTemplateFilename || !formTemplateFilename.trim()) {\n logError(pluginJson, `submitFormRequest: formTemplateFilename is required; form must submit the filename of the form that was filled out.`)\n return {\n success: false,\n message: 'Form template filename is required. The form must submit the filename of the form that was filled out.',\n data: { formSubmissionError: 'Form template filename is required.' },\n }\n }\n logDebug(pluginJson, `submitFormRequest: Loading form from file \"${formTemplateFilename}\"`)\n const formContext = await loadFormContextFromFilename(formTemplateFilename)\n if (!formContext) {\n return {\n success: false,\n message: `Could not load form from \"${formTemplateFilename}\". Template not found or invalid.`,\n data: { formSubmissionError: `Could not load form from \"${formTemplateFilename}\".` },\n }\n }\n // Merge loaded form context (templateBody, newNoteFrontmatter, etc.) into data so processCreateNew can access it\n // processCreateNew reads from data.templateBody, not reactWindowData.pluginData.templateBody\n // Use payload first, then form definition; default true when missing (matches Form Builder UI)\n const shouldOpenInEditor =\n data.shouldOpenInEditor !== undefined\n ? resolveShouldOpenInEditor(data.shouldOpenInEditor)\n : resolveShouldOpenInEditor(formContext.shouldOpenInEditor)\n const dataWithFormContext = {\n ...data,\n templateBody: data.templateBody || formContext.templateBody || '',\n newNoteFrontmatter: data.newNoteFrontmatter || formContext.newNoteFrontmatter || '',\n newNoteTitle: data.newNoteTitle || formContext.newNoteTitle || '',\n newNoteFolder: data.newNoteFolder || formContext.newNoteFolder || '',\n shouldOpenInEditor,\n }\n logDebug(pluginJson, `submitFormRequest: [DIAG] calling handleSubmitButtonClick with loaded form (no reactWindowData)`)\n const result = await handleSubmitButtonClick(dataWithFormContext, formContext.formFields || [])\n logDebug(\n pluginJson,\n `submitFormRequest: handleSubmitButtonClick done, success=${String(result.success)}, hasFormSubmissionError=${String(!!result.formSubmissionError)}`,\n )\n return {\n success: result.success,\n data: {\n formSubmissionError: result.formSubmissionError,\n aiAnalysisResult: result.aiAnalysisResult,\n },\n message: result.success ? 'Form submitted' : (result.formSubmissionError || 'Form submission failed'),\n }\n } catch (error) {\n logError(pluginJson, `submitFormRequest: Error: ${error.message}`)\n return {\n success: false,\n message: `Form submission error: ${error.message}`,\n data: { formSubmissionError: error.message || 'Form submission failed' },\n }\n }\n}\n\n/**\n * Handle form submission action (onSubmitClick)\n * @param {Object} data - Request data\n * @param {Object} reactWindowData - Window data from React\n * @param {string} windowId - Window ID (already determined by router)\n * @returns {Promise}\n */\n// Track recent SET_DATA sends to prevent loops (key: windowId, value: last send time)\nconst recentSetDataSends = new Map()\n\n/**\n * Clean up old entries from recentSetDataSends (older than 5 seconds)\n * This is called proactively when we interact with the Map, avoiding the need for setTimeout\n */\nfunction cleanupOldSetDataSends(): void {\n const now = Date.now()\n const maxAge = 5000 // 5 seconds\n for (const [windowId, timestamp] of recentSetDataSends.entries()) {\n if (now - timestamp > maxAge) {\n recentSetDataSends.delete(windowId)\n }\n }\n}\n\nexport async function handleFormSubmitAction(data: any, reactWindowData: any, windowId: string): Promise {\n logDebug(pluginJson, `[BACK-END] handleFormSubmitAction: Called from front-end (onSubmitClick), windowId=\"${windowId}\"`)\n try {\n if (!reactWindowData) {\n logError(pluginJson, `handleFormSubmitAction: reactWindowData is required`)\n return {\n success: false,\n message: `reactWindowData is required`,\n data: null,\n }\n }\n \n // GUARD: Prevent sending SET_DATA too frequently (within 100ms) to same window\n // Clean up old entries first (proactive cleanup, no setTimeout needed)\n cleanupOldSetDataSends()\n const lastSendTime = recentSetDataSends.get(windowId) || 0\n const timeSinceLastSend = Date.now() - lastSendTime\n if (timeSinceLastSend < 100) {\n logDebug(pluginJson, `[BACK-END] GUARD: handleFormSubmitAction: SET_DATA sent recently (${timeSinceLastSend}ms ago), skipping to prevent loop`)\n // Still return success but don't send SET_DATA\n return {\n success: true,\n message: 'Form submission throttled to prevent loop',\n data: reactWindowData, // Return existing data\n }\n }\n\n // Merge passThroughVars if provided\n if (data.passThroughVars && reactWindowData.passThroughVars) {\n reactWindowData.passThroughVars = { ...reactWindowData.passThroughVars, ...data.passThroughVars }\n } else if (data.passThroughVars) {\n reactWindowData.passThroughVars = { ...data.passThroughVars }\n }\n\n // Use payload first; when missing, use form definition (pluginData). Default true when missing (matches Form Builder UI)\n if (data.shouldOpenInEditor === undefined) {\n data.shouldOpenInEditor = resolveShouldOpenInEditor(reactWindowData?.pluginData?.shouldOpenInEditor)\n logDebug(pluginJson, `handleFormSubmitAction: shouldOpenInEditor from pluginData: ${String(data.shouldOpenInEditor)}`)\n }\n\n // Payload does not include templateBody/newNoteFrontmatter; processCreateNew needs them from the form definition\n if (data.templateBody === undefined || data.templateBody === '') {\n const fromPlugin = reactWindowData?.pluginData?.templateBody\n if (fromPlugin != null && String(fromPlugin).trim() !== '') {\n data.templateBody = String(fromPlugin)\n logDebug(pluginJson, `handleFormSubmitAction: templateBody from pluginData (length=${data.templateBody.length})`)\n }\n }\n if (data.newNoteFrontmatter === undefined && reactWindowData?.pluginData?.newNoteFrontmatter != null) {\n data.newNoteFrontmatter = reactWindowData.pluginData.newNoteFrontmatter\n logDebug(pluginJson, `handleFormSubmitAction: newNoteFrontmatter from pluginData`)\n }\n\n logDebug(pluginJson, `[BACK-END] handleFormSubmitAction: Calling handleSubmitButtonClick...`)\n const formFields = reactWindowData?.pluginData?.formFields || []\n const result = await handleSubmitButtonClick(data, formFields)\n logDebug(pluginJson, `[BACK-END] handleFormSubmitAction: handleSubmitButtonClick returned, success=${String(result.success)}`)\n\n // Check if there's an AI analysis result (error message from template rendering)\n const hasAiAnalysis =\n result.aiAnalysisResult &&\n typeof result.aiAnalysisResult === 'string' &&\n result.aiAnalysisResult.includes('==**Templating Error Found**')\n \n // Check if there's a form submission error\n const hasFormSubmissionError =\n result.formSubmissionError &&\n typeof result.formSubmissionError === 'string' &&\n result.formSubmissionError.trim() !== ''\n logDebug(\n pluginJson,\n `handleFormSubmitAction: success=${String(result.success)}, hasAiAnalysis=${String(hasAiAnalysis)}, hasFormSubmissionError=${String(hasFormSubmissionError)}, keepOpenOnSubmit=${String(data.keepOpenOnSubmit)}`,\n )\n\n // Update window data with error/aiAnalysisResult if present\n // Only send SET_DATA if there's an error or AI analysis result to display\n if (hasAiAnalysis || hasFormSubmissionError) {\n // $FlowFixMe[exponential-spread] - Building object step by step to avoid Flow exponential spread issue\n const updatedPluginData: any = {}\n const basePluginData = reactWindowData.pluginData || {}\n Object.keys(basePluginData).forEach((key) => {\n updatedPluginData[key] = basePluginData[key]\n })\n if (hasAiAnalysis && result.aiAnalysisResult) {\n updatedPluginData.aiAnalysisResult = result.aiAnalysisResult\n }\n if (hasFormSubmissionError && result.formSubmissionError) {\n updatedPluginData.formSubmissionError = result.formSubmissionError\n }\n const updatedWindowData = {\n ...reactWindowData,\n pluginData: updatedPluginData,\n }\n const updateText = hasAiAnalysis\n ? 'AI Analysis Error Detected'\n : 'Form Submission Error Detected'\n logDebug(\n pluginJson,\n `[BACK-END] handleFormSubmitAction: Sending SET_DATA to windowId=\"${windowId}\", has aiAnalysisResult=${String(hasAiAnalysis)}, has formSubmissionError=${String(hasFormSubmissionError)}`,\n )\n sendToHTMLWindow(windowId, 'SET_DATA', updatedWindowData, updateText)\n // Track that we sent SET_DATA to prevent rapid resends\n recentSetDataSends.set(windowId, Date.now())\n // Clean up old entries proactively (no setTimeout needed - cleanup happens on next check/add)\n cleanupOldSetDataSends()\n logDebug(pluginJson, `[BACK-END] handleFormSubmitAction: SET_DATA sent to windowId=\"${windowId}\"`)\n }\n\n // Close the window after successful submission, unless:\n // 1. keepOpenOnSubmit is true (e.g., for Form Browser context)\n // 2. There's an AI analysis result (keep window open to show the error)\n // 3. There's a form submission error (keep window open to show the error)\n if (result.success && !data.keepOpenOnSubmit && !hasAiAnalysis && !hasFormSubmissionError) {\n logDebug(pluginJson, `handleFormSubmitAction: Closing window windowId=\"${windowId}\" (success, no keepOpenOnSubmit, no errors)`)\n closeWindowFromCustomId(windowId)\n } else if (result.success && (data.keepOpenOnSubmit || hasAiAnalysis || hasFormSubmissionError)) {\n logDebug(\n pluginJson,\n `handleFormSubmitAction: NOT closing window - keepOpenOnSubmit=${String(data.keepOpenOnSubmit)} or hasAiAnalysis=${String(hasAiAnalysis)} or hasFormSubmissionError=${String(hasFormSubmissionError)}`,\n )\n } else if (!result.success) {\n logDebug(pluginJson, `handleFormSubmitAction: Not closing window - submission failed`)\n }\n\n return {\n success: result.success,\n message: result.success ? 'Form submitted successfully' : (result.formSubmissionError || 'Form submission failed'),\n data: {\n formSubmissionError: result.formSubmissionError,\n aiAnalysisResult: result.aiAnalysisResult,\n },\n }\n } catch (error) {\n logError(pluginJson, `handleFormSubmitAction: Error: ${error.message}`)\n return {\n success: false,\n message: `Error submitting form: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Handle unknown action type\n * @param {string} actionType - The unknown action type\n * @param {Object} data - Request data\n * @param {string} windowId - Window ID\n * @returns {Promise}\n */\nexport async function handleUnknownAction(actionType: string, data: any, windowId: string): Promise {\n await sendBannerMessage(windowId, `Plugin received an unknown actionType: \"${actionType}\" command with data:\\n${JSON.stringify(data)}`, 'ERROR')\n return {\n success: false,\n message: `Unknown actionType: \"${actionType}\"`,\n data: null,\n }\n}\n" }, { "path": "dwertheimer.Forms/src/formSubmitRouter.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Form Submit Router\n// Routes actions from FormView React component (form submission)\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { getGlobalSharedData } from '../../helpers/HTMLView'\nimport { handleRequest } from './requestHandlers' // For shared requests like getFolders, getNotes, getTeamspaces\nimport { handleFormSubmitAction, handleUnknownAction, getFormWindowIdForSubmission } from './formSubmitHandlers'\nimport { WEBVIEW_WINDOW_ID, getFormWindowId, findFormWindowId } from './windowManagement'\nimport { handleRequestResponse, newCommsRouter, type RequestResponse } from '@helpers/react/routerUtils'\nimport { logDebug, logError, clo, JSP } from '@helpers/dev'\n\n/**\n * Get window ID for form submission (complex lookup with fallbacks)\n * @param {any} data - Request data\n * @returns {Promise} - Window ID\n */\nasync function getFormSubmitWindowId(data: any): Promise {\n // Get window ID - prioritize windowId from request (most reliable), then try lookup\n let windowId = data?.__windowId || null\n logDebug(pluginJson, `getFormSubmitWindowId: windowId from request: \"${windowId || 'NOT PROVIDED'}\"`)\n\n // If windowId was provided in request, use it directly (most reliable)\n if (windowId) {\n logDebug(pluginJson, `getFormSubmitWindowId: Using windowId from request: \"${windowId}\"`)\n return windowId\n }\n\n // Fallback: try to find it from open windows or window data\n // For form entry windows, use findFormWindowId() first\n windowId = findFormWindowId() || WEBVIEW_WINDOW_ID\n logDebug(pluginJson, `getFormSubmitWindowId: Fallback - Initial windowId from findFormWindowId: \"${windowId}\"`)\n try {\n // Try to get window data with the found ID\n const tempWindowData = await getGlobalSharedData(windowId)\n logDebug(\n pluginJson,\n `getFormSubmitWindowId: Got window data for \"${windowId}\", has pluginData.windowId=${String(!!tempWindowData?.pluginData?.windowId)}, has formTitle=${String(\n !!tempWindowData?.pluginData?.formTitle,\n )}`,\n )\n if (tempWindowData?.pluginData?.windowId) {\n windowId = tempWindowData.pluginData.windowId\n logDebug(pluginJson, `getFormSubmitWindowId: Updated windowId from pluginData.windowId: \"${windowId}\"`)\n } else if (tempWindowData?.pluginData?.formTitle) {\n windowId = getFormWindowId(tempWindowData.pluginData.formTitle)\n logDebug(pluginJson, `getFormSubmitWindowId: Updated windowId from formTitle \"${tempWindowData.pluginData.formTitle}\": \"${windowId}\"`)\n }\n } catch (e) {\n logDebug(pluginJson, `getFormSubmitWindowId: Error getting window data for \"${windowId}\": ${e.message}, trying WEBVIEW_WINDOW_ID`)\n // If that fails, try the base WEBVIEW_WINDOW_ID\n try {\n const tempWindowData = await getGlobalSharedData(WEBVIEW_WINDOW_ID)\n logDebug(\n pluginJson,\n `getFormSubmitWindowId: Got window data for WEBVIEW_WINDOW_ID, has pluginData.windowId=${String(!!tempWindowData?.pluginData?.windowId)}, has formTitle=${String(\n !!tempWindowData?.pluginData?.formTitle,\n )}`,\n )\n if (tempWindowData?.pluginData?.windowId) {\n windowId = tempWindowData.pluginData.windowId\n logDebug(pluginJson, `getFormSubmitWindowId: Updated windowId from WEBVIEW_WINDOW_ID data: \"${windowId}\"`)\n } else if (tempWindowData?.pluginData?.formTitle) {\n windowId = getFormWindowId(tempWindowData.pluginData.formTitle)\n logDebug(pluginJson, `getFormSubmitWindowId: Updated windowId from WEBVIEW_WINDOW_ID formTitle: \"${windowId}\"`)\n } else {\n windowId = WEBVIEW_WINDOW_ID\n logDebug(pluginJson, `getFormSubmitWindowId: Using WEBVIEW_WINDOW_ID as fallback: \"${windowId}\"`)\n }\n } catch (e2) {\n // Last resort: use the found ID or base ID\n windowId = findFormWindowId() || WEBVIEW_WINDOW_ID\n logDebug(pluginJson, `getFormSubmitWindowId: Last resort windowId: \"${windowId}\"`)\n }\n }\n\n return windowId\n}\n\n/**\n * Route request to appropriate handler based on action type\n * submitForm is routed to handleFormSubmitAction so the backend can close the floating window on success.\n * Other requests (getFolders, getNotes, etc.) use the shared request handler.\n * @param {string} actionType - The action/command type\n * @param {any} data - Request data\n * @returns {Promise}\n */\nasync function routeFormSubmitRequest(actionType: string, data: any): Promise {\n if (actionType === 'submitForm') {\n // Route submitForm through handleFormSubmitAction so it can close the window on success.\n // If we can't resolve windowId or reactWindowData, fall back to handleRequest (submitFormRequest).\n try {\n const windowId = await getFormSubmitWindowId(data)\n const reactWindowData = await getGlobalSharedData(windowId)\n if (reactWindowData) {\n logDebug(pluginJson, `formSubmitRouter: Routing submitForm to handleFormSubmitAction for windowId=\"${windowId}\"`)\n return await handleFormSubmitAction(data, reactWindowData, windowId)\n }\n } catch (e) {\n logDebug(pluginJson, `formSubmitRouter: submitForm could not use handleFormSubmitAction (${e.message}), falling back to handleRequest`)\n }\n }\n // For shared requests (getFolders, getNotes, getTeamspaces, etc.), use the shared request handler\n return await handleRequest(actionType, data)\n}\n\n/**\n * Handle non-REQUEST actions (legacy action-based pattern)\n * @param {string} actionType - The action type\n * @param {any} data - Request data\n * @returns {Promise}\n */\nasync function handleFormSubmitNonRequestAction(actionType: string, data: any): Promise {\n // For non-REQUEST actions (legacy action-based pattern), route to handlers\n const windowId = await getFormWindowIdForSubmission(data)\n let reactWindowData = null\n\n try {\n reactWindowData = await getGlobalSharedData(windowId)\n } catch (e) {\n logError(pluginJson, `onFormSubmitFromHTMLView: Could not get window data for windowId: ${windowId}`)\n return {}\n }\n\n // Route to appropriate handler based on action type\n switch (actionType) {\n case 'onSubmitClick':\n await handleFormSubmitAction(data, reactWindowData, windowId)\n break\n default:\n await handleUnknownAction(actionType, data, windowId)\n break\n }\n\n return {}\n}\n\n/**\n * Handle actions from FormView React component (form submission)\n * Routes requests to appropriate handlers and sends responses back\n * @param {string} actionType - The action/command type\n * @param {any} data - Request data with optional __requestType, __correlationId, __windowId\n * @returns {Promise}\n */\nexport const onFormSubmitFromHTMLView: (actionType: string, data: any) => Promise = newCommsRouter({\n routerName: 'onFormSubmitFromHTMLView',\n defaultWindowId: WEBVIEW_WINDOW_ID,\n routeRequest: routeFormSubmitRequest,\n handleNonRequestAction: handleFormSubmitNonRequestAction,\n getWindowId: getFormSubmitWindowId,\n pluginJson: pluginJson,\n useSharedHandlersFallback: true, // Forms uses shared handlers for choosers\n})\n" }, { "path": "dwertheimer.Forms/src/index.js", "content": "// @flow\n// Flow typing is important for reducing errors and improving the quality of the code.\n// About Flow: https://flow.org/en/docs/usage/#toc-write-flow-code\n// Getting started with Flow in NotePlan: https://github.com/NotePlan/plugins/blob/main/Flow_Guide.md\n// Note: As you will see in this plugin folder, you can have multiple files -- e.g. one file per command or logical group of commands\n// ...and separate files for helper/support functions that can be tested in isolation\n// The `autowatch` packager combines them all into one script.js file for NotePlan to read\n// From the command line:\n// `noteplan-cli plugin:dev {{pluginId}} --test --watch --coverage`\n// ...will watch for changes and will compile the Plugin script code\n// and copy it to your plugins directory where NotePlan can find it\n// Since NP reloads the Javascript every time you CMD-J to insert a plugin,\n// you can immediately test the new code without restarting NotePlan\n// This index.js file is where the packager starts looking for files to combine into one script.js file\n// So you need to add a line below for each function that you want NP to have access to.\n// Typically, listed below are only the top-level plug-in functions listed in plugin.json\n\nexport { openTemplateForm, openFormBuilder, testRequestHandlers, triggerOpenForm, restoreFormFromAutosave } from './NPTemplateForm'\nexport { openFormBrowser } from './windowManagement'\nexport { onFormSubmitFromHTMLView } from './formSubmitRouter'\nexport { onFormBuilderAction } from './formBuilderRouter'\nexport { onFormBrowserAction } from './formBrowserRouter'\nexport { testFormFieldRender } from './FormFieldRenderTest'\nexport { createProcessingTemplate } from './ProcessingTemplate'\n\n// FETCH mocking for offline testing\n// If you want to use external server calls in your plugin, it can be useful to mock the server responses\n// while you are developing the plugin. This allows you to test the plugin without having to\n// have a server running or having to have a network connection (or wait/pay for the server calls)\n// Comment the following import line out if you want to use live fetch/server endpoints (normal operation)\n// Uncomment it for using server mocks (fake/canned responses) you define in support/fetchOverrides.js\n// import './support/fetchOverrides'\n\n/**\n * Other imports/exports - you will normally not need to edit these\n */\n// eslint-disable-next-line import/order\nexport { editSettings } from '@helpers/NPSettings'\nexport { onUpdateOrInstall, init, onSettingsUpdated, versionCheck } from './NPTriggers-Hooks'\nexport { onOpen, onEditorWillSave } from './NPTriggers-Hooks'\n" }, { "path": "dwertheimer.Forms/src/noteHelpers.js", "content": "// @flow\n\n/**\n * Helper functions for converting NotePlan notes to React-compatible format\n * Uses native decoration functions from @helpers to ensure consistency\n *\n * @author @dwertheimer\n */\n\nimport { getNoteDecoration } from '@helpers/NPnote'\nimport { logDebug } from '@helpers/dev'\nimport { getRelativeDates } from '@helpers/NPdateTime'\n\n/**\n * Type definition for note options used in React components\n */\nexport type NoteOption = {\n title: string,\n filename: string,\n type: string, // 'Notes' or 'Calendar'\n frontmatterAttributes: { [key: string]: any },\n isTeamspaceNote: boolean,\n teamspaceID: ?string,\n teamspaceTitle: ?string,\n changedDate: ?number,\n // Decoration info from native getNoteDecoration (optional, can be added later)\n decoration?: {\n icon: string,\n color: string,\n shortDescription: ?string,\n },\n}\n\n/**\n * Convert a single TNote to NoteOption format for React components\n * Uses native getNoteDecoration for consistent decoration\n * @param {TNote} note - The NotePlan note to convert\n * @param {string} overrideType - Optional type override (e.g., 'Calendar' for calendar notes)\n * @param {boolean} includeDecoration - Whether to include decoration info (default: false, can be added by React components as needed)\n * @returns {?NoteOption} The converted note option, or null if note is invalid\n */\nexport function convertNoteToOption(note: TNote, overrideType?: ?string, includeDecoration: boolean = false): ?NoteOption {\n if (!note || !note.title || !note.filename) {\n return null\n }\n\n const option: NoteOption = {\n title: note.title,\n filename: note.filename,\n type: overrideType || note.type || 'Notes',\n frontmatterAttributes: note.frontmatterAttributes || {},\n isTeamspaceNote: note.isTeamspaceNote || false,\n teamspaceID: note.teamspaceID || null,\n teamspaceTitle: note.teamspaceTitle || null,\n changedDate: typeof note.changedDate === 'number' ? note.changedDate : note.changedDate instanceof Date ? note.changedDate.getTime() : null,\n }\n\n // Optionally include decoration from native helper\n if (includeDecoration) {\n try {\n const decoration = getNoteDecoration(note)\n if (decoration && decoration.icon && decoration.color) {\n option.decoration = {\n icon: decoration.icon,\n color: decoration.color,\n shortDescription: decoration.shortDescription || null,\n }\n }\n } catch (error) {\n // If decoration fails, continue without it\n const noteTitle = note?.title || 'unknown'\n logDebug('noteHelpers', `Failed to get decoration for note \"${noteTitle}\": ${error.message}`)\n }\n }\n\n return option\n}\n\n/**\n * Convert an array of TNote objects to NoteOption format\n * Filters out invalid notes and sorts by changedDate (most recent first)\n * Uses native getNoteDecoration for consistent decoration\n * @param {$ReadOnlyArray} notes - Array of NotePlan notes to convert\n * @param {string} overrideType - Optional type override for all notes\n * @param {boolean} includeDecoration - Whether to include decoration info from native helpers (default: true)\n * @returns {Array} Array of converted note options, sorted by changedDate\n */\nexport function convertNotesToOptions(notes: $ReadOnlyArray, overrideType?: ?string, includeDecoration: boolean = true): Array {\n if (!Array.isArray(notes) || notes.length === 0) {\n return []\n }\n\n const converted: Array = []\n for (const note of notes) {\n const option = convertNoteToOption(note, overrideType, includeDecoration)\n if (option != null) {\n converted.push(option)\n }\n }\n\n // Sort by changedDate (most recent first)\n converted.sort((a: NoteOption, b: NoteOption) => {\n const aDate = typeof a.changedDate === 'number' ? a.changedDate : 0\n const bDate = typeof b.changedDate === 'number' ? b.changedDate : 0\n return bDate - aDate\n })\n\n return converted\n}\n\n/**\n * Get all project notes converted to NoteOption format\n * Uses native getNoteDecoration for consistent decoration\n * @param {boolean} includeCalendarNotes - Whether to include calendar notes (default: false)\n * @param {boolean} includeDecoration - Whether to include decoration info from native helpers (default: true)\n * @returns {Array} Array of converted note options\n */\nexport function getAllNotesAsOptions(includeCalendarNotes: boolean = false, includeDecoration: boolean = true): Array {\n const notes: Array = []\n\n // Get all project notes\n const projectNotes = DataStore.projectNotes || []\n notes.push(...convertNotesToOptions(projectNotes, undefined, includeDecoration))\n\n // Optionally include calendar notes\n if (includeCalendarNotes) {\n const calendarNotes = DataStore.calendarNotes || []\n notes.push(...convertNotesToOptions(calendarNotes, 'Calendar', includeDecoration))\n }\n\n // Re-sort all notes together by changedDate (most recent first)\n notes.sort((a: NoteOption, b: NoteOption) => {\n const aDate = typeof a.changedDate === 'number' ? a.changedDate : 0\n const bDate = typeof b.changedDate === 'number' ? b.changedDate : 0\n return bDate - aDate\n })\n\n return notes\n}\n\n/**\n * Convert relative date relName to TemplateRunner format\n * Maps relative date names like \"today\", \"this week\", \"next week\" to TemplateRunner format like \"\", \"\", \"\"\n * @param {string} relName - The relative date name from getRelativeDates (e.g., \"today\", \"this week\", \"next week\")\n * @returns {?string} The TemplateRunner format (e.g., \"\", \"\", \"\") or null if no mapping\n */\nfunction relNameToTemplateRunnerFormat(relName: string): ?string {\n const mapping: { [key: string]: string } = {\n today: '',\n 'this week': '',\n 'next week': '',\n 'last week': '',\n 'this month': '',\n 'next month': '',\n 'last month': '',\n 'this quarter': '',\n 'next quarter': '',\n 'last quarter': '',\n }\n return mapping[relName.toLowerCase()] || null\n}\n\n/**\n * Get relative notes as NoteOption format for React components\n * Uses getRelativeDates() and converts to NoteOption format with TemplateRunner-compatible values\n * @param {boolean} includeDecoration - Whether to include decoration info (default: false)\n * @returns {Array} Array of relative note options\n */\nexport function getRelativeNotesAsOptions(includeDecoration: boolean = false): Array {\n try {\n const relativeDates = getRelativeDates(true) // Use ISO daily dates\n const relativeNotes: Array = []\n\n for (const rd of relativeDates) {\n if (!rd.relName || !rd.dateStr) {\n continue\n }\n\n // Convert relName to TemplateRunner format\n const templateRunnerValue = relNameToTemplateRunnerFormat(rd.relName)\n if (!templateRunnerValue) {\n // Skip if no mapping exists (e.g., \"yesterday\", \"tomorrow\", \"in 2 days\", etc.)\n // Only include the main ones that TemplateRunner supports\n continue\n }\n\n // Create a NoteOption for this relative date\n const option: NoteOption = {\n title: templateRunnerValue, // Display name (e.g., \"today\", \"this week\")\n filename: templateRunnerValue, // TemplateRunner format (e.g., \"\", \"\")\n type: 'Calendar', // Relative dates are calendar notes\n frontmatterAttributes: {},\n isTeamspaceNote: false,\n teamspaceID: null,\n teamspaceTitle: null,\n changedDate: null, // Relative dates don't have a changedDate\n }\n\n // Optionally add decoration (calendar icon)\n if (includeDecoration) {\n option.decoration = {\n icon: 'calendar-star',\n color: 'gray-500',\n shortDescription: rd.dateStr, // Show the actual date string as short description\n }\n }\n\n relativeNotes.push(option)\n }\n\n // Also add special options that TemplateRunner supports\n const specialOptions: Array<{ relName: string, templateValue: string }> = [\n { relName: 'Current Note', templateValue: '' },\n { relName: 'Choose Note', templateValue: '' },\n ]\n\n for (const special of specialOptions) {\n const option: NoteOption = {\n title: special.relName,\n filename: special.templateValue,\n type: 'Notes', // These are note selection options, not calendar notes\n frontmatterAttributes: {},\n isTeamspaceNote: false,\n teamspaceID: null,\n teamspaceTitle: null,\n changedDate: null,\n }\n\n if (includeDecoration) {\n option.decoration = {\n icon: 'file-lines',\n color: 'gray-500',\n shortDescription: null,\n }\n }\n\n relativeNotes.push(option)\n }\n\n return relativeNotes\n } catch (error) {\n logDebug('noteHelpers', `Failed to get relative notes: ${error.message}`)\n return []\n }\n}\n" }, { "path": "dwertheimer.Forms/src/requestHandlers.js", "content": "// @flow\n\n/**\n * Request Handlers for Forms Plugin\n *\n * This file contains handlers for request/response pattern communication from React to NotePlan.\n * Each handler should return a standardized response object with:\n * - success: boolean\n * - message: string (optional, for error messages or informational messages)\n * - data: any (the actual response data)\n *\n * @author @dwertheimer\n */\n\nimport moment from 'moment/min/moment-with-locales'\nimport pluginJson from '../plugin.json'\nimport { getAllNotesAsOptions, getRelativeNotesAsOptions } from './noteHelpers'\nimport { loadTemplateBodyFromTemplate, loadTemplateRunnerArgsFromTemplate, formatFormFieldsAsCodeBlock, getFormTemplateList } from './templateIO'\nimport { logDebug, logError, logInfo, logWarn } from '@helpers/dev'\nimport { getFoldersMatching, getFolderFromFilename } from '@helpers/folders'\nimport { displayTitle } from '@helpers/paragraph'\nimport { createRunPluginCallbackUrl } from '@helpers/general'\nimport { getAllTeamspaceIDsAndTitles } from '@helpers/NPTeamspace'\nimport { parseTeamspaceFilename } from '@helpers/teamspace'\nimport { showMessage } from '@helpers/userInput'\nimport { getHeadingsFromNote, getOrMakeRegularNoteInFolder } from '@helpers/NPnote'\nimport { getNoteByFilename, getNote } from '@helpers/note'\nimport { getNoteContentAsHTML } from '@helpers/HTMLView'\nimport { focusHTMLWindowIfAvailable } from '@helpers/NPWindows'\nimport { updateFrontMatterVars, ensureFrontmatter, endOfFrontmatterLineIndex } from '@helpers/NPFrontMatter'\nimport { saveCodeBlockToNote, loadCodeBlockFromNote, replaceCodeBlockContent } from '@helpers/codeBlocks'\nimport { parseObjectString } from '@helpers/stringTransforms'\nimport { replaceContentUnderHeading, removeContentUnderHeading } from '@helpers/NPParagraph'\nimport { initPromisePolyfills, waitForCondition } from '@helpers/promisePolyfill'\nimport { testFormFieldRender } from './FormFieldRenderTest'\n// Import data-fetching functions from dataHandlers.js to break circular dependency\n// These are used by handleRequest() but not re-exported - import directly from dataHandlers.js if needed\nimport { getFolders, getNotes, getEvents, getHashtags, getMentions, getTeamspaces, getFrontmatterKeyValues } from './dataHandlers'\n// Import RequestResponse type from shared types\nimport { type RequestResponse } from './shared/types'\n// Re-export RequestResponse type for backward compatibility (used by other handler files)\nexport type { RequestResponse }\n// Form-specific handlers are now in their respective handler files:\n// - formBrowserHandlers.js: getFormTemplates, getFormFields, handleSubmitForm, handleOpenFormBuilder\n// - formBuilderHandlers.js: handleCreateProcessingTemplate, handleOpenNote, handleCopyFormUrl, handleDuplicateForm\n// - formSubmitHandlers.js: handleFormSubmitAction, handleUnknownAction, submitFormRequest (REQUEST path for form submit)\nimport { submitFormRequest } from './formSubmitHandlers'\n\n// Initialize Promise polyfills early\ninitPromisePolyfills()\n\n/**\n * Test function to verify request handlers are working correctly\n * Call this from NotePlan Command Bar: \"Test Request Handlers\"\n * @returns {Promise}\n */\nexport async function testRequestHandlers(): Promise {\n try {\n logInfo(pluginJson, '🧪 Testing request handlers...')\n\n // Test getFolders\n logInfo(pluginJson, 'Testing getFolders...')\n const foldersResult = getFolders({ excludeTrash: true })\n logInfo(pluginJson, `getFolders: success=${String(foldersResult.success)}, folders=${foldersResult.data?.length ?? 0}`)\n if (foldersResult.data && foldersResult.data.length > 0) {\n logInfo(pluginJson, `First 3 folders: ${foldersResult.data.slice(0, 3).join(', ')}`)\n }\n\n // Test getNotes\n logInfo(pluginJson, 'Testing getNotes...')\n const notesResult = getNotes({ includeCalendarNotes: false })\n logInfo(pluginJson, `getNotes: success=${String(notesResult.success)}, notes=${notesResult.data?.length ?? 0}`)\n if (notesResult.data && notesResult.data.length > 0) {\n logInfo(\n pluginJson,\n `First 3 notes: ${notesResult.data\n .slice(0, 3)\n .map((n: any) => n.title || n.filename)\n .join(', ')}`,\n )\n }\n\n // Test getTeamspaces\n logInfo(pluginJson, 'Testing getTeamspaces...')\n const teamspacesResult = getTeamspaces({})\n logInfo(pluginJson, `getTeamspaces: success=${String(teamspacesResult.success)}, teamspaces=${teamspacesResult.data?.length ?? 0}`)\n if (teamspacesResult.data && teamspacesResult.data.length > 0) {\n logInfo(pluginJson, `Teamspaces: ${teamspacesResult.data.map((ts: any) => `${ts.title} (${ts.id})`).join(', ')}`)\n }\n\n logInfo(pluginJson, '✅ All request handlers tested successfully! Check Plugin Console for details.')\n await showMessage('Request handlers test complete! Check Plugin Console (NotePlan > Help > Plugin Console) for details.')\n } catch (error) {\n logError(pluginJson, `❌ Error testing request handlers: ${error.message}`)\n await showMessage(`Error testing request handlers: ${error.message}`)\n }\n}\n\n// getFolders has been moved to dataHandlers.js to break circular dependencies.\n// It is imported and re-exported above for backward compatibility.\n\n// getNotes and getEvents have been moved to dataHandlers.js to break circular dependencies.\n// They are imported and re-exported above for backward compatibility.\n\n/**\n * Get list of available calendar titles\n * NOTE: There is a known bug in NotePlan's Calendar.availableCalendarTitles() API that causes\n * it to only return calendars with write access, even when writeOnly=false. This means the\n * list may be incomplete and missing read-only calendars that NotePlan can still access events from.\n * @param {Object} params - Request parameters\n * @param {boolean} params.writeOnly - If true, only return calendars with write access (default: false)\n * @returns {RequestResponse}\n */\nexport function getAvailableCalendars(params: { writeOnly?: boolean } = {}): RequestResponse {\n const startTime: number = Date.now()\n try {\n const writeOnly = params.writeOnly ?? false\n logDebug(pluginJson, `[DIAG] getAvailableCalendars START: writeOnly=${String(writeOnly)}`)\n\n // NOTE: Bug in NotePlan API - availableCalendarTitles may only return writeable calendars\n // even when writeOnly=false. This is why we offer \"All NotePlan Enabled Calendars\" option.\n const calendars = Calendar.availableCalendarTitles(writeOnly || false)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getAvailableCalendars COMPLETE: totalElapsed=${totalElapsed}ms, found=${calendars.length} calendars`)\n\n return {\n success: true,\n data: calendars,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getAvailableCalendars ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get calendars: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get list of available reminder list titles\n * @param {Object} params - Request parameters (currently unused)\n * @returns {RequestResponse}\n */\nexport function getAvailableReminderLists(_params: Object = {}): RequestResponse {\n const startTime: number = Date.now()\n try {\n logDebug(pluginJson, `[DIAG] getAvailableReminderLists START`)\n\n // NOTE: Calendar.availableReminderListTitles() may return an empty array if the user\n // has no reminder lists configured in NotePlan. This is not an error condition.\n const reminderLists = Calendar.availableReminderListTitles()\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getAvailableReminderLists COMPLETE: totalElapsed=${totalElapsed}ms, found=${reminderLists.length} reminder lists`)\n\n if (reminderLists.length === 0) {\n logDebug(pluginJson, `[DIAG] getAvailableReminderLists: Empty result - user may not have any reminder lists configured in NotePlan`)\n }\n\n return {\n success: true,\n data: reminderLists,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getAvailableReminderLists ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get reminder lists: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get teamspace definitions for folder decoration\n * @param {Object} params - Request parameters (currently unused)\n * @returns {RequestResponse}\n */\n// getHashtags and getMentions have been moved to dataHandlers.js to break circular dependencies.\n// They are imported and re-exported above for backward compatibility.\n\n// getFrontmatterKeyValues has been moved to dataHandlers.js to break circular dependency:\n// requestHandlers -> FormFieldRenderTest -> windowManagement -> requestHandlers\nexport { getFrontmatterKeyValues } from './dataHandlers'\n\n// getTeamspaces has been moved to dataHandlers.js to break circular dependencies.\n// It is imported and re-exported above for backward compatibility.\n\n/**\n * Create a new folder\n * @param {Object} params - Request parameters\n * @param {string} params.folderPath - Full path of the folder to create (e.g., '/Projects/NewProject' or 'NewFolder')\n * @returns {RequestResponse}\n */\nexport function createFolder(params: { folderPath: string }): RequestResponse {\n try {\n logDebug(pluginJson, `createFolder: Creating folder=\"${params.folderPath}\"`)\n\n if (!params.folderPath || !params.folderPath.trim()) {\n return {\n success: false,\n message: 'Folder path is required',\n data: null,\n }\n }\n\n const folderPath = params.folderPath.trim()\n\n // Check if folder already exists\n const existingFolders = DataStore.folders || []\n if (existingFolders.includes(folderPath)) {\n logDebug(pluginJson, `createFolder: Folder already exists: \"${folderPath}\"`)\n return {\n success: true,\n message: 'Folder already exists',\n data: folderPath,\n }\n }\n\n // Create the folder\n DataStore.createFolder(folderPath)\n\n logDebug(pluginJson, `createFolder: Successfully created folder: \"${folderPath}\"`)\n\n return {\n success: true,\n data: folderPath,\n }\n } catch (error) {\n logError(pluginJson, `createFolder: Error: ${error.message}`)\n return {\n success: false,\n message: `Failed to create folder: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Create a new note\n * @param {Object} params - Request parameters\n * @param {string} params.noteTitle - Title of the new note\n * @param {string} params.folder - Folder path to create the note in (default: '/')\n * @returns {RequestResponse}\n */\nexport function createNote(params: { noteTitle: string, folder?: string }): RequestResponse {\n const startTime: number = Date.now()\n try {\n const { noteTitle, folder = '/' } = params\n\n if (!noteTitle || !noteTitle.trim()) {\n return {\n success: false,\n message: 'Note title is required',\n data: null,\n }\n }\n\n logDebug(pluginJson, `[DIAG] createNote START: noteTitle=\"${noteTitle}\", folder=\"${folder}\"`)\n\n // Create the note using DataStore.newNote\n const filename = DataStore.newNote(noteTitle.trim(), folder)\n\n if (filename) {\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] createNote COMPLETE: totalElapsed=${totalElapsed}ms, filename=\"${filename}\"`)\n return {\n success: true,\n data: filename,\n }\n } else {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] createNote ERROR: totalElapsed=${totalElapsed}ms, DataStore.newNote returned null`)\n return {\n success: false,\n message: 'Failed to create note: DataStore.newNote returned null',\n data: null,\n }\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] createNote ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to create note: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Save autosave content to a note\n * @param {Object} params - Request parameters\n * @param {string} params.filename - Filename pattern (e.g., \"@Trash/Autosave-2025-12-30T23-51-09\")\n * @param {string} params.content - Content to save (JSON code block)\n * @param {Object} params.formState - Form state object (for reference)\n * @returns {RequestResponse}\n */\nexport async function saveAutosave(params: { filename: string, content: string, formState?: Object }): Promise {\n const startTime: number = Date.now()\n try {\n const { filename, content } = params\n\n if (!filename || !content) {\n return {\n success: false,\n message: 'Filename and content are required',\n data: null,\n }\n }\n\n logDebug(pluginJson, `saveAutosave: Saving to \"${filename}\"`)\n\n // Parse filename pattern: \"@Trash/Autosave-2025-12-30T23-51-09\"\n // Extract folder and note title\n const parts = filename.split('/')\n let folder = '/'\n let noteTitle = filename\n\n if (parts.length > 1) {\n folder = parts.slice(0, -1).join('/')\n noteTitle = parts[parts.length - 1]\n } else if (filename.startsWith('@')) {\n // If it starts with @ but no slash, treat the whole thing as the note title\n noteTitle = filename\n folder = '/'\n }\n\n logDebug(pluginJson, `saveAutosave: Parsed folder=\"${folder}\", noteTitle=\"${noteTitle}\"`)\n\n // Try to find existing note first by searching in the folder\n // Note: DataStore.projectNotes excludes notes in @Trash, so we need to use\n // projectNoteByTitle with searchAllFolders: true for trash folder\n let note: ?TNote = null\n const isTrashFolder = folder === '@Trash' || folder.startsWith('@Trash/')\n\n if (isTrashFolder) {\n // For @Trash folder, use projectNoteByTitle with searchAllFolders: true\n // because projectNotes excludes trash notes\n // Search by filename pattern since NotePlan appends numbers to filenames, not titles\n const potentialNotes = DataStore.projectNoteByTitle(noteTitle, true, true) ?? []\n \n // First, try to find exact title match\n let matchingNotes = potentialNotes.filter((n) => {\n const noteFolder = getFolderFromFilename(n.filename)\n const noteDisplayTitle = displayTitle(n)\n return noteFolder === folder && noteDisplayTitle === noteTitle\n })\n \n // If no exact match, search by filename pattern (NotePlan appends \" 2\", \" 3\", etc. to filenames)\n if (matchingNotes.length === 0) {\n // Extract base filename without extension (e.g., \"Autosave-Jeff-Meeting-Form-2025-12-31T08-40-49\")\n const baseFilename = noteTitle.replace(/\\.(md|txt)$/i, '')\n matchingNotes = potentialNotes.filter((n) => {\n const noteFolder = getFolderFromFilename(n.filename)\n if (noteFolder !== folder) return false\n \n // Get filename without folder and extension\n const noteFilename = n.filename.split('/').pop() || ''\n const noteFilenameBase = noteFilename.replace(/\\.(md|txt)$/i, '').replace(/\\s+\\d+$/, '') // Remove number suffix\n \n // Match if base filename matches (ignoring number suffix)\n return noteFilenameBase === baseFilename || noteFilenameBase === noteTitle\n })\n }\n \n if (matchingNotes.length > 0) {\n // Prefer exact title match, otherwise use first match (which should be the original, not numbered)\n note = matchingNotes.find((n) => displayTitle(n) === noteTitle) || matchingNotes[0]\n logDebug(pluginJson, `saveAutosave: Found existing note in trash folder \"${folder}\": ${note.filename}`)\n }\n } else if (folder === '/') {\n // Root folder - find notes without folder path\n const rootNotes = DataStore.projectNotes.filter((n) => {\n const noteFolder = getFolderFromFilename(n.filename)\n return noteFolder === '/' && displayTitle(n) === noteTitle\n })\n if (rootNotes.length > 0) {\n note = rootNotes[0]\n logDebug(pluginJson, `saveAutosave: Found existing note in root: ${note.filename}`)\n }\n } else {\n // Specific folder - find notes in that folder\n const folderNotes = DataStore.projectNotes.filter((n) => {\n const noteFolder = getFolderFromFilename(n.filename)\n return noteFolder === folder && displayTitle(n) === noteTitle\n })\n if (folderNotes.length > 0) {\n note = folderNotes[0]\n logDebug(pluginJson, `saveAutosave: Found existing note in folder \"${folder}\": ${note.filename}`)\n }\n }\n\n // If note not found, create it\n // For @Trash, we need to use a different approach since getOrMakeRegularNoteInFolder doesn't search trash properly\n if (!note) {\n logDebug(pluginJson, `saveAutosave: Note not found, creating new note`)\n if (isTrashFolder) {\n // For @Trash, create the note directly using DataStore.newNote (synchronous, not async)\n const noteFilename = DataStore.newNote(noteTitle, folder)\n if (noteFilename) {\n // Try to get the note by filename first\n note = await DataStore.projectNoteByFilename(noteFilename)\n if (!note) {\n // Wait a bit for the note to be available in the cache\n await new Promise((resolve) => setTimeout(resolve, 100))\n // Try again\n note = await DataStore.projectNoteByFilename(noteFilename)\n if (!note) {\n // If that fails, try to find it using projectNoteByTitle with searchAllFolders\n const foundNotes = DataStore.projectNoteByTitle(noteTitle, true, true) ?? []\n const matchingNotes = foundNotes.filter((n) => {\n const noteFolder = getFolderFromFilename(n.filename)\n return noteFolder === folder && displayTitle(n) === noteTitle\n })\n if (matchingNotes.length > 0) {\n note = matchingNotes[0]\n logDebug(pluginJson, `saveAutosave: Found newly created note in trash: ${note.filename}`)\n }\n }\n }\n if (note) {\n // Update cache to ensure note is available\n DataStore.updateCache(note, true)\n logDebug(pluginJson, `saveAutosave: Created/found note in trash: ${note.filename}`)\n }\n }\n } else {\n // For other folders, use getOrMakeRegularNoteInFolder\n note = await getOrMakeRegularNoteInFolder(noteTitle, folder)\n }\n \n if (!note) {\n logError(pluginJson, `saveAutosave: Failed to get or create note \"${noteTitle}\" in folder \"${folder}\"`)\n return {\n success: false,\n message: `Failed to get or create note \"${noteTitle}\"`,\n data: null,\n }\n }\n logDebug(pluginJson, `saveAutosave: Created/found note: ${note.filename}`)\n }\n\n // Extract JSON content from the code block (content comes as \"```json\\n{...}\\n```\")\n // Remove the code block fences to get just the JSON content\n let jsonContent = content\n if (content.startsWith('```')) {\n // Remove opening fence (e.g., \"```json\\n\")\n const lines = content.split('\\n')\n if (lines.length > 1) {\n // Skip first line (fence) and last line (closing fence), join the rest\n jsonContent = lines.slice(1, -1).join('\\n')\n } else {\n // Fallback: try to strip fences manually\n jsonContent = content.replace(/^```[a-z]*\\n/, '').replace(/\\n```$/, '')\n }\n }\n\n // Use replaceCodeBlockContent to save to a code block (replaces existing or adds new)\n // Use fixed code block type \"autosave\" so each save replaces the previous one in the same note\n const codeBlockType = 'autosave'\n const success = replaceCodeBlockContent(note, codeBlockType, jsonContent, pluginJson.id)\n\n if (!success) {\n logError(pluginJson, `saveAutosave: Failed to save code block to note`)\n return {\n success: false,\n message: 'Failed to save autosave content',\n data: null,\n }\n }\n\n // Add xcallback URL outside the codeblock for restoring the form\n // Parse the formState to get the form title if available\n let formStateObj: any = {}\n try {\n formStateObj = params.formState || JSON.parse(jsonContent)\n } catch (e) {\n logDebug(pluginJson, `saveAutosave: Could not parse formState, using empty object`)\n }\n\n // Create xcallback URL to restore the form\n // The restore command will need the autosave filename to restore from\n const restoreCommand = 'Restore form from autosave'\n const restoreUrl = createRunPluginCallbackUrl(pluginJson['plugin.id'], restoreCommand, [filename])\n\n // Add the restore link to the note content (outside the codeblock)\n // Check if the link already exists in the note\n const restoreLinkText = `[Restore form from autosave](${restoreUrl})`\n const noteContent = note.content || ''\n \n // Remove existing restore link if present (look for the pattern, including any trailing newline and blank lines)\n // Remove the link and up to 2 following newlines (to clean up extra blank lines)\n let updatedContent = noteContent.replace(/\\[Restore form from autosave\\]\\(noteplan:\\/\\/[^\\)]+\\)\\n{0,2}/g, '')\n \n // Split content into lines for easier manipulation\n const lines = updatedContent.split('\\n')\n \n // Find where to insert the restore link\n // If note has frontmatter, insert after frontmatter; otherwise insert at index 1 (after title)\n const fmEndIndex = endOfFrontmatterLineIndex(note)\n let insertIndex = 1 // Default: after title line (index 0)\n \n if (fmEndIndex !== -1) {\n // Has frontmatter, insert after it\n insertIndex = fmEndIndex + 1\n }\n \n // Check if restore link already exists (shouldn't happen after removal, but be safe)\n const existingLinkIndex = lines.findIndex((line) => line.includes('[Restore form from autosave]'))\n if (existingLinkIndex === -1) {\n // Only insert if it doesn't already exist\n // Check what's at the insert position and after to avoid adding extra blank lines\n const lineAtInsert = lines[insertIndex] || ''\n const lineAfterInsert = lines[insertIndex + 1] || ''\n \n // If the line at insert position is already blank, just insert the link\n if (lineAtInsert.trim() === '') {\n lines[insertIndex] = restoreLinkText\n } else {\n // Insert link and ensure exactly one blank line after it\n lines.splice(insertIndex, 0, restoreLinkText)\n // If the next line isn't blank, add one blank line\n if (insertIndex + 1 >= lines.length || lines[insertIndex + 1].trim() !== '') {\n lines.splice(insertIndex + 1, 0, '')\n }\n }\n } else {\n // Link exists, just update it (don't add extra blank lines)\n lines[existingLinkIndex] = restoreLinkText\n }\n updatedContent = lines.join('\\n')\n\n // Update the note content\n note.content = updatedContent\n\n // Update cache\n DataStore.updateCache(note, true)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `saveAutosave: Successfully saved to \"${filename}\", totalElapsed=${totalElapsed}ms`)\n return {\n success: true,\n data: note.filename,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `saveAutosave: Error saving autosave, totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Error saving autosave: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get headings from a note\n * @param {Object} params - Request parameters\n * @param {string} params.noteFilename - Filename of the note to get headings from\n * @param {boolean} params.optionAddTopAndBottom - Whether to add \"top of note\" and \"bottom of note\" options (default: true)\n * @param {boolean} params.includeArchive - Whether to include headings in Archive section (default: false)\n * @returns {RequestResponse}\n */\nexport function getHeadings(params: { noteFilename: string, optionAddTopAndBottom?: boolean, includeArchive?: boolean }): RequestResponse {\n const startTime: number = Date.now()\n try {\n logDebug(pluginJson, `[DIAG] getHeadings START: noteFilename=\"${params.noteFilename}\"`)\n\n if (!params.noteFilename) {\n return {\n success: false,\n message: 'Note filename is required',\n data: null,\n }\n }\n\n // Get the note by filename\n const note = getNoteByFilename(params.noteFilename)\n if (!note) {\n return {\n success: false,\n message: `Note not found: ${params.noteFilename}`,\n data: null,\n }\n }\n\n // Get headings from the note\n const optionAddTopAndBottom = params.optionAddTopAndBottom ?? true\n const includeArchive = params.includeArchive ?? false\n const headings = getHeadingsFromNote(note, false, optionAddTopAndBottom, false, includeArchive)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getHeadings COMPLETE: totalElapsed=${totalElapsed}ms, found=${headings.length} headings`)\n\n return {\n success: true,\n data: headings,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getHeadings ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get headings: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Render markdown text to HTML\n * @param {Object} params - Request parameters\n * @param {string} params.markdown - Markdown text to render\n * @returns {RequestResponse}\n */\nexport async function renderMarkdown(params: { markdown: string }): Promise {\n const startTime: number = Date.now()\n try {\n logDebug(pluginJson, `[DIAG] renderMarkdown START: markdown length=${params.markdown?.length || 0}`)\n\n if (!params.markdown) {\n return {\n success: false,\n message: 'Markdown text is required',\n data: null,\n }\n }\n\n // For static markdown, we need to create a minimal note-like object\n // getNoteContentAsHTML expects (content: string, note: TNote)\n // We'll create a minimal note object with just the required properties\n const tempNote: any = {\n filename: 'temp.md',\n content: params.markdown,\n paragraphs: [],\n }\n\n const html = await getNoteContentAsHTML(params.markdown, tempNote)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] renderMarkdown COMPLETE: totalElapsed=${totalElapsed}ms`)\n\n return {\n success: true,\n data: html,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] renderMarkdown ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to render markdown: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Get note content as HTML\n * @param {Object} params - Request parameters\n * @param {string} params.noteIdentifier - Filename or title of the note\n * @param {boolean} params.isFilename - Whether noteIdentifier is a filename (default: true)\n * @param {boolean} params.isTitle - Whether noteIdentifier is a title (default: false)\n * @returns {RequestResponse}\n */\nexport async function getNoteContentAsHTMLHandler(params: { noteIdentifier: string, isFilename?: boolean, isTitle?: boolean }): Promise {\n const startTime: number = Date.now()\n try {\n logDebug(\n pluginJson,\n `[DIAG] getNoteContentAsHTML START: noteIdentifier=\"${params.noteIdentifier}\", isFilename=${String(params.isFilename ?? true)}, isTitle=${String(params.isTitle ?? false)}`,\n )\n\n if (!params.noteIdentifier) {\n return {\n success: false,\n message: 'Note identifier is required',\n data: null,\n }\n }\n\n // Get the note by filename or title\n const note = await getNote(params.noteIdentifier, null, '')\n if (!note) {\n return {\n success: false,\n message: `Note not found: ${params.noteIdentifier}`,\n data: null,\n }\n }\n\n // Get the note content as HTML\n const html = await getNoteContentAsHTML(note.content, note)\n\n const totalElapsed: number = Date.now() - startTime\n logDebug(pluginJson, `[DIAG] getNoteContentAsHTML COMPLETE: totalElapsed=${totalElapsed}ms`)\n\n return {\n success: true,\n data: html,\n }\n } catch (error) {\n const totalElapsed: number = Date.now() - startTime\n logError(pluginJson, `[DIAG] getNoteContentAsHTML ERROR: totalElapsed=${totalElapsed}ms, error=\"${error.message}\"`)\n return {\n success: false,\n message: `Failed to get note content as HTML: ${error.message}`,\n data: null,\n }\n }\n}\n\n/**\n * Remove empty lines from a note's content\n * Removes sequences of 2+ newlines, blank lines after frontmatter, and trailing blank lines\n * @param {any} note - The note to clean up (CoreNoteFields)\n * @returns {void}\n */\nexport function removeEmptyLinesFromNote(note: any): void {\n if (!note) return\n\n // Rebuild content from paragraphs\n const contentParts = note.paragraphs.map((p) => p.rawContent)\n let cleanedContent = contentParts.join('\\n')\n\n // Remove all blank lines: replace any sequence of 2+ newlines with a single newline\n cleanedContent = cleanedContent.replace(/\\n{2,}/g, '\\n')\n // Remove blank lines immediately after frontmatter (after the closing ---)\n cleanedContent = cleanedContent.replace(/(---\\n)\\n+/g, '$1')\n // Remove trailing blank lines\n cleanedContent = cleanedContent.replace(/\\n+$/, '')\n\n note.content = cleanedContent\n note.updateParagraphs(note.paragraphs)\n}\n\n/**\n * Update form links in a note's body content under \"Form Details\" heading\n * Uses replaceContentUnderHeading to replace or create the heading section\n * @param {CoreNoteFields} note - The note to update\n * @param {string} formTitle - The title of the form\n * @param {string} launchLink - The launch link URL\n * @param {string} formEditLink - The form edit link URL\n * @param {string} processingTemplateLink - Optional processing template link URL\n * @returns {Promise}\n */\nexport async function updateFormLinksInNote(\n note: any, // CoreNoteFields - note object with paragraphs and frontmatter\n formTitle: string,\n launchLink: string,\n formEditLink: string,\n processingTemplateLink?: string,\n): Promise {\n logDebug(pluginJson, `updateFormLinksInNote: [START] Called with formTitle: \"${formTitle}\"`)\n logDebug(pluginJson, `updateFormLinksInNote: [START] Note content before (first 30 lines):\\n${(note.content || '').split('\\n').slice(0, 30).join('\\n')}`)\n logDebug(pluginJson, `updateFormLinksInNote: [START] Note has ${note.paragraphs.length} paragraphs`)\n\n const links = [`- [open form](${launchLink})`, `- [edit form](${formEditLink})`]\n if (processingTemplateLink) {\n links.push(`- [open processing template](${processingTemplateLink})`)\n }\n // Use replaceContentUnderHeading to replace or create the \"Form Details\" section\n // Note: The heading text includes the formTitle, but this is just for display in the body\n const markdownContent = `## Form Details - ${formTitle}:\\n${links.join('\\n')}`\n logDebug(pluginJson, `updateFormLinksInNote: [BEFORE] markdownContent to insert:\\n${markdownContent}`)\n\n // Find where the frontmatter ends to insert after it\n // endOfFrontmatterLineIndex expects a note object, not just paragraphs\n const endOfFM = endOfFrontmatterLineIndex(note)\n logDebug(pluginJson, `updateFormLinksInNote: endOfFrontmatterLineIndex returned: ${endOfFM}`)\n\n if (endOfFM != null && endOfFM >= 0) {\n // We have frontmatter - insert after it\n const insertionIndex = endOfFM + 1\n logDebug(pluginJson, `updateFormLinksInNote: Will insert at index ${insertionIndex} (after frontmatter ending at ${endOfFM})`)\n\n // Check if \"Form Details\" heading already exists\n let headingIndex = -1\n for (let i = insertionIndex; i < note.paragraphs.length; i++) {\n const p = note.paragraphs[i]\n if (p.type === 'title' && p.content.trim().startsWith('Form Details')) {\n headingIndex = i\n break\n }\n }\n\n if (headingIndex >= 0) {\n // Heading exists, remove content under it first\n removeContentUnderHeading(note, 'Form Details', false, false)\n // Re-find the heading after removal\n for (let i = insertionIndex; i < note.paragraphs.length; i++) {\n const p = note.paragraphs[i]\n if (p.type === 'title' && p.content.trim().startsWith('Form Details')) {\n headingIndex = i\n break\n }\n }\n // Insert content after the heading\n note.insertParagraph(links.join('\\n'), headingIndex + 1, 'text')\n } else {\n // Heading doesn't exist, insert heading and content\n // Use insertHeading with headingLevel 2 for ## heading\n note.insertHeading(`Form Details - ${formTitle}:`, insertionIndex, 2)\n note.insertParagraph(links.join('\\n'), insertionIndex + 1, 'text')\n }\n } else {\n // No frontmatter, use the standard method\n logDebug(pluginJson, `updateFormLinksInNote: No frontmatter found, using replaceContentUnderHeading`)\n await replaceContentUnderHeading(note, 'Form Details', markdownContent, false, 2)\n }\n\n logDebug(pluginJson, `updateFormLinksInNote: [AFTER] Note content after (first 30 lines):\\n${(note.content || '').split('\\n').slice(0, 30).join('\\n')}`)\n logDebug(pluginJson, `updateFormLinksInNote: [AFTER] Note has ${note.paragraphs.length} paragraphs`)\n}\n\n/**\n * Router function to handle requests from React\n * @param {string} requestType - The type of request (e.g., 'getFolders', 'getNotes', 'createFolder')\n * @param {Object} params - Request parameters\n * @returns {Promise}\n */\nexport async function handleRequest(requestType: string, params: Object = {}): Promise {\n try {\n logDebug(pluginJson, `handleRequest: requestType=\"${requestType}\", params=${JSON.stringify(params)}`)\n\n switch (requestType) {\n case 'getFolders':\n return getFolders(params)\n case 'getNotes':\n return getNotes(params)\n case 'getEvents':\n return await getEvents(params)\n case 'getAvailableCalendars':\n return getAvailableCalendars(params)\n case 'getAvailableReminderLists':\n return getAvailableReminderLists(params)\n case 'getTeamspaces':\n return getTeamspaces(params)\n case 'getHashtags':\n return getHashtags(params)\n case 'getMentions':\n return getMentions(params)\n case 'getFrontmatterKeyValues':\n return await getFrontmatterKeyValues(params)\n case 'createFolder':\n return createFolder(params)\n case 'getHeadings':\n return getHeadings(params)\n case 'renderMarkdown':\n return await renderMarkdown(params)\n case 'getNoteContentAsHTML':\n return await getNoteContentAsHTMLHandler(params)\n case 'createNote':\n return createNote(params)\n case 'saveAutosave':\n return await saveAutosave(params)\n case 'submitForm':\n return await submitFormRequest(params)\n case 'testFormFieldRender':\n // Open the form field render test window\n await testFormFieldRender()\n return {\n success: true,\n message: 'Form field examples opened',\n data: null,\n }\n // Form-specific handlers are now in their respective handler files:\n // - formBrowserHandlers.js handles: getFormTemplates, getFormFields, submitForm, openFormBuilder\n // - formBuilderHandlers.js handles: createProcessingTemplate, openNote, copyFormUrl, duplicateForm\n // - formSubmitHandlers.js handles: onSubmitClick and other form submission actions\n default:\n logError(pluginJson, `handleRequest: Unknown request type: \"${requestType}\"`)\n return {\n success: false,\n message: `Unknown request type: \"${requestType}\"`,\n data: null,\n }\n }\n } catch (error) {\n logError(pluginJson, `handleRequest: Error handling request \"${requestType}\": ${error.message}`)\n return {\n success: false,\n message: `Error handling request: ${error.message}`,\n data: null,\n }\n }\n}\n" }, { "path": "dwertheimer.Forms/src/shared/constants.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Shared Constants - Used by both React components and back-end code\n// These constants have no back-end dependencies and can be safely imported by React\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../../plugin.json'\n\n/**\n * Base window ID for Form Builder React windows\n * Individual windows will append the template title/filename to make them unique\n */\nexport const FORMBUILDER_WINDOW_ID = `${pluginJson['plugin.id']} Form Builder React Window`\n\n/**\n * Window ID for the Form Entry React window\n */\nexport const WEBVIEW_WINDOW_ID = `${pluginJson['plugin.id']} Form Entry React Window`\n" }, { "path": "dwertheimer.Forms/src/shared/types.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Shared Types - Used by both React components and back-end code\n// These types have no back-end dependencies and can be safely imported by React\n//--------------------------------------------------------------------------\n\n/**\n * Data structure passed to React windows from the plugin\n */\nexport type PassedData = {\n startTime?: Date /* used for timing/debugging */,\n title?: string /* React Window Title */,\n width?: number /* React Window Width */,\n height?: number /* React Window Height */,\n pluginData: any /* Your plugin's data to pass on first launch (or edited later) */,\n ENV_MODE?: 'development' | 'production',\n debug: boolean /* set based on ENV_MODE above */,\n logProfilingMessage: boolean /* whether you want to see profiling messages on React redraws (not super interesting) */,\n returnPluginCommand: { id: string, command: string } /* plugin jsFunction that will receive comms back from the React window */,\n componentPath: string /* the path to the rolled up webview bundle. should be ../pluginID/react.c.WebView.bundle.* */,\n passThroughVars?: any /* any data you want to pass through to the React Window */,\n}\n\n/**\n * Standardized response type for all request handlers\n */\nexport type RequestResponse = {\n success: boolean,\n message?: string,\n data?: any,\n}\n\n" }, { "path": "dwertheimer.Forms/src/support/fetchOverrides.js", "content": "// @flow\n\n// This file is only loaded and fetch is overridden if the import is enabled in the index file\n\n/**\n * FETCH MOCKING\n * This file is used to override the fetch function (calls to an external server) with a fake response\n * This allows you to test your plugin without having to have a server running or having to have a network connection\n * or wait/pay for the server calls\n * You can define your fake responses in this file or in a separate file (see below)\n * ...and when your code makes a fetch call to a server, it will get (an appropriate) fake response instead\n * You define the responses and the text that must be in the fetch call to yield a particular response\n * (see the mockResponses array below)\n */\n\n/**\n * 1) Import any of your fake responses that are saved as files here (or see below for defining them as strings)\n * The file should contain the exact response that the live server would return\n * You can save the response as a JSON file (like sampleFileResponse below) or as a string (like sampleTextResponse below)\n */\nimport sampleFileResponse from './fetchResponses/google.search-for-something.json' // a sample fake response saved as a JSON file\n\n// Other necessary imports\nimport { FetchMock, type FetchMockResponse } from '@mocks/Fetch.mock'\nimport { logDebug } from '@helpers/dev'\n\n/**\n * 2) Or you can define your fake responses as strings in this file:\n */\n// You could also just put all the fake responses here in this file\n// A little messier, but if you don't have very many responses, or they are small/strings, it's fine\nconst sampleTextWeatherResponse = `Nuremberg: ☀️ +9°F`\n\n// 3) So the mock knows when to send back which response, you need to define the match and response for each mock response\n// Fill in the match and response for each mock response you want to use\n// The match object hast following properties:\n// url: string - the url to match (can be a partial string, or can even be a string that includes regex)\n// optionsBody: string - a partial string or string/regex included in the POST body of the request to match (sent in options.body to fetch)\n// optionsBody is optional. If you don't need to match on the POST body (matching URL is enough), just leave it out\n// The response MUST BE A STRING. So either use a string response (like sampleTextWeatherResponse above) or\n// JSON.stringify your response object (like sampleFileResponse above)\nconst mockResponses: Array = [\n // the first mock below will match a POST request to google.com with the words \"search for something\" in the POST body\n { match: { url: 'google.com', optionsBody: 'search for something' }, response: JSON.stringify(sampleFileResponse) },\n // the mock below will match any GET or POST request to \"wttr.in/Nuremberg?format=3\" regardless of the body\n { match: { url: 'wttr.in/Nuremberg?format=3' }, response: sampleTextWeatherResponse },\n]\n\n/**\n * DO NOT TOUCH ANYTHING BELOW THIS LINE\n */\n\nconst fm = new FetchMock(mockResponses) // add one object to array for each mock response\nfetch = async (url: string, opts: FetchOptions) => {\n logDebug(`fetchOverrides.js`, `FetchMock faking response from: \"${url}\" (turn on/off in index.js)`)\n return await fm.fetch(url, opts)\n} //override the global fetch\n" }, { "path": "dwertheimer.Forms/src/support/fetchResponses/google.search-for-something.json", "content": "{\n \"someKey\": \"Some Value\",\n \"youGet\": \"The Idea\"\n}" }, { "path": "dwertheimer.Forms/src/support/performRollup.node.js", "content": "#!/usr/bin/node\n\n/**\n * FormView Rollup Script\n *\n * Builds development and production modes for:\n * - WebView bundle\n *\n * Usage:\n * node '/path/to/performRollup.node.js'\n *\n * Options:\n * --react Include the React core bundle\n * --graph Create the visualization graph\n * --watch Watch for changes\n */\n\nconst rollupReactScript = require('../../../scripts/rollup.generic.js')\nconst { rollupReactFiles, getCommandLineOptions, getRollupConfig } = rollupReactScript\n\n//eslint-disable-next-line\n;(async function () {\n const { watch, graph } = getCommandLineOptions()\n\n const rollupProms = []\n\n // FormView bundle configs\n const formViewRollupConfigs = [\n getRollupConfig({\n entryPointPath: 'dwertheimer.Forms/src/support/rollup.FormView.entry.js',\n outputFilePath: 'dwertheimer.Forms/requiredFiles/react.c.FormView.bundle.REPLACEME.js',\n externalModules: ['React', 'react', 'reactDOM', 'dom', 'ReactDOM'],\n createBundleGraph: graph,\n buildMode: 'development',\n bundleName: 'FormViewBundle',\n }),\n ]\n\n const formViewConfig = formViewRollupConfigs[0] // use only dev version for now\n rollupProms.push(rollupReactFiles(formViewConfig, watch, 'dwertheimer.Forms FormView Component development version'))\n\n // FormBuilderView bundle configs\n const formBuilderViewRollupConfigs = [\n getRollupConfig({\n entryPointPath: 'dwertheimer.Forms/src/support/rollup.FormBuilderView.entry.js',\n outputFilePath: 'dwertheimer.Forms/requiredFiles/react.c.FormBuilderView.bundle.REPLACEME.js',\n externalModules: ['React', 'react', 'reactDOM', 'dom', 'ReactDOM'],\n createBundleGraph: graph,\n buildMode: 'development',\n bundleName: 'FormBuilderViewBundle',\n }),\n ]\n\n const formBuilderViewConfig = formBuilderViewRollupConfigs[0] // use only dev version for now\n rollupProms.push(rollupReactFiles(formBuilderViewConfig, watch, 'dwertheimer.Forms FormBuilderView Component development version'))\n\n // FormBrowserView bundle configs\n const formBrowserViewRollupConfigs = [\n getRollupConfig({\n entryPointPath: 'dwertheimer.Forms/src/support/rollup.FormBrowserView.entry.js',\n outputFilePath: 'dwertheimer.Forms/requiredFiles/react.c.FormBrowserView.bundle.REPLACEME.js',\n externalModules: ['React', 'react', 'reactDOM', 'dom', 'ReactDOM'],\n createBundleGraph: graph,\n buildMode: 'development',\n bundleName: 'FormBrowserViewBundle',\n }),\n ]\n\n const formBrowserViewConfig = formBrowserViewRollupConfigs[0] // use only dev version for now\n rollupProms.push(rollupReactFiles(formBrowserViewConfig, watch, 'dwertheimer.Forms FormBrowserView Component development version'))\n\n try {\n await Promise.all(rollupProms)\n } catch (error) {\n console.error('Error during rollup:', error)\n }\n})()\n" }, { "path": "dwertheimer.Forms/src/support/rollup.FormBrowserView.entry.js", "content": "// use rollup to create the bundle of these included files\n// See directions in the performRollup.node.js file\n\n// Export FormBrowserView as WebView for the Root React Component\nexport { FormBrowserView as WebView } from '../components/FormBrowserView.jsx'\n" }, { "path": "dwertheimer.Forms/src/support/rollup.FormBuilderView.entry.js", "content": "// use rollup to create the bundle of these included files\n// See directions in the performRollup.node.js file\n\n// Even though we have named this FormBuilderView.jsx, it is exported as WebView because that\n// is what the Root React Component expects\n\nexport { WebView } from '../components/FormBuilderView.jsx'\n" }, { "path": "dwertheimer.Forms/src/support/rollup.FormView.entry.js", "content": "// use rollup to create the bundle of these included files\n// See directions in the performRollup.node.js file\n\n// Even though we have named this FormView.jsx, it is exported as WebView.jsx because that\n// is what the Root React Component expects\n\nexport { FormView as WebView } from '../components/FormView.jsx'\n" }, { "path": "dwertheimer.Forms/src/templateIO.js", "content": "// @flow\n//--------------------------------------------------------------------------\n// Template I/O Functions - Loading and saving template data from/to codeblocks\n//--------------------------------------------------------------------------\n\nimport pluginJson from '../plugin.json'\nimport { templateBodyCodeBlockType, templateRunnerArgsCodeBlockType, varsCodeBlockType, varsInForm, customCSSCodeBlockType, newNoteFrontmatterCodeBlockType } from './ProcessingTemplate'\nimport { getNoteByFilename } from '@helpers/note'\nimport { saveCodeBlockToNote, loadCodeBlockFromNote, replaceCodeBlockContent } from '@helpers/codeBlocks'\nimport { parseObjectString, stripDoubleQuotes } from '@helpers/stringTransforms'\n// DataStore is a global variable in NotePlan, no import needed\nimport { logError, logDebug, JSP } from '@helpers/dev'\nimport { showMessage } from '@helpers/userInput'\nimport NPTemplating from 'NPTemplating'\nimport { isDoubleEncoded, fixDoubleEncoded } from './utils/encodingFix.js'\n\n/**\n * Search DataStore.projectNotes for form templates (type: template-form)\n * This searches all project notes, not just @Templates/*\n * @returns {Array<{label: string, value: string}>} Array of {label: title, value: filename}\n */\nexport function getFormTemplateList(): Array<{ label: string, value: string }> {\n const allNotes = DataStore.projectNotes\n const formTemplates = []\n\n for (const note of allNotes) {\n const type = note.frontmatterAttributes?.type\n if (type === 'template-form') {\n const title = note.title || note.filename || ''\n if (title) {\n formTemplates.push({\n label: title,\n value: note.filename || '',\n })\n }\n }\n }\n\n // Sort by title\n formTemplates.sort((a, b) => a.label.localeCompare(b.label))\n\n return formTemplates\n}\n\n/**\n * Check for duplicate form titles and return duplicates if found\n * @param {string} templateTitle - The title to check for duplicates\n * @returns {Array<{label: string, value: string}>} - Array of duplicate templates (empty if no duplicates)\n */\nexport function findDuplicateFormTemplates(templateTitle: string): Array<{ label: string, value: string }> {\n if (!templateTitle || !templateTitle.trim()) {\n return []\n }\n\n const allTemplates = getFormTemplateList()\n const duplicates = allTemplates.filter((template) => template.label === templateTitle)\n\n // If there's more than one match, return all duplicates\n return duplicates.length > 1 ? duplicates : []\n}\n\n/**\n * Format form fields array as code block JSON (more readable format)\n * @param {Array} fields - The form fields\n * @returns {string} - Formatted JSON string\n */\nexport function formatFormFieldsAsCodeBlock(fields: Array): string {\n // Use JSON.stringify with indentation, but we'll clean it up for readability\n const json = JSON.stringify(fields, null, 2)\n // Replace quoted keys with unquoted keys where appropriate (for cleaner look)\n // Actually, let's keep it as standard JSON since it needs to be parseable\n return json\n}\n\n/**\n * Save form fields to template as code block\n * @param {string} templateFilename - The template filename\n * @param {Array} fields - The form fields array\n * @returns {Promise}\n */\nexport async function saveFormFieldsToTemplate(templateFilename: string, fields: Array): Promise {\n try {\n // Use generalized helper function\n const success = await saveCodeBlockToNote(\n templateFilename,\n 'formfields',\n fields,\n pluginJson.id,\n formatFormFieldsAsCodeBlock, // Format function\n true, // Show error messages to user\n )\n\n if (success) {\n const templateNote = await getNoteByFilename(templateFilename)\n if (templateNote) {\n // await showMessage(`Form fields saved to template \"${templateNote.title || templateFilename}\"`)\n logDebug(pluginJson, `saveFormFieldsToTemplate: Saved ${fields.length} fields to template`)\n }\n }\n } catch (error) {\n logError(pluginJson, `saveFormFieldsToTemplate error: ${JSP(error)}`)\n await showMessage(`Error saving form fields: ${error.message}`)\n }\n}\n\n/**\n * Save templateBody to template as code block\n * @param {string} templateFilename - The template filename\n * @param {string} templateBody - The template body content\n * @returns {Promise}\n */\n// Buffer buster padding for NotePlan's console\nexport async function saveTemplateBodyToTemplate(templateFilename: string, templateBody: string): Promise {\n try {\n logDebug(pluginJson, `saveTemplateBodyToTemplate: ENTRY - templateFilename=\"${templateFilename}\", templateBody length=${templateBody?.length || 0}`)\n let cleanedBody = templateBody || ''\n \n // IMPORTANT: Check if the content coming from React is already corrupted\n // This can happen if the data was corrupted when sent through the bridge\n // We should fix it before saving to prevent the corruption from persisting\n // Note: isDoubleEncoded and fixDoubleEncoded are already imported at the top of the file\n logDebug(pluginJson, `saveTemplateBodyToTemplate: About to check for double encoding`)\n if (cleanedBody && isDoubleEncoded(cleanedBody)) {\n logDebug(pluginJson, `saveTemplateBodyToTemplate: Detected corruption in content from React, fixing before save`)\n const fixed = fixDoubleEncoded(cleanedBody)\n if (fixed !== cleanedBody) {\n logDebug(pluginJson, `saveTemplateBodyToTemplate: Fixed corruption before save (original length=${cleanedBody.length}, fixed length=${fixed.length})`)\n cleanedBody = fixed\n }\n }\n \n // Log encoding info for debugging\n if (cleanedBody) {\n const hasUnicode = /[^\\x00-\\x7F]/.test(cleanedBody)\n if (hasUnicode) {\n logDebug(pluginJson, `saveTemplateBodyToTemplate: Saving content with Unicode characters (length=${cleanedBody.length})`)\n // Check for common Unicode characters that might get corrupted\n const hasEmDash = cleanedBody.includes('—')\n const hasEmoji = /[\\u{1F300}-\\u{1F9FF}]/u.test(cleanedBody)\n if (hasEmDash || hasEmoji) {\n logDebug(pluginJson, `saveTemplateBodyToTemplate: Content contains em-dash or emoji - monitoring for encoding issues`)\n }\n }\n }\n \n // Use generalized helper function (no formatting needed for templateBody, it's already a string)\n logDebug(pluginJson, `saveTemplateBodyToTemplate: About to call saveCodeBlockToNote`)\n await saveCodeBlockToNote(\n templateFilename,\n templateBodyCodeBlockType,\n cleanedBody,\n pluginJson.id,\n null, // No format function needed\n false, // Don't show error messages to user (silent operation)\n )\n logDebug(pluginJson, `saveTemplateBodyToTemplate: Successfully saved codeblock`)\n } catch (error) {\n logDebug(pluginJson, `saveTemplateBodyToTemplate: ERROR: ${error.message || String(error)}`)\n logError(pluginJson, `saveTemplateBodyToTemplate error: ${JSP(error)}`)\n }\n}\n\n/**\n * Load templateBody from template code block\n * @param {CoreNoteFields | string} templateNoteOrFilename - The template note or filename\n * @returns {Promise} - The template body content, or empty string if not found\n */\nexport async function loadTemplateBodyFromTemplate(templateNoteOrFilename: CoreNoteFields | string): Promise {\n try {\n // Use generalized helper function (no parsing needed for templateBody, it's already a string)\n const content = await loadCodeBlockFromNote(templateNoteOrFilename, templateBodyCodeBlockType, pluginJson.id, null)\n const loadedContent = content || ''\n \n // Check for and fix double-encoded UTF-8 issues\n // This can happen if content was saved with wrong encoding\n if (loadedContent) {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Loaded content (length=${loadedContent.length})`)\n \n // Check for specific corruption patterns we know exist in the file\n // Check both the literal characters and their character codes\n const hasKnownCorruption = \n loadedContent.includes('ðŸ') || \n loadedContent.includes('ô€') || \n loadedContent.includes('ô»') ||\n loadedContent.includes('') ||\n loadedContent.includes(String.fromCharCode(0xF0, 0x9F)) || // ðŸ as bytes\n loadedContent.includes(String.fromCharCode(0xF4, 0x8F)) || // ô€ as bytes \n loadedContent.includes(String.fromCharCode(0xEF, 0xBF, 0xBD)) //  as bytes (replacement character)\n \n if (hasKnownCorruption) {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Found known corruption patterns`)\n // Log a sample of corrupted content for debugging\n const sampleStart = loadedContent.indexOf('ðŸ') >= 0 ? loadedContent.indexOf('ðŸ') : \n loadedContent.indexOf('ô€') >= 0 ? loadedContent.indexOf('ô€') :\n loadedContent.indexOf('') >= 0 ? loadedContent.indexOf('') : -1\n if (sampleStart >= 0) {\n const sample = loadedContent.substring(Math.max(0, sampleStart - 10), Math.min(loadedContent.length, sampleStart + 30))\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Sample corrupted content: \"${sample}\"`)\n // Log character codes\n const charCodes = []\n for (let i = Math.max(0, sampleStart - 5); i < Math.min(loadedContent.length, sampleStart + 10); i++) {\n charCodes.push(`${loadedContent[i]}(${loadedContent.charCodeAt(i)})`)\n }\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Character codes: ${charCodes.join(', ')}`)\n }\n }\n \n if (isDoubleEncoded(loadedContent) || hasKnownCorruption) {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Detected double-encoded UTF-8, attempting fix`)\n \n // Log a sample of corrupted content before fix\n const corruptedSample = loadedContent.substring(\n Math.max(0, (loadedContent.indexOf('ðŸ') >= 0 ? loadedContent.indexOf('ðŸ') : \n loadedContent.indexOf('ô€') >= 0 ? loadedContent.indexOf('ô€') : \n loadedContent.indexOf('') >= 0 ? loadedContent.indexOf('') : 0) - 5),\n Math.min(loadedContent.length, (loadedContent.indexOf('ðŸ') >= 0 ? loadedContent.indexOf('ðŸ') : \n loadedContent.indexOf('ô€') >= 0 ? loadedContent.indexOf('ô€') : \n loadedContent.indexOf('') >= 0 ? loadedContent.indexOf('') : 0) + 20)\n )\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Before fix sample: \"${corruptedSample}\"`)\n \n const fixed = fixDoubleEncoded(loadedContent)\n \n // Log a sample of fixed content\n const fixedSample = fixed.substring(\n Math.max(0, Math.min(corruptedSample.length, fixed.length) - 5),\n Math.min(fixed.length, Math.max(corruptedSample.length, fixed.length) + 20)\n )\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: After fix sample: \"${fixedSample}\"`)\n \n // Check if corruption patterns are still present\n const stillHasCorruption = isDoubleEncoded(fixed) || \n fixed.includes('ðŸ') || \n fixed.includes('ô€') || \n fixed.includes('')\n \n if (fixed !== loadedContent) {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Fixed encoding issues (original length=${loadedContent.length}, fixed length=${fixed.length}, stillHasCorruption=${String(stillHasCorruption)})`)\n // Auto-save the fixed content to prevent future issues\n // But only if we loaded from a filename (not a note object)\n if (typeof templateNoteOrFilename === 'string') {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Auto-saving fixed content back to template`)\n await saveTemplateBodyToTemplate(templateNoteOrFilename, fixed)\n }\n return fixed\n } else {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: Detected double-encoding but fix did not change content`)\n if (stillHasCorruption) {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: WARNING - Corruption still present after fix attempt`)\n }\n }\n } else {\n logDebug(pluginJson, `loadTemplateBodyFromTemplate: No double-encoding detected`)\n }\n }\n \n return loadedContent\n } catch (error) {\n logError(pluginJson, `loadTemplateBodyFromTemplate error: ${JSP(error)}`)\n return ''\n }\n}\n\n/**\n * Load TemplateRunner args from template code block\n * These are processing variables that contain template tags and should not be in frontmatter\n * @param {CoreNoteFields | string} templateNoteOrFilename - The template note or filename\n * @returns {Promise} - The TemplateRunner args object, or null if not found\n */\nexport async function loadTemplateRunnerArgsFromTemplate(templateNoteOrFilename: CoreNoteFields | string): Promise {\n try {\n // Use generalized helper function to load and parse JSON\n const content = await loadCodeBlockFromNote(templateNoteOrFilename, templateRunnerArgsCodeBlockType, pluginJson.id, parseObjectString)\n return content || null\n } catch (error) {\n logError(pluginJson, `loadTemplateRunnerArgsFromTemplate error: ${JSP(error)}`)\n return null\n }\n}\n\n/**\n * Save TemplateRunner args to template code block\n * These are processing variables that contain template tags and should not be in frontmatter\n * @param {string} templateFilename - The template filename\n * @param {Object} templateRunnerArgs - The TemplateRunner args object to save\n * @returns {Promise}\n */\nexport async function saveTemplateRunnerArgsToTemplate(templateFilename: string, templateRunnerArgs: Object): Promise {\n try {\n // Use generalized helper function to save as JSON\n await saveCodeBlockToNote(\n templateFilename,\n templateRunnerArgsCodeBlockType,\n templateRunnerArgs || {},\n pluginJson.id,\n (obj) => JSON.stringify(obj, null, 2), // Format as JSON\n false, // Don't show error messages to user (silent operation)\n )\n } catch (error) {\n logError(pluginJson, `saveTemplateRunnerArgsToTemplate error: ${JSP(error)}`)\n }\n}\n\n/**\n * Save custom CSS to template as code block\n * @param {string} templateFilename - The template filename\n * @param {string} customCSS - The custom CSS content\n * @returns {Promise}\n */\nexport async function saveCustomCSSToTemplate(templateFilename: string, customCSS: string): Promise {\n try {\n // Use generalized helper function (no formatting needed for CSS, it's already a string)\n await saveCodeBlockToNote(\n templateFilename,\n customCSSCodeBlockType,\n customCSS || '',\n pluginJson.id,\n null, // No format function needed\n false, // Don't show error messages to user (silent operation)\n )\n } catch (error) {\n logError(pluginJson, `saveCustomCSSToTemplate error: ${JSP(error)}`)\n }\n}\n\n/**\n * Load custom CSS from template code block\n * @param {CoreNoteFields | string} templateNoteOrFilename - The template note or filename\n * @returns {Promise} - The custom CSS content, or empty string if not found\n */\nexport async function loadCustomCSSFromTemplate(templateNoteOrFilename: CoreNoteFields | string): Promise {\n try {\n // Use generalized helper function (no parsing needed for CSS, it's already a string)\n const content = await loadCodeBlockFromNote(templateNoteOrFilename, customCSSCodeBlockType, pluginJson.id, null)\n return content || ''\n } catch (error) {\n logError(pluginJson, `loadCustomCSSFromTemplate error: ${JSP(error)}`)\n return ''\n }\n}\n\n/**\n * Save newNoteFrontmatter to template as code block\n * @param {string} templateFilename - The template filename\n * @param {string} newNoteFrontmatter - The frontmatter content\n * @returns {Promise}\n */\nexport async function saveNewNoteFrontmatterToTemplate(templateFilename: string, newNoteFrontmatter: string): Promise {\n try {\n logDebug(pluginJson, `saveNewNoteFrontmatterToTemplate: Saving frontmatter (length=${newNoteFrontmatter?.length || 0})`)\n let cleanedFrontmatter = newNoteFrontmatter || ''\n \n // Check for double encoding issues\n if (cleanedFrontmatter && isDoubleEncoded(cleanedFrontmatter)) {\n logDebug(pluginJson, `saveNewNoteFrontmatterToTemplate: Detected corruption, fixing before save`)\n const fixed = fixDoubleEncoded(cleanedFrontmatter)\n if (fixed !== cleanedFrontmatter) {\n cleanedFrontmatter = fixed\n }\n }\n \n await saveCodeBlockToNote(\n templateFilename,\n newNoteFrontmatterCodeBlockType,\n cleanedFrontmatter,\n pluginJson.id,\n null, // No format function needed\n false, // Don't show error messages to user (silent operation)\n )\n logDebug(pluginJson, `saveNewNoteFrontmatterToTemplate: Successfully saved codeblock`)\n } catch (error) {\n logDebug(pluginJson, `saveNewNoteFrontmatterToTemplate: ERROR: ${error.message || String(error)}`)\n logError(pluginJson, `saveNewNoteFrontmatterToTemplate error: ${JSP(error)}`)\n }\n}\n\n/**\n * Load newNoteFrontmatter from template code block\n * @param {CoreNoteFields | string} templateNoteOrFilename - The template note or filename\n * @returns {Promise} - The frontmatter content, or empty string if not found\n */\nexport async function loadNewNoteFrontmatterFromTemplate(templateNoteOrFilename: CoreNoteFields | string): Promise {\n try {\n const content = await loadCodeBlockFromNote(templateNoteOrFilename, newNoteFrontmatterCodeBlockType, pluginJson.id, null)\n const loadedContent = content || ''\n \n // Check for and fix double-encoded UTF-8 issues\n if (loadedContent && (isDoubleEncoded(loadedContent) || loadedContent.includes('ðŸ') || loadedContent.includes('ô€') || loadedContent.includes(''))) {\n logDebug(pluginJson, `loadNewNoteFrontmatterFromTemplate: Detected double-encoded UTF-8, attempting fix`)\n const fixed = fixDoubleEncoded(loadedContent)\n if (fixed !== loadedContent && typeof templateNoteOrFilename === 'string') {\n logDebug(pluginJson, `loadNewNoteFrontmatterFromTemplate: Auto-saving fixed content back to template`)\n await saveNewNoteFrontmatterToTemplate(templateNoteOrFilename, fixed)\n return fixed\n }\n return fixed\n }\n \n return loadedContent\n } catch (error) {\n logError(pluginJson, `loadNewNoteFrontmatterFromTemplate error: ${JSP(error)}`)\n return ''\n }\n}\n\n/**\n * Update receiving template with field keys from form fields\n * Adds template variables for each field key at the end of the template\n * @param {string} receivingTemplateTitle - The title of the receiving template\n * @param {Array} fields - The form fields array\n * @returns {Promise}\n */\nexport async function updateReceivingTemplateWithFields(receivingTemplateTitle: string, fields: Array, parentSaveId?: string): Promise {\n const updateId = parentSaveId ? `${parentSaveId}-UPDATE` : `UPDATE-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n try {\n // Strip double quotes from the template title at the start\n const cleanedReceivingTemplateTitle = stripDoubleQuotes(receivingTemplateTitle)\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: ENTRY - Starting for template \"${cleanedReceivingTemplateTitle}\"`)\n\n // Find the receiving template by searching all notes (not just template folder)\n // Search all project notes for forms-processor type templates\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Searching ${DataStore.projectNotes.length} project notes...`)\n let receivingNote: ?TNote = null\n const allNotes = DataStore.projectNotes\n for (const note of allNotes) {\n const noteType = note.frontmatterAttributes?.type\n if (noteType === 'forms-processor' || noteType === 'template-runner') {\n const noteTitle = stripDoubleQuotes(note.title || '')\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Checking note \"${noteTitle}\" (type=\"${noteType}\")`)\n if (noteTitle === cleanedReceivingTemplateTitle) {\n receivingNote = note\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Found processing template \"${cleanedReceivingTemplateTitle}\" at \"${note.filename}\"`)\n break\n }\n }\n }\n\n // Fallback: try getTemplateList if direct search didn't find it\n if (!receivingNote) {\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Direct search didn't find template, trying getTemplateList`)\n const templateList = await NPTemplating.getTemplateList('forms-processor')\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Found ${templateList.length} forms-processor templates`)\n const receivingTemplate = templateList.find((t) => {\n // Strip double quotes from both sides for comparison\n const templateLabel = stripDoubleQuotes(t.label)\n return templateLabel === cleanedReceivingTemplateTitle\n })\n\n if (receivingTemplate) {\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Found template in getTemplateList, loading note...`)\n receivingNote = await getNoteByFilename(receivingTemplate.value)\n }\n }\n\n if (!receivingNote) {\n logError(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Could not find receiving template \"${cleanedReceivingTemplateTitle}\"`)\n // Don't show error message or throw - just log and continue\n return\n }\n \n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Found receiving note: \"${receivingNote.filename}\", type=\"${receivingNote.frontmatterAttributes?.type || 'none'}\"`)\n\n // Extract fields that have keys (only fields that have keys, excluding separators, headings, templatejs-block, and other display-only fields)\n const fieldsWithKeys = fields.filter(\n (f) =>\n f.key &&\n f.type !== 'separator' &&\n f.type !== 'heading' &&\n f.type !== 'templatejs-block' &&\n f.type !== 'markdown-preview' &&\n f.type !== 'button' &&\n f.type !== 'table-of-contents' &&\n f.type !== 'comment',\n )\n\n logDebug(pluginJson, `[${updateId}] updateReceivingTemplateWithFields: Found ${fieldsWithKeys.length} fields with keys to add`)\n\n // Build the code block content: varsInForm followed by lines like \"