CHANGELOG.md

4.3.5 (2025-01-02)

Bug Fixes

• tags: different object types on query.pages() fails to render (1c76ff8), closes #59

4.3.4 (2024-10-10)

Bug Fixes

• context: add child uuids to context of block (9568758)
• tags: query.table doesn't work (fe9a2d9), closes #57

4.3.3 (2024-09-21)

Bug Fixes

• core: global issue that breaks all context-related template tags (6401768)

4.3.2 (2024-09-18)

Bug Fixes

• views: display mode for different div-blocks (6502ad4)

4.3.1 (2024-09-16)

Bug Fixes

• views: css for displaying in breadcrumbs (4154907)

4.3.0 (2024-09-15)

Bug Fixes

• context: full overview (6ec454a)
• core: sync filtering value for ... and { return ...} ways (4eb9ff4)
• tags: dev.tree.sync improvements (352b4ba)
• tags: display all template tags on c.tags (bfedf9d)
• ui: css colors for default white & black logseq themes (bb2924c)
• ui: template / view insertion modes (986f24f)

Features

• commands: template buttons (598e21b)
• tags: live views via dev.tree.sync (748aa66)

4.2.2 (2024-09-02)

Bug Fixes

• remove race condition whe positioning cursor in selection mode (34e4a80)

4.2.1 (2024-08-27)

Bug Fixes

• add new notification for users about version release (7179eb7)

4.2.0 (2024-08-27)

Bug Fixes

• core: do not parse ... when there is new line inside (fe4a2be)
• core: fail on returning null or undefined in template body (f40078c)
• forgotten lines (fc88613)
• linter warnings (011147f)
• tags: dev.context.page fix for different object structures (59d17e1)
• tags: layout.args for boolean values (f0bd749)
• typescript errors & tests (e7ca1a7)
• wrong import (5f0d181)

Features

• core: a way to skip unwrapping code block (with added space after ```) (90c5940)
• core: add .ignore flag to parsing options (e1ec3d4)
• core: block rendering of sub-tree with return undefined statement (62c9e76)
• core: don't reqire edit mode or selection mode for templates with shortcuts (80b197b)
• core: render current block slash-command (ba52e58)
• notify user about frocing insertion as view or template (6f2a609)
• refactor cursor positioning after insertion (4266e99)
• rendering: instant templates insertion (a0320c9)
• shortcuts for templates (b75db7a)
• sync changed shortcuts for template (afd024d)
• tags: blocks.actions.update (050e2e6)
• tags: blocks.edit (12077a1)
• tags: blocks.selected (e838d84)
• tags: blocks.skip (fb30043)
• tags: dev.color improved (e38b259)
• tags: template tags: sleep, dev.cssVars, cursor.selection (aa92538)
• try to keep cursor position for render-this-block command (e1e32cd)
• ui: show template shortcut in the ui list (6d5b3da)

4.1.0 (2024-07-22)

Bug Fixes

• inserting: update props of current block with props from head block (5be70b6)
• tags: block.uuid return real uuid for template head block (no need to replace refs) (5cecf97)
• tags: blocks.uuid for view rendering (9c75045)
• tags: dev.get usage of negative index (f8ff2d6)
• tags: query.table corner cases (e9544c4)
• views: rendering of ref to unexisted block (3d8770f)

Features

• args: mixed named & positional access to args (6daec59)
• query for pages: filter by journals (fa3400f)
• query language: .valueType filter (106a38a)
• tags: array function .zipWith (946f666)
• tags: blocks.uuid for future block UUID (42c7332), closes #46
• tags: query.table & query.table_ (b6ed240)
• tags: query.table: accessing custom fields & sorting by custom field (2eec704)
• tags: setUUID support for spawned blocks (d97f66b)

4.0.0 (2024-07-11)

Bug Fixes

• context: review c.config contents (4938926)
• core: cursor positioning bug with empty spaces before and after cursor marker (969cb87)
• core: cursor positioning find order (61d572c)
• core: cursor positioning when including templates: corner case for head (9832fa1)
• core: order of code execution: as block follows (a753c9d)
• docs: scrolling to anchor bug (334fa2d)
• docs: toc scroll highlighting bug (51a694d)
• escaping named args while transcluding templates (1482583)
• improve nacro mode pattern matching (5ea6083)
• insertion ui: losing focus on tab key (d6bf556)
• propper work of escaping regex (55792b2)
• query: filtering by value for includes, starts with & ends with operations (7f253ce)
• remove autoselection of syntax (76499f7)
• remove template-list-as and template-usage properties when template-including-parent is YES (1ae4566), closes #39
• rendering template when user return custom value within template (68e1f74)
• sometimes dumping context variables fails to render in logseq (fba29f1)
• tags: changing default value for .countby & .groupby (b3d8262)
• tags: complete review of include and layout template tags + docs (26dd906)
• tags: dev.dump and context objects displaying issues with spaces (26fea51)
• tags: dev.get now could return an array of strings (041851d)
• views: fix support of highlighting text (2ea6445)
• views: improve compilation of logseq markup to HTML (7d55f87)

Build System

• make version increment (3918f27)

Features

• change ui appearence according to sellected blocks (991b7e6)
• core: cross-block scoped js vars (446c413)
• core: inserting new blocks at runtime (31b0bad)
• core: make returnin values from templates look pretty (0200fbe)
• core: passing execution environment back to template tags (b27cc05)
• core: pretty printing values returning from templates (955c66e)
• core: set cursor position (16a9b36), closes #13
• docs: scroll rigth toc sidebar according to current view (c076344)
• macro mode (f258c02)
• prototype of Action template (6de9754)
• query: .referenceCount filter (c49e89c)
• support locales based on logseq settings (cc90aba), closes #40
• tags: array.countby & wrap to object option (c1f62af)
• tags: add dev.tree.* namespace & dev.tree.getNode template tags with docs (bf3588d)
• tags: added cursor() template tag to position cursor from {...} (4c83f2c)
• tags: dev.compileMarkup, dev.cleanMarkup template tags (a4a33d3)
• tags: dev.dump template tag (d51fbeb)
• tags: improve query.refs.pages & query.refs.journals to retrieve block props (5858a4d)
• tags: include.veiw, include,inlineView and lazy param for include & layout (b315c6c)
• tags: layout.args (ced84e1)
• tags: new template tag date.fromJournal (5d43b87)
• tags: now layout.args could have specified values for arguments (58b5a8f)
• tags: parse.links, parse.refs, dev.refs template tags (f9b75f6)
• tags: review dev.get template tag (c95fe4e)
• tags: spawn and append whole tree template tags (d8b5857)
• views: resolve page aliases when clicking on refs (c2eeff8)

BREAKING CHANGES

• see change log for details

3.4.0 (2024-02-20)

Bug Fixes

• allow return from code block {...} value of any type (ab82608)
• bug when logseq hidden properties prepend (63d275c)
• coercing property args to bool only with ? ending (b5c2503)
• dayjs timezone plugin (aa94272)
• displaying c.tags.date context (ccfec09)
• query: bug with query cloning (af38b2a)
• remove old css var (b01794f)
• remove protected mode for ... (8becb07)
• tags: empty template tag & add docs (9a3921e)
• tags: when template tag & add docs (3b83f1d)
• views: escaping values for views rendering (985454f)
• xss improvements while parsing (089732b)

Features

• add start of week setup for dayjs (4b58b49)
• added c.tags context to get all available tag utils and its signatures (212e5ed)
• allow usage of async/await in custom JS templates (0a860b7)
• args: coercing arg-properties with «?» to bool (444b2fc)
• context: add file path for pages (9853f8e)
• engine: improve template errors readability (35e2b60)
• notifications: replace release notification (1fac518)
• support coercing to bool in template args (7405577)
• syntax: out & outn functions to output info within {...} (9b4ec63)
• syntax: new syntax @... for date.nlp & fix date.nlp bug (5b3d4b5)
• tags: bool template tag (5a72905)
• tags: dev.uuid template tag & docs (5ce563f)
• tags: include & layout template tags (ad452d9)
• tags: query.pages().getSample(n) interface (ca52289)
• tags: add dev.context.page & dev.context.block utils to transform API Entity to Context item (ed942e2)
• tags: add query.refs namespace with .count, .journals, .pages (4813da2)
• tags: add walkTree template tag (4be1437)
• tags: dev.include template tag to include templates into each other (7a031d8), closes #18
• tags: helpful array functions: unique, zip, sorted, groupby (e7b24ec)
• tags: query.pages template tag for simple query building (fix #20) (2209481)
• tags: query.pages: inverted operations, shortcuts, title operations, prevent vars dublication (aae442c)
• tags: template tag tag & propper rendering of tags in views (57008ee)
• ui: order with respect the numeric characters (379fdf9)

3.3.0 (2023-11-29)

Bug Fixes

• notifications: change appearing time of messages from rendering templates (91e4faf)

Features

• support radix colors (2bc82c2)

3.2.1 (2023-11-16)

Bug Fixes

• notifications: macro warning notification accidental appearing (e06179c)
• remove notification about prev release & update insert warning notification (7734351)

3.2.0 (2023-11-08)

Bug Fixes

• forgotten check for cleaningMarks from template-usage (66ac683)
• remove backwards compatibility for old page syntax: {{renderer :template, wiki, —, ru}} (91b7aaa)
• replace macro checking with an informational message to user (36f975e)
• ui: always hightlight the first result (616d102)
• ui: change default shortcut (3ca5313)
• ui: exit editing block before jumping to template (a866ab7), closes #23
• ui: filter results bug (b883ea1)
• ui: insert highlighted name bug (1b232ee)
• ui: unnecessary qoutes in usage with several args (414919c)
• ui: update default font (7764d34)
• ui: wrap template name with qoutes when comma is present (eb0327c)

Features

• "Copy as ..." commands for page (e515336)
• add fast carriage positioning without api (cba9c27)
• generalize template-usage & template-list-as handling; support template-usage in "Copy as ..." (78fb437)
• notification: add notification about new UI (7f82a1d)
• ui: add "Preparing..." message & remove "hidden" label (6a07d19)
• ui: add content insertion logix (5717540)
• ui: add data preparation and labels (85241d3)
• ui: add foter with shortcut hints and platform-dependant behaviour (0e56d60)
• ui: add page name (0727316)
• ui: add searching by template page name fix #23 (593759c)
• ui: add template-usage property support (fbcf99b)
• ui: change sorting: by page then by template name (c11e409)
• ui: fuzzy search (13d40c4)
• ui: hide ui on mouse missclick (6fe984f)
• ui: highlight with keyboard and mouse logic (bb2b1f1)
• ui: insertion view draft (98b4e84)
• ui: insertion view styles (8147bd8)
• ui: live showing hidden items with alt/opt key (8a709b6)
• ui: loading of templates data (5ed57b7)
• ui: merge insertion of templates and views (6219469)
• ui: no results case (54abc7b)
• ui: open template block with shift (68c7d9a)
• ui: replace old insert command (a56c445)
• ui: scrolling (60b98d3)
• ui: smart selection after insertion with selected block (c67d4c7)
• ui: smart selection after insertion within editing block (664cc07)
• ui: special search case for spaces only (efb6abd)
• utils to get css vars from main frame (835ead0)

3.1.1 (2023-08-23)

Bug Fixes

• rendering: render page as a template (54976ed)

3.1.0 (2023-08-23)

Bug Fixes

• rendering: inserting child blocks of first child node in non-inclusion parent mode (a8bec22), closes #26

Features

• tags: support label param for ref (78ab990)

3.0.0 (2023-08-14)

Bug Fixes

• do not replace text if rendered template is empty (8486445)
• engine: <% current page %> stands for current page, not for c.page (af8156a)
• engine: add fool-protection for inline templates to prevent tags intersection (b64136f)
• engine: handling quotes in protections code (55a6af9)
• engine: qoutes handling in corner cases (6ca7be5)
• engine: trimming right whitespaces overriding (6e975cc)
• fix link to docs in notification about :macros usage (7003a07)
• propper c.template.name in case of accessing template by property name (5738a47)
• propper render of c.identity (1bfb522)
• remove css rule for macros (dbf38c1), closes #22
• rendering c.args (fbb3755)
• rendering: "template not found" when template is a first block of a page (e022a56)
• rendering: prevent recursive rendering (41458e1)
• tags: empty template tag null value should be fallen back (a2a225c)
• tags: return null for empty template tag (5c707a4)

Features

• add isoWeek plugin for dayjs (18196bf)
• args: positional only args with syntax c.args.$1 (52f7caf)
• command: command to convert template to a new syntax (daf7ea9)
• context: added page.namespace (73ba0bd)
• engine: autodetecting of syntax style (ef6d611)
• engine: render basic standard templates syntax (d61cb53)
• engine: render standard templates syntax with nlp (53d619d)
• engine: support new syntax for rendering tags (ad75616)
• notifications: add notification about new syntax; notify only old users (c900fa4)
• provide delayed option for views (3c1bb84)
• tags: date.nlp template tag (eef9e01)

BREAKING CHANGES

• engine: before: { x }, after: x

2.6.0 (2023-05-08)

Features

• add option to delay rendering of :template command :delay-until-rendered (51e902d)
• context: add c.currentPage & c.currentBlock (5444b7a)

2.5.1 (2023-04-13)

Bug Fixes

• views: code block compiling (7e62d8c)

2.5.0 (2023-04-13)

Features

• inline views: quickly create inline views in one edit (592a1f1)
• views: support macros compiling to html (a6a99e1)

2.4.0 (2023-04-11)

Bug Fixes

• args: proper properties overriding with args (98db356)
• html escape rendering error messages (ad6665a)
• template tags: improve assets detection & fix dev.get (479e388)
• views: render image link only when "!" specified (2f53eb2)

Features

• args: default values for args via template block properties (7161e1d)
• args: specify false value for argument (2937074)
• code block parsing & assets protocol supporting for template tags (b75ff38)
• context: special :block arg to replace c.block context variable (behaves like a :page) (d96640f)
• support @-syntax for getting properties with dev.get (3b0d95a)
• template tags: added dev.get to access specified path for object (3b5c680)
• template tags: added parseLinks (c83bb22)

2.3.0 (2023-04-05)

Features

• context: add extended graph info to c.config context var (d15c817)
• context: added c.identity.slot & c.identity.key to use with css inside the view (56fad04)
• template tags: when now could reference its condition obj (2df9944)
• template tags: added dev.color (7564a77)
• template tags: added when, dev.parseMarkup, dev.toHTML, dev.asset & update ref (03f5f86)
• unwrap «```» before rendering any block (0e7d1cd)
• views: support special assets url schema & links to images (f51b31b)

2.2.0 (2023-04-02)

Bug Fixes

• args: args are space sensitive in :template command (30600eb), closes #3
• logseq reference with provided options bad parsing (d88d37f)
• template name is uuid whem there is no template property in block (982d984)
• views: single block view doesn't display (2839d2f)

Features

• args: mask undefined named args with empty string (7614029)

2.1.0 (2023-04-01)

Features

• args: simple notation of named arg (to set bool) (ce33431)

2.0.0 (2023-04-01)

Bug Fixes

• check is rendering occurs from inside the macro (320f059)
• error message not showing when template name is wrong (58d8168)
• handle in-macro with missed block uuid (be08ff1)
• multi block rendering view problem with paragraphs (b5b7947)
• preserve block uuid on copy command (8f2af89)
• restrict plugin work inside the macro (cfe9438)
• send single-char pages to context (6668df9)

Features

• args: removed positional page context argument (fb79c1c)
• beutify error messages for user (a554ea9)
• notify: breaking changes user notification (c8cd377)
• template-view: :template-view command& replaces the macros system (7023e5a)
• views: add insert template view command (6bdf913)
• views: block ref displaying (1435e24)
• views: compile block references labels to html & make all compilation async (07552d2)
• views: compiling block tree to html view (bdff1c5)
• views: compiling external links (d4e4c1c)
• views: make refs clickable (ada2e27)
• views: parsing mldoc ast to compile rendered view to html (65fe95d)
• views: restrict compiling by nesting levels (bfd5992)
• views: show or hide ref brackets based on logseq config (f98818c)
• views: special case for non-existent block (d5ba14b)
• views: support additional logseq markup syntax (caa21cf)

BREAKING CHANGES

• args: Args auto-shifts for the empty first arg case: {{renderer :template, wiki, —, ru}} → {{renderer :template, wiki, ru}}. But for non-empty — template behavior would be broken: {{renderer :template, wiki, [[Logseq]], ru}} fills c.page with current page instead of [[Logseq]]. And first positional argument would be [[Logseq]], not "ru". Manual change required: {{renderer :template, wiki, :page [[Logseq]], ru}}

1.5.0 (2023-03-22)

Bug Fixes

• parsing properties (ccaee78)

Features

• template arguments: use arguments inside the templates to customize rendering behaviour (9ac9247)

1.4.0 (2023-03-21)

Bug Fixes

• clearing template from system props (3873243)
• order of rendered blocks & bubling up wrong sibling (94fc7a8), closes #1

Features

• replace only renderer macro during template rendering (52b074b)

1.3.0 (2023-03-20)

Bug Fixes

• properties deletion; review properties erasing (8764609)

Features

• context: level value & access to current page (161f63e)
• do not override block content on /-command inserting (bcf8270)
• smart copy code context menu for template blocks (fd45cb1)
• template tags: parentBlock & prevBlockcan be used to create refs; bref deprecated (014ccbf)

1.2.0 (2023-03-13)

Bug Fixes

• added missed props context variable for page (a0a56de)
• clear page properties in case of template rendering from page (ba27389)
• date template tags refreshing (7e42d92)

Features

• context command to render block (b8aa85a)

1.1.0 (2023-03-08)

Bug Fixes

• inserting renderer command (1f3f1c9)
• removing id property to prevent fake parent bug (008d2e1)

Features

• added possibility to override template-including-parent property when calling render (ec0a5e1)
• render page as a template rework & scan-rendering context variables (16266dd)
• render page as template (832fc5d)
• rendering non-template block incuding parent by default (979693e)

1.0.3 (2023-03-06)

Bug Fixes

• review package structure — move icon to top-level (87eaa70)

1.0.2 (2023-03-06)

Bug Fixes

• update tutorial and trigger build (c9156df)

1.0.1 (2023-03-06)

Bug Fixes

• return image for installation instructions (01ec7f4)

1.0.0 (2023-03-06)

First public release

Features

• add LogseqReference type to recognize any page or block refs (238273e)
• universal reference to template (0064e7b)