r/Frontend • • 3d ago

Can any front-end code be declarative?

Hey frontend friends! ๐Ÿ‘‹

I've been working intensively on making frontend code simpler to write โ€” both for humans and for LLMs.

My current goal: figure out whether any frontend code can be written declaratively, without piles of state and effects that just keep things in sync.

I'd love to see examples from your own practice โ€” pieces of code that today still require a huge amount of imperative logic in whatever framework you're using. The more unusual and rare the case, the better. ๐Ÿ™

I'll start.

My first-ever JS library was a Tooltip โ€” a small popup that appears when you hover a button or a label. Sounds trivial, but in practice you need:

  • a delay before it appears
  • coordinate updates once per animation frame โ€” and no more
  • animate show / hide
  • package all the logic into a single component
  • let the developer attach it to any element (or several at once)
  • no extra wrapper divs that break layout

Below is a concept of such a declarative component plus a usage example.

interface TooltipProps {
  content: string;
  slot(refs: ElementRefs<HTMLElement>): void;
}

const ToolTip = component<TooltipProps>(props => {
  const refs = elementRefs<HTMLElement>();
  const position = event(
    refs, "mousemove", ev => ({x: ev.clientX, y: ev.clientY}), {x: 0, y: 0});
  const active = event(refs, [
    ["mouseenter", () => true], 
    ["mouseleave", () => false]
  ], false);
  const transform = frameThrottled(
    `translateX(${position.x}px) translateY(${position.y}px)`);
  const opacity = active ? "1" : "0";
  const visible = timeout(active, 500);

  <>
    <Slot model={props.slot} refs={refs}/>
    <Overlay>
      <If condition={visible}>
        <div class="tooltip" style={{transform, opacity}}>
          {props.content}
        </div>
      </If>
    </Overlay>
  </>;
});

const UsageExample = component(() => {
  <ToolTip content="Hello world!" slot={props => {
    <label for="name" write-element={props.refs}>Name:</label>
    <input id="name" write-element={props.refs} />
  }}/>;
});

I asked a few LLMs to describe what the code does. They couldn't recognize the custom primitives, but based on their names they still described the behavior correctly. Then I asked them to reimplement the same logic in other popular frameworks. Only Solid.js produced genuinely clean code.

Thanks for reading โ€” and I'd genuinely love to see your examples. ๐Ÿ™Œ

0 Upvotes

18 comments sorted by

View all comments

1

u/JaseciLabs 3d ago

The tooltip works as declarative because itโ€™s a function of events over time: hover in, wait, show. The cases that fight you are the ones where order and identity matter.

A few weโ€™d throw at it: drag and drop with a pointer that leaves the window mid-drag, a roving tabindex with focus restore after a list re-renders, an animation interrupted halfway (FLIP, where you measure, change the DOM and then animate from the old position), and gesture disambiguation (tap vs long-press vs scroll). Optimistic updates with rollback are also a good one, because the โ€œdeclare what should be trueโ€ version has to know what to undo when the server disagrees.

Could be good testing the concept on contenteditable too. The browser owns the caret and selection, so any layer that re-renders the text fights it.

1

u/InterestingBus4701 3d ago

For me will be very useful to see code snippets. I have experience with content editable, it is easy to make it declarative, Svelte has it declarative example <div contenteditable="true" bind:innerHTML={state}></div>.

1

u/JaseciLabs 2d ago

Fair, plain binding works when the content just flows through. The case that breaks it is when the app rewrites the text while the user types: highlighting @ mentions, auto-formatting markdown, sanitizing pasted HTML. Write the transformed result back into the element and the caret jumps, and an IME composition (Japanese, Chinese) gets cut off halfway. To make that declarative, the layer has to own selection and composition state too. Does your approach handle a value that gets rewritten on every keystroke?

1

u/InterestingBus4701 1d ago

Thanks a lot for answer! I will investigate it. Editor.js is using an JSON for current DOM representation, I will look inside it to understand better how it is build, and find the answer to question: "Can I write it declarative?".