Package sass.embedded_protocol

Class EmbeddedSass.OutboundMessage.CanonicalizeRequest.Builder

  • All Implemented Interfaces:
    Message.Builder, MessageLite.Builder, MessageLiteOrBuilder, MessageOrBuilder, Cloneable, EmbeddedSass.OutboundMessage.CanonicalizeRequestOrBuilder
    Enclosing class:
    EmbeddedSass.OutboundMessage.CanonicalizeRequest
    public static final class EmbeddedSass.OutboundMessage.CanonicalizeRequest.Builder
extends GeneratedMessageV3.Builder<EmbeddedSass.OutboundMessage.CanonicalizeRequest.Builder>
implements EmbeddedSass.OutboundMessage.CanonicalizeRequestOrBuilder
     A request for a custom importer to convert an imported URL to its canonical
 format.
 If the URL is not recognized by this importer, or if no stylesheet is found
 at that URL, `CanonicalizeResponse.result` must be `null`. Otherwise, the
 importer must return an absolute URL, including a scheme.
 > The host's documentation should encourage the use of file importers (via
 > `CompileRequest.Importer.file_importer_id`, `FileImportRequest`, and
 > `FileImportResponse`) for any importers that simply refer to files on
 > disk. This will allow Sass to handle the logic of resolving partials,
 > file extensions, and index files.
 If Sass has already loaded a stylesheet with the returned canonical URL, it
 re-uses the existing parse tree. This means that importers must ensure that
 the same canonical URL always refers to the same stylesheet, *even across
 different importers*. Importers must also ensure that any canonicalized
 URLs they return can be passed back to `CanonicalizeRequest` and will be
 returned unchanged.
 If this importer's URL format supports file extensions, it should
 canonicalize them the same way as the default filesystem importer:
 * The importer should look for stylesheets by adding the prefix `_` to the
   URL's basename, and by adding the extensions `.sass` and `.scss` if the
   URL doesn't already have one of those extensions. For example, if the URL
   was `foo/bar/baz`, the importer would look for:
   * `foo/bar/baz.sass`
   * `foo/bar/baz.scss`
   * `foo/bar/_baz.sass`
   * `foo/bar/_baz.scss`
   If the URL was foo/bar/baz.scss, the importer would just look for:
   * `foo/bar/baz.scss`
   * `foo/bar/_baz.scss`
   If the importer finds a stylesheet at more than one of these URLs, it
   should respond with a `CanonicalizeResponse.result.error` indicating that
   the import is ambiguous. Note that if the extension is explicitly
   specified, a stylesheet with another extension may exist without error.
 * If none of the possible paths is valid, the importer should perform the
   same resolution on the URL followed by `/index`. In the example above, it
   would look for:
   * `foo/bar/baz/_index.sass`
   * `foo/bar/baz/index.sass`
   * `foo/bar/baz/_index.scss`
   * `foo/bar/baz/index.scss`
   As above, if the importer finds a stylesheet at more than one of these
   URLs, it should respond with a `CanonicalizeResponse.result.error`
   indicating that the import is ambiguous.
    Protobuf type sass.embedded_protocol.OutboundMessage.CanonicalizeRequest