Repository navigation
docs: point at the hosted endpoint, and at what it cannot do - #14
Merged
Merged
Conversation
A reader who wants a mark in a README should not have to write a program to get one, and there is now an endpoint that serves them. It runs this code: the deploy compares every response against a go run of the same version, byte for byte, and refuses to ship on a disagreement. What it cannot do is worth as much as what it can. The deployment has ten milliseconds of CPU per request, which SVG does not notice — its cost is the renderer's own maths and is flat in the requested size — and which PNG feels immediately, because rasterising and deflating cost the square of the edge length. Hence measured per-renderer ceilings, and hence flowfield being absent from PNG entirely: its streamline integration costs the same at sixteen pixels as at five hundred. Said plainly here because the alternative is someone concluding the library has those limits. It does not. That distinction is the reason to depend on a library with no dependencies rather than on somebody's endpoint. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SU6ycrqMbQ8AVxzxYgdC5C
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a Hosted marks section between Output and Gallery.
Covers the endpoint (
api.blazon.build/v1/mark/{version}.{svg|png|txt}), that it runs this code — the deploy compares every response against ago runof the same version byte for byte — and the limits of the deployment as distinct from limits of the library:flowfieldis not served as PNG at all: its streamline integration costs the same at sixteen pixels as at five hundred, so no size fits.Stated explicitly so a reader does not conclude the library has those limits.
blazon.PNGhas no ceiling and excludes no renderer.🤖 Generated with Claude Code
https://claude.ai/code/session_01SU6ycrqMbQ8AVxzxYgdC5C