That would allow for platform implementations to diverge though and experiment before standardizing common functionality. This is starting to feel like a web standards proposal now 🤔

…Namespaces could help here if we failed builds when unimplemented directives are found. Some directives might get standardized and moved to the global namespaces.

This reminds me of vendor prefixes in CSS though, so I’m a bit hesitant.

In a monorepo, multiple frontends could be deployed on different platforms. In this case the lines get blurry and it’s unclear what code is and isn’t portable between projects. The code deploys fine, but doesn’t behave the same…

Yeah, namespaces could help with that. Like “vercel: use workflow”. Tanner mentioned this too, but that doesn’t fully solve the problem because it’s still up to everyone to cooperate. Better than just all global though.

Versioning is a great point! Haven’t even considered that yet

I think we do need to solve for some of the issues Tanner raised though. Like having an ergonomic syntax for options and being able to differentiate between language and platform-/framework-specific annotations. If we can solve that with directives, great, but I haven’t seen any good proposals yet

That’s a fair point. Counter argument though: we already have restrictions around placement of hooks even though they’re just regular functions and we use lint rules to enforce placement. We could do the same here.

What concerns me most about directives is it’s not clear which ones are a language feature vs a platform/framework feature, and if you move your code between platforms that both have “use workflow” but diverging implementations, then things can break unexpectedly even though the code is identical.

Hmm, since decoratiors aren’t official, what about tagged template literals?

vercel`workflow(options)`;
function sendEmail() { … }

I envy your result. The lower the score, the more intact your sanity is 🤪

Or would it work with @convex.dev (and other sync engine tools) for more efficient syncing of local data?