Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

arc-resolver

Package Overview
Dependencies
Maintainers
2
Versions
8
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

arc-resolver

<img src="https://img.shields.io/github/license/eBay/ar

  • 2.0.0
  • npm
  • Socket score

Version published
Weekly downloads
143
decreased by-7.74%
Maintainers
2
Weekly downloads
 
Created
Source

arc-resolver

ebay open source MIT licensed travisci build Codecov npm version downloads

API

new Resolver(fs)

import Resolver from 'arc-resolver';
  • fs (optional): a filesystem that conforms to the node.js fs api. Defaults to the built-in fs module
Instance methods
  • clearCache()
  • getMatchesSync(path)
  • getDirMatchesSync(dir, request)
  • resolveSync(path, flags)
  • isAdaptiveSync(path)

new MatchSet(matches) an iterable

import { MatchSet} from 'arc-resolver';
  • matches (required): an Array of Objects with the keys flags and value:
    • flags: an Array of strings representing the required flags for the value
    • value: any value to associate with the flags
Properties
  • count: the number of possible matches
  • default: the default value (the least specific, the one with no flags)
Methods
  • match(flags): return the matching value for a flagset
    • flags: an Object where each key represents a flag and the value is a boolean indicating whether that flag is active
  • map(fn): return a new MatchSet with the mapped values
    • fn: a Function that is passed value, flags and index, returns a new value

Defining flags

arc adapts files based on a filenaming convension:

style.css
style[android].css

How it works

Write your application as though the flagged version of the file did not exist:

@import url('./style.css');

When bundling the css (using arc-webpack or arc-lasso), if the android flag is set, style[android].css will replace style.css in the output bundle.

Multiple flags

Require all flags (AND)

Use the plus (+) to specify that all of the listed flags need to match:

style[mobile+android].css
Require any flag (OR)

Use the comma (,) to specify that one of the listed flags needs to match:

style[android,ios].css
Combining flag logic

The plus (+) has higher precedence than the comma (,), similar to how && has higher precedence than || in JavaScript.

For example,

style[mobile+ios,mobile+android].css

Is logically equivalent to:

(mobile && ios) || (mobile && android)
Subgroups of flags

To increase the precedence of a group, you can wrap it in []:

style[mobile+[ios,android]].css

This is logically equivalent to the previous example.

Specificity

More Flags === Higher Specificity

Given the following files:

style.css
style[mobile,tablet,headset,desktop].css
style[mobile+[ios,android]].css
style[mobile+ios+chrome,safari].css

The matching logic looks something like:

if mobile & ios & chrome
  'style[mobile+ios+chrome,safari].css'

else if mobile & ios
  'style[mobile+[ios,android]].css'

else if mobile & android
  'style[mobile+[ios,android]].css'

else if safari
  'style[mobile+ios+chrome,safari].css'

else if mobile
  'style[mobile,tablet,headset,desktop].css'

else if tablet
  'style[mobile,tablet,headset,desktop].css'

else if headset
  'style[mobile,tablet,headset,desktop].css'

else if desktop
  'style[mobile,tablet,headset,desktop].css'

else
  'style.css'

FAQs

Package last updated on 07 Nov 2019

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc