@slicemachine/core NPM

Slice Machine Core

Primitive operations and data models for the Slicemachine world.

Structure

The core is structured in sub-packages that can be used and imported independently. Although most of the operations it provides are filesystem based, you should be able to import Models and utilities in browser-based environments.

Node-Utils

Query and parse Slicemachine data in the Filesystem

Framework

Some parts of Slicemachine are framework dependent. Use autodetectFramework to get what's identified in your package.json.

import { autodetectFramework } from "@slicemachine/core/build/node-utils";

(async () => {
  const framework = autodetectFramework("." /* project cwd */);
})();

Manifest

Slicemachine projects rely on an sm.json file to configure the behaviour of the plugin (slice-machine-ui mostly).

import * as Manifest from "@slicemachine/core/build/node-utils/manifest";
import { DEFAULT_BASE } from "@slicemachine/core/build/consts";

(async () => {
  const cwd = "./";

  // creates a manifest at path `./sm.json`
  createManifest(cwd, { apiEndpoint: "https://my-project.prismic.io/api/v2" });

  // my-project
  const maybeRepoName = maybeRepoNameFromSMFile(cwd, DEFAULT_BASE);

  patchManifest(cwd, { storybook: `https://${maybeRepoName}.vercel.app` });

  const { exists, content } = retrieveManifest(cwd);

  console.log({ exists, content }); // true, { apiEndpoint, storybook }
})();

Paths

Resolve paths in the context of a Slicemachine project.

Pkg

Work with package.json files

import {
  retrieveJsonPackage,
  patchJsonPackage,
} from "@slicemachine/core/build/node-utils";

(async () => {
  const cwd = "./";
  patchJsonPackage(cwd, { name: "new-name" });
  const { exists, content } = retrieveJsonPackage(cwd);
})();

Libraries (wip)

An essential data model in Slicemachine is Library: a set of components that hold code, Prismic Slice model, screenshots and mocks.

Once registered, retrieve them from the Filesystem

import { libraries } from "@slicemachine/core/build/libraries";

(async () => {
  const cwd = "./";
  const libs = [/* local */ "~/slices", /* in node_modules */ "shared-lib"];

  const myLibs = libraries(cwd, libs);
  /*
        [
            name: string,
            path: string,
            isLocal: boolean,
            components: [{
                from: string,
                href: string,
                pathToSlice: string,
                infos: ComponentInfo,
                model: SliceAsObject,
                migrated: boolean,
            }]
        ]

    */
})();

Models

Types (+ helpers) of Slicemachine data models

Prismic

Helpers to interact with Prismic and Prismic Shared Config object (~/.prismic)

Utils (expanding)

Various helpers to deal with Slicemachine specifics

import { pascalize, snakelize } from "@slicemachine/core/build/utils";

(async () => {
  const camelName = "camelName";

  const componentName = pascalize(camelName); // CamelName
  const prismicId = snakelize(camelName); // camel_name
})();

fp-ts io-ts cookie io-ts-types io-ts-reporters @prismicio/types-internal

@everything-registry/sub-chunk-843 @prismicio/slice-canvas-renderer @zalastax/nolb-_sli @slicemachine/client

1.1.18-dev-ct-slice-delete.8

2 years ago

1.1.18-dev-ct-slice-delete.9

2 years ago

1.1.18-dev-ct-slice-delete.5

2 years ago

1.1.18-dev-ct-slice-delete.6

2 years ago

1.1.18-dev-ct-slice-delete.7

2 years ago

1.1.18-dev-ct-slice-delete.10

2 years ago

1.1.18-dev-ct-slice-delete.11

2 years ago

1.1.18-dev-ct-slice-delete.12

2 years ago

1.1.19

2 years ago

1.1.18

2 years ago

1.1.19-dev-release-feb.2

2 years ago

1.1.19-dev-release-feb.0

2 years ago

1.1.19-dev-release-feb.1

2 years ago

1.1.19-dev-release-0.7.1.0

2 years ago

1.1.18-dev-ct-slice-delete.0

2 years ago

1.1.18-dev-ct-slice-delete.1

2 years ago

1.1.18-dev-ct-slice-delete.2

2 years ago

1.1.18-dev-ct-slice-delete.3

2 years ago

1.1.18-dev-ct-slice-delete.4

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

1.1.17-dev-fix-mock-edits.0

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1.1.16-dev-ct-slice-delete.5

2 years ago

1.1.16-dev-ct-slice-delete.4

2 years ago

1.1.16-dev-ct-slice-delete.3

3 years ago

1.1.16-dev-ct-slice-delete.2

3 years ago

1.1.16-dev-ct-slice-delete.6

2 years ago

3 years ago

3 years ago

2 years ago

2 years ago

1.1.16-dev-ct-slice-delete.1

3 years ago

2 years ago

2 years ago

2 years ago

3 years ago

2 years ago

2 years ago

1.1.17-dev-fix-npmignore-source-maps.0

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

1.1.16-dev-mocks-with-simv2.1

3 years ago

1.1.16-dev-react-18.5

3 years ago

1.1.16-dev-mocks.2

3 years ago

1.1.16-dev-mocks-with-simv2.0

3 years ago

1.1.16-dev-mocks-with-simv2.3

3 years ago

1.1.16-dev-react-18.3

3 years ago

1.1.16-dev-mocks-with-simv2.2

3 years ago

1.1.16-dev-mocks.0

3 years ago

1.1.16-dev-react-18.4

3 years ago

1.1.16-dev-react-18.1

3 years ago

1.1.16-dev-react-18.2

3 years ago

1.1.16-dev-react-18.0

3 years ago

1.1.16-dev-0.6.0.0

3 years ago

1.1.14-dev.0

3 years ago

1.1.16-dev-ct-slice-delete.0

3 years ago

1.1.15-dev-screenshotv2.3

3 years ago

1.1.15

3 years ago

1.1.15-dev-screenshotv2.4

3 years ago

1.1.15-dev-screenshotv2.1

3 years ago

1.1.14

3 years ago

1.1.15-dev-screenshotv2.2

3 years ago

1.1.14-dev.10

3 years ago

1.1.14-dev-screenshotv2.0

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago