forgetti

• Moved to Biome for better linter/formatter stuff.
• Fix generated templates to have better dev-only names

What's Changed

• Separate $$ref from $$cache by @SukkaW in https://github.com/lxsmnsyc/forgetti/pull/30
  • Pretty big internal change, so I have to make a minor release. This change separates ref handling from cache management (instead of useRef for all, useRef is only now used for refs, the rest uses useMemo). This change is pretty much aligned to React's behavior e.g. Server Components support and proper cache management through useMemo

Full Changelog: https://github.com/lxsmnsyc/forgetti/compare/v0.6.2...v0.7.0

• Change cache generation to use useRef instead of useMemo https://github.com/lxsmnsyc/forgetti/commit/e288b040b2c1580a3827c8680b1563472fa20455
  • React may potentially free up useMemo references in a scheduled way (think of LRU). useRef doesn't have this kind of behavior
• Add auto-memoization runtime for JSX https://github.com/lxsmnsyc/forgetti/commit/1645c4d0f2f524089044d9dc539728f6e2f6ba89
  • This allows components of the respective framework to re-render only when necessary.
• Change preset config API https://github.com/lxsmnsyc/forgetti/commit/d14ccd9cbacd2729e552ca1e4e47cf4c3613e649
• Deprecate optimizeJSX config https://github.com/lxsmnsyc/forgetti/pull/23/commits/27093b79fe00703685d811b8a8c60662427c18c8
  • Defining runtime.memo in the preset will automatically generate JSX optimization

This release adds a new optimization process on top of the current memoization process. Forgetti will now run the transform as follows:

1. Pre-inlining
   Variable declarations that can be inlined are recursively inlined. This allows the memoization step to know the largest possible constant expression and cache it in a single entry.
2. Expansion
   Assignment expressions and hooks had issues in optimization in 0.4.x. With the expansion step, these expressions are now moved before the parent statement path, and ensures that these expressions are called out of their rules.
3. Simplify
   Some expressions that are guaranteed to have literal evaluation are evaluated in compile-time.
4. Memoization
   This is where the old core runs. A major difference compared to 0.4.x now is that the memoization process will test first if the entire expression is a "constant" to save more cache slots. Previously, it would subdivide naively, generating unnecessary amount of caching.
5. Post-inlining
   Same process as step 1. This allows generated variables to be inlined so that there's less output.

Changes

• Fix #14 by @SukkaW in https://github.com/lxsmnsyc/forgetti/pull/15
• Fix nested hook call by @SukkaW in https://github.com/lxsmnsyc/forgetti/pull/18
• Fix hook expr optimization and add optimization steps by @lxsmnsyc in https://github.com/lxsmnsyc/forgetti/pull/20
• Add cache to isConstant and isContainsHook by @SukkaW in https://github.com/lxsmnsyc/forgetti/pull/19
• Feat: accept exclude components options by @SukkaW in https://github.com/lxsmnsyc/forgetti/pull/17
• 0.5.0 by @lxsmnsyc in https://github.com/lxsmnsyc/forgetti/pull/21

Full Changelog: https://github.com/lxsmnsyc/forgetti/compare/v0.4.7...v0.5.0

• Fix constant expressions to use logical OR assignment shorthand https://github.com/lxsmnsyc/forgetti/commit/6f3b926dfe215763c1452b6df09162cda2636f6e
• Add support for throw statements https://github.com/lxsmnsyc/forgetti/commit/37c1d3c9d610f7da862bd970c60b21b1ac42e586
• Add support for labeled statements https://github.com/lxsmnsyc/forgetti/commit/4df469f416c006289c8c94c28cfb6ad1537fe342
• Fix subsequent let to be merged as a single declaration https://github.com/lxsmnsyc/forgetti/commit/5d224a4d36330819d6337582fcd0fd0c997da01d
• Fix useMemo and useCallback tracked dependency
• Improve docs

Full Changelog: https://github.com/lxsmnsyc/forgetti/compare/v0.2.0...v0.3.0

• Now auto-memoizes useRef

import { useRef } from 'react';
function Example(props) {
  return useRef(props.value);
}
// Compiles into
import { useMemo as _useMemo } from "react";
import { useRef } from 'react';
function Example(props) {
  let _c = _useMemo(() => new Array(1), []);
  let _v = _c[0] || (_c[0] = {
    current: props.value
  });
  return _v;
}

Full Changelog: https://github.com/lxsmnsyc/forgetti/compare/v0.1.1...v0.2.0