@riboseinc/paneron-registry-kit 2.0.0 → 2.0.1

package/dependencies-local/extension-kit/i18n/ContextProvider.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _context = require("./context");
+
+function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
+
+function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+const I18nContextProvider = function (props) {
+  const [langConfig, setLangConfig] = (0, _react.useState)({
+    available: props.available,
+    default: props.default,
+    selected: props.selected,
+    select: langId => {
+      setLangConfig(langConfig => Object.assign({}, langConfig, {
+        selected: langId
+      }));
+    }
+  });
+  return _react.default.createElement(_context.I18nConfigContext.Provider, {
+    value: langConfig
+  }, props.children);
+};
+
+var _default = I18nContextProvider;
+exports.default = _default;

package/dependencies-local/extension-kit/i18n/ContextProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextProvider.js","sourceRoot":"","sources":["../../src/i18n/ContextProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAU9C,MAAM,mBAAmB,GAA4C,UAAU,KAAK;IAClF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC;QAC3C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAiB;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAkB;QAClC,MAAM,EAAE,CAAC,MAAoC,EAAE,EAAE;YAC/C,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACnF,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,CACL,oBAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,IAC1C,KAAK,CAAC,QAAQ,CACY,CAC9B,CAAC;AACJ,CAAC,CAAC;AAGF,eAAe,mBAAmB,CAAC","sourcesContent":["import React, { useState } from 'react';\n\nimport { SupportedLanguages } from './types';\nimport { I18nConfigContext } from './context';\n\n\nexport type I18nContextProviderProps<Languages extends SupportedLanguages> = {\n  available: Languages\n  default: keyof Languages\n  selected: keyof Languages\n};\n\n\nconst I18nContextProvider: React.FC<I18nContextProviderProps<any>> = function (props) {\n  const [langConfig, setLangConfig] = useState({\n    available: props.available,\n    default: props.default as string,\n    selected: props.selected as string,\n    select: (langId: keyof typeof props.available) => {\n      setLangConfig(langConfig => Object.assign({}, langConfig, { selected: langId }));\n    },\n  });\n\n  return (\n    <I18nConfigContext.Provider value={langConfig}>\n      {props.children}\n    </I18nConfigContext.Provider>\n  );\n};\n\n\nexport default I18nContextProvider;\n"]}

package/dependencies-local/extension-kit/i18n/context.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { SupportedLanguages, LangConfig } from './types';
+export interface I18nConfigContextSpec extends LangConfig {
+    available: SupportedLanguages;
+    default: keyof SupportedLanguages & string;
+    selected: keyof SupportedLanguages & string;
+    select(id: string): void;
+}
+export declare const I18nConfigContext: React.Context<I18nConfigContextSpec>;

package/dependencies-local/extension-kit/i18n/context.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.I18nConfigContext = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const I18nConfigContext = _react.default.createContext({
+  available: {
+    en: 'English',
+    zh: 'Chinese',
+    ru: 'Russian'
+  },
+  default: 'en',
+  selected: 'en',
+  select: id => {}
+});
+
+exports.I18nConfigContext = I18nConfigContext;

package/dependencies-local/extension-kit/i18n/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/i18n/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAa1B,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAwB;IAC1E,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IAC1D,OAAO,EAAE,IAAa;IACtB,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,CAAC,EAAU,EAAE,EAAE,GAAE,CAAC;CAC3B,CAAC,CAAC","sourcesContent":["import React from 'react';\n\nimport { SupportedLanguages, LangConfig } from './types';\n\n\nexport interface I18nConfigContextSpec extends LangConfig {\n  available: SupportedLanguages,\n  default: keyof SupportedLanguages & string,\n  selected: keyof SupportedLanguages & string,\n  select(id: string): void,\n}\n\n\nexport const I18nConfigContext = React.createContext<I18nConfigContextSpec>({\n  available: { en: 'English', zh: 'Chinese', ru: 'Russian' },\n  default: 'en' as const,\n  selected: 'en',\n  select: (id: string) => {},\n});\n"]}

package/dependencies-local/extension-kit/i18n/types.d.ts

@@ -0,0 +1,10 @@
+export interface SupportedLanguages {
+    [id: string]: string;
+}
+export interface LangConfig {
+    default: string;
+    selected: string;
+}
+export interface Translatable<T> {
+    [id: string]: T;
+}

package/dependencies-local/extension-kit/i18n/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface SupportedLanguages { [id: string]: string }\nexport interface LangConfig { default: string, selected: string }\nexport interface Translatable<T> { [id: string]: T; }\n\n"]}

package/dependencies-local/extension-kit/i18n/widgets.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { IButtonGroupProps, IButtonProps } from '@blueprintjs/core';
+import { Translatable } from './types';
+interface TranslatableComponentProps {
+    what: Translatable<string>;
+}
+export declare const Trans: React.FC<TranslatableComponentProps>;
+interface LangSelectorProps {
+    value?: Translatable<any>;
+    groupProps?: IButtonGroupProps;
+    exclude?: string[];
+    untranslatedProps?: IButtonProps;
+    translatedProps?: IButtonProps;
+}
+export declare const LangSelector: React.FC<LangSelectorProps>;
+export {};

package/dependencies-local/extension-kit/i18n/widgets.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.LangSelector = exports.Trans = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _core = require("@blueprintjs/core");
+
+var _context = require("./context");
+
+function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
+
+function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+const Trans = function ({
+  what
+}) {
+  const i18n = (0, _react.useContext)(_context.I18nConfigContext);
+  const translated = what[i18n.selected];
+  const untranslated = what[i18n.default];
+  return _react.default.createElement("span", null, translated || untranslated || '(malformed translatable string)');
+};
+
+exports.Trans = Trans;
+
+const LangSelector = function ({
+  exclude,
+  value,
+  untranslatedProps,
+  translatedProps,
+  groupProps
+}) {
+  const i18n = (0, _react.useContext)(_context.I18nConfigContext);
+  return _react.default.createElement(_core.ButtonGroup, Object.assign({}, groupProps), Object.keys(i18n.available).filter(langID => (exclude || []).indexOf(langID) < 0).map(langId => _react.default.createElement(LangSelectorButton, {
+    key: langId,
+    id: langId,
+    title: i18n.available[langId],
+    isSelected: langId === i18n.selected,
+    onSelect: () => i18n.select(langId),
+    untranslatedProps: untranslatedProps,
+    translatedProps: translatedProps,
+    hasTranslation: value !== undefined ? value[langId] !== undefined : undefined
+  })));
+};
+
+exports.LangSelector = LangSelector;
+
+const LangSelectorButton = function (props) {
+  return _react.default.createElement(_core.Button, Object.assign({
+    active: props.isSelected,
+    onClick: props.onSelect
+  }, !props.hasTranslation ? props.untranslatedProps : {}, props.hasTranslation ? props.translatedProps : {}), props.id);
+};

package/dependencies-local/extension-kit/i18n/widgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.js","sourceRoot":"","sources":["../../src/i18n/widgets.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAmC,MAAM,mBAAmB,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAM9C,MAAM,CAAC,MAAM,KAAK,GAAyC,UAAU,EAAE,IAAI,EAAE;IAC3E,MAAM,IAAI,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO,kCAAO,UAAU,IAAI,YAAY,IAAI,iCAAiC,CAAQ,CAAC;AACxF,CAAC,CAAC;AAUF,MAAM,CAAC,MAAM,YAAY,GACzB,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE;IAC1E,MAAM,IAAI,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE3C,OAAO,CACL,oBAAC,WAAW,oBAAK,UAAU,GACxB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QACxB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrD,GAAG,CAAC,MAAM,CAAC,EAAE,CACf,oBAAC,kBAAkB,IACjB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAC7B,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC,QAAQ,EACpC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EACnC,iBAAiB,EAAE,iBAAiB,EACpC,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,GACjF,CACH,CACW,CACf,CAAC;AACJ,CAAC,CAAC;AAYF,MAAM,kBAAkB,GAAsC,UAAU,KAAK;IAC3E,OAAO,CACL,oBAAC,MAAM,kBACH,MAAM,EAAE,KAAK,CAAC,UAAU,EACxB,OAAO,EAAE,KAAK,CAAC,QAAQ,IACnB,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,EACtD,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,GACxD,KAAK,CAAC,EAAE,CACF,CACV,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import React, { useContext } from 'react';\nimport { Button, ButtonGroup, IButtonGroupProps, IButtonProps } from '@blueprintjs/core';\nimport { Translatable } from './types';\nimport { I18nConfigContext } from './context';\n\n\ninterface TranslatableComponentProps {\n  what: Translatable<string>\n}\nexport const Trans: React.FC<TranslatableComponentProps> = function ({ what }) {\n  const i18n = useContext(I18nConfigContext);\n  const translated = what[i18n.selected];\n  const untranslated = what[i18n.default];\n\n  return <span>{translated || untranslated || '(malformed translatable string)'}</span>;\n};\n\n\ninterface LangSelectorProps {\n  value?: Translatable<any>\n  groupProps?: IButtonGroupProps\n  exclude?: string[]\n  untranslatedProps?: IButtonProps\n  translatedProps?: IButtonProps\n}\nexport const LangSelector: React.FC<LangSelectorProps> =\nfunction ({ exclude, value, untranslatedProps, translatedProps, groupProps }) {\n  const i18n = useContext(I18nConfigContext);\n\n  return (\n    <ButtonGroup {...groupProps}>\n      {Object.keys(i18n.available).\n          filter(langID => (exclude || []).indexOf(langID) < 0).\n          map(langId =>\n        <LangSelectorButton\n          key={langId}\n          id={langId}\n          title={i18n.available[langId]}\n          isSelected={langId === i18n.selected}\n          onSelect={() => i18n.select(langId)}\n          untranslatedProps={untranslatedProps}\n          translatedProps={translatedProps}\n          hasTranslation={(value !== undefined) ? (value[langId] !== undefined) : undefined}\n        />\n      )}\n    </ButtonGroup>\n  );\n};\n\n\ninterface LangSelectorButtonProps {\n  id: string\n  title: string\n  isSelected: boolean\n  onSelect: () => void\n  hasTranslation?: boolean\n  untranslatedProps?: IButtonProps\n  translatedProps?: IButtonProps\n}\nconst LangSelectorButton: React.FC<LangSelectorButtonProps> = function (props) {\n  return (\n    <Button\n        active={props.isSelected}\n        onClick={props.onSelect}\n        {...(!props.hasTranslation ? props.untranslatedProps : {})}\n        {...(props.hasTranslation ? props.translatedProps : {})}>\n      {props.id}\n    </Button>\n  );\n};\n"]}

package/dependencies-local/extension-kit/index.d.ts

@@ -0,0 +1,3 @@
+import 'electron';
+import type { ExtensionMaker } from './types/extension-maker';
+export declare const makeExtension: ExtensionMaker;

package/dependencies-local/extension-kit/index.js

@@ -0,0 +1,78 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.makeExtension = void 0;
+
+var _semver = _interopRequireDefault(require("semver"));
+
+require("electron");
+
+var _electronLog = _interopRequireDefault(require("electron-log"));
+
+var _context = require("./context");
+
+var _objectSpecs = require("./object-specs");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/* The default export of Paneron extension’s extension.ts entry file
+   should be the result of calling this function. */
+const makeExtension = async options => {
+  var _a;
+
+  let plugin;
+  const objectSpecs = (_a = options.objects) !== null && _a !== void 0 ? _a : [];
+
+  if (process.type === 'browser') {
+    const migration = options.datasetInitializer ? (await options.datasetInitializer()).default : async () => ({
+      bufferChangeset: {},
+      versionAfter: '1.0'
+    });
+    plugin = {
+      isCompatible: hostAppVersion => options.requiredHostAppVersion !== undefined && _semver.default.satisfies(hostAppVersion, options.requiredHostAppVersion),
+      getObjectSpecs: () => {
+        return objectSpecs;
+      },
+      getMigration: datasetVersion => Object.entries(options.datasetMigrations || {}).filter(([migrationVersionSpec, _]) => _semver.default.satisfies(datasetVersion, migrationVersionSpec)).map(([versionSpec, migration]) => ({
+        versionSpec,
+        migration
+      }))[0],
+      initialMigration: migration
+    };
+  } else if (process.type === 'renderer') {
+    const mainViewImportResult = options.mainView || options.repoView ? await (options.mainView ||
+    /* Deprecated */
+    options.repoView)() : undefined;
+    const objectSpecsWithCachedViews = await Promise.all(objectSpecs.filter(spec => spec.views !== undefined).map(async spec => Object.assign(Object.assign({}, spec), {
+      _viewCache: (await spec.views()).default
+    })));
+    plugin = {
+      mainView: mainViewImportResult ? (0, _context.withDatasetContext)(mainViewImportResult.default) : undefined,
+      getObjectView: ({
+        objectPath,
+        viewID
+      }) => {
+        const spec = Object.values(objectSpecsWithCachedViews).find(c => (0, _objectSpecs.matchesPath)(objectPath, c.matches));
+
+        if (spec) {
+          const view = spec._viewCache[viewID];
+          return view;
+        } else {
+          _electronLog.default.error("Unable to find object view for object path", objectPath, viewID);
+
+          throw new Error("Cannot find object view");
+        }
+      }
+    };
+  } else {
+    _electronLog.default.error("Paneron extension: Unsupported process type", options.name);
+
+    throw new Error("Unsupported process type");
+  }
+
+  return plugin;
+};
+
+exports.makeExtension = makeExtension;

package/dependencies-local/extension-kit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import semver from 'semver';\nimport 'electron';\nimport log from 'electron-log';\nimport type { Extension } from './types/extension';\nimport type { ExtensionMaker } from './types/extension-maker';\nimport type { DatasetMigrationFunction } from './types/migrations';\nimport { withDatasetContext } from './context';\nimport { matchesPath } from './object-specs';\n\n\n/* The default export of Paneron extension’s extension.ts entry file\n   should be the result of calling this function. */\nexport const makeExtension: ExtensionMaker = async (options) => {\n  let plugin: Extension;\n\n  const objectSpecs = options.objects ?? [];\n\n  if (process.type === 'browser') {\n    const migration: DatasetMigrationFunction = options.datasetInitializer\n      ? (await options.datasetInitializer()).default\n      : async () => ({\n          bufferChangeset: {},\n          versionAfter: '1.0',\n        });\n\n    plugin = {\n\n      isCompatible: (hostAppVersion: string) => (\n        options.requiredHostAppVersion !== undefined &&\n        semver.satisfies(hostAppVersion, options.requiredHostAppVersion)\n      ),\n\n      getObjectSpecs: () => {\n        return objectSpecs;\n      },\n\n      getMigration: (datasetVersion) => (\n        Object.entries(options.datasetMigrations || {}).\n        filter(([migrationVersionSpec, _]) =>\n          semver.satisfies(datasetVersion, migrationVersionSpec)\n        ).\n        map(([versionSpec, migration]) =>\n          ({ versionSpec, migration })\n        )[0]\n      ),\n\n      initialMigration: migration,\n    };\n\n  } else if (process.type === 'renderer') {\n    const mainViewImportResult = (options.mainView || (options as any).repoView)\n      ? await (\n          options.mainView ||\n          /* Deprecated */(options as any).repoView\n        )()\n      : undefined;\n\n    const objectSpecsWithCachedViews = (await Promise.all(objectSpecs.\n      filter(spec => spec.views !== undefined).\n      map(async (spec) => ({ ...spec, _viewCache: (await spec.views!()).default }))));\n\n    plugin = {\n      mainView: mainViewImportResult\n        ? withDatasetContext(mainViewImportResult.default)\n        : undefined,\n\n      getObjectView: ({ objectPath, viewID }) => {\n        const spec = Object.values(objectSpecsWithCachedViews).\n          find(c => matchesPath(objectPath, c.matches));\n        if (spec) {\n          const view = spec._viewCache[viewID];\n          return view;\n        } else {\n          log.error(\"Unable to find object view for object path\", objectPath, viewID);\n          throw new Error(\"Cannot find object view\");\n        }\n      },\n    };\n\n  } else {\n    log.error(\"Paneron extension: Unsupported process type\", options.name);\n    throw new Error(\"Unsupported process type\");\n  }\n\n  return plugin;\n}\n"]}

package/dependencies-local/extension-kit/object-specs/index.d.ts

@@ -0,0 +1,2 @@
+import type { PathMatcher } from '../types/object-spec';
+export declare function matchesPath(p: string, rule: PathMatcher): boolean;

package/dependencies-local/extension-kit/object-specs/index.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.matchesPath = matchesPath;
+
+function matchesPath(p, rule) {
+  // Match by default
+  let matched = true; // Narrow by path prefix
+
+  if (rule.pathPrefix) {
+    matched = p.startsWith(rule.pathPrefix);
+  } // Narrow by path-matching function
+
+
+  if (matched && rule.path) {
+    matched = matched && rule.path(p);
+  }
+
+  return matched;
+}

package/dependencies-local/extension-kit/object-specs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/object-specs/index.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,IAAiB;IACtD,mBAAmB;IACnB,IAAI,OAAO,GAAY,IAAI,CAAC;IAE5B,wBAAwB;IACxB,IAAI,IAAI,CAAC,UAAU,EAAE;QACnB,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;KACzC;IAED,mCAAmC;IACnC,IAAI,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE;QACxB,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACnC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { PathMatcher } from '../types/object-spec';\n\n\nexport function matchesPath(p: string, rule: PathMatcher): boolean {\n  // Match by default\n  let matched: boolean = true;\n\n  // Narrow by path prefix\n  if (rule.pathPrefix) {\n    matched = p.startsWith(rule.pathPrefix);\n  }\n\n  // Narrow by path-matching function\n  if (matched && rule.path) {\n    matched = matched && rule.path(p);\n  }\n\n  return matched;\n}\n"]}

package/dependencies-local/extension-kit/object-specs/paneron-object.d.ts

@@ -0,0 +1,6 @@
+import { SerDesRule } from '../types/object-spec';
+import { OnlyJSON } from '../util';
+export declare const utf8Decoder: TextDecoder;
+export declare function makePaneronObjectCompositeSerDesRule<T extends Record<string, any> & OnlyJSON<Record<string, any>> = any>(): SerDesRule<T>;
+export declare function unflattenObject<T extends Record<string, any>>(parts: Record<string, any>): T;
+export declare function flattenObject(obj: Record<string, any>, _prefix?: false | string, _result?: Record<string, any> | null): Record<string, any>;

package/dependencies-local/extension-kit/object-specs/paneron-object.js

@@ -0,0 +1,161 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.makePaneronObjectCompositeSerDesRule = makePaneronObjectCompositeSerDesRule;
+exports.unflattenObject = unflattenObject;
+exports.flattenObject = flattenObject;
+exports.utf8Decoder = void 0;
+
+var _path = _interopRequireDefault(require("path"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const utf8Decoder = new TextDecoder('utf-8');
+exports.utf8Decoder = utf8Decoder;
+const stringSerDes = {
+  deserialize: buf => utf8Decoder.decode(buf),
+  serialize: val => Buffer.from(val, 'utf-8')
+};
+const numberSerDes = {
+  deserialize: buf => parseInt(utf8Decoder.decode(buf), 10),
+  serialize: val => Buffer.from(val.toString(), 'utf-8')
+};
+const partSerDes = {
+  'text': stringSerDes,
+  'number': numberSerDes
+}; //const EXT = '.pan';
+
+/* Creates a spec for objects where a serialized object
+   is represented as a tree of buffers.
+
+   An object is represented as comprised from “parts”,
+   where each part corresponds to a buffer (e.g., file).
+
+   The default behavior is such that e.g.
+
+       { title: "Hello world", foo: { bar: baz } }
+
+   after disassembly (basic flattening) would be represented as:
+
+       { "/title": "Hello world", "/foo/bar": "baz" }
+
+   (On disk, title and foo/bar would be paths to files
+   relative to object root path.)
+*/
+
+function makePaneronObjectCompositeSerDesRule() {
+  const assemble = unflattenObject;
+  const disassemble = flattenObject;
+  return {
+    deserialize: (rawData, opts) => {
+      function deserializePart(buf, partPath) {
+        var _a, _b;
+
+        return partSerDes[(_b = (_a = opts.parts[partPath]) === null || _a === void 0 ? void 0 : _a.dataType) !== null && _b !== void 0 ? _b : 'text'].deserialize(buf);
+      }
+
+      const parts = deserializeParts(rawData, deserializePart);
+      return assemble(parts);
+    },
+    serialize: (obj, opts) => {
+      function serializePart(data, partPath) {
+        var _a, _b;
+
+        return partSerDes[(_b = (_a = opts.parts[partPath]) === null || _a === void 0 ? void 0 : _a.dataType) !== null && _b !== void 0 ? _b : 'text'].serialize(data);
+      }
+
+      const parts = disassemble(obj);
+      return serializeParts(parts, serializePart);
+    }
+  };
+} // Object flattening and unflattening is based
+// on original implementation from Tofandel’s answer: https://stackoverflow.com/a/59787588/247441
+
+/* Aggregates parts (mapped to slash-separated paths) into a nested object.
+
+   E.g.:
+
+     { /some/path: A, /foo: B, /some/other/path: C }
+   
+   gets turned into:
+
+     { foo: B, some: { path: A, other: { path: C } } }
+*/
+
+
+function unflattenObject(parts) {
+  const result = {}; // Ideally should be typed as Partial<T>, but that causes problems down the line
+
+  for (const partPath of Object.keys(parts)) {
+    if (Object.prototype.hasOwnProperty.call(parts, partPath)) {
+      const keys = partPath.match(/^\/+[^\/]*|[^\/]*\/+$|(?:\/{2,}|[^\/])+(?:\/+$)?/g); // Matches a standalone slash in a key
+      //const keys = partPath.match(/^\.+[^.]*|[^.]*\.+$|(?:\.{2,}|[^.])+(?:\.+$)?/g);
+
+      if (keys) {
+        keys.reduce((accumulator, val, idx) => {
+          return accumulator[val] || (accumulator[val] = isNaN(Number(keys[idx + 1])) ? keys.length - 1 === idx ? parts[partPath] : {} : []);
+        }, result);
+      }
+    }
+  }
+
+  return result;
+}
+/* Recursively decomposes an arbitrarily nested object into a flat record
+   of slash-separated part paths mapped to respective structures.
+
+   E.g.:
+
+     { foo: B, some: { path: A, other: { path: C } } }
+   
+   gets turned into:
+
+     { /some/path: A, /foo: B, /some/other/path: C }
+*/
+
+
+function flattenObject(obj, _prefix = false, _result = null) {
+  const result = _result || {}; // Preserve empty objects and arrays, they are lost otherwise
+
+  if (_prefix !== false && typeof obj === 'object' && obj !== null && Object.keys(obj).length === 0) {
+    result[_prefix] = Array.isArray(obj) ? [] : {};
+    return result;
+  }
+
+  const prefix = _prefix !== false ? _prefix + _path.default.posix.sep : _path.default.posix.sep;
+
+  for (const i in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, i)) {
+      if (typeof obj[i] === 'object' && obj[i] !== null) {
+        // Recursion on deeper objects
+        flattenObject(obj[i], prefix + i, result);
+      } else {
+        result[prefix + i] = obj[i];
+      }
+    }
+  }
+
+  return result;
+}
+
+function deserializeParts(buffers, partFromBuffer) {
+  const result = {};
+
+  for (const [p, buffer] of Object.entries(buffers)) {
+    result[p] = partFromBuffer(buffer, p);
+  }
+
+  return result;
+}
+
+function serializeParts(parts, partToBuffer) {
+  const result = {};
+
+  for (const [p, part] of Object.entries(parts)) {
+    result[p] = partToBuffer(part, p);
+  }
+
+  return result;
+}

package/dependencies-local/extension-kit/object-specs/paneron-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paneron-object.js","sourceRoot":"","sources":["../../src/object-specs/paneron-object.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'path';\nimport { SerDesRule } from '../types/object-spec';\nimport { OnlyJSON } from '../util';\n\n\nexport const utf8Decoder = new TextDecoder('utf-8');\n\n\ninterface PartSerDes<T> {\n  deserialize: (buf: Uint8Array) => T\n  serialize: (obj: T) => Uint8Array\n}\n\n\nconst stringSerDes: PartSerDes<string> = {\n  deserialize: (buf) => utf8Decoder.decode(buf),\n  serialize: (val) => Buffer.from(val, 'utf-8'),\n};\n\nconst numberSerDes: PartSerDes<number> = {\n  deserialize: (buf) => parseInt(utf8Decoder.decode(buf), 10),\n  serialize: (val) => Buffer.from(val.toString(), 'utf-8'),\n};\n\nconst partSerDes: { [key in DataType]: PartSerDes<any> } = {\n  'text': stringSerDes,\n  'number': numberSerDes,\n};\n\n\ninterface PartSerDesOptions {\n  dataType: DataType\n}\n\ninterface SerDesOptions {\n  parts: {\n    [propertyPath: string]: PartSerDesOptions\n  }\n}\n\ntype DataType = 'text' | 'number';\n\n//const EXT = '.pan';\n\n\n/* Creates a spec for objects where a serialized object\n   is represented as a tree of buffers.\n\n   An object is represented as comprised from “parts”,\n   where each part corresponds to a buffer (e.g., file).\n\n   The default behavior is such that e.g.\n\n       { title: \"Hello world\", foo: { bar: baz } }\n\n   after disassembly (basic flattening) would be represented as:\n\n       { \"/title\": \"Hello world\", \"/foo/bar\": \"baz\" }\n\n   (On disk, title and foo/bar would be paths to files\n   relative to object root path.)\n*/\nexport function makePaneronObjectCompositeSerDesRule\n<T extends Record<string, any> & OnlyJSON<Record<string, any>> = any>\n():\nSerDesRule<T> {\n  const assemble: (data: any) => T = unflattenObject;\n  const disassemble: (obj: T) => Record<string, any> = flattenObject;\n\n  return {\n    deserialize: (rawData, opts: SerDesOptions) => {\n      function deserializePart(buf: Uint8Array, partPath: string): any {\n        return partSerDes[opts.parts[partPath]?.dataType ?? 'text'].deserialize(buf);\n      }\n      const parts = deserializeParts(rawData, deserializePart);\n      return assemble(parts);\n    },\n    serialize: (obj, opts: SerDesOptions) => {\n      function serializePart(data: any, partPath: string): Uint8Array {\n        return partSerDes[opts.parts[partPath]?.dataType ?? 'text'].serialize(data);\n      }\n      const parts = disassemble(obj);\n      return serializeParts(parts, serializePart);\n    },\n  };\n}\n\n\n// Object flattening and unflattening is based\n// on original implementation from Tofandel’s answer: https://stackoverflow.com/a/59787588/247441\n\n/* Aggregates parts (mapped to slash-separated paths) into a nested object.\n\n   E.g.:\n\n     { /some/path: A, /foo: B, /some/other/path: C }\n   \n   gets turned into:\n\n     { foo: B, some: { path: A, other: { path: C } } }\n*/\n\nexport function unflattenObject<T extends Record<string, any>>\n(parts: Record<string, any>): T {\n  const result: Record<string, any> = {};\n  // Ideally should be typed as Partial<T>, but that causes problems down the line\n\n  for (const partPath of Object.keys(parts)) {\n    if (Object.prototype.hasOwnProperty.call(parts, partPath)) {\n\n      const keys = partPath.match(/^\\/+[^\\/]*|[^\\/]*\\/+$|(?:\\/{2,}|[^\\/])+(?:\\/+$)?/g);\n      // Matches a standalone slash in a key\n      //const keys = partPath.match(/^\\.+[^.]*|[^.]*\\.+$|(?:\\.{2,}|[^.])+(?:\\.+$)?/g);\n\n      if (keys) {\n        keys.reduce((accumulator, val, idx) => {\n          return accumulator[val] || (\n            (accumulator[val] = isNaN(Number(keys[idx + 1]))\n              ? (keys.length - 1 === idx\n                ? parts[partPath]\n                : {})\n              : [])\n          );\n        }, result);\n      }\n    }\n  }\n\n  return result as T;\n}\n\n\n/* Recursively decomposes an arbitrarily nested object into a flat record\n   of slash-separated part paths mapped to respective structures.\n\n   E.g.:\n\n     { foo: B, some: { path: A, other: { path: C } } }\n   \n   gets turned into:\n\n     { /some/path: A, /foo: B, /some/other/path: C }\n*/\nexport function flattenObject(\n  obj: Record<string, any>,\n  _prefix: false | string = false,\n  _result: Record<string, any> | null = null,\n): Record<string, any> {\n  const result: Record<string, any> = _result || {};\n\n  // Preserve empty objects and arrays, they are lost otherwise\n  if (_prefix !== false &&\n      typeof obj === 'object' &&\n      obj !== null &&\n      Object.keys(obj).length === 0) {\n    result[_prefix] = Array.isArray(obj) ? [] : {};\n    return result;\n  }\n\n  const prefix = _prefix !== false\n    ? (_prefix + path.posix.sep)\n    : path.posix.sep;\n\n  for (const i in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, i)) {\n      if (typeof obj[i] === 'object' && obj[i] !== null) {\n        // Recursion on deeper objects\n        flattenObject(obj[i], prefix + i, result);\n      } else {\n        result[prefix + i] = obj[i];\n      }\n    }\n  }\n  return result;\n}\n\n\nfunction deserializeParts(\n  buffers: Record<string, Uint8Array>,\n  partFromBuffer: (buffer: Uint8Array, path: string) => any,\n): Record<string, any> {\n  const result: Record<string, any> = {};\n  for (const [p, buffer] of Object.entries(buffers)) {\n    result[p] = partFromBuffer(buffer, p);\n  }\n  return result;\n}\n\n\nfunction serializeParts(\n  parts: Record<string, any>,\n  partToBuffer: (data: any, path: string) => Uint8Array,\n): Record<string, Uint8Array> {\n  const result: Record<string, Uint8Array> = {};\n  for (const [p, part] of Object.entries(parts)) {\n    result[p] = partToBuffer(part, p);\n  }\n  return result;\n}\n"]}

package/dependencies-local/extension-kit/object-specs/ser-des.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Serialization/deserialization rules describe how physical buffers
+ * are represented as JS structures at runtime.
+ *
+ * This is Node-only code due to use of Buffer API.
+ */
+import { PointerInfo as LFSPointerInfo } from '@riboseinc/isogit-lfs/pointers';
+import { SerDesRule, SerDesRuleName, SerDesRuleNameExtensionMap } from '../types/object-spec';
+import type { OnlyJSON } from '../util';
+import type { BufferDataset } from '../types/buffers';
+/** Returns serialization/deserialization rule that works for given object. */
+export declare function findSerDesRuleForObject(objPath: string, obj: Record<string, any>, overrides?: {
+    extensions?: SerDesRuleNameExtensionMap;
+}): SerDesRule;
+/** Returns serialization/deserialization rule that works for given buffer dataset. */
+export declare function findSerDesRuleForBuffers(objPath: string, buffers: BufferDataset, overrides?: {
+    extensions?: SerDesRuleNameExtensionMap;
+}): SerDesRule;
+export declare function getSerDesRuleByName(ruleName: SerDesRuleName): SerDesRule;
+export declare const lfsPointer: SerDesRule<{
+    lfsPointerInfo: LFSPointerInfo;
+}>;
+export declare const textFile: SerDesRule<{
+    asText: string;
+}>;
+export declare const jsonFile: SerDesRule<OnlyJSON<Record<string, any>>>;
+export declare const yamlFile: SerDesRule<OnlyJSON<Record<string, any>>>;
+export declare const binaryFile: SerDesRule<{
+    binaryData: Uint8Array;
+    asBase64: string;
+}>;